domovoy_bot/ГОТОВО.md
Admin ba4676b0af v1.0 MVP - Инициализация проекта 🏠
 Регистрация и верификация жильцов
 Рейтинг активности (уровни)
 Детект шпионов (Score 0-100)
 Анти-мат система (3 предупреждения → бан)
 Админ-панель с рассылкой
 Учёт квартир (несколько жильцов)
 Телефоны экстренных служб и мастеров
 Еженедельный экспорт JSON
 Прокси (socks5) для обхода РКН

Бекап: backups/versions/v1.0_mvp_2026-02-26/

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
2026-02-27 10:54:16 +00:00

5.5 KiB
Raw Blame History

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

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

  1. Написан код домового бота (20+ файлов, ~2500 строк)
  2. Настроена база данных (SQLite)
  3. Настроен прокси для обхода РКН (xray порт 10808)
  4. Установлены все зависимости
  5. Протестировано подключение через прокси

📋 Что нужно сделать ПРЯМО СЕЙЧАС:

1. Создай бота в Telegram

  1. Открой @BotFather
  2. Напиши /newbot
  3. Введи имя: Домовой Бот
  4. Введи username: DomovoyTest2026bot (должен заканчиваться на bot)
  5. Скопируй токен (длинная строка вида 1234567890:ABCdef...)

2. Узнай свой Telegram ID

  1. Открой @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:

# Вставь ТОКЕН от 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 на реальные телефоны УК, диспетчера, участкового

Или оставь как есть для теста.


🚀 Запуск бота

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

Или вручную:

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 Заявки на верификацию

🐛 Отладка

Смотри логи:

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

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