Initial commit: VoIdeaAI - voice-first AI idea assistant

template/docs/runbook/03-incident.md

@@ -0,0 +1,53 @@
+# Runbook: Инциденты
+
+---
+
+## Сервис недоступен
+
+```bash
+# 1. Проверить что процесс жив
+ps aux | grep uvicorn
+
+# 2. Проверить логи
+journalctl -u voidea -n 50 --no-pager
+
+# 3. Перезапустить
+systemctl restart voidea
+
+# 4. Проверить
+curl http://localhost:8020/health
+
+# 5. Если не помогло → rollback
+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 < backup.sql
+```
+
+## Высокая загрузка CPU
+
+```bash
+# 1. Найти процесс
+top -o %CPU
+
+# 2. Найти endpoint
+tail -n 100 /var/log/voidea/access.log
+
+# 3. Временно отключить (если endpoint не критичен)
+
+# 4. Разбираться после восстановления
+```