LigmaBa LLs — проектная документация

«Находка для рыбака»: карта водоёмов Москвы и Московской области, Fishing Index, сообщество и кнопочный помощник «Рыбак AI». Frontend написан на TypeScript/TSX со строгой проверкой типов; npm run typecheck и production-сборка проверяют код через tsc --noEmit. Визуальный стандарт фронтенда — VKUI 8.4.2, светлая и тёмная темы vkCom; проверенные экраны приведены в результатах проверки.

Обычный режим содержит реальный региональный каталог OpenStreetMap: 1621 именованный водоём Москвы и МО: 1617 из снимка PBF 15.10.2026 и четыре полных пограничных объекта из OSM API 16.10.2026. Маркеры получены из полигональной геометрии, прогноз — из Open-Meteo. Снимок включён в backend, чтобы старт не зависел от доступности публичного Overpass. Сетевое обновление и происхождение данных описаны в архитектуре.

Лабораторные работы

• Lab 2: сохранённый чек-лист описывает исходный Hello World.
• Lab 3: состав результата и проверка связывает требования преподавателя с кодом, моделью данных, интерфейсом и демонстрацией.
• Приёмка и сценарий защиты охватывает все UC-01–UC-09, перезапуск с сохранением данных и негативные кейсы.
• Результаты проверки отделяют выполненные проверки от шагов, требующих доступного окружения.

Навигация

1. Анализ задачи и границы MVP
2. Бизнес-требования
3. Use cases
4. Физическая модель данных
5. Архитектура и потоки данных
6. Правила API и OpenAPI
7. Формула Fishing Index 2.0 и границы достоверности
8. Негативные кейсы
9. Roadmap
10. GitHub Project / ветвление
11. Контейнерный запуск

Источники и приоритет решений

Задание преподавателя задаёт критерии лабораторной. Для продукта актуальны зафиксированный PRD reference/LigmaBa_LLs_PRD_v1.0.docx, бизнес-требования и уточнённые контракты в этом репозитории. Бинарные исходники сохранены.

reference/LigmaBa_LLs_Находка_для_рыбака.pptx — ранняя презентация идеи: упоминания платных тарифов, иных погодных провайдеров и свободного AI-чата не задают текущий MVP. В MVP все функции бесплатны, погода поступает только из Open-Meteo, помощник работает кнопками. Реки, реальные платежи, Windy/Yandex-парсеры и влияние уловов на индекс остаются вне MVP.

Lab 3 развивает сохранённый baseline Lab 2. Текущее поведение описано в ARCHITECTURE.md и api/openapi.yaml и проверяется по ACCEPTANCE.md; снимки работающего интерфейса приведены в VERIFICATION.md.

Структура рабочего каталога

LigmaBa_LLs/
├── ligmaba-backend/       # отдельный Git-репозиторий
├── ligmaba-frontend/      # отдельный Git-репозиторий
└── ligmaba-docs/          # этот Git-репозиторий
    └── deploy/           # отслеживаемый Compose для трёх соседних repo

Из ligmaba-docs/deploy скопировать .env.example в .env, заменить демонстрационные значения и выполнить docker compose up --build. Подробности режимов и URL — в инструкции запуска.