3.3 KiB
3.3 KiB
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
- Tenant-Billing-Status sichtbar: Plan, Seats, Subscription-Status, Payment-Status, letzte Invoice.
- Manuelle Sync-Aktion fuer Lago und Mollie.
- Read-only/Frozen-Grund und Recovery-Hinweis sichtbar.
- Admin kann Plan/Seats fuer Test-/Sonderkunden kontrolliert setzen, mit Audit und Reason.
- Keine Pricing-/Self-Service-UI fuer Endkunden.
- i18n/Klartext fuer sichtbare Texte.
- Tests fuer Loader/View-Model und Admin-Actions.
Umsetzungs-Notiz
2026-07-04 · Raffael
- Interne Admin-Route
admin/accounts/billingergaenzt und im Admin-Accounts-Menue mitadmin.account.subscriptionverlinkt. - View-Model
packages/view-models/src/admin/billing-admin.vm.tsgebaut: Status, Plan, Seats, letzte Invoice/Payment, Provider-Referenzen, Read-only-Grund und Recovery-Hinweis. - Server-Service
apps/web/app/services/admin/billing-admin.server.tsgebaut: 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,energaenzt. - Proof:
pnpm --dir packages/view-models test -- billing-admin.vm.test.tspnpm exec vitest run apps/web/app/services/admin/billing-admin.server.test.ts apps/web/app/routes/admin/accounts/billing.test.tspnpm --dir apps/web typecheckpnpm 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.tspnpm --dir apps/web typecheck
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-P19D-ADMINnach spaeterem Screen-Recut