Initial commit: VoIdeaAI - voice-first AI idea assistant

docs/runbook/03-incident.md

@@ -0,0 +1,59 @@
+# Runbook: Инциденты
+
+## Сервис недоступен
+
+```bash
+# 1. Проверить что процесс жив
+systemctl status voidea
+
+# 2. Проверить логи
+journalctl -u voidea -n 50 --no-pager
+
+# 3. Перезапустить
+systemctl restart voidea
+
+# 4. Проверить health
+curl http://localhost:8020/health
+
+# 5. Если не помогло — rollback
+cd /opt/voidea
+git checkout <previous-stable-tag>
+systemctl restart voidea
+```
+
+## База данных недоступна
+
+```bash
+# 1. Проверить PostgreSQL
+systemctl status postgresql
+
+# 2. Проверить логи
+journalctl -u postgresql -n 50
+
+# 3. Перезапустить
+systemctl restart postgresql
+
+# 4. Если повреждена — восстановить из backup
+psql -U voidea -d voidea < /backups/voidea.20260511.sql
+```
+
+## AI провайдер недоступен
+
+- FallbackChain автоматически пробует YandexGPT → GigaChat
+- Если оба недоступны — возвращается AgentResult(success=False)
+- Пользователь получает уведомление, анализ не блокируется
+
+## Высокая загрузка CPU
+
+```bash
+# 1. Найти процесс
+top -o %CPU
+
+# 2. Проверить какие endpoint'ы нагружают
+tail -n 100 /var/log/voidea/access.log
+
+# 3. Временно ограничить: увеличить число воркеров или перезапустить
+systemctl restart voidea
+
+# 4. Разбираться после восстановления
+```