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
@@ -6,7 +6,7 @@
|
||||
| **Owner** | Raffael |
|
||||
| **Phase** | P1 — Fundament & Walking-Skeleton |
|
||||
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1 |
|
||||
| **Status** | geplant |
|
||||
| **Status** | Done |
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `R-P1a` (EU-Sterilisation + Contracts)
|
||||
@@ -22,7 +22,7 @@ Kein fachlicher Screen — reine Service-Kerne (Backend). Die Bedien-Oberfläche
|
||||
|
||||
## Definition of Done
|
||||
- [x] `AuditEvent` mit **SHA-256-Hash-Kette** *(vorhanden+getestet; Auto-Audit-Prisma-Middleware bewusst aufgeschoben, manueller `auditEvent`-Pfad ist der unterstützte Weg — s.u.)*
|
||||
- [x] `notify()` Kanal-Abstraktion (In-App / Email; Push-Stub bis v2)
|
||||
- [x] `notify()` Kanal-Abstraktion (In-App / Email; Push-Stub bis v2) *(Regression 14.–17.07. unter FORCE RLS worker-seitig — behoben, s. §Fix-Notiz 2026-07-17)*
|
||||
- [x] `packages/i18n` + `verify:i18n`-CI-Gate (Resolution User→Tenant→DE, Build-Lint Hard-Strings)
|
||||
- [x] `tenantHasFlag()` + `tenantHasModule()`-Muster (Cache; in R-P1c am Skeleton angedockt)
|
||||
- [x] `logActivity()` (polymorph `subject_type/id`, `actor_kind`) + Search-Registry + Subframe-Adapter + Mass-Action-Schutz aufrufbar
|
||||
@@ -36,14 +36,13 @@ Kein fachlicher Screen — reine Service-Kerne (Backend). Die Bedien-Oberfläche
|
||||
## Quellen (granular)
|
||||
- `ENTITY-MODEL.md` → **Domäne 2: Querschnitt** (AuditEntry/Notification/NotificationPreference/Device) + **Cross-Cutting** (Activity, Konnektor via SubscriptionFeature.code)
|
||||
- `REQUIREMENTS.md` → `REQ-audit-datenmodell`, `REQ-notification-datenmodell`, `REQ-i18n-architektur`, `REQ-feature-flags-system`, `REQ-integration-activity-wiring`/`-audit-wiring`/`-notification-wiring`
|
||||
- `ROADMAP.md` → Phase 1 · `PHASE-SOURCES.md` → Phase 1 (M001/M003/M006/M011 + M005/M007)
|
||||
- `ROADMAP.md` → Phase 1 · Milestones: (M001/M003/M006/M011 + M005/M007)
|
||||
- `designer-briefs/P01-fundament-walking-skeleton.md` (Service-Kerne)
|
||||
- `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md`, `M32-feature-flags.md`
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-D0a`/`D-D0b`-Delta)
|
||||
- [ ] Activity-Stream-/Konnektor-Wiring an Davids Komponenten-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] Plane-Ticket `R-P1b` aktualisiert
|
||||
- [ ] REQUIREMENTS/ROADMAP nachgezogen
|
||||
- [x] Plane-Ticket `R-P1b` aktualisiert
|
||||
|
||||
## Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
|
||||
|
||||
@@ -79,3 +78,74 @@ AK-P3 (DoD 2, Diff-Detail-Drawer) hat die im LOCKED `ENTITY-MODEL.md` §Domäne
|
||||
binden (Chain-Format-Versionierung) + flächige Befüllung der Diffs über die Schreibpfade
|
||||
(Auto-Audit-Middleware, siehe „Bewusst aufgeschoben" oben).
|
||||
- Konsumenten-Tests grün (audit-events 12/12, worker persist 11/11 + bootstrap 6/6, outbox-e2e).
|
||||
|
||||
## Abschluss-Notiz (2026-07-09, Raffael)
|
||||
|
||||
**DoD-Stand:** 5/5 DoD = 100 % done.
|
||||
|
||||
**Proof:** Die Querschnittsdienste sind laut Umsetzungsnotiz gebaut und verifiziert: Konnektor 6/6, Web-Typecheck grün, `verify:i18n` grün und volle Suite grün. Dieses Ticket ist screen-frei; spätere Activity-/Komponenten-Nachzüge aus David-Designs sind kein Done-Blocker.
|
||||
|
||||
**Plane:** Ticket `HIVEGRID-17` auf `Done` verschoben.
|
||||
|
||||
## Regressions-Befund 2026-07-16 · notify() unter FORCE RLS (aus AK-P4-Audit, Akeshan)
|
||||
|
||||
Beim Staging-Live-Check zu AK-P4b (16.07., `demo-pro-crm`) hat der Task-Reminder-Sweep **keine**
|
||||
In-App-Benachrichtigung mehr zugestellt, obwohl das `before`-Fenster offen war und sicher ≥1
|
||||
Stunden-Sweep gelaufen ist (Benachrichtigungszentrale leer).
|
||||
|
||||
**Ursache (Code-gelesen, auf Staging noch nicht log-verifiziert):** `notify()`
|
||||
(`packages/foundation/src/notifications.ts`) macht einen rohen `notificationDelivery.upsert`
|
||||
mit dem übergebenen Client und bindet **keinen** Tenant-Kontext; die Worker-Aufrufer (z.B.
|
||||
`runTaskReminderSweepHandler` in `apps/worker/src/handlers.ts`) rufen es bewusst **außerhalb**
|
||||
von `withTenantRLS()` auf („own RLS story"-Kommentar). Seit dem app-weiten RLS-Cutover
|
||||
`20260713190000_appwide_rls_cutover` (R-P2b, scharf seit 14.07.) steht `NotificationDelivery`
|
||||
auf FORCE RLS → der Upsert scheitert an der Policy, der Handler fängt und loggt nur
|
||||
(`tasks.reminder.notify-failed`), Zustellung entfällt still. **Betroffen ist mutmaßlich jeder
|
||||
worker-seitige `notify()`-Aufruf**, nicht nur Tasks-Reminder; web-seitige Aufrufer mit
|
||||
Request-RLS-Kontext sind unauffällig.
|
||||
|
||||
**To-do (Owner R-P1b/Raffael, mit R-P2b abzustimmen):**
|
||||
- Staging-Worker-Logs auf `notify-failed`-Einträge prüfen (Nachweis).
|
||||
- Fix: `notify()` kontext-bindend machen (Tenant-GUC setzen, analog `withTenantRLS`) **oder**
|
||||
alle Worker-Aufrufer in den Tenant-RLS-Kontext wrappen; Regressions-Test analog
|
||||
`rls-task-isolation.integration.test.ts` (notify-Write unter FORCE RLS).
|
||||
- Diagnose-Fixture liegt bereit: Staging-Task `cmrnw4rbp000101s1cxglkb3d`
|
||||
(„AK-P4-Audit Testaufgabe", Fälligkeit 17.07.) — nach dem Fix löschen.
|
||||
|
||||
Querverweise: Befund-Ursprung `.planning/ticket-docs/AK-P4b.md` (Notiz 16.07. Abend) ·
|
||||
Cutover `R-P2b`.
|
||||
|
||||
## Fix-Notiz 2026-07-17 · notify()-RLS-Regression behoben (Akeshan, aus R-P1a/b/c-Stand-Audit)
|
||||
|
||||
**Audit-Befund (17.07.):** DoD-Punkt 2 war real nur teilweise erfüllt (worker-seitig stille
|
||||
Zustell-Ausfälle, s. Regressions-Befund oben) → korrigierter Stand vor dem Fix: 4/5 DoD = ~80 %.
|
||||
|
||||
**Fix (Branch `fix/r-p1b-notify-rls-context`):** Der Worker-Default-Client ist bereits der
|
||||
RLS-Proxy aus `@hivegrid/db` (`createRlsScopedClient`), der den Tenant-GUC transaktionslokal
|
||||
bindet, sobald ein `runWithRlsContext`-Kontext aktiv ist — genau das Muster, das
|
||||
`apps/worker/src/jobs/portal-lifecycle-bootstrap.ts` schon korrekt nutzt. Deshalb wurde **nicht**
|
||||
`packages/foundation/notifications.ts` umgebaut (bleibt pure, kein Prisma-Import), sondern:
|
||||
- Neu: `apps/worker/src/notify-rls.ts` → `notifyWithTenantRlsContext(input, client)` wrappt den
|
||||
`notify()`-Write in `runWithRlsContext({ tenantId: input.tenantId }, …)`.
|
||||
- Alle 4 kranken Call-Sites in `apps/worker/src/handlers.ts` umgestellt (Task-Reminder-Sweep,
|
||||
HR-Upload-Reminder-Dispatch + -Eskalation, Email-Domain-Probe); die irreführenden
|
||||
„own RLS story"-Kommentare korrigiert. `portal-status-mail-store` (übergibt tx aus
|
||||
`withTenantRLS`) und `portal-lifecycle-bootstrap` (bereits `runWithRlsContext`) waren gesund.
|
||||
- Regressionstest `apps/worker/src/notify-rls.test.ts`: bildet die FORCE-RLS-Policy
|
||||
(`hg_NotificationDelivery_insert` WITH CHECK) im Fake-Client nach (AGENTS.md §RLS — Mock ohne
|
||||
Policy beweist nichts); erster Test dokumentiert den Bug (plain `notify()` ohne Kontext → Reject).
|
||||
|
||||
**Proof:** `notify-rls.test.ts` 4/4 + `rls-context.test.ts` 3/3 + `handlers.test.ts` 110/110 grün ·
|
||||
Worker- + Foundation-Typecheck grün · ESLint grün.
|
||||
|
||||
**Offen (Staging-Nachweis, nach Merge+Deploy):** Worker-Logs auf ausbleibende
|
||||
`tasks.reminder.notify-failed` prüfen; Diagnose-Fixture `cmrnw4rbp000101s1cxglkb3d`
|
||||
(Tenant `demo-pro-crm`) löschen, sobald die In-App-Notification zugestellt wurde.
|
||||
|
||||
**Drift-Korrektur (Stand main, 17.07.):** Der in Plane am 15.07. gemeldete Audit-Diff-Nachzug
|
||||
(`computeAuditFieldDiff`, Restarbeiten-Wave 2a) ist **nicht auf `main`**; der Branch
|
||||
`feat/restarbeiten-initiative` wurde verworfen. Die beiden Design-Entscheidungen
|
||||
(Default-on-Middleware-Wiring, v3-Chain-Format) liegen weiter bei Raffael; DoD-Punkt 1 bleibt in
|
||||
seiner abgeschwächten Fassung (expliziter `auditEvent`-Pfad) erfüllt.
|
||||
|
||||
**Stand nach Fix-Merge:** wieder 5/5 DoD = 100 % done (Staging-Nachweis als offener Nachzug oben).
|
||||
Reference in new issue
Block a user