Ключевые функции:
— онбординг и сбор профилей; каталог участников с поиском/фильтрами и редактированием профиля;
— подтверждение актуальности (настраивается в админке);
— рассылки от фаундера (мастер отправки в боте);
— консерж-запросы (статусы new/in_progress/done);
— доступ только для членов чата (проверка при октрытии + ночная сверка);
1. Общая схема
- Сервис предоставляет общий закрытый чат сообщества (групповой чат в Telegram).
- В этот чат добавлен бот.
- Доступ к боту и Mini App имеют только участники чата.
- У сервиса есть фаундер (администратор) — у него расширенные права: рассылки, управление запросами, администрирование.
1.1 Панель управления (Django Admin)
- Вся информация (профили участников, запросы, рассылки, статусы, настройки) доступна через Django Admin.
- Админка используется для:
- просмотра и редактирования профилей участников,
- управления консерж-запросами,
- просмотра истории рассылок.
2. Telegram-бот
2.1 Доступ
- Если пользователь пишет боту, но не состоит в чате → бот отвечает:
«Доступ есть только у участников. Чтобы вступить, напишите организатору @username».
- Если состоит → доступ открыт.
2.2 Меню (reply-keyboard + slash-команды)
Для всех участников:
- Каталог → открывает Mini App (кнопка WebApp).
- Мой профиль (/profile) → показывает карточку профиля + кнопки «Редактировать» / «Открыть в Mini App».
- Оставить запрос (/request) → запускает мастер создания консерж-запроса.
- Помощь (/help) → справка + контакт организатора.
Для фаундера отдельно:
- /broadcast — создать рассылку.
- /broadcast_last — посмотреть отчет о последней рассылке.
- /requests — список и статусы всех консерж-запросов.
Если обычный пользователь вводит команду вручную, сервер проверяет права и вернёт «Недостаточно прав».
2.3 Онбординг и профиль
- При первом /start бот спрашивает данные:
Имя (обяз.),
Город (обяз.),
Компания,
Роль,
Краткое био (до 280 символов),
Ссылки на соцсети (до 3шт.),
Фото обяз.(1шт.).
- После заполнения — предпросмотр → подтверждение и сохранение.
- Профиль сохраняется в базе.
2.4 Подтверждение актуальности
- Раз в ПЕРИОД бот проверяет дату подтверждения профиля.
- Пользователь получает напоминание.
- Варианты ответов:
«Всё актуально» → дата обновляется.
«Обновить данные» → редактирование профиля.
2.5 Консерж-запросы
- Пользователь выбирает «Оставить запрос» или /request.
- Мастер по шагам: тема → описание → (опц.) дедлайн → предпросмотр → отправка.
- Запрос сохраняется в базе.
- Фаундер получает уведомление с кнопками:
«В работе» → статус in_progress, пользователь предупреждается «Запрос взят в работу».
«Завершить» → статус done, пользователь предупреждается «Запрос закрыт».
«Просмотр профиля» → переход в MiniApp к профилю пользователя.
2.6 Рассылки (только для фаундера)
- Фаундер пишет /broadcast.
- Мастер по шагам:
1. Текст (до 4096 символов, поддержка HTML)
2. Предпросмотр
3. Отправка и отчет.
- Рассылка идёт всем текущим участникам чата (список проверяется через getChatMember).
- По завершении — отчёт: сколько доставлено, сколько ошибок.
3. Mini App
3.1 Авторизация и доступ
- Mini App открывается из бота (кнопка WebApp).
- Авторизация идёт через initData Telegram WebApp.
- Сервер проверяет подпись и членство в чате.
- Если пользователь не в чате → показывается заглушка:
«Доступ только для участников. Напишите организатору @username».
3.2 Каталог участников
- Кнопка «Фильтры»: поиск по имени + город (выбор), роль (выбор).
- Список (карточки участников):
Фото / инициалы.
Имя (ярким)
Город.
Иконки соцсетей (если есть).
- Нажатие по карточке → детальная карточка.
3.3 Детальная карточка
- Фото (крупное).
- Имя.
- Роль.
- Компания.
- Город.
- Краткое био.
- Ссылки (иконки соцсетей).
- Кнопка «Написать в Telegram» → deeplink tg://resolve?domain=<username>.
3.4 Экран «Мой профиль»
- Поля: Имя*, Город*, Компания, Роль, Био, Ссылки (до 3), Фото.
- Кнопки: «Редактировать».
- После сохранения — сообщение «Сохранено».
4. Проверка членства
- При каждом открытии Mini App сервер проверяет членство.
- При действиях (сохранение профиля, создание запроса, запуск рассылки) тоже проверяется.
Технологии:
- Backend: Python (Django).
- Бот: aiogram.
- БД: PostgreSQL.
- Frontend Mini App: bootstrap, tailwindcss.
- Деплой: VPS (в РФ), Gunicorn, Nginx + Let’s Encrypt, systemd.
Примеры использования:
1. Закрытое сообщество девелоперов / инвесторов / франчайзи
Сценарий:
- Сообщество владельцев недвижимости или инвесторов.
Бот и Mini App:
Каталог участников с городами и объектами.
Запросы формата “нужен партнёр для проекта в Екатеринбурге”.
Рассылки от фаундера о новых инвестиционных сделках.
Автоматическая проверка актуальности данных раз в полгода.
Mini App: фильтрация по городам, сферам, имени.
Бизнес-смысл: внутренний CRM клубного типа — все в одном месте, без Notion и Excel.
Монетизация: закрытые уровни доступа, платный фаундерский тариф.
2. Клуб предпринимателей / бизнес-сообщество (MVP Networking Hub)
- Сценарий использования:
Закрытый клуб из 30–100 предпринимателей (например, “Клуб малого бизнеса региона”).
Бот и Mini App — это единая точка взаимодействия:
Профили участников (город, бизнес, роль, контакты).
Поиск по участникам (“ищу поставщика POS-оборудования”, “ищу франчайзи”).
Консьерж-запросы (“нужен бухгалтер в Питере до пятницы”).
Фаундер рассылает новости клуба, встречи, партнёрские предложения.
Mini App = каталог членов сообщества с фильтрацией и быстрыми поиском.
- Бизнес-смысл: повышение ценности сообщества и вовлечённости, превращение чата в управляемую сеть контактов.
В итоге сервис = закрытое комьюнити, где всё завязано на членство в Telegram-чате, а взаимодействие идёт через бота + Mini App с каталогом участников, профилями и запросами.
