Initial commit: VoIdeaAI - voice-first AI idea assistant

docs/runbook/05-update.md

@@ -0,0 +1,64 @@
+# Runbook: Обновление
+
+## Стандартное обновление
+
+```bash
+# 1. Забрать новую версию
+cd /opt/voidea
+git pull origin main
+
+# 2. Активировать виртуальное окружение
+source venv/bin/activate
+
+# 3. Обновить зависимости
+pip install -r requirements.txt
+
+# 4. Применить миграции БД
+alembic upgrade head
+
+# 5. Перезапустить сервис
+systemctl restart voidea
+
+# 6. Проверить health
+curl http://localhost:8020/api/v1/health
+```
+
+## Обновление с минимальным даунтаймом
+
+```bash
+# 1. Запустить второй инстанс на другом порту
+DATABASE_URL=... uvicorn app.main:app --port 8021 &
+
+# 2. Проверить его health
+curl http://localhost:8021/health
+
+# 3. Переключить systemd или Nginx на новый порт
+# 4. Остановить старый
+```
+
+## Откат
+
+```bash
+# 1. Откатить код
+cd /opt/voidea
+git revert HEAD
+
+# 2. Откатить БД (если была миграция)
+alembic downgrade -1
+
+# 3. Перезапустить
+systemctl restart voidea
+```
+
+## Миграция БД
+
+```bash
+# Сгенерировать новую миграцию
+alembic revision --autogenerate -m "description"
+
+# Применить
+alembic upgrade head
+
+# Откатить
+alembic downgrade -1
+```