domovoy_bot/SETUP_GUIDE.md

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

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

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

---

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

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

---

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

Способ 1 (через бота):

1. Добавь бота @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 и замени значения:

# Вставь токен от 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 и замени заглушки на реальные телефоны:

{
  "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: Первый запуск

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

Или вручную:

source venv/bin/activate
python main.py

---

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

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

---

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

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

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

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

[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

Активируй:

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

---

📞 Помощь

Если что-то не работает — смотри логи:

tail -f logs/bot.log

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