# Settlements UI

Версия: 4108a165419e815bc0d050dd281962115590fce9

Редактор границ на React, MobX и MapLibre: 19 городов, 27 районов и округов, 8 областей России. Подробные контуры OpenStreetMap, составные полигоны, редактирование вершин и массовый импорт GeoJSON. Замокан только backend; изменения остаются в памяти вкладки.

## Решения

- Исходная тема sppi-dark: тёмный фон, жёлтые элементы управления и исходные цвета статусов.
- MapLibre получает обычные тайлы OpenStreetMap. Указана атрибуция; массовая загрузка карт и офлайн-кеширование не реализованы.
- Штатные экраны FilesScreen → PolygonsScreen → PolygonEditScreen работают через локальный адаптер контрактов OData и geo-import.
- Импорт сначала проходит проверку и просмотр. Применение переносит только валидные полигоны в основной редактор; повторное применение не создаёт новых копий с тем же importId.
- Standalone-стили собраны в единую область .sppi-dark: исходные цвета, единые SVG-иконки, размер действий 40 px, адаптивные карточки файлов. ResizeObserver синхронизирует MapLibre с изменениями панелей и экрана.
- Контуры OpenStreetMap упрощены с сохранением топологии: 54 территории, 21 421 вершина, 7 MultiPolygon. Области, районы и города имеют разную прозрачность; исходные цвета управления и статусов сохранены.

## Проверки

- Опубликованная версия 4108a165: 54 именованные территории, пять карточек городов/области/района, поиск и пустой результат; экспорт исходных координат совпадает с набором.
- Массовый импорт 54 территорий: все геометрии валидны. Сохранение составного полигона, пропуск одной территории, применение 53; повторное применение не создаёт дубликатов; экспорт содержит 107 объектов и ссылки на источник.
- Самопересечение блокирует применение. Другая сессия не получает файлы; сброс восстанавливает 54 исходных объекта.
- На контуре Суздаля указателем перемещена вершина. После сохранения изменённая геометрия подтверждена экспортом; остальные 53 объекта не изменились.
- Desktop 1440×1000, мобильные 390×844 и 360×844: нет горизонтального переполнения или ошибок JavaScript. В мобильном редакторе ОКТМО выбранной территории и общие левый/правый края с расхождением не более 1 px.
- Сборка Vite и GitHub CI успешны. Полный legacy TypeScript/lint набор в эту проверку не входит.

## Ограничения

- Только backend заменён памятью вкладки. Серверный OData/PostGIS-сервис не подключён; закрытый исходный репозиторий остаётся приватным.
- Пределы адаптера: 20 файлов, 500 полигонов в файле, 1000 в сессии; текст файла до 5 MB. Поддержаны Polygon/MultiPolygon и EPSG:4326/3857.
- После перезагрузки импортированные данные исчезают. Экспорт GeoJSON позволяет сохранить результат у себя.
- Подложка OpenStreetMap — реальный внешний картографический сервис, её доступность зависит от провайдера.
- Границы OSM упрощены для редактора, не являются кадастровыми данными. Города — контуры place=city/town, районы и области — boundary=administrative; коды ОКТМО учебные. Источник и ODbL указаны в демо и скачиваемом GeoJSON.

## Эксплуатация

- Сборка: src_front, npm ci --ignore-scripts; npm run build:demo. Артефакт собирается в GitHub CI и публикуется как статический релиз Nginx.
- Backend adapter расположен в demo/api.ts и demo/import-api.ts. При подключении настоящего API нужно реализовать контракт применения импорта и заменить локальный транспорт.
- Проверка геометрии использует существующий validation.util.ts; WKB-конвертация — wkx. Пользовательские GeoJSON не отправляются на VPS.
- Перед изменением проследить функцию через экран, ImportRepository, адаптер, геометрию и состояние. После изменения обновить code-map и пройти загрузку, ошибки, пропуск, применение, экспорт и сброс.
- Доработка визуала 7 сентября 2026: CSS подключается после исходных компонентов; специфичность ограничена темой. Текстовые кнопки не получают размер icon-only. На узком экране импорт расположен вертикально; фон страницы блокируется при открытии модального окна. Тайлы OpenStreetMap остаются внешними и могут догружаться при масштабировании.
- Выравнивание 7 сентября 2026: у редактора импорта один контейнер отступов 12 px. Удалены конфликтующие utility-классы и резерв скроллбара у одиночной карточки; footer и ОКТМО используют ту же ширину. Правка ограничена экраном PolygonEditScreen.
- Географический набор: demo/russia-boundaries.json, срез OpenStreetMap от 7 сентября 2026, 11:09:36 UTC. У каждой территории сохранены relation URL, тип, дата и величина упрощения. Производный набор доступен по ODbL через скачивание и экспорт.
- Вычисление bbox учитывает все кольца и части MultiPolygon. При сохранении и импорте bbox пересчитывается. После загрузки карты выбранная территория сохраняет фокус; в редакторе импорта показан её собственный ОКТМО.

## Code-map

| Функция | Экран | Модуль | Проверка |
|---|---|---|---|
| Карта и тема | Главный редактор | src_front/src/demo/config.ts; styles/themes/sppi-dark.scss | MapLibre, OSM, 54 территории и прозрачность вложенных границ |
| Массовая загрузка | Импорт файлов → /geo-import/import | modules/import/screens/FilesScreen.tsx; demo/import-api.ts | GeoJSON, CRS, WKB; файл из 54 реальных контуров |
| Проверка и применение | Список полигонов → /geo-import/files/:id/apply | PolygonsScreen.tsx; ImportRepository; import-api.ts | статусы, пропуск, валидация; 53 применённых, 107 в экспорте |
| Изменение | Изменение полигона → /polygons/:id/save | PolygonEditScreen.tsx; MapImportMapHelper | Mapbox Draw; original/default WKB |
| Изоляция и экспорт | Основной экран | demo/data.ts; demo/Controls.tsx | EventTarget, память вкладки; GeoJSON export и reset |
| Визуальная система | Все экраны и состояния | demo/foundation.css; demo/original-theme.css | SVG masks, поля, кнопки, таблицы; визуальный QA |
| Размер карты | Главный редактор и импорт | utils/observe-map-resize.ts; MapEditor.tsx; MapImport.tsx | ResizeObserver, requestAnimationFrame, cleanup; размеры canvas |
| Слои импорта | Меню подложки | MapImportLayersSwitcher.tsx; map-import.controller.ts | исходная видимость синхронизируется со store; штатный checkbox |
| Отступы редактора импорта | Изменение полигона | PolygonEditScreen.tsx; demo/original-theme.css | import-polygon-editor: общий padding 12 px; координаты полей и кнопок, сохранение |
| Набор и происхождение | Карта / скачать набор | demo/russia-boundaries.json; demo/data.ts | OSM relations, ODbL, учебные ОКТМО, Polygon/MultiPolygon |
| Общая граница | Карточка и карта импорта | geometryBbox; getUnitedPolygons; validatePolygons; MapImport.tsx | bbox всех частей; фокус выбранной территории после загрузки |

Источник границ: [© OpenStreetMap contributors, ODbL](https://www.openstreetmap.org/copyright).
