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 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
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) |
|
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 | (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.deist 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)
- Klartext-Diagnostik pro Feature (LP-10) — Pflicht-Abschnitt im Spec
- Adapter-Pattern für Integrationen (LP-11) — auch wenn nur 1 Implementierung
- Branchen-Templates deklarativ, nicht hartkodiert — Onboarding-Wizard liest Templates aus Konfiguration
- i18n: alle Strings extern — kein hartkodierter Text
- Permissions-aware-Default — jede Liste/Suche/View filtert nach User-Permissions ohne separate Logik
- Audit-Trail-Default — jedes schreibende Aktion wird auditierbar geloggt
- 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:
- Klartext-Diagnostik pro Feature (LP-10) — Pflicht-Abschnitt im Spec
- Adapter-Pattern für Integrationen (LP-11) — auch wenn nur 1 Implementierung
- Branchen-Templates deklarativ, nicht hartkodiert — Onboarding-Wizard liest Templates aus Konfiguration
- i18n: alle Strings extern — kein hartkodierter Text
- Permissions-aware-Default — jede Liste/Suche/View filtert nach User-Permissions
- Audit-Trail-Default — jedes schreibende Aktion wird auditierbar geloggt
- Feature-Flag-Hülle — neue Features werden mit Flag eingeführt, dann breit ausgerollt
- Idempotenz pro Automation-Action (EC-3)
- Anti-Liste + Change-Request-Mechanismus zwischen Raphael und Noah (PM-1)
- Dry-Run + Reversibilität für KI-erzeugte Aktionen (PM-3)
- Schema-Drift-Sentinel für jede ERP-Anbindung (PM-4, EC-7)
- EU-Stack komplett: Hosting + KI (PM-5, LP-13)
- Multi-Provider-Fallback für KI (EC-6)
- Promptfoo-Eval-Suite mit Injection-Vektoren (EC-5)
- Optimistic Locking + Last-Write-Wins-mit-Sichtbarkeit für ERP-Sync-Konflikte (EC-9)
- Rate-Limiting + Anomalie-Detection für Automation-Trigger (EC-1)
- Loop-Guard mit Klartext-Stopp und Pre-Save-Validation (EC-2)
- Heartbeat + Auto-Recovery für ERP-Sync-Clients (EC-7)
- Persistente Queue mit Timestamps + Rate-Limited-Replay für ERP-Sync (EC-8)
- 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:
- Verifikations-Runde mit Noah — Session-Datei durchgehen, Scope-Freigabe (vor jeder Detail-Spec, sonst Re-Work)
- 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; ...)
- Übergang zu BMAD-Skill
bmad-product-brief(für Stakeholder-Alignment) oder direktbmad-create-prdmit dieser Session als Context-File - Geparkte Themen aufgreifen — Migration aus HubSpot/Quiply, Pricing-Modell konkret, Sales-Flow Self-Service vs. Demo. Jeweils eigene Runde.
- Nach KWP-Geschäftsführer-Termin — Native-Integration neu evaluieren (kann Modul 19 vereinfachen)