# AK-INFRA1 · Infra-Live: Staging + Coolify-Apps + PG/Redis/PgBouncer | | | |---|---| | **Typ** | Dev (Ops/Infra — `typ:external`) | | **Owner** | Raffael (urspr. Akeshan; Umsetzung + Verifikation Raffael, s. Plane-Assignee) | | **Phase** | P1-Querschnitt (Infra-Schiene, kein Code-Modul) | | **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 | | **Status** | **Done** (Plane Done seit 2026-06-20; Audit-bestätigt 2026-07-16) | ## 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). *(Hinweis 2026-07-16: der Host heißt inzwischen `staging-app.hivegrid.de` — `staging-web.hivegrid.de` hat keinen DNS-Record mehr.)* - 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. ## Audit-Notiz (2026-07-16, Stand-Audit) Drei-Quellen-Abgleich (Doc vs. Plane vs. Code/Live) — **DoD 3/3 bestätigt, 100 %**: - **Live nachgemessen:** `staging-app.hivegrid.de` (ehem. `staging-web`) + `staging-api.hivegrid.de` → `/healthz` + `/readyz` = 200; `X-Robots-Tag: noindex, nofollow` live auf `/login`. - **Code:** `apps/web/app/utils/seo/noindex.server.ts` + `entry.server.tsx` (`WEB_NOINDEX`-Gate), `public/robots.txt` statisch — auf `main` vorhanden. - **Pipeline:** Live-Revision auf Staging = `6616cfc3a` (aktueller `main`-Stand zum Audit-Zeitpunkt) → CI rollt weiterhin automatisch aus. - **Plane:** Status Done (20.06.), Kommentare deckungsgleich mit dieser Doc. - **Korrigierter Drift:** Status-Header stand fälschlich auf „geplant" (→ Done), Hostname `staging-web` veraltet (→ `staging-app`, s. Hinweis oben), Owner-Zeile präzisiert (Plane-Assignee 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) - `AGENTS.md` → Estate-Infrastruktur und Deploy-Vertrag - `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)