Sascha WolfandClaude Opus 5
6fd713497d
Spiegelt das Vertriebspostfach ueber Microsoft Graph ins CRM. Aus jeder Mail entstehen Kontakt-Vorschlaege, und jede Mail laesst sich an Opportunities und Kontakte haengen. Uebernommen ist die Idee aus dem Altsystem KeepTrack, nicht die Umsetzung: - Delta Query statt "$filter=isRead eq false" mit anschliessendem PATCH. Damit genuegt die Anwendungsberechtigung Mail.Read, es braucht keinen Schreibzugriff auf das Postfach, und eine vorher in Outlook geoeffnete Mail geht nicht verloren. Der Fortschritt liegt als delta_link in der Datenbank und ueberlebt Neustarts; ein Lauf ist gedeckelt und fortsetzbar. - Tenant- und Client-ID kommen aus der .env, nicht aus dem Browser. Im Altsystem konnte jeder Angemeldete das Server-Secret gegen einen fremden Tenant verwenden. - Kontaktdaten werden aus den Graph-Feldern und der Signatur gelesen, ohne Sprachmodell. Mailinhalte verlassen den Server nicht. - Ein Vorschlag ohne E-Mail-Adresse wird nicht mit einer erfundenen Adresse angelegt, sondern bleibt zur Durchsicht liegen. Ist die Adresse schon als Kontakt vorhanden, werden nur leere Felder ergaenzt. - Mails haengen als eigene Verknuepfung an Opportunity und Kontakt, nicht als Text im Notizfeld - loesbar und mehrfach moeglich. - Fremdes Mail-HTML wird serverseitig entschaerft und in einem iframe mit sandbox="" gezeigt. Externe Bilder sind per CSP gesperrt, damit das Oeffnen dem Absender nichts meldet. - Der Verbindungstest prueft Anmeldung und tatsaechlichen Postfachzugriff und benennt den wahrscheinlichen Grund. Der alte Test holte nur ein Token. Fehlen die MS_*-Werte, startet das CRM normal; die Einstellungen nennen die fehlende Variable. Neue Tabellen: crm_mail_messages, crm_mail_links, crm_mail_contact_candidates, crm_mail_sync_state, crm_settings. Uebernommene Kontakte tragen source = 'Mail'; die Kontaktliste hat dafuer einen Herkunftsfilter. Nicht enthalten: Senden, Antworten, Weiterleiten, Anhaenge und die automatische Zuordnung zu Opportunities. npm test im Verzeichnis server prueft Kontaktextraktion und Graph-Client (47 Pruefungen, ohne Framework und ohne Datenbank). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
75 lines
2.8 KiB
Markdown
75 lines
2.8 KiB
Markdown
# Dokumentation perinco CRM
|
|
|
|
Technische Dokumentation mit Funktionszeichnungen. Die Diagramme sind Mermaid und
|
|
werden von Gitea direkt gerendert.
|
|
|
|
**Neu hier?** Wer die Anwendung *benutzen* will, faengt bei
|
|
[07 Anleitung fuer Benutzer](07-anleitung-benutzer.md) an. Wer daran *entwickeln*
|
|
will, bei [08 Anleitung fuer Entwickler](08-anleitung-entwickler.md). Beide setzen
|
|
keine Vorkenntnisse voraus.
|
|
|
|
| Kapitel | Inhalt |
|
|
| --- | --- |
|
|
| [01 Architektur](01-architektur.md) | Topologie, Prozesse, Ports, Anfrageweg, Rollen |
|
|
| [02 Datenmodell](02-datenmodell.md) | Tabellen beider Datenbanken als ER-Diagramme |
|
|
| [03 Projekt Scanner](03-scanner.md) | Suchlauf von der Boerse bis zum Treffer, Parallelbetrieb |
|
|
| [04 Diktat](04-diktat.md) | Spracherkennung im Browser, Modell-Lebenszyklus |
|
|
| [05 Frontend](05-frontend.md) | Ansichten, Menue, Komponentenkarte, Zustand |
|
|
| [06 Betrieb](06-betrieb.md) | Deployment, Umgebungsvariablen, Dienste, Stoerungssuche |
|
|
| [07 Anleitung fuer Benutzer](07-anleitung-benutzer.md) | Bedienung aller Bereiche, Schritt fuer Schritt |
|
|
| [08 Anleitung fuer Entwickler](08-anleitung-entwickler.md) | Einrichten, erweitern, bekannte Fallen |
|
|
| [09 Quellcode-Referenz](09-quellcode.md) | jede Datei, ihre Exporte und Zusagen |
|
|
| [10 Glossar](10-glossar.md) | Agent, Match, Lead, Opportunity, Status- und Portalwerte |
|
|
| [11 Postfachanbindung](11-postfach.md) | crm@perinco.de ueber Microsoft Graph, Kontakte aus Mails |
|
|
|
|
Die Designentscheidungen und die Messwerte zur Spracherkennung stehen im
|
|
[README des Projekts](../README.md).
|
|
|
|
## Das Ganze in einem Bild
|
|
|
|
```mermaid
|
|
flowchart TB
|
|
subgraph Browser
|
|
SPA["React-SPA<br/>Vite-Build"]
|
|
WSP["Whisper im Web Worker<br/>WebGPU / WASM"]
|
|
end
|
|
|
|
subgraph Server["Server 212.227.135.41"]
|
|
AP["Apache<br/>:443"]
|
|
API["Express-Backend<br/>127.0.0.1:5006"]
|
|
SCH["Scanner-Scheduler<br/>node-cron"]
|
|
MSCH["Mail-Scheduler<br/>node-cron"]
|
|
PW["Playwright<br/>Chromium"]
|
|
DB1[("MariaDB<br/>perinco_CRM")]
|
|
DB2[("MariaDB<br/>perinco_scanner")]
|
|
ALT["alte Scanner-App<br/>:5005"]
|
|
DB3[("MariaDB<br/>project_scanner")]
|
|
end
|
|
|
|
OAI["OpenAI<br/>gpt-4o-mini"]
|
|
BOERSE["Projektboersen<br/>freelancermap, hays, ..."]
|
|
GRAPH["Microsoft Graph<br/>crm@perinco.de"]
|
|
|
|
SPA -->|"HTTPS /api"| AP
|
|
AP --> API
|
|
API --> DB1
|
|
API --> DB2
|
|
SCH --> PW
|
|
PW --> BOERSE
|
|
SCH --> OAI
|
|
SCH --> DB2
|
|
API -.-> SCH
|
|
API -.-> MSCH
|
|
MSCH -->|"Delta Query, nur lesend"| GRAPH
|
|
MSCH --> DB1
|
|
ALT --> DB3
|
|
ALT --> BOERSE
|
|
SPA -.->|"Audio bleibt im Browser"| WSP
|
|
|
|
classDef alt fill:#f7f7f7,stroke:#9a9a9a,stroke-dasharray: 4 3
|
|
class ALT,DB3 alt
|
|
```
|
|
|
|
Gestrichelt: die urspruengliche Scanner-App, die bis zur Ablosung parallel
|
|
weiterlaeuft. Sie hat ihre eigene Datenbank und wird vom CRM nicht angefasst.
|