Per-service docs (Vrstva 2)
Každá služba má vlastní složku s docs. Pro strojově čitelná metadata viz catalog/services/<name>.yaml — tato složka obsahuje lidsky čitelný kontext pro práci na dané službě.
Struktura per-service
Minimum:
- INDEX.md — one-pager: stack, deps, URL, kde je repo, kde jsou secrets, key facts. První co čtu, když začnu pracovat na službě.
Rozšířená (pro služby s bohatým ops obsahem):
- ops.md — deploy, restart, HC, troubleshoot recepty
- architecture.md — detail technické architektury (jen pokud je netriviální)
- decisions.md — per-service ADR
- history.md — incident log, deploy poznámky
Aplikační služby
| Služba |
Owner |
Status |
Hub |
Prod |
| billit |
billit |
running |
s60hub.cz |
billit.cz |
| pulse |
pulse |
running |
s60hub.cz |
pulselab.cz |
| auth |
auth |
running |
auth.s60hub.cz |
auth.studio60.cz |
| badwolf |
badwolf |
running |
api.s60hub.cz |
be.studio60.cz |
| mail |
mail |
stopped |
— |
— (Resend domain pending) |
| cs |
cs |
running |
(Cortex) |
(Cortex) |
| venom |
venom |
running |
venom.s60hub.cz |
— |
| nexus |
nexus |
development |
— |
— |
| vaultwarden |
sentinel |
running |
— (single-env) |
pass.studio60.cz |
Workflow / orchestration
| Služba |
Owner |
Účel |
| n8n |
infra |
Workflow automatizace (queue mode + Redis) |
| telegram |
sentinel |
Relay → Telegram bridge pro Libora |
Infrastructure-as-service
| Služba |
Owner |
Účel |
| nginx |
infra |
Reverse proxy, SSL termination |
| redis |
infra |
Cache, queues (BullMQ), pub/sub |
| postgres-managed |
infra |
DO Managed PG (deprecated, v migraci na pg-alfa) |
Monitoring
| Služba |
Owner |
Účel |
| glitchtip |
sentinel |
Error tracking (Sentry-compat) |
| uptime-kuma |
sentinel |
Status page + HTTP checks |
| metrics |
sentinel |
Lightweight server metrics (SQLite) |
SDKs & shared
| Služba |
Owner |
Účel |
| s60authsdk |
auth |
@s60/auth-sdk (JwtAuthGuard, Redis blacklist) |
| s60-agent-runtime |
kaizen |
Runner API + relay infra (sentinel se nedotýká) |
CMS / Web (legacy + nové)
Specializované služby
Konvence
- Tier 1 docs (full ops + architecture): služby na kterých sentinel intenzivně pracuje (billit, pulse, n8n, auth, badwolf)
- Tier 2 docs (INDEX only): aktivní služby s nízkou ops zátěží na sentinel
- Tier 3 docs (skeleton): periferní / legacy / dosud nezdokumentované — odkaz na catalog yaml + repo
Doplňování je lazy — když pracujeme na službě a INDEX není dostatečný, dopíšeme to.