71 lines
2.7 KiB
Markdown
71 lines
2.7 KiB
Markdown
# 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`.
|
|
|
|
## 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] 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.27.1`, `getlago/front:v1.27.1`, 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.
|
|
|
|
Proof:
|
|
- `docs/ops/lago-staging.md`
|
|
- `git diff --check`
|