Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-INFRA1.md
T

5.6 KiB

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

  • 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). (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)