enduro-trails/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file. Format: Keep a Changelog

[Unreleased]

Changed

• ET-012: Слой публичных GPS-треков теперь виден с зума z=5 (раньше — с z=8). Калибровка существующей tier-структуры build_gps_mvt/_simplify_coords (ADR-016): для z≤5 фильтр min_length=10 км, limit=1500; для z=6 — 5 км/2000; для z=7 — без изменений (2 км/3000). DP-tolerance расширен парой стопов: z=6 → 0.018° (~2 км), z≤5 → 0.04° (~4 км). На клиенте константа GPS_TRACKS_MIN_ZOOM понижена до 5; line-width/halo-stops в MapLibre получили stop на z=5 (0.8/1.8 px), hint обновлён с «Зум 8+» на «Зум 5+». Контракт API /api/gps-tracks/tiles/{z}/{x}/{y}.mvt не изменился (REQ-F-15); z≥8 не затронут (регрессия). Тесты: 18 unit zoom-tier+simplify, 9 integration endpoint z5-z7, 2 perf (PERF-Z5-01/02; avg ~64 мс, p95 ~89 мс при 500 треках — ниже бюджета 200 мс/500 мс по M-6). Refs: ET-012.

[v0.0.5] — 2026-06-04

Деплой задеплоен на test (https://openclaw.mva154.duckdns.org/enduro/). Healthcheck + smoke PASS. См. docs/work-items/ET-013/14-deploy-log.md.

Added

• ET-013: Zoom-aware paint для terrain-слоёв hillshade и tri (Terrain Ruggedness Index) на z9-z11. UI-минзум hillshade понижен с 10 до 9; raster-paint обоих слоёв переведён в zoom-aware форму через MapLibre interpolate. На z9-z11 — пик raster-opacity/raster-contrast (видимость рельефа сопоставима с z8); на z12-z14 — возврат к исходным значениям (регрессия по AC-10). TRI на z8 сохранил opacity 0.70 (регрессия по AC-06), пик 0.80-0.85 на z9-z11. Файлы: src/web/app.js (константы HILLSHADE_PAINT / TRI_PAINT, applyTerrainLayer расширена для поддержки object-paint, обратно-совместимо), src/web/index.html. Тесты: 17 unit tests/unit/test_terrain_paint.py (валидация interpolate-stops, инварианты opacity/contrast по zoom), 6 integration tests/integration/test_terrain_z9_tiles.py ((hillshade, tri) × (z9, z10, z11)). ADR-017. Refs: ET-013.
• ET-013 (review F-1 fix): Слой tri добавлен в whitelist FastAPI-endpoint'а GET /terrain/{layer}/{z}/{x}/{y}.png (src/api/main.py). На test/prod-среде nginx перехватывает /enduro/terrain/* и отдаёт PNG напрямую с диска, но в dev-режиме (make dev → FastAPI на :5556 без nginx) endpoint должен поддерживать tri нативно. Изменение аддитивное: ответ-контракт и заголовки идентичны существующим слоям (hypso, hillshade); REQ-F-18 «API contract без изменений» не нарушен. Регрессия: integration-тест test_known_terrain_layer_accepted_by_whitelist параметризован по (hypso, hillshade, tri) и проверяет, что для заведомо отсутствующего файла возвращается detail: "Tile not found", а не "Unknown layer". Refs: ET-013, review F-1.

Changed

• ET-013 (review F-2 fix): Integration-тест tests/integration/test_terrain_z9_tiles.py параметризован по (layer ∈ {hillshade, tri}) × (zoom ∈ {9, 10, 11}) — 6 кейсов вместо 3, покрывает оба слоя на расширенном диапазоне зумов (ранее покрывался только hillshade). Refs: ET-013, review F-2.

[v0.0.4] — 2026-06-04 (tagged earlier, deploy log pending)

Тег v0.0.4 создан в рамках ET-012 deploy, но 14-deploy-log пишется в отдельном PR deploy/ET-012-v0.0.4-log (см. PR #25). Артефакты ET-012 живут под [Unreleased] до закрытия того PR — не трогаю.

[v0.0.3] — 2026-06-03 (tagged, NOT deployed)

⚠️ Тег создан и запушен, PR смерджен в main, но docker-образ на test не задеплоен: deploy-hook /home/slin/bin/enduro-deploy-hook.sh упал на Permission denied при записи в /var/log/enduro-trails/ (каталог root-owned, у slin нет права записи и нет NOPASSWD sudo). Подробности и инструкция для ops: docs/work-items/ET-011/14-deploy-log.md.

Added

• ET-011: Скачивание GPX из popup публичного трека. Новый эндпоинт GET /api/gps-tracks/{track_id}/download собирает GPX 1.1 из геометрии трека и отдаёт с Content-Disposition: attachment (UTF-8 имя файла по RFC 5987). В popup на карте появилась кнопка «Скачать GPX» (32×32 CSS px, mobile-friendly). Реализация: новый модуль src/api/gps_tracks/export.py (build_gpx, safe_filename); расширение config/gps_sources.yaml per-source флагом download_allowed (default-deny; MVP whitelist = osm, см. ADR-015); helper load_download_allowed_sources в config.py. Тесты: 13 unit GPX-builder + 10 unit filename + 11 integration download. ADR-014, ADR-015. Refs: ET-011.

[v0.0.2] — 2026-06-02

Added

• ET-009: Активация GPS-источников EnduroRussia и Wikiloc — config/gps_sources.yaml включает оба источника (enabled: true), для Wikiloc добавлен soft-cap max_tracks_per_run: 50 и activity-фильтр; config/gps_regions.yaml подписывает wikiloc на регион tsfo_plus_chuvashia. Парсер wikiloc.py извлекает время из GPX-metadata (для корректной дедупликации) и поддерживает max_tracks_per_run cap. UI: цвет wikiloc, чекбокс источника, динамическая атрибуция (GPS_SOURCE_ATTRIBUTIONS) подтягивается с /api/gps-tracks/health. Тесты: 10 unit ER + 10 unit WL + 5 integration + 2 contract (nightly only). PR #16, tag v0.0.2.

Fixed

• ET-009: исправлен URL enduro_russia в config/gps_sources.yaml (https://enduro-russia.ru → https://endurorussia.ru, без дефиса).

[v0.0.1] — 2026-06-01

Added

• ET-008: GPS-треки с публичных платформ на карте — новый модуль src/web/gps_tracks.js с отображением публичных GPS-треков (OSM Traces, enduro_russia, ttrails) в виде MVT-тайлов (z 8–11) и GeoJSON (z ≥ 12); фильтрация по активности и источнику, попап с мета-данными трека, z-order ниже личных GPX-треков (AC-10). Backend: FastAPI-пакет src/api/gps_tracks/ (endpoint, MVT, LRU-кэш, дедупликация), миграция migrations/gps_tracks_001_init.sql, pipeline-скрипт scripts/gps_collect.py, Docker-сервис gps-collector. PR #12, tag v0.0.1.

[Unreleased]

• Initial project structure
• CLAUDE.md project passport
• Agent system prompts (architect, developer, reviewer, tester, deployer)
• CI pipeline (Gitea Actions)
• Docker configuration
• ET-002: чекбокс «POI» в попапе рельефа — показ/скрытие маркеров POI с сохранением состояния в localStorage (ключ poi-visible)
• ET-005: переключатель единиц измерения расстояний (км/мили) в попапе рельефа — новый модуль src/web/units.js с централизованным форматтером Units.formatDistance(); выбор сохраняется в localStorage (ключ distance_unit), пересчёт всех видимых расстояний выполняется единым оркестратором по событию unitchange
• ET-006: загрузка и визуализация GPX-треков — новый модуль src/web/gpx.js с клиентским парсингом GPX 1.1 (DOMParser, чанковая конвертация), отрисовкой треков и waypoints на карте, панелью #sheet-gpx со списком треков, статистикой и canvas-профилем высот; GPX-слои восстанавливаются после смены стиля карты через rebuildMapOverlays(). Данные треков хранятся только в памяти сессии