Документация проекта lovii¶

Полный корпус исследований, аудита аналогов и продуктовых спецификаций для создания ресторанной CRM/ERP-платформы полного цикла (заказ → чек → кухня → списание продуктов → курьер → отзыв гостя → франшиза).

Карта документов¶

Быстрый вход: Каталог схем — все диаграммы сайта со ссылками на страницы, где они находятся. Каталог генерируется скриптом scripts/gen_diagram_catalog.py.

0. Резюме и аудит корпуса¶

Файл	Содержание
`research/executive-summary.md`	Резюме исследования на одной странице — для руководства
`research/audit-report.md`	Аудит корпуса документации: проверки, пробелы, оценки

0.1. Внешний аудит документации (ревизия №1)¶

Файл	Содержание
`research/audit/report.md`	Отчёт внешнего аудита корпуса (70 страниц): 43 находки — 4 критичных, 23 средних, 16 низких; методика, проверенное, план исправлений в 3 волны. DOCX
`research/audit/register.md`	Реестр находок F-01…F-43 с цитатами, привязкой к файлам и рекомендациями (рабочий чек-лист). XLSX

0.5. Академические разборы¶

Файл	Содержание
`research/crm-vs-erp.md`	Сравнение CRM и ERP лоб в лоб: отличия, связка, два контура общепита
`research/terminology-crm-erp.md`	CRM и ERP: академические определения, происхождение, граница классов, определитель «ситуация → термин»
`research/terminology-franchise.md`	Франшиза и франчайзинг: теории, правовой режим РФ, финансовая и операционная терминология
`research/academic-research-agenda.md`	Программа дальнейших академических разборов с приоритетами
`research/academic/01-management-accounting.md`	Терминология управленческого учёта общепита: фудкост, прайм-кост, P&L, EBITDA
`research/academic/02-unit-economics.md`	Юнит-экономика точки: модель расходов, чувствительность, экономика доставки и франчайзи
`research/academic/03-service-quality.md`	Качество сервиса: модель Оливера, SERVQUAL → DINESERV, сервис-рекавери
`research/academic/04-personal-data-loyalty.md`	Лояльность и ПДн: режим 152-ФЗ, сравнение с GDPR, чек-лист платформы
`research/academic/05-franchising-economics.md`	Экономика франчайзинга: структуры роялти, агентские издержки, выживаемость
`research/academic/06-food-safety-terminology.md`	Пищевая безопасность: Кодекс Алиментариус, ХАССП, ККТ, прослеживаемость
`research/academic/07-operations-terminology.md`	Операционный менеджмент: теория ограничений, очереди, закон Литтла
`research/academic/08-clv-models.md`	Модели ценности гостя: когорты, RFM, Парето/НБД, Гамма-Гамма, прогнозный CLV
`research/academic/09-menu-engineering.md`	Инженерия меню: матрица Касаваны–Смита, поведенческая экономика меню
`research/academic/10-waiting-psychology.md`	Психология ожидания: принципы Мэйстера и требования к статусам/обещаниям
`research/academic/11-technology-adoption.md`	Принятие технологий персоналом: TAM, UTAUT/UTAUT2 и требования к интерфейсам
`research/academic/12-event-architecture-cqrs.md`	Событийная архитектура и CQRS в мультитенантной платформе
`research/academic/13-mdm-data-quality.md`	Качество данных и MDM: мастер-данные сети, золотая запись, владение
`research/academic/14-lean-kitchen.md`	Бережливая кухня: семь потерь, 5S, визуальный менеджмент
`research/academic/15-staff-turnover.md`	Текучесть линейного персонала: модели ухода и интервенции
`research/academic/16-innovation-diffusion.md`	Диффузия инноваций в сетях: механика раскатки изменений (Роджерс)
`research/academic/17-franchise-law-comparative.md`	Сравнительное право франчайзинга: Россия, США (Правило ФТК), ЕС

1. Рынок и архитектура¶

Файл	Содержание
`research/00-market-landscape.md`	Рынок общепита РФ в цифрах, сегменты автоматизации, глобальный контекст
`research/01-reference-architecture.md`	Референс-модель: 13 доменов, сквозной процесс, модель данных, роли
`research/02-personas-cjm.md`	Персоны и сценарии: гость, курьер, франчайзи, УК, повар
`research/design-system.md`	Дизайн-система и UI-кит: токены, каркас, компоненты, правила разработки
`research/glossary.md`	Глоссарий отраслевых и регуляторных терминов

2. Компоненты (детальные спецификации)¶

Файл	Домен
`components/01-pos-fiscal.md`	Касса, чеки, фискализация (54-ФЗ, ФФД 1.2, ОФД)
`components/02-order-channels.md`	Каналы приёма заказов: зал, киоск, бронь/банкеты, сайт, приложение, агрегаторы
`components/03-kitchen-kds.md`	Кухня: KDS, цеха, тайминги, ТТК на экране
`components/04-inventory-procurement.md`	Склад, техкарты, фудкост, закупки, поставщики, ЭДО
`components/05-delivery-couriers.md`	Доставка: свои курьеры, маршрутизация, агрегаторы
`components/06-crm-loyalty-feedback.md`	CRM гостя, лояльность, отзывы, NPS
`components/07-hr-staff.md`	Персонал: смены, табель, ФОТ, мотивация, обучение
`components/08-finance-analytics.md`	Финансы, P&L, BI, видеоконтроль, антифрод
`components/09-franchise-network.md`	Франшиза и управляющая компания: роялти, стандарты, онбординг точек
`components/10-compliance-safety.md`	Пищевая безопасность, ХАССП, ЕГАИС, Честный ЗНАК, Меркурий
`components/11-integration-platform.md`	Платформа: API, события, офлайн-режим, мультитенантность, безопасность
`components/12-data-model.md`	Модель данных: сущности, атрибуты, контракты

2.5. Технические спецификации (схемы Mermaid)¶

Файл	Содержание
`research/specs/00-overview.md`	Контекст системы и контейнерная схема
`research/specs/01-domain-model.md`	ER-схемы доменов и стейт-машины заказов/доставки
`research/specs/02-processes.md`	Последовательности: зал, онлайн-доставка, агрегаторы, закупки, офлайн, отзывы, роялти, инвентаризация
`research/specs/03-api-contracts.md`	Ресурсы REST, контракт заказа, каталог событий, вебхуки, надёжность
`research/specs/04-deployment-offline.md`	Топология деплоя, мультитенантность, офлайн-синхронизация, безопасность

2.6. Инфраструктура и эксплуатация¶

Файл	Содержание
`research/infrastructure/banks-kassa-ofd.md`	Банки-эквайеры, онлайн-кассы и ОФД: роли, экономика (сколько съедают от выручки), лучшие примеры 2026, контракт мок-сервисов
`research/infrastructure/02-operations-sla.md`	Эксплуатация платформы и SLA: уровни сервиса, мониторинг, инциденты, бэкапы, поддержка

2.7. SaaS-платформа и демо¶

Файл	Содержание
`research/saas/00-platform-map.md`	Карта-цель: `app.lovii.ru`, `crm.lovii.ru`, `erp.lovii.ru` — три входа одной платформы, роли и принципы единства
`research/saas/01-information-flow.md`	Семь правил движения информации; схемы «источники → журнал → контуры», путь заказа и путь поставки
`research/saas/02-demo-cabinet.md`	Спецификация демо-кабинета: три кабинета (Витрина / CRM / ERP), 10 ролей по контурам, 30 экранов полного периметра, отчёты и рекомендации, аудиты, онбординг. Демо собрано → открыть демо-кабинет · живой прототип витрины: lovii.mobiap.com
`research/saas/03-role-scenarios.md`	Аудит кабинетов: боли каждой из 10 ролей, полная матрица сценариев с действиями, подсказки «что делать дальше» и прогноз итога, сквозные сценарии через все роли

2.8. Бизнес: модель и тарифы¶

Файл	Содержание
`research/business/01-financial-model.md`	Финансовая модель платформы: 4 потока выручки, затраты на постройку, сценарии на 24 мес, чувствительность
`research/business/02-pricing.md`	Тарифная сетка «Старт/Базовый/Про/УК», принципы монетизации, положение на рынке против 30+ вендоров, франшизные условия
`research/business/03-gtm-strategy.md`	Стратегия выхода на рынок: волны продаж, позиционирование, воронка пилотов, план первых 90 дней
`research/business/04-metrics-plan.md`	План метрик и измерений: дерево целей, формулы, источники событий, бизнес-метрики платформы

2.9. Юридический пакет и франч-бук¶

Файл	Содержание
`research/legal/01-legal-package.md`	Юрминимум запуска: карта документов, операторы данных, обязательства платформы, что отдаётся внешнему юристу
`research/legal/02-privacy-policy-draft.md`	Драфт политики ПДн и обособленных согласий (152-ФЗ)
`research/legal/03-loyalty-offer-draft.md`	Драфт публичной оферты программы лояльности
`research/legal/04-terms-of-use-draft.md`	Драфт пользовательского соглашения платформы: данные клиента, экспорт, ответственность
`research/legal/05-franchise-contract-outline.md`	Драфт структуры договора коммерческой концессии (глава 54 ГК РФ)
`research/franchise/franchise-book-v0.md`	Франч-бук (v0): сделка в цифрах, путь франчайзи, стандарты и контроль

2.10. Пилот¶

Файл	Содержание
`research/pilot/01-pilot-runbook.md`	Пилотный срез «приложение + касса + чеки + мини-кабинет»: что настоящее и что эмулируется, порядок запуска, критерии успеха. Работает → открыть пилот

3. Аудиты аналогов¶

Россия

Файл	Системы
`competitors/iiko.md`	iiko (лидер рынка РФ)
`competitors/rkeeper.md`	r_keeper
`competitors/poster.md`	Poster POS
`competitors/quick-resto.md`	Quick Resto
`competitors/saby-presto.md`	Saby Presto (СБИС)
`competitors/1c.md`	1С:Общепит / 1С:Ресторан / 1С:Фастфуд
`competitors/ru-smaller.md`	Tillypad, Fusion POS, Yuma, Эвотор-решения

Мир

Файл	Системы
`competitors/toast.md`	Toast (США, эталон вертикальной платформы)
`competitors/lightspeed.md`	Lightspeed Restaurant
`competitors/square-touchbistro-revel.md`	Square for Restaurants, TouchBistro, Revel
`competitors/middleware-delivery.md`	Deliverect, Otter, Checkmate + RU-сервисы доставки
`competitors/loyalty-crm-vendors.md`	ReMarked, Loona.ai, getMeBack, PremiumBonus и др.
`competitors/audit-standards-vendors.md`	MD Audit, CheckOffice, Service Inspector, Mozg

4. Выводы и план продукта¶

Файл	Содержание
`research/gap-analysis.md`	Матрица «компонент × система», разрывы, окно возможностей
`research/product-blueprint.md`	Архитектура платформы lovii, фазы, MVP, метрики, риски

5. План реализации и систематизация¶

Файл	Содержание
`research/plan/01-implementation-plan.md`	Фазы с гейтами, план первых 90 дней, команда, риски
`research/plan/02-systems-roadmap.md`	Какие системы нужны по фазам: строить / покупать / интегрировать
`research/plan/03-backbone-stack.md`	Опорный стек до выхода на целевые показатели, правила миграций, бюджет