Files
perinco-CRM/docs/10-glossar.md
T
Sascha WolfandClaude Opus 5 ea55acdb5c feat(kontakte): Vorbereich "Aus Mails" mit Dublettenabgleich
Der Postfachabgleich hat gefundene Personen bisher direkt in den
Kontaktbestand geschrieben. Damit wächst eine gepflegte Liste ungefragt
mit jeder Adresse aus jeder Mail - genau daran ist das Altsystem
gescheitert.

Funde landen jetzt in einem Vorbereich (crm_leads.mail_pool = 1), der als
Unterpunkt "Aus Mails" unter dem Menüpunkt Kontakte aufklappt. Der
Kontaktbestand bleibt unberührt, bis dort jemand entscheidet; in
Opportunities, Kalender und Netzwerk tauchen die Funde nicht auf.

Eine Spalte statt einer zweiten Tabelle, weil crm_mail_links und
crm_mail_contact_candidates per Fremdschlüssel auf crm_leads zeigen - so
behält der Vorbereich seine Mailbezüge.

Übernehmen kennt zwei Wege:
- neue Person: Kopie mit mail_pool = 0, die Mailverknüpfungen wandern mit
- Dublette (Adresse, sonst voller Name): gold markiert, abweichende
  Felder mit altem und neuem Wert; die Feldauswahl schreibt sie in den
  vorhandenen Kontakt. Vorausgewählt sind nur Lücken - ein Wert aus einer
  alten Signatur soll nichts Gepflegtes stillschweigend ersetzen.

db.js verschiebt beim ersten Start die vorhandenen Kontakte mit
source = 'Mail' in den Vorbereich, einmalig über den Merker
leads_mail_pool_migrated in crm_settings.

Die Sidebar-Gruppe ist dabei generisch geworden (MenuGroup) - Kontakte
und Scanner benutzen jetzt denselben Code.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-11 08:59:14 +02:00

5.7 KiB

10 Glossar

Begriffe, die in der Oberflaeche, im Code und in den Tabellen vorkommen. Die englischen Fachbegriffe sind bewusst nicht eingedeutscht - sie stehen so auch im Quelltext.

Begriff Bedeutung
Agent / Suchagent Ein Beraterprofil im Scanner: Name, Lebenslauf als PDF, Suchbegriffe, Ausschluss-Begriffe. Tabelle agents. Nicht zu verwechseln mit einem Benutzerkonto.
Ausschluss-Begriff Wort, das ein Projekt fuer diesen Agenten sofort aussortiert - noch vor der KI-Bewertung, spart also Kosten. Typisch: „Arbeitnehmerueberlassung".
Benutzer Konto fuer die Anmeldung, Rolle admin oder user. Tabelle crm_users.
Boerse / Portal Projektplattform, die der Scanner durchsucht. Oeffentlich (Hays, Etengo) oder geschuetzt (Freelance.de, Freelancermap.de). Tabelle portals.
App-only Zugriff auf Microsoft 365 im Namen der Anwendung, nicht eines Benutzers (OAuth-Ablauf Client Credentials). Braucht Anwendungsberechtigungen und Administratorzustimmung, aber keinen Login.
Cookie-Import Uebertragen einer angemeldeten Browsersitzung auf den Scraper, per JSON-Export der Erweiterung Cookie-Editor. Landet als session_state am Portal.
Delta Query Graph-Abfrage, die beim naechsten Aufruf nur noch die Aenderungen liefert. Der Fortschritt steckt in einem Verweis (delta_link), der in crm_mail_sync_state liegt.
Kontakt / Lead Person im Netzwerk: Firma, Position, Status, Verbindungen. Tabelle crm_leads mit mail_pool = 0. Im Code durchgaengig lead.
Aus Mails / Vorbereich Zeilen in crm_leads mit mail_pool = 1: Personen, die der Postfachabgleich gefunden hat. Eigener Menuepunkt unter Kontakte, taucht in keiner Auswahlliste auf. Erst das Uebernehmen macht daraus einen Kontakt.
Dublette (Aus Mails) Ein Fund, zu dem es in den Kontakten schon eine Person gibt - erkannt an der E-Mail-Adresse, sonst am vollen Namen. In der Liste gold markiert, abweichende Felder hervorgehoben.
Kontakt-Vorschlag Aus einer Mail gelesene Person, die noch kein Kontakt ist. Tabelle crm_mail_contact_candidates. Wird uebernommen, ergaenzt oder verworfen.
Match / Treffer Die Bewertung eines Projekts fuer einen Agenten: Prozentwert, Pro-Liste, Contra-Liste, Status. Tabelle matches. Ein Projekt erzeugt so viele Treffer, wie es aktive Agenten gibt.
Opportunity Geschaeft in Arbeit: Phase, Tagessatz, Laufzeit, Wahrscheinlichkeit, Ansprechpartner. Tabelle crm_opportunities.
Phase / Stage Fortschritt einer Opportunity: Neu, Qualifizierung, Angebot, Verhandlung, Gewonnen, Verloren.
Pipeline Zwei Bedeutungen, je nach Zusammenhang: die Kanban-Ansicht der Opportunities oder der Suchlauf des Scanners (services/pipeline.js).
Projekt Ein von einer Boerse gescrapter Auftrag. Tabelle projects, Aufbewahrung 7 Tage.
Scraper Der Teil, der mit einem echten Browser (Playwright/Chromium) die Suchseiten der Boersen abruft.
Session (Portal) Gespeicherte Cookies einer angemeldeten Boersen-Sitzung, im Playwright-Format storageState.
Sitzung (CRM) Die eigene Anmeldung, als JWT im localStorage, 12 Stunden gueltig.
Suchintervall Abstand zwischen zwei automatischen Suchlaeufen, in Minuten. Einstellung search_interval.
Schwellenwert Anzeige display_threshold - Treffer darunter bleiben im Dashboard ausgeblendet.
Schwellenwert Benachrichtigung match_threshold - ab hier gibt es Signalton und E-Mail.
Verbindung Kante zwischen zwei Kontakten im Netzwerkdiagramm, mit Art und Staerke. Tabelle crm_lead_connections.
Volumen Tagessatz x Personentage. Gewichtet heisst zusaetzlich mit der Abschlusswahrscheinlichkeit multipliziert.
Whisper Das Spracherkennungsmodell fuer das Diktat. Laeuft im Browser, nicht auf dem Server.
Zugriffsrichtlinie ApplicationAccessPolicy in Exchange Online. Begrenzt eine App-only-Berechtigung auf einzelne Postfaecher - ohne sie gilt sie tenant-weit.
Zustaendiger / Owner Benutzer, dem ein Kontakt oder eine Opportunity zugeordnet ist. Darf sie aendern, auch wenn er sie nicht angelegt hat.
Zuversicht / Confidence Wert von 0 bis 100 an einem Kontakt-Vorschlag. Ab 70 und mit echter Mailadresse landet er automatisch im Vorbereich Aus Mails.

Herkunft eines Kontakt-Vorschlags

Wert in der DB in der Oberflaeche Zuversicht
absender Absender 90, mit bestaetigender Signatur 95
empfaenger Empfaenger 78
signatur Signatur 55 - weitere Adresse in der Signatur, etwa eine Assistenz
text Im Text genannt 35 - nur mit Anrede und Rufnummer, nie automatisch uebernommen

Status eines Kontakt-Vorschlags

Wert in der Oberflaeche Bedeutung
offen Offen wartet auf eine Entscheidung
uebernommen Uebernommen es entstand ein Eintrag - im Automatiklauf in Aus Mails, von Hand ein Kontakt
dublette Ergaenzt die Adresse war im Zielbestand vorhanden, der Eintrag wurde erweitert
verworfen Verworfen von Hand abgelehnt

Statuswerte im Scanner

Wert in der DB in der Oberflaeche Bedeutung
new Neu noch nicht angesehen
reviewed Gesehen geprueft, noch keine Bewerbung
applied Beworben Bewerbung ist raus
rejected Abgelehnt passt nicht; erscheint nur unter Unpassend

Portal-Status

Wert Bedeutung
connected Verbindung steht, letzte Pruefung erfolgreich
expired Session abgelaufen oder CAPTCHA - neuer Cookie-Import faellig
error Portal nicht erreichbar oder Seitenaufbau geaendert
disconnected nie verbunden; bei oeffentlichen Portalen heisst das nur „bereit"