# Dokumentation ICON CRM

Technische Dokumentation mit Funktionszeichnungen. Die Diagramme sind Mermaid und
werden von Gitea direkt gerendert.

**Neu hier?** Wer die Anwendung *benutzen* will, fängt bei
[08 Anleitung für Benutzer](08-anleitung-benutzer.md) an. Wer daran *entwickeln*
will, bei [09 Anleitung für Entwickler](09-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) | Alle Tabellen als ER-Diagramm, Feld für Feld |
| [03 Frontend](03-frontend.md) | Ansichten, Menü, Komponentenkarte, Designs, Zustand |
| [04 Diktat](04-diktat.md) | Spracherkennung im Browser, Lebenszyklus des Modells |
| [05 KI](05-ki.md) | CV-Import, Schreibhilfe, erweiterte Suche |
| [06 Schnittstellen](06-schnittstellen.md) | ICON Website, perinco CRM in beide Richtungen |
| [07 Betrieb](07-betrieb.md) | Deployment, Umgebungsvariablen, Dienste, Störungssuche |
| [08 Anleitung für Benutzer](08-anleitung-benutzer.md) | Bedienung aller Bereiche, Schritt für Schritt |
| [09 Anleitung für Entwickler](09-anleitung-entwickler.md) | Einrichten, erweitern, bekannte Fallen |
| [10 API-Referenz](10-api.md) | Jeder Endpunkt, seine Rechte und seine Antwort |
| [11 Glossar](11-glossar.md) | Lead, Ausschreibung, Phase, Art, Status – was was bedeutet |
| [12 Scanner](12-scanner.md) | Stellenanzeigen aus Jobbörsen: Quellen, Bewertung, Zeitplan, Endpunkte |

Die Designentscheidungen 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 31.70.144.60"]
        AP["Apache :443"]
        API["Express-Backend<br/>127.0.0.1:5007"]
        WEB["ICON Website<br/>/var/www/icon_website/dist"]
        DB[("MariaDB<br/>icon_CRM")]
    end

    OAI["OpenAI<br/>gpt-6-luna"]
    PCRM["perinco CRM<br/>pcrm.perinco.de"]
    HF["Hugging-Face-CDN"]

    SPA -->|"HTTPS /api"| AP
    AP --> API
    API --> DB
    API -->|"CV-Auslesung, Schreibhilfe, erweiterte Suche"| OAI
    API <-->|"Token, nur GET"| PCRM
    WEB -->|"/api/public/tenders (gleiche Herkunft)"| AP
    SPA -.->|"Audio bleibt im Browser"| WSP
    HF -.->|"einmalig ~300 MB"| WSP
```

Das CRM ersetzt seit dem 14.09.2026 den Supabase-Aufbau des alten ICON CRM. Die
ICON Website liegt seither auf demselben Server und liest ihre Projektbörse aus
derselben MariaDB – über einen öffentlichen, ausschließlich lesenden Endpunkt.