e1d6c58d9c
Запланирована система раздачи VPN конфигов: - /vpn — запросить конфиг из пула - Авто-напоминания об истечении (7, 3 дня) - /vpn_add — админ добавляет конфиги пачкой - /vpn_stats — статистика - Веб-панель управления пулом - Сгорание 1-го числа след. месяца Причина: РКН блокирует интернет, жильцы теряют связь с домом Приоритет: Высокий Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
171 lines
8.2 KiB
Markdown
171 lines
8.2 KiB
Markdown
# План V3 - Новый функционал Домовой Бот
|
||
|
||
> Дата: 6 апреля 2026 г.
|
||
> Статус: Черновик, обсуждение
|
||
> Автор: Генерация AI + обсуждение с разработчиком
|
||
|
||
---
|
||
|
||
## 📋 Список предложений (10 пунктов)
|
||
|
||
### 1. Система обратной связи (Feedback)
|
||
- Команда `/feedback` для жильцов
|
||
- Категоризация: предложения, жалобы, проблемы
|
||
- Автоматическое распределение по темам
|
||
- Трекинг статуса (в работе/решено/отклонено)
|
||
- **Интеграция с ИГ**: сообщения автоматически уходят всем членам Инициативной Группы
|
||
- Аналитика: топ проблем дома
|
||
|
||
### 2. Умная рассылка с аналитикой прочтения
|
||
- Кнопка "Прочитал ✅" в каждом сообщении рассылки
|
||
- Статистика прочтений в веб-панели
|
||
- A/B тестирование текстов
|
||
- Лучшее время отправки (анализ активности)
|
||
- Отложенная рассылка с таймером
|
||
|
||
### 3. Геймификация для повышения активности
|
||
- Еженедельные/месячные рейтинги ("Жилец месяца")
|
||
- Бейджи за участие в жизни дома
|
||
- Публичная доска почета
|
||
|
||
### 4. Умные уведомления для жильцов
|
||
- Персональные напоминания (долги, события, опросы)
|
||
- Подписка на категории уведомлений
|
||
- Еженедельный дайджест
|
||
|
||
### 5. Аналитика и дашборды
|
||
- Активность чата по дням/часам
|
||
- Топ тем обсуждений
|
||
- Процент верифицированных vs неактивных
|
||
- Тренд токсичности
|
||
- Экспорт CSV/Excel
|
||
|
||
### 6. Система "Помощь соседу"
|
||
- `/help_request` — запрос помощи
|
||
- `/help_offer` — предложение помощи
|
||
- Уведомления заинтересованным
|
||
- История взаимопомощи
|
||
|
||
### 7. Бронирование общих ресурсов
|
||
- Запись на прачечную/спортзал/коворкинг
|
||
- Календарь занятости
|
||
- Напоминания о бронировании
|
||
|
||
### 8. База знаний дома
|
||
- FAQ и инструкции
|
||
- `/wiki` — быстрый доступ
|
||
- Администрирование через веб-панель
|
||
- Поиск по статьям
|
||
|
||
### 9. Экстренные оповещения
|
||
- `/emergency` — мгновенная рассылка всем
|
||
- Обходит все настройки приватности
|
||
- Требует подтверждение прочтения
|
||
- Лог экстренных сообщений
|
||
|
||
### 10. Персонализированные рекомендации
|
||
- Анализ активности и предложения
|
||
- Напоминания об активности
|
||
- Подсказки для заполнения профиля
|
||
|
||
---
|
||
|
||
## 🔒 VPN ДЛЯ ЖИЛЬЦОВ (Запланировано)
|
||
|
||
> Добавлено: 12.04.2026
|
||
> Статус: Идея одобрена, ждёт реализации
|
||
> Приоритет: Высокий (люди теряют связь с домом из-за блокировок РКН)
|
||
|
||
### 🎯 Проблема
|
||
РКН блокирует интернет → жильцы без VPN отключаются от чата → теряют связь с домом. Многие не умеют настраивать VPN.
|
||
|
||
### 💡 Решение
|
||
Бот раздаёт VPN конфиги (VLESS) из пула админа автоматически.
|
||
|
||
### 📋 Функционал
|
||
|
||
**Для жильца:**
|
||
- `/vpn` — запросить VPN конфиг
|
||
- Бот отправляет ссылку с инструкцией и VLESS конфигом
|
||
- ⚠️ Предупреждение: ссылка сгорает 1-го числа след. месяца в 00:00 если не используется
|
||
- `/vpn_status` — проверить статус своего VPN (когда сгорит)
|
||
- Авто-напоминания: за 7 дней, за 3 дня, после истечения
|
||
|
||
**Для админа:**
|
||
- `/vpn_add` — добавить конфиги в пул (пачкой, по одному на строку)
|
||
- `/vpn_stats` — статистика (выдано, свободно, истекает)
|
||
- Веб-панель `/vpn_configs` — управление пулом
|
||
- Пул: админ закидывает 10-50 конфигов, бот раздаёт по мере запросов
|
||
|
||
**Автоматика (Scheduler):**
|
||
- Ежедневно в 10:00 — проверка истекающих
|
||
- Напоминания жильцам за 7 и 3 дня
|
||
- 1-го числа в 00:05 — очистка истёкших
|
||
|
||
### ⚠️ Ограничения
|
||
- НЕТ проверки активности использования (веб-панель VPN требует отдельного подключения)
|
||
- Сгорание по таймеру: 1 месяц с даты выдачи
|
||
- Один жилец = один активный конфиг
|
||
|
||
### 📐 Техническая структура
|
||
```
|
||
database/models.py → модель VpnConfig
|
||
database/migrate_v3_5_vpn.py → миграция БД
|
||
handlers/vpn.py → хендлеры /vpn, /vpn_status, /vpn_help
|
||
services/vpn_service.py → выдача, проверка, напоминания
|
||
services/scheduler.py → ежедневная задача проверки
|
||
web/app.py → /vpn_configs страница
|
||
web/templates/vpn_configs.html → веб-панель админа
|
||
```
|
||
|
||
### 🚀 Приоритет: Реализовать при первой возможности
|
||
---
|
||
|
||
## 🥇 Приоритет для быстрой реализации
|
||
|
||
1. **Обратная связь + интеграция с ИГ** ← В работе
|
||
2. **Умные рассылки с прочтением** ← В работе
|
||
3. **Еженедельный дайджест** ← В работе
|
||
|
||
---
|
||
|
||
## 🔑 Детали реализации приоритетных функций
|
||
|
||
### Умная рассылка с прочтением
|
||
- Inline-кнопка "Прочитал ✅" под каждым сообщением
|
||
- Веб-панель: кто прочитал, кто нет
|
||
- Фильтры по статусу прочтения
|
||
- Повторная рассылка непрочитавшим
|
||
|
||
### Еженедельный дайджест
|
||
- Автоматическая отправка в воскресенье
|
||
- Топ событий, опросов, объявлений за неделю
|
||
- Персонализация по активности
|
||
- Настройка через веб-панель
|
||
|
||
### Обратная связь с интеграцией ИГ
|
||
- Кнопка "Обратная связь" в меню верифицированных
|
||
- Форма с категориями
|
||
- **Автоматическая отправка всем членам ИГ**
|
||
- Веб-панель: управление обращениями
|
||
- Аналитика по категориям
|
||
|
||
---
|
||
|
||
## Веб-панель управления
|
||
|
||
Все управление через веб-админку:
|
||
- Создание рассылок + статистика прочтения
|
||
- Настройка дайджеста
|
||
- Просмотр обратной связи
|
||
- Управление обращениями
|
||
- Аналитика и дашборды
|
||
|
||
---
|
||
|
||
## Интеграция с Инициативной Группой
|
||
|
||
- Автоматическое уведомление ИГ при новой обратной связи
|
||
- Уведомления о жалобах и проблемах
|
||
- Общий канал для обсуждений
|
||
- Статусы обращений видны всем членам ИГ
|