| Úkol | dev | stage/prod (VPS / Arcane) |
|---|
| Stav služeb | docker compose -p lift-dev ps | docker compose -p lift-prod ps |
| Logy | make logs [SERVICE=api] | docker compose -p lift-prod logs -f app |
| Zdraví | curl localhost:8001/api/health/ready | curl https://lift.vytahy1.cz/api/health |
| Migrace | make migrate | automaticky (migrate), ručně docker compose … run --rm migrate |
| Restart | make dev | Arcane: restart projektu |
/api/health – verze, commit, prostředí (liveness); /api/health/ready – včetně DB.
- Logy jdou na stdout bez hesel, tokenů a e-mailových adres; rotace Dockerem (json-file).
- Auditní log: tabulka
audit_events (akce, aktér, cíl, IP, čas).
- Plánovač loguje každý průchod (
Plánovač: eskalováno …).
Časté problémy
| Příznak | Příčina a řešení |
|---|
| Aplikace nenastartuje, „Nebezpečná nebo neúplná konfigurace“ | doplňte proměnné podle hlášky (deploy/*.env.example) |
app čeká na migrate | docker compose logs migrate – chyba migrace |
| Neodchází e-maily | stage: Mailpit; prod: SMTP údaje a SPF/DKIM/DMARC domény |
| PDF protokol selže | v obrazu chybí písmo – make build obsahuje kouřový test |
| Port 8000 obsazený (dev) | nastavte API_PORT v .env (výchozí 8001) |
Doporučení pro DNS e-mailu (produkce)
SPF záznam s odesílajícím SMTP poskytovatelem, DKIM podle poskytovatele, DMARC alespoň
p=quarantine s reportováním. Nastavuje uživatel ručně.