---
type: infra-requirements
work_item_id: ET-002
title: "Инфраструктурные требования — ET-002: Чекбокс показа/скрытия POI"
version: 1
status: approved
created_at: 2026-05-21
authors:
  - "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` не требуется.
