Дорожная карта MVP

[blsssss]

Готово

• Каркас сервиса, CI, Docker (chore(backend): add service skeleton, tooling and CI #1)
• Схема БД, миграции, доменные контракты (feat(db): add schema, migrations and domain contracts #4)
• Вход через MAX, сессии, демо-учётки, OpenAPI-контракт (feat(api): add MAX sign in, sessions and OpenAPI contract #5)
• Общие модули: время, гео, итоги дня, фоновые задачи, загрузка фото (feat(core): add time, geo, totals, background tasks and image uploads #6)

Этап 1. Независимые модули бэкенда (можно делать параллельно)

• [B1] Ориентир калорий, профиль пищевого поведения и ранжирование блюд #7 Движок: ориентир калорий, профиль пищевого поведения, ранжирование
• [B2] Распознавание блюд и меню через ChadGPT #8 Распознавание блюд и меню через ChadGPT
• [B3] Транспорт MAX Bot API: клиент, long polling и вебхук #9 Транспорт MAX Bot API
• [B4] Профиль гостя, согласия, удаление аккаунта и дневник питания #10 Профиль гостя, согласия, удаление аккаунта, дневник
• [B5] Заведения, импорт меню, горящие предложения и каталог #11 Заведения, импорт меню, горящие предложения, каталог

Этап 2. Сборка сценария

• [B6] Рекомендации блюд и обратная связь по предложениям #12 Рекомендации и обратная связь (после [B1] Ориентир калорий, профиль пищевого поведения и ранжирование блюд #7, [B4] Профиль гостя, согласия, удаление аккаунта и дневник питания #10, [B5] Заведения, импорт меню, горящие предложения и каталог #11)
• [B7] Брони, погашение и аналитика заведения #13 Брони, погашение, аналитика (после [B5] Заведения, импорт меню, горящие предложения и каталог #11, [B6] Рекомендации блюд и обратная связь по предложениям #12)
• [B8] Сценарии гостя в чат-боте MAX #14 Бот: сценарии гостя (после [B3] Транспорт MAX Bot API: клиент, long polling и вебхук #9, [B4] Профиль гостя, согласия, удаление аккаунта и дневник питания #10, [B6] Рекомендации блюд и обратная связь по предложениям #12, [B7] Брони, погашение и аналитика заведения #13), ядро бота готово в feat(bot): add bot core, onboarding and diary flows #38
• [B9] Сценарии заведения в чат-боте MAX #15 Бот: сценарии заведения (после [B3] Транспорт MAX Bot API: клиент, long polling и вебхук #9, [B5] Заведения, импорт меню, горящие предложения и каталог #11, [B7] Брони, погашение и аналитика заведения #13)
• [B10] Фоновые задачи и уведомления в MAX #16 Фоновые задачи и уведомления (после [B3] Транспорт MAX Bot API: клиент, long polling и вебхук #9, [B7] Брони, погашение и аналитика заведения #13)
• [B11] Демо-режим и тестовые данные по Казани #17 Демо-режим и тестовые данные по Казани (после [B5] Заведения, импорт меню, горящие предложения и каталог #11, [B7] Брони, погашение и аналитика заведения #13)

Этап 3. Сдача

• [B12] Документация, DATA-API.yaml и материалы для сдачи #18 Документация, DATA-API.yaml, материалы для сдачи
• [B13] Развёртывание на сервере с HTTPS и публикация образов #19 Развёртывание с HTTPS и публикация образов
• [B14] Живые проверки интеграций и чек-лист основного сценария #20 Живые проверки интеграций и чек-лист сценария

Мини-приложение

• [F1] Каркас мини-приложения: React, MAX Bridge, API-клиент и сборка #21 Каркас: React, MAX Bridge, API-клиент, сборка (можно начинать сразу по openapi.yaml)
• [F2] Онбординг гостя: согласия, цель, ориентир калорий и геопозиция #22 Онбординг гостя (после [B4] Профиль гостя, согласия, удаление аккаунта и дневник питания #10)
• [F3] Дневник питания: день, запись по фото и тексту, неделя и привычки #23 Дневник (после [B4] Профиль гостя, согласия, удаление аккаунта и дневник питания #10, [B6] Рекомендации блюд и обратная связь по предложениям #12)
• [F4] Раздел «Что поесть»: подборка блюд, карточка заведения и горящие позиции рядом #24 «Что поесть»: подборка, карточка заведения, горящие рядом (после [B5] Заведения, импорт меню, горящие предложения и каталог #11, [B6] Рекомендации блюд и обратная связь по предложениям #12)
• [F5] Брони гостя: оформление, код и QR, таймер, отмена и история #25 Брони гостя (после [B7] Брони, погашение и аналитика заведения #13)
• [F6] Кабинет заведения: карточка, меню и импорт меню #26 Кабинет заведения: карточка, меню, импорт (после [B5] Заведения, импорт меню, горящие предложения и каталог #11)
• [F7] Горящие позиции, брони, погашение по QR и статистика заведения #27 Горящие позиции, брони, погашение по QR, статистика (после [B5] Заведения, импорт меню, горящие предложения и каталог #11, [B7] Брони, погашение и аналитика заведения #13)
• [F8] Профиль гостя, согласия и удаление аккаунта #28 Профиль и данные (после [B4] Профиль гостя, согласия, удаление аккаунта и дневник питания #10)
• [F9] Состояния экранов, навигация и возможности платформы MAX в мини-приложении #29 Состояния экранов, навигация, возможности MAX (после остальных экранов)

Как брать задачу

1. Назначить задачу на себя, чтобы никто не делал её параллельно.
2. Ветка от main, один PR на задачу, в описании Closes #N.
3. Тесты в том же PR, CI зелёный, слияние squash. Правила: CONTRIBUTING.md.
4. Контракт API живёт в openapi.yaml в корне, Swagger UI доступен на /docs запущенного сервера.

[Mikkkin]

Все задачи дорожной карты выполнены. Этап 3 в PR #59 (#19), #60 (#18), #61 (#20): это стопка, сливать по порядку. Ручные шаги после слияния (сервер, публичные пакеты GHCR, запуск smoke на main, чек-лист на телефонах, тег v1.0.0, презентация) перечислены в комментариях к #18, #19 и #20.