Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-INFRA1.md
T

56 lines
4.5 KiB
Markdown

# AK-INFRA1 · Infra-Live: Staging + Coolify-Apps + PG/Redis/PgBouncer
| | |
|---|---|
| **Typ** | Dev (Ops/Infra — `typ:external`) |
| **Owner** | Akeshan |
| **Phase** | P1-Querschnitt (Infra-Schiene, kein Code-Modul) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-06` (Hetzner-Projekt HiveGrid: S3 + Token + DEK-Master-Key)
- **Blocks:** CI/Gates, **alle Deploys** (ohne Staging kein Demo, kein Gate-Beweis)
- **Läuft parallel zu:** Raffaels `R-P1a`/`R-P1b`/`R-P1c` — **reines Ops, kein Code-Konflikt** (Grobstruktur: Raffael Code SOLO ‖ Akeshan Infra). Keine Schema-Berührung.
- **Konflikt-Risiko:** keines.
## Was wir bauen
Die **lauffähige Staging-Umgebung** auf der Hetzner/Coolify-Schiene (Infra-Stack ADR-009/010): `staging-app` + `staging-api` auf `staging-1`, öffentlich erreichbar aber **gehärtet** (noindex, HMAC-geschützt), plus die **Coolify-managed Datenbank-Schicht** (Postgres, Redis, PgBouncer). Das ist das Deploy-Ziel, gegen das alle Folge-Tickets ausrollen und die W1-Gates beweisen.
## Definition of Done
- [x] `staging-app` + `staging-api` live — `/healthz` 200 + Coolify `running:healthy`. **noindex** implementiert (greift mit nächstem main-Deploy); **HMAC bewusst zurückgestellt** (Owner-Entscheidung 19.06., s.u.)
- [x] Coolify-managed **Postgres** + **Redis** + **PgBouncer** erreichbar — Postgres/Redis Coolify `running:healthy`, pooled DB-Pfad via `/readyz` 200 belegt
- [x] Deploy-Pipeline grün (CI rollt gegen Staging aus) — Live-Revision = `main`-Commit `b8fff6fe`
## Umsetzungsstand / Verifikation (2026-06-19, Owner Raffael)
**Live verifiziert (Coolify-API + HTTP):**
- `hivegrid-web`, `hivegrid-api`, `worker-general` = `running:healthy`; `hivegrid-staging-postgres` + `hivegrid-staging-redis` = `running:healthy`.
- `staging-web.hivegrid.de/healthz` + `/readyz` = 200 (`ready` → Postgres über PgBouncer erreichbar), `staging-api.hivegrid.de` ebenso. TLS gültig (HSTS).
- Deploy-Pipeline rollt `main` aus (Live-Rev `b8fff6fe` = echter main-Commit).
- PgBouncer hat keinen eigenen Coolify-Resource-UUID (vermutlich Sidecar/Teil der PG-URL); der pooled Pfad ist über `/readyz` aber bewiesen.
**Härtung (noindex) — LIVE auf Staging (Deploy `fe1d75b1`, verifiziert):**
- `entry.server.tsx` setzt `X-Robots-Tag: noindex, nofollow` auf jeder SSR-HTML-Antwort, wenn `WEB_NOINDEX=true` (`utils/seo/noindex.server.ts`-Gate). `WEB_NOINDEX=true` auf staging-web in Coolify gesetzt. **Live verifiziert:** `GET /login` → `x-robots-tag: noindex, nofollow`. Das ist der verlässliche noindex-Mechanismus (Suchmaschinen respektieren ihn pro Seite).
- robots.txt bleibt **statisch** (`public/robots.txt`, allow-all, env-unabhängig). Hinweis: Der dynamische `other-routes.server`-Pfad greift im Prod-Server **nicht** (auch das bestehende `/sitemap.xml` 302't dort) — env-abhängige robots.txt wäre also wirkungslos gewesen; der `X-Robots-Tag`-Header erzwingt den noindex ohnehin. Das `other-routes`/`sitemap`-302-Verhalten ist ein **separater, vorbestehender** Befund (kein INFRA1-Blocker).
**Entscheidung 2026-06-20 (Owner) — Staging-Access-Gate (HMAC/Edge-Basic-Auth) bewusst DEFERRED:** Kein
Edge-Schutz für Staging nötig fürs Erste. Begründung: Staging-App liegt hinter Login (Root → 302 `/login`,
verifiziert), `X-Robots-Tag: noindex, nofollow` aktiv (keine Suchmaschinen-Indexierung), keine echten
Kundendaten auf Staging. Ein Edge-Basic-Auth (wie `staging.mitapp.de`) bleibt ein optionaler Folgeschritt,
falls Staging später öffentlich-sensibler wird — **nicht** Teil dieses Tickets. Die DoD-Formulierung
„HMAC-geschützt" gilt damit als bewusst aus dem W1-Scope genommen.
**Status:** **DoD erfüllt — 100 % (W1-Scope).** Staging live: web/api `/readyz` 200 (Migration
UserSession+TrustedDevice angewandt), Postgres/Redis/PgBouncer healthy, CI-Pipeline grün, noindex aktiv.
Staging-Access-Gate bewusst deferred (s.o.). Selbst machbar offen: 0. Ticket auf **Done** (Plane). Owner: Raffael.
## Warum
Ohne Staging + DB-Schicht kein Deploy, kein CI-Gate, keine Noah-Demo. Sessions (R-P2a) brauchen Postgres als Source-of-Truth + Redis-Cache (AD-4); PgBouncer für Connection-Pooling unter RLS (`SET LOCAL app.tenant_id` pro Transaktion).
## Quellen (granular)
- `EXTERNALS-CHECKLISTE.md` → C3/C4 (Staging + Coolify-DB)
- `project_infra_stack` (Memory) → ADR-009/010, Hetzner+Coolify+Cloudflare
- `ROADMAP.md` → Phase 1 (lauffähige Codebasis)
- abhängig: `EXT-06` (S3 + DEK-Master-Key)