Dokumentation: docs/11-glossar.md

docs/11-glossar.md

@@ -0,0 +1,85 @@
+# 11 Glossar
+
+## Begriffe
+
+**Ausschreibung** – ein Projektangebot eines Kunden oder aus einer Börse. Steht
+in `icon_tenders`. Mit gesetztem Schalter *Online* erscheint sie in der
+Projektbörse der ICON Website.
+
+**Art (eines Kontakts)** – Experte, Ansprechpartner oder Lead. Die Liste wird in
+den Stammdaten gepflegt und kann wachsen.
+
+**Berater** – in den Zeichnungen der Netzwerkansicht die Kontakte mit der Art
+*Experte*; ihr Ast im Stammbaum ist golden.
+
+**Ehemalige / Verlassen** – Kontakte mit einer **beendeten** Anstellung bei
+einem Unternehmen (`icon_employments.ended_on`). Sie hängen am grauen,
+gestrichelten Ast; darunter steht, wo die Person heute ist.
+
+**Erwähnung (@)** – ein Verweis in einem Text auf Kontakt, Unternehmen oder
+Benutzer. Gespeichert als Token `@[Name](contact:12)`, indiziert in
+`icon_mentions`, im Lesezustand anklickbar.
+
+**Group** – der Konzern, zu dem ein Unternehmen gehört (`group_name`). Reiter in
+der Unternehmensansicht.
+
+**Kunde** – kein eigener Datentyp, sondern ein Unternehmen mit
+`is_customer = 1`. Der Zustand *aktiv* oder *alumni* unterscheidet laufende von
+früheren Kunden.
+
+**Lead** – eine Vertriebsspur in der Pipeline (`icon_leads`), nicht zu
+verwechseln mit der Kontaktart *Lead*. Ein Lead trägt Unternehmen,
+Ansprechpartner, Phase, Checkliste und Erinnerung.
+
+**Live!** – die Ausschreibungen als Kanban über die Phasen, bearbeitbar per
+Ziehen.
+
+**Phase (Ausschreibung)** – Ausschreibung → Kontakte sichten → Interview →
+Kunden Interview → Vertragsgestaltung → Abschluss → Geschlossen.
+
+**Spalte (Lead)** – Backlog (`Fuer Spaeter`) → Neuer Lead → Erstkontakt →
+1. Gespräch → Followup geplant → Followup Gespräch → Closed → Absage.
+
+**Status (Ausschreibung)** – Aktiv, Inaktiv, Ausgelaufen, Archiviert.
+
+**Status (Kontakt)** – Interessiert, Interview, Gebucht, Inaktiv. Der frühere
+Wert *Verfügbar* aus dem alten CRM wurde bei der Migration zu *Interessiert*.
+
+**Stammdaten** – die gepflegten Auswahllisten (Branchen, Arten der Kontakte) in
+`icon_options`. Umbenennen zieht den Bestand mit; Entfernen nur, wenn ein Wert
+nirgends benutzt wird.
+
+**Stundensatz** – `rate_onsite` / `rate_remote`, in **Euro je Stunde**. Leer
+heißt *nicht hinterlegt*, nicht *null Euro*. Es gibt im CRM keinen Tagessatz.
+
+**Zuständig (owner)** – der Benutzer, der sich kümmert. Beim Anlegen mit dem
+angemeldeten Benutzer vorbelegt.
+
+## Technische Begriffe
+
+**Diktat / Whisper** – Spracherkennung, die vollständig im Browser läuft. Siehe
+[04 Diktat](04-diktat.md).
+
+**JWT** – das Token der Anmeldung, 12 Stunden gültig, im `localStorage`. Wird
+bei jeder Anfrage zusätzlich gegen die Datenbank geprüft.
+
+**MentionField** – das Textfeld mit zwei Zuständen (lesen / bearbeiten) für
+Texte mit Erwähnungen.
+
+**RichTextEditor** – das WYSIWYG-Feld ohne Fremdpaket, auf `contentEditable`.
+
+**SPA / FallbackResource** – die Anwendung ist eine einzige Seite; Apache
+liefert für jeden unbekannten Pfad `index.html` aus.
+
+**Systemschnittstelle** – die beiden Router, über die ICON CRM und perinco CRM
+Kontakte austauschen: fester Token statt JWT, ausschließlich `GET`.
+
+## Namen und Adressen
+
+| Name | Bedeutung |
+| --- | --- |
+| `icrm.icon-experts.de` | das CRM |
+| `icon-experts.de`, `www.icon-experts.de` | die ICON Website, auf demselben Server |
+| `pcrm.perinco.de` | das perinco CRM (Schwestersystem) |
+| `icondb.perinco.de` | die alte Supabase-Instanz – nur noch Quelle der Migration |
+| `31.70.144.60` | der Server von CRM und Website |