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

@@ -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)

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
```