DOCS: Add GEMINI.md and RECOVERY.md for DDD architecture
This commit is contained in:
parent
455c3dbd5b
commit
6a8bcca35b
2 changed files with 36 additions and 0 deletions
13
GEMINI.md
Normal file
13
GEMINI.md
Normal 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
23
RECOVERY.md
Normal 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/`.
|
||||
Loading…
Reference in a new issue