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>
110 lines
4.5 KiB
Bash
110 lines
4.5 KiB
Bash
# perinco CRM Backend
|
|
# Kopie als .env anlegen und Werte setzen. .env niemals committen.
|
|
|
|
PORT=5006
|
|
# Nur lokal binden - von aussen erreichbar ist die App ausschliesslich
|
|
# ueber den Apache-Reverse-Proxy.
|
|
HOST=127.0.0.1
|
|
|
|
DB_HOST=localhost
|
|
DB_PORT=3306
|
|
DB_USER=root
|
|
DB_PASSWORD=changeme
|
|
DB_NAME=perinco_CRM
|
|
|
|
# Signiert die JWT-Sessions. Muss ein langer Zufallswert sein.
|
|
JWT_SECRET=changeme-langer-zufallswert
|
|
JWT_EXPIRES_IN=12h
|
|
|
|
# Wird beim ersten Start angelegt, falls noch kein Benutzer existiert.
|
|
ADMIN_USERNAME=admin
|
|
ADMIN_NAME=Administrator
|
|
ADMIN_EMAIL=admin@perinco.de
|
|
ADMIN_PASSWORD=changeme-starkes-passwort
|
|
|
|
# Das Diktat braucht hier keine Konfiguration: Whisper laeuft im Browser des
|
|
# Benutzers, eingestellt wird es im Reiter "Whisper" der Anwendung.
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Postfachanbindung Microsoft 365 (crm@perinco.de)
|
|
# ---------------------------------------------------------------------------
|
|
# Lesender Zugriff ueber Microsoft Graph mit App-only-Berechtigung
|
|
# (Client Credentials). Benoetigt wird in Entra genau eine
|
|
# Anwendungsberechtigung: Mail.Read, mit Administratorzustimmung. Kein
|
|
# Schreibzugriff, kein Redirect-URI, kein interaktiver Login.
|
|
#
|
|
# Fehlen diese Werte, startet das CRM normal - die Postfachanbindung meldet in
|
|
# den Einstellungen, welche Angabe fehlt, und der Abgleich bleibt aus.
|
|
#
|
|
# In Exchange Online zusaetzlich den Zugriff auf dieses eine Postfach begrenzen,
|
|
# sonst darf die App jedes Postfach im Tenant lesen:
|
|
# New-ApplicationAccessPolicy -AppId <MS_CLIENT_ID> `
|
|
# -PolicyScopeGroupId crm@perinco.de -AccessRight RestrictAccess `
|
|
# -Description "perinco CRM: nur crm@perinco.de"
|
|
MS_TENANT_ID=
|
|
MS_CLIENT_ID=
|
|
MS_CLIENT_SECRET=
|
|
MS_MAILBOX=crm@perinco.de
|
|
|
|
# Ordner im Postfach. "inbox" ist ein von Graph vorgegebener Name.
|
|
# MS_MAIL_FOLDER=inbox
|
|
|
|
# Hintergrundabgleich. Standard ist AN; nur "false" schaltet ihn hart ab.
|
|
# Intervall, Zeitraum und automatische Kontaktuebernahme stehen dagegen in den
|
|
# Einstellungen der Anwendung (Tabelle crm_settings).
|
|
MAIL_SYNC=true
|
|
|
|
# Bremse fuer den Erstabgleich: so viele Delta-Seiten holt ein Lauf hoechstens.
|
|
# Der naechste Lauf setzt an derselben Stelle fort.
|
|
# MAIL_MAX_PAGES=20
|
|
|
|
# Obergrenze fuer den gespeicherten Mailtext je Nachricht (Zeichen).
|
|
# MAIL_MAX_BODY_CHARS=400000
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Projekt Scanner (portiert, laeuft parallel zur alten App)
|
|
# ---------------------------------------------------------------------------
|
|
# Diese Instanz ist vollstaendig eigenstaendig: eigene Datenbank, eigener
|
|
# Schluessel, eigenes Upload-Verzeichnis, eigener Scheduler. Sie fasst die Daten
|
|
# des alten Scanners nicht an.
|
|
|
|
# Eigene Datenbank - wird beim Start automatisch angelegt, falls sie fehlt.
|
|
# NICHT auf project_scanner zeigen lassen, das ist die Datenbank der alten App.
|
|
SCANNER_DB_NAME=perinco_scanner
|
|
# SCANNER_DB_HOST=localhost
|
|
# SCANNER_DB_PORT=3306
|
|
# SCANNER_DB_USER=root
|
|
# SCANNER_DB_PASSWORD=
|
|
|
|
# Eigener Schluessel fuer die Portal-Passwoerter, unabhaengig von der alten App.
|
|
# Langer Zufallswert, z. B.: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
|
|
SCANNER_ENCRYPTION_KEY=
|
|
|
|
# Eigenes Verzeichnis fuer die CV-PDFs. Leer = <server>/uploads.
|
|
SCANNER_UPLOAD_DIR=
|
|
|
|
# Hintergrund-Scraper (Playwright + OpenAI). Standard ist AN; nur "false"
|
|
# schaltet ihn ab. Achtung: solange die alte App laeuft, bewerten beide Instanzen
|
|
# dieselben Projekte unabhaengig voneinander - die OpenAI-Kosten fallen doppelt an.
|
|
SCANNER_SCHEDULER=true
|
|
|
|
# Minuten Versatz fuer den allerersten Lauf dieser Instanz. Verhindert, dass
|
|
# beide Scanner gleichzeitig mit denselben Portal-Sessions losziehen (CAPTCHA).
|
|
# Greift nur, solange noch kein Lauf stattgefunden hat - danach traegt der in der
|
|
# Datenbank gespeicherte Zeitpunkt (last_scan_at) den Zeitplan ueber Neustarts
|
|
# hinweg. 0 = sofort loslegen.
|
|
SCANNER_SCHEDULER_OFFSET=30
|
|
|
|
# Fallback fuer den OpenAI-Key; bevorzugt wird der Wert aus den Einstellungen.
|
|
# OPENAI_API_KEY=
|
|
|
|
# --- Einmalige Uebernahme aus der alten Scanner-Datenbank ---
|
|
# npm run scanner:import [-- --with-matches] [-- --force] [-- --dry-run]
|
|
LEGACY_DB_NAME=project_scanner
|
|
# LEGACY_DB_HOST / _PORT / _USER / _PASSWORD (leer = CRM-Werte von oben)
|
|
# Verzeichnis der CV-PDFs der alten App - von dort werden die Dateien kopiert.
|
|
# LEGACY_UPLOAD_DIR=/opt/project-scanner/backend/uploads
|
|
# ENCRYPTION_KEY der alten App - nur damit koennen die Portal-Passwoerter
|
|
# uebernommen (und hier neu verschluesselt) werden.
|
|
# LEGACY_ENCRYPTION_KEY=
|