Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-06.md
T
2026-07-08 16:15:37 +02:00

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/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.

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