Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-06.md
T

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