Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/docs/CHANGE-REQUESTS.md
T

173 lines
81 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# HiveGrid Change-Requests
Diese Liste ist der vollständige Change-Request-Vertrag gemäß `AGENTS.md` §Produktgrenzen. Eine Änderung
wirkt erst, wenn Datum, Initiator, betroffener Vertrag, gewünschte Änderung, Begründung,
Aufwandsauswirkung, Entscheidung und Entscheidungsdatum dokumentiert sind. Genehmigte Änderungen müssen
anschließend in den zuständigen aktiven Quellen und Ticket-Docs nachgezogen werden.
| ID | Datum | Initiator | Betrifft (Punkt-Adresse) | Was soll geändert werden | Warum (Begründung) | Auswirkung auf Aufwand | Entscheidung | Datum der Entscheidung |
| ------ | ---------- | --------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| CR-001 | 2026-07-15 | Raffael / Produktteam | 15.1.1, 15.14.2, 27.14.2, 31.4.1, 31.4.6, 31.5.3, AD-15 | Das Customer-Portal erhält als Standard `portal.hivegrid.de/<tenant>/...` statt `app.hivegrid.de/portal/<tenant>/...`. Starter und Team können das Portal für 19,99 EUR netto/Monat je Workspace buchen; Business und Enterprise enthalten es. PortalUser und Projekte sind unbegrenzt, bestehende Plan-/Fair-Use-Limits für Speicher, Uploads und Mail bleiben. Eine eigene Portal-Subdomain kostet für Starter/Team/Business 299,99 EUR netto einmalig pro Einrichtung; Enterprise enthält eine Domain. Der Standardhost bleibt Fallback. Domain-Wechsel sind eine neue Einrichtung. | Das Portal ist eine eigenständige Endkunden-Oberfläche und ein vermarktbares Add-on. Eine eigene Kundendomain stärkt das Branding, soll aber ohne Einzelprojekt durch HiveGrid self-service-fähig sein. | `VA-P26a` wird um den separaten Runtime-/DB-Trust-Boundary erweitert und muss vor Baubeginn neu geschätzt/terminiert werden. Neuer Ticket-Scope `VA-P26c` für Entitlements/Checkout, Host-Auflösung, DNS-Verifikation, TLS/Ingress, Lifecycle, UI und Betrieb. Abhängigkeiten zu `VA-P26a`, `VA-P24a`, `VD-P26` und `VJ-3`; kein Termin wird durch diesen CR automatisch verschoben. Die endgültige Slice-Schätzung erfolgt im Ticketplan. | Genehmigt; am 2026-07-16 ergänzt: Business enthält das Portal, die Custom-Domain bleibt dort eine einmalige 299,99-EUR-Einrichtung; öffentlicher Produktstart erst nach `VA-P26b`, Domain-Cooldown 30 Tage. | 2026-07-16 |
| CR-002 | 2026-07-17 | Akeshan | M011 (Notifications-Querschnitt), R-P5 DoD #4 (Connection-Health), AGENTS.md §Querschnitt-Hülle | M011 bekommt nicht-unterdrückbare, kritische Notification-Kategorien. `isNotificationEnabled` liefert für Kategorien in `CRITICAL_NOTIFICATION_CATEGORIES` (`packages/foundation`) immer `true`, unabhängig von jeder gespeicherten Präferenz. Die Präferenz-UI zeigt sie als gesperrte, immer-aktive Gruppe (kein Toggle, „Immer aktiv"-Hinweis). Die Connection-degraded/broken-Benachrichtigung aus R-P5 (Worker-Sweeps + Web-Health-Probe) wird auf die kritische Kategorie `critical` umgehängt und läuft einheitlich über `notify()`. | Eine kaputte Integration stoppt still den Sync eines Tenants; die Warnung muss den Besitzer erreichen, auch wenn er System-Benachrichtigungen abbestellt hat, analog zu nicht-abbestellbaren Transaktionsmails. Vorher fiel die Integrations-Kategorie `system` auf die `default`-Präferenz zurück und konnte durch das Abschalten von „Allgemein" unterdrückt werden. | Klein bis mittel. `isNotificationEnabled` + Set in `packages/foundation`, Locked-Registry + UI-Zweig in `packages/view-models`/`NotificationSettingsPage`, i18n de+en, zwei Integrations-Call-Sites. Baut auf PR #149 (R-P5 notify-RLS-Fix) auf; kein Termin wird verschoben. | Genehmigt (User-Freigabe im Chat 2026-07-17). | 2026-07-17 |
| CR-003 | 2026-07-22 | Raffael / Produktteam | 4.6.14, 17.3.7, 19.2.1, 19.3.3, 19.7.1–19.7.3, M091, M094, M074, Phase 32, AD-32 | Der initiale Scope der KWP-Integration in v2-P5/Phase 32 ist read-only: HiveGrid verbindet sich per OAuth2, liest KWP-Daten und verarbeitet sie in HiveGrid, führt aber keine fachlichen KWP-Mutationen aus. Writeback einschließlich Project-/Auftrag-Create, `kwp.push_auftrag`, M091 sowie der Outbound-Anteile von M094 und M074 wird geparkt. | KWP stellt keinen Endpoint zur Neuanlage eines kaufmännischen Projekts/Auftrags bereit. Ohne belastbaren Providervertrag und kontrollierten Testpfad wäre eine generische Push-Queue oder ein anderer Schreibpfad nicht fachlich abnehmbar und könnte produktive KWP-Daten verändern. | Der bereits bewiesene Connector-/Health-Scope kann unabhängig abgeschlossen werden. Pull-, Sentinel-, Konflikt- und Inbound-Sync-Arbeit bleibt planbar. Writeback wird nicht gelöscht, sondern nach `VEXT-6` erst bei dokumentierten Operationen, Scopes/Rechten, Payloads, Fehler-/Idempotenzvertrag und erneuter Produktfreigabe als eigener Dev-Slice geschnitten. | Genehmigt. Initial/current KWP bleibt read-only; keine KWP-Mutationen. Writeback wird bis zu einem belastbaren Providervertrag und einer erneuten ausdrücklichen Freigabe geparkt. | 2026-07-22 |
| CR-004 | 2026-07-23 | Raffael / Produktteam | M092/093, Phase 32, `VR-P32b`, `VR-P32d`, CRM-Projektadressen | `VR-P32b` und `VR-P32d` werden in einem gemeinsamen PR umgesetzt, intern strikt in der Reihenfolge Schutzschicht vor Projektimport. `VR-P32d` wird von einem behaupteten cursorlosen Vollabzug auf einen gezielten Projektimport erweitert: Suche, Detailansicht, explizites Create/Link nach Diff, stabile Status-Zuordnung sowie Bindung von Projekt-, Rechnungs- und Bauherradresse an bestehende oder bewusst neu angelegte CRM-Kontakte. Pro Rolle kann höchstens ein primärer Ansprechpartner gewählt werden. | Der bestätigte KWP-Vertrag bietet Projekt-Suche und Detailabrufe, aber keine garantierte Pagination für einen vollständigen Bestand. Ein Vollimport wäre daher nicht beweisbar. Der erste fachlich nutzbare read-only Slice muss ein ausgewähltes KWP-Projekt vollständig und wiederholbar mit HiveGrid-Projektkern und CRM verbinden. | Groß, geschätzt 14–20 Entwicklungstage inklusive Schutzschicht, persistenter Bindings, Polling, Interim-UI, Tests und CI. `VR-P32d` wächst von 7 auf 10 überprüfbare DoD-Punkte. `VR-P32c` konsumiert dieselbe Schutz-/Binding-Schicht; `VN-2` bleibt nachgelagerter Live-Proof. `VD-P32` bleibt Design-Nachzug und blockiert die Interim-UI nicht. | Genehmigt. Ein gemeinsamer PR ist zulässig; KWP bleibt fachlich read-only. Die lokale HiveGrid-Projektnummer bleibt erhalten, KWP-`projNr` ist eine externe Referenz. Erstimport löst keine Automationen aus; spätere Stage-Wechsel senden das bestehende Event mit `source=kwp`. Beim Trennen bleiben lokale Projekt-/CRM-Daten erhalten. | 2026-07-23 |
| CR-005 | 2026-07-24 | Raffael / Produktteam | Phase 32, M089–M095, M074, `VR-P32c`, `VEXT-6`, AD-32 | Der KWP-Adapter wird gegen die vollständige aktuelle Tenant-OpenAPI inventarisiert. Von 554 dokumentierten Operationen liegen 113 in den fünf für HiveGrid lizenzierten `*-extern`-Scopes: 77 semantisch lesende und 36 mutierende Operationen. Alle 113 erhalten einen expliziten, schema-validierten Adaptervertrag und capability-spezifische Drift-Abdeckung. Die 77 Leseoperationen dürfen nur über eine feste Allowlist ausgeführt werden. Die 36 Mutationen werden als echte, fixture-validierte Verträge erfasst, bleiben aber im Runtime-Transport fail-closed gesperrt und werden weder als Action noch als Queue oder UI-Aktion registriert. | Der bisherige Drei-Operationen-Adapter deckt nur Projekt-Suche, Projektdetails und eine Adresse ab. Für Plantafel, Aktivitäten, Vorgänge, Archiv, Aufgaben und Material braucht HiveGrid den gesamten tatsächlich lizenzierten Vertragsraum, ohne einen generischen URL-Pass-through oder ungeprüfte Rohpayloads einzuführen. Gleichzeitig dürfen Staging- oder Kundendaten während der Adapterentwicklung nicht verändert werden. | `VR-P32c` wächst von 5 auf 9 überprüfbare DoD-Punkte und umfasst den vollständigen Scoped-Contract, 77 Read-Adapter, 36 gesperrte Mutation-Contracts und capability-spezifischen Sentinel zusätzlich zum bisherigen Inbound-Scope. Die vollständigen 554 Operationen werden inventarisiert; 441 Operationen außerhalb der lizenzierten fünf Scopes werden bewusst nicht ausführbar gemacht. `VEXT-6` bleibt 0/4, weil weiterhin Project-/Auftrag-Create, Provider-Idempotenzvertrag und freigegebener Live-Write-Testpfad fehlen. `VN-2` bleibt der kontrollierte Inbound-Live-E2E. | Genehmigt. Lesende Operationen dürfen auf Staging secretsicher und ohne Import-Nebenwirkung verprobt werden. Schreibende Operationen werden nur gegen Vertrags-Fixtures getestet; kein Live-Write ohne erneute gemeinsame Freigabe. Der Merge erfolgt als normaler Merge, nicht als Squash. | 2026-07-24 |
| CR-006 | 2026-07-24 | Raffael / Produktteam | Phase 32, `VR-P32b`, `VR-P32d`, `VR-P32c`, `VN-2`, KWP-Projektkatalog | Eine bestätigte KWP-Verbindung startet automatisch einen read-only Projektkatalog-Lauf. `Projektampel/LoadProjekteNachFilter` entdeckt die im bestätigten Mandanten und in den KWP-Projektampel-Einstellungen sichtbaren Projektnummern; Worker reichern sie unter gemeinsamem Rate-Budget in begrenzten, replay-sicheren Batches an. Manuelle KWP-Suchen schreiben Treffer sofort in denselben tenant-/connectiongebundenen Cache. Die Importansicht sucht cache-first mit einem indizierten normalisierten Suchtext und ergänzt Treffer kontrolliert über die Live-Suche. Response-Drift wird für den Import nur anhand der tatsächlich konsumierten, Zod-validierten Felder bewertet; bekannte, aber ungenutzte OpenAPI-Felder mit providerseitig abweichender Nullable-Semantik pausieren die Capability nicht. Die Interim-UI wird gegen Überlappungen korrigiert und zeigt den Katalogzustand. | Der echte Staging-Payload liefert bei ungenutzten Adressfeldern wie `ortPstf`, `briefanrede`, `selekt1`, `selekt2` und `bank` `null`, obwohl die Tenant-OpenAPI dort nur Objekte beschreibt. Die konsumierten Projekt-/Adressfelder sind gültig; die bisherige Vollobjektvalidierung erzeugt daher einen falschen Capability-Stopp. Außerdem ist eine ausschließlich synchrone Provider-Suche bei großen Projektbeständen langsam und unnötig abhängig von KWP-Verfügbarkeit. | `VR-P32d` wächst von 10 auf 14 DoD. Neue tenant-scoped Katalogtabellen, Forward-only-Migration, RLS/Registry, Queue-Job, Maintenance-Scheduling, read-through Cache, trigram-indizierte Suche, Katalogstatus im VM und fokussierte Worker-/Route-/Visual-Tests. `VR-P32b` behält echte semantische Drift als Pause-Grund; `VR-P32c` konsumiert weiter denselben Read-only-Transport. `VN-2` bleibt der kontrollierte Live-Importbeweis. | Genehmigt durch ausdrücklichen User-Auftrag im Chat. KWP bleibt fachlich read-only. Es wird kein leerer `Projekt/Search`-Aufruf und kein garantierter providerweiter Vollbestand behauptet: `LoadProjekteNachFilter` ist laut Vertrag ein einstellungsabhängiger sichtbarer Projektplatzhalter-Bestand ohne Pagination. Der lokale Katalog ist für große Bestände ausgelegt und wird asynchron vervollständigt; kein Request hält eine lange DB-Transaktion offen. Merge ausschließlich als normaler Merge-Commit, niemals Squash. | 2026-07-24 |
| CR-007 | 2026-07-27 | Raffael / Produktteam | M006, `R-LEADS`, `VA-P28b`, `AK-SET-01`, `VA-P26a/b/c` | Die fertigen Kernfunktionen Plattform-Leads, Gruppenverwaltung und Kundenportal werden nicht mehr durch die globalen Flags `platform_admin_leads`, `row-groups` und `customer-portal` geschaltet. Sie sind standardmäßig verfügbar und werden ausschließlich durch Identität, Permissions, Tenant-/Subscription-Zustand und Portal-Entitlements begrenzt. Vorhandene Flag-Zeilen werden als Audit-Tombstones archiviert und aus Auswertung sowie Verwaltung ausgeblendet. Der externe Lead-Ingress-Schalter bleibt als separater operativer Sicherheitsschalter bestehen. | Ein fehlender Datenbank-Flag-Eintrag erzeugte auf Staging trotz korrekter Berechtigung eine tote Admin-Route (404). Abgeschlossene Produktfunktionen dürfen nicht von manuell gepflegten Rollout-Daten abhängen. | Mittel. Web, Worker, RLS-Vertrag, Seed-/Bootstrap-Pfade, Flag-Verwaltung, Tests, Migration und Betriebsdokumentation werden gemeinsam nachgezogen. Bestehende Permission-, RLS-, Subscription- und Entitlement-Grenzen bleiben unverändert. | Genehmigt durch ausdrücklichen User-Auftrag im Chat: standardmäßig aktivieren und die drei Flags entfernen. | 2026-07-27 |
| CR-008 | 2026-07-30 | Raffael / Produktteam | `BILL-10`, `BILL-11`, `VA-P24a`, `AK-P14b`, Billing-Checkout und Verbrauchsanzeige | HiveGrid erhält vor dem Mollie Hosted Checkout eine eigene, serverseitig aus der Mollie Methods API geladene Zahlungsmethoden-Auswahl. Tarif- und Add-on-Käufe zeigen Preis, Leistung und Zahlart zusammenhängend in HiveGrid; die Bank-/3DS-Bestätigung bleibt als sicherer Top-Level-Handoff bei Mollie. Produktkäufe erhalten einen tenant-gebundenen Return-Flow. Speicher- und E-Mail-Marketing-Verbrauch werden read-only gegen die bereits erzwungenen Quoten sichtbar. Ein Wechsel des E-Mail-Marketing-Pakets aktiviert das neue Kontingent erst nach bestätigter Zahlung und beendet das alte Paket danach atomar mit durablem Provider-Cleanup. | Wenige Tage vor dem Pilot sollen Checkout, Rückkehr und Freischaltung wie ein zusammenhängender HiveGrid-Flow wirken. Nutzer müssen vor dem Kauf wissen, welche Zahlart, Leistung und Auslastung gelten. Das alte „erst kündigen, dann neu buchen“ erzeugt eine unnötige Funktionslücke; ein voreiliges Kündigen vor Zahlung wäre dagegen abrechnungsgefährlich. | Mittel bis groß. Mollie-Gateway-Vertrag, Billing-VM/Interim-UI, Add-on-Ledger-/Webhook-Sync, Return-Route, Usage-Queries, i18n, Visual-/Hot-Swap-/Route-/Provider-Tests und kontrolliertes Staging-E2E werden gemeinsam nachgezogen. Keine neue Usage-Abrechnung, kein Iframe und keine Abhängigkeit von Mollies privater Checkout-Session-Beta. `BILL-08` / `EXT-16` bleiben unveränderte Production-Gates. | Genehmigt durch ausdrücklichen User-Auftrag im Chat am 2026-07-30: alle offenen Billing-Nachzüge fertigstellen und die Mollie-Zahlung sauber in HiveGrid einbetten. | 2026-07-30 |
| CR-009 | 2026-07-31 | Raffael / Produktteam | Registrierung, `BILL-11`, `BILL-13`, Billing-Checkout | Die Registrierung erhält nach den Kontoangaben eine separate Teamgrößen-Seite. Der Nutzer gibt Büro- und Monteur-/Baustellen-Nutzer an; HiveGrid berechnet mit dem kanonischen Monatskatalog für Core, Swarm und Colony jeweils Basis- plus Zusatznutzerpreis und empfiehlt die günstigste Konfiguration. Die Empfehlung bleibt überschreibbar. Gewählte Mengen und Tarif werden bis nach der E-Mail-Verifizierung persistiert und im bestehenden Billing-/Mollie-Checkout vorausgefüllt. | Die bisherige statische Tarifliste verlangt vom Nutzer, Inklusivmengen und Zusatznutzerpreise selbst gegeneinander zu rechnen. Eine nachvollziehbare Empfehlung reduziert Fehlbuchungen und macht den Weg von Registrierung zu Zahlung konsistent. | Mittel. Reiner Empfehlungscontract, zweistufige Interim-UI, optionale Felder am Pre-Auth-Registrierungsdatensatz, sichere Replay-/Verifizierungsübergabe, Billing-VM-Prefill, Forward-only-Migration sowie Unit-, Route-, A11y-, Visual- und Hot-Swap-Tests. Preise, Planleistungen, Lago-/Mollie-Verträge und Production-Gates bleiben unverändert. | Genehmigt durch ausdrücklichen User-Auftrag im Chat am 2026-07-31. | 2026-07-31 |
| CR-010 | 2026-08-01 | Raffael / Produktteam | Tenant-Bootstrap, `VA-P26a`, `VA-P26c`, Customer-Portal-Admin | Jeder Tenant erhält beim Bootstrap atomar einen unveröffentlichten Customer-Portal-Scaffold; bereits bestehende Tenants ohne Portal werden einmalig idempotent nachgezogen. Der Scaffold übernimmt Tenant-Slug und -Name, veröffentlicht nichts und erzeugt keinerlei Billing-, Entitlement-, Checkout- oder Domain-Zustand. | Der vollständige Staging-UAT nach der Registrierung hat gezeigt, dass die Portal-Admin-Routen einen vorhandenen Portal-Datensatz voraussetzen, während der normale Tenant-Bootstrap keinen erzeugt. Frische zahlende Tenants landeten deshalb vor dem Portal-Add-on-Kauf auf einem generischen 500er. | Klein. Eine zusätzliche Query in der bestehenden Bootstrap-Transaktion, eine konfliktprüfende Forward-only-Datenmigration, fokussierte Unit-/Performance-/Migrationsverträge sowie erneuter Staging-UAT des Portal-Add-on-Kaufs. Keine Preis-, Entitlement-, RLS- oder Veröffentlichungsänderung. | Genehmigt durch ausdrücklichen User-Auftrag im Chat, alle Billing- und Customer-Portal-Flows bis zum erfolgreichen Staging-Test fertigzustellen. | 2026-08-01 |
| CR-011 | 2026-08-01 | Raffael / Produktteam | `BILL-14`, `BILL-15`, `BILL-11`, wiederkehrende Produktkäufe und Rechnungsinkasso | Wiederkehrende Add-on-Käufe spiegeln nach bestätigter Mollie-Zahlung die exakte initiale Lago-Rechnung als bezahlt. HiveGrid persistiert die getrennten Lago-Providerreferenzen, unterscheidet `subscription_starting` strikt von `subscription_periodic`, markiert die bereits per Checkout bezahlte Erstrechnung idempotent und lässt ausschließlich echte Folgerechnungen in das wiederkehrende Mollie-Inkasso. Bestehende aktive Käufe werden über den bounded 5-Minuten-Reconciler tenantweise nachgezogen. | Der vollständige Staging-UAT hat bewiesen, dass E-Mail-Marketing und Customer-Portal korrekt freigeschaltet werden, ihre Lago-Rechnungen aber auf „Ausstehend“ bleiben. Gleichzeitig fehlt dem lokalen Produkt-Mirror die Lago-Provider-Subscription-ID; eine spätere Invoice-Webhook-Wiederholung könnte die Erstrechnung nicht sicher von einer Folgerechnung unterscheiden. Das ist ein Rechnungs- und potenzielles Doppelabbuchungsrisiko vor dem Pilot. | Mittel. Zwei nullable Provider-Mirror-Felder, Forward-only-Migration, erweiterter Lago-Invoice-Contract, exakte Outbox-Side-Effects, bounded Self-Heal im bestehenden Reconciler, Initialrechnungs-Gate vor dem Recurring-Collector sowie Unit-, Worker-, API-, Migration-, RLS- und Staging-E2E-Proof. Preise, Entitlements und Mollie-Live-Gates bleiben unverändert. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, alle Billing-Flows vollständig fertigzustellen, mit Mollie-Testzahlungen live zu prüfen und sichere Launch-Fixes selbstständig umzusetzen. | 2026-08-01 |
| CR-012 | 2026-08-01 | Raffael / Produktteam | `EXT-02`, Signup-Willkommensmail, `packages/mail` Mailjet-Adapter | Mailjets `CustomID` wird auf den im Staging-Sandbox-Test bestätigten 64-Zeichen-Vertrag begrenzt. Kurze IDs bleiben lesbar; längere Replay-Keys erhalten eine deterministische SHA-256-Korrelation mit exakt höchstens 64 Zeichen. Sender, Template, Queue, Retry- und Idempotenzvertrag bleiben unverändert. | Frische direkte Registrierungen erzeugen einen 93 Zeichen langen Welcome-Replay-Key. Mailjet akzeptiert im Sandbox-Proof 64 Zeichen, weist 65 und mehr jedoch mit `mj-0006` zurück. Die bisherige 100-Zeichen-Annahme ließ dadurch jede Welcome-Delivery dauerhaft fehlschlagen. | Klein. Ein Provider-Normalizer, fokussierte Grenz-/Kollisions-/Replay-Tests, Full-Gate, Staging-Deploy und Zustellproof an einem frischen Test-Signup. Keine neue Mail, kein Providerwechsel und kein Eingriff in Marketingversand. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, nach Billing auch Willkommens-E-Mails und die SaaS-Onboarding-Experience bis zum Staging-Proof zu prüfen und sichere Launch-Fixes umzusetzen. | 2026-08-01 |
| CR-013 | 2026-08-01 | Raffael / Produktteam | Phase 32, `VR-P32c`, `VN-2`, KWP-Inbound-Runtime | Die vier KWP-Inbound-Bereiche Termine, Aufgaben, Material und Archiv werden voneinander entkoppelt. Termine, Aufgaben und Material laufen weiter alle 15 Minuten und werden je Bereich unabhängig übernommen. Das Archiv wird höchstens alle sechs Stunden in fortsetzbaren Fünf-Ordner-Batches bis zu einer Sicherheitsgrenze von 1.000 Ordnern entdeckt. Jede Datei bleibt ein eigener Job mit drei Versuchen und exponentiellem 60-Sekunden-Backoff. Temporäre Archiv-Providerfehler lassen die Connection aktiv und erscheinen als Dateifehler mit automatischem Retry statt als Reconnect-Aufforderung. | Der kontrollierte Staging-Read zeigte 35 zugängliche Archivordner und überschritt damit die bisherige harte 20-Ordner-Grenze. Drei repräsentative `archivExternalExportDatei`-Reads lieferten reproduzierbar HTTP 500, obwohl OAuth, Tokenrotation, Health und alle sechs Capabilities aktiv blieben. Der bisherige gekoppelte Vollsnapshot verwarf dadurch auch gesunde Kerndomänen und erzeugte 111 fehlgeschlagene Vollwiederholungen in 24 Stunden. | Mittel. Keine Schema- oder KWP-Write-Änderung. Neue resumierbare Queue-Payloads, tenant-sichere Archivauflösung, bereichssichere Missing-Reconciliation, Retry-Klassifizierung, Klartextstatus und fokussierte Integrations-/Worker-/Queue-Tests. `VR-P32c` bleibt implementiert; `VN-2` bleibt bis zum kontrollierten Staging-Importbeweis offen und `VH-1` bis dahin blockiert. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, den permanenten Fix vollständig umzusetzen, auszurollen und kontrolliert zu beobachten. CR-003/AD-32 bleibt unverändert: keinerlei fachliche KWP-Mutation. | 2026-08-01 |
| CR-014 | 2026-08-01 | Raffael / Produktteam | `BILL-13`, `BILL-11`, dedizierter Billing-Usage-Tab | Der separate Usage-Tab verwendet für Speicher dieselbe RLS-gebundene, kommerzielle Kapazitätsprojektion wie die Billing-Hauptseite und die Upload-Grenze. Verbrauch ist gespeicherte plus laufend reservierte Bytes; Limit ist Basistarif plus feste Speicher-Add-ons. Ein nicht sicher bestimmbares Limit wird als Klartext-Fehler statt als „kein Limit“ dargestellt. | Der abschließende Staging-UAT zeigte auf demselben aktiven Swarm-Workspace mit `storage_100gb` korrekt 350 GB in der Billing-Hauptseite, aber „0 BYTES / kein Limit“ im Usage-Tab. Die alte Route las ausschließlich Legacy-`SubscriptionFeature`-/UsageRecord-Daten und band ihre eigenen Queries nach dem Modul-Gate nicht an RLS. | Klein. Bestehenden Resolver wiederverwenden, Read-Grenze binden, Service-/Route-Regressionstests, i18n und erneuter Staging-Screenshot. Keine Migration, kein Katalog-, Preis-, Checkout- oder Providerwechsel. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, den vollständigen Billing-Flow live zu prüfen und gefundene sichere Launch-Fixes selbstständig fertigzustellen. | 2026-08-01 |
| CR-015 | 2026-08-01 | Raffael / Produktteam | `MAIL-01`, transaktionale React-E-Mail-Templates, Signup-Willkommensmail | Transaktionale E-Mails erhalten die tatsächliche Dokumentsprache, einen vollständig lokalisierten Footer und die bereits vom Renderer erzeugte Plaintext-Alternative bis in Queue, Outbox und Mailjet-`TextPart`. Der künstliche einzelne Bindestrich in der Signatur entfällt. | Der reale MAIL-01-Screenshot zeigte deutschen Hauptinhalt unter `lang="en"`, einen englischen Footer und eine isolierte Bindestrichzeile. Der Renderer erzeugte korrekt Plaintext, der Web-Wrapper verwarf ihn jedoch vor dem Versand. Mailjet empfiehlt passende `lang`-Attribute und stets eine lesbare Reintext-Version. | Klein bis mittel. Expliziter, optionaler Mail-Chrome-Vertrag, vorhandene de/en-Mailübersetzungen, Text-Propagation im bestehenden Payload und fokussierte Template-/Signup-/Outbox-/Provider-Tests. Keine neue Mail, kein neuer CTA, keine Provider-, Secret-, Retry-, Idempotenz- oder Marketingänderung. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, nach Billing die Willkommensmail wie bei einem klassischen SaaS zu prüfen und sichere, recherchierte Launch-Verbesserungen selbstständig umzusetzen. | 2026-08-01 |
| CR-016 | 2026-08-01 | Raffael / Produktteam | `BILL-14`, öffentliche Registrierung, self-hosted CAP | Der Team-/Tarif-Schritt erhält eine responsive Entscheidungshierarchie mit Rollen-Steppern, prominenter Tarifempfehlung, eingeklappten Alternativen und klarer Vorab-Zahlungsinformation. Der Client bindet die CAP-Events `solve`, `reset` und `error`; ein Submit bleibt bis zu einem frischen Proof gesperrt. Nach jedem fehlgeschlagenen initialen Registrierungs-POST remountet ein opaker serverseitiger Retry-Schlüssel eine neue Challenge. | `noValidate` erlaubte einen Registrierungs-POST ohne CAP-Proof. Ein bereits erfolgreich verifizierter CAP-Token ist einmalig und konnte bei einem späteren Validierungsfehler dennoch im optisch gelösten Widget verbleiben; der nächste Versuch scheiterte dadurch wiederholt bis zum Reload. Gleichzeitig war der lange schmale Tarifscreen kurz vor dem Piloten schwer erfassbar. | Mittel. Reiner UI-/Request-Response-Nachzug ohne Migration oder Provideränderung: vorhandene `~/ui`-Komponenten, CAP-Statusvertrag, opaker Reset-Key, de/en/formal-i18n, Unit-/Service-Regressionen und Desktop-/Mobile-Pixelbaselines. Preise, Empfehlung, E-Mail-Verifikation, Mollie/Lago und Entitlements bleiben unverändert. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, den gezeigten Checkout-Vorlauf neu zu gestalten und den blockierenden CAPTCHA-Fehler vollständig zu beheben. | 2026-08-01 |
| CR-017 | 2026-08-02 | Raffael / Produktteam | `BILL-14`, `BILL-18`, Registrierung, Subscription-Gate, Billing-Erstkauf | Synchron prüfbare Passwortregeln blockieren den Wechsel aus dem Konto-Schritt und werden dort inline erklärt. Nach dem technischen Workspace-Bootstrap erscheint für Tenants ohne Subscription-Produkt und ohne aktive Testphase ein eigener, app-chrome-freier Aktivierungscheckout. Er übernimmt die registrierte Tarif-/Sitzpräferenz, zeigt die serverseitig geprüfte Preiszusammenfassung und führt mit genau einer Primäraktion zu Mollie. Laufende Nutzung, Rechnungen und unabhängige Add-ons bleiben bis zur Basisaktivierung aus diesem Zustand ausgeblendet. | Der reale Staging-Flow meldete ein zu kurzes Passwort erst nach dem finalen Tarif-Submit. Nach erfolgreicher Registrierung zeigte er anschließend die vollständige Workspace-/Settings-Hülle und eine lange Verwaltungsseite, obwohl noch keine Zahlung und keine aktive Testphase vorlagen. Das Backend sperrte Fachmodule korrekt, die visuelle Systemgrenze und Informationsarchitektur vermittelten jedoch das Gegenteil. | Mittel. Reiner UI-/Routing-/Gate-Nachzug mit bestehenden View-Models, `~/ui`, Preisvorschau und Checkout-Actions. Route-, Component-, A11y-, Desktop-/Mobile- und Live-Mollie-Testproof. Keine Migration, keine neue Trial, keine Preis-, Provider-, Rechnungs- oder Entitlement-Änderung. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, die verspätete Passwortwarnung, den unbezahlten Workspace-Eindruck und die unübersichtliche Erstkaufseite vollständig UX-technisch zu korrigieren. | 2026-08-02 |
| CR-018 | 2026-08-02 | Raffael / Produktteam | `BILL-19`, `AK-P20`, `VA-P24a`, Checkout-Return, Onboarding, aktive Billing-Verwaltung | Nach bestaetigter Basiszahlung fuehrt HiveGrid ohne Timer in eine eigene, app-chrome-freie Welcome-/Setup-Surface. Sie verwendet die vorhandene RLS-gebundene Erste-Schritte-Session, ergaenzt Team-Einladung als automatisch erkannten Setup-Schritt und bleibt im Dashboard resumierbar. Die aktive Billing-Hauptseite trennt Uebersicht, Tarif/Nutzer und Zusatzmodule; Speicher, E-Mail-Marketing und Customer-Portal verwenden weiterhin ihre bestehenden Checkout-/Entitlement-Vertraege. | Der aktuelle Return verteilt Nutzer auf drei gleichrangige Ziele und erzwingt nach zehn Sekunden das Dashboard. Gleichzeitig stapelt die aktive Billing-Seite Vertragsstatus, Nutzung, Trial-Hinweis, kompletten Tarif-/Seat-/Speicher-Builder und E-Mail-Marketing. Kurz vor dem Piloten fehlt damit eine klare erste Nutzungsphase und eine aufgabenorientierte Billing-Informationsarchitektur. | Mittel bis gross. Neue pure Welcome-VM und Route, `~/ui`-Interim-Screen, synthetischer tenantgebundener Team-Detection-Step ohne Migration, fokussierte Billing-Navigation, bestehende Portal-Deep-Links sowie Unit-/Route-/A11y-/Visual-/Staging-UAT-Proof. Keine Preis-, Trial-, Provider-, Schema-, Rechnungs- oder Entitlement-Aenderung; der gecancelte 10-Step-Scope aus `VA-P24b` bleibt geparkt. | Genehmigt durch den ausdruecklichen User-Auftrag im Chat, die Journey von Registrierung und Mollie-Zahlung bis Welcome, Team-Setup und uebersichtlichem Billing komplett fuer den Pilot-Launch zu ueberarbeiten und end-to-end zu belegen. | 2026-08-02 |
| CR-019 | 2026-08-02 | Raffael / Produktteam | `BILL-08`, `BILL-11`, `BILL-13`, `BILL-14`, Mollie-Erst- und Folgezahlungen | Bei einem an Mollie übergebenen Bruttobetrag bis einschließlich 1.000,00 EUR bleibt der bestehende Mandatsvertrag gültig. Ab 1.000,01 EUR ist `creditcard` für Basisplan-, Änderungs- und Add-on-Checkouts sowie invoice-getriebene Folgezahlungen zwingend. Fehlt die Karte im konkreten Mollie-Profil, bricht HiveGrid vor Provider-Mutationen mit Klartext ab. Der technische Katalogcode `annual_sepa` bleibt migrationsstabil, bestimmt oberhalb der Grenze aber nicht die Zahlart. | Mollies dokumentiertes Standardmaximum für SEPA Direct Debit beträgt 1.000 EUR. Colony liegt bereits ohne Extras bei 1.069,81 EUR brutto. Der bisherige 12-Monatsvertrag blendete Karten aus, autorisierte per iDEAL ein SEPA-Mandat und erzwang im Worker später erneut `directdebit`; damit war der größte Standardtarif nicht sicher wiederkehrend einziehbar. | Mittel. Zentraler Payment-Policy-Resolver, serverseitige Methodenauswahl, fail-closed Kartenverfügbarkeit, Recurring-Worker-Nachzug, Klartext-UI und Grenzwerttests. Keine Migration, keine Preis-, Laufzeit-, Steuer-, Lago-, Entitlement- oder Hosted-Checkout-Änderung. Das bisherige externe SEPA-Limit-Gate in `BILL-08` entfällt; Mollie-Live-KYC und Legal-/Steuerfreigabe bleiben. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, Zahlungen über 1.000 EUR zwingend per Mollie-Karte abzuwickeln. | 2026-08-02 |
| CR-020 | 2026-08-02 | Raffael / Produktteam | `REQ-i18n-architektur`, `REQ-i18n-outbound`, ROADMAP Phase 3/30, bisheriger v1-DE-only-Vertrag | HiveGrid erweitert den statischen Produkt- und Transaktionskatalog von Deutsch/Englisch um Polnisch (`pl`), Russisch (`ru`), Ukrainisch (`uk`) und Ungarisch (`hu`). Alle sechs Basis-Sprachen und ihre formellen Anredevarianten werden vollständig verdrahtet. Vorhandene Kataloge und produktiv aktivierte Sprachen werden getrennt: `I18N_ENABLED_LOCALES` aktiviert standardmäßig nur `de,en`; jede weitere Sprache bleibt bis zum dokumentierten Muttersprachler-Gate deaktiviert. UI-Sprache, Customer-Portal, Billing-Hülle und Systemmails folgen derselben aktivierten Empfängersprache. Knowledge-Base-Inhaltssprachen und nutzergenerierte Inhalte bleiben getrennte Verträge. | Polnisch und Ukrainisch decken den priorisierten Handwerks-Arbeitsmarkt ab; Russisch und Ungarisch gehören zum ausdrücklich freigegebenen Produktscope. Der bestehende i18n-Unterbau ist bereits katalogbasiert, aber harte `de/en`-Sonderfälle würden neue Sprachen unvollständig oder unkontrolliert aktivieren. | Groß. Vier vollständige Kataloge mit je neun Namespaces, formelle Overrides, Release-Konfiguration, Locale-Auflösung, Portal-/Mail-/Billing-Nachzug, Terminologie-/Review-Artefakte, automatisierte Paritäts-/Token-/Plural-/Fallback-Gates sowie Browser- und Mail-UAT. Keine Datenbankmigration, kein Runtime-Übersetzungsdienst und keine neue LLM-Abhängigkeit. Rumänisch wird nur als nächster Ausbau dokumentiert. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, den vorliegenden Umsetzungsplan für Polnisch, Russisch, Ukrainisch und Ungarisch vollständig umzusetzen. | 2026-08-02 |
| CR-021 | 2026-08-02 | Raffael / Produktteam | `BILL-11`, `BILL-14`, `BILL-19`, `BILL-20`, `BILL-21`, Registrierungs- und Mollie-Erstkaufpfad | Registrierung und Aktivierung werden als geführter Ablauf neu geschnitten: Teamgröße vor Tarif, serverseitig live berechnete Empfehlung und Preise, anschließend getrennte und überspringbare Speicher- sowie E-Mail-Marketing-Upsells und eine fokussierte Zahlungsseite. Bis einschließlich 1.000,00 EUR kann der Kunde alle von Mollie für den konkreten Betrag angebotenen Erstzahlarten einschließlich Kreditkarte frei wählen; ab 1.000,01 EUR bleibt Karte zwingend. Wiederkehrende Belastungen verwenden ein gültiges Mandat der gewählten Methodenfamilie und fallen nie still auf SEPA zurück. Der technische Cadence-Code `annual_sepa` bleibt migrationsstabil, ist aber keine UI- oder Methodenpflicht mehr. | Der aktuelle Flow vermischt fünf Entscheidungen, versteckt alternative Tarife und bindet 12-Monatsverträge unnötig an iDEAL/SEPA. Zusätzlich widersprach der Mollie-Adapter dem in `BILL-21` eingeführten Recurring-Kartenvertrag. Kurz vor dem Piloten müssen Produktauswahl, Upsells, Betrag und Zahlart getrennt verständlich und technisch konsistent sein. | Mittel bis groß. Reiner UI-/Service-/Worker-Nachzug mit bestehenden `~/ui`-Komponenten, Katalog-/Preview-Verträgen und Hosted Checkout; keine Schemaänderung und keine eigenen Zahlungsfelder. Speicherpreise werden in diesem Slice nur anhand aktueller Hetzner-Kosten bewertet und nicht ohne separate Produktentscheidung geändert. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, Kreditkarte auch unter 1.000 EUR frei anzubieten und Team-, Tarif-, Speicher-, E-Mail- sowie Zahlungsschritte vollständig neu zu ordnen. | 2026-08-02 |
| CR-022 | 2026-08-02 | Raffael / Produktteam | `MAIL-01`, `MAIL-02`, `I18N-01`, alle festen transaktionalen und runtime-erzeugten HiveGrid-Systemmails | Alle von HiveGrid selbst formulierten Systemmails verwenden einen gemeinsamen, responsiven Markenrahmen mit horizontalem HiveGrid-Logo, klarer Typografie, abgestufter Informationshierarchie, lokalisiertem Preheader, konkretem CTA, vollständiger Plaintext-Alternative, Supportkontakt sowie den verbindlichen Plattformlinks `https://hivegrid.de/agb`, `https://hivegrid.de/datenschutz` und `https://hivegrid.de/impressum`. Bestehende rohe HTML-/Text-Versandpfade werden auf denselben Renderer umgestellt. Plattformlogo und Plattform-Rechtslinks bleiben fest; Tenant-/Projektkontext erscheint in Inhalt und Absenderkontext, ersetzt aber nicht die HiveGrid-Absenderidentität. | Der reale Inbox-UAT zeigte ein inkonsistentes Produktbild: Der Brand-Resolver liefert verschachtelte Tokens, während das Mail-Theme flache Werte erwartet; dadurch erscheint oft nur ein Textfallback. Zudem umgehen zahlreiche Runtime-Mails den React-Renderer vollständig, besitzen weder Logo noch einheitlichen Footer und enthalten teils knappe oder hartkodierte Texte. Der Empfänger soll Anlass, Bedeutung und nächste Aktion auf einen Blick verstehen und HiveGrid eindeutig als vertrauenswürdigen Absender erkennen. | Mittel bis groß. Gemeinsames Mail-Designsystem, absolut gehostetes E-Mail-Logo, zentraler Brand-Adapter, generische Systemmail-Komponenten, Nachzug aller festen Web-/Worker-Mailpfade, sechs Basis-Sprachen plus formelle Fallbacks, Rendering-/Snapshot-/Text-/Link-Verträge und realer Inbox-UAT. Keine neue Mailkategorie, kein Marketing- oder nutzergenerierter Inhalt, kein Provider-, Secret-, Queue-, Retry-, Tracking-, Billing- oder Datenbankvertrag. Die vier neuen Sprachen bleiben produktiv deaktiviert. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, sämtliche festen HiveGrid-Systemmails mit Logo, Farben, visueller Hierarchie und professionelleren Texten vollständig zu überarbeiten und danach ohne Testkennzeichnung wie an einen echten Kunden zuzustellen. | 2026-08-02 |
| CR-023 | 2026-08-02 | Raffael / Produktteam | `BILL-08`, `BILL-11`, `BILL-17`, `BILL-22`, Storage-Kapazität, Checkout, Usage und Lago-Katalog | Speicher wird als gemeinsamer Workspace-Pool verkauft, der mit bezahlten Nutzerplätzen wächst: Core 100 GB plus 10 GB je Zusatznutzer, Swarm 500 GB plus 20 GB, Colony 2 TB plus 40 GB. Büro und Baustelle zählen für Speicher gleich. Feste `Cloud-Speicher Plus`-Pakete bleiben vorhersehbar und kosten 1,25/6,25/12,50/62,50 EUR netto für 100 GB/500 GB/1 TB/5 TB. Die Rohmarge ist selbst ohne Egress auf maximal 50 Prozent gegen 6,26 EUR/TB direkte Hetzner-Speicherkosten gedeckelt. | Pauschaler Planspeicher plus rollenabhängige Zusatzkontingente ist schwer greifbar, obwohl Projektdateien dem Workspace gehören. Die bisherigen Add-ons erzielen 84 bis 93 Prozent Rohmarge und sind für den Pilotkunden unnötig teuer. Ein lizenzbasierter gemeinsamer Pool ist transparent, skaliert mit dem Team und vermeidet persönliche Dateisilos. | Mittel. Versionierter Katalog-, Kapazitäts-, VM-, Checkout-, Usage-, Lago-Sync-, i18n- und Visual-Nachzug ohne Schemaänderung oder Usage-Metering. Technische Codes bleiben stabil; Production-Sync bleibt hinter `BILL-08`. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, die Speicherabrechnung vollständig neu zu denken, intelligent in den geführten Billing-Flow zu integrieren und die Rohmarge auf maximal 50 Prozent zu begrenzen. | 2026-08-02 |
| CR-024 | 2026-08-03 | Raffael / Produktteam | `BILL-08`, `BILL-23`, Speicher-Upsell, Checkout und Lago-Katalog | Neu buchbare Speicherpakete verwenden ein konsistentes, wertigeres `,99`-Raster: 500 GB für 4,99 EUR, 1 TB für 9,99 EUR und 5 TB für 49,99 EUR netto pro Monat. Das bisherige 100-GB-Paket bleibt nur für Bestandsverträge technisch auflösbar und wird für Neuabschluss und Upsell serverseitig gesperrt. Die maximal 50-prozentige direkte Rohmarge bleibt unverändert verbindlich. | Die bisherigen Viertel-/Halbeuropreise wirken wie interne Kalkulationswerte; ein 100-GB-Einstieg für 1,25 oder 1,99 EUR setzt einen zu billigen Preisanker. Drei klare Größen sind leichter vergleichbar, wertiger und halten mit rund 37 Prozent direkter Rohmarge genügend Abstand zur vereinbarten Obergrenze. | Klein bis mittel. Versionierter Katalog-, Self-Service-, Checkout-, Test-, Doku-, Visual- und Staging-Sync-Nachzug ohne Schema-, Basisplan- oder Production-Änderung. Technische Codes bleiben stabil. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, alle Speicherpreise auf schönere `,99`-Endungen zu stellen und den billigen `1,99`-Preisanker zu vermeiden. | 2026-08-03 |
| CR-025 | 2026-08-03 | Raffael / Produktteam | `BILL-08`, `BILL-22`, `BILL-24`, Speicher-Upsell, Download-Telemetrie und Lago-Katalog | Neu buchbare Speicherpakete kosten 6,99 EUR für 500 GB, 12,99 EUR für 1 TB und 60,99 EUR für 5 TB netto pro Monat. Die Kalkulation verwendet die tatsächlich als 1024³ Bytes je GB gewährte Quota gegen Hetzners dezimale TB und trägt konservativ fünf vollständig kostenpflichtige externe Auslieferungen der gebuchten Paketkapazität bei 1 EUR/TB Mehrtraffic. Nur die kleinste wertige ,99-Stufe liegt ohne Egress mit 51,9 Prozent knapp über der angestrebten direkten 50-Prozent-Marge; 5,99 EUR wäre bei 5× Egress bereits negativ. Der accountweite Hetzner-Freibetrag bleibt Plattformpuffer und wird keinem Workspace versprochen. HiveGrid trennt Provider-Istkosten, aggregierte autorisierte Downloadbytes und die nur näherungsweise Workspace-bezogene Signed-URL-Nutzung; es entsteht kein Traffic-Overage-Billing. | Die bisherige Kalkulation vermischte binäre HiveGrid-Quota mit dezimalen Provider-TB und war dadurch nach fünf vollständigen Auslieferungen leicht negativ. Für den Piloten soll normaler Dokumenten-/Fotodownload ohne variable Nachberechnung wirtschaftlich bleiben, während öffentliche Links, Hotlinking und ungewöhnliche Transfermuster früh sichtbar werden. | Mittel. Versionierter Katalog-/Lago-Nachzug, automatisierte Egress-Kalkulation, niedrig-kardinale Download-Telemetrie, Betriebsvertrag sowie erneuter Registrierungs-/Mollie-TEST-/Invoice-/Add-on-UAT. Keine Schemaänderung, kein Download-Proxy, keine neue CDN-/Serverinfrastruktur und keine echte Production-Zahlung. Production-Katalog erst nach grünem Staging-Proof; Billing-Side-Effects bleiben bis `BILL-08` geschlossen. | Genehmigt durch den ausdrücklichen User-Auftrag im Chat, die Preise minimal für vier bis fünf vollständige Egress-Zyklen anzuheben, Storage-Traffic sauber beobachtbar zu machen und den kompletten Billing-/Registrierungsflow erneut bis Staging und kontrolliertem Production-Katalog zu prüfen. | 2026-08-03 |
## Verbindliche Auslegung zu CR-006
- Automatischer KWP-Sync darf nicht vom Freigabestatus des generischen Dateiimports abhängen. KWP-Projekt-,
Katalog-, Contract- und Archivjobs laufen deshalb über die eigene Queue `hivegrid.kwp-imports`, die der
bestehende `worker-import` in jedem gültigen Runtime-Modus konsumiert.
- Die generische Queue `hivegrid.imports` bleibt unverändert hinter
`IMPORT_QUEUE_ENABLED=true` plus `IMPORT_QUEUE_RUNTIME_READY=true`. Der schmale
`PORTAL_GDPR_EXPORT_QUEUE_ENABLED=true`-Modus konsumiert KWP plus `hivegrid.exports`, aber weiterhin
keine generischen Dateiimporte.
- Bereits vor dieser Trennung auf `hivegrid.imports` persistierte KWP-Jobs bleiben replay-fähig. Neue
typisierte KWP-Producer können ausschließlich die dedizierte Queue adressieren.
## Verbindliche Auslegung zu CR-013
- Ein Fehler in Termine, Aufgaben oder Material darf erfolgreiche Bereiche nicht verwerfen. Nur Bindings
eines erfolgreich gelesenen Bereichs dürfen in diesem Lauf als fehlend markiert werden.
- Das Archiv ist keine Voraussetzung für den Abschluss des Kernlaufs. Sein Queue-Cursor enthält nur
numerische Ordner-IDs, ist auf 1.000 eindeutige Ordner begrenzt und bleibt über Worker-Restarts replaybar.
- Der 15-Minuten-Takt des Kernlaufs bleibt bestehen. Archiv-Discovery und erneute Dateiexporte sind über
einen sechs Stunden breiten Idempotenz-Bucket entkoppelt; innerhalb dieses Buckets erhält ein Dateijob
höchstens drei Versuche mit exponentiellem 60-Sekunden-Backoff.
- `provider_outage`, Rate-Limit- und vergleichbare temporäre Dateifehler sind retrybar und ändern den
Connection-Status nicht. Vertragsdrift, fehlende Berechtigung, pausierte Capability, ungültige lokale
Credentials, nicht mehr vorhandene Ressourcen und feste Importgrenzen werden im Job nicht sinnlos
wiederholt; der nächste reguläre Lauf bleibt davon unberührt.
- Keine neue Mutation-Operation, kein Writeback und keine Änderung am OAuth-/Refresh-Vertrag. Ein echter
Authentifizierungsfehler darf weiterhin den vorhandenen Connection-Health-Pfad auslösen.
## Verbindliche Auslegung zu CR-001
- Die Custom-Domain gilt nur für das Customer-Portal. Sie ist kein vollständiges App-White-Label für
`app.hivegrid.de` und ändert den Enterprise-only-Scope des allgemeinen White-Label-Pakets nicht.
- Die Einmalgebühr umfasst die erste DNS-/TLS-Einrichtung eines exakten Hostnamens. Apex-Domains,
Wildcards und mehrere parallele Portal-Domains sind nicht enthalten.
- Business enthält das Portal, aber keine Domain; die Einrichtung kostet dort wie bei Starter/Team
299,99 EUR netto. Enterprise enthält Portal und eine Domain als vertraglichen Override.
- Entfernte oder gewechselte Hostnamen bleiben 30 Tage gegen eine Übernahme durch einen anderen Workspace
gesperrt. Der Standardhost bleibt währenddessen erreichbar.
- Eine aktive HiveGrid-Subscription und ein aktives Portal-Entitlement sind Voraussetzung. Fällt das
Portal-Entitlement weg, wird auch die Custom-Domain deaktiviert.
- Die Endkunden-Surface läuft im separaten Coolify-Service/Container `hivegrid-portal`, zunächst aus
demselben unveränderlichen Web-Image. Eigene Runtime-Grenzen und der minimal berechtigte DB-Login
`hivegrid_portal` gehören zu `VA-P26a`; der Domain-Controller aus `VA-P26c` routet nur auf diesen Service.
- Technischer Vertrag und Sicherheitsgrenzen stehen in `AGENTS.md` §Architektur-Baseline,
dieser CR-001-Auslegung und `docs/INTEGRATION-CONTRACTS.md` §3/§14; AD-30 bleibt die
rückverfolgbare Entscheidungs-ID.
## Verbindliche Auslegung zu CR-003
- „Read-only“ bezeichnet die fachliche Richtung der initialen KWP-Integration: KWP → HiveGrid. OAuth-Code-
Austausch, automatische Refresh-Token-Rotation, Connection-Health und andere notwendige
Verbindungs-Lifecycle-Operationen sind keine fachlichen KWP-Mutationen.
- HiveGrid sendet im aktuellen Scope keine Create-, Update-, Delete-, Import- oder sonstigen fachlichen
Schreibrequests an KWP. Das gilt auch für vorhandene Termin-, Aufgaben- oder Archiv-Schreiboperationen.
- M091, `kwp.push_auftrag`, Project-/Auftrag-Create sowie M094-outbound und M074-outbound bleiben als
verpflichtender, aber geparkter Writeback-Nachzug erhalten. Sie sind keine DoD-Voraussetzung des
initialen read-only Scopes.
- `VEXT-6` hält den externen Write-Vertrag nach. Erst dessen belastbarer Abschluss plus eine erneute
ausdrückliche Produktfreigabe erlauben das Schneiden eines Dev-Tickets; bis dahin wird kein spekulativer
Write-Adapter gebaut.
- KWP bleibt v2-P5/Phase 32. CR-003 verschiebt KWP nicht nach v1 und ändert nicht die historische
v1/v2-Scope-Schnitt-Entscheidung.
## Verbindliche Auslegung zu CR-004
- Der gemeinsame PR hebt die fachliche Dependency nicht auf: `VR-P32b` wird intern vollständig vor
`VR-P32d` umgesetzt und verifiziert. `VR-P32d` bleibt bis dahin formal blockiert.
- Es gibt keinen behaupteten KWP-Vollimport. `POST /api/Projekt/Search` benötigt einen Suchbegriff mit
mindestens zwei Zeichen; ausgewählte Treffer werden über die freigegebenen Detailoperationen geladen.
- `AppEntityBinding` ist die dauerhafte providerneutrale External↔Local-Zuordnung. `AppSyncItem` bleibt die
Historie eines einzelnen Laufs und ist allein kein dauerhaftes Mapping.
- KWP-eigene Projektfelder sind Projektname, KWP-Status mit daraus abgeleiteter Pipeline/Stage, Beginn,
Auftragswert, externe KWP-Projektnummer sowie gebundene KWP-Adressen und ausgewählte KWP-Kontaktdaten.
Lokale Beschreibung, Priorität, Deadline, Mitglieder, Checklisten, Portalzugänge, Tasks, Notizen und Custom
Fields bleiben lokal editierbar.
- Projekt-, Rechnungs- und Bauherradresse werden je Rolle explizit mit einem vorhandenen CRM-Kontakt verbunden
oder bewusst neu angelegt. Es gibt kein automatisches Fuzzy-Merge und keine ungefragte Massenübernahme von
Ansprechpartnern. Architektenadressen und weitere KWP-Ansprechpartner bleiben außerhalb dieses Slices.
- IBAN, Bank, Kreditlimit, Steuerdaten, Geburtstag, interne KWP-Hinweise und Benutzerfelder werden weder in
typisierten Tabellen noch in Roh-Snapshots gespeichert.
- Der Erstimport schreibt Search, Audit und Activity, veröffentlicht aber kein Workflow-Event. Nur spätere
KWP-Stage-Änderungen veröffentlichen `project.stage_changed` mit `source=kwp`.
- Trennen stoppt den Sync und entfernt das Binding, behält aber Projekt und CRM-Daten lokal. Ein expliziter
Restore trennt zuerst atomar, stellt danach den vor der KWP-Überschreibung gesicherten lokalen Stand wieder
her und protokolliert Audit sowie Activity.
- Der kontrollierte Live-Geerkens-E2E bleibt ausschließlich in `VN-2` und blockiert den Merge dieses
fixture-validierten Implementierungs-PRs nicht.
## Verbindliche Auslegung zu CR-005
- „Vollständig“ bedeutet den aktuellen, durch die fünf angeforderten OAuth-Scopes
`adresse-extern`, `archiv-extern`, `termin-extern`, `vorgang-extern` und `aktivitaet-extern`
erreichbaren Vertrag. Die übrigen 441 OpenAPI-Operationen werden inventarisiert, aber nicht als
ausführbare HiveGrid-Capability ausgegeben.
- Jede der 113 Scoped-Operationen besitzt eine feste Kombination aus ID, HTTP-Methode, Pfad, Capability,
Modus und Request-/Response-Schema. Fachcode darf weder freie KWP-Pfade noch URL, Token, Mandant oder
rohe Credentials übergeben.
- „Read“ wird semantisch klassifiziert. Deshalb dürfen auch nachweislich lesende `POST`-Operationen wie
`Search`, `Load`, `Count`, `Get` und `Check` in der Read-Allowlist stehen. `Save`, `Add`, `Delete`,
`Remove`, `Import`, `Publish` und `Reset` bleiben unabhängig von ihrer HTTP-Methode Mutation.
- Ein Mutation-Contract ist kein freigegebener Writeback. Die Runtime muss die 36 Operationen vor
Budgetverbrauch, Relay-Auflösung und HTTP blockieren. Es entstehen kein Mutation-Export für Web/Worker,
keine Automation-Action, keine Push-Queue und keine UI-Aktion.
- Responses werden vor Domain-Mapping gegen den eingecheckten Scoped-Vertrag validiert. Der tägliche
Sentinel vergleicht semantisch pro Capability nur konsumierte Operationen und ihre rekursiv referenzierten
Schemas; Drift in einem Bereich pausiert nicht automatisch alle anderen Bereiche.
- Live-Tests auf Staging bleiben read-only, secretsicher und selektiv. Sie dürfen weder einen
unbestätigten Realprojektimport noch eine KWP-Mutation auslösen. Der kontrollierte fachliche Importbeweis
bleibt in `VN-2`.
- `VEXT-6` bleibt das Gate für ausführbaren Writeback und Project-/Auftrag-Create. CR-005 erfüllt keinen
seiner vier externen DoD-Punkte und deutet `/api/Projekt/Save` nicht als Create um.
## Verbindliche Auslegung zu CR-006
- Automatisch synchronisiert wird der im bestätigten Mandanten durch
`GET /api/Projektampel/LoadProjekteNachFilter` sichtbare Platzhalterbestand. Da KWP weder Cursor noch
Pagination und laut Hersteller keinen Delta-Filter liefert, bleibt die Aussage bewusst auf diesen
einstellungsabhängigen Bestand begrenzt. HiveGrid behauptet keinen darüber hinausgehenden Vollabzug.
- Der Discovery-Call speichert zunächst ausschließlich erlaubte Projektnummern. Details werden asynchron in
kleinen, lease- und replay-sicheren Batches angereichert. 50.000 Einträge dürfen weder eine lange
DB-Transaktion noch eine synchrone 50.000-Request-Schleife erzeugen.
- Jede gezielte Live-Suche ist zugleich read-through: schema-valide Treffer werden idempotent in den
Katalog geschrieben und stehen danach auch bei einer vorübergehenden KWP-Störung für die Suche zur
Verfügung. Ein Live-Fehler darf vorhandene Cache-Treffer nicht vernichten.
- Der Katalog enthält nur die bereits freigegebenen KWP-Projektfelder. Rohpayloads sowie IBAN, Bank,
Kreditlimit, Steuerdaten, Geburtstag, interne Hinweise und Benutzerfelder werden weiterhin nicht
gespeichert.
- Der komplette Scoped-Adapter aus CR-005 bleibt für generische Operationen vollvertraglich validiert. Der
fachliche Projektimport verwendet zusätzlich eine engere Zod-Projektion: Nur ein Typfehler in einem
konsumierten Feld gilt dort als Response-Drift. Abweichungen in ungenutzten Feldern bleiben redigiert und
ohne Capability-Pause.
- Auto-Recovery ist nur bei identischem genehmigtem und beobachtetem semantischem Fingerprint sowie
erfolgreicher aktueller Projektion erlaubt. Echte OpenAPI-Drift, konsumierte Typfehler und fehlende
Providerrechte bleiben pausiert.
**Produktgrenzen:** `AGENTS.md` §Produktgrenzen / Anti-Liste bleibt verbindlich. Dieser CR führt keine
zusätzliche Ausnahme ein.