From 6a8bcca35b23265e82bcac207b8794f75ac2e243 Mon Sep 17 00:00:00 2001
From: Admin <admin@domovoy.local>
Date: Sat, 13 Jun 2026 10:00:57 +0400
Subject: [PATCH] DOCS: Add GEMINI.md and RECOVERY.md for DDD architecture

---
 GEMINI.md   | 13 +++++++++++++
 RECOVERY.md | 23 +++++++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 GEMINI.md
 create mode 100644 RECOVERY.md

diff --git a/GEMINI.md b/GEMINI.md
new file mode 100644
index 0000000..23ad860
--- /dev/null
+++ b/GEMINI.md
@@ -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.
\ No newline at end of file
diff --git a/RECOVERY.md b/RECOVERY.md
new file mode 100644
index 0000000..7fc374b
--- /dev/null
+++ b/RECOVERY.md
@@ -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/`.
\ No newline at end of file