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

23 KiB

stepsCompleted, inputDocuments, session_topic, session_goals, selected_approach, techniques_used, ideas_generated, context_file
stepsCompleted inputDocuments session_topic session_goals selected_approach techniques_used ideas_generated context_file
1
2
3
4
/tmp/hivegrid-inventory-codebase.md
/tmp/hivegrid-inventory-planning.md
/tmp/hivegrid-apple-rules.md
HiveGrid SaaS — Sauberes Re-Planning vor 3. Anlauf (Pflichten-/Lastenheft als Output, Geerkens als Erstkunde) Lücken aus den letzten zwei Anläufen finden, klares Scope-Modell, Spec-Tiefe statt Feature-Liste, Verifikations-Basis für Noah AI-Recommended (Pre-mortem → Role-Play → Modul-für-Modul-Schnitt → Edge-Case-Jagd)
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)

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)