# План 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-кнопка "Прочитал ✅" под каждым сообщением
- Веб-панель: кто прочитал, кто нет
- Фильтры по статусу прочтения
- Повторная рассылка непрочитавшим

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

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

---

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

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

---

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

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