Админка Франшизы — Фронтенд-спеки

Описание экранов, user flow, состояний и переходов для бэк-офиса владельца франшизы (React SPA).

Навигация и видимость разделов

(Введено в BR 1.4.4)

Фронт получает контекст пользователя из GET /api/v1/admin/auth/me:

franchise.type ∈ corporate | individual — управляет видимостью раздела «Юр. лица»
scope — какие данные доступны (вся франшиза / свои ЮЛ / свои ТТ)
permissions[] — что может делать (агрегат permissions всех permissions-ролей)

Хранится в PermissionContext (React-сторе). Используется во всех гейтах: пункты меню, кнопки, поля.

Раздел меню	Видимость
Юр. лица	`franchise.type=corporate` И scope=all_franchise (владелец франшизы) или scope=legal_entity_ids (владелец партнёра — видит только своё)
Роли	Владелец франшизы (или сотрудник с `roles.read`). Скрытые роли в списке не отображаются — управляются через карточку ЮЛ
Сотрудники	По scope + permission `employees.read`
Прочие разделы	По соответствующим permissions / scope

При franchise.type=individual пункт меню «Юр. лица» скрыт, прямой URL → 404.

Каждый файл описывает один экран или flow:

Модуль	Экраны	Статус
Авторизация	Логин, Восстановление пароля	draft (blocked)
Юридические лица	Список, Карточка, Импорт	draft
Торговые точки	planned (экраны будут созданы отдельно)	planned
Каталог	Товары, Категории, Версии	draft
Склад	—	planned
Сотрудники	Список, Карточка	draft
Клиенты (CRM)	Список, Карточка	draft
Группы клиентов	Список, Карточка	draft
Интеграции	Агрегаторы доставки, PayKeeper (BR 3.3)	draft
Кухонные станции	Кухонные станции (с порогами для KDS — BR 5.1)	draft
Настройки KDS	Настройки KDS (звуки + список устройств) (BR 5.1)	draft
Kitchen Queue	Очередь кухни (web kanban для менеджера, временное решение)	active
Маркетинговая информация	Список, Редактирование (BR 6.1)	active
AI-агент	Чат (floating) (BR 6.3) — overlay поверх всех страниц	planned