# Визуальные гайды test-контура {#overview}

Пошаговые инструкции со **скриншотами** реального UI песочницы: Gitea CI, ArgoCD, Grafana, Prometheus и Loki.

Перед просмотром добавьте в `/etc/hosts` IP VM (см. `./scripts/print-urls.sh`):

```
192.168.252.2 git.sova.local argocd.sova.local grafana.sova.local prometheus.sova.local docs.sova.local
```

## Разделы

| Гайд | О чём |
|------|--------|
| [Gitea: теги и CI/CD](./gitea-ci) | push тега → Actions → registry → deploy-gitops |
| [ArgoCD: приложения](./argocd) | Applications, sync, backend vs sova-root vs data-test |
| [Grafana, Prometheus, Loki](./monitoring) | метрики, targets, логи в Explore |

## Обновление скриншотов

Скрины лежат в [`../screenshots/`](../screenshots/). Переснять после изменений UI:

```bash
cd k3s-test
./scripts/capture-platform-screenshots/run.sh
cd sova-docs && npm run build   # локальная проверка
```

Скрипт использует Playwright и логинится в сервисы test-контура автоматически (креды из `.generated/platform-credentials.env` и kubectl).