Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,273 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user