diff --git a/docs/README.md b/docs/README.md index 803bf59..de267a0 100644 --- a/docs/README.md +++ b/docs/README.md @@ -18,3 +18,24 @@ - [PH-7.barriers](./phases/PH-7.barriers/) — Шлагбаумы, тротуары, слой препятствий - [PH-8.elevation-profile](./phases/PH-8.elevation-profile/) — Профиль высот, режим «Горка» - [PH-9.pwa](./phases/PH-9.pwa/) — Офлайн режим + +## Задачи (Work Items) + +| ID | Название | Статус | Ветка | +|----|----------|--------|-------| +| ET-001 | Слой шлагбаумов | ✅ Done | main | +| ET-002 | POI и маршруты | ✅ Done | main | +| ET-005 | Переключатель единиц | ✅ Done | main | +| ET-006 | Загрузка GPX-треков | ✅ Done | main | +| ET-007 | Спутниковый слой | ✅ Done | main | +| ET-008 | GPS-треки с публичных платформ | ✅ Done | main | + +## Инфраструктура + +- **URL:** https://openclaw.mva154.duckdns.org/enduro/ +- **Host:** mva154 (82.22.50.71) +- **App container:** enduro-trails-app-1 (port 5558) +- **GPS collector:** docker compose --profile batch run --rm gps-collector +- **Deploy:** автоматически через orchestrator deployer (SSH hook) +- **Логи deploy:** /var/log/enduro-trails/deploy-hook.log +- **Pipeline:** Multi-Agent Orchestrator (port 8500) diff --git a/docs/operations/runbook.md b/docs/operations/runbook.md new file mode 100644 index 0000000..d3951d3 --- /dev/null +++ b/docs/operations/runbook.md @@ -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 +```