Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-01.md
T
2026-07-08 16:15:37 +02:00

2.7 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-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

  • Lago laeuft als Coolify-Resource, nicht als manueller Raw-Compose-Stack.
  • API, Frontend, DB, Redis, Worker, Billing-Worker 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.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