Files
0pt/docs/compliance/EVIDENCE/health.md
T
admin 0386d82c49
CI (SIAX Cloud) / integration (push) Skipped
CI (SIAX Cloud) / sonar (push) Skipped
masterplan-lock / check (push) Successful in 7s
CI (SIAX Cloud) / sonar (pull_request) Skipped
CI (SIAX Cloud) / security (push) Successful in 17s
Security Scan (SIAX Cloud) / security (push) Successful in 18s
Security Scan (SIAX Cloud) / security (pull_request) Successful in 28s
masterplan-lock / check (pull_request) Successful in 28s
CI (SIAX Cloud) / security (pull_request) Successful in 29s
CI (SIAX Cloud) / integration (pull_request) Successful in 37s
CI (SIAX Cloud) / quality (push) Successful in 1m8s
CI (SIAX Cloud) / quality (pull_request) Successful in 1m0s
fix(health): engine-kollen ärlig (not_configured när URL saknas) + EVIDENCE-docs mot Coolify-verkligheten
2026-09-30 10:08:25 +02:00

3.6 KiB
Raw Blame History

EVIDENCE — FAS 8 · /api/health + dependencies

Live-prober + källanalys 2026-09-30 (VERIFIERAT mot prod). Ersätter den gamla Vercel-mätningen (2026-08-10) — 0pt.app är inte längre på Vercel.

Prod-topologi (Coolify, inte Vercel)

0pt.app = kanonisk prod via Coolify på cloud.siax.io, deployad av .gitea/workflows/cd.yml vid varje merge till main (repo-secret COOLIFY_TOKEN, repo-variable COOLIFY_APP_ID — riktig UUID, guarden passerar; se docs/architecture/decisions/0001-deploy-target-coolify-not-vercel.md). Inga Vercel-referenser är längre aktuella för prod.

Live (0pt.app, prod — mätt 2026-09-30 08:0x UTC)

GET https://0pt.app/api/health -> 200
{"ok":false,"service":"0pt-web","db":"ok","queue":"not_configured",
 "engine":"error","stripe":"not_configured",
 "detail":{"engine":"This operation was aborted"},
 "ts":"2026-09-30T08:05:32.935Z"}

GET https://0pt.app/admin      -> 200
GET https://0pt.app/api/orders -> 401 fail-closed (OPT_UNAUTHENTICATED)

Hälsokontraktet ljuger inte: ok:false speglar en verkligt degraderad beroendekoll (engine:error), db är på riktigt ok och authen fail-close:ar. Vad som återstår är att åtgärda orsaken, inte att måla grönt (se nedan).

Engine-kollens rotorsak — konfig, inte kod

  • lib/health-checks.ts#checkEngine gör en riktig HTTP-roundtrip mot ${ENGINE_URL}/health (AbortController, 2 s timeout). Kontraktet: not_configured när ENGINE_URL ej är satt; error när den ÄR satt men misslyckas (t.ex. abort/non-2xx); ok först vid lyckad roundtrip.
  • Prod-symptomet "This operation was aborted" = timeout-aborten mot en oprovisionerad host: ENGINE_URL pekar på http://0pt-engine:8000, ett namn utan DNS-post i flottan (mätt 2026-09-25 och åter 09-30; ingen sådan container på server5–11).
  • Infisical /0pt (prod): 0 nycklar matcher ENGINE_URL (räknat 2026-09-30 via siax-secrets export --env prod --path /0pt). Värdet sitter alltså i Coolify-appens egen env, inte i valvet.
  • Beslut per konvention: kollen är redan ärlig och icke-blockerande när motorn ej provisionerats — ENGINE_URL borttaget ⇒ engine:"not_configured" och ok:true, utan kodändring. Sålänge URL:en är satt men död är error den korrekta, ärliga statusen. Regressionstest finns i tests/lib/health-checks.test.ts (unset → not_configured; satt+abort → error med abort-meddelandet i detail).
  • Åtgärd (konfig, Simon-gate): ta bort ENGINE_URL (och ev. oanvänd INTERNAL_TOKEN för motorn) från Coolify-appens env → omdeploy. Tills FastAPI-motorn (services/api) faktiskt provisioneras ska ingen ENGINE_URL finnas i prod.

Källkod (app/api/health/route.ts + lib/health-checks.ts)

  • Routen är liveness: alltid 200 så länge processen svarar. Bodyns ok är den ärliga signalen: false när en konfigurerad dependency fail:ar.
  • Per-dependency: ok | error (med detail) | not_configured | not_integrated (endast queue/REDIS_URL — ingen Redis-klient wired i repot; aldrig fabricerad ok).
  • Readiness (/api/ready) fail-close:ar på db != ok och på varje error — konfigurerad-men-död räknas inte som "valfri".

Simon-gates (ej agent-verifierbara)

Inloggad journey (admin-portalens E2E) och kanarie-identitet (beställd kanarieorder spårad end-to-end) kräver Simons inloggning och stäms separat — omfattas ej av denna mätning.

Historik

2026-08-10 mättes 0pt.app på Vercel ({"ok":true,"db":"not_configured",...} hardcoded-grönt — BACKLOG P0-3, sedan fixat). Den deploymenten är inaktuell; alla prod-utsagor i denna fil gäller Coolify-cutovern.