DOCS: Add GEMINI.md and RECOVERY.md for DDD architecture

This commit is contained in:
Admin 2026-06-13 10:00:57 +04:00
parent 455c3dbd5b
commit 6a8bcca35b
2 changed files with 36 additions and 0 deletions

13
GEMINI.md Normal file
View file

@ -0,0 +1,13 @@
# 🤖 Domovoy Bot
## 🧠 Специфика для Gemini
- **Стек:** Python 3.12, Aiogram 3.x, SQLite, Playwright, Uvicorn/FastAPI (веб-панель).
- **Методология:** Строгое следование архитектуре SDD (Spec-Driven Development).
- **Связь с сетью:** Для работы с API Telegram и внешним интернетом бот НЕ нуждается в прокси (используем прямое подключение на сервере, обход блокировок не нужен для бота).
- **Мониторинг:** Всегда логировать критические действия в Telegram.
- **Парсер ГИС ЖКХ:** Работает в подпапке `scraper_gis`. Использует Headless Chromium. Требует авторизованный `browser_context`.
## 📂 Структура данных
- `database/domovoy.db` — Основная база данных.
- `logs/` — Файлы логов (`bot.log`, `web.log`).
- `services/email_auditor/` — Пайплайн парсинга почты и PDF.

23
RECOVERY.md Normal file
View file

@ -0,0 +1,23 @@
# 🚨 АВАРИЙНОЕ ВОССТАНОВЛЕНИЕ: Domovoy Bot
## 1. Зависимости и Окружение
Бот работает в виртуальном окружении Python: `venv`.
Загрузка файлов на Google Drive использует отдельное окружение: `venv-google`.
## 2. Системные сервисы (systemd)
Бот разбит на два процесса:
1. `domovoy-bot.service` (Основной Telegram-бот)
2. `domovoy-web.service` (Веб-админка на порту 8000)
**Перезапуск:**
```bash
sudo systemctl restart domovoy-bot.service domovoy-web.service
sudo systemctl status domovoy-bot.service
```
## 3. Автоматика (Cron)
Пайплайн синхронизации почты запускается ежесуточно в 02:00 через cron пользователя `matrixhasyou`.
Команда: `/bin/bash /home/matrixhasyou/domovoy_bot/services/email_auditor/auto_sync_pipeline.sh`
## 4. Бэкапы баз данных
База `domovoy.db` бэкапится скриптом `backup-commander`. Ищите последние дампы на Synology в `/volume1/video/youtube/office_backups/`.