Snapshot of uncommitted work: landing, bots, prod infra, partner cabinet, backoffice stage 1

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-21 01:23:32 +04:00
1 parent 45d7512d2b
commit d452824c62
@@ -0,0 +1,95 @@
+# Новая админка 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. Клиентская часть: мини-апп и бот.