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
@@ -7,17 +7,25 @@
|
||||
|
||||
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **AI-Credits-Screen + AI-Token-Quota entfallen** (kein LLM-Gateway in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]; `AiCredits`/`AiTokenUsage` gestrichen). Die Verbrauchs-Übersicht bleibt für Automation-Läufe + Speicher. Alle AI-Credits/AI-Token-Stellen unten sind durchgestrichen.
|
||||
|
||||
> 🔄 **Provisionierungs-Recut 2026-07-15 (R-CR1/R-P20b, AD-29):** AK-P20 bleibt abgeschlossen; der
|
||||
> damalige Auto-SHK-Provisionierungs-Slice und seine Proofs zu `provisionShkTenantDefaults()`/
|
||||
> `shkRoles.server.ts` bleiben unten ausschließlich als historische Umsetzung dokumentiert. Aktueller Vertrag
|
||||
> für neue Workspaces ist der zentrale R-P20b-Bootstrap mit fünf editierbaren Tenant-Rollen und ausschließlich
|
||||
> der globalen Rolle `Admin` für den Owner. Bestehende Tenants werden nicht automatisch verändert.
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **Typ** | Dev (Code) |
|
||||
| **Owner** | Akeshan |
|
||||
| **Phase** | P20 — Billing, Onboarding & Branding |
|
||||
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-08 · Gate W4 |
|
||||
| **Status** | Recut / On Hold fuer Billing-Anteil; Onboarding/Branding/Frozen-Vorarbeit verwertbar |
|
||||
| **Status** | Dev-DoD 8/8 = 100 %; Interim-UI nach AD-28; Ready-to-Verify / Done-Freigabe ausstehend |
|
||||
|
||||
**🎨 design-nachzug: offen** (seit 2026-07-12) — Interim-UI aus `~/ui` steht; finale Subframe-Optik aus `D-P20` ausstehend.
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `BILL-00` bis `BILL-05` fuer den neuen Billing-Kern; `AK-P19` fuer Admin-/Tenant-Verwaltungsgrundlagen; `D-P20` fuer finale Screens
|
||||
- **Blocks:** `AK-P21` teilweise (Read-only/Frozen-State und Billing-Cancel-Vertrag), `BILL-06` (Admin-Billing-Basis), spaetere Customer-Billing-Screens
|
||||
- **Blocked by:** keine selbst machbaren Dev-Blocker. `D-P20` ist nach AD-28 nur noch ein nicht blockierender Design-Nachzug.
|
||||
- **Blocks / gelieferte Verträge:** `AK-P21` kann den unveränderten Read-only-/Frozen-/Billing-Cancel-Vertrag konsumieren; die `BILL-06`-Admin-Basis steht bereits. Spätere Customer-Billing-Screens bauen auf den hier stabilisierten VMs/Routen auf.
|
||||
- **Läuft parallel zu:** Raffaels Kern-Kette (Auftrags-/Abnahme-Welt P9). Eigene `prisma/schema/billing.prisma` + Onboarding-Teile (AD-21); `core.prisma` (Tenant) nur über Relation.
|
||||
- **Konflikt-Risiko:** gering — additive Tabellen + Read-Only-Middleware (Frozen) auf der Request-Pipeline (Querschnitt, additiv).
|
||||
|
||||
@@ -26,10 +34,10 @@
|
||||
Drei gebündelte v1-Module:
|
||||
|
||||
1. **Billing-Grundlagen:** lokaler Billing-/Entitlement-State fuer Plans + Seats, Trial/Dunning/Frozen, Read-only-State
|
||||
und Feature-Gates. Lago wird spaeter Billing-Source-of-Truth, Mollie nur Payment Processor.
|
||||
und Feature-Gates. Lago ist Billing-/Invoice-Source-of-Truth, Mollie ausschließlich Payment Processor.
|
||||
2. **Onboarding:** Auto-SHK-Provisionierung beim Signup (Seeds M158, ohne Wizard) + Demo-Daten-Knopf +
|
||||
Erste-Schritte-Checkliste.
|
||||
3. **Branding:** nur Hell/Dunkel-Toggle (kein System-Modus), flash-frei via SSR-Cookie.
|
||||
3. **Branding:** Light/Dark-Unterbau bleibt erhalten; Toggle und Dark-Anwendung im App-/Admin-Bereich sind vorerst deaktiviert (PR #81).
|
||||
|
||||
Nicht mehr Ziel dieses Tickets: Legacy-Provider-Abo-Baukasten, Legacy-Provider-Customer-Portal, Payment-Checkout, Usage-Billing,
|
||||
AI-Credits oder Pricing-/Upgrade-UI fuer Endkunden.
|
||||
@@ -37,67 +45,165 @@ AI-Credits oder Pricing-/Upgrade-UI fuer Endkunden.
|
||||
## Benötigte Screens (Backend bedient — Design liefert `D-P20`)
|
||||
| Screen [Route] | Kern-Inhalt |
|
||||
|---|---|
|
||||
| Abo-Übersicht [`/admin/subscription`] | Basis-Plan + **Feature-Module als Positionsliste mit Preisen** (read-only), Status/Trial-Countdown, **KEIN Upgrade-Button** (Hinweis-Box „Plan-Wechsel über Account-Manager/hivegrid.de"), Pausieren + Kündigen |
|
||||
| Verbrauchs-Übersicht [`/admin/usage`] ~~· AI-Credits [`/admin/usage/ai-credits`]~~ (AI-Credits-Screen entfällt — [[AD-26]]) | Quota-Balken je Metrik (Automation/~~AI-Tokens~~ (entfällt)/Speicher), ~~Donut AI-Verbrauch~~, 80%-Warnbanner, Aufgebraucht-Klartext |
|
||||
| Rechnungen/Zahlung [`/admin/billing`] | Lago-Invoice-Status + Mollie-Payment-Status + Klartext-Hilfe; kein Legacy-Provider-Portal-Embed |
|
||||
| Demo-Daten [`/admin/onboarding/demo-data`] | Settings-Knopf „Beispieldaten anlegen" (~25 Datensätze, Klartext-Liste), Demo-Zähler + Lösch-Funktion, „Demo ausblenden"-Filter |
|
||||
| Erste-Schritte-Checkliste [`/onboarding/checklist`] | Auto-erkannte Status-Häkchen, CTA-Links, manuell abhakbar/ausblendbar, Glückwunsch bei 100% (auch Dashboard-Widget) |
|
||||
| Status-Banner-System (Shell) | trial-Ende-3-Tage / past_due / frozen / deletion_pending je eigener Klartext + Action; Read-Only-Toast bei blockiertem Schreib-Button |
|
||||
| Hell/Dunkel-Toggle [Profil/User-Menü] | Zwei Optionen, sofortige Anwendung, flash-frei (SSR-Cookie) |
|
||||
| Abo-Übersicht [`/:tenant/settings/subscription`] | Plan + Seats + Feature-Module (read-only), Status/Trial-Countdown, **KEIN Upgrade-Button** (Hinweis „Plan-Wechsel über Account-Manager/hivegrid.de"), Kündigen falls freigegeben |
|
||||
| Verbrauchs-Übersicht [`/:tenant/settings/usage`] | Quota-Balken fuer Automation und Speicher, Warnbanner und Aufgebraucht-Klartext; keine Usage-Billing-Sprache |
|
||||
| Rechnungen/Zahlung [`/:tenant/settings/billing`] | Lago-Invoice-Status + Mollie-Payment-Status + Klartext-Hilfe; kein Legacy-Provider-Portal-Embed |
|
||||
| Demo-Daten [`/:tenant/settings/onboarding/demo-data`] | Settings-Knopf „Beispieldaten anlegen" (~25 Datensätze, Klartext-Liste), Demo-Zähler + Lösch-Funktion, „Demo ausblenden"-Filter |
|
||||
| Erste-Schritte-Checkliste [`/:tenant/onboarding/checklist`] | Auto-erkannte Status-Häkchen, CTA-Links, manuell abhakbar/ausblendbar, Glückwunsch bei 100% (auch Dashboard-Widget) |
|
||||
| Status-Banner-System (Shell) | AK-P20: Trial-Ende-3-Tage / `past_due` / `frozen` mit Klartext + Abo-Aktion; die bestehende 423-Klartext-Hülle bleibt. `deletion_pending` samt Shell-Aktion gehört zu `AK-P21`/`D-P21`; der finale Read-only-Toast bleibt `D-P20`-Design-Nachzug. |
|
||||
| Light/Dark-Toggle [Profil/User-Menü] | Vorerst ausgeblendet und im App-/Admin-Bereich deaktiviert (PR #81) |
|
||||
|
||||
## Definition of Done
|
||||
- [ ] **Billing-Recut-Basis**: lokaler Plan-/Seat-/Entitlement-State ist auf Lago/Mollie/HiveGrid ausgerichtet; keine Legacy-Provider-IDs als Zielmodell; kein Usage-Billing
|
||||
- [x] **Billing-Recut-Basis**: lokaler Plan-/Seat-/Entitlement-State ist auf Lago/Mollie/HiveGrid ausgerichtet; keine Legacy-Provider-IDs als Zielmodell; kein Usage-Billing
|
||||
- [x] **Trial + Dunning** (Tag 1/3/7) + **Frozen-Modus** (Read-Only-Middleware) greift; Status-Banner pro Zustand; Verbrauchs-Zähler + Drossel (Aufschlags-Abrechnung → v2)
|
||||
- [x] **In-App keine** Pricing-Tabelle/Upgrade-Buttons/Plan-Wechsel-UI (LP-8) — Read-Only + externer Verweis; Pause/Kündigen erlaubt
|
||||
- [x] **In-App keine** Pricing-Tabelle/Upgrade-Buttons/Plan-Wechsel-UI (LP-8) — Read-Only + externer Verweis; Kündigen bleibt bei vorhandener Berechtigung erlaubt
|
||||
- [x] **Auto-SHK-Provisionierung** beim Signup (Seeds M158: Pipelines, Custom-Felder, Rollen, Form-Templates, Checkliste) — **ohne Wizard-UI** (v2)
|
||||
- [x] **Demo-Daten-Knopf** (per Settings, `is_demo_data`-Flag löschbar) + „Demo ausblenden"-Filter
|
||||
- [x] **Erste-Schritte-Checkliste** (auto-erkannter Status, CTA-Links, abhakbar/ausblendbar; Dashboard-Widget)
|
||||
- [x] **Hell/Dunkel-Toggle** flash-frei (SSR-Cookie, `next-themes`) — kein System-Modus
|
||||
- [x] **Light/Dark-Unterbau** bleibt erhalten; Toggle und Dark-Anwendung sind vorerst deaktiviert (`DARK_MODE_IN_APP=false`, PR #81)
|
||||
- [x] Konnektor `tenantHasModule('billing')`; RLS auf allen Tenant-Tabellen
|
||||
|
||||
## Aktueller Stand (Billing-Recut 2026-07-04)
|
||||
## Aktueller Stand (Interim-UI 2026-07-12)
|
||||
|
||||
**Fortschritt:** **AK-P20: 7/8 historischer DoD = 87,5 % done; nach AD-27 bleibt 1/8 blockiert/ersetzt durch `BILL-02` bis `BILL-05`.**
|
||||
**Fortschritt:** **AK-P20: 8/8 DoD = 100 % done.** Es gibt keine selbst machbare Dev-Arbeit mehr.
|
||||
Die finale Subframe-Optik aus `D-P20` bleibt als nicht blockierender `design-nachzug` offen. Das Plane-Ticket
|
||||
wird ohne separate Done-Freigabe nicht auf Done gesetzt.
|
||||
|
||||
**Erledigt:**
|
||||
- Trial/Dunning/Frozen inkl. Statusbanner, zentralem Read-only-Guard, Usage-Zählern und Drossel.
|
||||
- In-App-Subscription bleibt read-only: keine Pricing-Tabelle, keine Upgrade-Buttons, keine Planwechsel-UI; Billing-/Zahlungsaktionen bleiben nur als freigegebene Recovery-/Kontaktpfade erreichbar.
|
||||
- Auto-SHK-Provisionierung beim Signup mit Rollen, Pipeline, Formular-Templates, Projekt-/Abnahme-Templates und Checkliste.
|
||||
- Demo-Daten-Knopf, `isDemoData`-Tracking, Löschung und Standardfilter “Demo ausblenden”.
|
||||
- Erste-Schritte-Checkliste mit Auto-Erkennung, manuellen Zuständen und Dashboard-Widget.
|
||||
- Hell/Dunkel-Toggle ohne System-Modus, SSR-Cookie-basiert.
|
||||
- Billing-Konnektor `tenantHasModule('billing')`, Tenant-Isolation/RLS-Artefakte und Boundary-Gates.
|
||||
- Seat-Typen im Plattform-Admin-Pricing blockiert: keine `PER_SEAT`-Seeds, keine `PER_SEAT`-Auswahl, serverseitige Guards gegen manipulierte Formulare.
|
||||
- Lago-/Mollie-/HiveGrid-Recut aus `BILL-02` bis `BILL-05`, Trial/Dunning/Frozen, Shell-Statusbanner
|
||||
für die AK-P20-Billing-Zustände (nicht `deletion_pending`),
|
||||
zentraler Read-only-Guard sowie nicht abrechenbare Usage-Zähler und Drossel.
|
||||
- Read-only Subscription ohne Pricing-, Upgrade-, Planwechsel- oder Checkout-UI; nur Kontakt und erlaubte
|
||||
Kündigung. Rechnungen zeigen Lago-Invoice- und Mollie-Payment-State.
|
||||
- Auto-SHK-Provisionierung, Demo-Daten-Verwaltung samt Environment-Gate/Listenfilter und Erste-Schritte-
|
||||
Checkliste samt Dashboard-Widget.
|
||||
- App-/Admin-Dark-Mode und Toggle bleiben wie mit PR #81 beabsichtigt deaktiviert; der Unterbau bleibt erhalten.
|
||||
- Fünf app-chrome-freie Interim-Screens aus `~/ui`, reine VM-Verträge, Smoke-/Hot-Swap- und Interim-Visual-Proof.
|
||||
Der M016-Pixelnachweis liegt in `tests/component/ak-p20-interim.ct.tsx` mit fünf PNG-Baselines unter
|
||||
`tests/component/__screenshots__/`; der schnelle React-Markup-Nachweis liegt in
|
||||
`apps/web/app/components/screens/ak-p20-interim.visual.test.tsx`. Die austauschbare Mock-Baseline liegt
|
||||
unter `packages/ui-mock/visual-baseline/ak-p20-interim.*`.
|
||||
|
||||
**Offen:**
|
||||
- Neuer Billing-Abschluss: lokale Billing-Domain auf Lago-/Mollie-Referenzen umstellen, Legacy-Provider-spezifische Felder/Services inventarisieren und ueber `BILL-02` bis `BILL-05` ersetzen.
|
||||
- Finale Subframe-/Screen-Integration aus `D-P20`.
|
||||
|
||||
**Recut-Entscheidung:** AK-P20 wird nicht still auf Done gesetzt. Die verwertbaren Teile (Trial/Dunning/Frozen,
|
||||
Read-only, Onboarding, Demo-Daten, Checkliste, Theme, Entitlement-Gates) bleiben Grundlage. Der alte
|
||||
Legacy-Provider-Abo-Baukasten-DoD wird durch `BILL-02` bis `BILL-05` ersetzt.
|
||||
**Offen, nicht Done-blockierend:** finales Layout-/Copy-Delta aus `D-P20`, anschließender Component-Swap und
|
||||
Re-Baseline. Die fachlichen Loader-, VM- und Action-Verträge bleiben dabei stabil.
|
||||
|
||||
## Technische Bausteine
|
||||
- **Entities** (eigene `prisma/schema/billing.prisma`): bestehende Subscription-/Feature-/Usage-Tabellen bleiben Migrationsbasis, muessen aber in `BILL-02` von Legacy-Provider-zentrierten Referenzen auf Lago-/Mollie-/HiveGrid-Referenzen umgestellt werden. Onboarding: `Onboarding`/`OnboardingSession`/`OnboardingDemoProvisioning`. Branding: `User.theme_preference` (Feld, kein eigenes Modell). `core.prisma` nur ueber noetige Tenant-Relationen (AD-21).
|
||||
- **Entities** (eigene `prisma/schema/billing.prisma`): Subscription-/Feature-/Usage-Tabellen tragen den lokalen HiveGrid-State sowie Lago-/Mollie-Referenzen; Legacy-Felder sind nur noch Migrationskompatibilität, nicht Zielmodell. Onboarding: `Onboarding`/`OnboardingSession`/`OnboardingDemoProvisioning`. Branding: vorhandener User-Theme-Unterbau (kein neues Modell). `core.prisma` nur ueber noetige Tenant-Relationen (AD-21).
|
||||
- **Abo-/Entitlement-Schicht:** `SubscriptionFeature.code` (z.B. `kwp_integration`) = Entitlement-Schicht; `tenantHasModule()` bleibt zentrale Gate-API.
|
||||
- **Billing-Integration neu:** Lago-Gateway (`BILL-03`), Mollie-Payment-Gateway (`BILL-04`), Sync/Frozen-State (`BILL-05`). Die vorhandenen Legacy-Provider-Webhook-/Dunning-Tests sind Migrationsvorlage, nicht Ziel.
|
||||
- **Billing-Integration:** Lago-Gateway (`BILL-03`), Mollie-Payment-Gateway (`BILL-04`) und Sync/Frozen-State (`BILL-05`) sind der aktive Vertrag. Historische Legacy-Webhook-/Dunning-Pfade bleiben nur Migrationsinventar.
|
||||
- **Auto-SHK-Provisionierung** orchestriert die Self-Seeds aller Module (AD-12); Demo-Daten-Seed via `is_demo_data`; Trial-Freischaltung durch Plattform-Admin (AK-P19).
|
||||
- **RLS** überall (global: Produkte/Features/Preise); `next-themes` SSR-Cookie für Hell/Dunkel.
|
||||
- **RLS** überall (global: Produkte/Features/Preise); der bestehende Theme-Unterbau bleibt erhalten, App-/Admin-Dark-Mode wird wegen `DARK_MODE_IN_APP=false` nicht angewendet.
|
||||
|
||||
## Quellen (granular)
|
||||
- `ENTITY-MODEL.md` → **Domäne 12: Billing & Abo-Baukasten** (Recut-Modell, keine Seat-Typen) + **Domäne 13** (Onboarding, OnboardingDemoProvisioning, User.theme_preference)
|
||||
- `ENTITY-MODEL.md` → **Domäne 12: Billing** (AD-27-Recut: Lago/Mollie/HiveGrid, Plans + Seats) + **Domäne 13** (Onboarding, OnboardingDemoProvisioning, bestehender User-Theme-Unterbau)
|
||||
- `REQUIREMENTS.md` → `REQ-billing-datenmodell`, `REQ-billing-trial-dunning`, `REQ-onboarding-demo-daten`, `REQ-branding-theme-phase1` (Onboarding-Wizard → v2)
|
||||
- `ROADMAP.md` → Phase 20 · `PHASE-SOURCES.md` → Phase 20 (M153-legacyProvider, M154-recut bindend, M155-trial-readonly, M156-metering Zähler+Drossel, M158-shk-provisionierung, M159-branchen-templates nur SHK, M160-demo gedünnt, M030 nur Hell/Dunkel)
|
||||
- `designer-briefs/P20-billing-onboarding-branding.md` (Abo-Baukasten, kein Upgrade-UI LP-8, Demo-Knopf, Hell/Dunkel)
|
||||
- `_bmad-output/specs/M28-subscriptions-billing.md` (⚠ M154-Recut), `M29-onboarding.md` (Wizard → v2), `M31-branding.md` · Legacy: `archive/hivegrid-cloud/app/config/pricing-plans.ts`
|
||||
- `ROADMAP.md` → Phase 20 · Milestones: (AD-27-Recut, M155 Trial/Read-only, M156 nur Zähler+Drossel, M158 Signup-Provisionierung, M159 nur SHK, M160 Demo gedünnt, M030-Unterbau bei deaktiviertem Toggle)
|
||||
- `designer-briefs/P20-billing-onboarding-branding.md` (read-only Lago/Mollie/HiveGrid, kein Upgrade-UI, Demo-Knopf, Theme-Toggle deaktiviert)
|
||||
|
||||
## Dev-Nachzug (nach Davids `D-P20`-Delta)
|
||||
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
|
||||
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
|
||||
- [ ] Plane-Ticket `AK-P20` aktualisiert
|
||||
- [x] Interim-UI aus `~/ui` auf den fünf kanonischen Tenant-Routen integriert; VM + Action-Callbacks stabil.
|
||||
- [x] ROADMAP, REQUIREMENTS, Designer-Brief und `D-P20` auf AD-27/AD-28 sowie PR #81 ausgerichtet.
|
||||
- [ ] Finale Subframe-Optik aus `D-P20` integrieren und `ak-p20-interim` neu baselinen.
|
||||
- [x] Plane-Kommentar `1dee227f-4726-4b7c-8ef1-7a15108f7e99`, Recut-Titel und Label
|
||||
`design-nachzug` nach dem Push gespiegelt; Status bewusst unverändert.
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
### 2026-07-20 · Stand-Audit + Dunning-Trigger-Nachzug (Branch `fix/ak-p20-audit-restwork`)
|
||||
|
||||
Drei-Quellen-Audit (Doc vs. Plane vs. Code) nach dem RLS-Cutover vom 14.07. Ergebnis: Interim-UI,
|
||||
Onboarding, Frozen/Read-only, Demo-Daten, Checkliste und Layer-Trennung sind vollstaendig belegt;
|
||||
die aktiven Pfade (Mollie-Webhook, Signup-Bootstrap, Checklist-Persistenz) binden den RLS-Kontext korrekt.
|
||||
**Ein realer Befund:** Die Tag-1/3/7-Dunning-Sequenz (DoD 2) hatte keinen Produktions-Trigger —
|
||||
`applyBillingDunningCycle()` im Web-Legacy-Service war nur aus Tests aufrufbar, und `BILL-05` hat
|
||||
Dunning-Mailsequenzen explizit aus seinem Scope ausgeklammert. Korrigierter Stand vor dem Nachzug: 7/8.
|
||||
|
||||
Umgesetzt:
|
||||
- Pure Dunning-Entscheidung (`evaluateBillingDunning`, Tag 1/3/7 + Freeze) nach
|
||||
`@hivegrid/db/billing-domain.server` gehoben (Commit `b30881a0a`).
|
||||
- Neuer taeglicher Worker-Cron `billing-dunning-sweep`: Sweep pro Tenant aus der globalen
|
||||
Tenant-Registry, `TenantSubscription`-Zugriffe in `withTenantRLS()`, Notices ueber
|
||||
`notifyWithTenantRlsContext()` (FORCE RLS, R-P1b-Praezedenz, sourceKey-Dedupe pro Attempt),
|
||||
Freeze nach Tag 7 mit `AuditEvent` + `billing_state_changed`-Activity im BILL-05-Format.
|
||||
Task in der `CleanupJob`-Union registriert (Folge-Commit auf dem Branch).
|
||||
- Nachzug (per User-Freigabe zum ausgewiesenen Vorschlag): Der tote Legacy-Service
|
||||
`billingDunningService.ts` (Stripe-Pfade, referenzierte ein nicht existierendes
|
||||
`stripeWebhookLog`-Modell, keine Konsumenten ausser dem eigenen Test) wurde samt Test
|
||||
entfernt; ebenso die VM-Dublette `buildBillingStatusBannerVm` + `BillingStatusBannerVm`
|
||||
aus `billingStatusService.ts` (der reale Banner laeuft ueber
|
||||
`packages/view-models/src/billing/subscription-banner.vm.ts`). Damit ist der letzte
|
||||
`stripe`-Import aus dem Codebestand verschwunden.
|
||||
|
||||
Audit-Klarstellungen (kein Code-Delta):
|
||||
- Das fehlende `tenantHasModule('billing')`-Gate auf `settings/subscription.tsx` ist **beabsichtigt**:
|
||||
`/plan-required/:tenant` verlinkt genau dorthin zurueck und BILL-05-DoD verlangt erreichbare
|
||||
Recovery-/Billing-Routen im Frozen-Zustand — ein Gate wuerde einen Redirect-Loop erzeugen.
|
||||
DoD 8 gilt damit als erfuellt (Gates auf `settings/usage` + `settings/billing` vorhanden).
|
||||
- Proof-Hash-Korrektur zu den 2026-07-12-Notizen: `84f56966c` existiert nach dem Rebase als
|
||||
`5c27d7b34` (`feat(ak-p20): add interim billing and onboarding UI`); `2ddff0ec0` ist als
|
||||
PR-#86-Merge `ecca4400a` auf `main`.
|
||||
- Das Zielschema liegt real in `prisma/schema/subscriptions.prisma` (nicht `billing.prisma`).
|
||||
|
||||
Proof: `pnpm --filter @hivegrid/{worker,queue,db,web} typecheck` gruen; fokussierte Suiten
|
||||
`billing-domain.server.test.ts` (13), `billing-dunning-cron.test.ts` + `handlers.test.ts` (123),
|
||||
`packages/queue` (127), `index.test.ts`/`notify-rls.test.ts` gruen; `verify:i18n`,
|
||||
`verify:cross-cutting-models`, `verify:sidebar-routes` gruen.
|
||||
|
||||
Fortschritt: **AK-P20: 8/8 DoD = 100 % done** (nach Nachzug; vor dem Nachzug real 7/8 = 87,5 %).
|
||||
|
||||
### 2026-07-12 · Bugfix-Nachtrag: EmptyState-Aktions-Buttons + Checklist-Reopen
|
||||
|
||||
Befund (Staging-Verifikation `demo-pro-crm`): Der „Demo-Daten erstellen"-Button war im DOM, aber unsichtbar.
|
||||
Root Cause außerhalb der AK-P20-Dateien: der `~/ui`-EmptyState-Wrapper (`apps/web/app/ui/components/EmptyState/index.tsx`)
|
||||
mergte noch `[&_button]:hidden` (Alt-Workaround gegen den früheren hartkodierten Subframe-CTA) und versteckte damit
|
||||
jeden per `action`-Slot übergebenen Button (~10 Screens, u.a. Demo-Daten-Create und Retry-CTAs). Zusätzlich war das
|
||||
Checklisten-„Ausblenden" irreversibel (Dismissed-State ohne nächste Aktion, DoD-23-Lücke).
|
||||
|
||||
Umgesetzt:
|
||||
- Wrapper-Klasse entfernt + Regression-Guard-Test (`EmptyState.wrapper.test.tsx`).
|
||||
- Checklist-Reopen: Service-Action `show` (Session zurück auf `active`), „Wieder einblenden"-Button im
|
||||
Dismissed-State, i18n `onboarding.firstSteps.dismissed.reopen` (de/en), Tests nachgezogen.
|
||||
- Staging-Ops: versehentlich dismisste Session (john.doe @ demo-pro-crm) per SQL zurück auf `active`.
|
||||
|
||||
Proof: PR #86 (`fix(ui): EmptyState action buttons visible again + checklist reopen`, Commit `2ddff0ec0`);
|
||||
`pnpm typecheck`, `verify:i18n`, `verify:source-health` grün; fokussierte Suites (Wrapper-Guard,
|
||||
OnboardingInterimScreens, akP20OnboardingService) 12/12 grün. Staging-E2E-Nachweis nach Merge/Deploy.
|
||||
|
||||
DoD-Stand unverändert: **AK-P20: 8/8 DoD = 100 % done** (Bugfix, kein Scope-Delta).
|
||||
|
||||
### 2026-07-12 · Interim-UI abgeschlossen
|
||||
|
||||
Umgesetzt:
|
||||
- Fünf kanonische Tenant-Screens fuer Subscription, Usage, Rechnungen/Zahlung, Demo-Daten und Erste Schritte
|
||||
als app-chrome-freie `~/ui`-Komponenten mit reinen VM-/Action-Verträgen.
|
||||
- Subscription bleibt read-only ohne Pricing, Checkout, Upgrade/Downgrade oder Customer-Portal; Kontakt und
|
||||
berechtigte Kündigung bleiben verfügbar. Lago-Invoices und Mollie-Payment-State sind getrennt dargestellt.
|
||||
- Trial-/`past_due`-/`frozen`-Banner in der Tenant-Shell; Aktion nur mit View-Permission. Der Dark-Mode-Toggle
|
||||
bleibt deaktiviert und auch gespeicherte Tenant-Dark-Farben werden bei `DARK_MODE_IN_APP=false` nicht angewendet.
|
||||
- Demo-Daten-Settings und Erste-Schritte-Checkliste einschließlich Dashboard-Widget. Der Checklisten-GET ist
|
||||
strikt read-only; Provisionierung/Persistenz geschieht nur noch über explizite Mutationspfade.
|
||||
- Echter M016-Pixelvergleich fuer alle fünf Screens sowie schneller React-Markup- und `ui-mock`-Hot-Swap-Proof.
|
||||
|
||||
Proof:
|
||||
- Code-Commit `84f56966c` (`feat(ak-p20): add interim billing and onboarding UI`), auf aktuellem `origin/main`
|
||||
(`6d16e4da7`) rebased und gepusht.
|
||||
- Plane-Kommentar `1dee227f-4726-4b7c-8ef1-7a15108f7e99`, Titel auf den AD-27-Recut korrigiert und
|
||||
Label `design-nachzug` gesetzt; Ticket-State unverändert gelassen.
|
||||
- `pnpm typecheck` und `pnpm lint` grün; Pre-Push-Typecheck/i18n ebenfalls grün.
|
||||
- Fokussierte AK-P20-Suite: 22 Testdateien, 112 Tests grün.
|
||||
- `pnpm run test:component:p20`: 5/5 Chromium-Pixelvergleiche grün; PNGs visuell geprüft.
|
||||
- `pnpm run verify:i18n`, `pnpm run verify:ui-visual`, `pnpm run test:hot-swap`,
|
||||
`pnpm run verify:billing-boundary-baseline`, `pnpm run verify:onboarding-flow`,
|
||||
`pnpm run verify:ci-baseline`, `pnpm run verify:source-health` und `pnpm exec prisma validate` grün.
|
||||
- Sidebar-Reachability im Main-Workspace: 5 Testdateien, 29 Tests grün. Playwright-E2E-Discovery:
|
||||
6 AK-P20-Smokes; ein vollständiger Live-Lauf benötigt die E2E-Tenant-Credentials.
|
||||
- Der breite Root-Wrapper `pnpm test` ist lokal kein belastbarer Gate-Lauf, weil er die benachbarten
|
||||
`.codex/worktrees` mit separaten React-Installationen einsammelt und dort bekannte Invalid-Hook-Fehler erzeugt.
|
||||
Die betroffenen Main-Workspace-Dateien und passenden Verify-Gates wurden deshalb explizit und grün ausgeführt.
|
||||
|
||||
Fortschritt: **AK-P20: 8/8 DoD = 100 % done.** Keine selbst machbare Dev-Arbeit offen; finales `D-P20`-Delta
|
||||
bleibt als nicht blockierender `design-nachzug` getrackt. Plane-Done bleibt bis zur separaten Freigabe ausstehend.
|
||||
|
||||
> Hinweis 2026-07-04: Die folgenden Slice-Notizen dokumentieren historische Umsetzung vor `AD-27`. Wo sie Legacy-Provider nennen,
|
||||
> ist das als Migrationsinventar/Vorarbeit zu lesen. Der aktive Zielpfad ist `BILL-02` bis `BILL-05`.
|
||||
|
||||
|
||||
Reference in new issue
Block a user