--- stepsCompleted: [1, 2, 3, 4] inputDocuments: - /tmp/hivegrid-inventory-codebase.md - /tmp/hivegrid-inventory-planning.md - /tmp/hivegrid-apple-rules.md session_topic: 'HiveGrid SaaS — Sauberes Re-Planning vor 3. Anlauf (Pflichten-/Lastenheft als Output, Geerkens als Erstkunde)' session_goals: 'Lücken aus den letzten zwei Anläufen finden, klares Scope-Modell, Spec-Tiefe statt Feature-Liste, Verifikations-Basis für Noah' selected_approach: 'AI-Recommended (Pre-mortem → Role-Play → Modul-für-Modul-Schnitt → Edge-Case-Jagd)' techniques_used: - 'Pre-mortem (5 Risiko-Szenarien)' - 'Role-Play (begonnen, dann zu Modul-Schnitt gewechselt da Workflow-Aufteilung analytisch ist)' - 'Modul-für-Modul-Schnitt mit Phase-1/Phase-2/Raus-Verdikt (40 Module)' - 'Edge-Case-Jagd entlang USP-Säulen (9 Edge-Cases, Automation/KI/Legacy)' ideas_generated: [] context_file: '' --- # Brainstorming Session Results **Facilitator:** Raffael **Date:** 2026-05-07 ## Session Overview **Topic:** HiveGrid SaaS — Sauberes Re-Planning vor 3. Anlauf (Pflichten-/Lastenheft als Output, Geerkens als Erstkunde) **Goals:** - Lücken aus den letzten zwei Anläufen finden, die nicht gesehen wurden - Klares Scope-Modell für Phase 1 statt 97-Feature-Liste - Spec-Tiefe (Menüpfade, Entitäten, Funktionen) statt Vision-Ebene - Verifikations-Basis, die Noah inhaltlich freigeben kann ## Kontext aus Phase 1 (Inventur) - **Codebase-Stand (verworfen):** ~50 Prisma-Schemas, ~150 Entitäten, 39 Feature-Module — die meisten als "vollständig" implementiert, aber als Spaghetti. Mobile-App war P0 im Plan, im Code nur Expo-Skeleton. Taifun-ERP war P0 im Plan, im Code gar nicht da. Der Code hat strategische Stufen-Trennung (Cloud/Cloud+/Enterprise) ignoriert — alles wurde gebaut, statt Cloud sauber zu halten. - **Planning-Stand März 2026:** Vision + 97 Features in 18 Kategorien + 7 End-to-End-Journeys. **Keine Architecture-Doc, keine Epics, keine Stories** — `implementation-artifacts/` war leer. 30 Annahmen, 24 Lücken im Plan dokumentiert. - **Wahre Ursachen für Spaghetti (User-Aussage):** Kaputte UI-Iterationen, unsaubere Boilerplate, Workspace-Tenant-Modell wirr, kein Entitäten-System, Planung blieb auf "Ich will Feature X"-Ebene statt "Feature X mit Menü Y und 34 Funktionen". --- ## Phase 2 — Reflektion: Leitplanken ### LP-1 — Eine Handwerksfirma = ein Tenant = ein Workspace Multi-Tenant-Modell sauber von Anfang an. Admin-Routes und App-Routes hart getrennt. Rollen gehören zur Workspace-Welt, nicht zur Plattform-Admin-Welt. URL-Schema: `app.hivegrid.de/{tenant}/...`. ### LP-2 — Büro vs. Baustelle als kontextuelle Modi Eine App, nicht zwei. Aber kontextuell zwei klar getrennte Erlebnisse: Büro-Welt = volle Plattform am Desktop. Baustellen-Welt = mobile-first, WhatsApp-einfach. Diese Achse muss strukturell durchgezogen werden, nicht nur per Feature-Toggle. Spiegelt sich auch im Pricing (Büro-Seat vs. Monteur-Seat). ### LP-3 — Modular-Architektur, SHK-Inhalt Architektur Tag-1 modular vorbereitet (Entitäten erweiterbar, Pipelines konfigurierbar, Branchen-Templates als deklarative Konfiguration austauschbar). **Aber Inhalt zum Launch kompromisslos SHK-fokussiert.** Andere Gewerke (Maler, Elektro) erst mit zahlendem Kunden. Onboarding-Wizard zeigt SHK pre-selected; andere Branchen sichtbar als "Coming soon". Genau das war im letzten Anlauf der Spaghetti-Trigger ("alles könnte mal"). ### LP-4 — USP-Säulen vs. Commodity-Säulen - **USP (hier toben wir uns aus):** Automation-Engine, KI als Bedienoberfläche, Legacy-Anbindung (KWP/Taifun) - **Commodity (gut genug, kein Wettbewerb):** CRM, HR-Hub, Booking, Kalender — müssen HubSpot/Quiply ablösen können, aber nicht "besser" als sie sein - Aufwandsverteilung folgt dieser Trennung ### LP-5 — KI ist die Schnittstelle zur Automation-Engine Statt "klicke dir Trigger zusammen" → "sag der KI was du willst, sie baut das Wenn-Dann-Konstrukt". Visuelles Editieren bleibt möglich, aber **erschaffen** läuft über Sprache. Damit greifen die USP-Säulen ineinander statt nebeneinander zu stehen. KI bleibt in Phase 1 ein Werkzeug auf User-Trigger — autonome Agents kommen erst Phase 2 (Vertrauensgewinn aufbauen). ### LP-6 — Anti-Agentur-Positionierung (Markenkern) Selbst-Wartbarkeit als USP. Automationen müssen für Noah und "den dummen Handwerker" pflegbar sein. Transparente Diagnostik statt Black-Box-Fehler ("Webhook 401" → "Die Buchhaltungs-Software hat den Auftrag nicht angenommen, Anmeldung läuft ab in 7 Tagen"). Die Plattform befreit Mittelständler aus der Agentur-Abhängigkeit. ### LP-7 — Ablösungs-Logik bei Geerkens (klarer Scope-Filter) - **Wird abgelöst:** HubSpot (CRM+Lead+Booking+Email-Marketing), Quiply (Mitarbeiter-App), Zapier+n8n+Supabase (Glue), teilweise Google Kalender - **Bleibt:** KWP (rechtlich/groß), AirCall (USP-Tool), Google Workspace (Mails/Docs), PandaDoc (Integration, keine Eigenentwicklung) - Filter für Phase-1-Features: "Was Geerkens heute woanders nutzt und ablösen will = Pflicht. Rest = später." ### LP-8 — App-Store-Strategie: Capacitor-Wrapper Web-App + Capacitor-Wrap für iOS/Android. Apple-Compliance über Enterprise-Services-Ausnahme (3.1.3(c)) — **keine Pricing/Upgrade-UI in der App**, nur Login + App-Funktionen. Min. 3 native Features (Push, Face-ID, Kamera). Account-Löschung in der App (Pflicht). Privacy Manifest, Reviewer-Demo-Account. **Offline-Modus für Baustelle ist Phase-1-Pflicht** (Service-Worker + IndexedDB + Sync-on-Reconnect mit Last-Write-Wins für Status-Felder, append-only für Fotos/Notes). ### LP-9 — Spec-Tiefe statt Feature-Liste (Output-Format) Pflichten-/Lastenheft muss pro Feature liefern: Menüpfad, Entitäten/Felder, Sub-Funktionen, Permissions, Übergänge zu anderen Modulen. Nicht "Ich will CRM", sondern "CRM hat Menüpunkte X/Y/Z, Entität Kontakt mit Feldern A-N, verknüpft mit Deal/Pipeline/...". ### LP-10 — Klartext-Diagnostik als bauliche Pflicht (aus Pre-mortem #2) Jedes Feature, jede Integration, jede Automation muss eine **fest formulierte Klartext-Erklärschicht** haben (Variante a, nicht KI-on-the-fly). Pro Fehler-Case ist ein menschenlesbarer Text + Lösungs-Button definiert. Kein Feature wird ohne diese Erklärschicht gemerged. Schiebt Spec-Tiefe weiter nach oben — gewollt. ### LP-11 — Adapter-Pattern als Architektur-Vorschrift (aus Modul 19/33a) Externe Integrationen (KWP, Gmail, AirCall, Stripe, PandaDoc, Calendar...) sprechen gegen ein abstraktes Adapter-Interface, nicht direkt. Die "Apps Engine" liefert dieses Interface. KWP ist die erste ERP-Implementierung. Andere ERPs (Taifun, TopKontor, Streit) hängen sich später an dasselbe Interface, ohne dass Engine umgebaut wird. Connection-Settings, Sync-Jobs und Klartext-Diagnostik sind über alle Apps einheitlich. ### LP-12 — i18n extrem sauber, mehrere Sprachen easy Alle UI-Strings konsequent aus Locale-Files. Phase 1: nur DE-Locale befüllt. Phase 2: DeepL-Pipeline für DE→EN/TR/PL Übersetzungen. Damit ist Sprache wirklich kostenlos erweiterbar. ### LP-13 — EU-Stack komplett (aus Pre-mortem #5) Hosting, DB, Worker auf Scaleway (EU). KI-Provider ausschließlich EU (Scaleway Generative, Mistral, AlephAlpha — kein Anthropic/OpenAI). Trade-off: Modell-Qualität ist nicht GPT-5-Niveau, ist aber für unsere Use-Cases (Klartext-Diagnostik, Automation-Vorschläge, RAG-Suche) absolut ausreichend. Marketing-Argument: "100% EU, 100% DSGVO". --- ## Phase 3 — Pre-mortem: Schutz-Mechanismen Ein-Jahr-zurück-Blick (Mai 2027). 5 Failure-Szenarien durchgegangen, pro Szenario Schutz-Mechanismus festgelegt: ### PM-1 — Scope-Drift / Wiederholungs-Fehler **Schutz:** - **Anti-Liste** im Pflichtenheft: explizit namentlich „NICHT in Phase 1: WhatsApp-Marketing, Knowledge-Base, CMS, Marketplace, Custom-Subdomain..." - **Change-Request-Regel** zwischen Raphael und Noah: neue Features nach Sign-off des Pflichtenhefts gehen in eine Change-Request-Liste mit Datum und Zustimmung. Kein stillschweigendes Mitnehmen in Phase 1. ### PM-2 — Black-Box-Falle **Schutz:** - **Klartext-Diagnostik als bauliche Pflicht** (Variante a — fest formulierte Texte, kein KI-on-the-fly). Siehe LP-10. ### PM-3 — KI-Schaden (Auto-Aktion mit unbeabsichtigter Reichweite) **Schutz:** - **Dry-Run/Vorschau-Pflicht** vor Aktivierung jeder KI-erzeugten Automation: zeigt Anzahl betroffener Entitäten, Stichprobe der ersten 5, Bestätigung erforderlich - **Reversibilität / Undo-Funktion** für letzte 24h Wirkungen: zeigt wer betroffen war, ermöglicht Nachschicken/Entschuldigen ### PM-4 — KWP-Schema-Drift **Schutz:** - **Schema-Drift-Sentinel**: täglicher Job, der gegen die KWP-DB checkt ob erwartete Tabellen/Spalten/Datentypen noch da sind. Push-Alert an Raphael bei Abweichung. Vorsprung bevor Sandra den Bruch live merkt. ### PM-5 — DSGVO-Verkaufsblocker **Schutz:** - **Kompletter EU-Stack** (Hosting + KI). Siehe LP-13. --- ## Phase 4 — Modul-für-Modul-Schnitt (Phase 1 / Phase 2 / Raus) > **Wichtiger Hinweis:** Das ist ein **oberflächlicher Sweep** zur Scope-Festlegung. Pro Modul folgt im nächsten Schritt eine **Detail-Spec** (Menüpfade, Entitäten, Sub-Funktionen, Permissions, Übergänge zu anderen Modulen) gemäß LP-9. ### Phase 1 — Cloud-Launch-Scope (Geerkens-fokussiert) | # | Modul | Verdikt | Anmerkungen | |---|---|---|---| | 1 | CRM-Kern (Kontakte + Firmen) | **Phase 1, voll** | Ohne CSV-Import (Migration parked) | | 2 | Lead-Inbox / Lead-Management | **Phase 1, voll** | HubSpot-Lead-Ablösung | | 3 | Sales-Pipeline (Deals) | **Phase 1, voll** | HubSpot-Pipeline-Ablösung | | 4 | Auftrags-/Projektpipeline | **Phase 1, voll** | Geerkens-Kern, inkl. Plantafel + Acceptance | | 5 | Form Builder | **Phase 1, XL** | Voll Google-Forms-Niveau (User-Entscheidung); Klebstoff | | 6 | Booking | **Phase 1, voll** | HubSpot-Booking-Ablösung | | 7 | Angebot + Signatur | **Phase 1** | Nur PandaDoc/DocuSign-Integration, keine eigene eIDAS-Engine. Acceptance-Signatur direkt im Form-Builder | | 9 | Email Inbox + Gmail/Outlook-Sync | **Phase 1** | Plus eigene Sending-Domain mit DKIM (für Modul 10 nötig) | | 10 | Email-Marketing | **Phase 1, voll** | (User-Korrektur: HubSpot-Marketing kritisch genug) | | 12 | Telefonie (AirCall) | **Phase 1** | Nur AirCall, Sipgate Phase 2 | | 13 | Team-Chat | **Phase 1, voll** | 3 Ebenen (Projekt/Gruppe/DM), Pinned, Reactions, Threads | | 14 | HR-Hub / Mitarbeiterplattform | **Phase 1, voll** | (User-Korrektur: alles drin, Quiply-Komplett-Ablösung) | | 15 | Customer-Portal | **Phase 1, voll** | (User-Korrektur: kritisch genug) | | 17 | Automation Engine | **Phase 1, voll** | Mit Dry-Run, Reversibilität, Klartext-Logs, KI-Erstellung | | 18 | KI-Layer | **Phase 1 als Werkzeug** | LLM-Gateway EU, Lead-Zusammenfassung, Programm-Hilfe, RAG, Whisper. Autonome Agents Phase 2 | | 19 | KWP-Integration | **Phase 1** | Nur KWP. Über Adapter-Pattern (LP-11). Schema-Drift-Sentinel (PM-4) | | 20 | Dashboard / Reporting | **Phase 1, GF-fokussiert** | Pipeline-KPIs, Forecast, Vertriebler-Performance mit Drill-Down | | 21 | Audit-Log | **Phase 1** | Diff, Filter, 24-Monate-Default-Retention | | 22 | Notifications | **Phase 1, voll** | Push/Email/In-App, Anti-Spam-Bündelung, Ruhezeiten | | 23 | Files / Dokumente | **Phase 1, voll** | Scaleway-Storage EU | | 24 | Globale Suche | **Phase 1** | Hybrid (FTS + Embeddings), Permission-aware | | 25 | Calendar-Sync (Google + MS) | **Phase 1, voll, bidirektional** | OAuth pro User | | 26 | Tasks | **Phase 1, voll** | Aus Chat / Form / Automation erstellbar | | 27 | Auth/Multi-Tenancy/Rollen | **Phase 1, voll** | Inkl. **2FA** (User-Korrektur), 7 Rollen, Magic-Link, OAuth Microsoft (kein Google wegen SIWA-Trigger) | | 28 | Subscriptions/Billing | **Phase 1** | Stripe + Seat-Modell (Büro/Monteur) + Trial + Read-Only-Downgrade | | 29 | Onboarding | **Phase 1, deklarativ branchen-modular** | SHK pre-selected, andere "Coming soon", Demo-Daten-Provisioning | | 30 | i18n / Mehrsprachigkeit | **Phase 1, DE-only** | Library extrem sauber, Phase 2 DeepL-Pipeline (LP-12) | | 31 | Branding/Theme | **Phase 1: nur Light/Dark-Mode** | Rest Phase 2 (User-Korrektur) | | 32 | Feature-Flags | **Phase 1, minimal** | Nur Admin-Werkzeug für uns | | 33a | Apps Engine (Adapter-Layer) | **Phase 1, voll** | Foundation für alle Integrationen (LP-11) | | 34 | Public API & Webhooks | **Phase 1, basic** | Read-API + Webhooks, kein Schreib-API | | 35 | DSGVO-Export / Löschung | **Phase 1, voll** | Pflicht (DSGVO + Apple-Account-Löschung) | | 36 | Mobile-App (Capacitor) | **Phase 1** | Mit Push/Face-ID/Kamera + **Offline-Modus dringend** | | 37 | Plattform-Admin | **Phase 1, basic** | Was wir zum Betrieb brauchen | | 38 | Help-Center (öffentlich) | **Phase 1, minimal** | ~10-20 Markdown-Artikel | | 39 | Help-Desk / Support | **Phase 1, basic** | Email + In-App-Feedback-Widget | ### Phase 2 — Nach Geerkens-Launch | # | Modul | Anmerkungen | |---|---|---| | 8 | Rechnung / Buchhaltung-UI in HiveGrid | (KWP-Native-Integration nach KWP-Termin neu evaluieren) | | 11 | WhatsApp | (User-Korrektur: kein Fokus für Geerkens) | | 16 | Knowledge Base / Wiki | Anti-Listen-Kandidat, kein Geerkens-Pain | | 18 | KI als autonomer Agent (HiveMind) | Custom-Tools, Scheduled-Actions, Screen-Context | | 19 | Taifun + TopKontor + Streit V.1 ERPs | Über Adapter-Pattern (LP-11), erst mit zahlendem Kunden | | 27 | IP-Whitelisting, SAML/SSO | | | 27 | **Custom-Subdomain nur Enterprise** | (User-Korrektur) | | 31 | Branding voll: White-Label, Custom-Fonts, Email-Templates, Custom-Login | | | 33b/c | Community-App-Marketplace, Template-Marketplace | Klassische Anti-Listen-Kandidaten | | 34 | Voll-CRUD-API + GraphQL + OAuth2-für-Drittanbieter | | | 36 | NFC, Bluetooth, advanced native Features | | ### Anti-Liste — explizit NICHT in Phase 1 - WhatsApp komplett (auch nicht Standard-Inbox) - Knowledge Base / Wiki intern - Eigene Rechnungs-UI / Buchhaltungs-Adapter (LexOffice, sevDesk, FastBill, Datev) - Customer Portal: bidirektionale Kommunikation, Blog, Multi-Portal-Branding - HiveMind als autonomer Agent (Custom-Tools, Scheduled-Actions) - Taifun, TopKontor, Streit V.1 - Sipgate Telefonie - Branding über Logo/Primärfarbe hinaus - IP-Whitelisting, SAML, 2FA-Hardware-Keys - API-Schreib-Operationen, GraphQL - Community-App-Marketplace, Template-Marketplace - Sites / MySite / Blog / CMS — **komplett raus, auch Phase 2/3** (Marketing-Site `hivegrid.de` ist eigene Sache) - Form-Verzweigungslogik, Form-Charts/Reporting - Versionierung von Angeboten (V1/V2/V3) - WhatsApp-Marketing - Apple-Login (nur falls Reviewer drauf besteht) - Google-OAuth (würde SIWA-Pflicht triggern) - Sub-Workflows, Loops in Automation-Engine ### Modul-Architektur-Vorschriften (für Pflichtenheft) 1. **Klartext-Diagnostik pro Feature** (LP-10) — Pflicht-Abschnitt im Spec 2. **Adapter-Pattern für Integrationen** (LP-11) — auch wenn nur 1 Implementierung 3. **Branchen-Templates deklarativ, nicht hartkodiert** — Onboarding-Wizard liest Templates aus Konfiguration 4. **i18n: alle Strings extern** — kein hartkodierter Text 5. **Permissions-aware-Default** — jede Liste/Suche/View filtert nach User-Permissions ohne separate Logik 6. **Audit-Trail-Default** — jedes schreibende Aktion wird auditierbar geloggt 7. **Feature-Flag-Hülle** — neue Features werden mit Flag eingeführt, dann breit ausgerollt --- ## Geparkt für später (eigene Runden) - Migration aus HubSpot/Quiply/KWP-Bestand - Pricing-Modell konkret (Cloud/Cloud+/Enterprise, Trigger-Volumen, Setup-Fee, Seat-Preise) - Konkreter Sales-Flow (Self-Service vs. Enterprise-Demo) - KWP-Native-Integration nach KWP-Geschäftsführer-Termin neu evaluieren - Detail-Spec pro Modul (Menüpfade, Entitäten, Funktionen, Permissions) — kommt nach diesem Sweep --- ## Phase 5 — Edge-Case-Jagd (Schutz-Mechanismen pro USP-Säule) 9 Edge-Cases entlang der drei USP-Säulen durchgegangen. Pro Edge-Case wurden alle vorgeschlagenen Schutz-Mechanismen vom User bestätigt — alles wird in Phase 1 als bauliche Pflicht aufgenommen. ### Säule 1 — Automation-Engine #### EC-1 — Webhook-Storm Spam-Welle füttert über Kontaktformular 2.000 Fake-Leads in 5 Min → 2.000 Aufträge in KWP, 2.000 Pushes. - **Hard-Limit:** Tenant-konfigurierbar, max-Trigger pro Stunde, Rest verworfen mit Notification - **Anomalie-Detection:** System erkennt 10x-normale-Rate-Spike, pausiert Automation automatisch mit Klartext-Hinweis - **Beides aktiv** (Hard-Limit als Backup, Anomalie-Detection als smarter Schutz davor) #### EC-2 — Automation-Loop Selbst-triggernde Schleife (A setzt Tag, B reagiert auf Tag und ändert Stage, A reagiert auf Stage…). - **Hardes Limit:** max. 5 Auto-Trigger pro Datensatz pro 60 Sek, danach Abbruch - **Klartext-Stopp:** bei Abbruch sieht User die Trigger-Kette visuell + Lösungs-Hinweis - **Pre-Save-Validation beim Erstellen:** System prüft Abhängigkeits-Graph beim Speichern und warnt vor potenziellen Schleifen - (User-Erweiterung: noch zusätzliche Schutz-Schicht falls sinnvoll) #### EC-3 — Halbe Ausführung Automation hat 5 Schritte, Schritt 4 (KWP) scheitert → 1-3 sind durch, 4-5 nicht; Retry-Komplett würde Schritte 1-3 doppelt ausführen. - **Idempotenz pro Action** mit Idempotency-Key — Action prüft "schon erledigt?" bevor sie ausführt - **Resume-Mode** — Retry beginnt am fehlgeschlagenen Schritt, nicht von vorne - **Klartext-Halb-Status** im Execution-Log mit User-Optionen (Retry / Manuell / Skip / Abbruch) ### Säule 2 — KI-Layer #### EC-4 — KI-Halluzination bei Automation-Erstellung KI erfindet nicht-existente Felder, rät bei mehrdeutigen Namen, erkennt semantische Risiken nicht. - **Schema-Validation:** KI darf nur existierende Felder/Entitäten/User/Pipelines referenzieren — Validation vor Vorschau - **Rückfrage bei Mehrdeutigkeit:** KI darf nicht raten — bei zwei Klausens fragt sie zurück - **Semantische Risiko-Hinweise:** bei Filter-Bedingungen mit false-positive-Risiko ergänzt KI Klartext-Warnung im Vorschau-Text #### EC-5 — Prompt-Injection Bösartige Eingabe via externe Daten (Form-Submission, eingehende Mail, WhatsApp-Text) versucht KI zu hijacken. - **Input-Sanitization** für alle externen Daten bevor sie als KI-Kontext serviert werden — Markup-Marker neutralisiert - **Strikte Trennung System-Prompt / User-Daten** im Prompt-Template + Tool-Calling-Architektur (Mistral-Large EU-konform) - **Action-Boundary für KI:** KI darf aus RAG-Kontext oder externen Daten **niemals** schreibende Aktionen ableiten ohne separate User-Bestätigung - **Promptfoo-Eval-Suite mit Standard-Injection-Vektoren als Pflicht für jeden neuen Prompt-Flow** (User-Erweiterung — kontinuierliche Tests, nicht einmaliger Build) #### EC-6 — KI-Provider Down Mistral-API 30 Min nicht erreichbar — Lead-Zusammenfassungen, Automation-Erstellung, RAG-Suche fallen aus. - **Multi-Provider-Fallback** — primär Mistral, sekundär Scaleway-Hosted-Modelle, tertiär AlephAlpha; alle EU-konform - **Graceful Degradation** — KI-getriebene UI-Elemente zeigen Klartext-Hinweis und Fallback-Modus (z.B. "Nutze visuellen Editor stattdessen") - **Cache für deterministische KI-Outputs** — gleiche Hilfe-Antworten/Lead-Zusammenfassungen werden gecacht, viele User auch bei Down produktiv ### Säule 3 — Legacy-Anbindung (KWP) #### EC-7 — kwpsync.exe stoppt unbemerkt Windows-Auto-Update stoppt kwpsync.exe → Daten fließen 8h nicht, niemand merkt's. - **Heartbeat:** kwpsync.exe pingt HiveGrid alle 5 Min, 15 Min ohne Ping → Alert - **Sichtbarer Connection-Status** überall wo KWP-Daten gezeigt werden (grün/gelb/rot mit Klartext-Lösung) - **Auto-Recovery via Windows-Service** — kwpsync.exe als Windows-Service mit Wrapper (NSSM), Auto-Restart bei Crash, Auto-Start nach Reboot #### EC-8 — Queue-Backlog nach HiveGrid-Outage HiveGrid 6h down, 1.230 Operationen in lokaler kwpsync-Queue, Burst beim Wiederhochfahren. - **Persistente Queue mit Timestamps** — SQLite, unbegrenzte Größe, chronologisches Replay - **Rate-Limiting beim Einspielen** — max. 100 Ops/Min, sichtbarer Progress-Indicator beim Re-Sync - **Klartext-Konflikt-View** bei Konflikten zwischen Queue und HiveGrid-Stand (User wählt welcher Stand gilt) #### EC-9 — Concurrent Edit (KWP-direkt vs. HiveGrid) Sandra editiert in KWP, Noah parallel in HiveGrid denselben Auftrag — Last-Write gewinnt unbemerkt. - **Last-Write-Wins mit Audit-Sichtbarkeit** — Phase-1-Default; bei überschriebenem User-Edit kommt Klartext-Notification mit Restore-Button - **Optimistic Locking auf HiveGrid-Seite** — version_hash beim Laden, Block beim Speichern wenn Version sich änderte, Diff-View zur Konflikt-Auflösung - **Visueller Indikator "gerade in KWP bearbeitet"** — bei erkanntem Stand-Mismatch warnt UI vorm Edit --- ## Architektur-Vorschriften aus Pre-mortem & Edge-Cases (zusätzlich zu Modul 4) Konsolidiert aus PM-1..5 und EC-1..9 — alle als bauliche Pflicht im Pflichtenheft: 1. **Klartext-Diagnostik pro Feature** (LP-10) — Pflicht-Abschnitt im Spec 2. **Adapter-Pattern für Integrationen** (LP-11) — auch wenn nur 1 Implementierung 3. **Branchen-Templates deklarativ, nicht hartkodiert** — Onboarding-Wizard liest Templates aus Konfiguration 4. **i18n: alle Strings extern** — kein hartkodierter Text 5. **Permissions-aware-Default** — jede Liste/Suche/View filtert nach User-Permissions 6. **Audit-Trail-Default** — jedes schreibende Aktion wird auditierbar geloggt 7. **Feature-Flag-Hülle** — neue Features werden mit Flag eingeführt, dann breit ausgerollt 8. **Idempotenz pro Automation-Action** (EC-3) 9. **Anti-Liste + Change-Request-Mechanismus zwischen Raphael und Noah** (PM-1) 10. **Dry-Run + Reversibilität für KI-erzeugte Aktionen** (PM-3) 11. **Schema-Drift-Sentinel für jede ERP-Anbindung** (PM-4, EC-7) 12. **EU-Stack komplett: Hosting + KI** (PM-5, LP-13) 13. **Multi-Provider-Fallback für KI** (EC-6) 14. **Promptfoo-Eval-Suite mit Injection-Vektoren** (EC-5) 15. **Optimistic Locking + Last-Write-Wins-mit-Sichtbarkeit für ERP-Sync-Konflikte** (EC-9) 16. **Rate-Limiting + Anomalie-Detection für Automation-Trigger** (EC-1) 17. **Loop-Guard mit Klartext-Stopp und Pre-Save-Validation** (EC-2) 18. **Heartbeat + Auto-Recovery für ERP-Sync-Clients** (EC-7) 19. **Persistente Queue mit Timestamps + Rate-Limited-Replay für ERP-Sync** (EC-8) 20. **Action-Boundary für KI: keine schreibenden Aktionen aus RAG/External ohne User-Bestätigung** (EC-5) --- ## Übergang zu Pflichten-/Lastenheft Diese Session liefert das **vollständige Scope-Fundament**: - 13 Leitplanken (LP-1..13) - 5 Pre-mortem-Schutz-Mechanismen (PM-1..5) - 40 Module mit Phase-1/Phase-2/Raus-Verdikt - 9 Edge-Cases mit Schutz-Mechanismen (EC-1..9) - Anti-Liste (explizit NICHT in Phase 1) - 20 Architektur-Vorschriften für Pflichtenheft **Empfohlene nächste Schritte:** 1. **Verifikations-Runde mit Noah** — Session-Datei durchgehen, Scope-Freigabe (vor jeder Detail-Spec, sonst Re-Work) 2. **Detail-Spec pro Modul gemäß LP-9** — Menüpfade, Entitäten/Felder, Sub-Funktionen, Permissions, Übergänge zu anderen Modulen, Klartext-Fehler-Texte, Adapter-Interfaces. Iterativ nach Modul-Priorität (USP-Säulen zuerst: Automation, KI, KWP-Integration; dann CRM-Vertriebs-Cluster; dann Plattform-Kern; ...) 3. **Übergang zu BMAD-Skill** `bmad-product-brief` (für Stakeholder-Alignment) oder direkt `bmad-create-prd` mit dieser Session als Context-File 4. **Geparkte Themen aufgreifen** — Migration aus HubSpot/Quiply, Pricing-Modell konkret, Sales-Flow Self-Service vs. Demo. Jeweils eigene Runde. 5. **Nach KWP-Geschäftsführer-Termin** — Native-Integration neu evaluieren (kann Modul 19 vereinfachen)