# Новая админка Barev Club — ТЗ

Согласовано с владельцем 2026-10-21. Новое приложение `apps/backoffice` рядом со старой `apps/admin`;
API и база общие. Старая админка работает, пока новая не готова. Все данные сохраняются.

Порядок работы: каждый этап сначала показываем на localhost, деплой — только после согласования.

## Роли

Один человек может иметь несколько ролей. Команда стартово 1–3 человека.

| Роль | Где работает | Что может |
|---|---|---|
| Суперадмин | веб-админка | всё, единственный видит деньги |
| Поддержка | веб-админка | чат поддержки, заказы (статусы, назначение), начисление подписок |
| Консьерж | веб-админка | чат консьержа (только подписчики) |
| Продажник | веб-админка | своя CRM: свои заведения и агентства, свой бонус |
| Партнёр | Telegram (рабочий бот) | как сейчас; в админке им управляет команда |
| Исполнитель | Telegram (рабочий бот + мини-апп) | как сейчас; в админке им управляет команда |

Партнёры — два раздельных типа: **агентства** (приводят клиентов, дарят подписку, получают %) и
**заведения** (кафе/рестораны с клубной картой).

## Общее

- Вход через Telegram (подтверждение в рабочем боте), без паролей.
- Языки интерфейса: русский, английский, армянский.
- Только светлая тема, дизайн в стиле barevclub.com (кремовый фон, малиновый акцент, пастельные
  цвета направлений, Rubik + Onest, крупные скругления).
- Удобно и на компьютере, и на телефоне.
- Валюта — драм (AMD).
- Журнал действий: видно всё — кто, когда, что изменил.
- Онлайн-платёжка ещё не выбрана — делаем абстракцию «ссылка на оплату», провайдера подключим позже.

## Разделы

### Дашборд суперадмина
1. **Требует внимания** — неназначенные заказы, неотвеченные чаты, заявки, низкие оценки (кликабельно).
2. **Деньги** — сегодня / неделя / месяц и сравнение с прошлым периодом; подписки vs заказы.
3. **Подписки** — активные Barev+ / Elite, истекают за 7 дней, конверсия подарочных в платные.
4. **Рост** — новые клиенты, источники, воронка лид → клиент → платящий.
5. **Команда** — подключения продажников, рейтинг исполнителей, активность заведений.
6. **Лента событий** — оплаты, подписки, действия команды.

### Клиенты
- Список: подписка (тариф, до какого числа, источник), откуда пришёл, сколько денег принёс
  (подписки + заказы, вал), теги.
- Фильтры, сохранённые сегменты, экспорт в Excel, теги, рассылки в бот по сегменту.
- Карточка: профиль, подписки, заказы (история + создать заказ за клиента), чаты, заметки, журнал.
- Подписка: подарить (помечается «подарок» и кто подарил), продать (ссылка на оплату или ручная
  отметка оплаты наличными/переводом), продлить, отменить, сменить тариф, вернуть деньги.
  Всегда видно, кто начислил: команда (кто именно), агентство или покупка.

### Чаты
- Два раздельных канала: **поддержка** (все клиенты) и **консьерж** (только подписчики).
- Клиент пишет и из бота, и из мини-аппа — одна переписка.
- Файлы в обе стороны.
- Взять диалог / передать коллеге / закрыть; шаблоны ответов; карточка клиента сбоку с действиями;
  внутренние заметки (клиент не видит).
- Уведомления: Telegram + счётчики в админке.
- Архитектура готова к ИИ-консьержу: автор ответа — человек или бот; человек может перехватить.

### Партнёры
- **Агентства**: код, процент, клиенты, начисленные подарки, вознаграждение.
- **Заведения**: предложения по уровням, сотрудники, сканы карты, активность.

### Исполнители
- Профиль и допуск (документы, активен/заблокирован), расписание и районы, рейтинг и качество
  (оценки, жалобы, отказы), деньги и выплаты.
- Заказы распределяются автоматически, диспетчер может переназначить вручную.

### CRM продажника
- Лиды: заведения и агентства. Воронка: Новый → Контакт → Встреча → Переговоры → Подключён / Отказ
  (этапы настраивает суперадмин).
- Задачи и напоминания (пуш в Telegram), история контактов (звонки, встречи, заметки, фото, файлы),
  карта заведений.
- «Подключён» → партнёр и ссылка для собственника создаются в один клик.
- Продажник видит своих лидов и свой бонус; формула бонуса настраивается гибко.

### Продукты
- Услуги и цены, тарифы подписки, промокоды, релокация.
- Каждый продукт настраивается полностью: наполнение, настройки, цена, скидки по уровню подписки.

### Клиентская часть (позже)
Переделываем мини-апп и клиентский бот (лендинг не трогаем).

## Этапы

1. **Каркас + дашборд + клиенты** — вход через Telegram, роли и команда, навигация, дашборд,
   клиенты с подписками, теги, сегменты, экспорт.
2. Чаты (поддержка + консьерж, файлы).
3. Заказы и исполнители.
4. Партнёры (агентства, заведения) + CRM продажника.
5. Продукты, рассылки, журнал, настройки.
6. Клиентская часть: мини-апп и бот.