# 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 - [x] Zielhost/-Coolify fuer `lago-production` entschieden. - [x] Eigene Production-DB/Volumes/Secrets, keine Wiederverwendung der Staging-Instanz. - [x] Backup + Restore-Drill dokumentiert. - [x] Zugriff/Auth/Domain entschieden. - [ ] Mollie-Live-Konto verifiziert und Live-Webhooks vorbereitet. - [ ] Rechnungssteller-/Steuer-/Impressumsdaten fachlich freigegeben. - [x] 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.