# AGENTS.md

## Projekt
Jídelníček menzy Troja jako statický web na Kubernetes. Python 3.12, uv.
CI na GitLabu každý den stránku vygeneruje a nasadí. Claude běží jen lokálně, nikdy v CI.

## Rozhraní (měnit jen po domluvě s člověkem)
- `uv run menza.py --html public/` zapíše `public/index.html` (+ případné další soubory, bez podadresářů)
- `public/` celkem < 900 KiB (nasazuje se jako ConfigMap, limit 1 MiB)
  → grafy jako inline SVG, nebo knihovna z CDN
- Závislosti jen v PEP 723 hlavičce `menza.py` (`uv add --script menza.py ...`)
- Data z API jsou nedůvěryhodná → v HTML vždy escapovat
- Obsah a formát stránky vlastní `web`; CI na nich nesmí záviset (nasazení ověř porovnáním celého `index.html`)

## Kdo co vlastní
- worktree `web`: `menza.py`, `templates/`, `static/`
- worktree `ci`: `.gitlab-ci.yml`, `k8s/`
- `AGENTS.md` a `.claude/` mění jen člověk

## Cluster (kuba-cluster, CERIT-SC)
- namespace `<prijmeni>-ns`, adresa https://menza-<login>.dyn.cloud.e-infra.cz
  (před `.dyn.cloud.e-infra.cz` smí být jen jeden label)
- Pod Security "restricted": runAsNonRoot, capabilities drop ALL, seccomp RuntimeDefault, port > 1024
- web = `nginxinc/nginx-unprivileged` (port 8080, UID 101), obsah z ConfigMap;
  vlastní image ne (GitLab nemá registry)
- ven přes Gateway API: `HTTPRoute` na `traefik-gateway` (namespace `kube-system`),
  sekce `websecure` + druhá route na sekci `web` s přesměrováním na https; ne Ingress
- CI: server `https://rancher.cloud.e-infra.cz/k8s/clusters/c-m-qvndqhf6`, token v `$KUBE_TOKEN`
  (Rancher API klíč; token ServiceAccountu Rancher nepřijme)
- deploy jen z `master` a z plánované pipeline

## Příkazy
- Stránka: `uv run menza.py --html public/`
- Náhled: `uv run python -m http.server -d public` → http://localhost:8000
- Cluster: `kubectl get/describe/logs -n <prijmeni>-ns`
- Manifesty ověř: `kubectl apply --dry-run=server -n <prijmeni>-ns -f k8s/`
  (skutečně nasazuje CI z `master`; ručně jen se souhlasem člověka)

## Git a review
- Pracuj jen na své větvi ve svém worktree, nikdy do `master`
- Hotovo = náhled funguje, commit, push, `glab mr create --draft --fill --yes`
- Review: spusť `claude -p --model opus --settings .claude/settings.json "/code-review medium !<číslo MR> --comment"`
  přesně takto, bez prefixů (oprava pro Git Bash je v `.claude/settings.json`);
  trvá několik minut: timeout 10 min, nebo na pozadí a počkej na dokončení
- Ověř `glab mr view <číslo> --comments`, že komentář reviewera v MR je; když chybí, spusť review znovu
- Pak oprav nálezy (jedno kolo), na ostatní odpověz v MR
  proč ne, push, `glab mr update <číslo> --ready --reviewer <nick>`. Merge dělá člověk.

## Nikdy
- merge, push do `master`, `git push --force`, `kubectl delete`
- číst `~/.kube/`, psát tokeny do souborů, commitů nebo promptů
