Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ROADMAP-V2.md
T

33 KiB
Raw Blame History

Roadmap: HiveGrid 2.0 — v2 (Start 13.07.2026 · Carry-over offen)

Status: Entwurf 2026-06-15, inzwischen ticket-getrieben fortgeführt. Ergänzt die v1-ROADMAP (Phasen 1–21). v2 = 43 committed-deferred Scope-Bausteine, nach v1-Launch (10.07.) sequenziert — kein Vielleicht-Backlog.

Overview

v2 bringt die eigentlichen USP-/Revenue-Hebel, die in v1 bewusst geschnitten wurden: KWP-Sync (das Haupt-Verkaufsargument), Self-Service-Abo, Postfach-Sync, Customer-Portal, Mobile-PWA-Ausbau, MCP-Server und Public-API. v1 hat die tragfähige Kette + alle Andockpunkte geliefert; v2 dockt rückwirkend an (Dependency-Inversion bleibt das Prinzip).

Bau-Strategie: Wie v1 zwei dependency-frei parallele Tracks (Raffael + Akeshan), Designer (David) 1–2 Phasen voraus. Ursprüngliches Drei-Wochen-Fenster: v2-W1 13.–19.07. · v2-W2 20.–26.07. · v2-W3 27.–31.07. Retimierte Arbeit wird als v2-Carry-over geführt; insbesondere läuft VA-P26a bis 05.08., VA-P26b frühestens danach und VA-P26c bleibt bis zur finalen Slice-Planung undatiert.

Die kritische geteilte Vorbedingung: Das M33a-Apps-Engine-Adapter-Interface (v1-P5, M008–M010) trägt KWP (v2-P5), die HR-Drittanbieter (v2-P10) und das Provider-Pattern für Postfach/Telefonie. Wenn das in v1 sauber steht, docken die v2-Integrationen ohne Kern-Umbau an.

⚠️ Zwei Gaps (vor Bau zu schließen)

  • HalloPetra (M105): kommt in keiner Spec vor. M12 ist eine reine AirCall-Spec. HalloPetra wäre ein zweiter Telefonie-Provider über das vorhandene TelephonyProviderInterface — mechanisch klar, inhaltlich unspezifiziert. → eigene Vorlauf-Spec (API-Vertrag) nötig.
  • Memberspot/Boobora (M138): kommt in keiner Spec vor. M14 nennt nur generische „HR-Onboarding + externe Systeme via Apps-Engine". → eigene Drittanbieter-Spec nötig.

Wiederkehrendes Risiko: „Partner-API-Vertrag offen"

HalloPetra (P11) und HR-Drittanbieter (P10) hängen wie KWP am Muster „externer Adapter über M33a" und warten noch auf ihren Partnervertrag. Für KWP (P5) sind Discovery, dynamische Relay-Auflösung, tenant-spezifischer OpenAPI-Vertrag sowie Auth-/Resource-/Refresh-Dauerbetrieb verifiziert. Der initiale Phase-32-Scope ist nach AD-32/CR-003 read-only und nicht mehr durch Project-Create blockiert. Ausschließlich Writeback bleibt hinter VEXT-6, belastbarem Providervertrag und erneuter Freigabe geparkt.

Hinweis: „phase:1"-Specs nur teilweise v2

M15 (Portal), M37/M32 (Admin), M38/M39 (Help), M20/M22/M30 (Querschnitt) sind in den Specs als phase:1 markiert. Das Fundament gehört laut Spec in v1 (großteils erledigt/gedünnt) — nur das Komfort-/Tiefen-Delta ist echtes v2. Die Phasen unten beschreiben das Delta.


Phasen-Übersicht

v2-Phase Titel MS Owner Slot UI
v2-P1 Public-API & Webhooks M161-163, M027 Raffael W1 yes
v2-P2 Postfach-Sync (Email-Inbox) M096-098 Akeshan W1 yes
v2-P3 Self-Service-Billing & Onboarding-Wizard M157 (+M28-SB-Delta) Akeshan W1→W2 yes
v2-P4 MCP-Server (ex „KI-Tiefe — HiveMind/RAG", AD-26) VR-MCP/VD-MCP (kein M0xx) Raffael W1→W2 yes
v2-P5 KWP-Integration (ex-P10, RECUT) M089-095, M074 Raffael W2 yes
v2-P6 Customer-Portal (ex-P18) M141-146 Akeshan W1→Carry-over yes
v2-P7 Mobile-PWA-Ausbau M167-171 Akeshan W2→W3 yes
v2-P8 Plattform-Admin-Tiefe M038/039/033/040 Raffael+Akeshan W3 yes
v2-P9 Help-Center & Help-Desk M172-175 Akeshan W3 yes
v2-P10 Komfort & Querschnitt M149/150/117/029/138 Akeshan W3 yes
v2-P11 Telefonie-Erweiterung & DSGVO-Vollausbau M105, M166 Raffael W3 yes

Execution-Order: v2-P1/P2 (W1) → v2-P3/P4 (W1→W2) → v2-P5 (W2) → v2-P7 (W2→W3) → v2-P8/P9/P10/P11 (W3). P6 beginnt mit VA-P26a in W1 und läuft retimiert in den Carry-over; VA-P26b/VA-P26c folgen nach den Gates. Tracks parallel: Raffael P1→P4→P5→P8→P11 · Akeshan P2→P3→P6 sowie die übrigen disjunkten P7/P9/P10-Slices.

Nummern-Mapping: v2-Px ↔ ROADMAP-Phase 22–34 ↔ ex-Pn (C-2)

Drei Nummernkreise zeigen auf dieselben Phasen: diese Datei (v2-Px), die v1-ROADMAP.md (fortlaufend Phase 22–34, die Plane-Tickets nutzen 22–34) und die alte v1-Roadmap-Nummern (ex-Pn, soweit ein v1-Platzhalter existierte). Insb. KWP = v2-P5 = Phase 32 = ex-P10.

v2-Px (diese Datei) ROADMAP.md Phase ex-Pn Titel
v2-P1 Phase 22 — Public-API & Webhooks
v2-P2 Phase 23 — Postfach-Sync (Email-Inbox)
v2-P3 Phase 24 — Self-Service-Billing & Onboarding-Wizard
v2-P4 Phase 25 — MCP-Server
v2-P5 Phase 32 ex-P10 KWP-Integration (RECUT)
v2-P6 Phase 26 ex-P18 Customer-Portal
v2-P7 Phase 27 — Mobile-PWA-Ausbau
v2-P8 Phase 28 — Plattform-Admin-Tiefe
v2-P9 Phase 29 — Help-Center & Help-Desk
v2-P10 Phase 30 (+ Phase 34 HR-Drittanbieter, M138) — Komfort & Querschnitt / Dashboard-Deluxe
v2-P11 Phase 31 (DSGVO) + Phase 33 (HalloPetra, M105) — Telefonie-Erweiterung & DSGVO-Vollausbau

Phase Details

v2-P1: Public-API & Webhooks

Owner: Raffael · Slot: W1 (13.–17.07.) · Goal: Externe Systeme lesen HiveGrid-Hauptentitäten per versionierter REST-API und empfangen/senden Events über signierte Webhooks. Milestones: M161 (OpenAPI + Read-Endpoints), M162 (API-Key-Auth + Scopes + Rate-Limit), M163 (Webhooks signiert), M027 (API-Keys + Tarif-Gates) Depends on: v1-ApiKey-Modell (M027-Vorbereitung lag in v1 ungenutzt bereit) · Redis (Token-Bucket) · v1-Frozen/past_due-Middleware (Writes 402) · RLS via app.tenant_id · v1-P12 Automation (external_event-Trigger + ausgehende Webhook-Action) Host-Contract: Public API nur https://api.hivegrid.de/v1/... (staging: https://staging-api.hivegrid.de/v1/...); keine Public-API-Routen unter app.hivegrid.de/api. Success Criteria:

  1. GET contacts/companies/deals/projects/tasks/leads — cursor-paginiert, Filter/Sort/Sparse-Fieldsets/Embed (Tiefe 1); read_only-Scope lässt sensible Felder aus (nicht 403).
  2. Eingehende Lead-Webhooks (POST https://api.hivegrid.de/v1/webhooks/incoming/{tenant}/{slug}) legen Leads an (API-Key/HMAC/URL-Token + Payload-Mapping + Auto-Match).
  3. Ausgehende WebhookSubscriptions: HMAC-SHA256-Signatur, Idempotenz-ID, Retry mit exp. Backoff (max 5), Auto-Disable nach 10 Fehlern.
  4. OpenAPI-3.1 auto-generiert (https://api.hivegrid.de/v1/openapi.json) + Swagger-UI; Rate-Limit (1k/h Key, 10k/h Tenant) mit X-RateLimit-* + Klartext-429. Screens (David): API-Key-Verwaltung (Erweiterung) · Incoming-Webhook-Slug-Verwaltung + Ingestion-Log · Outgoing-Subscription-Liste/Detail (Secret-einmal-sichtbar, Delivery-Stats, Replay/Test) · API-Request-Logs + Usage-Aggregat Recut/Risiko: Bewusst Read-only + Webhooks (Voll-CRUD/GraphQL/3-Legged-OAuth = später). Vor Bau: OpenAPI-Tooling wählen, HMAC-Format dokumentieren.

v2-P2: Postfach-Sync (Email-Inbox)

Owner: Akeshan · Slot: W1 (13.–17.07.) · Goal: Gmail/Outlook-Postfächer werden bidirektional ins CRM gespiegelt, auto-gematcht und im Activity-Stream sichtbar. Milestones: M096 (Gmail-OAuth via Apps-Engine), M097 (Sync + Inbox-UI + Threading + Auto-Verknüpfung), M098 (Versand + Vorlagen) Depends on: v1-Sende-Domain DKIM/SPF/DMARC (P14, NICHT neu bauen) · EmailProviderInterface (Apps-Engine-Pattern) · v1-Activity-Stream + Contact/Project-FKs (Matching) · Webhook-Ingest-Infra (geteilt mit P1) · v1-Files (Anhänge) · Token-Encryption (DEK) Success Criteria:

  1. OAuth-Connect Gmail (Pub/Sub-Watch) + Microsoft (Graph-Subscription, 3-Tage-Renewal-Worker); Token-Refresh + Revoke.
  2. Push-Sync (kein Primär-Polling) spiegelt Mails; Initial-Sync 90 Tage, resumebar mit Progress.
  3. Auto-Match: From-Adresse → Contact/Lead, Subject-Pattern ([Projekt #123]), 1-offenes-Projekt-Heuristik; manueller Override sticht.
  4. Inbox-Liste (Filter/Suche/Bulk) + Detail mit Thread, sicherem HTML-Render (CSP, externe Bilder blockiert), Reply/Forward via Mailbox.
  5. email.read_own vs. email.read_all filtern Liste + Activity-Stream. Screens (David): Mailbox-Connect-Settings (Sync-Status/Reconnect) · Inbox-Liste · Mail-Detail (Thread/Verknüpfungs-Editor/Reply) · Outbound-Compose Recut/Risiko: ⚠️ Gmail restricted scopes (gmail.modify/send) → Google-Verifizierung + ggf. CASA-Assessment (Wochen Vorlauf, Antrag lief in v1 EXT-13). Microsoft-Graph-Subscription läuft ~3 Tage → Renewal-Worker kritisch. Versand über User-Mailbox (Provider-Quotas).

v2-P3: Self-Service-Billing & Onboarding-Wizard

Owner: Akeshan · Slot: W1→W2 (Abo-UI 13.–17., Wizard 18./19.) · Goal: Tenants buchen/wechseln Pläne und pauschale Add-ons self-service über Web-Checkout und durchlaufen einen branchen-getriebenen Onboarding-Wizard. Milestones: M157 (Wizard-Framework + State-Machine) + M28-Self-Service-Delta (In-App-Subscription, Block P) Depends on: v1-HiveGrid-Entitlements + Lago-Billing-Gateway + Mollie-Payment-/Webhook-Vertrag (BILL-02 bis BILL-10) · v1-Read-Only-Middleware · v1-TenantUserInvitation · deklaratives Branchen-Template-Verzeichnis (geteilt mit P6/P10) · v2-P4 (KI-Walkthrough-Coach) → KI-Coach entfällt (AD-26: kein eigenes LLM; v2-P4 = MCP-Server) Success Criteria:

  1. Self-Service-Trial ohne Vertriebs-Freigabe (requires_manual_activation=false) mit Zahlungsmethoden-Pflicht.
  2. Plan-Wechsel/Add-On-Käufe laufen über den Web-Checkout-Flow (PWA-only → kein App-Store, keine Store-Billing-Auflage). Der Vertrag unterstützt wiederkehrende Pauschal-Add-ons und einmalige Einrichtungspositionen; Usage-Metering bleibt ausgeschlossen. VA-P26c nutzt dies für Portal und Custom-Domain.
  3. Onboarding-Wizard resumebar nach Signup, Step-Validierung, Block der Rückwärts-Navigation nach irreversiblen Actions.
  4. SHK-Branchen-Template (Pipelines/Rollen/Custom-Felder/Forms/Demo/Checkliste) deklarativ aus YAML geseedet; weitere Branchen „coming soon".
  5. Erste-Schritte-Checkliste (Detection-Rules) + Demo-Daten-Bulk-Löschung. Screens (David): Onboarding-Wizard (10 Steps, Vollbild) · Erste-Schritte-Checkliste-Widget + Detail · Demo-Daten-Verwaltung · Self-Service-Plan-Wechsel-Flow (Web) · Add-On-Kauf-Flächen Recut/Risiko: Self-Service ist v2, weil konkrete Preise feststehen müssen (in v1 EXT-14 fixiert) und das Wizard-/Abo-Baukasten-Delta Komplexität trägt — nicht mehr wegen Apple-Store-Auflagen (PWA-only → kein App-Store, Plan-Wechsel direkt im Web). Wizard-Framework ist großteils v1-fähig; v2-Delta = weitere Branchen + KI-Coach (entfällt — AD-26) + Migration-Importer.

v2-P4: MCP-Server (ex „KI-Tiefe — HiveMind/RAG", umgeschnitten via AD-26)

⛔ KI→MCP-Pivot (AD-26): HiveGrid hostet kein eigenes LLM/RAG/Whisper mehr. Diese Phase liefert stattdessen einen Remote-MCP-Server, über den externe KI-Clients (Claude, ChatGPT-Connectors u.a.) HiveGrid-Daten lesen und freigegebene Aktionen ausführen. Verbindliche Bau-Spec: VR-MCP (Backend) / VD-MCP (Screens). Die alten HiveMind/RAG/Whisper-Inhalte stehen darunter durchgestrichen als v3-Kandidat (zurückgestellt). Owner: Raffael · Slot: W1→W2 (Start 18./19.07.) · Goal: Ein produktiver, tenant-gescopeter Remote-MCP-Server stellt HiveGrid-Daten als Read-Ressourcen und freigegebene Aktionen als Action-Tools bereit — auditiert, permission-gegated, ohne eigenes LLM. Milestones: kein M0xx (v2-Neuschnitt) → siehe VR-MCP/VD-MCP Source-Specs: VR-MCP / VD-MCP · AD-26 Depends on: v1-OAuth 2.1/PKCE für MCP + Scopes + Rate-Limit aus der Public-API-Grundlage (VR-P22) · v1-withTenantScope()/RLS · v1-withPermission() (M004) · v1-M001-Audit · @modelcontextprotocol/sdk Host-/Runtime-Contract: MCP nur https://mcp.hivegrid.de (staging: https://staging-mcp.hivegrid.de) als eigener Service/Container hivegrid-mcp (apps/mcp); kein /mcp-Pfad, nicht in app.hivegrid.de oder api.hivegrid.de. Success Criteria:

  1. Remote-MCP-Server (Streamable HTTP, @modelcontextprotocol/sdk) exponiert Read-Ressourcen (Kontakte/Firmen/Leads/Projekte/Aufträge u.a.) und Action-Tools (definierte Schreib-Aktionen).
  2. Authentifizierung per OAuth 2.1 + PKCE + Scopes + Rate-Limit; Tenant wird aus dem Access Token abgeleitet, jeder Zugriff läuft durch withTenantScope()/RLS. API-Key bleibt nur Fallback/Operator-Modus.
  3. Jede Action ist withPermission()-gegated, verlangt bei schreibenden Operationen eine Confirmation und wird via M001-Audit protokolliert (Actor-Kind „MCP/Agent").
  4. Tenant-Admin verwaltet MCP-Verbindungen/Scopes (UI aus VD-MCP); OAuth-Clients/Tokens/Grants sind getrennt nachvollziehbar, keine neuen KI-Entitäten. Screens (David): siehe VD-MCP (MCP-Connection-Verwaltung, Scope-Auswahl, Audit-/Aktivitäts-Sicht der MCP-Zugriffe). Recut/Risiko: Kein LLM-Hosting → kein Provider-AVV und kein DSGVO-Provider-Constraint mehr; Sicherheit liegt vollständig in Tenant-Scope/RLS, Scope-Minimierung und Confirmation-Grenze für Schreib-Aktionen.

Owner: Raffael · Slot: W1→W2 (Start 18./19.07.) · Goal: Aus dem v1-LLM-Gateway wird semantische Tiefe — RAG über Tenant-Daten, EU-Whisper, perspektivisch der autonome HiveMind-Agent. (v3-Kandidat, zurückgestellt — AD-26) Milestones: M087 (RAG-Layer + Aktions-Grenze) + Whisper-EU + pgvector-Hybrid-Suche + zweiter EU-Provider Depends on: v1-LLM-Gateway (Multi-Provider-Abstraktion) · v1-RetrievalProvider-Interface + Outbox-Index-Events · v1-AiCredits/AiTokenUsage · v2-P9 Help-Center (RAG-Korpus) · v1-Activity-Stream/Custom-Felder/Forms (RAG-Quellen) · Promptfoo in CI Success Criteria: Embedding-Pipeline → TenantEmbedding (pgvector, HNSW/IVFFlat) · RAG für Programm-Hilfe/Lead-Zusammenfassung/Hybrid-Suche (RRF) · Whisper-EU (Scaleway-GPU) async · HiveMind-Agent mit Action-Boundary · Multi-Provider-Failover (Mistral→Scaleway→AlephAlpha) + Promptfoo in CI. Screens (David): KI-Chat/Assistent-Panel + History · HiveMind-Insight-Anzeige · Custom-Tool-Editor + Scheduled-Actions · AI-Usage-Dashboard · Whisper-Aufnahme/Transkription. Recut/Risiko: DSGVO-Hard-Constraint (nur EU-Provider, AVV); HiveMind autonom erst nach Reifegrad-Gate; pgvector-Index- + Whisper-Modell-Wahl offen.

v2-P5: KWP-Integration (ex-P10 — RECUT auf REST/OAuth2)

Owner: Raffael · Slot: Read-only Implementierung ab W2; Live-E2E separat ohne Termin nach VR-P32c/d + VN-1 · Goal: KWP wird regulärer REST/OAuth2-Adapter über die Apps-Engine. Der initiale/current Scope ist read-only KWP → HiveGrid für Aufträge/Stammdaten/Belege/Plantafel/Dokumente/Tasks mit „KWP gewinnt"-Konfliktregel; HiveGrid führt keine fachliche KWP-Mutation aus. Milestones: current read-only: M089 (API-Connector), M090 (Connection-Health), M092 (Contract-Sentinel), M093 (Konflikt „KWP gewinnt"), M095 (Dokumenten-Archiv-Sync) sowie M094-inbound (Plantafel) und M074-inbound (Tasks); geparkt: M091 (Push-Queue + Replay), M094-outbound, M074-outbound Depends on: HART: v1-M33a Apps-Engine-Adapter-Interface (M008–M010) · v1-@hivegrid/storage + FileEntityLink · v1-Extension-Points an Auftrag/Abnahme/Material (P9) · AVV/Subprozessoren (P11). Cloud-Outbox/M007 und P12-kwp.push_auftrag werden erst vom geparkten Writeback benötigt. Success Criteria:

  1. KWP-API-Connector als erster konkreter Adapter hinterm M33a-Interface; Kundenkürzel und OAuth-Metadaten/Refresh-Token per-Tenant-DEK-verschlüsselt in DataConnection.credentialsCiphertext, Relay-Host dynamisch über den offiziellen Loadbalancer.
  2. Read-only Sync: Pull mangels dokumentierter Webhooks per konservativ rate-limitiertem Cron, idempotent über AppSyncItem; keine Create-, Update-, Delete-, Import- oder sonstigen fachlichen KWP-Schreibrequests.
  3. Konflikt „KWP gewinnt" (LWW mit Audit-Restore) + Optimistic Locking HiveGrid-seitig.
  4. API-Contract-Sentinel (Tenant-OpenAPI-Fingerprint + endpoint-spezifische Response-Validierung) pausiert Sync bei Drift + alarmiert Plattform-Admin.
  5. Plantafel-, Task- und Dokumenten-Archiv-Daten laufen KWP → HiveGrid über die API; KWP-Dokumente werden in @hivegrid/storage übernommen.
  6. Vollständige Scoped-Adapterabdeckung nach CR-005: 554 Tenant-Operationen inventarisiert; alle 113 Operationen der fünf HiveGrid-*-extern-Scopes besitzen einen festen Contract. 77 semantische Reads sind allowlisted, 36 Mutation-Contracts bleiben fixture-validiert und garantiert vor HTTP gesperrt. Screens (David/Akeshan): KWP-Setup-Wizard (Kundenkürzel + OAuth2/PKCE, Initial-Sync-Vorschau) · Connection-Health-View · Sync-Log + KwpErrorReport · Konflikt-Resolution (Diff + Restore) · Admin: KWP-Sync-Status pro Tenant + Contract-Diff + Sync-Freigabe Recut/Risiko: ⚠️ kwpsync.exe NICHT bauen (3→2-Komponenten). Auth-/Resource-/Refresh-Dauerbetrieb ist bewiesen; es gibt keine dokumentierten Webhooks, Delta-Cursor oder einheitlichen Versionsfelder. AD-32/CR-003 parken M091, kwp.push_auftrag, Project-/Auftrag-Create und die Outbound-Anteile von M094/M074 hinter VEXT-6 + erneuter Freigabe. CR-005 erweitert nur die explizite Contract-Abdeckung; Mutation-Contracts sind nicht runtime-ausführbar und kein Writeback. AVV-Neubewertung: OAuth-Metadaten/Refresh-Token liegen verschlüsselt in der Cloud; Azure-Exchange-URLs sind kurzlebige Transferdaten.

v2-P6: Customer-Portal (ex-P18)

Owner: Akeshan · Slot: VA-P26a retimiert 16.07.–05.08.; VA-P26b frühestens ab 06.08. mit neu zu planendem Ziel; VA-P26c Termin offen · Goal: Endkunden sehen über eine eigene Auth-Schicht ihre Projekte/Status/Dokumente, laden Dateien hoch, erhalten Auto-Status-Mails und erreichen das Portal über einen dedizierten Standardhost oder optional eine verifizierte Kundendomain. Milestones: M141 (Auth/Magic-Link), M142 (Projekt-Sicht + Status-Mails), M143 (Endkunden-Upload + Reklamation), M144 (Subunternehmer-Zugang), M145 (Skalierungs-Sicht/Service-Inbox), M146 (Lebensdauer + DSGVO + Konfig) Requirements: REQ-portal-datenmodell, REQ-portal-auth-magic-link, REQ-portal-projekt-sicht, REQ-portal-runtime-isolation, REQ-portal-commercial-access, REQ-portal-custom-domain Depends on: v1-Auth-Pattern (parallel, NICHT geteilt) + Tenant-Lifecycle (frozen→read-only) · v1-Project-Stage-Trigger + Acceptance-PDF-Auto-Freigabe · v1-Files/FileEntityLink (Doc-Freigabe + Portal-Uploads, in P4 vorbereitet) · v1-Sende-Domain (Auto-Mails) · v1-Form-Builder (portal_form) · v1-Automation (portal.*) · v1-notify() · v1-DSGVO-Lösch-Workflow · P1-Host-Routing/URL-Contract · VA-P24a für pauschale Add-ons/Einmalpositionen · Estate-Traefik/DNS/TLS Success Criteria:

  1. Eigener Coolify-Service/Container hivegrid-portal aus demselben immutable Web-Image; fail-closed Surface-Routing, getrennte Sessions/Secrets/Healthchecks und dedizierter minimal berechtigter DB-Login hivegrid_portal isolieren App/Admin.
  2. Eigene PortalUser-Klasse strikt getrennt von TenantUser (eigene Cookies, Routes, keine Permission-Vermischung); Magic-Link primär.
  3. Endkunde sieht nur eigene Projekte/konfigurierte Stages/freigegebene Dokumente; fehlender Zugang → 404 (keine Existenz-Offenlegung).
  4. Upload (mobile-Kamera, Multi-File, Limits) → Files + Activity + PL-Notification.
  5. Auto-Status-Mails bei project.stage_changed (Debounce, Bedingungen: sichtbare Stage/aktiver Access/Pref/nicht frozen).
  6. Tenant-Admin konfiguriert Phasen-Sichtbarkeit/Doc-Auto-Freigabe/Templates; DSGVO-Lösch/Export für PortalUser.
  7. Standardhost ist portal.hivegrid.de/<tenant>; ein optionaler Custom-Host wird per TXT+CNAME self-service verifiziert, automatisch mit TLS/Ingress provisioniert und sicher einem Tenant zugeordnet. Der Standardhost bleibt Fallback.
  8. Portal-Entitlement: Starter/Team 19,99 EUR netto/Monat, Business/Enterprise inklusive; Custom-Domain Starter/Team/Business 299,99 EUR netto je Einrichtung, Enterprise eine inklusive. Ein Domainwechsel ist eine neue kostenpflichtige Einrichtung, sofern keine individuelle Enterprise-Regel greift. PortalUser/Projekte unbegrenzt, Basispaket-Limits bleiben. Öffentliche Freischaltung erst nach VA-P26b; Domain-Reclaim-Cooldown 30 Tage. Screens (David — eigener Polish, extern sichtbar): Endkunde: Login/Setup/Reset, Portal-Dashboard, Projekte-Liste, Project-Detail (Fortschritt/Docs/Upload/Reklamation), Settings · Tenant-Admin: Portal-Konfig, PortalUser-Verwaltung, Access-Matrix, Mail-Template-Editor, Paket-/Domain-Setup mit DNS/TLS-Status Recut/Risiko: Eigene Auth = eigenes Härtungs-Budget (Rate-Limits, Captcha, kein User-Enumeration, wasserdichte Cookie-Trennung). Die Portal-Runtime ist ein zusätzlicher Coolify-/Deploy-/RLS-Security-Slice in VA-P26a; deshalb wurde VA-P26a am 15.07.2026 auf 16.07.–05.08. retimiert und VA-P26b hinter das Security-Gate verschoben. Custom-Domain = separater Provisioner- und Domain-Takeover-Sicherheitsbereich. Ausgeklammert bleiben eigenes apps/portal/Portal-Image im ersten Schnitt, Multi-Portal, vollständiges App-White-Label, Apex/Wildcard/mehrere Portal-Domains und PWA-Push; PortalSubscription als eigenes paralleles Abomodell bleibt ausgeschlossen, die Freischaltung läuft über die zentralen HiveGrid-Entitlements (AD-30).

v2-P7: Mobile-PWA-Ausbau

Owner: Akeshan · Slot: W2→W3 (23.–27.07.) · Goal: Die mobile-first-PWA aus v1 wird zur vollwertigen installierbaren App — Add-to-Homescreen, Service-Worker-Offline-Härtung, Web-Push, Baustellen-tauglich. Kein nativer Client, kein App-Store (AD-17, PWA-only). Milestones: M167 (PWA-Manifest + Installierbarkeit), M168 (Web-Features: Web-Push/Kamera/Foto), M169 (mobile Navigation + Routes), M170 (Service-Worker-Offline-Modus), M171 (Force-Update + PWA-Härtung) — auf PWA umzuschneiden Depends on: v1-OfflineSyncQueue (P9) + serverseitige Idempotency-Keys · v1-notify()/NotificationDevice (→ Web-Push/VAPID, P21-Andockpunkt) · v1-Auth (Email/Pwd + Magic-Link + offline Permissions-Snapshot) · v1-Files (Foto), Abnahme/Tasks/Chat offline · mobile-first responsive Web (Voraussetzung) Success Criteria:

  1. Offline-Pflicht: Pre-Cache beim Login (Projekte/Tasks/Kontakte/Checklisten/Acceptance-Templates) über Service-Worker + IndexedDB, Offline-Read + Offline-Write-Queue (Foto/Note/Task-Status/Checklist/Acceptance/Chat).
  2. Sync-on-Reconnect drainiert Queue idempotent (lokale UUID als Key), Append-only konfliktfrei, Status-Updates LWW mit Konflikt-Resolution.
  3. Installierbar: Web-App-Manifest + Add-to-Homescreen + Standalone-Display; Web-Push (VAPID); Kamera/Foto via Web-APIs (lokaler Resize); 2FA bleibt.
  4. Account-Löschung erreichbar; Force-Update via Service-Worker-Versionierung; Deeplinks. Screens (David — mobile-first PWA-Shell, Touch-Paradigma): Login + Setup · mobile Navigation (Baustelle/Büro) · Sync-Queue + Konflikt-Resolution · Mobile-Settings (Pre-Cache/Storage/Geräte) · Web-Push-Pre-Prompt + Force-Update-Modal · Install-Hinweis (A2HS) Recut/Risiko: ⚠️ PWA-only-Recut der M36-Spec (kein EAS-Build, keine Native-Module, keine Store-Compliance). iOS-Safari-PWA-Grenzen (Web-Push iOS ≥16.4 nur im installierten Standalone-Modus), Offline-Storage-Budget, Background-Sync-Verfügbarkeit. Kein Apple/Google-Review-Risiko mehr. Native-App + Stores → frühestens v3.

v2-P8: Plattform-Admin-Tiefe

Owner: Raffael + Akeshan · Slot: M040a vorgezogen ab 16.07.; übrige Tiefe W3 (27.–31.07.) · Goal: Native Plattform-Leads und getrennte AdminUser-Identität/RBAC auf admin.hivegrid.de + Feature-Flag-Massen-Statistik (löst die v1-Auflagen-Brücke ab). Milestones: M038 (Mandanten-MA-Verwaltung), M039 (AdminUser-Konten + Rollen), M033 (Flag-Massen-Statistik), M040a (native Plattform-Leads/Intake/Admin-Inbox/Cutover in R-LEADS), M040b (AdminDeal/Kanban/Forecast/Promotion in VA-P28b) Depends on: M040a verwendet die bereits ausgelieferten M034-/AK-P19-Verträge (Admin-Host/Shell/Auth/Audit), aber nicht dessen offene Billing-/Support-/Queue-DoD · v1-Auth-Bausteine (TOTP/Bcrypt/Session — wiederverwendet, eigene Tabellen) · v1-FeatureFlag-Modell + tenantHasFlag() (P8 ergänzt nur Massen-UI) · Read-Replica (Filter-Vorschau) · Redis (Dashboard-Cache). M040b hängt zusätzlich von M040a + M038/M039 ab. Success Criteria:

  1. Eigene AdminUser-Klasse, hart getrennt (eigene Cookies SameSite=Strict, kein Cross-Routing, kein BYPASSRLS — Admin liest Tenant-Daten via RLS mit gesetztem app.tenant_id).
  2. AdminRBAC mit eigenen Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer), 2FA-Pflicht, 8h-Session, Self-Permission-Schutz.
  3. AdminAuditLog cross-tenant mit Reason-Pflicht bei sensitiven Aktionen; Impersonate mit Reason + Banner.
  4. Flag-Massen-Statistik: Effektiv-Auswertung (X aktiv/Y nicht), Live-Filter-Vorschau, Bulk-Override; deterministische Auswertung (Override > Filter > Default) + Audit.
  5. M040a: source-authentifizierter/idempotenter Plattform-Lead-Eingang, native AdminLead-Inbox, Legacy-Backfill und kontrollierte Stilllegung von lead-inbox; M040b ergänzt Deal-Kanban/Forecast/Promotion ohne zweite Lead-Datenbasis. Screens (David — interner Polish): AdminUser-Verwaltung + AdminRole-Editor + Admin-Security-Settings · Feature-Flag Effektiv-Statistik + Filter-Editor (Live-Match) + Bulk-Override · Plattform-Lead-Inbox/-Detail/-Sources (M040a) · Deal-Pipeline/-Detail (M040b) · Cross-Tenant-Audit-View Recut/Risiko: AD-31: M040a ist als R-LEADS vorgezogen; VD-P28 bleibt nach AD-28 ein Design-Nachzug. Kein BYPASSRLS = bewusste Hardgrenze. Impersonate-Cookie-Scope offen. M032 Tenant-Self-Service-Flags (/labs/) = spätere Phase.

v2-P9: Help-Center & Help-Desk

Owner: Akeshan · Slot: W3 (28.–30.07.) · Goal: Öffentliches file-basiertes Help-Center mit Deep-Links aus der App + In-App-Feedback-Widget → Plattform-Admin. Milestones: M172 (Markdown-Artikel Git-PRs), M173 (Routes + Suche + SEO + kontextuelle Hilfe), M174 (Email-Ticket-System), M175 (In-App-Feedback-Widget) Depends on: Public-Routing außerhalb Auth-Middleware + IP-Rate-Limiting · v1-Files (Feedback-Attachments) · v1-Feedback-Widget → Support-Inbox (P21-Andockpunkt, generische Quelle) · v2-P8 AdminAuditLog + Admin-Permissions · v2-P4 MCP-Resources optional für Help-Artikel · v2-P10 i18n (Sprachsegment) Success Criteria:

  1. Markdown mit Frontmatter, Build-Time-Index (Volltext + Kategorien + Sitemap), Build-Fail bei kaputten Referenzen.
  2. Öffentliche Routen /help/{lang}/{category}/{slug} ohne Auth (vor Auth-Middleware), SEO-Defaults, Suche.
  3. Deep-Link Route→Artikel (Hilfe-Icon pro App-Route, Fallback Help-Home).
  4. Feedback-Widget (überall) → Feedback mit Auto-Kontext (tenant/user/route/browser/app-version), Screenshot-Option, Rate-Limit 10/h.
  5. Plattform-Admin: Feedback-Liste + Detail (Status-Lifecycle/Assignee/Notes/Attachments) mit Audit. Screens (David): Help-Home (Hero/Suche/Kategorien) · Kategorie-Seite · Artikel-Detail (TOC/verwandt/Vote) · Such-Ergebnisse · Feedback-Modal (in v1 schon klein da → ausbauen) · Admin-Feedback-Liste/Detail Recut/Risiko: Bewusst klein (Git-PRs, kein Editor-UI, kein volles Ticket-System in Phase 1). Später: DB-Pflege, MCP-Resource-Expose, Mehrsprachigkeit, kontextuelle Inline-Hilfe, SLA/CSAT/Live-Chat. Support-Mailbox-Sync (Mails→Feedback) nutzt M9.

v2-P10: Komfort & Querschnitt

Owner: Akeshan · Slot: W3 (29.–31.07.) · Goal: Querschnitts-Komfort — anpassbare Dashboards/Export, Notification-Bündelung/Quiet-Hours, Sprach-Wechsler/EN, HR-Drittanbieter-Onboarding. Milestones: M149 (Custom-Widgets + Drilldown), M150 (Dashboard-Export/Report), M117 (Notif-Bündelung + Quiet-Hours), M029 (Sprach-Wechsler + EN), M138 (HR-Onboarding-Drittanbieter) Depends on: v1-Dashboard/Widget-Registry (P11, voll gebaut) + Role-Default-Layouts (deklaratives Template, geteilt mit P3) · v1-notify() (P10 ergänzt Bundle-Manager/Quiet-Hours-Resolver) · v1-i18n-Library + DE-Locale (P10 füllt EN + DeepL) · v1-M33a Apps-Engine (HR-Drittanbieter) · WebSocket (Chat-geteilt) · v1-Forms/Tasks (Onboarding-Checklisten) Success Criteria:

  1. Dashboard: User passt Layout an (Drag/Resize, Widget-Catalog permission-gegated), Drilldown pro Kachel, CSV-Export, Realtime mit Opt-Out.
  2. Notifications: Bündelung (gleicher event_type_group in 5-Min-Window → 1 Push/Mail mit count), Quiet-Hours (queued, Urgent-Override), Pro-User-Präferenzen Event×Kanal.
  3. i18n: Sprach-Wechsler (Profil + Public), EN-Locale befüllt (DeepL DE→EN mit Review), vollständige Build-Validierung, Fallback DE; Empfänger-Sprach-Auflösung Outbound.
  4. HR: Onboarding-Checklisten pro neuem MA (Forms/Tasks/Reminders) + Drittanbieter via Apps-Engine. Screens (David): Dashboard-Edit-Modus (Grid + Widget-Picker + Config) · Notification-Präferenzen-Editor + Quiet-Hours · Sprach-Wechsler + Tenant-Default · HR-Onboarding-Checklisten + Drittanbieter-Setup Recut/Risiko: ⚠️ Gap M138: Memberspot/Boobora nicht spezifiziert → eigene Drittanbieter-Spec (gleiche „API-Vertrag offen"-Abhängigkeit wie KWP). M20/M22/M30 großteils v1-fähig — v2-Delta = Custom-Dashboards/Export, Bundle/Quiet-Hours, EN+DeepL. Chat-Auto-Übersetzung (M30) koppelt an M13 + EU-LLM (P4).

v2-P11: Telefonie-Erweiterung & DSGVO-Vollausbau

Owner: Raffael · Slot: W3 (29.–31.07.) · Goal: Zweiten Telefonie-Provider anbinden + DSGVO vertiefen (AVV-Versionierung, Subprozessoren-Workflow, Auskunfts-/Export-Workflow ersetzt manuelles Playbook). Milestones: M105 (HalloPetra-Adapter), M166 (AVV + Subprozessoren + Auskunfts-Workflow) Depends on: v1-TelephonyProviderInterface + AirCall-Adapter (P15) als Referenz · v1-Automation-Trigger (call.*) · v1-notify() · v1-Files (Export-ZIP, AVV-PDF) · BullMQ-Worker · v1-Account-Löschung (P2/P21) · v1-Frozen→Deletion (P20) · v2-P8 AdminAuditLog + Legal-Verwaltung Success Criteria:

  1. HalloPetra als zusätzlicher Provider hinterm TelephonyProviderInterface ohne Kern-Umbau; Webhook-Auto-Match → Activity + Automation-Trigger.
  2. Click-to-Call + Inbound + Logging providerunabhängig (E.164-Normalisierung, Match-Confidence, Notiz-Editor).
  3. AVV-Versionierung mit dynamischem PDF + elektronischer Akzeptanz, Re-Akzeptanz bei Updates (14-Tage-Frist → Read-Only).
  4. Subprozessoren-Liste mit Drittland-Warnung + 14-Tage-Widerspruchs-Workflow.
  5. User-Daten-Export (Art. 15/20) + Tenant-Voll-Export (ZIP, async, 7-Tage-Window) + Tenant-Lösch-Workflow (30-Tage-Grace + Hard-Delete-Cron). Screens (David): Telefonie-Setup (Provider-Connect, User-Bindings, Test) · Call-Session-Detail · DSGVO/Privacy-Hub (Export-Jobs, Tenant-Lösch-Multi-Step + Slug-Confirm, Subprozessoren, AVV-Download/History) · User-Daten-Export/Account-Löschung · Admin: Subprozessoren + AVV-Versions-Verwaltung Recut/Risiko: ⚠️ Gap HalloPetra: keine Spec — API-Vertrag (Auth/Webhook-Events/Recording/Call-Lifecycle) erst erheben (eigener Vorlauf-Task). AVV-PDF-Inhalt anwaltlich finalisieren (in v1 EXT-03 beauftragt). Voicemail-Transkription/Whisper ist nach AD-26 zurückgestellt.

Geteilte v2-Mechanismen (einmal robust bauen)

  • Deklaratives Branchen-Template-Seeding — zieht durch P3 (Onboarding), P6 (PortalConfig), P10 (Dashboard-/Notification-Defaults).
  • M33a-Adapter-Pattern — trägt P5 (KWP), P2 (Email-Provider), P10 (HR-Drittanbieter), P11 (Telefonie-Provider). KWP hat einen live bewiesenen OAuth-/Health-Vertrag und startet read-only; nur Writeback wartet hinter VEXT-6 auf den belastbaren Providervertrag. HalloPetra und HR warten noch auf ihren Partnervertrag.
  • Webhook-Ingest-Infra — geteilt P1 (Public-API) + P2 (Email).

Offene Vorlauf-Tasks (Specs/Verträge, vor Bau)

  1. KWP-Writeback-Vertrag (VEXT-6): Dokumentierte Mutationsoperationen einschließlich Project-/Auftrag-Create, Scopes/BNWIN-Rechte, Request-/Response-Schemas, Idempotenz-/Fehlersemantik, Rate-Limit-Verhalten und kontrollierten Testpfad bestätigen lassen. Kein Blocker des initialen read-only Scopes; Dev-Slice erst nach erneuter Produktfreigabe.
  2. HalloPetra-Spec (Telefonie-Provider-Vertrag) — neu.
  3. Memberspot/Boobora-Spec (HR-Drittanbieter) — neu.
  4. Konkrete Preise/Plans (für Self-Service P3) — in v1 EXT-14 fixiert.
  5. AVV-PDF-Inhalt anwaltlich (P11) — in v1 EXT-03 beauftragt.

Erzeugt: 2026-06-15 · aktive Quellen zuletzt bereinigt: 2026-08-02. Coverage: 43/43 v2-Scope-Bausteine gemappt.