# ✅ Бот настроен и готов к запуску!

## 🎉 Что сделано:

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. ⏳ Маркетплейс, опросы (потом)

---

**Всё готово! Вставляй токен и запускай!** 🚀
