89 lines
3.8 KiB
Markdown
89 lines
3.8 KiB
Markdown
# 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
|