init

2025-10-12 23:15:09 +03:00
commit 09cdd06307
88 changed files with 15007 additions and 0 deletions
@@ -0,0 +1,132 @@
+# 🚀 Быстрый запуск проекта
+
+## Требования
+- Python 3.11+
+- Node.js 18+
+- Ollama установлен
+
+## Шаг 1: Ollama
+
+Откройте **терминал 1**:
+
+```bash
+ollama serve
+```
+
+Оставьте терминал открытым.
+
+## Шаг 2: Backend
+
+Откройте **терминал 2**:
+
+```bash
+cd backend
+
+# Активируйте виртуальное окружение
+source venv/Scripts/activate  # Git Bash/Linux/Mac
+# ИЛИ
+venv\Scripts\activate  # Windows CMD
+
+# Запустите backend
+python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+```
+
+Дождитесь сообщения:
+```
+INFO:     Uvicorn running on http://0.0.0.0:8000
+INFO:     Application startup complete.
+```
+
+## Шаг 3: Frontend
+
+Откройте **терминал 3**:
+
+```bash
+cd frontend
+
+# Запустите frontend
+npm run dev
+```
+
+Дождитесь:
+```
+  ➜  Local:   http://localhost:5173/
+```
+
+## 🌐 Доступ
+
+- **Frontend UI**: http://localhost:5173
+- **Backend API**: http://localhost:8000
+- **API Docs**: http://localhost:8000/docs
+- **Ollama**: http://localhost:11434
+
+## 📝 Первое использование
+
+1. Откройте http://localhost:5173
+2. Перейдите в **Репозитории**
+3. Нажмите **+ Добавить репозиторий**
+4. Заполните данные:
+   - Название: `my-project`
+   - Платформа: `Gitea`
+   - URL: `https://your-gitea.com/owner/repo`
+   - API токен: ваш токен из Gitea
+5. Нажмите **Добавить**
+6. Скопируйте **Webhook URL** из карточки
+7. Настройте webhook в Gitea (Settings → Webhooks → Add Webhook)
+
+## 🔍 Ручная проверка
+
+После добавления репозитория можете:
+1. Нажать кнопку **🔍 Проверить сейчас**
+2. Система найдет все открытые PR и запустит ревью
+
+## ⚠️ Важно
+
+Если вы изменили `ENCRYPTION_KEY` в `.env` файле и получаете ошибку при расшифровке токенов:
+
+1. Удалите базу данных:
+   ```bash
+   cd backend
+   rm review.db
+   ```
+
+2. Перезапустите backend - база создастся автоматически
+
+3. Добавьте репозитории заново
+
+## 🐛 Устранение проблем
+
+### Backend не запускается
+
+```bash
+cd backend
+source venv/Scripts/activate
+python -c "from app.main import app; print('OK')"
+```
+
+Если ошибка - проверьте `.env` файл.
+
+### Frontend не подключается
+
+```bash
+# Проверьте что backend запущен
+curl http://localhost:8000/health
+```
+
+### Ollama не отвечает
+
+```bash
+ollama list
+```
+
+Если пусто - установите модель:
+```bash
+ollama pull codellama:7b
+```
+
+## 📚 Документация
+
+- [README.md](README.md) - полная документация
+- [QUICKSTART.md](QUICKSTART.md) - быстрый старт
+- [COMMANDS.md](COMMANDS.md) - все команды
+