domovoy_bot/ПЛАН_V3_НОВЫЙ_ФУНКЦИОНАЛ.md

План 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 → веб-панель админа

🚀 Приоритет: Реализовать при первой возможности

---

📄 ОТПРАВКА ДОКУМЕНТОВ (Реализовано v3.4)

Добавлено: 12.04.2026 Статус: ✅ Готово Версия: v3.4

Что умеет:

• Загрузка PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, ZIP, RAR через веб-панель
• Отправка в любую тему форума (10+ тем)
• По расписанию или мгновенно
• Поддержка фото + текст + документ одновременно
• Отправка в чат и/или всем верифицированным жильцам

Как использовать:

1. Веб-панель → Запланированные посты
2. Ввести текст, выбрать тему
3. Прикрепить документ (необязательно)
4. Выбрать время (или "сейчас")
5. Нажать "Запланировать"

---

🥇 Приоритет для быстрой реализации

1. Обратная связь + интеграция с ИГ ← В работе
2. Умные рассылки с прочтением ← В работе
3. Еженедельный дайджест ← В работе

---

🔑 Детали реализации приоритетных функций

Умная рассылка с прочтением

• Inline-кнопка "Прочитал ✅" под каждым сообщением
• Веб-панель: кто прочитал, кто нет
• Фильтры по статусу прочтения
• Повторная рассылка непрочитавшим

Еженедельный дайджест

• Автоматическая отправка в воскресенье
• Топ событий, опросов, объявлений за неделю
• Персонализация по активности
• Настройка через веб-панель

Обратная связь с интеграцией ИГ

• Кнопка "Обратная связь" в меню верифицированных
• Форма с категориями
• Автоматическая отправка всем членам ИГ
• Веб-панель: управление обращениями
• Аналитика по категориям

---

Веб-панель управления

Все управление через веб-админку:

• Создание рассылок + статистика прочтения
• Настройка дайджеста
• Просмотр обратной связи
• Управление обращениями
• Аналитика и дашборды

---

Интеграция с Инициативной Группой

• Автоматическое уведомление ИГ при новой обратной связи
• Уведомления о жалобах и проблемах
• Общий канал для обсуждений
• Статусы обращений видны всем членам ИГ