Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/brainstorming/brainstorming-session-2026-05-07-2206.md
T

332 lines
23 KiB
Markdown

---
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)