Initial commit: VoIdeaAI - voice-first AI idea assistant

template/docs/runbook/01-startup.md

@@ -0,0 +1,35 @@
+# Runbook: Запуск проекта
+
+---
+
+## Первый запуск
+
+```bash
+# 1. Клонировать репозиторий
+git clone <repo> && cd <repo>
+
+# 2. Настроить окружение
+cp .env.example .env
+# Редактировать .env: JWT_SECRET_KEY, DATABASE_URL
+
+# 3. Установить зависимости
+pip install -r requirements.txt
+
+# 4. Запустить
+uvicorn app.main:app --reload --host 0.0.0.0 --port 8020
+```
+
+## Проверка
+
+```bash
+curl http://localhost:8020/health
+# → {"status": "healthy"}
+curl http://localhost:8020/docs
+# → Swagger UI
+```
+
+## Остановка
+
+```bash
+Ctrl+C  # или kill $(pgrep -f uvicorn)
+```