Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
96 lines
7.8 KiB
Markdown
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. Клиентская часть: мини-апп и бот.
|