domovoy_bot/SETUP_GUIDE.md

# 🛠 Настройка домового бота - пошаговая инструкция

## Шаг 1: Получение токена бота

1. Открой Telegram и найди [@BotFather](https://t.me/BotFather)
2. Отправь команду `/newbot`
3. Введи имя бота (например: `Домовой Бот`)
4. Введи username бота (например: `DomovoyBot123bot`)
5. Скопируй полученный токен (вида: `1234567890:ABCdefGHIjklMNOpqrsTUVwxyz`)

---

## Шаг 2: Узнай свой Telegram ID

1. Найди бота [@userinfobot](https://t.me/userinfobot)
2. Нажми `/start`
3. Скопируй свой ID (число, например: `123456789`)

---

## Шаг 3: Узнай ID чата дома

**Способ 1 (через бота):**
1. Добавь бота [@GetMyChatIdBot](https://t.me/GetMyChatIdBot) в чат дома как участника
2. Он сразу напишет ID чата (вида: `-1001234567890`)
3. Удали бота из чата

**Способ 2 (через веб-версию Telegram):**
1. Открой чат дома в веб-версии: https://web.telegram.org
2. Посмотри на URL в адресной строке
3. ID будет после `c/`: например `https://web.telegram.org/a/#-1001234567890` → ID = `-1001234567890`

---

## Шаг 4: Настройка .env файла

Открой файл `.env` и замени значения:

```ini
# Вставь токен от BotFather
BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

# ID чата дома (с минусом в начале!)
ADMIN_CHAT_ID=-1001234567890

# Твой ID (без минуса)
ADMIN_USER_ID=123456789

# Тот же ID для уведомлений
SPY_ALERT_USER_ID=123456789
```

---

## Шаг 5: Настройка телефонов

Открой файл `data/phones.json` и замени заглушки на реальные телефоны:

```json
{
  "utility": [
    {
      "name": "Диспетчер УК",
      "phone": "+7 (495) 123-45-67",
      "description": "Круглосуточно"
    }
  ],
  "police": [
    {
      "name": "Участковый Иванов И.И.",
      "phone": "+7 (495) 123-45-67",
      "description": "Приём: Вт, Чт 18:00-20:00"
    }
  ],
  "masters": [
    {
      "name": "Сантехник Алексей",
      "phone": "+7 (999) 123-45-67",
      "description": "Опыт 15 лет",
      "rating": 4.8
    }
  ]
}
```

---

## Шаг 6: Добавление бота в чат

1. Найди своего бота по username (например: `@DomovoyBot123bot`)
2. Добавь его в чат дома как **администратора** (для чтения сообщений)

**Важно:** Дай боту права:
- ✅ Чтение сообщений
- ✅ Удаление сообщений (опционально)
- ✅ Добавление участников (опционально)

---

## Шаг 7: Первый запуск

```bash
cd /home/matrixhasyou/domovoy_bot
./run.sh
```

Или вручную:
```bash
source venv/bin/activate
python main.py
```

---

## Шаг 8: Проверка работы

1. Бот должен написать тебе в личку: `✅ Домовой бот запущен!`
2. В чате напиши `/start` или нажми кнопку
3. Проверь команду `/admin` (доступна только тебе)

---

## Шаг 9: Автозапуск (опционально)

Для работы 24/7 создай systemd сервис:

```bash
sudo nano /etc/systemd/system/domovoy-bot.service
```

Вставь содержимое (замени `matrixhasyou` на своего пользователя):

```ini
[Unit]
Description=Domovoy Bot
After=network.target

[Service]
Type=simple
User=matrixhasyou
WorkingDirectory=/home/matrixhasyou/domovoy_bot
ExecStart=/home/matrixhasyou/domovoy_bot/venv/bin/python main.py
Restart=always

[Install]
WantedBy=multi-user.target
```

Активируй:
```bash
sudo systemctl daemon-reload
sudo systemctl enable domovoy-bot
sudo systemctl start domovoy-bot
sudo systemctl status domovoy-bot
```

---

## 🔍 Проверка работы детекта шпионов

1. Добавь в чат тестовый аккаунт (без аватарки, с ником `user12345`)
2. Подожди 24 часа (или измени в коде `unverified_hours`)
3. Проверь команду `/spies` — должен показать подозрительного

---

## 📊 Просмотр статистики

Команды админа:
- `/admin` — главное меню
- `/stats` — быстрая статистика
- `/spies` — подозрительные пользователи
- `/export` — выгрузить JSON
- `/users` — список жильцов

---

## ❓ Частые проблемы

**Бот не отвечает:**
- Проверь токен в `.env`
- Проверь логи: `cat logs/bot.log`

**Бот не видит сообщения:**
- Убедись, что бот добавлен в чат как администратор
- Проверь `ADMIN_CHAT_ID` (должен быть с минусом)

**База данных не создаётся:**
- Проверь права на папку: `chmod 755 /home/matrixhasyou/domovoy_bot/database`

---

## 📞 Помощь

Если что-то не работает — смотри логи:
```bash
tail -f logs/bot.log
```

Или пиши в issue на GitHub.