Files
enduro-trails/docs/work-items/ET-002/07-infra-requirements.md
claude-bot af579f7f2a
All checks were successful
CI / lint (push) Successful in 4s
CI / test (push) Successful in 4s
CI / build (push) Successful in 3s
docs(ET-002): add ADR-0001 and infra requirements for POI toggle
Record architecture decision to implement POI visibility toggling
client-side (setLayoutProperty + localStorage), reusing the existing
layerState model, with no backend, DB or infrastructure changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-21 14:51:37 +00:00

4.2 KiB

type, work_item_id, title, version, status, created_at, authors
type work_item_id title version status created_at authors
infra-requirements ET-002 Инфраструктурные требования — ET-002: Чекбокс показа/скрытия POI 1 approved 2026-05-21
agent:architect

Инфраструктурные требования — ET-002

1. Резюме

ET-002 — изменение исключительно фронтенда (src/web/index.html, src/web/app.js). Новой инфраструктуры не требуется. Документ зафиксирован для полноты work-item и явно подтверждает отсутствие инфра-воздействия (см. ADR-0001).

2. Контейнеры и сервисы

Аспект Требование
Новые контейнеры Нет
Изменения существующих сервисов (api, osrm, nginx) Нет
Изменения docker-compose.yml Нет
Изменения Dockerfile Нет

3. Сеть

Аспект Требование
Новые порты Нет
Изменения reverse proxy (nginx, /enduro/) Нет
Новые внешние домены / DNS Нет
Исходящие сетевые вызовы из фронтенда Нет (вся логика локальная)

4. Хранилища данных

Аспект Требование
Изменения схемы SQLite/Spatialite Нет
Миграции БД (migrations/) Нет
Серверное хранилище состояния Нет
Клиентское хранилище localStorage, ключ poi-visible ('1'/'0'), ≈ 1 байт полезной нагрузки на браузер

5. Конфигурация и секреты

Аспект Требование
Новые переменные окружения Нет
Новые секреты Нет
Изменения конфигурации FastAPI / uvicorn Нет

6. Зависимости

Аспект Требование
Новые npm/Python пакеты Нет
Новые внешние сервисы Нет
Версия MapLibre GL JS Без изменений (setLayoutProperty — штатный API)

7. Сборка и деплой

  • Pipeline: существующий Gitea Actions без изменений (lint, test, build).
  • Артефакт: статические ассеты фронтенда (src/web/). Деплой — штатная пересборка/перевыкладка и docker compose up -d на mva154.
  • Простой (downtime): нет — изменение только в статике фронтенда.
  • План отката: обратный коммит (revert) и повторный деплой; миграций/состояния, требующих отдельного отката, нет.

8. Ресурсы (CPU / RAM / диск)

Воздействие отсутствует. Переключение layout.visibility слоёв выполняется в браузере клиента; тайлы не перезапрашиваются (REQ-NF-01).

9. Наблюдаемость

Новые метрики, логи и алерты не требуются. Поведение проверяется e2e-тестами фронтенда согласно 04-test-plan.yaml.

10. Влияние на C4

Состав компонентов системы не меняется. Обновление docs/architecture/c4-*.mmd не требуется (диаграммы C4 в репозитории на данный момент отсутствуют — только docs/architecture/README.md).

11. Вывод

Инфраструктурных, сетевых, конфигурационных изменений и изменений БД нет. ET-002 безопасен для деплоя в рамках обычного релизного цикла фронтенда. Эскалация arch:major-change не требуется.