Files
BarevClub/docs/backoffice/SPEC.md
T
2026-10-25 22:55:29 +04:00

96 lines
7.8 KiB
Markdown

# Новая админка 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. Клиентская часть: мини-апп и бот.