Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/docs/audits/PILOT-READINESS-2026-07-29.md
T

16 KiB

Pilot-Readiness-Audit — 29.07.2026

Kurzurteil

Der Pilot-Pfad ist nach diesem Lauf deutlich sicherer, konsistenter und besser prüfbar. Die gefundenen, risikoarm behebbaren Code-Risiken wurden nicht nur dokumentiert, sondern in 66 atomaren Code-Commits behoben. Damit ist trotz zusätzlicher Guards und Tests netto Code entfallen.

Ein blindes „alles launch-ready“ wäre dennoch falsch. Der produktionsnahe Lauf mit erzwungenem RLS hat einen echten Blocker im alten Workflow-Engine-Modul sichtbar gemacht: direkte Prisma-Zugriffe laufen ohne gebundenen Tenant-RLS-Kontext und sehen unter hivegrid_app die Readiness-Workflows nicht. Ist die Workflow Engine Teil des Piloten, muss das vor Launch typisiert und transaktional behoben werden. Ist sie nicht Pilot-Scope, muss sie für Pilot-Tenants explizit deaktiviert bleiben. Zusätzlich ist die operative Ticket-Wahrheit zwischen Plane, Ticket-Docs und alter Milestone-Planung auseinandergelaufen. Externe Staging-/Produktionsdienste wurden bewusst weder belastet noch mutiert.

Lauf und Grenzen

  • Laufzeitfenster: 29.07.2026, 13:17:18 bis 21:17:18 CEST
  • Basis: frisches origin/main bei 27fbea94e94ac9bbc7ddc157e23c2d4924d12829
  • Branch: audit/pilot-readiness-20260729
  • isolierter Worktree: /Users/raffaelsheikh/Documents/GitHub/HiveGrid-Cloud-pilot-readiness-20260729
  • kein Push, Deploy, Plane-Schreibzugriff oder Eingriff in echte Server
  • lokale Einweg-Infrastruktur: PostgreSQL unter erzwungenem RLS mit der eingeschränkten Rolle hivegrid_app, Redis und Web-Runtime
  • vollständiger dateibasierter Inventar-/Static-Scan; manuelle Tiefenprüfung fokussierte anschließend die Pilot-Flows, Authentifizierung, Uploads, Berechtigungen, RLS, Kryptografie, Worker, Deployment und Hot Paths

Inventar zum Prüfzeitpunkt:

  • 7.967 Repository-Dateien
  • 6.269 TypeScript-/TSX-Dateien
  • 814 Web-Routen, davon 141 API-Routen
  • 305 Worker-Dateien
  • 60 Prisma-Schema-Dateien
  • 205 Ticket-Docs
  • 170 tatsächlich vorhandene Milestone-Verzeichnisse

Was behoben wurde

Sicherheit

  • Chunked Uploads erzwingen jetzt CSRF, prüfen Chunk-Integrität und akzeptieren keine ungebundenen Teilstücke.
  • Portal-Uploads sind während des Streamings begrenzt; unnötige Base64-/Buffer-Kopien wurden entfernt.
  • Aircall-Aufzeichnungsdownloads sind auf den erwarteten Anbieter-Host gepinnt.
  • Offene TOTP-Einschreibungen laufen ab.
  • Der Tenant-DEK-Cache ist begrenzt und verworfene Schlüssel werden überschrieben.
  • Interne Feedback-Servicefehler werden nicht mehr an Benutzer ausgegeben.
  • Runtime-Ressourcen müssen explizite CPU-/Memory-Hardcaps besitzen.
  • Verwundbare tar- und Valibot-Transitivabhängigkeiten wurden gepatcht.
  • Der Produktion-Audit meldet nur noch den geprüften, nicht anwendbaren React Router RSC-Hinweis; HiveGrid aktiviert den betroffenen RSC-Pfad nicht.

Performance und Ressourcennutzung

  • Dashboard-Charts werden wieder als Lazy-Chunk geladen; der Chart-Chunk liegt bei rund 5,1 KB statt im initialen Bundle.
  • Feature-Flag-Rollouts haben eine begrenzte Tenant-Fan-out-Größe.
  • Worker-Vorschauen und Portal-Uploads vermeiden große Buffer-Kopien.
  • Eine redundante Datenbank-Statusabfrage im Migrationspfad ist entfallen.
  • Der Tenant-Schlüsselcache besitzt eine harte Obergrenze.

Toter und irreführender Code

  • ungenutzter Chart-Wrapper entfernt
  • tote TOTP-Platzhalterroute entfernt
  • pensionierte AI-Upload- und Completion-Clients/-Routen entfernt
  • veraltete Route- und Readiness-Verweise auf die entfernten Flächen bereinigt
  • keine verbotenen US-Provider-Imports gefunden

Pilot-Flows und Bedienbarkeit

  • Ein echter Routing-Konflikt bei /select-tenant wurde behoben: Die Admin-Host-Aliasroute überschattete zuvor den App-Flow und konnte Benutzer nach erfolgreichem Login wieder auf die Anmeldung schicken.
  • Auth-/Recovery-Flows bleiben auf dem richtigen Host und zeigen aktuelle Passwortanforderungen sowie semantisch zugeordnete Fehler.
  • Mobile Sidebar und Accordion verhalten sich jetzt semantisch und schließen nach Navigation.
  • Form-, Menü-, Switch-, Select-, Profil- und Dialog-Controls erhielten zugängliche Namen; mehrere Kontrastfehler wurden behoben.
  • Der A11y-Coverage-Gate prüft wieder die aktuellen Billing-, API-Key-, Audit-, Profil- und Readiness-Smokes statt pensionierter UI-IDs und Flow-Namen.
  • Einstellungen, Compliance, Billing, API-Keys, Plugins, Privacy und Notifications verlinken wieder auf die kanonischen Routen.
  • Ein Projektboard ohne Pipeline mutiert nicht länger während eines GETs, sondern zeigt den vorhandenen Empty-State. Die Readiness-Fixture erzeugt die benötigte Pipeline deterministisch.
  • Profil-Mutationen lesen den angemeldeten Benutzer jetzt im gebundenen User-/Tenant-RLS-Kontext statt über einen kontextlosen Prisma-Zugriff.
  • Form-Builder-Liste, Detail, Exporte und Mutationen laufen vollständig im authentifizierten RLS-Kontext.
  • Der Plugin-Capability-Audit bindet Plugin- und Audit-Reads an denselben nachgewiesenen Tenant-/User-Kontext.
  • Onboarding-, Billing- und Operator-Fixtures bilden die aktuellen Produktionsverträge ab und schlagen bei fehlenden Voraussetzungen geschlossen fehl.

Verifikation

Prüffeld Ergebnis
TypeScript final grün
ESLint, keine Warnungen final grün
Core-Unit-/Komponententests final grün; 1.144 Dateien, 7.914 grün, 60 erwartete Skips
Erzwungene RLS-Verträge 372/372 Modelle grün
Release-Readiness 253 Modelle und 25 Artefakte grün
Frische Datenbank 17 Migrationen aus leerer DB, Status sauber
Route-/Sidebar-/Source-Health-Gates grün
Production-Build grün
Bundle-Budget Initial-Payload, Kompression, Lazy-Runtime, Gesamtgröße und alle Einzelrouten grün; zwei bereits auf main rote Rohsummen bleiben offen
Runtime-Closures grün nach vollständigem Build
Produktionsabhängigkeiten keine anwendbare High-/Critical-Lücke
Chromium-E2E, vollständiger RLS-Lauf 185 grün, 43 erwartete Skips, 31 rot; davon 23 gebündelt auf die Workflow Engine
Auth-/Account-Production-Smoke 20 grün, 4 explizit umgebungsabhängig übersprungen
Production-Service-Worker 2/2 grün
Kritischer Workflow-RLS-Recheck 7/7 reproduzierbar rot; Redirect zum Dashboard nach DB-Fehler
lokaler Production-HTTP-Lasttest /healthz: 5.000/5.000 bei c=100, 0 Fehler, 10.946,52 req/s, p95 17 ms, p99 29 ms; /login: 1.000/1.000 bei c=50, 0 Fehler, 304,31 req/s, p95 174 ms, p99 195 ms

Die produktionsgebundenen Service-Worker-Tests erkennen nun korrekt die Vite-Dev-Runtime und werden dort bewusst übersprungen. Sie müssen gegen den gebauten Stand laufen; der anschließende lokale Production-Runtime-Lauf hat beide Tests grün bestätigt.

Der Bundle-Gate-Vergleich wurde zusätzlich in einem separaten Worktree direkt gegen den unveränderten Basis-Commit gebaut. Bereits main überschreitet manifest_js um 0,4 % und application_js um 5,7 %. Der Audit-Branch reduziert gegenüber dieser Basis die rohe Anwendungssumme um 4.813 Bytes, CSS um 2.283 Bytes sowie den initialen Gzip-/Brotli-Payload um 85/70 Bytes; das Manifest wächst um 598 Bytes. Budgets wurden bewusst nicht aufgeweicht. Die zwei roten Rohsummen sind somit ein vorbestehender CI-/Budget-Nachzug, keine neu eingeführte Gesamtgrößenregression.

Validierte User-Flows

Mit realer lokaler PostgreSQL-Datenbank, eingeschränkter App-Rolle, erzwungenem RLS und anschließend auch dem gebauten Production-Server wurden unter anderem folgende Pfade ausgeführt:

  • Passwort-Login, Recovery und Registrierungsfehler
  • Tenant-Auswahl und Single-Tenant-Einstieg
  • Admin-Login/Host-Isolation und Operator-Dashboard
  • Dashboard und mobile Hauptnavigation
  • Profil, Passwortdialog, MFA-Einstieg und Sessions
  • Billing, Abo-Übersicht, Rechnungen und Onboarding
  • Notification-Center und Notification-Einstellungen
  • API-Key-Einstellungen und Anlagevertrag ohne persistierende Mutation
  • Workspace-Governance und Compliance
  • Plugin-Katalog, Detail, Lifecycle und Audit
  • Privacy-Hub und leere Privacy-Teilflächen
  • Lead-Anlage
  • Projektboard einschließlich fehlender Pipeline
  • Production-Service-Worker einschließlich kontrollierter Übernahme

Der komplette Chromium-Lauf ergab 185 grüne Tests, 43 explizite Skips und 31 Fehler. Zwei UI-Vertragsdrifts in Workspace-Governance und dem neuen Office-/Field-Seat-Billing wurden anschließend korrigiert und gezielt grün verifiziert. Vier serielle Auth-Fehler waren im isolierten Production-Recheck nicht reproduzierbar: dort liefen 20 Auth-/Account-Tests grün, vier umgebungsabhängige Mutationsfälle wurden korrekt übersprungen. Zwei alte Admin-Tests erwarten zwingend die Login-Seite und sind deshalb mit einem vor-authentifizierten Admin-State nicht kompatibel; der native Platform-Lead-Flow selbst lief mit diesem State unter hivegrid_app grün.

Die verbleibende belastbare Fehlergruppe ist die Workflow Engine. 23 Tests des Gesamtlaufs und alle sieben gezielten Production-Rechecks wurden zum Dashboard umgeleitet. Parallel protokollierte die Runtime workflow.findFirstOrThrow-Datenbankfehler. Die Legacy-DB-Layer unter apps/web/app/modules/workflowEngine/** verwenden direkte db.workflow*- Aufrufe, ohne runWithRlsContext() oder withTenantRLS(). Lokal mit RLS_RUNTIME_MODE=off bleibt dieser Fehler unsichtbar; genau deshalb ist er launchrelevant. Die statische Inventur zählt 70 direkte Zugriffsstellen in elf Produktionsdateien und keinen RLS-Wrapper innerhalb des Moduls. Die drei internen Trigger-/Execution-Endpunkte binden den RLS-Kontext bereits; der Bruch liegt im nachgelagerten Legacy-Modul. Ein eiliger Teil-Fix wäre riskant, weil Reads, Mutationen, Blocks, Variablen, Credentials und Executions gemeinsam transaktional nachgezogen werden müssen.

Eine abschließende Direktzugriffs-Heuristik über alle Route-Dateien zeigt nach den Profil-, Form- und Plugin-Korrekturen keinen tenant-seitigen App-Route-Read mehr, der db direkt importiert, aber keinen RLS-Kontext/-Scope referenziert. Die verbleibenden Treffer sind Admin-/Operator- und Health-Routen; deren separate Identitätsgrenzen wurden in den zugehörigen Runtime-Smokes geprüft.

Bewusst nicht als lokal bewiesen gelten echte Mailjet-/Mollie-/Aircall- und Coolify-Endpunkte sowie Provider-Webhooks. Sie wurden weder gefälscht als „grün“ ausgegeben noch extern belastet.

Ticket- und Planungsabgleich

Read-only aus Plane:

  • 208 Issues insgesamt
  • 108 offene Issues
  • 72 offene Issues über Zieldatum, 22 ohne Zieldatum
  • 8 explizit blockierte Issues: AK-P19, EXT-13, VA-P23, VR-P22b, VEXT-6, VH-1, VN-1, VN-2
  • Statusverteilung: 83 Done, 17 Cancelled, 61 Backlog, 8 Todo, 15 In Progress, 5 In Review, 11 Ready for Review

Abweichungen:

  • AGENTS.md nennt noch 157 Ticket-Docs; vorhanden sind 205.
  • 13 aktive Tickets mit Working-ID haben keinen Doc-Link; 16 Ticket-Docs haben keine Plane-Working-ID.
  • 21 als Done markierte Ticket-Docs wirken im Dokument noch geplant, in Arbeit oder statuslos.
  • 9 cancelte Tickets wirken in den Docs noch geplant oder statuslos.
  • Von 77 auswertbaren Done-Docs haben 59 vollständige DoD-Häkchen, 13 offene DoD-Punkte und 5 keine maschinenlesbare DoD.
  • AK-P14b steht in Plane auf Done, die Doc weist 6/7 DoD, also rund 86 %, aus.
  • 17 Done-Docs besitzen keine Umsetzungsnotiz.
  • 46 Docs markieren einen Design-Nachzug, aber Plane hat 39 entsprechende Labels; 8 sind nur in der Doc markiert, R-P12b nur in Plane.
  • Alle 41 aktiven Screen-Tickets sind noch nicht Done.
  • R-UX1 ist aktiv, besitzt aber keine Ticket-Doc.
  • R-P13 steht in Plane auf Done, obwohl AD-26 den v1-KI-Layer gestrichen hat.

Die Dateien damalige Planungsstatusdatei, ROADMAP*.md, REQUIREMENTS.md und SPRINT-DAYPLAN.md enthalten zusätzlich erkennbaren Zeit-/Status-Drift. Dieser Lauf hat die externen Statusdaten bewusst nicht eigenmächtig umgeschrieben.

Infrastruktur- und Belastungsbefund

  • Deploy-, Runtime-, Non-root-, Secret-, Pin- und Hardcap-Verträge sind statisch grün.
  • Eine leere lokale Datenbank lässt sich vollständig migrieren und mit der eingeschränkten Runtime-Rolle betreiben.
  • RLS wurde nicht durch Mocks „bewiesen“, sondern in der laufenden App mit der Rolle hivegrid_app validiert. Dadurch wurde der Workflow-Engine-Fehler überhaupt erst sichtbar.
  • Die Production-Konfiguration bricht bei fehlenden Pflicht-URLs, Secrets, Storage-Parametern und Revision fail-closed ab.
  • Der lokale Production-Load-Smoke lieferte bei 6.000 Requests und erhöhter Parallelität keinen HTTP-Fehler. Die Werte enthalten weder TLS noch Netzwerk-/Providerlatenz und sind daher nur ein Regressionssignal.
  • Externe Estate-Dienste wurden nicht belastet. Das wäre ohne abgestimmtes Wartungsfenster kein risikoarmer Audit-Schritt.
  • Der lokale HTTP-Lasttest dient nur als Regressionssignal; er ist keine Kapazitätszusage für Hetzner/Coolify.

Bereinigung der alten OQ-/Milestone-Planung

Erledigt am 2026-08-02. Plane ist die operative Status-, Ownership- und Dependency-Quelle; .planning/ticket-docs/<ID>.md ist die ausführbare Bau- und DoD-Quelle. Die drei noch fachlich referenzierten Altverträge wurden vor dem Löschen übernommen: KWP nach .planning/KWP-API-CONTRACT.md, Plattform-Leads nach R-LEADS/VA-P28b und SHK-Provisionierung nach R-CR1/R-P20b.

Prioritäten vor dem Piloten

  1. Workflow Engine vollständig an den RLS-Kontext anbinden und alle 23 betroffenen Smokes grün machen; alternativ die Funktion für Pilot-Tenants nachweislich deaktivieren.
  2. Einen gebauten Staging-Stand unter scharfem RLS einmal durch den Pilot-Smoke und die echten Provider-Callbacks führen.
  3. Die 13 Done-Docs mit offenen DoD-Punkten und die 17 Done-Docs ohne Umsetzungsnotiz fachlich bestätigen oder in Plane zurückstufen.
  4. Die acht blockierten Tickets mit Owner, nächster Aktion und realistischem Termin versehen; die 72 überfälligen offenen Tickets triagieren.
  5. Den Design-Nachzug zwischen Docs und Plane einmalig synchronisieren.
  6. Die alte Milestone-Planung nach obigem Verfahren einfrieren, statt sie als parallele Projektsteuerung weiterzuführen.