HiveGrid 2.0 — Master-Milestone-Index
Diese Datei ist der vollständige Plan für die Phase-1-Umsetzung des HiveGrid-2.0-Pflichtenhefts (_bmad-output/pflichtenheft/).
Gesamt: 176 Milestones, gegliedert in zwei Querschnitt-Blöcke (Bauprinzipien + UI-Hot-Swap-Architektur) plus 7 Pflichtenheft-Blöcke.
Jeder Milestone hat ein eigenes Verzeichnis mit PLAN.md. Die Slice- und Task-Planung pro Milestone übernimmt der ToolController auf Basis dieser Dateien.
Vorbedingungen (außerhalb dieses Plans)
- EU-Sterilisation der Boilerplate — Anthropic/OpenAI/Google-Auth raus, Mistral/Scaleway/AlephAlpha rein, TOTP+Magic-Link rein.
- RR7-Migration der Boilerplate zu Ende — Root-Runtime →
apps/web, hybrider Status auflösen.
AGENTS.md im Repo-Root — zentrale Regel-Datei für AI-Agents (Layer-Grenzen, Anti-Patterns, Import-Regeln). Wird mit M001 angelegt.
Erst danach beginnt die aktive Modul-Umsetzung.
Querschnitt-Hülle Teil 1: Bauprinzipien als Code (M001-M011)
| ID |
Titel |
Bauprinzip |
| M001 |
Audit-Log default |
A.6 |
| M002 |
Klartext-Diagnostik |
A.1 |
| M003 |
i18n-Pflicht-Wiring |
A.4 |
| M004 |
Tenant-Scope-Wrapper + Owner-Check |
A.5 Teil 1 |
| M005 |
URL-Tampering Hardening + Mass-Action-Schutz |
A.5 Teil 2 |
| M006 |
Feature-Flag-Engine (Code-Layer) |
A.7 |
| M007 |
Idempotenz-Wrapper für BullMQ |
A.8 |
| M008 |
Apps-Engine: Adapter-Interface + State-Machine |
A.2 Teil 1 |
| M009 |
Apps-Engine: Setup-Wizard + Sync-Log |
A.2 Teil 2 |
| M010 |
Apps-Engine: Probe-Scheduler + Webhook-Sturm-Schutz |
A.2 Teil 3 + A.16 |
| M011 |
Notification-Service-Layer |
— |
Querschnitt-Hülle Teil 2: UI-Hot-Swap-Architektur (M012-M017)
| ID |
Titel |
Zweck |
| M012 |
Workspace-Topologie (view-models, ui-hivegrid, ui-subframe) |
Drei getrennte Pakete + ESLint-Boundary-Rules |
| M013 |
View-Model-Konvention |
Daten-Shape-Regeln + Zod-Schemas + lint-erzwungen |
| M014 |
Action-Callback-Contract |
Standard-Shape für UI→Server-Aktionen |
| M015 |
Subframe-Adapter-Layer |
Brücke Subframe-Output → HiveGrid-Pages |
| M016 |
Visual-Regression-Gate |
Playwright Screenshot-Diff in CI |
| M017 |
Hot-Swap-Drill |
Synthetischer UI-Lib-Tausch in CI |
Block 1 — Plattform-Fundament
M27 Anmeldung/Mandanten/Rollen
| ID |
Titel |
| M018 |
Mandanten-Anlage |
| M019 |
Mandanten-Trennung Hardening |
| M020 |
Email/Passwort-Auth + HIBP + Brute-Force |
| M021 |
Magic-Link + Sitzungs-Verwaltung |
| M022 |
TOTP-2FA + Notfall-Codes |
| M023 |
Rollen-Engine + 6 SHK-Standard-Rollen + Gruppen |
| M024 |
Mitarbeiter-Einladung/Deaktivierung |
| M025 |
Konto-Löschung (User + Admin) |
| M026 |
Mandanten-Lebenszyklus |
| M027 |
API-Keys + Tarif-Feature-Gates |
M30 Mehrsprachigkeit
| ID |
Titel |
| M028 |
User/Tenant Sprach-Settings + Auflösungs-Reihenfolge |
| M029 |
Sprach-Wechsler + Fallback-Hinweise |
M31 Branding
| ID |
Titel |
| M030 |
Hell/Dunkel-Modus + Capacitor-Status-Bar |
M32 Feature-Flag Admin-UI
| ID |
Titel |
| M031 |
Schalter-Definition + Lifecycle |
| M032 |
Filter-Editor + Einzel-Ausnahme-Editor |
| M033 |
Massen-Funktionen + Statistik + Audit-Historie |
M37 Plattform-Admin
| ID |
Titel |
| M034 |
Plattform-Admin-Auth (admin.) |
| M035 |
Plattform-Admin-Dashboard |
| M036 |
Mandanten-Verwaltung |
| M037 |
Stellvertreter-Anmeldung |
| M038 |
Mandanten-Mitarbeiter-Verwaltung |
| M039 |
Plattform-Admin-Konten + Rollen |
| M040 |
Interne Lead-Pipeline + Promote-to-Tenant |
| M041 |
System-Health + Audit-Anzeige + Datenschutz + Support |
Block 2 — CRM-Kern
M1 CRM
| ID |
Titel |
| M042 |
Kontakt-Stammdaten |
| M043 |
Firma-Stammdaten + Hierarchie |
| M044 |
Schlagwörter + Custom-Felder |
| M045 |
Aktivitäts-Stream |
| M046 |
Listen + Segmente + DSGVO-Felder |
M2 Lead-Inbox
| ID |
Titel |
| M047 |
Lead-Inbox-Schema + Quellen-Adapter |
| M048 |
Lead-Routing pro Quelle [N4] |
| M049 |
Auto-Verkaufsfall-Anlage |
| M050 |
Spam/Duplikat-Erkennung |
| M051 |
Lead-Status-Pipeline + Verlust-Gründe |
M23 Dateien
| ID |
Titel |
| M052 |
Datei-Upload (Anti-Virus + Format-Whitelist) |
| M053 |
Speicher-Backend (S3 auf Scaleway) |
| M054 |
Permissions + Sharing + Versionierung |
| M055 |
Datei-Suche + Tagging + Archivierung |
M24 Globale Suche
| ID |
Titel |
| M056 |
Such-Index (Postgres FTS / Meilisearch) |
| M057 |
Permission-aware Search |
| M058 |
Such-UI + Saved-Searches |
Block 3 — Vertrieb & Auftrag
M3 Sales-Pipeline
| ID |
Titel |
| M059 |
Pipeline-Konfiguration + SHK-Standard-Pipeline |
| M060 |
Verkaufsfall-CRUD + Pflichtfeld Vertriebler [N6] |
| M061 |
Kanban-UI + Drag&Drop |
| M062 |
Verlust/Gewinn-Gründe [N8] |
| M063 |
Auto-Auftragsprojekt [N7] + Setter-Closer [N17] |
| M064 |
Pipeline-Reporting + KWP-Sync |
M4 Auftragspipeline
| ID |
Titel |
| M065 |
Auftragspipeline-Konfiguration |
| M066 |
Auftrag-CRUD + KWP-Dokumenten-Archiv [N5] |
| M067 |
Plantafel mit Tagen-Granularität [N10] |
| M068 |
Mitglieder-Mgmt + Rollen pro Auftrag |
| M069 |
Abnahme-Workflow + Mängel-Liste |
| M070 |
Material-Listen + Lager-Anbindung |
M26 Aufgaben
| ID |
Titel |
| M071 |
Aufgaben-CRUD + Zuweisung |
| M072 |
Aufgaben-Listen pro Modul |
| M073 |
Erinnerungen + Push + Email |
| M074 |
Aufgaben-Sync mit ERP [N11] |
Block 4 — USP-Säulen
M17 Automation-Engine
| ID |
Titel |
| M075 |
Automation-Schema + Auslöser-Registry |
| M076 |
Aktion-Registry + Steuerungs-Bausteine |
| M077 |
Bedingungen |
| M078 |
Visueller Editor (xyflow) |
| M079 |
Test-Lauf + Schwellenwert-Vorschau |
| M080 |
24h-Undo-Fenster + Reversibilität |
| M081 |
Schleifen-Schutz + Webhook-Sturm + Anomalie |
| M082 |
Klartext-Logs + Re-Run + Trigger-Volumen-Metering |
M18 KI-Layer
| ID |
Titel |
| M083 |
EU-Provider-Layer (Mistral/Scaleway/AlephAlpha) |
| M084 |
Multi-Provider-Fallback + 30-Min-Health-Window |
| M085 |
Promptfoo-Eval-Suite mit Injection-Vektoren in CI |
| M086 |
KI-Sprach-zu-Automation |
| M087 |
RAG-Layer + Aktions-Grenze |
| M088 |
Token-Limits + Pay-as-you-go [N13] |
M19 KWP-Integration
| ID |
Titel |
| M089 |
KWP-API-Connector (REST/OAuth über Apps-Engine) |
| M090 |
KWP-API Connection-Health |
| M091 |
KWP-Push-Queue + Replay (Cloud-Outbox) |
| M092 |
KWP-API-Contract-Sentinel |
| M093 |
Konflikt-Auflösung „KWP gewinnt" [N14] |
| M094 |
Bidirektionale Plantafel-Sync [N10] |
| M095 |
Dokumenten-Archiv-Sync KWP→HiveGrid [N5] |
Re-Cut 2026-06-04: KWP bekommt eine offizielle API → Architektur von 3 auf 2 Komponenten, kwpsync.exe entfällt. Verbindlich: docs/milestones/M19-KWP-API-RECUT.md.
Block 5 — Kommunikation
M9 Email-Inbox
| ID |
Titel |
| M096 |
Gmail-OAuth-Integration via Apps-Engine |
| M097 |
Email-Sync + Inbox-UI + Threading |
| M098 |
Email-Versand + Vorlagen |
| M099 |
Email-Tracking + Bounces |
M10 Email-Marketing
| ID |
Titel |
| M100 |
Marketing-Email-Editor |
| M101 |
Segmente + Empfänger-Auswahl |
| M102 |
Versand-Engine + DKIM/SPF |
| M103 |
A/B-Tests + Reporting |
| M104 |
Unsubscribe + Bounce-Handling |
M12 Telefonie [N16]
| ID |
Titel |
| M105 |
HalloPetra-Adapter |
| M106 |
AirCall-Adapter |
| M107 |
Anruf-Eingang + CRM-Verknüpfung |
| M108 |
Anruf-Ausgang + Click-to-Call |
| M109 |
Voicemail + Anruf-Notizen + Aufgaben-Auto |
M13 Team-Chat
| ID |
Titel |
| M110 |
Channel-Modell + Permissions |
| M111 |
Direkt-Nachrichten + Threading |
| M112 |
Datei/Foto-Anhänge |
| M113 |
Modul-Verknüpfungen |
| M114 |
Mentions + Push + Lese-Bestätigungen |
M22 Notifications-Center (Service-Layer in M011)
| ID |
Titel |
| M115 |
Notification-Center + Lese-Status |
| M116 |
User-Settings (Kanal + Stille Stunden) |
| M117 |
Kategorien + Bündelung |
M25 Calendar-Sync
| ID |
Titel |
| M118 |
Google-Calendar-Adapter |
| M119 |
Termin-Sync (bi-direktional) |
| M120 |
Termin-Display + Modul-Verknüpfung |
Block 6 — Spezialfälle & Außenseite
M5 Form-Builder
| ID |
Titel |
| M121 |
Form-Editor |
| M122 |
Form-Veröffentlichung |
| M123 |
Submission-Eingang + CRM-Verknüpfung |
| M124 |
Conditional-Display (kein Branching) |
| M125 |
Rate-Limit + Captcha + DSGVO |
M6 Booking
| ID |
Titel |
| M126 |
Buchungs-Seite + Time-Slot-Engine |
| M127 |
Verfügbarkeits-Berechnung |
| M128 |
Bestätigungs-Flow |
| M129 |
Stornierung + No-Show-Tracking |
M7 Angebot+Signatur
| ID |
Titel |
| M130 |
Angebots-Erstellung |
| M131 |
PandaDoc/DocuSign-Integration |
| M132 |
Status-Tracking + Verkaufsfall-Verknüpfung |
M14 HR-Hub
| ID |
Titel |
| M133 |
Mitarbeiter-Stammdaten |
| M134 |
Dokumente-Bereich |
| M135 |
Urlaubs-Anträge |
| M136 |
Krankmeldungen |
| M137 |
Mitarbeiter-Kommunikation |
| M138 |
Onboarding-Drittanbieter [N18] |
| M139 |
HR-Berichte + Lohn-Export |
| M140 |
Mitarbeiter-Selbstbedienung |
M15 Customer-Portal
| ID |
Titel |
| M141 |
Customer-Portal-Auth |
| M142 |
Projekt-Sicht für Endkunde |
| M143 |
Datei-Upload durch Endkunde |
| M144 |
Subunternehmer-Zugang [N19] |
| M145 |
Skalierungs-Sicht [N19] |
| M146 |
Pro-Kunde-Lebensdauer-Mgmt [N19] |
M20 GF-Dashboard
| ID |
Titel |
| M147 |
Dashboard-Layout + Widget-Engine |
| M148 |
Standard-Widgets |
| M149 |
Custom-Widgets |
| M150 |
Export + Report-Versand |
Block 7 — Compliance & Plattform-Außenseite
M21 Audit-Log Anzeige
| ID |
Titel |
| M151 |
Audit-Log-Anzeige + Filter + Volltext |
| M152 |
Audit-Export + Aufbewahrungs-Mgmt |
M28 Subscriptions
| ID |
Titel |
| M153 |
Stripe-Integration |
| M154 |
Plan-Engine + Seat-Modell |
| M155 |
Trial + Read-Only-Downgrade |
| M156 |
Trigger-Volumen-Metering [N13] |
M29 Onboarding
| ID |
Titel |
| M157 |
Onboarding-Wizard-Framework |
| M158 |
SHK-Standard-Daten-Provisionierung |
| M159 |
Branchen-Templates deklarativ (A.3) |
| M160 |
Test-Daten + Demo-Modus |
M34 Public-API
| ID |
Titel |
| M161 |
OpenAPI-Spec + Read-API |
| M162 |
API-Key-Auth + Rate-Limit |
| M163 |
Webhooks (signiert) |
M35 DSGVO
| ID |
Titel |
| M164 |
Daten-Export |
| M165 |
Lösch-Workflow + Anonymisierung |
| M166 |
Auskunfts-Workflow |
M36 Mobile-App
| ID |
Titel |
| M167 |
Capacitor-Setup + Build-Pipeline |
| M168 |
Native-Push + Status-Bar |
| M169 |
Mobile-First-Routes |
| M170 |
Offline-First für Foto-Upload |
| M171 |
App-Store-Compliance |
M38 Help-Center
| ID |
Titel |
| M172 |
Hilfe-Artikel-Mgmt |
| M173 |
Hilfe-Suche + Kontextuelle Hinweise |
M39 Help-Desk
| ID |
Titel |
| M174 |
Support-Ticket-Eingang |
| M175 |
Self-Service-Knöpfe |
Doku
| ID |
Titel |
| M176 |
Anti-Liste + Change-Request-Workflow als Repo-Doku (A.9) |
Bewusst NICHT in Phase 1 (Anti-Liste)
- M8 Rechnungs-UI (geparkt nach KWP-GF-Termin)
- M16 Knowledge Base / Wiki
- M33b Community-App-Marketplace
- M33c Template-Marketplace
- M40 CMS / Sites / Blog (komplett ausgeschlossen)
- WhatsApp-Inbox, Unified Inbox [N15] (Phase 2)
- Apple-Login, Google-OAuth, Microsoft-Anmeldung
- GraphQL-API
- Schreibendes Public-API
- Hardware-Sicherheits-Schlüssel (FIDO2/WebAuthn)
- IP-Whitelisting, SAML/SSO
- Custom-Subdomain pro Mandant (außer Enterprise Phase 2)
- Branding-White-Label, Custom-Fonts (Phase 2)
- Sub-Workflows / Loops in Automation-Engine
- Custom-JS-Expressions in Automation-Conditions
- Eigene Buchhaltungs-Adapter (LexOffice, sevDesk, FastBill, Datev)
- Andere ERPs (Taifun, TopKontor, Streit V.1)
- Sipgate-Telefonie, sonstige Telefonie-Anbieter
- Service-Modul (Wartung/Service als eigene Pipeline) — Phase 2 [N9]
- HiveMind als autonomer Agent
- NFC, Bluetooth, advanced native Mobile-Features
- Versionierung von Angeboten
Vollständige Begründungen siehe _bmad-output/pflichtenheft/02-vision.md Kapitel V.3.
Architektur-Entscheidungen (kommen aus Party-Mode-Diskussion 2026-05-10)
- Designer-Workflow: Subframe → Code-Output → User → AI-Agent → Integration. Subframe ist der Component-Catalog (kein separates Storybook).
- Daten-Fluss: Synchron im Loader. Server bereitet View-Model auf, UI-Component bekommt fertiges VM als Prop.
- Agent-Regeln: Eine zentrale
AGENTS.md im Repo-Root. Pro Modul keine Sonder-Regeln, außer ausdrücklich nötig.
- Layer-Trennung (lint-erzwungen):
app/routes/** → Loaders/Actions, baut View-Models, importiert packages/ui-hivegrid. Keine direkten Prisma-Calls.app/domain/** → Domain-Logik, Prisma, BullMQ. Importiert NIE React oder UI.packages/view-models/** → reine Funktionen (domain → VM). Kein React, kein Prisma.packages/ui-hivegrid/** → Library-Adapter. Kennt weder Prisma noch Routen noch Auth.packages/ui-subframe/** → Subframe-Output unangefasst. Wird NIE direkt von Routes importiert.
