Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -1,12 +1,12 @@
# 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 |
| | |
| ----------------- | ------------------------------ |
| **Typ** | Setup/Infra |
| **Owner** | Raffael |
| **Phase** | Billing-Recut nach AD-27 |
| **Cycle/Fenster** | nach `BILL-00` |
| **Status** | Umgesetzt / bereit fuer Review |
## Abhaengigkeiten & Parallelitaet
@@ -29,11 +29,13 @@ aber nicht mit Production gemischt.
- 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 und PDF-Service starten.
- [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.
@@ -45,7 +47,7 @@ aber nicht mit Production gemischt.
## Technische Bausteine
- Coolify Docker-Compose-Resource mit `getlago/api:v1.27.1`, `getlago/front:v1.27.1`, Postgres 15, Redis 7.
- 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`.
@@ -65,6 +67,24 @@ Invoice-PDF-Storage-Entscheidung, Upgrade/Rollback und Testdaten-Konvention steh
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`