docs: add operations runbook, update README with work items and infra
Some checks failed
CI / lint (pull_request) Failing after 4s
CI / test (pull_request) Failing after 5s
CI / build (pull_request) Has been skipped

This commit is contained in:
claude-bot
2026-06-01 20:10:02 +03:00
parent e2bf99d05f
commit 37af99eb6b
2 changed files with 71 additions and 0 deletions

View File

@@ -0,0 +1,50 @@
# Runbook: Enduro Trails
## Сервисы
| Сервис | Команда | Порт |
|--------|---------|------|
| App (API + static) | `docker compose up -d app` | 5558 |
| GPS Collector (разовый запуск) | `docker compose --profile batch run --rm gps-collector` | — |
| GPS Collector (с регионом) | `docker compose --profile batch run --rm gps-collector python scripts/gps_collect.py --region tsfo_plus_chuvashia --source osm` | — |
## Deploy
Deploy выполняется автоматически через Multi-Agent Orchestrator.
При ручном деплое:
```bash
cd /home/slin/repos/enduro-trails
git pull origin main
docker compose up -d app
```
## GPS Collector
Первичный сбор треков (ЦФО + Чувашия, OSM):
```bash
cd /home/slin/repos/enduro-trails
nohup docker compose --profile batch run --rm gps-collector python scripts/gps_collect.py --region tsfo_plus_chuvashia --source osm > /tmp/gps-collector.log 2>&1 &
```
Статус:
```bash
tail -f /tmp/gps-collector.log
```
Активация EnduroRussia/ttrails источников — после юридического review ADR-010/ADR-011:
1. Обновить статус ADR до `accepted`
2. Установить `enabled: true` в `config/gps_sources.yaml`
## Healthcheck
```bash
curl -s https://openclaw.mva154.duckdns.org/enduro/api/health
curl -s https://openclaw.mva154.duckdns.org/enduro/api/gps-tracks/health
```
## Логи
```bash
docker logs enduro-trails-app-1 --tail 50
tail -f /var/log/enduro-trails/deploy-hook.log
```