# BILL-06 · Interne Admin-Billing-Basis | | | | ----------------- | -------------------------- | | **Typ** | Dev/UI ohne finale Screens | | **Owner** | Raffael | | **Phase** | Billing-Recut nach AD-27 | | **Cycle/Fenster** | nach `BILL-05` | | **Status** | Done | ## Abhaengigkeiten & Parallelitaet - **Blocked by:** `BILL-05` - **Blocks:** Customer-facing Billing-Screens spaeter. - **Screen-Status:** finale Designs offen; Backend/Minimal-Admin kann ohne Screens vorbereitet werden. ## Was wir bauen Eine interne Admin-Basis, damit Support/Operatoren Billing-Zustand sehen und manuell korrigieren koennen, ohne direkt in Lago/Mollie zu arbeiten. ## Definition of Done - [x] Tenant-Billing-Status sichtbar: Plan, Seats, Subscription-Status, Payment-Status, letzte Invoice. - [x] Manuelle Sync-Aktion fuer Lago und Mollie. - [x] Read-only/Frozen-Grund und Recovery-Hinweis sichtbar. - [x] Admin kann Plan/Seats fuer Test-/Sonderkunden kontrolliert setzen, mit Audit und Reason. - [x] Keine Pricing-/Self-Service-UI fuer Endkunden. - [x] i18n/Klartext fuer sichtbare Texte. - [x] Tests fuer Loader/View-Model und Admin-Actions. ## Umsetzungs-Notiz 2026-07-04 · Raffael - Interne Admin-Route `admin/accounts/billing` ergaenzt und im Admin-Accounts-Menue mit `admin.account.subscription` verlinkt. - View-Model `packages/view-models/src/admin/billing-admin.vm.ts` gebaut: Status, Plan, Seats, letzte Invoice/Payment, Provider-Referenzen, Read-only-Grund und Recovery-Hinweis. - Server-Service `apps/web/app/services/admin/billing-admin.server.ts` gebaut: Tenant-Billing-Liste, Plan/Seat-Override mit Pflichtgrund + Audit, Cache-Invalidierung und optionalem Catalog-Product-Attach; manuelle Lago-/Mollie-Sync-Anforderung via Outbox. - Endkunden-Pricing/Self-Service bewusst nicht beruehrt. - i18n in `de`, `de-formal`, `en` ergaenzt. - Proof: - `pnpm --dir packages/view-models test -- billing-admin.vm.test.ts` - `pnpm exec vitest run apps/web/app/services/admin/billing-admin.server.test.ts apps/web/app/routes/admin/accounts/billing.test.ts` - `pnpm --dir apps/web typecheck` - `pnpm run lint` **BILL-06: 7/7 DoD = 100 % done.** 2026-07-05 · Readiness-Nachtrag - Luecke geschlossen: Die Admin-Aktion fuer manuellen Provider-Sync legt nicht mehr nur ein `billing.*`-Outbox-Event ab. Diese Events hatten noch keinen Billing-Consumer und waeren damit fuer Admin-Sync als reine Platzhalter haengen geblieben. - Lago-Sync refetcht jetzt serverseitig den Lago-Customer und die letzte Tenant-Rechnung und wendet den lokalen Billing-Sync direkt an. - Mollie-Sync refetcht jetzt serverseitig die Zahlung ueber die Payment-ID und wendet den lokalen Payment-Sync direkt an. - `MOLLIE_*` ist fuer die Web-Runtime konfigurierbar, weil die Admin-Oberflaeche im Web-Prozess laeuft. - Proof: - `pnpm exec vitest run packages/config/src/web.test.ts packages/config/src/catalog.test.ts apps/web/app/services/admin/billing-admin.server.test.ts` - `pnpm --dir apps/web typecheck` **BILL-06: 7/7 DoD = 100 % done.** 2026-07-28 · Abhaengigkeits-Nachzug aus BILL-03 - Der manuelle Admin-Pull-Sync bleibt als operatorgesteuerter Recovery-Pfad bestehen. - Die neue signierte Lago-Push-Grenze nutzt denselben lokalen Sync-Service, aendert aber weder Admin-Actions noch deren Berechtigungs-, Audit- oder Klartext-Vertrag. **BILL-06: 7/7 DoD = 100 % done.** ## Nicht im Scope - Finales Customer-Billing-Center. - oeffentliche Planwechsel-/Checkout-UI. - Rechnungssteller-/Steuer-Finalisierung. ## Technische Bausteine - Admin-Route oder bestehende Tenant-Detail-Erweiterung. - View-Model in `packages/view-models`. - Actions nur serverseitig, mit `withPermission()` und Audit. ## Quellen - AD-27 - `AK-P19` - `D-ADMIN` nach spaeterem Screen-Recut