178 lines
8.7 KiB
Markdown
178 lines
8.7 KiB
Markdown
# 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.
|