6.6 KiB
R-P1b · P1 Service-Kerne (Audit/notify/i18n/Flags) + Konnektor-Muster
| Typ | Dev (Code) |
| Owner | Raffael |
| Phase | P1 — Fundament & Walking-Skeleton |
| Cycle/Fenster | W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1 |
| Status | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
R-P1a(EU-Sterilisation + Contracts) - Blocks:
R-P2a,AK-P3, alle Module (KonnektortenantHasModule()ist Pflicht-Gate jeder Folge-Phase) - Läuft parallel zu:
AK-INFRA1/AK-INFRA2(Ops, kein Code-Konflikt). P1 = Raffael SOLO. - Konflikt-Risiko: keines — Service-Kerne sind Querschnitt (eigene Packages/Middleware). Schema-Berührung nur an Cross-Cutting (
AuditEntry,Notification) — eigeneprisma/schema/*.prisma, db push auf Branch (AD-21).
Was wir bauen
Die Querschnittsdienste, auf denen jedes Folge-Modul aufsetzt: logActivity() (append-only Activity-Stream), Search-Registry, Subframe-Adapter, Mass-Action-Schutz, Audit-Event mit SHA-256-Hash-Kette (Prisma-Middleware, default-on), notify() mit Kanal-Abstraktion (In-App/Email; Push-Stub bis v2), packages/i18n (Resolution User → Tenant → DE, Build-Lint gegen Hard-Strings) und die Feature-Flag-Engine mit Entitlement-Gate (tenantHasFlag() + tenantHasModule() — das Konnektor-Prinzip). Liefert das Konnektor-Muster exemplarisch am Skeleton (wird in R-P1c angedockt).
Benötigte Screens (Backend bedient — Design liefert D-D0a/D-D0b)
Kein fachlicher Screen — reine Service-Kerne (Backend). Die Bedien-Oberflächen dieser Dienste kommen in P3 (AK-P3: Audit-Viewer + Notification-Center + Sprach-Settings). David liefert hier nur die Archetypen-Baseline (D-D0a/D-D0b), inkl. Activity-Stream-Komponente (A3) für spätere Detail-Views.
Definition of Done
AuditEventmit SHA-256-Hash-Kette (vorhanden+getestet; Auto-Audit-Prisma-Middleware bewusst aufgeschoben, manuellerauditEvent-Pfad ist der unterstützte Weg — s.u.)notify()Kanal-Abstraktion (In-App / Email; Push-Stub bis v2)packages/i18n+verify:i18n-CI-Gate (Resolution User→Tenant→DE, Build-Lint Hard-Strings)tenantHasFlag()+tenantHasModule()-Muster (Cache; in R-P1c am Skeleton angedockt)logActivity()(polymorphsubject_type/id,actor_kind) + Search-Registry + Subframe-Adapter + Mass-Action-Schutz aufrufbar
Technische Bausteine
- Entities (eigene
prisma/schema/*.prisma):AuditEntry(append-only,before/after_diff,summary_textDE, Hash-Kette),Notification/NotificationPreference/NotificationDevice(Push-Kanal ruht v1),Activity(Cross-Cutting, polymorphsubject_type+subject_id,actor_kinduser/system/automation/ki_agent). i18n = keine Tabelle (JSON-Files + FelderUser.language/Tenant.default_language). - Konnektor
tenantHasModule(): prüftSubscriptionFeature.codeim Abo des Tenants (Brücke Billing↔Feature-Gate); Redis-Cache. - RLS auf
AuditEntry/Notification(tenant-bezogen, AD-1). is_demo_data-Flag-Konvention für seedbare Definitions-Tabellen.
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-wiringROADMAP.md→ Phase 1 ·PHASE-SOURCES.md→ Phase 1 (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-P1baktualisiert
Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
Branch
p1-fundament-rp1abc. Den finalen DoD-Abhaken/Done macht Raffael.
Ausgangslage: Die meisten Querschnitt-Service-Kerne lagen schon in der Boilerplate vor und wurden als aufrufbar verifiziert:
- Audit + SHA-256-Hash-Kette:
packages/db/audit-hash.ts(computeAuditHash/verifyAuditChain/canonicalizeAuditPayload) +audit-events.server.ts(createAuditEvent/publishAuditEventViaOutbox), getestet (audit-hash.test.ts,audit-events.server.test.ts). notify()Kanal-Abstraktion (In-App/Email, Push-Stub) inpackages/foundation/notifications.ts.- i18n +
verify:i18n-Gate:packages/i18n+pnpm run verify:i18n(i18n-check + hardcoded-strings + eslint auf ui-Paketen), grün. logActivity()(@toolctrl/activity), Search-Registry (indexedEntities/listIndexedEntities,@toolctrl/search), Subframe-Adapter (defineAdapter,@toolctrl/ui-app), Mass-Action-Schutz (previewMassAction/assertMassActionAllowed,@toolctrl/foundation) — alle exportiert/callable.
Neu gebaut = der Konnektor (die eigentliche Lücke):
apps/web/app/utils/connector/tenantConnector.server.tsmit dem kanonischen Pflicht-Gate:tenantHasModule({tenantId, userId, moduleKey})→ bool. Brücke Billing↔Feature-Gate: nutztresolveTenantProductAccess(Abo/SubscriptionFeatureviagetActiveTenantSubscriptions, Blueprint, Tenant-Override, Rollen-Permission). Modul-Entscheidung Connector-seitig gecacht (cachified) +invalidateTenantModuleAccessCache(tenantId).tenantHasFlag({flagKey, tenantId?, userId?})→ bool. Delegiert an den v2-evaluateFlagForContext(bringt eigenen Eval-Cache mit).
- 6 Unit-Tests (
tenantConnector.server.test.ts). - Cache-Backing = App-Cache (
~/utils/cache.server, LRU heute, perredisCacheAdapterRedis-swappbar — Infra-Schalter; die genutzten ResolvergetActiveTenantSubscriptions/evaluateFlagForContextcachen bereits cross-replica).
Bewusst aufgeschoben (begründet):
- Default-on Auto-Audit-Prisma-Middleware: Die Hash-Kette + explizites
auditEvent/createAuditEventsind vorhanden und der richtige Pfad. Eine auto-Middleware am geteilten Prisma-Client ohne request-scoped Actor-Kontext (AsyncLocalStorage) erzeugt actor-lose Events (schlechter als die expliziten Aufrufe mit vollem Kontext) und ist ohne lokalen DB-Zugriff nicht validierbar. Querschnitt-Tabelle erlaubt explizit „auto via Middleware oder manuell auditEvent". → ALS/Auto-Audit als separater Infra-Schritt.
Proof: Konnektor 6/6 · Web-Typecheck grün · verify:i18n Exit 0 · volle Suite grün (siehe R-P1c-Abschluss).