8.7 KiB
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-23fü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-16fail-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-productionentschieden. - 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-21erzwingt 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 danachsequenceType=recurring.
Proof:
docs/ops/lago-production-prep.mdworkflows/hivegrid-lago-backupundworkflows/hivegrid-lago-restore-drilliminfra-Repo- Cloud Runtime-Gate
85fac5bb7; Infra Backup/Restore936a32a; Clock-Restorecfbe109/ normaler Mergef7abfda - Restic-Snapshots
3d8a1deb,cc8c5c88,3c245001,176fdf80; Restore-Drills 2026-07-27 und 2026-07-28 BILL-11Production-Verify und Promote Run11477: identischer Katalog-Digest, alle Runtime-Ressourcen gesund, Side-Effect-Gate weiterhinfalse, kein Mollie-Key und keine Production-Zahlungpnpm 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-07EXT-16docs/ops/lago-production-prep.md
2026-08-02 · Abhängigkeitsschutz für BILL-21
BILL-21ersetzt 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-08bleibt 5/7 DoD = ~71 % done; 2 Punkte extern blockiert, 0 Punkte selbst machbar.
2026-08-02 · Abhängigkeitsschutz für BILL-22
BILL-22schließ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-08bleibt 5/7 DoD = ~71 % done; 2 Punkte extern blockiert, 0 Punkte selbst machbar.
2026-08-02 · Abhängigkeitsschutz für BILL-23
BILL-23hat 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-08bleibt 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-24zieht 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-24ist ein zusätzlicher, aktuell selbst machbarer Abhängigkeitsschutz vor dem späteren Production-Sync.
2026-08-03 · Abhängigkeitsschutz für BILL-25
BILL-25ersetzt 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-08bleibt 5/7 DoD = ~71 % done; 2 Punkte extern blockiert. Der Katalog-Sync ausBILL-25darf diese Gates nicht als erledigt markieren.