Files
perinco-CRM/docs/10-glossar.md
T
Sascha WolfandClaude Opus 5 4d90f14d6b docs: Anleitungen fuer Benutzer und Entwickler, Quellcode-Referenz, Glossar
Die bisherige Dokumentation beschrieb die Architektur, half aber niemandem, der
die Anwendung zum ersten Mal oeffnet. Dazu jetzt vier Kapitel:

- 07 Anleitung fuer Benutzer: was die Anwendung tut, jeder Bereich Schritt fuer
  Schritt, warum der Signalton nur im Dashboard klingelt, was Loeschen eines
  Suchagenten mitnimmt
- 08 Anleitung fuer Entwickler: einrichten, pruefen, Feld/Menuepunkt/Reiter/
  Endpunkt hinzufuegen, dazu eine Tabelle der Fallen, die real Zeit gekostet
  haben (Routen-Reihenfolge, FormData, Leerzeichen in Pfaden, Zeitstempel
  koennen nur vorziehen, Kaskaden beim Loeschen)
- 09 Quellcode-Referenz: jede Datei mit ihren Exporten und den Zusagen, auf die
  sich der Rest verlaesst
- 10 Glossar: Agent, Match, Lead, Opportunity und die Statuswerte der Datenbank

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

3.6 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.
Cookie-Import Uebertragen einer angemeldeten Browsersitzung auf den Scraper, per JSON-Export der Erweiterung Cookie-Editor. Landet als session_state am Portal.
Kontakt / Lead Person im Netzwerk: Firma, Position, Status, Verbindungen. Tabelle crm_leads. Im Code durchgaengig lead.
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.
Zustaendiger / Owner Benutzer, dem ein Kontakt oder eine Opportunity zugeordnet ist. Darf sie aendern, auch wenn er sie nicht angelegt hat.

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"