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

178 lines
8.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.