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

4.5 KiB

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

  • 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.)
  • Coolify-managed Postgres + Redis + PgBouncer erreichbar — Postgres/Redis Coolify running:healthy, pooled DB-Pfad via /readyz 200 belegt
  • 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)