ba4676b0af
✅ Регистрация и верификация жильцов ✅ Рейтинг активности (уровни) ✅ Детект шпионов (Score 0-100) ✅ Анти-мат система (3 предупреждения → бан) ✅ Админ-панель с рассылкой ✅ Учёт квартир (несколько жильцов) ✅ Телефоны экстренных служб и мастеров ✅ Еженедельный экспорт JSON ✅ Прокси (socks5) для обхода РКН Бекап: backups/versions/v1.0_mvp_2026-02-26/ Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
188 lines
5.5 KiB
Markdown
188 lines
5.5 KiB
Markdown
# ✅ Бот настроен и готов к запуску!
|
||
|
||
## 🎉 Что сделано:
|
||
|
||
1. ✅ Написан код домового бота (20+ файлов, ~2500 строк)
|
||
2. ✅ Настроена база данных (SQLite)
|
||
3. ✅ Настроен прокси для обхода РКН (xray порт 10808)
|
||
4. ✅ Установлены все зависимости
|
||
5. ✅ Протестировано подключение через прокси
|
||
|
||
---
|
||
|
||
## 📋 Что нужно сделать ПРЯМО СЕЙЧАС:
|
||
|
||
### 1. Создай бота в Telegram
|
||
|
||
1. Открой [@BotFather](https://t.me/BotFather)
|
||
2. Напиши `/newbot`
|
||
3. Введи имя: `Домовой Бот`
|
||
4. Введи username: `DomovoyTest2026bot` (должен заканчиваться на `bot`)
|
||
5. **Скопируй токен** (длинная строка вида `1234567890:ABCdef...`)
|
||
|
||
### 2. Узнай свой Telegram ID
|
||
|
||
1. Открой [@userinfobot](https://t.me/userinfobot)
|
||
2. Нажми `/start`
|
||
3. **Скопируй свой ID** (число вида `123456789`)
|
||
|
||
### 3. Создай тестовую группу
|
||
|
||
1. В Telegram: **Новая группа**
|
||
2. Название: `Тест Бота`
|
||
3. Добавь туда своего бота (найди по username)
|
||
4. **Сделай бота администратором** (дай право читать сообщения)
|
||
5. Узнай ID группы:
|
||
- Добавь @GetMyChatIdBot → он напишет ID
|
||
- Или через веб-версию Telegram
|
||
6. **Скопируй ID группы** (вида `-1001234567890`)
|
||
|
||
### 4. Вставь данные в .env
|
||
|
||
Открой файл `/home/matrixhasyou/domovoy_bot/.env`:
|
||
|
||
```ini
|
||
# Вставь ТОКЕН от BotFather
|
||
BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
|
||
|
||
# Вставь ID тестовой группы (с минусом!)
|
||
ADMIN_CHAT_ID=-1001234567890
|
||
|
||
# Вставь СВОЙ ID (без минуса)
|
||
ADMIN_USER_ID=123456789
|
||
|
||
# Туда же свой ID
|
||
SPY_ALERT_USER_ID=123456789
|
||
|
||
# Прокси (уже настроено!)
|
||
USE_PROXY=true
|
||
PROXY_TYPE=socks5
|
||
PROXY_HOST=127.0.0.1
|
||
PROXY_PORT=10808
|
||
```
|
||
|
||
### 5. Замени телефоны на реальные
|
||
|
||
Открой `data/phones.json` и замени:
|
||
- `+7 (XXX) XXX-XX-XX` на реальные телефоны УК, диспетчера, участкового
|
||
|
||
Или оставь как есть для теста.
|
||
|
||
---
|
||
|
||
## 🚀 Запуск бота
|
||
|
||
```bash
|
||
cd /home/matrixhasyou/domovoy_bot
|
||
./run.sh
|
||
```
|
||
|
||
Или вручную:
|
||
```bash
|
||
source venv/bin/activate
|
||
python main.py
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ Проверка работы
|
||
|
||
### Бот должен написать тебе в личку:
|
||
```
|
||
✅ Домовой бот запущен!
|
||
Прокси: ✅
|
||
Все системы в норме.
|
||
```
|
||
|
||
### В тестовой группе напиши:
|
||
- `/start` — бот ответит меню с кнопками
|
||
- `/admin` — покажет админ-панель (только тебе)
|
||
- `/помощь` — список команд
|
||
|
||
---
|
||
|
||
## 🕵️ Тест верификации
|
||
|
||
1. **С другого аккаунта** (жена/друг/второй номер):
|
||
- Напиши боту в личку: `45`
|
||
|
||
2. **Тебе придёт уведомление:**
|
||
```
|
||
🔔 Новая заявка на верификацию
|
||
Жилец: Иван @username
|
||
Квартира: 45
|
||
```
|
||
|
||
3. **Подтверди:**
|
||
```
|
||
/verify_approve 987654321
|
||
```
|
||
(где `987654321` — ID пользователя)
|
||
|
||
---
|
||
|
||
## 🕵️ Тест детекта шпионов
|
||
|
||
1. Создай тестовый аккаунт (без аватарки, ник `user12345`)
|
||
2. Добавь в тестовую группу
|
||
3. Тебе придёт уведомление
|
||
4. Через 24 часа проверь: `/spies`
|
||
|
||
---
|
||
|
||
## 📊 Админские команды
|
||
|
||
| Команда | Описание |
|
||
|---------|----------|
|
||
| `/admin` | Панель администратора |
|
||
| `/stats` | Статистика чата |
|
||
| `/spies` | Подозрительные пользователи |
|
||
| `/export` | Экспорт JSON |
|
||
| `/users` | Список жильцов |
|
||
| `/verify` | Заявки на верификацию |
|
||
|
||
---
|
||
|
||
## 🐛 Отладка
|
||
|
||
### Смотри логи:
|
||
```bash
|
||
tail -f /home/matrixhasyou/domovoy_bot/logs/bot.log
|
||
```
|
||
|
||
### Если ошибка "Unauthorized":
|
||
- Проверь `BOT_TOKEN` в `.env`
|
||
|
||
### Если ошибка "timeout":
|
||
- Проверь прокси: `ps aux | grep xray`
|
||
- Проверь порт: `ss -tlnp | grep 10808`
|
||
|
||
### Если бот не отвечает в группе:
|
||
- Убедись что бот **администратор** группы
|
||
- Проверь `ADMIN_CHAT_ID` (должен быть с минусом!)
|
||
|
||
---
|
||
|
||
## 📚 Документация
|
||
|
||
| Файл | Описание |
|
||
|------|----------|
|
||
| `QUICKSTART.md` | Быстрый старт (5 минут) |
|
||
| `SETUP_GUIDE.md` | Полная пошаговая настройка |
|
||
| `PROXY_SETUP.md` | Настройка прокси |
|
||
| `README.md` | Общая информация |
|
||
| `STATUS.md` | Статус проекта |
|
||
|
||
---
|
||
|
||
## 🎯 Дальнейшие шаги
|
||
|
||
1. ✅ Протестировать в тестовой группе
|
||
2. ✅ Настроить телефоны служб
|
||
3. ✅ Добавить в настоящий чат дома
|
||
4. ⏳ AI-юрист (потом)
|
||
5. ⏳ Маркетплейс, опросы (потом)
|
||
|
||
---
|
||
|
||
**Всё готово! Вставляй токен и запускай!** 🚀
|