---
type: acceptance-criteria
work_item_id: ET-009
title: "Acceptance Criteria: Новые источники GPS-треков — EnduroRussia и Wikiloc"
version: 1
status: draft
created_at: 2026-06-01
updated_at: 2026-06-01
authors:
  - "agent:analyst"
---

# Acceptance Criteria — ET-009

Критерии формализованы в Gherkin-стиле. Все критерии — обязательные;
задача считается принятой, когда **каждый** прошёл проверку в
test-среде или в автоматическом тестовом запуске CI.

## AC-01 — Конфиг EnduroRussia исправлен и активирован

**Given** запись `enduro_russia` в `config/gps_sources.yaml`
**When** работа ET-009 завершена
**Then**:
- `base_url` равно `https://endurorussia.ru` (без дефиса);
- `enabled` равно `true`;
- `license_adr` указывает на существующий файл с `status: accepted`;
- `rate_limit_sec` ≥ 5.

## AC-02 — Конфиг Wikiloc добавлен

**Given** `config/gps_sources.yaml`
**When** работа ET-009 завершена
**Then** существует запись с `id: wikiloc`, в которой:
- `enabled: true`;
- `base_url: https://www.wikiloc.com`;
- `rate_limit_sec: 10`;
- `license_adr: docs/work-items/ET-008/06-adr/ADR-012-wikiloc-licensing.md`;
- `parser_module: src.api.gps_tracks.sources.wikiloc`;
- `save_user_field: false`;
- `attribution: "© Wikiloc contributors"`;
- задано `max_tracks_per_run` (любое целое > 0; для MVP — 50).

## AC-03 — Wikiloc подписан на регион ЦФО+Чувашия

**Given** `config/gps_regions.yaml`
**When** работа ET-009 завершена
**Then** запись `tsfo_plus_chuvashia.sources` содержит элемент `wikiloc`.
`enduro_russia` в этом списке уже был и остаётся.

## AC-04 — Pipeline licensing-guard прозрачно работает

**Given** `scripts/gps_collect.py` и ADR-010 со `status: accepted`
**When** оператор запускает `python scripts/gps_collect.py --region tsfo_plus_chuvashia --source enduro_russia`
**Then** в логах нет сообщения `skipped_license`, в `pipeline_runs`
последняя запись имеет `status` ∈ `{ok, partial}`, не `skipped_license`.

**And given** искусственная подмена `status: accepted` на `status: proposed` в копии ADR-010
**When** запуск pipeline с этим путём
**Then** `pipeline_runs[-1].status == 'skipped_license'`, exit-code 1.

## AC-05 — Unit-тесты EnduroRussia зелёные

**Given** ветка `feature/ET-009-…` с коммитом изменений
**When** CI запускает `pytest tests/unit/test_gps_tracks_enduro_russia.py -v`
**Then** все тесты UT-ER-01..UT-ER-08 проходят, exit-code 0.

## AC-06 — Unit-тесты Wikiloc зелёные

**Given** та же ветка
**When** CI запускает `pytest tests/unit/test_gps_tracks_wikiloc.py -v`
**Then** все тесты UT-WL-01..UT-WL-10 проходят, exit-code 0.

## AC-07 — Integration-тесты pipeline зелёные

**Given** ветка
**When** CI запускает `pytest tests/integration/test_pipeline_et009.py -v`
**Then** все тесты IT-ER-01, IT-WL-01, IT-WL-02, IT-DEDUP-01, IT-LIC-01
проходят.

## AC-08 — Тестовые фикстуры существуют в репо

**Given** репо после слияния
**When** проверка файлов
**Then** следующие файлы существуют и не пустые:
- `tests/fixtures/gps-tracks/enduro-russia-api-tracks-page1.json`
- `tests/fixtures/gps-tracks/enduro-russia-track-1.gpx` (≥ 10 trkpt)
- `tests/fixtures/gps-tracks/enduro-russia-track-2.gpx` (пустой)
- `tests/fixtures/gps-tracks/enduro-russia-track-3.gpx` (вне bbox)
- `tests/fixtures/gps-tracks/wikiloc-search-page1.html` (≥ 5 ссылок на треки)
- `tests/fixtures/gps-tracks/wikiloc-trail-page.html`
- `tests/fixtures/gps-tracks/wikiloc-track.gpx`

## AC-09 — Первый продакшн-прогон EnduroRussia

**Given** mva154, ветка смерджена в main, deploy выполнен
**When** оператор выполняет
```
python scripts/gps_collect.py --region tsfo_plus_chuvashia --source enduro_russia
```
**Then**:
- exit-code 0;
- последняя запись `pipeline_runs` имеет `region_id='tsfo_plus_chuvashia'`,
  `source_id='enduro_russia'`, `status='ok'` или `'partial'`;
- `tracks_new + tracks_updated ≥ 200`;
- `errors_json IS NULL` или содержит ≤ 5% от tracks_new;
- длительность ≤ 45 минут.

## AC-10 — Первый продакшн-прогон Wikiloc

**Given** mva154 и активированный `wikiloc`
**When** оператор выполняет
```
python scripts/gps_collect.py --region tsfo_plus_chuvashia --source wikiloc
```
**Then**:
- exit-code 0 (graceful-stop приемлем);
- последняя запись `pipeline_runs` имеет `status` ∈ `{ok, partial, rate_limited}`;
- `tracks_new + tracks_updated ≥ 1` (любое ненулевое — успех; ограничение `max_tracks_per_run=50`).

## AC-11 — API возвращает новые источники

**Given** БД после двух прогонов AC-09 + AC-10
**When** клиент делает `GET /api/gps-tracks?bbox=37.0,55.0,38.0,56.0`
**Then** в ответе:
- статус 200;
- в `FeatureCollection.features[].properties.sources` встречаются строки
  `"enduro_russia"` и/или `"wikiloc"` (для разных треков);
- ни одна feature не имеет в `sources` значение `"enduro-russia"`
  (с дефисом) или другую опечатку.

## AC-12 — Health-эндпоинт показывает новые источники

**Given** БД после прогонов
**When** клиент делает `GET /api/gps-tracks/health`
**Then** в ответе:
- статус 200;
- поле `tracks_by_source` содержит ключи `enduro_russia` и `wikiloc`
  с числовыми значениями ≥ 1.

## AC-13 — Dedup-merge работает между источниками

**Given** БД после прогонов
**When** SQL-запрос:
```sql
SELECT id, sources_json FROM tracks
WHERE sources_json LIKE '%enduro_russia%'
  AND (sources_json LIKE '%wikiloc%' OR sources_json LIKE '%osm%');
```
**Then** возвращается ≥ 1 строка (хотя бы один трек попал в БД из ≥ 2
источников и был объединён по dedup-key).

**Note.** Если для данного снимка БД таких пересечений нет физически
(маловероятно при ≥ 200 треков EnduroRussia), AC-13 проверяется
синтетически через integration-тест IT-DEDUP-01 и считается покрытым.

## AC-14 — Стили карты содержат цвета новых источников

**Given** `src/web/style.json` и `src/web/style-dark.json`
**When** работа ET-009 завершена
**Then** в `paint.line-color` слоя для публичных треков (имя слоя по
ET-008 — `gps-tracks-layer` или эквивалент) match-expression
содержит ключи `osm`, `enduro_russia`, `wikiloc` с присвоенными цветами,
и есть fallback-значение по умолчанию.

## AC-15 — Атрибуция отображается в UI

**Given** в БД есть треки из всех трёх источников
**When** пользователь открывает страницу, включает «Публичные треки»,
ждёт 3 сек
**Then** в строке атрибуции MapLibre (правый нижний угол) видны:
- «© OpenStreetMap contributors (ODbL)»;
- «EnduroRussia.ru»;
- «© Wikiloc contributors».

## AC-16 — UI-фильтр источников показывает 3 чекбокса

**Given** в БД есть треки трёх источников
**When** пользователь открывает `#sheet-gps-filters`
**Then** в секции «ИСТОЧНИК» (`#gps-source-grid`) видны минимум три
чекбокса с подписями «OSM», «EnduroRussia», «Wikiloc». По умолчанию
все установлены.

## AC-17 — Снятие галки источника убирает соответствующие линии

**Given** включён слой и видны треки трёх источников
**When** пользователь снимает галку «EnduroRussia» в фильтре
**Then** через ≤ 200 мс на карте все линии цвета `enduro_russia` (или
все треки с этим источником в `properties.sources`) исчезают; OSM и
Wikiloc остаются.

## AC-18 — Документация work item полная

**Given** репо после слияния ET-009
**When** проверка `docs/work-items/ET-009/`
**Then** существуют:
- `00-business-request.md`
- `01-brd.md`
- `02-trz.md`
- `03-acceptance-criteria.md`
- `04-test-plan.yaml`
- `04b-ui-test-cases.md`
- `13-test-report.md` (после Тестирования)
- `14-deploy-log.md` (после Деплоя)

## AC-19 — Регрессия ET-008 не сломана

**Given** все существующие e2e-тесты ET-008
**When** CI прогоняет `pytest tests/e2e/ -v` (или соответствующий
маркер)
**Then** все тесты ET-008 (E-01..E-41 из `docs/work-items/ET-008/04-test-plan.yaml`)
проходят без регрессий, как и до ET-009.

## AC-20 — Производительность endpoint не деградировала

**Given** БД с треками после ET-009 (новые источники добавлены)
**When** нагрузочный тест 100 запросов `GET /api/gps-tracks?bbox=…` на
z=10 с 500 треков в bbox
**Then** p95 latency ≤ 300 мс (не выше, чем baseline ET-008).
