Files
perinco-CRM/docs
Sascha WolfandClaude Opus 5 1ac0e2d2c7 feat(opportunities): Papierkorb statt endgueltigem Loeschen
Das Loeschsymbol gab es in der Kachelansicht schon, es war aber bis zum
Ueberfahren durchsichtig - ein Knopf, den man nur findet, wenn man ihn kennt.
Jetzt ist er sichtbar, in der Liste ebenso, und die Pipeline-Karte hat ihn
ueberhaupt zum ersten Mal.

Geloescht wird nicht mehr endgueltig: DELETE setzt deleted_at, die Zeile bleibt.
An einer Opportunity haengen Ansprechpartner, Verlauf und Mailzuordnungen, und
ein Fehlklick soll das nicht kosten. Der Papierkorb ist ein Unterpunkt unter
Opportunities und zeigt, wann und von wem geloescht wurde und wie lange der
Eintrag noch liegt. Zurueckholen darf, wer auch loeschen darf; das Leeren jeder
Angemeldete - was dort liegt, hat schon jemand mit den noetigen Rechten
weggeworfen. Beides fragt vorher nach.

Nach 90 Tagen raeumt das Backend selbst auf, beim Abruf der Liste und hoechstens
einmal pro Stunde je Prozess - dasselbe Muster wie in der Akquise. Ein eigener
Zeitplan waere eine weitere Stelle, die ausfallen kann, und die Abfragen filtern
Faelliges ohnehin heraus.

Im Papierkorb liegende Opportunities sind aus allen Listen, Summen und
Zuordnungsdialogen heraus und lassen sich nicht bearbeiten (409) - erst
zurueckholen, dann aendern.

Nebenbei: der Header bekommt seinen Titel jetzt ueber viewTitle(). Der
Ansichtsname musste eindeutig sein ("Opportunity-Papierkorb", weil die Mails
schon einen Papierkorb haben), angezeigt wird beides als "Papierkorb".

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

Dokumentation perinco 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 07 Anleitung für Benutzer an. Wer daran entwickeln will, bei 08 Anleitung für Entwickler. Beide setzen keine Vorkenntnisse voraus.

Kapitel Inhalt
01 Architektur Topologie, Prozesse, Ports, Anfrageweg, Rollen
02 Datenmodell Tabellen beider Datenbanken als ER-Diagramme
03 Projekt Scanner Suchlauf von der Börse bis zum Treffer, Parallelbetrieb
04 Diktat Spracherkennung im Browser, Modell-Lebenszyklus
05 Frontend Ansichten, Menü, Komponentenkarte, Zustand
06 Betrieb Deployment, Umgebungsvariablen, Dienste, Störungssuche
07 Anleitung für Benutzer Bedienung aller Bereiche, Schritt für Schritt
08 Anleitung für Entwickler Einrichten, erweitern, bekannte Fallen
09 Quellcode-Referenz jede Datei, ihre Exporte und Zusagen
10 Glossar Agent, Match, Lead, Opportunity, Status- und Portalwerte
11 Postfachanbindung crm@perinco.de über Microsoft Graph, Kontakte aus Mails

Die Designentscheidungen und die Messwerte zur Spracherkennung stehen im README des Projekts.

Das Ganze in einem Bild

flowchart TB
    subgraph Browser
        SPA["React-SPA<br/>Vite-Build"]
        WSP["Whisper im Web Worker<br/>WebGPU / WASM"]
    end

    subgraph Server["Server 212.227.135.41"]
        AP["Apache<br/>:443"]
        API["Express-Backend<br/>127.0.0.1:5006"]
        SCH["Scanner-Scheduler<br/>node-cron"]
        MSCH["Mail-Scheduler<br/>node-cron"]
        PW["Playwright<br/>Chromium"]
        DB1[("MariaDB<br/>perinco_CRM")]
        DB2[("MariaDB<br/>perinco_scanner")]
        ALT["alte Scanner-App<br/>:5005"]
        DB3[("MariaDB<br/>project_scanner")]
    end

    OAI["OpenAI<br/>gpt-4o-mini"]
    BOERSE["Projektbörsen<br/>freelancermap, hays, ..."]
    GRAPH["Microsoft Graph<br/>crm@perinco.de"]

    SPA -->|"HTTPS /api"| AP
    AP --> API
    API --> DB1
    API --> DB2
    SCH --> PW
    PW --> BOERSE
    SCH --> OAI
    SCH --> DB2
    API -.-> SCH
    API -.-> MSCH
    MSCH -->|"Delta Query, nur lesend"| GRAPH
    MSCH --> DB1
    ALT --> DB3
    ALT --> BOERSE
    SPA -.->|"Audio bleibt im Browser"| WSP

    classDef alt fill:#f7f7f7,stroke:#9a9a9a,stroke-dasharray: 4 3
    class ALT,DB3 alt

Gestrichelt: die ursprüngliche Scanner-App, die bis zur Ablosung parallel weiterläuft. Sie hat ihre eigene Datenbank und wird vom CRM nicht angefasst.