📝 docs: Добавлен план VPN для жильцов

Запланирована система раздачи VPN конфигов:
- /vpn — запросить конфиг из пула
- Авто-напоминания об истечении (7, 3 дня)
- /vpn_add — админ добавляет конфиги пачкой
- /vpn_stats — статистика
- Веб-панель управления пулом
- Сгорание 1-го числа след. месяца

Причина: РКН блокирует интернет, жильцы теряют связь с домом
Приоритет: Высокий

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
This commit is contained in:
Admin 2026-04-12 19:40:01 +04:00
parent e8653595eb
commit e1d6c58d9c

View file

@ -70,6 +70,57 @@
--- ---
## 🔒 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. **Обратная связь + интеграция с ИГ**В работе 1. **Обратная связь + интеграция с ИГ**В работе