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.