4.3 KiB
BILL-01 · Lago-Staging sauber betreiben
| Typ | Setup/Infra |
| Owner | Raffael |
| Phase | Billing-Recut nach AD-27 |
| Cycle/Fenster | nach BILL-00 |
| Status | Umgesetzt / bereit fuer Review |
Abhaengigkeiten & Parallelitaet
- Blocked by:
BILL-00fuer endgueltige Doku-Namen; Pilot kann parallel validiert werden. - Blocks:
BILL-03,BILL-07.
Was wir bauen
Eine saubere Lago-Staging-Instanz als Coolify-Service im Estate. Sie ist fuer mehrere HiveGrid-Staging-Flows nutzbar, aber nicht mit Production gemischt.
Aktueller Stand
- Coolify-Projekt:
node1-estate - Resource:
lago-staging - Resource UUID:
kh7l869ianltiioqgmm45kur - Server:
node1 - Oeffentlicher Operator-Zugriff:
https://staging-lago.hivegrid.devia Lago-Login - Lokaler SSH-Tunnel aktuell moeglich:
- Frontend
http://127.0.0.1:8188 - API
http://127.0.0.1:3108
- Frontend
- Verifiziert 2026-07-04: API
GET /healthliefertSuccess; Frontend liefert200 OK. - Aktualisiert 2026-07-28: Lago
v1.50.0; API, Worker, Billing-Worker und der periodische Clock-Scheduler laufen auf demselben Zielstand.
Definition of Done
- Lago laeuft als Coolify-Resource, nicht als manueller Raw-Compose-Stack.
- API, Frontend, DB, Redis, Worker, Billing-Worker, Clock-Scheduler und PDF-Service starten.
- Alte manuelle Pilot-Instanz entfernt.
- Zugriffsmodell festgelegt: Public Operator-UI via Lago-Login; API intern ueber Mesh, SSH-Tunnel als Fallback.
- Backup-Konzept fuer Lago-Postgres dokumentiert und Restore-Pfad definiert.
- SMTP/Mail-Verhalten fuer Staging entschieden: standardmaessig deaktiviert, Mailjet-Testconfig nur explizit fuer
BILL-07. - Dateispeicher fuer Invoice-PDFs entschieden: lokales Coolify-Volume fuer Staging-Pilot, Production spaeter separat.
- Runbook fuer Start/Stop/Upgrade/Restore in
docs/ops/lago-staging.mddokumentiert.
Fortschritt: BILL-01: 8/8 DoD = 100 % done.
Technische Bausteine
- Coolify Docker-Compose-Resource mit
getlago/api:v1.50.0,getlago/front:v1.50.0, Postgres 15, Redis 7. - Keine Public-Domain ohne Auth.
- Keine Production-Daten.
- Runbook:
docs/ops/lago-staging.md.
Quellen
docs/ARCHITECTURE-DECISIONS.mdAD-27- Estate-Infra
../infra/runbooks/migrate-node1-to-coolify.md - Lago Self-hosting Docs
Umsetzungsnotiz
2026-07-04: Staging-Betrieb dokumentiert. Backup- und Restore-Pfad fuer Lago-Postgres, SMTP-Entscheidung,
Invoice-PDF-Storage-Entscheidung, Upgrade/Rollback und Testdaten-Konvention stehen in docs/ops/lago-staging.md.
2026-07-05: Zugriffsmodell aktualisiert. Die Operator-UI ist unter https://staging-lago.hivegrid.de erreichbar
und durch Lago-Login geschuetzt; die HiveGrid-zu-Lago-API bleibt intern ueber http://10.42.0.4:3108. Invoice-PDFs
liegen im Hetzner-Bucket hivegrid-staging-lago; Kunden-Downloads laufen ueber HiveGrid.
2026-07-28: Lago-Staging 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 Backfills durchlaufen. Vorher wurde ein verschluesseltes Postgres-Backup in eine
Wegwerf-Datenbank restored; Proof: 6 Kunden, 16 Subscriptions, 27 Rechnungen. Vor dem Ziel-Deploy
wurde ein zweites v1.45.0-Archiv validiert. Der fehlende offizielle api-clock-Dienst wurde ergaenzt
und plant 26 periodische Billing-Jobs ein.
Abschluss-Proof 2026-07-28: API lokal und ueber Mesh meldet v1.50.0; 0 offene DB-Migrationen;
Kernbestand unveraendert (1 Organisation, 6 Kunden, 4 Plaene, 16 Subscriptions, 27 Rechnungen);
Queues ohne Pending/Retry/Dead-Jobs; echter Operator-Login erfolgreich; REST-API HTTP 200; Fixed-Charges
im Plan-Contract verfuegbar; vorhandene S3-Rechnung als application/pdf mit gueltigem %PDF-Header
geladen; laufende HiveGrid-Staging-API erreicht Lago ueber Mesh mit HTTP 200. Ein frisches verschluesseltes
v1.50.0-Post-Upgrade-Backup wurde erneut in eine Wegwerf-Datenbank restored und reproduzierte
6 Kunden, 16 Subscriptions und 27 Rechnungen.
Fortschritt: BILL-01: 8/8 DoD = 100 % done.
Proof:
docs/ops/lago-staging.mdgit diff --check