code-review-agent/docs/START_PROJECT.md

133 lines
3.1 KiB
Markdown

# 🚀 Быстрый запуск проекта
## Требования
- 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) - все команды