# 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-00` fuer 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.de` via Lago-Login - Lokaler SSH-Tunnel aktuell moeglich: - Frontend `http://127.0.0.1:8188` - API `http://127.0.0.1:3108` - Verifiziert 2026-07-04: API `GET /health` liefert `Success`; Frontend liefert `200 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 - [x] Lago laeuft als Coolify-Resource, nicht als manueller Raw-Compose-Stack. - [x] API, Frontend, DB, Redis, Worker, Billing-Worker, Clock-Scheduler und PDF-Service starten. - [x] Alte manuelle Pilot-Instanz entfernt. - [x] Zugriffsmodell festgelegt: Public Operator-UI via Lago-Login; API intern ueber Mesh, SSH-Tunnel als Fallback. - [x] Backup-Konzept fuer Lago-Postgres dokumentiert und Restore-Pfad definiert. - [x] SMTP/Mail-Verhalten fuer Staging entschieden: standardmaessig deaktiviert, Mailjet-Testconfig nur explizit fuer `BILL-07`. - [x] Dateispeicher fuer Invoice-PDFs entschieden: lokales Coolify-Volume fuer Staging-Pilot, Production spaeter separat. - [x] Runbook fuer Start/Stop/Upgrade/Restore in `docs/ops/lago-staging.md` dokumentiert. **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.md` AD-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.md` - `git diff --check`