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

8.7 KiB
Raw Blame History

BILL-08 · Billing Production Prep

Typ Setup/Infra
Owner Raffael
Phase Billing-Recut nach AD-27
Cycle/Fenster Production-Foundation am 2026-07-27 freigegeben; Live-Billing weiter extern blockiert
Status In Arbeit · Lago Production provisioniert, Mollie-/Legal-Gates offen

Abhaengigkeiten & Parallelitaet

  • Blocked by: Firmierung/Rechnungssteller-Entscheidung, Mollie-Live-Verifizierung sowie BILL-23 für den finalen versionierten Production-Speicherkatalog.
  • Blocks: produktives Self-Service-Billing.
  • Aktuelle Entscheidung 2026-07-27: Die getrennte Production-Foundation wird provisioniert und per Restore-Drill abgesichert. Echte Zahlungen, Self-Service-Checkout und Provider-Side-Effects bleiben bis EXT-16 fail-closed.

Was wir bauen

Die Production-Vorbereitung fuer eine eigene Lago-Instanz im HiveGrid-Prod-Setup. Staging und Prod werden getrennt. BILL-07 ist erledigt; der verbleibende Blocker ist extern/rechtlich bzw. Mollie-Live-KYC.

Dieses Ticket bleibt als spaetere Production-Notiz erhalten. Fuer den aktuellen Testpfad gilt BILL-07 / docs/ops/lago-staging.md.

Definition of Done

  • Zielhost/-Coolify fuer lago-production entschieden.
  • Eigene Production-DB/Volumes/Secrets, keine Wiederverwendung der Staging-Instanz.
  • Backup + Restore-Drill dokumentiert.
  • Zugriff/Auth/Domain entschieden.
  • Mollie-Live-Konto verifiziert und Live-Webhooks vorbereitet.
  • Rechnungssteller-/Steuer-/Impressumsdaten fachlich freigegeben.
  • Rollback-Pfad fuer Billing-Deploy dokumentiert.

Fortschritt: BILL-08: 5/7 DoD = ~71 % done. Offen: 2 externe Gates (Mollie-Live-Konto, Rechnungssteller-/Steuer-/Impressumsdaten). Selbst machbarer Dev-/Ops-Anteil aktuell 5/5 = 100 %.

Nicht im Scope

  • Vorziehen ohne BILL-07.
  • Vermischung mit Staging.

Technische Bausteine

  • Eigene Lago-Production-Resource.
  • Secret-Rotation-Plan.
  • Monitoring/Healthchecks.

Umsetzungsnotiz

2026-07-04: Production-Prep ohne Provisionierung dokumentiert. Zieltopologie: Coolify-Projekt HiveGrid, Environment production, Resource lago-production; initial auf dem aktuellen HiveGrid-Production-Host, solange Hetzner-Kapazitaet limitiert ist, aber mit eigener Resource, eigener DB, eigenem Redis/Storage und eigenen Secrets. Kein Public-Lago-Zugang als Default; Operator-Zugriff intern/SSH-Tunnel, Authentik-gated Admin spaeter nur bei Bedarf. Backup-/Restore-Drill, Secret-Liste, Mollie-Live-Gates und Rollback-Pfad stehen in docs/ops/lago-production-prep.md.

2026-07-27: Nach expliziter Operator-Freigabe wurde lago-production auf dem Production-Worker provisioniert. Eigene Postgres-/Redis-Volumes, eigene Production-Secrets und der private, versionierte Bucket hivegrid-prod-lago sind aktiv. Die API ist nur im privaten Hetzner-Netz erreichbar; öffentliche Lago-Ports und DNS fehlen absichtlich. Die leere Production-Organisation wurde angelegt, Signup danach wieder geschlossen. Der tägliche verschlüsselte Backup-Job ist aktiv. Snapshot 3d8a1deb wurde in einer vollständigen Disposable-Topologie wiederhergestellt und per API-/DB-/S3-Probe verifiziert. Mollie Live bleibt unkonfiguriert; PRODUCT_ACQUISITION_PROVIDER_SIDE_EFFECT_REQUIRED=false hält den Provider-Subscriber fail-closed.

2026-07-28: lago-production kontrolliert von v1.27.1 auf v1.50.0 aktualisiert. Die Pflicht-Bridges v1.28.1, v1.30.0, v1.31.0, v1.32.0, v1.42.0, v1.43.0, v1.44.0 und v1.45.0 wurden mit den jeweiligen Required Jobs durchlaufen. Snapshots cc8c5c88 (vor Upgrade), 3c245001 (Bridge v1.45.0) und 176fdf80 (nach Upgrade) wurden jeweils in der disposable Production-Topologie wiederhergestellt. Der Restore-Drill prüft jetzt zusätzlich den neuen api-clock-Dienst.

Abschluss-Proof 2026-07-28: private API meldet v1.50.0; 0 offene DB-Migrationen; Production-Bestand unverändert (1 Organisation, 1 API-Key, sonst keine Billing-Daten); Queues ohne Pending/Retry/Dead-Jobs; PDF-Service HTTP 200; Object-Storage-HEAD erfolgreich; laufende HiveGrid-Production-API erreicht Lago authentifiziert mit HTTP 200. Der Provider-Side-Effect-Gate bleibt false; Mollie Live ist weiterhin nicht aktiviert.

Fortschritt: BILL-08: 5/7 DoD = ~71 % done. Offen: 2 externe Gates (Mollie-Live-Konto, Rechnungssteller-/Steuer-/Impressumsdaten). Selbst machbarer Dev-/Ops-Anteil 5/5 = 100 %.

2026-07-29 · Abhaengigkeitsnachzug aus BILL-11:

  • Der Production-Katalog Core / Swarm / Colony ist katalogseitig provisioniert und driftfrei zu Staging.
  • Der Side-Effect-Gate bleibt false; es wurde keine Production-Zahlung ausgeloest.
  • Das dokumentierte EUR-1.000-SEPA-Transaktionslimit wird nicht mehr als externe Limiterhoehung vorausgesetzt. BILL-21 erzwingt fuer jeden Bruttobetrag ab 1.000,01 EUR eine Kartenautorisierung; bereits Colony liegt mit 19 % Umsatzsteuer darueber.
  • Die erste Mandatserteilung nutzt eine kundenpraesente Zahlart mit sequenceType=first; echte Folgeeinzuege nutzen erst danach sequenceType=recurring.

Proof:

  • docs/ops/lago-production-prep.md
  • workflows/hivegrid-lago-backup und workflows/hivegrid-lago-restore-drill im infra-Repo
  • Cloud Runtime-Gate 85fac5bb7; Infra Backup/Restore 936a32a; Clock-Restore cfbe109 / normaler Merge f7abfda
  • Restic-Snapshots 3d8a1deb, cc8c5c88, 3c245001, 176fdf80; Restore-Drills 2026-07-27 und 2026-07-28
  • BILL-11 Production-Verify und Promote Run 11477: identischer Katalog-Digest, alle Runtime-Ressourcen gesund, Side-Effect-Gate weiterhin false, kein Mollie-Key und keine Production-Zahlung
  • pnpm typecheck, pnpm lint, pnpm test (7.840 grün, 60 übersprungen), verify:production-docs, verify:production-docs-baseline, git diff --check

Quellen

  • AD-24
  • AD-27
  • BILL-07
  • EXT-16
  • docs/ops/lago-production-prep.md

2026-08-02 · Abhängigkeitsschutz für BILL-21

  • BILL-21 ersetzt ausschließlich das zusätzliche SEPA-Limit-Gate durch eine fail-closed Kartenregel. Mollie-Live-KYC sowie Rechnungssteller-/Steuer-/ Impressumsfreigabe bleiben die zwei externen Gates.
  • BILL-08 bleibt 5/7 DoD = ~71 % done; 2 Punkte extern blockiert, 0 Punkte selbst machbar.

2026-08-02 · Abhängigkeitsschutz für BILL-22

  • BILL-22 schließt die freie Kartenwahl unterhalb der Grenze, den mandatsicheren Folgeeinzug und den geführten Pilot-Checkout. Mollie-Live-KYC sowie Rechnungssteller-/Steuer-/Impressumsfreigabe bleiben die zwei externen Production-Gates unverändert.
  • BILL-08 bleibt 5/7 DoD = ~71 % done; 2 Punkte extern blockiert, 0 Punkte selbst machbar.

2026-08-02 · Abhängigkeitsschutz für BILL-23

  • BILL-23 hat den finalen versionierten Speichervertrag auf Staging synchronisiert und live verifiziert. Technische Plan-/Add-on-Codes blieben stabil; der Production-Provider wurde nicht verändert.
  • Der Speicher-Katalog ist damit kein offenes Gate mehr. BILL-08 bleibt dennoch 5/7 DoD = ~71 % done; Mollie-Live-KYC sowie Rechnungssteller-/ Steuer-/Impressumsfreigabe sind die zwei extern blockierten Punkte, 0 Punkte selbst machbar.

2026-08-03 · Abhängigkeitsschutz für BILL-24

  • BILL-24 zieht das neu buchbare Speicherangebot auf drei wertige ,99-Stufen nach und bewahrt den bisherigen 100-GB-Code nur für Bestandsverträge. Production bleibt bis zum neuen Staging-Katalog- und Deploy-Proof auf dem unveränderten Stand.
  • Die 7 DoD-Punkte von BILL-08 ändern sich nicht: weiterhin 5/7 = ~71 % done, 2 externe Gates offen. BILL-24 ist ein zusätzlicher, aktuell selbst machbarer Abhängigkeitsschutz vor dem späteren Production-Sync.

2026-08-03 · Abhängigkeitsschutz für BILL-25

  • BILL-25 ersetzt die neu kaufbaren Speicherpreise durch eine konservative 5×-Egress-Kalkulation und prüft den vollständigen Staging-Journey-Vertrag erneut. Der Production-Katalog darf erst nach diesem Proof nachgezogen werden.
  • Die zwei externen Gates bleiben unverändert: keine Mollie-Live-Zahlung und keine Aktivierung produktiver Provider-Side-Effects ohne verifiziertes Live-Konto sowie freigegebene Rechnungssteller-/Steuer-/Impressumsdaten.
  • BILL-08 bleibt 5/7 DoD = ~71 % done; 2 Punkte extern blockiert. Der Katalog-Sync aus BILL-25 darf diese Gates nicht als erledigt markieren.