feat: Add review events persistence, version display, and auto-versioning system
This commit is contained in:
Primakov Alexandr Alexandrovich
261
docs/ARCHITECTURE.md
Normal file
261
docs/ARCHITECTURE.md
Normal file
@@ -0,0 +1,261 @@
|
||||
# Архитектура AI Code Review Agent
|
||||
|
||||
## Общая схема
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ User │
|
||||
└───────────────────────────┬─────────────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌────────────────┐
|
||||
│ Frontend │
|
||||
│ React + WS │
|
||||
└────────┬───────┘
|
||||
│
|
||||
▼
|
||||
┌────────────────┐
|
||||
│ FastAPI │
|
||||
│ Backend │
|
||||
└────┬───┬───┬───┘
|
||||
│ │ │
|
||||
┌───────────────┘ │ └───────────────┐
|
||||
▼ ▼ ▼
|
||||
┌───────────────┐ ┌────────────────┐ ┌───────────────┐
|
||||
│ Git Platform │ │ LangGraph │ │ Database │
|
||||
│ (Webhook) │ │ Agent │ │ SQLite │
|
||||
└───────────────┘ └────────┬───────┘ └───────────────┘
|
||||
│
|
||||
▼
|
||||
┌────────────────┐
|
||||
│ Ollama │
|
||||
│ (codellama) │
|
||||
└────────────────┘
|
||||
```
|
||||
|
||||
## Backend архитектура
|
||||
|
||||
### 1. FastAPI Layer
|
||||
|
||||
**Отвечает за:**
|
||||
- HTTP endpoints
|
||||
- WebSocket connections
|
||||
- CORS и middleware
|
||||
- Request validation
|
||||
|
||||
**Компоненты:**
|
||||
- `app/main.py` - главное приложение
|
||||
- `app/api/` - REST endpoints
|
||||
- `app/database.py` - DB session management
|
||||
|
||||
### 2. Agent Layer (LangGraph)
|
||||
|
||||
**Отвечает за:**
|
||||
- Workflow управление
|
||||
- Анализ кода через LLM
|
||||
- Генерация комментариев
|
||||
|
||||
**Компоненты:**
|
||||
- `app/agents/reviewer.py` - главный агент
|
||||
- `app/agents/tools.py` - инструменты (анализ кода)
|
||||
- `app/agents/prompts.py` - промпты для LLM
|
||||
|
||||
**Граф агента:**
|
||||
```
|
||||
START
|
||||
│
|
||||
├─► fetch_pr_info (получение PR)
|
||||
│
|
||||
├─► fetch_files (список файлов)
|
||||
│
|
||||
├─► analyze_files (анализ через Ollama)
|
||||
│
|
||||
├─► post_comments (отправка комментариев)
|
||||
│
|
||||
└─► complete_review (завершение)
|
||||
│
|
||||
END
|
||||
```
|
||||
|
||||
### 3. Service Layer
|
||||
|
||||
**Отвечает за:**
|
||||
- Интеграция с Git платформами
|
||||
- API запросы к Gitea/GitHub/Bitbucket
|
||||
|
||||
**Компоненты:**
|
||||
- `app/services/base.py` - базовый класс
|
||||
- `app/services/gitea.py` - Gitea API
|
||||
- `app/services/github.py` - GitHub API
|
||||
- `app/services/bitbucket.py` - Bitbucket API
|
||||
|
||||
### 4. Data Layer
|
||||
|
||||
**Отвечает за:**
|
||||
- Хранение данных
|
||||
- ORM операции
|
||||
|
||||
**Модели:**
|
||||
- `Repository` - репозитории
|
||||
- `PullRequest` - PR
|
||||
- `Review` - ревью
|
||||
- `Comment` - комментарии
|
||||
|
||||
## Frontend архитектура
|
||||
|
||||
### 1. Router Layer
|
||||
|
||||
**React Router для навигации:**
|
||||
- `/` - Dashboard
|
||||
- `/repositories` - управление репозиториями
|
||||
- `/reviews` - список ревью
|
||||
- `/reviews/:id` - детали ревью
|
||||
|
||||
### 2. State Management
|
||||
|
||||
**TanStack Query для сервер-стейта:**
|
||||
- Кеширование данных
|
||||
- Auto-refetch
|
||||
- Optimistic updates
|
||||
|
||||
### 3. WebSocket Layer
|
||||
|
||||
**Real-time обновления:**
|
||||
- Singleton WebSocket клиент
|
||||
- Event-based подписки
|
||||
- Auto-reconnect
|
||||
|
||||
### 4. UI Components
|
||||
|
||||
**Переиспользуемые компоненты:**
|
||||
- `RepositoryForm` - форма добавления
|
||||
- `ReviewProgress` - прогресс бар
|
||||
- `CommentsList` - список комментариев
|
||||
- `WebSocketStatus` - статус подключения
|
||||
|
||||
## Поток данных
|
||||
|
||||
### Webhook → Review flow
|
||||
|
||||
```
|
||||
1. Git Platform отправляет webhook
|
||||
POST /api/webhooks/{platform}/{repo_id}
|
||||
|
||||
2. Webhook handler создает Review
|
||||
- Сохраняет PR в DB
|
||||
- Создает Review запись
|
||||
- Запускает background task
|
||||
|
||||
3. Background task запускает LangGraph агент
|
||||
- Получает информацию о PR
|
||||
- Скачивает измененные файлы
|
||||
- Анализирует через Ollama
|
||||
- Генерирует комментарии
|
||||
|
||||
4. Agent сохраняет комментарии в DB
|
||||
|
||||
5. Agent отправляет комментарии в PR
|
||||
|
||||
6. WebSocket broadcast обновлений
|
||||
|
||||
7. Frontend обновляет UI
|
||||
```
|
||||
|
||||
## Безопасность
|
||||
|
||||
### 1. Encryption
|
||||
|
||||
API токены шифруются перед сохранением (Fernet):
|
||||
```python
|
||||
cipher = Fernet(key)
|
||||
encrypted = cipher.encrypt(token.encode())
|
||||
```
|
||||
|
||||
### 2. Webhook Validation
|
||||
|
||||
Каждый webhook проверяется по signature:
|
||||
```python
|
||||
signature = hmac.new(secret, payload, hashlib.sha256)
|
||||
```
|
||||
|
||||
### 3. CORS
|
||||
|
||||
Только разрешенные origins в `settings.cors_origins`
|
||||
|
||||
## Масштабирование
|
||||
|
||||
### Horizontal scaling
|
||||
|
||||
1. **Multiple workers**
|
||||
```bash
|
||||
uvicorn app.main:app --workers 4
|
||||
```
|
||||
|
||||
2. **Queue system**
|
||||
- Celery для background tasks
|
||||
- Redis для очередей
|
||||
|
||||
3. **Database**
|
||||
- Миграция на PostgreSQL
|
||||
- Connection pooling
|
||||
|
||||
### Vertical scaling
|
||||
|
||||
- Увеличение ресурсов Ollama
|
||||
- Использование более мощных GPU
|
||||
- Оптимизация промптов
|
||||
|
||||
## Мониторинг
|
||||
|
||||
### Метрики
|
||||
|
||||
- Количество ревью
|
||||
- Среднее время ревью
|
||||
- Количество комментариев
|
||||
- Ошибки
|
||||
|
||||
### Логи
|
||||
|
||||
```python
|
||||
import logging
|
||||
logger = logging.getLogger(__name__)
|
||||
logger.info("Review started", extra={"review_id": id})
|
||||
```
|
||||
|
||||
## Deployment
|
||||
|
||||
### Development
|
||||
- SQLite
|
||||
- Local Ollama
|
||||
- Dev сервер
|
||||
|
||||
### Production
|
||||
- PostgreSQL
|
||||
- Redis
|
||||
- Nginx reverse proxy
|
||||
- Systemd services
|
||||
- HTTPS
|
||||
- Rate limiting
|
||||
|
||||
## Будущие улучшения
|
||||
|
||||
1. **Множественные LLM**
|
||||
- Поддержка OpenAI, Anthropic
|
||||
- Выбор модели на уровне репозитория
|
||||
|
||||
2. **Настраиваемые правила**
|
||||
- YAML конфиг с правилами
|
||||
- Custom промпты
|
||||
|
||||
3. **Кеширование**
|
||||
- Redis для результатов анализа
|
||||
- Избежание повторного анализа
|
||||
|
||||
4. **Metrics & Analytics**
|
||||
- Prometheus metrics
|
||||
- Grafana dashboards
|
||||
|
||||
5. **Notifications**
|
||||
- Email уведомления
|
||||
- Slack/Discord интеграция
|
||||
|
||||
127
docs/CHANGELOG.md
Normal file
127
docs/CHANGELOG.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# Changelog
|
||||
|
||||
## 2025-10-10 - Улучшения UI и функционала
|
||||
|
||||
### ✨ Новые возможности
|
||||
|
||||
#### 1. Модальные окна
|
||||
- **Создан компонент `Modal`** - универсальное модальное окно с типами: info, success, error, warning
|
||||
- **Создан компонент `ConfirmModal`** - модальное окно подтверждения с кнопками действий
|
||||
- **Заменены все `alert()` и `confirm()`** на красивые модальные окна
|
||||
- Добавлена анимация появления модалок
|
||||
|
||||
#### 2. Повторное ревью
|
||||
- **Добавлена кнопка "🔄 Повторить ревью"**:
|
||||
- Отображается для завершенных ревью
|
||||
- Отображается для упавших ревью (с ошибками)
|
||||
- **Backend endpoint** для повторного запуска: `POST /api/reviews/{review_id}/retry`
|
||||
- Модальное подтверждение перед повторным запуском
|
||||
|
||||
#### 3. Улучшенные промпты AI
|
||||
- **Более строгий системный промпт** - агент теперь внимательнее к деталям
|
||||
- **Детальный diff review промпт** с конкретными примерами:
|
||||
- Находит опечатки (например, `'shmapplication/json'`)
|
||||
- Находит незакрытые скобки в JSX
|
||||
- Находит неправильное использование React key
|
||||
- Находит нарушения синтаксиса
|
||||
|
||||
#### 4. Улучшенные комментарии в PR
|
||||
- Агент **ВСЕГДА оставляет комментарий** в PR:
|
||||
- Если нашел проблемы: подробный список с severity
|
||||
- Если не нашел: "✅ Серьезных проблем не найдено!"
|
||||
- **Красивый summary** с подсчетом:
|
||||
```
|
||||
🤖 AI Code Review завершен
|
||||
|
||||
Найдено проблем: 3
|
||||
- ❌ Критичных: 2
|
||||
- ⚠️ Важных: 1
|
||||
|
||||
Проанализировано файлов: 2
|
||||
```
|
||||
|
||||
### 🐛 Исправления
|
||||
|
||||
#### 1. Исправлена критическая ошибка с токенами
|
||||
- **Проблема**: API токены передавались в зашифрованном виде в Git сервисы
|
||||
- **Решение**: Добавлена расшифровка токенов перед использованием в `ReviewerAgent._get_git_service()`
|
||||
- **Результат**: Gitea/GitHub/Bitbucket API теперь принимают токены (401 ошибка исправлена)
|
||||
|
||||
#### 2. Исправлена ошибка парсинга CORS
|
||||
- **Проблема**: `pydantic-settings` не мог распарсить `cors_origins`
|
||||
- **Решение**: Добавлен validator для поддержки разных форматов:
|
||||
- Через запятую: `http://localhost:5173,http://localhost:3000`
|
||||
- JSON массив: `["http://localhost:5173"]`
|
||||
- Одиночная строка: `http://localhost:5173`
|
||||
|
||||
### 📁 Новые файлы
|
||||
|
||||
- `frontend/src/components/Modal.tsx` - Компоненты модальных окон
|
||||
- `START_PROJECT.md` - Упрощенная инструкция по запуску
|
||||
- `CHANGELOG.md` - Этот файл
|
||||
|
||||
### 🔄 Измененные файлы
|
||||
|
||||
**Backend:**
|
||||
- `backend/app/config.py` - Добавлен validator для cors_origins
|
||||
- `backend/app/utils.py` - Добавлена обработка ошибок расшифровки
|
||||
- `backend/app/agents/reviewer.py` - Расшифровка токенов, улучшенная логика комментариев
|
||||
- `backend/app/agents/prompts.py` - Улучшенные промпты для AI
|
||||
- `backend/app/api/repositories.py` - Обработка ошибок расшифровки
|
||||
- `backend/.env` - Правильный формат конфигурации
|
||||
|
||||
**Frontend:**
|
||||
- `frontend/src/index.css` - Анимация для модалок
|
||||
- `frontend/src/pages/Repositories.tsx` - Использование модалок
|
||||
- `frontend/src/pages/Reviews.tsx` - Функционал повторного ревью + модалки
|
||||
- `frontend/src/components/ReviewList.tsx` - Кнопка "Повторить ревью"
|
||||
- `frontend/src/api/client.ts` - Добавлен метод `retryReview()`
|
||||
|
||||
### 🎨 UI/UX улучшения
|
||||
|
||||
1. **Модальные окна** вместо системных alert/confirm
|
||||
2. **Индикаторы загрузки** в модалках подтверждения
|
||||
3. **Кнопка повторного ревью** для упавших/завершенных ревью
|
||||
4. **Анимированное появление** модалок
|
||||
5. **Цветовая индикация** типа модалки (success/error/warning/info)
|
||||
|
||||
### 🧪 Как протестировать
|
||||
|
||||
#### Модальные окна:
|
||||
1. Добавьте репозиторий - увидите success модалку
|
||||
2. Удалите репозиторий - появится confirm модалка
|
||||
3. Попробуйте сканировать - появится confirm модалка
|
||||
|
||||
#### Повторное ревью:
|
||||
1. Перейдите в **Ревью**
|
||||
2. Найдите завершенное или упавшее ревью
|
||||
3. Нажмите **🔄 Повторить** (или **🔄 Повторить ревью**)
|
||||
4. Подтвердите в модалке
|
||||
5. Ревью запустится заново
|
||||
|
||||
#### Улучшенный AI:
|
||||
1. Создайте PR с ошибками:
|
||||
- Опечатка в строке (например, `'shmapplication/json'`)
|
||||
- Незакрытая скобка в JSX
|
||||
- Неправильный `key` в React списке
|
||||
2. Запустите ревью
|
||||
3. Агент должен найти ВСЕ эти проблемы и прокомментировать
|
||||
|
||||
### 📊 Метрики
|
||||
|
||||
- **Добавлено**: ~500 строк кода
|
||||
- **Изменено**: ~15 файлов
|
||||
- **Новых компонентов**: 2 (Modal, ConfirmModal)
|
||||
- **Новых API методов**: 1 (retryReview)
|
||||
- **Исправлено критических багов**: 2
|
||||
|
||||
### 🚀 Следующие шаги
|
||||
|
||||
Потенциальные улучшения:
|
||||
- [ ] Добавить настройки агента (temperature, model)
|
||||
- [ ] Webhook автоматическое создание при добавлении репозитория
|
||||
- [ ] Фильтрация файлов для ревью (ignore patterns)
|
||||
- [ ] Кастомные правила ревью
|
||||
- [ ] История изменений репозитория
|
||||
- [ ] Email уведомления о завершении ревью
|
||||
|
||||
226
docs/CHANGELOG_ORGANIZATIONS.md
Normal file
226
docs/CHANGELOG_ORGANIZATIONS.md
Normal file
@@ -0,0 +1,226 @@
|
||||
# 📝 Changelog: Организации и Очередь задач
|
||||
|
||||
## 🎉 Добавлено
|
||||
|
||||
### Backend
|
||||
|
||||
#### Новые модели:
|
||||
- ✅ `Organization` - модель для организаций (Gitea/GitHub/Bitbucket)
|
||||
- ✅ `ReviewTask` - модель для очереди задач review
|
||||
|
||||
#### Новые API endpoints:
|
||||
- ✅ `GET /api/organizations` - список организаций
|
||||
- ✅ `POST /api/organizations` - создать организацию
|
||||
- ✅ `GET /api/organizations/{id}` - получить организацию
|
||||
- ✅ `PUT /api/organizations/{id}` - обновить организацию
|
||||
- ✅ `DELETE /api/organizations/{id}` - удалить организацию
|
||||
- ✅ `POST /api/organizations/{id}/scan` - сканировать организацию
|
||||
|
||||
- ✅ `GET /api/tasks` - список задач в очереди
|
||||
- ✅ `GET /api/tasks?status=pending` - фильтр по статусу
|
||||
- ✅ `GET /api/tasks/worker/status` - статус worker'а
|
||||
- ✅ `POST /api/tasks/{id}/retry` - повторить задачу
|
||||
- ✅ `DELETE /api/tasks/{id}` - удалить задачу
|
||||
|
||||
#### Task Worker:
|
||||
- ✅ Фоновый worker для последовательной обработки задач
|
||||
- ✅ Гарантия: только 1 review одновременно
|
||||
- ✅ Поддержка приоритетов (HIGH > NORMAL > LOW)
|
||||
- ✅ Автоматический retry при ошибках (до 3 попыток)
|
||||
- ✅ FIFO при равном приоритете
|
||||
- ✅ Автозапуск при старте приложения
|
||||
|
||||
#### Сканирование организаций:
|
||||
- ✅ Автоматический поиск всех репозиториев в организации
|
||||
- ✅ Автоматический поиск всех открытых PR
|
||||
- ✅ Автоматическое создание задач на review
|
||||
- ✅ Поддержка Gitea (GitHub и Bitbucket - заглушки)
|
||||
|
||||
### Frontend
|
||||
|
||||
#### Новые страницы:
|
||||
- ✅ `/organizations` - управление организациями
|
||||
- ✅ `/tasks` - мониторинг очереди задач
|
||||
|
||||
#### Новые компоненты:
|
||||
- ✅ `Organizations.tsx` - страница организаций с CRUD
|
||||
- ✅ `Tasks.tsx` - страница очереди задач с мониторингом
|
||||
- ✅ `OrganizationForm` - форма создания/редактирования организации
|
||||
|
||||
#### Новые типы:
|
||||
- ✅ `Organization` - тип организации
|
||||
- ✅ `OrganizationCreate` / `OrganizationUpdate` - типы для CRUD
|
||||
- ✅ `ReviewTask` - тип задачи review
|
||||
- ✅ `TaskStatus` / `TaskPriority` - типы статусов и приоритетов
|
||||
- ✅ `WorkerStatus` - тип статуса worker'а
|
||||
|
||||
#### API клиент:
|
||||
- ✅ `getOrganizations()` - получить список
|
||||
- ✅ `createOrganization()` - создать
|
||||
- ✅ `updateOrganization()` - обновить
|
||||
- ✅ `deleteOrganization()` - удалить
|
||||
- ✅ `scanOrganization()` - сканировать
|
||||
- ✅ `getTasks()` - получить задачи
|
||||
- ✅ `getWorkerStatus()` - статус worker'а
|
||||
- ✅ `retryTask()` - повторить
|
||||
- ✅ `deleteTask()` - удалить
|
||||
|
||||
#### UI улучшения:
|
||||
- ✅ Навигация обновлена: добавлены пункты "Организации" и "Очередь"
|
||||
- ✅ Модальные окна исправлены (был баг с `onCancel`)
|
||||
- ✅ Real-time обновление статистики задач (каждые 5 секунд)
|
||||
- ✅ Фильтрация задач по статусу
|
||||
- ✅ Визуализация статуса worker'а
|
||||
|
||||
### Документация
|
||||
|
||||
- ✅ `ORGANIZATION_FEATURE.md` - подробная документация
|
||||
- ✅ `ORGANIZATION_QUICKSTART.md` - быстрый старт
|
||||
- ✅ `backend/migrate.py` - скрипт миграции БД
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Исправления
|
||||
|
||||
### Frontend
|
||||
- 🐛 Исправлены ошибки в компонентах `Modal` и `ConfirmModal`
|
||||
- `onCancel` → `onClose`
|
||||
- `message` prop → `title` + `children`
|
||||
- 🐛 Удален неиспользуемый импорт `ReviewTask` из `organizations.ts`
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Ключевые фичи
|
||||
|
||||
### 1. Организации
|
||||
```
|
||||
Добавление целой организации → Автосканирование всех репозиториев
|
||||
→ Поиск всех PR → Создание задач на review
|
||||
```
|
||||
|
||||
### 2. Очередь задач
|
||||
```
|
||||
Задачи в очереди → Worker берет по одной → Выполняет review
|
||||
→ Публикует комментарии → Переходит к следующей
|
||||
```
|
||||
|
||||
### 3. Гарантии
|
||||
- ✅ **Один review одновременно** - не перегружаем Ollama
|
||||
- ✅ **Приоритеты** - важные PR обрабатываются быстрее
|
||||
- ✅ **Retry** - автоматические повторы при ошибках
|
||||
- ✅ **Мониторинг** - видно состояние очереди и worker'а
|
||||
|
||||
---
|
||||
|
||||
## 📊 Статистика изменений
|
||||
|
||||
### Backend:
|
||||
- **Новых файлов**: 5
|
||||
- `models/organization.py`
|
||||
- `models/review_task.py`
|
||||
- `api/organizations.py`
|
||||
- `api/tasks.py`
|
||||
- `workers/task_worker.py`
|
||||
- **Изменено файлов**: 3
|
||||
- `models/__init__.py`
|
||||
- `api/__init__.py`
|
||||
- `main.py`
|
||||
|
||||
### Frontend:
|
||||
- **Новых файлов**: 3
|
||||
- `pages/Organizations.tsx`
|
||||
- `pages/Tasks.tsx`
|
||||
- `types/organization.ts`
|
||||
- **Изменено файлов**: 3
|
||||
- `App.tsx`
|
||||
- `api/organizations.ts`
|
||||
- `pages/Tasks.tsx` (исправления)
|
||||
|
||||
### Документация:
|
||||
- **Новых файлов**: 3
|
||||
- `ORGANIZATION_FEATURE.md`
|
||||
- `ORGANIZATION_QUICKSTART.md`
|
||||
- `CHANGELOG_ORGANIZATIONS.md`
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Как использовать
|
||||
|
||||
### 1. Миграция БД
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
./venv/Scripts/python.exe migrate.py
|
||||
```
|
||||
|
||||
### 2. Запуск проекта
|
||||
|
||||
```bash
|
||||
# Windows
|
||||
start.bat
|
||||
|
||||
# Linux/Mac
|
||||
./start.sh
|
||||
```
|
||||
|
||||
### 3. Добавить организацию
|
||||
|
||||
1. Открыть http://localhost:8000
|
||||
2. Перейти в **🏢 Организации**
|
||||
3. Нажать **➕ Добавить организацию**
|
||||
4. Заполнить форму
|
||||
5. Нажать **🔍 Сканировать**
|
||||
|
||||
### 4. Мониторинг
|
||||
|
||||
1. Перейти в **📝 Очередь задач**
|
||||
2. Следить за прогрессом
|
||||
3. Видеть статус worker'а
|
||||
4. Фильтровать по статусу
|
||||
|
||||
---
|
||||
|
||||
## ✅ Тестирование
|
||||
|
||||
### Проверено:
|
||||
- ✅ Создание организации
|
||||
- ✅ Сканирование организации (Gitea)
|
||||
- ✅ Создание задач на review
|
||||
- ✅ Последовательная обработка задач
|
||||
- ✅ Worker запускается и останавливается
|
||||
- ✅ Retry при ошибках
|
||||
- ✅ Frontend собирается без ошибок
|
||||
- ✅ Модальные окна работают корректно
|
||||
|
||||
### Требует тестирования:
|
||||
- ⏳ Полный цикл review через очередь
|
||||
- ⏳ Приоритеты задач
|
||||
- ⏳ Масштабирование (много задач)
|
||||
- ⏳ GitHub и Bitbucket организации
|
||||
|
||||
---
|
||||
|
||||
## 📝 TODO для будущих улучшений
|
||||
|
||||
- [ ] Реализовать сканирование GitHub организаций
|
||||
- [ ] Реализовать сканирование Bitbucket организаций
|
||||
- [ ] Добавить настройку приоритетов вручную
|
||||
- [ ] Добавить паузу/возобновление worker'а
|
||||
- [ ] Добавить планирование сканирований (cron)
|
||||
- [ ] Добавить webhook для организаций
|
||||
- [ ] Добавить статистику по организациям
|
||||
- [ ] Добавить логи worker'а в UI
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Результат
|
||||
|
||||
Теперь можно:
|
||||
1. ✅ Добавлять организации целиком
|
||||
2. ✅ Сканировать все репозитории одной кнопкой
|
||||
3. ✅ Автоматически ставить все PR в очередь
|
||||
4. ✅ Обрабатывать review последовательно
|
||||
5. ✅ Мониторить прогресс в реальном времени
|
||||
|
||||
**Один клик → Вся организация на review!** 🚀
|
||||
|
||||
367
docs/COMMANDS.md
Normal file
367
docs/COMMANDS.md
Normal file
@@ -0,0 +1,367 @@
|
||||
# Полезные команды
|
||||
|
||||
## Backend
|
||||
|
||||
### Разработка
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
|
||||
# Активация venv
|
||||
source venv/bin/activate # Linux/Mac
|
||||
venv\Scripts\activate # Windows
|
||||
|
||||
# Установка зависимостей
|
||||
pip install -r requirements.txt
|
||||
|
||||
# Запуск сервера
|
||||
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
|
||||
|
||||
# Или используйте скрипт
|
||||
./start.sh # Linux/Mac
|
||||
start.bat # Windows
|
||||
```
|
||||
|
||||
### База данных
|
||||
|
||||
```bash
|
||||
# Создание миграции (если используется Alembic)
|
||||
alembic revision --autogenerate -m "description"
|
||||
|
||||
# Применение миграций
|
||||
alembic upgrade head
|
||||
|
||||
# Откат миграции
|
||||
alembic downgrade -1
|
||||
|
||||
# Удаление базы
|
||||
rm review.db
|
||||
```
|
||||
|
||||
### Тестирование API
|
||||
|
||||
```bash
|
||||
# Health check
|
||||
curl http://localhost:8000/health
|
||||
|
||||
# Список репозиториев
|
||||
curl http://localhost:8000/api/repositories
|
||||
|
||||
# Создание репозитория
|
||||
curl -X POST http://localhost:8000/api/repositories \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"name": "test-repo",
|
||||
"platform": "gitea",
|
||||
"url": "https://git.example.com/owner/repo",
|
||||
"api_token": "your-token"
|
||||
}'
|
||||
|
||||
# Список ревью
|
||||
curl http://localhost:8000/api/reviews
|
||||
|
||||
# Статистика
|
||||
curl http://localhost:8000/api/reviews/stats/dashboard
|
||||
```
|
||||
|
||||
## Frontend
|
||||
|
||||
### Разработка
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
|
||||
# Установка зависимостей
|
||||
npm install
|
||||
|
||||
# Запуск dev сервера
|
||||
npm run dev
|
||||
|
||||
# Или используйте скрипт
|
||||
./start.sh # Linux/Mac
|
||||
start.bat # Windows
|
||||
|
||||
# Сборка
|
||||
npm run build
|
||||
|
||||
# Предпросмотр сборки
|
||||
npm run preview
|
||||
```
|
||||
|
||||
### Линтинг и проверка
|
||||
|
||||
```bash
|
||||
# ESLint
|
||||
npm run lint
|
||||
|
||||
# TypeScript проверка
|
||||
npx tsc --noEmit
|
||||
|
||||
# Форматирование (если используется Prettier)
|
||||
npx prettier --write src/
|
||||
```
|
||||
|
||||
## Ollama
|
||||
|
||||
### Управление моделями
|
||||
|
||||
```bash
|
||||
# Список моделей
|
||||
ollama list
|
||||
|
||||
# Загрузка модели
|
||||
ollama pull codellama
|
||||
ollama pull llama3
|
||||
|
||||
# Удаление модели
|
||||
ollama rm codellama
|
||||
|
||||
# Информация о модели
|
||||
ollama show codellama
|
||||
|
||||
# Запуск сервера
|
||||
ollama serve
|
||||
```
|
||||
|
||||
### Тестирование модели
|
||||
|
||||
```bash
|
||||
# Интерактивный режим
|
||||
ollama run codellama
|
||||
|
||||
# Одиночный запрос
|
||||
ollama run codellama "Review this code: def add(a, b): return a + b"
|
||||
```
|
||||
|
||||
## Docker (если будет добавлен)
|
||||
|
||||
```bash
|
||||
# Сборка
|
||||
docker-compose build
|
||||
|
||||
# Запуск
|
||||
docker-compose up -d
|
||||
|
||||
# Остановка
|
||||
docker-compose down
|
||||
|
||||
# Просмотр логов
|
||||
docker-compose logs -f backend
|
||||
docker-compose logs -f frontend
|
||||
|
||||
# Перезапуск
|
||||
docker-compose restart
|
||||
```
|
||||
|
||||
## Git
|
||||
|
||||
```bash
|
||||
# Клонирование
|
||||
git clone <repo-url>
|
||||
cd platform/review
|
||||
|
||||
# Создание feature branch
|
||||
git checkout -b feature/my-feature
|
||||
|
||||
# Коммит изменений
|
||||
git add .
|
||||
git commit -m "feat: Add new feature"
|
||||
|
||||
# Push
|
||||
git push origin feature/my-feature
|
||||
|
||||
# Обновление из main
|
||||
git checkout main
|
||||
git pull
|
||||
git checkout feature/my-feature
|
||||
git merge main
|
||||
```
|
||||
|
||||
## Мониторинг
|
||||
|
||||
### Логи
|
||||
|
||||
```bash
|
||||
# Backend логи (если настроены)
|
||||
tail -f logs/app.log
|
||||
|
||||
# Логи Ollama
|
||||
journalctl -u ollama -f
|
||||
|
||||
# Системные логи
|
||||
dmesg | tail
|
||||
```
|
||||
|
||||
### Процессы
|
||||
|
||||
```bash
|
||||
# Проверка запущенных процессов
|
||||
ps aux | grep uvicorn
|
||||
ps aux | grep ollama
|
||||
|
||||
# Проверка портов
|
||||
lsof -i :8000
|
||||
lsof -i :5173
|
||||
lsof -i :11434
|
||||
|
||||
# На Windows
|
||||
netstat -ano | findstr :8000
|
||||
```
|
||||
|
||||
### Ресурсы
|
||||
|
||||
```bash
|
||||
# CPU и память
|
||||
top
|
||||
htop
|
||||
|
||||
# Диск
|
||||
df -h
|
||||
du -sh *
|
||||
|
||||
# На Windows
|
||||
taskmgr
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Backend не запускается
|
||||
|
||||
```bash
|
||||
# Проверка Python
|
||||
python --version # должен быть 3.11+
|
||||
|
||||
# Проверка зависимостей
|
||||
pip list
|
||||
|
||||
# Переустановка зависимостей
|
||||
pip install --force-reinstall -r requirements.txt
|
||||
|
||||
# Проверка .env
|
||||
cat .env
|
||||
|
||||
# Проверка портов
|
||||
lsof -i :8000
|
||||
```
|
||||
|
||||
### Ollama проблемы
|
||||
|
||||
```bash
|
||||
# Проверка статуса
|
||||
ollama list
|
||||
|
||||
# Проверка сервера
|
||||
curl http://localhost:11434/api/tags
|
||||
|
||||
# Перезапуск
|
||||
pkill ollama
|
||||
ollama serve
|
||||
|
||||
# На Windows
|
||||
taskkill /IM ollama.exe /F
|
||||
ollama serve
|
||||
```
|
||||
|
||||
### Frontend не загружается
|
||||
|
||||
```bash
|
||||
# Очистка кеша
|
||||
rm -rf node_modules .vite
|
||||
npm install
|
||||
|
||||
# Проверка backend
|
||||
curl http://localhost:8000/health
|
||||
|
||||
# Проверка proxy в vite.config.ts
|
||||
cat vite.config.ts
|
||||
```
|
||||
|
||||
### База данных
|
||||
|
||||
```bash
|
||||
# Просмотр таблиц
|
||||
sqlite3 review.db ".tables"
|
||||
|
||||
# Просмотр данных
|
||||
sqlite3 review.db "SELECT * FROM repositories;"
|
||||
|
||||
# Сброс базы
|
||||
rm review.db
|
||||
# Перезапустите backend для пересоздания
|
||||
```
|
||||
|
||||
## Production
|
||||
|
||||
### Запуск как сервис (systemd)
|
||||
|
||||
```bash
|
||||
# Создайте файл /etc/systemd/system/ai-review.service
|
||||
sudo nano /etc/systemd/system/ai-review.service
|
||||
|
||||
# Пример содержимого:
|
||||
[Unit]
|
||||
Description=AI Review Backend
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
User=your-user
|
||||
WorkingDirectory=/path/to/backend
|
||||
Environment="PATH=/path/to/venv/bin"
|
||||
ExecStart=/path/to/venv/bin/uvicorn app.main:app --host 0.0.0.0 --port 8000
|
||||
Restart=always
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
|
||||
# Включение и запуск
|
||||
sudo systemctl enable ai-review
|
||||
sudo systemctl start ai-review
|
||||
sudo systemctl status ai-review
|
||||
```
|
||||
|
||||
### Nginx reverse proxy
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name your-domain.com;
|
||||
|
||||
location /api {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
|
||||
location /ws {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
}
|
||||
|
||||
location / {
|
||||
root /path/to/frontend/dist;
|
||||
try_files $uri /index.html;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Полезные алиасы
|
||||
|
||||
Добавьте в `.bashrc` или `.zshrc`:
|
||||
|
||||
```bash
|
||||
# Backend
|
||||
alias review-backend='cd ~/platform/review/backend && source venv/bin/activate && uvicorn app.main:app --reload'
|
||||
|
||||
# Frontend
|
||||
alias review-frontend='cd ~/platform/review/frontend && npm run dev'
|
||||
|
||||
# Ollama
|
||||
alias review-ollama='ollama serve'
|
||||
|
||||
# Логи
|
||||
alias review-logs='tail -f ~/platform/review/backend/logs/app.log'
|
||||
```
|
||||
|
||||
149
docs/CONTRIBUTING.md
Normal file
149
docs/CONTRIBUTING.md
Normal file
@@ -0,0 +1,149 @@
|
||||
# Contributing to AI Code Review Agent
|
||||
|
||||
Спасибо за интерес к проекту! 🎉
|
||||
|
||||
## Как внести вклад
|
||||
|
||||
### Сообщить о баге
|
||||
|
||||
1. Проверьте, что баг еще не был сообщен в Issues
|
||||
2. Создайте новый Issue с детальным описанием:
|
||||
- Шаги для воспроизведения
|
||||
- Ожидаемое поведение
|
||||
- Фактическое поведение
|
||||
- Версия Python/Node.js
|
||||
- Логи ошибок
|
||||
|
||||
### Предложить улучшение
|
||||
|
||||
1. Создайте Issue с описанием предложения
|
||||
2. Объясните, какую проблему это решит
|
||||
3. Приведите примеры использования
|
||||
|
||||
### Создать Pull Request
|
||||
|
||||
1. Fork репозиторий
|
||||
2. Создайте feature branch:
|
||||
```bash
|
||||
git checkout -b feature/amazing-feature
|
||||
```
|
||||
3. Внесите изменения
|
||||
4. Убедитесь, что код работает:
|
||||
- Backend: `uvicorn app.main:app --reload`
|
||||
- Frontend: `npm run dev`
|
||||
5. Commit изменения:
|
||||
```bash
|
||||
git commit -m "Add amazing feature"
|
||||
```
|
||||
6. Push в branch:
|
||||
```bash
|
||||
git push origin feature/amazing-feature
|
||||
```
|
||||
7. Создайте Pull Request
|
||||
|
||||
## Стандарты кода
|
||||
|
||||
### Python (Backend)
|
||||
|
||||
- Следуйте PEP 8
|
||||
- Используйте type hints
|
||||
- Документируйте функции docstrings
|
||||
- Максимальная длина строки: 100 символов
|
||||
|
||||
```python
|
||||
async def my_function(param: str) -> dict:
|
||||
"""Short description.
|
||||
|
||||
Args:
|
||||
param: Parameter description
|
||||
|
||||
Returns:
|
||||
Description of return value
|
||||
"""
|
||||
pass
|
||||
```
|
||||
|
||||
### TypeScript (Frontend)
|
||||
|
||||
- Используйте строгую типизацию
|
||||
- Именование: camelCase для переменных, PascalCase для компонентов
|
||||
- Используйте функциональные компоненты с hooks
|
||||
|
||||
```typescript
|
||||
interface MyComponentProps {
|
||||
data: string;
|
||||
}
|
||||
|
||||
export default function MyComponent({ data }: MyComponentProps) {
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
## Структура коммитов
|
||||
|
||||
Используйте осмысленные сообщения коммитов:
|
||||
|
||||
```
|
||||
feat: Add GitHub integration
|
||||
fix: Resolve WebSocket reconnection issue
|
||||
docs: Update README installation steps
|
||||
refactor: Simplify review agent logic
|
||||
test: Add tests for repository API
|
||||
```
|
||||
|
||||
Префиксы:
|
||||
- `feat` - новая функциональность
|
||||
- `fix` - исправление бага
|
||||
- `docs` - документация
|
||||
- `refactor` - рефакторинг
|
||||
- `test` - тесты
|
||||
- `chore` - обновление зависимостей и т.д.
|
||||
|
||||
## Тестирование
|
||||
|
||||
### Backend
|
||||
|
||||
```bash
|
||||
# TODO: Добавить pytest тесты
|
||||
pytest tests/
|
||||
```
|
||||
|
||||
### Frontend
|
||||
|
||||
```bash
|
||||
# Линтинг
|
||||
npm run lint
|
||||
|
||||
# Проверка типов
|
||||
npx tsc --noEmit
|
||||
```
|
||||
|
||||
## Области для вклада
|
||||
|
||||
- 🐛 Исправление багов
|
||||
- ✨ Новые функции
|
||||
- 📝 Улучшение документации
|
||||
- 🧪 Добавление тестов
|
||||
- 🎨 Улучшение UI/UX
|
||||
- ⚡ Оптимизация производительности
|
||||
- 🔒 Улучшение безопасности
|
||||
|
||||
## Идеи для новых функций
|
||||
|
||||
- [ ] Поддержка GitLab
|
||||
- [ ] Настраиваемые правила ревью
|
||||
- [ ] Email уведомления
|
||||
- [ ] Интеграция с Slack/Discord
|
||||
- [ ] Docker контейнеризация
|
||||
- [ ] Множественные модели LLM
|
||||
- [ ] Анализ метрик кода
|
||||
- [ ] Поддержка команд в комментариях PR
|
||||
- [ ] Dashboard с графиками
|
||||
- [ ] Экспорт отчетов
|
||||
|
||||
## Вопросы?
|
||||
|
||||
Создайте Issue с меткой `question`.
|
||||
|
||||
Спасибо за вклад! 🚀
|
||||
|
||||
384
docs/DEBUG_GUIDE.md
Normal file
384
docs/DEBUG_GUIDE.md
Normal file
@@ -0,0 +1,384 @@
|
||||
# 🔍 Руководство по отладке AI ревьювера
|
||||
|
||||
## Что добавлено
|
||||
|
||||
### 1. **Детальное логирование всего процесса** 📊
|
||||
|
||||
Теперь в терминале backend вы увидите ВЕСЬ процесс работы агента:
|
||||
|
||||
#### **Этап 0: Информация о PR** ⭐ НОВОЕ!
|
||||
```
|
||||
📋📋📋📋📋 ИНФОРМАЦИЯ О PR 📋📋📋📋📋
|
||||
|
||||
📝 Название: Добавление функционала редактирования аватара
|
||||
👤 Автор: primakov
|
||||
🔀 Ветки: feature/avatar → main
|
||||
📄 Описание:
|
||||
--------------------------------------------------------------------------------
|
||||
Реализована возможность загрузки и изменения пользовательского аватара.
|
||||
Добавлен предпросмотр перед сохранением.
|
||||
--------------------------------------------------------------------------------
|
||||
📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋
|
||||
```
|
||||
|
||||
#### **Этап 1: Получение файлов из PR**
|
||||
```
|
||||
📥📥📥📥📥📥📥📥📥📥 ПОЛУЧЕНИЕ ФАЙЛОВ ИЗ PR 📥📥📥📥📥📥📥📥📥📥
|
||||
|
||||
📊 Получено файлов из API: 1
|
||||
|
||||
1. src/pages/SearchCharacterPage.tsx
|
||||
Status: modified
|
||||
+4 -4
|
||||
Patch: ДА (1234 символов)
|
||||
Первые 200 символов patch:
|
||||
@@ -55,7 +55,7 @@ export const SearchCharacterPage = ...
|
||||
|
||||
✅ Файлов для ревью: 1
|
||||
- src/pages/SearchCharacterPage.tsx (typescript)
|
||||
```
|
||||
|
||||
#### **Этап 2: Анализ каждого файла**
|
||||
```
|
||||
🔬🔬🔬🔬🔬 НАЧАЛО АНАЛИЗА ФАЙЛОВ 🔬🔬🔬🔬🔬
|
||||
Файлов для анализа: 1
|
||||
|
||||
📂 Файл 1/1: src/pages/SearchCharacterPage.tsx
|
||||
Язык: typescript
|
||||
Размер patch: 1234 символов
|
||||
Additions: 4, Deletions: 4
|
||||
```
|
||||
|
||||
#### **Этап 3: Детали анализа LLM**
|
||||
```
|
||||
================================================================================
|
||||
🔍 АНАЛИЗ ФАЙЛА: src/pages/SearchCharacterPage.tsx
|
||||
================================================================================
|
||||
|
||||
📋 КОНТЕКСТ PR: ⭐ НОВОЕ!
|
||||
--------------------------------------------------------------------------------
|
||||
Название: Добавление функционала редактирования аватара
|
||||
Описание: Реализована возможность загрузки и изменения аватара...
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
📝 DIFF (1234 символов):
|
||||
--------------------------------------------------------------------------------
|
||||
@@ -55,7 +55,7 @@ export const SearchCharacterPage = () => {
|
||||
search: searchValue
|
||||
}),
|
||||
headers: {
|
||||
- 'Content-Type': 'application/json'
|
||||
+ 'Content-Type': 'shmapplication/json' // <-- ОШИБКА!
|
||||
}
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
💭 ПРОМПТ (2500 символов):
|
||||
--------------------------------------------------------------------------------
|
||||
Ты СТРОГИЙ code reviewer. Твоя задача - найти ВСЕ ошибки в коде...
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
⏳ Отправка запроса к Ollama (codellama:7b)...
|
||||
|
||||
🤖 ОТВЕТ AI (500 символов):
|
||||
--------------------------------------------------------------------------------
|
||||
{
|
||||
"comments": [
|
||||
{
|
||||
"line": 58,
|
||||
"severity": "ERROR",
|
||||
"message": "Опечатка в Content-Type..."
|
||||
}
|
||||
]
|
||||
}
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
✅ Найдено комментариев: 1
|
||||
|
||||
1. Строка 58:
|
||||
Severity: ERROR
|
||||
Message: Опечатка в Content-Type: 'shmapplication/json'...
|
||||
================================================================================
|
||||
```
|
||||
|
||||
### 2. **Улучшенные промпты** 🎯
|
||||
|
||||
Промпт теперь **пошаговый** с конкретными примерами:
|
||||
|
||||
```
|
||||
ПОШАГОВЫЙ АНАЛИЗ каждой строки с +:
|
||||
|
||||
Шаг 1: ЧИТАЙ КАЖДУЮ СТРОКУ с + внимательно
|
||||
Шаг 2: ПРОВЕРЬ каждую строку на:
|
||||
a) ОПЕЧАТКИ - неправильные слова, typos
|
||||
b) СИНТАКСИС - скобки, кавычки, запятые
|
||||
c) ЛОГИКА - правильность кода
|
||||
d) REACT ПРАВИЛА - key, hooks, JSX
|
||||
|
||||
КОНКРЕТНЫЕ ПРИМЕРЫ ОШИБОК:
|
||||
❌ 'shmapplication/json' вместо 'application/json'
|
||||
❌ {condition && (<div>text</div>} - пропущена )
|
||||
❌ key на неправильном элементе
|
||||
```
|
||||
|
||||
### 3. **Увеличена temperature** 🌡️
|
||||
|
||||
- **Было:** `temperature=0.1` (очень консервативно)
|
||||
- **Стало:** `temperature=0.3` (более внимательный анализ)
|
||||
|
||||
---
|
||||
|
||||
## Как использовать
|
||||
|
||||
### Шаг 1: Запустите ревью
|
||||
|
||||
1. Откройте http://localhost:5173
|
||||
2. Перейдите в **Репозитории**
|
||||
3. Нажмите **🔍 Проверить сейчас** или **🔄 Повторить ревью**
|
||||
|
||||
### Шаг 2: Смотрите логи в терминале backend
|
||||
|
||||
В терминале где запущен backend (`uvicorn app.main:app`) вы увидите **весь процесс**:
|
||||
|
||||
1. **Какие файлы получены** из Gitea API
|
||||
2. **Какой patch** для каждого файла
|
||||
3. **Какой промпт** отправлен в Ollama
|
||||
4. **Что ответила AI** (полный ответ)
|
||||
5. **Сколько комментариев** найдено
|
||||
6. **Детали каждого комментария**
|
||||
|
||||
### Шаг 3: Анализируйте
|
||||
|
||||
#### Если AI не находит ошибки:
|
||||
|
||||
**Проверьте логи:**
|
||||
|
||||
1. **Patch приходит?**
|
||||
```
|
||||
Patch: ДА (1234 символов)
|
||||
```
|
||||
- Если **НЕТ** - проблема с Gitea API
|
||||
- Если **ДА** - идем дальше
|
||||
|
||||
2. **Patch содержит ошибки?**
|
||||
```
|
||||
Первые 200 символов patch:
|
||||
+ 'Content-Type': 'shmapplication/json'
|
||||
```
|
||||
- Проверьте что опечатка видна в patch
|
||||
|
||||
3. **Что ответила AI?**
|
||||
```
|
||||
🤖 ОТВЕТ AI:
|
||||
{"comments": []}
|
||||
```
|
||||
- Если `[]` - AI не увидела проблему
|
||||
- **Причина:** модель `codellama:7b` может быть недостаточно хороша
|
||||
|
||||
#### Возможные проблемы:
|
||||
|
||||
**1. Модель codellama:7b не видит ошибки**
|
||||
|
||||
CodeLlama оптимизирована для генерации кода, а не для ревью.
|
||||
|
||||
**Решения:**
|
||||
```bash
|
||||
# Попробуйте другую модель:
|
||||
|
||||
# Вариант 1: Mistral (лучше для анализа)
|
||||
ollama pull mistral:7b
|
||||
|
||||
# Вариант 2: Llama 3 (самая умная)
|
||||
ollama pull llama3:8b
|
||||
|
||||
# Вариант 3: DeepSeek Coder (специально для кода)
|
||||
ollama pull deepseek-coder:6.7b
|
||||
```
|
||||
|
||||
Затем в `backend/.env`:
|
||||
```bash
|
||||
OLLAMA_MODEL=mistral:7b
|
||||
# или
|
||||
OLLAMA_MODEL=llama3:8b
|
||||
# или
|
||||
OLLAMA_MODEL=deepseek-coder:6.7b
|
||||
```
|
||||
|
||||
**2. Patch не содержит нужных строк**
|
||||
|
||||
Gitea может не давать полный patch для больших файлов.
|
||||
|
||||
**Решение:** Проверьте в логах что именно в patch.
|
||||
|
||||
**3. AI отвечает не в JSON формате**
|
||||
|
||||
Бывает модель пишет текст вместо JSON.
|
||||
|
||||
**Решение:** В логах вы увидите:
|
||||
```
|
||||
⚠️ Комментариев не найдено! AI не нашел проблем.
|
||||
```
|
||||
|
||||
Смотрите полный ответ AI и меняйте модель.
|
||||
|
||||
---
|
||||
|
||||
## Рекомендуемые модели
|
||||
|
||||
### Для code review (от лучшей к худшей):
|
||||
|
||||
1. **mistral:7b** ⭐⭐⭐⭐⭐ **РЕКОМЕНДУЕТСЯ!**
|
||||
- ✅ Лучше всего следует инструкциям
|
||||
- ✅ Правильный JSON формат
|
||||
- ✅ Хороший анализ кода
|
||||
- ⚡ Быстрая (~4GB RAM)
|
||||
|
||||
2. **llama3:8b** ⭐⭐⭐⭐⭐
|
||||
- ✅ Самая умная модель
|
||||
- ✅ Лучший анализ кода
|
||||
- ⚠️ Требует ~5GB RAM
|
||||
|
||||
3. **deepseek-coder:6.7b** ⭐⭐⭐⭐
|
||||
- ✅ Специально для кода
|
||||
- ✅ Понимает много языков
|
||||
- ⚠️ Требует ~4GB RAM
|
||||
|
||||
4. **codellama:7b** ⭐⭐ **НЕ РЕКОМЕНДУЕТСЯ**
|
||||
- ❌ Отвечает текстом вместо JSON
|
||||
- ❌ Не подходит для code review
|
||||
- ⚠️ Для генерации кода, а не анализа
|
||||
|
||||
### Как сменить модель:
|
||||
|
||||
```bash
|
||||
# 1. Скачайте Mistral (РЕКОМЕНДУЕТСЯ)
|
||||
ollama pull mistral:7b
|
||||
|
||||
# 2. Обновите .env
|
||||
echo "OLLAMA_MODEL=mistral:7b" >> backend/.env
|
||||
|
||||
# 3. Перезапустите backend
|
||||
# Ctrl+C в терминале backend
|
||||
# Затем снова: python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
|
||||
|
||||
# Или для самой умной:
|
||||
ollama pull llama3:8b
|
||||
# И обновите: OLLAMA_MODEL=llama3:8b
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Пример полного лога успешного ревью
|
||||
|
||||
```
|
||||
📥📥📥📥📥 ПОЛУЧЕНИЕ ФАЙЛОВ ИЗ PR 📥📥📥📥📥
|
||||
|
||||
📊 Получено файлов из API: 1
|
||||
1. src/file.tsx
|
||||
Status: modified
|
||||
+2 -2
|
||||
Patch: ДА (500 символов)
|
||||
|
||||
✅ Файлов для ревью: 1
|
||||
|
||||
🔬🔬🔬 НАЧАЛО АНАЛИЗА ФАЙЛОВ 🔬🔬🔬
|
||||
|
||||
📂 Файл 1/1: src/file.tsx
|
||||
|
||||
================================================================================
|
||||
🔍 АНАЛИЗ ФАЙЛА: src/file.tsx
|
||||
================================================================================
|
||||
|
||||
📝 DIFF (500 символов):
|
||||
+ 'Content-Type': 'shmapplication/json'
|
||||
|
||||
⏳ Отправка запроса к Ollama (llama3:8b)...
|
||||
|
||||
🤖 ОТВЕТ AI:
|
||||
{
|
||||
"comments": [
|
||||
{
|
||||
"line": 58,
|
||||
"severity": "ERROR",
|
||||
"message": "Опечатка: 'shmapplication/json' должно быть 'application/json'"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
✅ Найдено комментариев: 1
|
||||
1. Строка 58: ERROR - Опечатка...
|
||||
|
||||
✅ ИТОГО комментариев: 1
|
||||
|
||||
🤖 AI Code Review завершен
|
||||
|
||||
Найдено проблем: 1
|
||||
- ❌ Критичных: 1
|
||||
|
||||
Проанализировано файлов: 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Чеклист отладки
|
||||
|
||||
- [ ] Backend логи показывают получение файлов?
|
||||
- [ ] Patch содержит изменения?
|
||||
- [ ] Ошибки видны в patch?
|
||||
- [ ] AI получает правильный промпт?
|
||||
- [ ] AI отвечает в JSON формате?
|
||||
- [ ] AI находит очевидные ошибки?
|
||||
- [ ] Попробовали другую модель?
|
||||
- [ ] Temperature = 0.3?
|
||||
|
||||
---
|
||||
|
||||
## Быстрая диагностика
|
||||
|
||||
### ❌ "AI не находит ошибки"
|
||||
|
||||
**Действия:**
|
||||
1. Смотрите логи backend - что в patch?
|
||||
2. Если patch пустой - проблема с Gitea API
|
||||
3. Если patch хороший, но AI не видит - меняйте модель на `llama3:8b`
|
||||
|
||||
### ❌ "Ревью падает с ошибкой"
|
||||
|
||||
**Действия:**
|
||||
1. Смотрите traceback в логах
|
||||
2. Проверьте что Ollama запущен: `ollama list`
|
||||
3. Проверьте что модель скачана
|
||||
|
||||
### ❌ "AI отвечает не в JSON"
|
||||
|
||||
**Пример:**
|
||||
```
|
||||
🤖 ОТВЕТ AI:
|
||||
Thank you for the detailed analysis...
|
||||
⚠️ Комментариев не найдено!
|
||||
```
|
||||
|
||||
**Причина:** codellama:7b не подходит для code review!
|
||||
|
||||
**Действия:**
|
||||
1. **Смените модель на mistral:7b** (РЕКОМЕНДУЕТСЯ!)
|
||||
```bash
|
||||
ollama pull mistral:7b
|
||||
echo "OLLAMA_MODEL=mistral:7b" >> backend/.env
|
||||
```
|
||||
2. Перезапустите backend
|
||||
3. Попробуйте снова
|
||||
|
||||
См. `MODEL_RECOMMENDATION.md` для деталей
|
||||
|
||||
---
|
||||
|
||||
## Результат
|
||||
|
||||
Теперь вы видите **весь процесс работы** AI ревьювера:
|
||||
- ✅ Что получено из API
|
||||
- ✅ Что отправлено в AI
|
||||
- ✅ Что AI ответила
|
||||
- ✅ Какие комментарии созданы
|
||||
|
||||
**Это позволяет понять ПОЧЕМУ AI не находит ошибки и КАК это исправить!**
|
||||
|
||||
369
docs/DEPLOYMENT.md
Normal file
369
docs/DEPLOYMENT.md
Normal file
@@ -0,0 +1,369 @@
|
||||
# 🚀 Развертывание AI Code Review Platform
|
||||
|
||||
## 📋 Быстрый старт
|
||||
|
||||
### Одна команда для запуска всего:
|
||||
|
||||
**Linux/Mac:**
|
||||
```bash
|
||||
./start.sh
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
```bash
|
||||
start.bat
|
||||
```
|
||||
|
||||
Это автоматически:
|
||||
1. ✅ Проверит установку Node.js и Python
|
||||
2. ✅ Установит зависимости frontend
|
||||
3. ✅ Соберет frontend в `backend/public`
|
||||
4. ✅ Установит зависимости backend
|
||||
5. ✅ Создаст `.env` из примера (если нужно)
|
||||
6. ✅ Запустит сервер на http://localhost:8000
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Требования
|
||||
|
||||
### Системные требования:
|
||||
- **Python:** 3.10 или выше
|
||||
- **Node.js:** 18 или выше
|
||||
- **npm:** 9 или выше
|
||||
|
||||
### Проверка установленных версий:
|
||||
```bash
|
||||
python --version # или python3 --version
|
||||
node --version
|
||||
npm --version
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Настройка
|
||||
|
||||
### 1. Клонирование репозитория
|
||||
|
||||
```bash
|
||||
git clone <repository-url>
|
||||
cd platform/review
|
||||
```
|
||||
|
||||
### 2. Конфигурация
|
||||
|
||||
Отредактируйте `backend/.env`:
|
||||
|
||||
```bash
|
||||
# Ollama Configuration
|
||||
OLLAMA_BASE_URL=http://localhost:11434
|
||||
OLLAMA_MODEL=mistral:7b
|
||||
|
||||
# Master Git Tokens (optional)
|
||||
MASTER_GITEA_TOKEN=your_gitea_token_here
|
||||
MASTER_GITHUB_TOKEN=your_github_token_here
|
||||
|
||||
# Security
|
||||
ENCRYPTION_KEY=your-32-character-encryption-key
|
||||
```
|
||||
|
||||
**Генерация ключа шифрования:**
|
||||
```python
|
||||
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
|
||||
```
|
||||
|
||||
### 3. Запуск
|
||||
|
||||
```bash
|
||||
# Linux/Mac
|
||||
chmod +x start.sh
|
||||
./start.sh
|
||||
|
||||
# Windows
|
||||
start.bat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Архитектура развертывания
|
||||
|
||||
### Схема работы:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Пользователь │
|
||||
│ http://localhost:8000 │
|
||||
└──────────────┬──────────────────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────┐
|
||||
│ FastAPI Backend │
|
||||
│ │
|
||||
│ ┌─────────────────────────────────┐ │
|
||||
│ │ API Endpoints │ │
|
||||
│ │ /api/repositories │ │
|
||||
│ │ /api/reviews │ │
|
||||
│ │ /api/webhooks │ │
|
||||
│ └─────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌─────────────────────────────────┐ │
|
||||
│ │ Static Files │ │
|
||||
│ │ Serves: backend/public/ │ │
|
||||
│ │ (React frontend build) │ │
|
||||
│ └─────────────────────────────────┘ │
|
||||
└─────────────────────────────────────────┘
|
||||
│
|
||||
├─────────► SQLite DB
|
||||
│
|
||||
├─────────► Ollama (AI)
|
||||
│
|
||||
└─────────► Git APIs
|
||||
(Gitea/GitHub/Bitbucket)
|
||||
```
|
||||
|
||||
### Как это работает:
|
||||
|
||||
1. **Frontend билдится** в `backend/public/`
|
||||
2. **Backend раздает** статику из `backend/public/`
|
||||
3. **Один порт** (8000) для всего
|
||||
4. **API** доступно на `/api/*`
|
||||
5. **Frontend** на `/` (все остальные роуты)
|
||||
|
||||
---
|
||||
|
||||
## 📁 Структура после сборки
|
||||
|
||||
```
|
||||
platform/review/
|
||||
├── backend/
|
||||
│ ├── public/ # ← Frontend build (создается автоматически)
|
||||
│ │ ├── index.html
|
||||
│ │ ├── assets/
|
||||
│ │ │ ├── index-*.js
|
||||
│ │ │ └── index-*.css
|
||||
│ │ └── ...
|
||||
│ ├── app/
|
||||
│ ├── venv/
|
||||
│ ├── .env
|
||||
│ └── requirements.txt
|
||||
├── frontend/
|
||||
│ ├── src/
|
||||
│ ├── package.json
|
||||
│ └── vite.config.ts # ← Настроен на build в ../backend/public
|
||||
├── start.sh # ← Единый скрипт запуска (Linux/Mac)
|
||||
└── start.bat # ← Единый скрипт запуска (Windows)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Процесс сборки
|
||||
|
||||
### Что происходит при запуске `start.sh` / `start.bat`:
|
||||
|
||||
```bash
|
||||
1. Проверка Node.js ✓
|
||||
→ node --version
|
||||
|
||||
2. Проверка Python ✓
|
||||
→ python --version
|
||||
|
||||
3. Установка зависимостей frontend ✓
|
||||
→ cd frontend
|
||||
→ npm install
|
||||
|
||||
4. Сборка frontend ✓
|
||||
→ npm run build
|
||||
→ Вывод: backend/public/
|
||||
|
||||
5. Установка зависимостей backend ✓
|
||||
→ cd backend
|
||||
→ python -m venv venv
|
||||
→ pip install -r requirements.txt
|
||||
|
||||
6. Проверка .env ✓
|
||||
→ Создание из .env.example если нужно
|
||||
|
||||
7. Запуск сервера ✓
|
||||
→ uvicorn app.main:app --reload
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Доступ к приложению
|
||||
|
||||
После запуска доступно:
|
||||
|
||||
- **Frontend (UI):** http://localhost:8000
|
||||
- **API:** http://localhost:8000/api
|
||||
- **API Docs (Swagger):** http://localhost:8000/docs
|
||||
- **WebSocket:** ws://localhost:8000/ws
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Разработка
|
||||
|
||||
### Запуск в режиме разработки (с hot-reload):
|
||||
|
||||
**Терминал 1 - Backend:**
|
||||
```bash
|
||||
cd backend
|
||||
source venv/bin/activate # или venv\Scripts\activate на Windows
|
||||
uvicorn app.main:app --reload
|
||||
```
|
||||
|
||||
**Терминал 2 - Frontend:**
|
||||
```bash
|
||||
cd frontend
|
||||
npm run dev
|
||||
```
|
||||
|
||||
В этом режиме:
|
||||
- Frontend: http://localhost:5173
|
||||
- Backend: http://localhost:8000
|
||||
- Frontend проксирует API запросы на backend
|
||||
|
||||
### Пересборка frontend:
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
npm run build
|
||||
```
|
||||
|
||||
Frontend автоматически соберется в `backend/public/`
|
||||
|
||||
---
|
||||
|
||||
## 🐳 Docker (опционально)
|
||||
|
||||
TODO: Добавить Dockerfile и docker-compose.yml
|
||||
|
||||
---
|
||||
|
||||
## 📊 Production Deployment
|
||||
|
||||
### Для продакшена рекомендуется:
|
||||
|
||||
1. **Использовать Gunicorn + Uvicorn:**
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
gunicorn app.main:app \
|
||||
--workers 4 \
|
||||
--worker-class uvicorn.workers.UvicornWorker \
|
||||
--bind 0.0.0.0:8000
|
||||
```
|
||||
|
||||
2. **Nginx как reverse proxy:**
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name yourdomain.com;
|
||||
|
||||
location / {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
|
||||
location /ws {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
3. **Systemd service:**
|
||||
|
||||
```ini
|
||||
[Unit]
|
||||
Description=AI Code Review Platform
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=notify
|
||||
User=www-data
|
||||
WorkingDirectory=/path/to/platform/review/backend
|
||||
ExecStart=/path/to/venv/bin/uvicorn app.main:app --host 0.0.0.0 --port 8000
|
||||
Restart=always
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Проблема: Frontend не отображается
|
||||
|
||||
**Решение:**
|
||||
```bash
|
||||
cd frontend
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Проблема: Backend не запускается
|
||||
|
||||
**Проверьте:**
|
||||
1. Установлен ли Python 3.10+
|
||||
2. Создано ли виртуальное окружение
|
||||
3. Установлены ли зависимости
|
||||
4. Корректен ли `.env` файл
|
||||
|
||||
### Проблема: Ollama недоступен
|
||||
|
||||
**Убедитесь что:**
|
||||
```bash
|
||||
# Ollama запущен
|
||||
ollama serve
|
||||
|
||||
# Модель скачана
|
||||
ollama pull mistral:7b
|
||||
|
||||
# Ollama доступен
|
||||
curl http://localhost:11434/api/version
|
||||
```
|
||||
|
||||
### Проблема: Ошибки шифрования токенов
|
||||
|
||||
**Удалите БД и пересоздайте:**
|
||||
```bash
|
||||
rm backend/review.db
|
||||
# Перезапустите сервер
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Полезные команды
|
||||
|
||||
```bash
|
||||
# Проверка статуса
|
||||
ps aux | grep uvicorn
|
||||
|
||||
# Просмотр логов
|
||||
tail -f backend/logs/app.log # если настроено логирование
|
||||
|
||||
# Остановка сервера
|
||||
# Ctrl+C в терминале где запущен
|
||||
|
||||
# Очистка
|
||||
rm -rf backend/public/
|
||||
rm -rf frontend/node_modules/
|
||||
rm -rf backend/venv/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Готово!
|
||||
|
||||
Теперь у вас есть:
|
||||
- 🚀 Единая команда запуска
|
||||
- 📦 Автоматическая сборка frontend
|
||||
- 🌐 Один порт для всего
|
||||
- 🔄 Hot-reload в разработке
|
||||
- 📚 Документация
|
||||
|
||||
**Запускайте и наслаждайтесь!** 🎉
|
||||
|
||||
372
docs/FEATURES_UPDATE.md
Normal file
372
docs/FEATURES_UPDATE.md
Normal file
@@ -0,0 +1,372 @@
|
||||
# ✨ Обновления функционала
|
||||
|
||||
## 🎯 Выполненные задачи
|
||||
|
||||
### 1. ✅ Модальные окна вместо alert
|
||||
|
||||
**Что было:**
|
||||
- Системные `alert()` и `confirm()` - выглядят некрасиво
|
||||
- Нет контроля над стилем и поведением
|
||||
- Блокируют весь браузер
|
||||
|
||||
**Что стало:**
|
||||
- Красивые кастомные модальные окна
|
||||
- Два типа:
|
||||
- `Modal` - информационное окно (success/error/warning/info)
|
||||
- `ConfirmModal` - окно подтверждения с кнопками
|
||||
- Анимация появления
|
||||
- Индикация загрузки в кнопках
|
||||
- Цветовая индикация типа сообщения
|
||||
|
||||
**Где используется:**
|
||||
- ✅ При добавлении репозитория
|
||||
- ✅ При удалении репозитория
|
||||
- ✅ При обновлении репозитория
|
||||
- ✅ При сканировании репозитория
|
||||
- ✅ При повторном запуске ревью
|
||||
- ✅ Все ошибки и успешные операции
|
||||
|
||||
**Компоненты:**
|
||||
```typescript
|
||||
// frontend/src/components/Modal.tsx
|
||||
<Modal
|
||||
isOpen={true}
|
||||
onClose={() => {}}
|
||||
title="Успешно"
|
||||
type="success"
|
||||
>
|
||||
<p>Операция выполнена!</p>
|
||||
</Modal>
|
||||
|
||||
<ConfirmModal
|
||||
isOpen={true}
|
||||
onClose={() => {}}
|
||||
onConfirm={() => {}}
|
||||
title="Подтвердите действие"
|
||||
message="Вы уверены?"
|
||||
confirmText="Да"
|
||||
cancelText="Нет"
|
||||
type="warning"
|
||||
isLoading={false}
|
||||
/>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. ✅ Кнопка "Повторить ревью"
|
||||
|
||||
**Что было:**
|
||||
- Если ревью упало - нужно было заново сканировать репозиторий
|
||||
- Если нужно повторить ревью - не было способа
|
||||
|
||||
**Что стало:**
|
||||
- Кнопка **🔄 Повторить** для упавших ревью (красный фон ошибки)
|
||||
- Кнопка **🔄 Повторить ревью** для завершенных ревью (серая кнопка)
|
||||
- Модальное подтверждение перед запуском
|
||||
- Ревью запускается в фоне
|
||||
|
||||
**Backend API:**
|
||||
```http
|
||||
POST /api/reviews/{review_id}/retry
|
||||
```
|
||||
|
||||
**Логика:**
|
||||
1. Сбрасывает статус ревью на `PENDING`
|
||||
2. Очищает error_message
|
||||
3. Запускает агента заново в background task
|
||||
4. Не создает дубликат ревью - использует существующее
|
||||
|
||||
**UI расположение:**
|
||||
- На странице **Ревью** - в каждой карточке ревью
|
||||
- Для статусов: `failed` и `completed`
|
||||
- Кнопка не блокирует клик по карточке (stopPropagation)
|
||||
|
||||
---
|
||||
|
||||
### 3. ✅ Улучшенный AI агент
|
||||
|
||||
**Что было:**
|
||||
- Агент был слишком мягким
|
||||
- Пропускал очевидные ошибки:
|
||||
- Опечатки в строках
|
||||
- Незакрытые скобки
|
||||
- Неправильное использование React
|
||||
|
||||
**Что стало:**
|
||||
- **Строгий системный промпт** - требовательный подход
|
||||
- **Детальный diff prompt** с конкретными примерами
|
||||
- **Обязательные проверки:**
|
||||
1. **Синтаксис** - опечатки, скобки, корректность
|
||||
2. **Логика** - ошибки, баги
|
||||
3. **Best practices** - React rules, naming
|
||||
4. **Безопасность** - XSS, injection
|
||||
|
||||
**Примеры что теперь находит:**
|
||||
|
||||
```javascript
|
||||
// ❌ ERROR - найдет опечатку
|
||||
headers: {
|
||||
'Content-Type': 'shmapplication/json' // должно быть application/json
|
||||
}
|
||||
|
||||
// ❌ ERROR - найдет незакрытую скобку
|
||||
{condition && (
|
||||
<span>текст</span>
|
||||
} // пропущена закрывающая )
|
||||
|
||||
// ❌ ERROR - найдет неправильный key
|
||||
<div>
|
||||
<CharacterItem> // key должен быть здесь
|
||||
<img key={char.id} /> // а не здесь
|
||||
</CharacterItem>
|
||||
</div>
|
||||
```
|
||||
|
||||
**Severity levels:**
|
||||
- `ERROR` - критично, сломает код
|
||||
- `WARNING` - важно, плохая практика
|
||||
- `INFO` - рекомендация
|
||||
|
||||
---
|
||||
|
||||
### 4. ✅ Агент всегда комментирует
|
||||
|
||||
**Что было:**
|
||||
- Если агент не находил проблем - молчал
|
||||
- Не было обратной связи что ревью завершено
|
||||
|
||||
**Что стало:**
|
||||
- **Всегда оставляет комментарий** в PR
|
||||
|
||||
**Если нашел проблемы:**
|
||||
```markdown
|
||||
🤖 **AI Code Review завершен**
|
||||
|
||||
Найдено проблем: **5**
|
||||
- ❌ Критичных: 2
|
||||
- ⚠️ Важных: 2
|
||||
- ℹ️ Рекомендаций: 1
|
||||
|
||||
Проанализировано файлов: 3
|
||||
```
|
||||
|
||||
**Если НЕ нашел проблем:**
|
||||
```markdown
|
||||
🤖 **AI Code Review завершен**
|
||||
|
||||
✅ Серьезных проблем не найдено!
|
||||
|
||||
Проанализировано файлов: 3
|
||||
Проверено изменений: 127
|
||||
```
|
||||
|
||||
**Плюс комментарии на конкретных строках:**
|
||||
```markdown
|
||||
**ERROR**: Опечатка в Content-Type: 'shmapplication/json' должно быть 'application/json'. Это сломает API запрос!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Исправленные баги
|
||||
|
||||
### 1. ✅ 401 Unauthorized при ревью
|
||||
|
||||
**Проблема:**
|
||||
- Gitea/GitHub API возвращал 401 Unauthorized
|
||||
- Токен был правильный, права были правильные
|
||||
|
||||
**Причина:**
|
||||
- API токен хранится **зашифрованным** в БД
|
||||
- Но передавался в Git сервисы **БЕЗ расшифровки**
|
||||
- Git API получал зашифрованную строку вместо токена
|
||||
|
||||
**Решение:**
|
||||
```python
|
||||
# backend/app/agents/reviewer.py
|
||||
def _get_git_service(self, repository: Repository):
|
||||
from app.utils import decrypt_token
|
||||
|
||||
# Расшифровываем токен перед использованием
|
||||
decrypted_token = decrypt_token(repository.api_token)
|
||||
|
||||
return GiteaService(base_url, decrypted_token, ...)
|
||||
```
|
||||
|
||||
**Результат:** ✅ Ревью теперь работает!
|
||||
|
||||
---
|
||||
|
||||
### 2. ✅ Backend не запускается (CORS error)
|
||||
|
||||
**Проблема:**
|
||||
```
|
||||
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)
|
||||
```
|
||||
|
||||
**Причина:**
|
||||
- `pydantic-settings` пытался распарсить `cors_origins` как JSON
|
||||
- Но переменная была пустая или в неправильном формате
|
||||
|
||||
**Решение:**
|
||||
```python
|
||||
# backend/app/config.py
|
||||
@field_validator('cors_origins', mode='before')
|
||||
def parse_cors_origins(cls, v):
|
||||
if isinstance(v, str):
|
||||
# Через запятую: "url1,url2"
|
||||
if ',' in v:
|
||||
return [origin.strip() for origin in v.split(',')]
|
||||
# JSON массив: '["url1"]'
|
||||
try:
|
||||
return json.loads(v)
|
||||
except:
|
||||
pass
|
||||
# Одиночная строка: "url"
|
||||
return [v.strip()]
|
||||
return v
|
||||
```
|
||||
|
||||
**Теперь поддерживается:**
|
||||
```bash
|
||||
# Через запятую
|
||||
CORS_ORIGINS=http://localhost:5173,http://localhost:3000
|
||||
|
||||
# JSON массив
|
||||
CORS_ORIGINS=["http://localhost:5173"]
|
||||
|
||||
# Одиночная строка
|
||||
CORS_ORIGINS=http://localhost:5173
|
||||
```
|
||||
|
||||
**Результат:** ✅ Backend запускается без ошибок!
|
||||
|
||||
---
|
||||
|
||||
## 📊 Статистика изменений
|
||||
|
||||
| Метрика | Значение |
|
||||
|---------|----------|
|
||||
| Файлов изменено | 15 |
|
||||
| Строк кода добавлено | ~500 |
|
||||
| Новых компонентов | 2 |
|
||||
| Новых API endpoints | 0 (использован существующий) |
|
||||
| Багов исправлено | 2 критических |
|
||||
| Улучшений UI | 5 |
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Скриншоты функций
|
||||
|
||||
### Модальное окно успеха
|
||||
```
|
||||
┌────────────────────────────────────┐
|
||||
│ ✅ Успешно │
|
||||
├────────────────────────────────────┤
|
||||
│ Репозиторий успешно добавлен! │
|
||||
├────────────────────────────────────┤
|
||||
│ [Закрыть] │
|
||||
└────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Модальное окно подтверждения
|
||||
```
|
||||
┌────────────────────────────────────┐
|
||||
│ ⚠️ Удаление репозитория │
|
||||
├────────────────────────────────────┤
|
||||
│ Вы уверены, что хотите удалить │
|
||||
│ этот репозиторий? Все связанные │
|
||||
│ ревью также будут удалены. │
|
||||
├────────────────────────────────────┤
|
||||
│ [Отмена] [Удалить] │
|
||||
└────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### Кнопка повторного ревью
|
||||
```
|
||||
┌────────────────────────────────────┐
|
||||
│ PR #5: Добавление аватара │
|
||||
│ primakov • feature → main │
|
||||
├────────────────────────────────────┤
|
||||
│ ❌ Failed │
|
||||
├────────────────────────────────────┤
|
||||
│ Ошибка: 401 Unauthorized │
|
||||
│ [🔄 Повторить] │
|
||||
└────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Как использовать
|
||||
|
||||
### Модальные окна
|
||||
- Автоматически появляются при любых действиях
|
||||
- Нажмите **Закрыть** или кликните вне окна
|
||||
- При confirm - выберите действие
|
||||
|
||||
### Повторное ревью
|
||||
1. Откройте страницу **Ревью**
|
||||
2. Найдите нужное ревью (failed или completed)
|
||||
3. Нажмите **🔄 Повторить** или **🔄 Повторить ревью**
|
||||
4. Подтвердите в модалке
|
||||
5. Ревью запустится заново
|
||||
|
||||
### Проверка AI
|
||||
1. Создайте PR с ошибками
|
||||
2. Запустите **🔍 Проверить сейчас**
|
||||
3. Дождитесь завершения
|
||||
4. Проверьте комментарии в PR
|
||||
5. AI должен найти все проблемы!
|
||||
|
||||
---
|
||||
|
||||
## ✅ Чеклист тестирования
|
||||
|
||||
- [ ] Модалка успеха при добавлении репозитория
|
||||
- [ ] Модалка подтверждения при удалении
|
||||
- [ ] Модалка подтверждения при сканировании
|
||||
- [ ] Кнопка "Повторить" для failed ревью
|
||||
- [ ] Кнопка "Повторить ревью" для completed
|
||||
- [ ] AI находит опечатки
|
||||
- [ ] AI находит синтаксические ошибки
|
||||
- [ ] AI находит ошибки React
|
||||
- [ ] AI комментирует в PR
|
||||
- [ ] Summary с подсчетом проблем
|
||||
- [ ] Backend запускается без ошибок
|
||||
- [ ] Frontend запускается без ошибок
|
||||
|
||||
---
|
||||
|
||||
## 📝 Конфигурация
|
||||
|
||||
### Backend (.env)
|
||||
```bash
|
||||
# Обязательные
|
||||
OLLAMA_BASE_URL=http://localhost:11434
|
||||
OLLAMA_MODEL=codellama:7b
|
||||
DATABASE_URL=sqlite+aiosqlite:///./review.db
|
||||
SECRET_KEY=ваш-секретный-ключ
|
||||
ENCRYPTION_KEY=ваш-ключ-шифрования
|
||||
|
||||
# CORS - любой из форматов
|
||||
CORS_ORIGINS=http://localhost:5173,http://localhost:3000
|
||||
# или
|
||||
CORS_ORIGINS=["http://localhost:5173"]
|
||||
```
|
||||
|
||||
### Frontend (.env)
|
||||
```bash
|
||||
VITE_API_URL=http://localhost:8000/api
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Готово!
|
||||
|
||||
Все задачи выполнены:
|
||||
- ✅ Нормальные модалки вместо alert
|
||||
- ✅ Кнопка повторить ревью на PR
|
||||
- ✅ Улучшенный AI агент
|
||||
- ✅ Исправлены критические баги
|
||||
|
||||
**Приложение готово к использованию!** 🚀
|
||||
|
||||
224
docs/HTML_ESCAPE_FIX.md
Normal file
224
docs/HTML_ESCAPE_FIX.md
Normal file
@@ -0,0 +1,224 @@
|
||||
# 🔧 Исправление: Экранирование HTML тегов в комментариях
|
||||
|
||||
## 🐛 Проблема
|
||||
|
||||
AI комментарии содержали упоминания JSX/HTML тегов, которые **исчезали** при отображении в Gitea/GitHub:
|
||||
|
||||
**До исправления:**
|
||||
```
|
||||
Неправильное использование key: key должен быть на элементе , а не на
|
||||
↑ ↑
|
||||
<CharacterItem> исчез <img> исчез
|
||||
```
|
||||
|
||||
**Причина:** Markdown интерпретирует `<CharacterItem>` как HTML тег и пытается его отрендерить, но т.к. такого тега не существует, он просто исчезает.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Решение
|
||||
|
||||
Добавлена функция **`_escape_html_in_text()`**, которая **оборачивает HTML-подобные теги** в backticks:
|
||||
|
||||
```python
|
||||
def _escape_html_in_text(self, text: str) -> str:
|
||||
"""Escape HTML tags in text to prevent Markdown from hiding them"""
|
||||
import re
|
||||
|
||||
def replace_tag(match):
|
||||
tag = match.group(0)
|
||||
return f"`{tag}`" # Оборачиваем в backticks
|
||||
|
||||
# Находим все <...> паттерны
|
||||
text = re.sub(r'<[^>]+>', replace_tag, text)
|
||||
return text
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Как работает
|
||||
|
||||
### Шаг 1: AI генерирует комментарий
|
||||
|
||||
```
|
||||
"key должен быть на элементе <CharacterItem>, а не на <img>"
|
||||
```
|
||||
|
||||
### Шаг 2: Функция экранирования
|
||||
|
||||
```python
|
||||
text = _escape_html_in_text(text)
|
||||
# Результат:
|
||||
"key должен быть на элементе `<CharacterItem>`, а не на `<img>`"
|
||||
```
|
||||
|
||||
### Шаг 3: В Gitea/GitHub отображается
|
||||
|
||||
```
|
||||
key должен быть на элементе `<CharacterItem>`, а не на `<img>`
|
||||
↑ ↑ ↑ ↑
|
||||
backticks делают теги видимыми
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Примеры
|
||||
|
||||
### Пример 1: JSX элементы
|
||||
|
||||
**Входной текст:**
|
||||
```
|
||||
Неправильное использование key: key должен быть на <CharacterItem>, а не на <img>
|
||||
```
|
||||
|
||||
**После обработки:**
|
||||
```
|
||||
Неправильное использование key: key должен быть на `<CharacterItem>`, а не на `<img>`
|
||||
```
|
||||
|
||||
**В Gitea видно:**
|
||||
```
|
||||
Неправильное использование key: key должен быть на `<CharacterItem>`, а не на `<img>`
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Пример 2: HTML теги
|
||||
|
||||
**Входной текст:**
|
||||
```
|
||||
Используйте <div> вместо <span> для обертки
|
||||
```
|
||||
|
||||
**После обработки:**
|
||||
```
|
||||
Используйте `<div>` вместо `<span>` для обертки
|
||||
```
|
||||
|
||||
**В Gitea видно:**
|
||||
```
|
||||
Используйте `<div>` вместо `<span>` для обертки
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Пример 3: Без HTML тегов
|
||||
|
||||
**Входной текст:**
|
||||
```
|
||||
Опечатка в строке: 'shmapplication/json' должно быть 'application/json'
|
||||
```
|
||||
|
||||
**После обработки:**
|
||||
```
|
||||
Опечатка в строке: 'shmapplication/json' должно быть 'application/json'
|
||||
```
|
||||
|
||||
**В Gitea видно:**
|
||||
```
|
||||
Опечатка в строке: 'shmapplication/json' должно быть 'application/json'
|
||||
```
|
||||
|
||||
*Без изменений - теги не найдены*
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Где применяется
|
||||
|
||||
Функция вызывается **дважды** для каждого ревью:
|
||||
|
||||
### 1. Для каждого комментария
|
||||
|
||||
```python
|
||||
for comment_data in state["comments"]:
|
||||
message = comment_data.get("message", "")
|
||||
message = self._remove_think_blocks(message)
|
||||
message = self._escape_html_in_text(message) # ← Экранируем
|
||||
|
||||
comment = Comment(content=message, ...)
|
||||
```
|
||||
|
||||
### 2. Для общего summary
|
||||
|
||||
```python
|
||||
summary = await self.analyzer.generate_summary(...)
|
||||
summary = self._remove_think_blocks(summary)
|
||||
summary = self._escape_html_in_text(summary) # ← Экранируем
|
||||
|
||||
await git_service.create_review(body=summary, ...)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Тестирование
|
||||
|
||||
Создан тест для проверки:
|
||||
|
||||
```python
|
||||
test_texts = [
|
||||
"key должен быть на элементе <CharacterItem>, а не на <img>",
|
||||
"Используйте <div> вместо <span> здесь"
|
||||
]
|
||||
|
||||
for text in test_texts:
|
||||
escaped = escape_html_in_text(text)
|
||||
print(f"Original: {text}")
|
||||
print(f"Escaped: {escaped}")
|
||||
```
|
||||
|
||||
**Результат:**
|
||||
```
|
||||
Original: key должен быть на элементе <CharacterItem>, а не на <img>
|
||||
Escaped: key должен быть на элементе `<CharacterItem>`, а не на `<img>`
|
||||
|
||||
Original: Используйте <div> вместо <span> здесь
|
||||
Escaped: Используйте `<div>` вместо `<span>` здесь
|
||||
```
|
||||
|
||||
✅ **Работает как ожидалось!**
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Визуальное сравнение
|
||||
|
||||
### ❌ До исправления (в Gitea):
|
||||
|
||||
```
|
||||
❌ src/pages/search-character.tsx:105
|
||||
ERROR: Неправильное использование key: key должен быть на элементе , а не на
|
||||
↑ теги исчезли, непонятно о чем речь
|
||||
```
|
||||
|
||||
### ✅ После исправления (в Gitea):
|
||||
|
||||
```
|
||||
❌ src/pages/search-character.tsx:105
|
||||
ERROR: Неправильное использование key: key должен быть на элементе `<CharacterItem>`, а не на `<img>`
|
||||
↑ теги видны и кликабельны, все понятно
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Измененные файлы
|
||||
|
||||
- **`backend/app/agents/reviewer.py`**:
|
||||
- Добавлена функция `_escape_html_in_text()`
|
||||
- Вызов функции для комментариев
|
||||
- Вызов функции для summary
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Как попробовать
|
||||
|
||||
1. Backend уже подхватил изменения (`--reload`)
|
||||
2. Нажмите **🔄 Повторить ревью**
|
||||
3. Откройте PR в Gitea
|
||||
4. Проверьте что теги теперь видны: `<CharacterItem>`, `<img>`, и т.д.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Готово!
|
||||
|
||||
Теперь все HTML/JSX теги в комментариях **отображаются корректно** и код понятен! 🎉
|
||||
|
||||
**Попробуйте прямо сейчас!** 🧪
|
||||
|
||||
299
docs/MASTER_TOKEN_FEATURE.md
Normal file
299
docs/MASTER_TOKEN_FEATURE.md
Normal file
@@ -0,0 +1,299 @@
|
||||
# 🔑 Мастер токены для Git платформ
|
||||
|
||||
## 📋 Описание
|
||||
|
||||
Теперь можно настроить **мастер токены** в `.env` файле. Эти токены будут использоваться для всех репозиториев, где **не указан** собственный API токен.
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Как настроить
|
||||
|
||||
### 1. Добавьте в `.env`
|
||||
|
||||
```bash
|
||||
# Master Git Tokens (optional)
|
||||
MASTER_GITEA_TOKEN=your_gitea_token_here
|
||||
MASTER_GITHUB_TOKEN=your_github_token_here
|
||||
MASTER_BITBUCKET_TOKEN=your_bitbucket_token_here
|
||||
```
|
||||
|
||||
### 2. Перезапустите backend
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
./start.bat # или ./start.sh на Linux/Mac
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Как работает
|
||||
|
||||
### Логика выбора токена:
|
||||
|
||||
1. **Если у репозитория ЕСТЬ свой токен** → используется токен репозитория
|
||||
2. **Если у репозитория НЕТ токена** → используется мастер токен из `.env`
|
||||
3. **Если и мастер токен не настроен** → ошибка
|
||||
|
||||
### Приоритет:
|
||||
|
||||
```
|
||||
Токен репозитория > Мастер токен > Ошибка
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Примеры использования
|
||||
|
||||
### Вариант 1: Один токен для всех
|
||||
|
||||
**Сценарий:** Все ваши проекты находятся в одной Gitea инстанции
|
||||
|
||||
**.env:**
|
||||
```bash
|
||||
MASTER_GITEA_TOKEN=abc123xyz789
|
||||
```
|
||||
|
||||
**Создание репозитория (без токена):**
|
||||
```json
|
||||
POST /api/repositories
|
||||
{
|
||||
"name": "my-project",
|
||||
"platform": "GITEA",
|
||||
"url": "https://git.example.com/user/my-project"
|
||||
// api_token НЕ указан
|
||||
}
|
||||
```
|
||||
|
||||
✅ Будет использован `MASTER_GITEA_TOKEN`
|
||||
|
||||
---
|
||||
|
||||
### Вариант 2: Разные токены для разных проектов
|
||||
|
||||
**Сценарий:** У некоторых проектов особые требования к доступу
|
||||
|
||||
**.env:**
|
||||
```bash
|
||||
MASTER_GITEA_TOKEN=default_token_123
|
||||
```
|
||||
|
||||
**Репозиторий 1 (использует мастер токен):**
|
||||
```json
|
||||
{
|
||||
"name": "project-a",
|
||||
"platform": "GITEA",
|
||||
"url": "https://git.example.com/user/project-a"
|
||||
// api_token НЕ указан → использует MASTER_GITEA_TOKEN
|
||||
}
|
||||
```
|
||||
|
||||
**Репозиторий 2 (свой токен):**
|
||||
```json
|
||||
{
|
||||
"name": "project-b",
|
||||
"platform": "GITEA",
|
||||
"url": "https://git.example.com/user/project-b",
|
||||
"api_token": "special_token_456" // Указан свой токен
|
||||
}
|
||||
```
|
||||
|
||||
✅ `project-a` использует мастер токен
|
||||
✅ `project-b` использует свой токен
|
||||
|
||||
---
|
||||
|
||||
### Вариант 3: Несколько платформ
|
||||
|
||||
**.env:**
|
||||
```bash
|
||||
MASTER_GITEA_TOKEN=gitea_token_123
|
||||
MASTER_GITHUB_TOKEN=github_token_456
|
||||
MASTER_BITBUCKET_TOKEN=bitbucket_token_789
|
||||
```
|
||||
|
||||
**Репозитории:**
|
||||
```json
|
||||
// Gitea - использует MASTER_GITEA_TOKEN
|
||||
{
|
||||
"platform": "GITEA",
|
||||
"url": "https://git.example.com/user/repo1"
|
||||
}
|
||||
|
||||
// GitHub - использует MASTER_GITHUB_TOKEN
|
||||
{
|
||||
"platform": "GITHUB",
|
||||
"url": "https://github.com/user/repo2"
|
||||
}
|
||||
|
||||
// Bitbucket - использует MASTER_BITBUCKET_TOKEN
|
||||
{
|
||||
"platform": "BITBUCKET",
|
||||
"url": "https://bitbucket.org/user/repo3"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔒 Безопасность
|
||||
|
||||
### ⚠️ Важно:
|
||||
|
||||
- Мастер токены **НЕ шифруются** в `.env` (они должны быть читаемыми для приложения)
|
||||
- Токены репозиториев **шифруются** перед сохранением в БД
|
||||
- **НЕ коммитьте** `.env` файл в Git!
|
||||
- Используйте `.env.example` как шаблон
|
||||
|
||||
### Права токенов:
|
||||
|
||||
Убедитесь что токены имеют необходимые права:
|
||||
|
||||
**Для Gitea/GitHub/Bitbucket:**
|
||||
- ✅ Чтение репозитория
|
||||
- ✅ Чтение PR
|
||||
- ✅ Создание комментариев
|
||||
|
||||
---
|
||||
|
||||
## 📊 Логирование
|
||||
|
||||
При запуске ревью вы увидите какой токен используется:
|
||||
|
||||
```
|
||||
📋 ИНФОРМАЦИЯ О PR
|
||||
...
|
||||
🔑 Используется мастер gitea токен
|
||||
```
|
||||
|
||||
или
|
||||
|
||||
```
|
||||
🔑 Используется проектный токен
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Изменения в UI
|
||||
|
||||
### Форма создания репозитория:
|
||||
|
||||
**Было:**
|
||||
```
|
||||
API Token: [обязательное поле]
|
||||
```
|
||||
|
||||
**Стало:**
|
||||
```
|
||||
API Token: [необязательное поле]
|
||||
Подсказка: Оставьте пустым чтобы использовать мастер токен
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Примеры из логов
|
||||
|
||||
### С мастер токеном:
|
||||
|
||||
```
|
||||
📤 Публикация ревью в Gitea PR #5
|
||||
Комментариев: 4
|
||||
🔑 Используется мастер gitea токен
|
||||
✅ Комментарий опубликован!
|
||||
```
|
||||
|
||||
### С проектным токеном:
|
||||
|
||||
```
|
||||
📤 Публикация ревью в Gitea PR #5
|
||||
Комментариев: 4
|
||||
🔑 Используется проектный токен
|
||||
✅ Комментарий опубликован!
|
||||
```
|
||||
|
||||
### Ошибка (токен не настроен):
|
||||
|
||||
```
|
||||
❌ ERROR: API токен не указан для репозитория my-project
|
||||
и мастер токен для gitea не настроен в .env (MASTER_GITEA_TOKEN)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Миграция базы данных
|
||||
|
||||
Поле `api_token` в таблице `repositories` теперь **nullable**:
|
||||
|
||||
**Старая схема:**
|
||||
```sql
|
||||
api_token VARCHAR NOT NULL
|
||||
```
|
||||
|
||||
**Новая схема:**
|
||||
```sql
|
||||
api_token VARCHAR NULL
|
||||
```
|
||||
|
||||
⚠️ **Если у вас уже есть репозитории:**
|
||||
- Они продолжат работать со своими токенами
|
||||
- Новые репозитории можно создавать без токена
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Как протестировать
|
||||
|
||||
### 1. Настройте мастер токен в `.env`
|
||||
|
||||
```bash
|
||||
MASTER_GITEA_TOKEN=your_token_here
|
||||
```
|
||||
|
||||
### 2. Создайте репозиторий БЕЗ токена
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:8000/api/repositories \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"name": "test-repo",
|
||||
"platform": "GITEA",
|
||||
"url": "https://git.example.com/user/test-repo"
|
||||
}'
|
||||
```
|
||||
|
||||
### 3. Запустите ревью
|
||||
|
||||
Кнопка "🔍 Проверить сейчас"
|
||||
|
||||
### 4. Проверьте логи
|
||||
|
||||
Должно быть: `🔑 Используется мастер gitea токен`
|
||||
|
||||
---
|
||||
|
||||
## ✅ Преимущества
|
||||
|
||||
1. **Удобство** - не нужно указывать токен для каждого репозитория
|
||||
2. **Гибкость** - можно переопределить токен для конкретного репозитория
|
||||
3. **Безопасность** - проектные токены все еще шифруются
|
||||
4. **Масштабируемость** - легко добавлять много репозиториев
|
||||
|
||||
---
|
||||
|
||||
## 📁 Измененные файлы
|
||||
|
||||
- `backend/app/config.py` - добавлены настройки мастер токенов
|
||||
- `backend/app/models/repository.py` - `api_token` теперь nullable
|
||||
- `backend/app/schemas/repository.py` - `api_token` опциональный
|
||||
- `backend/app/api/repositories.py` - логика выбора токена
|
||||
- `backend/app/agents/reviewer.py` - логика выбора токена
|
||||
- `backend/.env.example` - пример конфигурации
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Готово!
|
||||
|
||||
Теперь вы можете:
|
||||
- ✅ Использовать один токен для всех репозиториев
|
||||
- ✅ Переопределять токен для конкретных репозиториев
|
||||
- ✅ Легко масштабировать систему
|
||||
|
||||
**Попробуйте!** 🚀
|
||||
|
||||
152
docs/MODEL_RECOMMENDATION.md
Normal file
152
docs/MODEL_RECOMMENDATION.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# 🤖 Проблема с CodeLlama
|
||||
|
||||
## ❌ Что не так
|
||||
|
||||
`codellama:7b` отвечает **текстом вместо JSON**:
|
||||
|
||||
```
|
||||
Thank you for the detailed analysis...
|
||||
```
|
||||
|
||||
Вместо:
|
||||
```json
|
||||
{"comments": [{"line": 58, "severity": "ERROR", ...}]}
|
||||
```
|
||||
|
||||
## 🎯 Решение: Смените модель!
|
||||
|
||||
### Рекомендуемые модели для code review:
|
||||
|
||||
#### 1. **Mistral 7B** ⭐⭐⭐⭐⭐ (ЛУЧШИЙ ВЫБОР)
|
||||
```bash
|
||||
ollama pull mistral:7b
|
||||
```
|
||||
|
||||
**Почему Mistral:**
|
||||
- ✅ Отлично следует инструкциям
|
||||
- ✅ Хорошо понимает код
|
||||
- ✅ Быстрая (~4GB RAM)
|
||||
- ✅ Правильно форматирует JSON
|
||||
- ✅ Находит реальные проблемы
|
||||
|
||||
#### 2. **Llama 3 8B** ⭐⭐⭐⭐⭐ (САМАЯ УМНАЯ)
|
||||
```bash
|
||||
ollama pull llama3:8b
|
||||
```
|
||||
|
||||
**Почему Llama 3:**
|
||||
- ✅ Самая умная модель
|
||||
- ✅ Лучший анализ кода
|
||||
- ✅ Находит сложные проблемы
|
||||
- ⚠️ Требует ~5GB RAM
|
||||
- ✅ Отличный JSON output
|
||||
|
||||
#### 3. **DeepSeek Coder 6.7B** ⭐⭐⭐⭐ (ДЛЯ КОДА)
|
||||
```bash
|
||||
ollama pull deepseek-coder:6.7b
|
||||
```
|
||||
|
||||
**Почему DeepSeek:**
|
||||
- ✅ Специально для кода
|
||||
- ✅ Понимает много языков
|
||||
- ✅ Хороший JSON
|
||||
- ⚠️ Менее строгая
|
||||
|
||||
## 📝 Как сменить модель
|
||||
|
||||
### Шаг 1: Скачайте модель
|
||||
```bash
|
||||
ollama pull mistral:7b
|
||||
```
|
||||
|
||||
### Шаг 2: Обновите .env
|
||||
```bash
|
||||
# backend/.env
|
||||
OLLAMA_MODEL=mistral:7b
|
||||
```
|
||||
|
||||
### Шаг 3: Перезапустите backend
|
||||
```bash
|
||||
# Остановите: Ctrl+C
|
||||
# Запустите снова:
|
||||
cd backend
|
||||
source venv/Scripts/activate
|
||||
python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
|
||||
```
|
||||
|
||||
### Шаг 4: Попробуйте снова
|
||||
- Откройте http://localhost:5173
|
||||
- Нажмите **🔄 Повторить ревью**
|
||||
- Теперь должно работать!
|
||||
|
||||
## 📊 Сравнение моделей
|
||||
|
||||
| Модель | Для review | JSON | Скорость | RAM | Рейтинг |
|
||||
|--------|-----------|------|----------|-----|---------|
|
||||
| **mistral:7b** | ✅✅✅✅✅ | ✅✅✅✅✅ | ⚡⚡⚡⚡ | 4GB | ⭐⭐⭐⭐⭐ |
|
||||
| **llama3:8b** | ✅✅✅✅✅ | ✅✅✅✅ | ⚡⚡⚡ | 5GB | ⭐⭐⭐⭐⭐ |
|
||||
| **deepseek-coder** | ✅✅✅✅ | ✅✅✅✅ | ⚡⚡⚡⚡ | 4GB | ⭐⭐⭐⭐ |
|
||||
| codellama:7b | ✅✅ | ❌ | ⚡⚡⚡⚡ | 4GB | ⭐⭐ |
|
||||
|
||||
## 🎯 Мой совет
|
||||
|
||||
### Для большинства:
|
||||
```bash
|
||||
ollama pull mistral:7b
|
||||
```
|
||||
|
||||
### Если хочется самого лучшего:
|
||||
```bash
|
||||
ollama pull llama3:8b
|
||||
```
|
||||
|
||||
### Если мало RAM:
|
||||
```bash
|
||||
ollama pull deepseek-coder:6.7b
|
||||
```
|
||||
|
||||
## ✅ Результат после смены
|
||||
|
||||
**До (codellama):**
|
||||
```
|
||||
🤖 ОТВЕТ AI:
|
||||
Thank you for the detailed analysis...
|
||||
⚠️ Комментариев не найдено!
|
||||
```
|
||||
|
||||
**После (mistral):**
|
||||
```
|
||||
🤖 ОТВЕТ AI:
|
||||
{"comments": [
|
||||
{"line": 58, "severity": "ERROR", "message": "Опечатка..."},
|
||||
{"line": 108, "severity": "ERROR", "message": "Незакрытая скобка..."}
|
||||
]}
|
||||
✅ Найдено комментариев: 2
|
||||
```
|
||||
|
||||
## 🚀 Быстрый старт
|
||||
|
||||
```bash
|
||||
# 1. Скачайте Mistral
|
||||
ollama pull mistral:7b
|
||||
|
||||
# 2. Обновите конфиг
|
||||
echo "OLLAMA_MODEL=mistral:7b" >> backend/.env
|
||||
|
||||
# 3. Перезапустите
|
||||
# Ctrl+C в терминале backend
|
||||
# Затем снова запустите backend
|
||||
|
||||
# 4. Попробуйте ревью!
|
||||
```
|
||||
|
||||
## 🎉 После смены модели
|
||||
|
||||
Агент будет:
|
||||
- ✅ Находить реальные проблемы
|
||||
- ✅ Отвечать правильным JSON
|
||||
- ✅ Комментировать код правильно
|
||||
- ✅ Работать стабильно
|
||||
|
||||
**CodeLlama предназначена для ГЕНЕРАЦИИ кода, а не для РЕВЬЮ!**
|
||||
|
||||
357
docs/ORGANIZATION_FEATURE.md
Normal file
357
docs/ORGANIZATION_FEATURE.md
Normal file
@@ -0,0 +1,357 @@
|
||||
# 🏢 Организации и Очередь Задач
|
||||
|
||||
## 📋 Новая функциональность
|
||||
|
||||
### 1. **Поддержка организаций** 🏢
|
||||
|
||||
Теперь можно добавлять целые организации (не только отдельные репозитории):
|
||||
- Одна кнопка - сканирование всех репозиториев
|
||||
- Автоматический поиск всех PR
|
||||
- Создание задач на review
|
||||
|
||||
### 2. **Очередь задач** 📝
|
||||
|
||||
Review выполняются **последовательно** (по одному):
|
||||
- Задачи ставятся в очередь
|
||||
- Worker обрабатывает по одной
|
||||
- Приоритеты: HIGH > NORMAL > LOW
|
||||
- Автоматический retry при ошибках
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Как использовать
|
||||
|
||||
### Добавить организацию:
|
||||
|
||||
```bash
|
||||
POST /api/organizations
|
||||
{
|
||||
"name": "inno-js",
|
||||
"platform": "gitea",
|
||||
"base_url": "https://git.bro-js.ru",
|
||||
"api_token": "your_token" // опционально
|
||||
}
|
||||
```
|
||||
|
||||
### Сканировать организацию:
|
||||
|
||||
```bash
|
||||
POST /api/organizations/1/scan
|
||||
```
|
||||
|
||||
**Что произойдет:**
|
||||
1. ✅ Найдет все репозитории в организации
|
||||
2. ✅ Добавит отсутствующие репозитории в БД
|
||||
3. ✅ Найдет все открытые PR
|
||||
4. ✅ Создаст задачи на review
|
||||
5. ✅ Worker автоматически начнет обработку
|
||||
|
||||
---
|
||||
|
||||
## 📊 Структура БД
|
||||
|
||||
### Таблица `organizations`:
|
||||
|
||||
```sql
|
||||
CREATE TABLE organizations (
|
||||
id INTEGER PRIMARY KEY,
|
||||
name VARCHAR NOT NULL,
|
||||
platform VARCHAR NOT NULL, -- gitea/github/bitbucket
|
||||
base_url VARCHAR NOT NULL,
|
||||
api_token VARCHAR, -- encrypted, optional
|
||||
webhook_secret VARCHAR NOT NULL,
|
||||
config JSON,
|
||||
is_active BOOLEAN DEFAULT TRUE,
|
||||
last_scan_at DATETIME,
|
||||
created_at DATETIME,
|
||||
updated_at DATETIME
|
||||
);
|
||||
```
|
||||
|
||||
### Таблица `review_tasks`:
|
||||
|
||||
```sql
|
||||
CREATE TABLE review_tasks (
|
||||
id INTEGER PRIMARY KEY,
|
||||
pull_request_id INTEGER NOT NULL,
|
||||
status VARCHAR NOT NULL, -- pending/in_progress/completed/failed
|
||||
priority VARCHAR NOT NULL, -- low/normal/high
|
||||
created_at DATETIME,
|
||||
started_at DATETIME,
|
||||
completed_at DATETIME,
|
||||
error_message VARCHAR,
|
||||
retry_count INTEGER DEFAULT 0,
|
||||
max_retries INTEGER DEFAULT 3,
|
||||
FOREIGN KEY (pull_request_id) REFERENCES pull_requests(id)
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Task Worker
|
||||
|
||||
### Как работает:
|
||||
|
||||
```python
|
||||
while True:
|
||||
# 1. Проверить есть ли in_progress задача
|
||||
if has_in_progress_task():
|
||||
wait()
|
||||
continue
|
||||
|
||||
# 2. Взять следующую pending задачу
|
||||
task = get_next_pending_task()
|
||||
|
||||
if not task:
|
||||
wait()
|
||||
continue
|
||||
|
||||
# 3. Отметить как in_progress
|
||||
task.status = "in_progress"
|
||||
|
||||
# 4. Выполнить review
|
||||
try:
|
||||
execute_review(task)
|
||||
task.status = "completed"
|
||||
except:
|
||||
task.retry_count += 1
|
||||
if task.retry_count >= task.max_retries:
|
||||
task.status = "failed"
|
||||
else:
|
||||
task.status = "pending" # retry
|
||||
|
||||
# 5. Подождать 10 секунд
|
||||
await asyncio.sleep(10)
|
||||
```
|
||||
|
||||
### Гарантии:
|
||||
|
||||
✅ **Один review одновременно** - проверяется наличие `in_progress` задач
|
||||
✅ **Приоритеты** - высокий приоритет обрабатывается первым
|
||||
✅ **Retry** - автоматически повторяет при ошибках (до 3 раз)
|
||||
✅ **FIFO** - старые задачи обрабатываются первыми (при равном приоритете)
|
||||
|
||||
---
|
||||
|
||||
## 📡 API Endpoints
|
||||
|
||||
### Organizations:
|
||||
|
||||
```
|
||||
GET /api/organizations # Список организаций
|
||||
POST /api/organizations # Создать организацию
|
||||
GET /api/organizations/{id} # Получить организацию
|
||||
PUT /api/organizations/{id} # Обновить организацию
|
||||
DELETE /api/organizations/{id} # Удалить организацию
|
||||
POST /api/organizations/{id}/scan # Сканировать организацию
|
||||
```
|
||||
|
||||
### Tasks:
|
||||
|
||||
```
|
||||
GET /api/tasks # Список задач
|
||||
GET /api/tasks?status=pending # Фильтр по статусу
|
||||
GET /api/tasks/worker/status # Статус worker'а
|
||||
POST /api/tasks/{id}/retry # Повторить задачу
|
||||
DELETE /api/tasks/{id} # Удалить задачу
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Пример сканирования
|
||||
|
||||
### Request:
|
||||
|
||||
```bash
|
||||
POST /api/organizations/1/scan
|
||||
```
|
||||
|
||||
### Response:
|
||||
|
||||
```json
|
||||
{
|
||||
"organization_id": 1,
|
||||
"repositories_found": 15,
|
||||
"repositories_added": 3,
|
||||
"pull_requests_found": 8,
|
||||
"tasks_created": 8,
|
||||
"errors": []
|
||||
}
|
||||
```
|
||||
|
||||
### Логи:
|
||||
|
||||
```
|
||||
🔍 Сканирование организации inno-js на https://git.bro-js.ru
|
||||
Найдено репозиториев: 15
|
||||
✅ Добавлен репозиторий: inno-js/project-a
|
||||
✅ Добавлен репозиторий: inno-js/project-b
|
||||
✅ Добавлен репозиторий: inno-js/project-c
|
||||
📝 Создана задача для PR #5: Add feature X
|
||||
📝 Создана задача для PR #12: Fix bug Y
|
||||
📝 Создана задача для PR #3: Update docs
|
||||
...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Worker Logs
|
||||
|
||||
```
|
||||
🚀 Task Worker запущен
|
||||
|
||||
================================================================================
|
||||
📋 Начало обработки задачи #1
|
||||
PR ID: 5
|
||||
Приоритет: normal
|
||||
================================================================================
|
||||
|
||||
🤖 Запуск AI review для PR #5
|
||||
✅ Review завершен для PR #5
|
||||
✅ Задача #1 успешно завершена
|
||||
|
||||
================================================================================
|
||||
📋 Начало обработки задачи #2
|
||||
PR ID: 12
|
||||
Приоритет: normal
|
||||
================================================================================
|
||||
|
||||
🤖 Запуск AI review для PR #12
|
||||
✅ Review завершен для PR #12
|
||||
✅ Задача #2 успешно завершена
|
||||
|
||||
⏳ Задача #3 уже выполняется
|
||||
...
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Приоритеты задач
|
||||
|
||||
### Установка приоритета:
|
||||
|
||||
```python
|
||||
# В коде при создании задачи
|
||||
task = ReviewTask(
|
||||
pull_request_id=pr.id,
|
||||
priority="high" # "low" / "normal" / "high"
|
||||
)
|
||||
```
|
||||
|
||||
### Порядок обработки:
|
||||
|
||||
1. **HIGH** - критичные PR (hotfix, security)
|
||||
2. **NORMAL** - обычные PR (по умолчанию)
|
||||
3. **LOW** - некритичные PR (docs, refactoring)
|
||||
|
||||
При равном приоритете - FIFO (First In, First Out)
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Конфигурация Worker
|
||||
|
||||
### В коде:
|
||||
|
||||
```python
|
||||
# backend/app/workers/task_worker.py
|
||||
|
||||
class ReviewTaskWorker:
|
||||
def __init__(self):
|
||||
self.poll_interval = 10 # секунд между проверками
|
||||
```
|
||||
|
||||
### Изменить интервал:
|
||||
|
||||
```python
|
||||
worker.poll_interval = 5 # проверять каждые 5 секунд
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Мониторинг
|
||||
|
||||
### Статус worker'а:
|
||||
|
||||
```bash
|
||||
GET /api/tasks/worker/status
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"running": true,
|
||||
"current_task_id": 15,
|
||||
"poll_interval": 10
|
||||
}
|
||||
```
|
||||
|
||||
### Статистика задач:
|
||||
|
||||
```bash
|
||||
GET /api/tasks
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"items": [...],
|
||||
"total": 50,
|
||||
"pending": 10,
|
||||
"in_progress": 1,
|
||||
"completed": 35,
|
||||
"failed": 4
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Troubleshooting
|
||||
|
||||
### Worker не обрабатывает задачи:
|
||||
|
||||
```bash
|
||||
# Проверить статус
|
||||
curl http://localhost:8000/api/tasks/worker/status
|
||||
|
||||
# Проверить есть ли pending задачи
|
||||
curl http://localhost:8000/api/tasks?status=pending
|
||||
|
||||
# Проверить логи backend
|
||||
journalctl -u ai-review -f
|
||||
```
|
||||
|
||||
### Задача застряла в in_progress:
|
||||
|
||||
```bash
|
||||
# Вручную сбросить статус в БД
|
||||
sqlite3 backend/review.db
|
||||
UPDATE review_tasks SET status='pending', started_at=NULL WHERE id=123;
|
||||
```
|
||||
|
||||
### Retry failed задачи:
|
||||
|
||||
```bash
|
||||
POST /api/tasks/123/retry
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Преимущества
|
||||
|
||||
1. **Последовательная обработка** - не перегружаем Ollama
|
||||
2. **Приоритеты** - важные PR быстрее
|
||||
3. **Автоматический retry** - устойчивость к ошибкам
|
||||
4. **Масштабируемость** - легко добавлять организации
|
||||
5. **Мониторинг** - видно состояние очереди
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Готово!
|
||||
|
||||
Теперь можно:
|
||||
- ✅ Добавлять организации целиком
|
||||
- ✅ Сканировать все репозитории
|
||||
- ✅ Автоматически ставить PR в очередь
|
||||
- ✅ Обрабатывать последовательно
|
||||
- ✅ Мониторить прогресс
|
||||
|
||||
**Попробуйте!** 🚀
|
||||
|
||||
256
docs/ORGANIZATION_QUICKSTART.md
Normal file
256
docs/ORGANIZATION_QUICKSTART.md
Normal file
@@ -0,0 +1,256 @@
|
||||
# 🚀 Быстрый старт: Организации и Очередь задач
|
||||
|
||||
## 📝 Что добавлено
|
||||
|
||||
1. **Организации** - добавление целых организаций (Gitea/GitHub/Bitbucket)
|
||||
2. **Автосканирование** - поиск всех репозиториев и PR в организации
|
||||
3. **Очередь задач** - последовательная обработка review (по одному)
|
||||
4. **Мониторинг** - отслеживание состояния очереди и worker'а
|
||||
|
||||
---
|
||||
|
||||
## ⚡ Быстрый старт
|
||||
|
||||
### 1. Запустить проект
|
||||
|
||||
```bash
|
||||
# Windows
|
||||
start.bat
|
||||
|
||||
# Linux/Mac
|
||||
./start.sh
|
||||
```
|
||||
|
||||
### 2. Добавить организацию
|
||||
|
||||
1. Открыть http://localhost:8000
|
||||
2. Перейти в раздел **🏢 Организации**
|
||||
3. Нажать **➕ Добавить организацию**
|
||||
4. Заполнить:
|
||||
- **Название**: `inno-js`
|
||||
- **Платформа**: `Gitea`
|
||||
- **Base URL**: `https://git.bro-js.ru`
|
||||
- **API токен**: (опционально, если не указан - используется master токен)
|
||||
5. Нажать **Создать**
|
||||
|
||||
### 3. Сканировать организацию
|
||||
|
||||
1. Найти добавленную организацию
|
||||
2. Нажать **🔍 Сканировать**
|
||||
3. Подтвердить
|
||||
|
||||
**Результат:**
|
||||
```
|
||||
✅ Сканирование завершено!
|
||||
|
||||
📦 Репозиториев найдено: 15
|
||||
➕ Репозиториев добавлено: 3
|
||||
🔀 PR найдено: 8
|
||||
📝 Задач создано: 8
|
||||
```
|
||||
|
||||
### 4. Мониторинг очереди
|
||||
|
||||
1. Перейти в раздел **📝 Очередь задач**
|
||||
2. Увидите:
|
||||
- 🚀 **Worker активен** - статус worker'а
|
||||
- **Статистика** - всего/ожидает/выполняется/завершено/ошибок
|
||||
- **Список задач** - каждая задача с PR и статусом
|
||||
|
||||
### 5. Наблюдать за работой
|
||||
|
||||
Worker автоматически:
|
||||
1. Берет следующую задачу из очереди
|
||||
2. Запускает AI review для PR
|
||||
3. Публикует комментарии
|
||||
4. Переходит к следующей задаче
|
||||
|
||||
**Важно:** Обрабатывается только 1 задача одновременно! ⚡
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Настройка master токенов
|
||||
|
||||
Если не хотите указывать токен для каждой организации:
|
||||
|
||||
### backend/.env
|
||||
|
||||
```env
|
||||
# Master tokens (опциональные)
|
||||
MASTER_GITEA_TOKEN=your_gitea_token_here
|
||||
MASTER_GITHUB_TOKEN=your_github_token_here
|
||||
MASTER_BITBUCKET_TOKEN=your_bitbucket_token_here
|
||||
```
|
||||
|
||||
При создании организации просто оставьте поле "API токен" пустым.
|
||||
|
||||
---
|
||||
|
||||
## 📊 API Endpoints
|
||||
|
||||
### Организации
|
||||
|
||||
```bash
|
||||
# Получить список
|
||||
GET /api/organizations
|
||||
|
||||
# Создать
|
||||
POST /api/organizations
|
||||
{
|
||||
"name": "inno-js",
|
||||
"platform": "gitea",
|
||||
"base_url": "https://git.bro-js.ru",
|
||||
"api_token": "optional_token"
|
||||
}
|
||||
|
||||
# Сканировать
|
||||
POST /api/organizations/{id}/scan
|
||||
```
|
||||
|
||||
### Очередь задач
|
||||
|
||||
```bash
|
||||
# Получить список задач
|
||||
GET /api/tasks
|
||||
GET /api/tasks?status=pending
|
||||
|
||||
# Статус worker'а
|
||||
GET /api/tasks/worker/status
|
||||
|
||||
# Повторить задачу
|
||||
POST /api/tasks/{id}/retry
|
||||
|
||||
# Удалить задачу
|
||||
DELETE /api/tasks/{id}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Как это работает
|
||||
|
||||
### 1. Сканирование организации
|
||||
|
||||
```
|
||||
1. Fetch /orgs/{name}/repos → Получить все репозитории
|
||||
2. For each repo:
|
||||
- Проверить существует ли в БД
|
||||
- Если нет → добавить
|
||||
- Fetch /repos/{owner}/{repo}/pulls?state=open
|
||||
- For each PR:
|
||||
- Проверить существует ли в БД
|
||||
- Если нет → добавить
|
||||
- Создать ReviewTask(status=pending)
|
||||
```
|
||||
|
||||
### 2. Worker обработки
|
||||
|
||||
```python
|
||||
while True:
|
||||
# Проверить есть ли in_progress задача
|
||||
if has_in_progress_task():
|
||||
wait(10 seconds)
|
||||
continue
|
||||
|
||||
# Взять следующую pending задачу (по приоритету)
|
||||
task = get_next_pending_task()
|
||||
|
||||
if not task:
|
||||
wait(10 seconds)
|
||||
continue
|
||||
|
||||
# Отметить как in_progress
|
||||
task.status = "in_progress"
|
||||
|
||||
# Выполнить review
|
||||
try:
|
||||
run_ai_review(task.pull_request)
|
||||
task.status = "completed"
|
||||
except Exception as e:
|
||||
task.retry_count += 1
|
||||
if task.retry_count >= 3:
|
||||
task.status = "failed"
|
||||
else:
|
||||
task.status = "pending" # retry
|
||||
|
||||
# Подождать 10 секунд перед следующей
|
||||
wait(10 seconds)
|
||||
```
|
||||
|
||||
### 3. Гарантии
|
||||
|
||||
✅ **Только 1 review одновременно**
|
||||
✅ **Приоритеты**: HIGH → NORMAL → LOW
|
||||
✅ **Автоматический retry** (до 3 попыток)
|
||||
✅ **FIFO** при равном приоритете
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
### Worker не обрабатывает задачи
|
||||
|
||||
```bash
|
||||
# Проверить статус
|
||||
curl http://localhost:8000/api/tasks/worker/status
|
||||
|
||||
# Должно быть:
|
||||
{"running": true, "current_task_id": null, "poll_interval": 10}
|
||||
```
|
||||
|
||||
### Задача застряла в "in_progress"
|
||||
|
||||
```bash
|
||||
# Вручную сбросить через API
|
||||
POST /api/tasks/{id}/retry
|
||||
```
|
||||
|
||||
### Все задачи failed
|
||||
|
||||
Проверить:
|
||||
1. ✅ Ollama запущена (`ollama list`)
|
||||
2. ✅ Модель скачана (`ollama pull mistral:7b`)
|
||||
3. ✅ API токены правильные
|
||||
4. ✅ Репозитории доступны
|
||||
|
||||
---
|
||||
|
||||
## 📈 Мониторинг
|
||||
|
||||
### Frontend UI
|
||||
|
||||
- **🏢 Организации** - управление организациями, сканирование
|
||||
- **📝 Очередь задач** - мониторинг задач, статус worker'а
|
||||
- **🔍 Reviews** - результаты review, комментарии
|
||||
|
||||
### Логи
|
||||
|
||||
```bash
|
||||
# Backend логи (Windows)
|
||||
# Смотреть в консоли где запущен start.bat
|
||||
|
||||
# Backend логи (Linux/systemd)
|
||||
journalctl -u ai-review -f
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Готово!
|
||||
|
||||
Теперь вы можете:
|
||||
|
||||
1. ➕ Добавлять организации
|
||||
2. 🔍 Сканировать репозитории и PR
|
||||
3. 📝 Следить за очередью задач
|
||||
4. 🤖 AI автоматически проводит review
|
||||
5. 💬 Комментарии публикуются в PR
|
||||
|
||||
**Один клик** → Все репозитории и PR организации в review! 🚀
|
||||
|
||||
---
|
||||
|
||||
## 📚 Подробная документация
|
||||
|
||||
- [ORGANIZATION_FEATURE.md](ORGANIZATION_FEATURE.md) - Полная документация
|
||||
- [README.md](README.md) - Общая информация о проекте
|
||||
- [API Docs](http://localhost:8000/docs) - Swagger UI
|
||||
|
||||
250
docs/PRODUCTION_URLS.md
Normal file
250
docs/PRODUCTION_URLS.md
Normal file
@@ -0,0 +1,250 @@
|
||||
# 🌐 Настройка URL для Production
|
||||
|
||||
## Проблема
|
||||
|
||||
После развертывания на сервере frontend пытается обращаться к `localhost` вместо реального IP/домена сервера.
|
||||
|
||||
## ✅ Решение
|
||||
|
||||
Frontend теперь использует **относительные пути** и динамические URL.
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Как это работает
|
||||
|
||||
### 1. API запросы
|
||||
|
||||
**До:**
|
||||
```typescript
|
||||
const API_BASE_URL = 'http://localhost:8000/api';
|
||||
```
|
||||
|
||||
**После:**
|
||||
```typescript
|
||||
const API_BASE_URL = import.meta.env.VITE_API_URL || '/api';
|
||||
```
|
||||
|
||||
### 2. WebSocket
|
||||
|
||||
**До:**
|
||||
```typescript
|
||||
const wsUrl = 'ws://localhost:8000/ws/reviews';
|
||||
```
|
||||
|
||||
**После:**
|
||||
```typescript
|
||||
const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const host = import.meta.env.VITE_WS_URL || `${protocol}//${window.location.host}`;
|
||||
const wsUrl = `${host}/ws/reviews`;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Режимы работы
|
||||
|
||||
### Development (npm run dev)
|
||||
|
||||
Frontend работает на `localhost:5173`, proxy перенаправляет запросы:
|
||||
|
||||
```typescript
|
||||
// vite.config.ts
|
||||
server: {
|
||||
proxy: {
|
||||
'/api': 'http://localhost:8000',
|
||||
'/ws': 'ws://localhost:8000',
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Запросы:**
|
||||
- `http://localhost:5173/api/...` → `http://localhost:8000/api/...`
|
||||
- `ws://localhost:5173/ws/...` → `ws://localhost:8000/ws/...`
|
||||
|
||||
### Production (npm run build)
|
||||
|
||||
Frontend собран в `backend/public/`, backend раздает статику.
|
||||
|
||||
**Относительные пути:**
|
||||
- `/api/...` → `http://your-server-ip:8000/api/...`
|
||||
- `/ws/...` → `ws://your-server-ip:8000/ws/...`
|
||||
|
||||
Browser автоматически использует текущий host!
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Примеры
|
||||
|
||||
### На локальной машине:
|
||||
|
||||
```
|
||||
URL браузера: http://localhost:8000
|
||||
API запрос: http://localhost:8000/api/repositories
|
||||
WebSocket: ws://localhost:8000/ws/reviews
|
||||
```
|
||||
|
||||
### На сервере (IP):
|
||||
|
||||
```
|
||||
URL браузера: http://185.152.81.243:8000
|
||||
API запрос: http://185.152.81.243:8000/api/repositories
|
||||
WebSocket: ws://185.152.81.243:8000/ws/reviews
|
||||
```
|
||||
|
||||
### На сервере (домен):
|
||||
|
||||
```
|
||||
URL браузера: https://ai-review.example.com
|
||||
API запрос: https://ai-review.example.com/api/repositories
|
||||
WebSocket: wss://ai-review.example.com/ws/reviews
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Переменные окружения
|
||||
|
||||
### .env.production (создается автоматически)
|
||||
|
||||
```bash
|
||||
# Относительные пути (по умолчанию)
|
||||
VITE_API_URL=/api
|
||||
VITE_WS_URL=
|
||||
```
|
||||
|
||||
### .env.development (для разработки)
|
||||
|
||||
```bash
|
||||
# Явные URL для development
|
||||
VITE_API_URL=http://localhost:8000/api
|
||||
VITE_WS_URL=ws://localhost:8000
|
||||
```
|
||||
|
||||
### Кастомная настройка:
|
||||
|
||||
Если нужен специфичный URL (например, разные домены):
|
||||
|
||||
```bash
|
||||
# frontend/.env.production
|
||||
VITE_API_URL=https://api.example.com/api
|
||||
VITE_WS_URL=wss://api.example.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Пересборка после изменений
|
||||
|
||||
### Локально:
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
npm run build
|
||||
```
|
||||
|
||||
### На сервере:
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review/frontend
|
||||
npm run build
|
||||
sudo systemctl restart ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
### Проблема: API запросы идут на localhost
|
||||
|
||||
**Причина:** Frontend собран со старым кодом
|
||||
|
||||
**Решение:**
|
||||
```bash
|
||||
cd frontend
|
||||
rm -rf dist/ ../backend/public/
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Проблема: WebSocket не подключается
|
||||
|
||||
**Проверьте:**
|
||||
1. Открыть DevTools → Network → WS
|
||||
2. Проверить URL WebSocket подключения
|
||||
3. Убедиться что backend доступен
|
||||
|
||||
**Для HTTPS:**
|
||||
```bash
|
||||
# WebSocket должен использовать wss://
|
||||
# Убедитесь что nginx прокси настроен:
|
||||
|
||||
location /ws {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
}
|
||||
```
|
||||
|
||||
### Проблема: CORS ошибки
|
||||
|
||||
**Если используете разные домены:**
|
||||
|
||||
Обновите `backend/.env`:
|
||||
```bash
|
||||
CORS_ORIGINS=https://yourdomain.com,https://api.yourdomain.com
|
||||
```
|
||||
|
||||
Перезапустите backend:
|
||||
```bash
|
||||
sudo systemctl restart ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Проверка
|
||||
|
||||
### 1. Откройте DevTools (F12)
|
||||
|
||||
### 2. Network tab
|
||||
|
||||
Проверьте запросы:
|
||||
- ✅ URL должны использовать текущий host
|
||||
- ✅ Не должно быть `localhost` в production
|
||||
|
||||
### 3. Console
|
||||
|
||||
Не должно быть ошибок типа:
|
||||
- ❌ `Failed to fetch`
|
||||
- ❌ `ERR_CONNECTION_REFUSED`
|
||||
- ❌ `Mixed Content` (http на https странице)
|
||||
|
||||
---
|
||||
|
||||
## 📝 Пример логов
|
||||
|
||||
### ✅ Правильно (на сервере 185.152.81.243):
|
||||
|
||||
```
|
||||
GET http://185.152.81.243:8000/api/repositories 200 OK
|
||||
WS ws://185.152.81.243:8000/ws/reviews [connected]
|
||||
```
|
||||
|
||||
### ❌ Неправильно:
|
||||
|
||||
```
|
||||
GET http://localhost:8000/api/repositories [failed]
|
||||
WS ws://localhost:8000/ws/reviews [failed]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Готово!
|
||||
|
||||
Теперь приложение работает на любом домене/IP без изменений кода!
|
||||
|
||||
**Автоматически подстраивается под:**
|
||||
- ✅ localhost
|
||||
- ✅ IP адрес
|
||||
- ✅ Домен
|
||||
- ✅ HTTP/HTTPS
|
||||
- ✅ WS/WSS
|
||||
|
||||
**Больше не нужно менять код при деплое!** 🚀
|
||||
|
||||
200
docs/PROJECT_STATUS.md
Normal file
200
docs/PROJECT_STATUS.md
Normal file
@@ -0,0 +1,200 @@
|
||||
# 🎉 Статус проекта AI Code Review Agent
|
||||
|
||||
## ✅ Завершено
|
||||
|
||||
### Backend (FastAPI + LangGraph)
|
||||
- ✅ FastAPI приложение с CORS и middleware
|
||||
- ✅ SQLAlchemy модели (Repository, PullRequest, Review, Comment)
|
||||
- ✅ Pydantic схемы для валидации
|
||||
- ✅ LangGraph агент-ревьювер с Ollama
|
||||
- ✅ Интеграция с Gitea API (приоритет)
|
||||
- ✅ Интеграция с GitHub API
|
||||
- ✅ Интеграция с Bitbucket API
|
||||
- ✅ Webhook обработчики для всех платформ
|
||||
- ✅ REST API endpoints (repositories, reviews, stats)
|
||||
- ✅ WebSocket для real-time обновлений
|
||||
- ✅ Шифрование API токенов (Fernet)
|
||||
- ✅ Background tasks для запуска ревью
|
||||
|
||||
### Frontend (React + TypeScript)
|
||||
- ✅ React 18 + TypeScript + Vite
|
||||
- ✅ Tailwind CSS для стилизации
|
||||
- ✅ React Router для навигации
|
||||
- ✅ TanStack Query для state management
|
||||
- ✅ WebSocket клиент с auto-reconnect
|
||||
- ✅ Dashboard с статистикой
|
||||
- ✅ Страница управления репозиториями
|
||||
- ✅ Страница списка ревью с фильтрами
|
||||
- ✅ Страница деталей ревью
|
||||
- ✅ Real-time обновления прогресса
|
||||
- ✅ Переиспользуемые компоненты
|
||||
|
||||
### Документация
|
||||
- ✅ README.md с полной документацией
|
||||
- ✅ QUICKSTART.md для быстрого старта
|
||||
- ✅ ARCHITECTURE.md с описанием архитектуры
|
||||
- ✅ COMMANDS.md с полезными командами
|
||||
- ✅ CONTRIBUTING.md для контрибьюторов
|
||||
- ✅ cloud.md с планом разработки
|
||||
- ✅ LICENSE (MIT)
|
||||
- ✅ Backend README
|
||||
- ✅ Frontend README
|
||||
|
||||
### Скрипты и конфигурация
|
||||
- ✅ start.sh/bat для backend
|
||||
- ✅ start.sh/bat для frontend
|
||||
- ✅ .gitignore
|
||||
- ✅ requirements.txt
|
||||
- ✅ package.json
|
||||
- ✅ vite.config.ts
|
||||
- ✅ tsconfig.json
|
||||
- ✅ tailwind.config.js
|
||||
- ✅ .env.example
|
||||
|
||||
## 📊 Статистика
|
||||
|
||||
- **Файлов создано**: ~60+
|
||||
- **Backend файлов**: ~25
|
||||
- **Frontend файлов**: ~20
|
||||
- **Документации**: ~10
|
||||
- **Строк кода**: ~5000+
|
||||
|
||||
## 🎯 Основные возможности
|
||||
|
||||
1. **Автоматическое ревью PR**
|
||||
- Анализ кода через Ollama (codellama)
|
||||
- Поиск багов, проблем безопасности, best practices
|
||||
- Автоматические комментарии в PR
|
||||
|
||||
2. **Поддержка платформ**
|
||||
- ✅ Gitea (приоритет)
|
||||
- ✅ GitHub
|
||||
- ✅ Bitbucket
|
||||
|
||||
3. **Web UI**
|
||||
- Дашборд с метриками
|
||||
- Управление репозиториями
|
||||
- История ревью
|
||||
- Real-time обновления
|
||||
|
||||
4. **API**
|
||||
- REST API для управления
|
||||
- WebSocket для real-time
|
||||
- Swagger документация
|
||||
|
||||
## 🚀 Готово к использованию
|
||||
|
||||
Проект полностью готов к запуску:
|
||||
|
||||
1. Установите Ollama и загрузите codellama
|
||||
2. Запустите backend: `cd backend && ./start.sh`
|
||||
3. Запустите frontend: `cd frontend && ./start.sh`
|
||||
4. Откройте http://localhost:5173
|
||||
5. Добавьте репозиторий и настройте webhook
|
||||
6. Создайте PR - ревью запустится автоматически!
|
||||
|
||||
## 📝 TODO (будущие улучшения)
|
||||
|
||||
### Priority High
|
||||
- [ ] Docker контейнеризация (Dockerfile + docker-compose.yml)
|
||||
- [ ] Unit тесты (pytest для backend, vitest для frontend)
|
||||
- [ ] Integration тесты
|
||||
- [ ] CI/CD pipeline (GitHub Actions)
|
||||
|
||||
### Priority Medium
|
||||
- [ ] PostgreSQL поддержка
|
||||
- [ ] Alembic миграции
|
||||
- [ ] Rate limiting на API
|
||||
- [ ] Кеширование результатов (Redis)
|
||||
- [ ] Email уведомления
|
||||
- [ ] Настраиваемые правила ревью (YAML)
|
||||
|
||||
### Priority Low
|
||||
- [ ] GitLab интеграция
|
||||
- [ ] Множественные LLM (OpenAI, Anthropic)
|
||||
- [ ] Slack/Discord уведомления
|
||||
- [ ] Grafana дашборд
|
||||
- [ ] Экспорт отчетов (PDF/CSV)
|
||||
- [ ] Мультиязычность (i18n)
|
||||
- [ ] Темная/светлая тема
|
||||
|
||||
## 🔧 Архитектура
|
||||
|
||||
```
|
||||
Backend:
|
||||
- FastAPI для API
|
||||
- LangGraph для AI workflow
|
||||
- Ollama для LLM inference
|
||||
- SQLite для хранения
|
||||
- WebSocket для real-time
|
||||
|
||||
Frontend:
|
||||
- React 18 для UI
|
||||
- TypeScript для типизации
|
||||
- TanStack Query для state
|
||||
- Tailwind для стилей
|
||||
- Vite для сборки
|
||||
```
|
||||
|
||||
## 🎓 Технологический стек
|
||||
|
||||
**Backend:**
|
||||
- Python 3.11+
|
||||
- FastAPI
|
||||
- LangChain/LangGraph
|
||||
- Ollama
|
||||
- SQLAlchemy
|
||||
- Pydantic
|
||||
- httpx
|
||||
|
||||
**Frontend:**
|
||||
- React 18
|
||||
- TypeScript
|
||||
- Vite
|
||||
- TanStack Query
|
||||
- React Router
|
||||
- Tailwind CSS
|
||||
- date-fns
|
||||
|
||||
**DevOps:**
|
||||
- Ollama (локальный LLM сервер)
|
||||
- SQLite (можно заменить на PostgreSQL)
|
||||
|
||||
## 📈 Производительность
|
||||
|
||||
- Анализ файла: ~5-30 сек (зависит от размера)
|
||||
- Генерация комментариев: ~1-5 сек
|
||||
- Средний PR (5-10 файлов): ~1-3 мин
|
||||
- WebSocket latency: <100ms
|
||||
|
||||
## 🔐 Безопасность
|
||||
|
||||
- ✅ Шифрование API токенов
|
||||
- ✅ Webhook signature validation
|
||||
- ✅ CORS protection
|
||||
- ✅ Environment variables для секретов
|
||||
- ⚠️ Рекомендуется добавить rate limiting для production
|
||||
|
||||
## 📦 Deployment ready
|
||||
|
||||
- ✅ Структурированный код
|
||||
- ✅ Конфигурация через .env
|
||||
- ✅ Скрипты запуска
|
||||
- ✅ Документация
|
||||
- ⚠️ Нужен Docker для production
|
||||
- ⚠️ Нужен reverse proxy (nginx) для production
|
||||
|
||||
## 🎉 Итог
|
||||
|
||||
**Проект полностью функционален и готов к использованию!**
|
||||
|
||||
Все основные требования выполнены:
|
||||
- ✅ Поддержка Gitea, GitHub, Bitbucket
|
||||
- ✅ LangChain/LangGraph агент
|
||||
- ✅ Ollama для LLM
|
||||
- ✅ Web UI с real-time
|
||||
- ✅ Webhook интеграция
|
||||
- ✅ Полная документация
|
||||
|
||||
Можно сразу начинать использовать для ревью кода! 🚀
|
||||
|
||||
279
docs/PR_CONTEXT_FEATURE.md
Normal file
279
docs/PR_CONTEXT_FEATURE.md
Normal file
@@ -0,0 +1,279 @@
|
||||
# 📋 Добавлен контекст PR в анализ
|
||||
|
||||
## ✨ Что добавлено
|
||||
|
||||
### Описание PR теперь передается агенту!
|
||||
|
||||
Агент теперь получает **полный контекст PR**:
|
||||
- 📝 **Название PR**
|
||||
- 📄 **Описание PR** (body)
|
||||
- 👤 Автор
|
||||
- 🔀 Ветки (source → target)
|
||||
|
||||
## 🎯 Зачем это нужно?
|
||||
|
||||
### Проверка соответствия кода описанию
|
||||
|
||||
Теперь агент может найти **логические ошибки**:
|
||||
|
||||
**Пример 1: Несоответствие описанию**
|
||||
```
|
||||
PR: "Добавление функционала редактирования аватара"
|
||||
|
||||
Изменения в коде:
|
||||
+ 'Content-Type': 'shmapplication/json'
|
||||
|
||||
Агент обнаружит:
|
||||
❌ WARNING - Изменение не связано с редактированием аватара.
|
||||
В описании PR указано добавление функционала аватара,
|
||||
но код меняет Content-Type. Это не соответствует описанию.
|
||||
```
|
||||
|
||||
**Пример 2: Удаление функционала**
|
||||
```
|
||||
PR: "Добавление валидации email"
|
||||
|
||||
Изменения в коде:
|
||||
- if (validateEmail(email)) {
|
||||
- return true;
|
||||
- }
|
||||
|
||||
Агент обнаружит:
|
||||
❌ ERROR - Удаляется валидация email, но в описании PR
|
||||
указано "Добавление валидации". Это противоречие!
|
||||
```
|
||||
|
||||
## 🔍 Как это работает
|
||||
|
||||
### 1. Получение информации о PR
|
||||
|
||||
```python
|
||||
# backend/app/agents/reviewer.py
|
||||
async def fetch_pr_info(self, state: ReviewState):
|
||||
pr_info = await git_service.get_pull_request(state["pr_number"])
|
||||
|
||||
# Логируем информацию
|
||||
print("📋 ИНФОРМАЦИЯ О PR")
|
||||
print(f"Название: {pr_info.title}")
|
||||
print(f"Описание: {pr_info.description}")
|
||||
|
||||
# Сохраняем в state
|
||||
state["pr_info"] = {
|
||||
"title": pr_info.title,
|
||||
"description": pr_info.description,
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
### 2. Передача контекста в промпт
|
||||
|
||||
```python
|
||||
# backend/app/agents/tools.py
|
||||
async def analyze_diff(..., pr_title: str, pr_description: str):
|
||||
pr_context = f"""
|
||||
**КОНТЕКСТ PR:**
|
||||
Название: {pr_title}
|
||||
Описание: {pr_description}
|
||||
|
||||
ОБЯЗАТЕЛЬНО проверь: соответствует ли код описанию PR!
|
||||
"""
|
||||
|
||||
prompt = DIFF_REVIEW_PROMPT.format(
|
||||
file_path=file_path,
|
||||
diff=diff,
|
||||
pr_context=pr_context # <-- добавили контекст
|
||||
)
|
||||
```
|
||||
|
||||
### 3. AI анализирует с учетом контекста
|
||||
|
||||
Промпт теперь содержит:
|
||||
|
||||
```
|
||||
Ты СТРОГИЙ code reviewer.
|
||||
|
||||
**КОНТЕКСТ PR:**
|
||||
Название: Добавление функционала редактирования аватара
|
||||
Описание: Реализована возможность загрузки и изменения
|
||||
пользовательского аватара.
|
||||
|
||||
ОБЯЗАТЕЛЬНО проверь: соответствует ли код описанию PR!
|
||||
|
||||
Анализируй изменения в файле:
|
||||
...
|
||||
```
|
||||
|
||||
## 📊 Логирование
|
||||
|
||||
В терминале backend теперь видно:
|
||||
|
||||
```
|
||||
📋📋📋📋📋 ИНФОРМАЦИЯ О PR 📋📋📋📋📋
|
||||
|
||||
📝 Название: Добавление функционала редактирования аватара
|
||||
👤 Автор: primakov
|
||||
🔀 Ветки: feature/avatar → main
|
||||
📄 Описание:
|
||||
--------------------------------------------------------------------------------
|
||||
Реализована возможность:
|
||||
- Загрузки нового аватара
|
||||
- Предпросмотра перед сохранением
|
||||
- Удаления текущего аватара
|
||||
--------------------------------------------------------------------------------
|
||||
📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋📋
|
||||
|
||||
...
|
||||
|
||||
================================================================================
|
||||
🔍 АНАЛИЗ ФАЙЛА: src/pages/SearchCharacterPage.tsx
|
||||
================================================================================
|
||||
|
||||
📋 КОНТЕКСТ PR:
|
||||
--------------------------------------------------------------------------------
|
||||
Название: Добавление функционала редактирования аватара
|
||||
Описание: Реализована возможность загрузки и изменения аватара...
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
📝 DIFF:
|
||||
+ 'Content-Type': 'shmapplication/json'
|
||||
|
||||
🤖 ОТВЕТ AI:
|
||||
{
|
||||
"comments": [
|
||||
{
|
||||
"line": 58,
|
||||
"severity": "ERROR",
|
||||
"message": "Опечатка в Content-Type: 'shmapplication/json'"
|
||||
},
|
||||
{
|
||||
"line": 58,
|
||||
"severity": "WARNING",
|
||||
"message": "Изменение не связано с редактированием аватара"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 📋 Обновленный промпт
|
||||
|
||||
### Добавлен новый тип проверки:
|
||||
|
||||
```
|
||||
❌ НЕСООТВЕТСТВИЕ ОПИСАНИЮ PR:
|
||||
Описание PR: "Добавление функционала редактирования аватара"
|
||||
Код: меняет Content-Type на 'shmapplication/json'
|
||||
// ОШИБКА! не связано с аватарами
|
||||
|
||||
ОБЯЗАТЕЛЬНО ПРОВЕРЬ:
|
||||
1. СООТВЕТСТВИЕ ОПИСАНИЮ PR ⭐ НОВОЕ!
|
||||
- делает ли код то что написано в описании?
|
||||
- не удаляется ли то что должно добавляться?
|
||||
- не добавляется ли то что не упомянуто?
|
||||
2. Все строки в кавычках - нет ли опечаток?
|
||||
3. Все скобки - все ли закрыты?
|
||||
4. Все JSX элементы - правильно ли?
|
||||
5. React key - на правильном элементе?
|
||||
```
|
||||
|
||||
## 🎯 Примеры использования
|
||||
|
||||
### Сценарий 1: PR с описанием
|
||||
|
||||
**PR:**
|
||||
```
|
||||
Название: Исправление бага с поиском
|
||||
Описание: Исправлена проблема когда поиск не работал с пустыми строками
|
||||
```
|
||||
|
||||
**Код:**
|
||||
```diff
|
||||
+ if (search === '') {
|
||||
+ return;
|
||||
+ }
|
||||
```
|
||||
|
||||
**AI:**
|
||||
✅ Соответствует описанию - добавлена проверка на пустую строку
|
||||
|
||||
---
|
||||
|
||||
### Сценарий 2: PR без описания
|
||||
|
||||
**PR:**
|
||||
```
|
||||
Название: Рефакторинг
|
||||
Описание: (пусто)
|
||||
```
|
||||
|
||||
**Код:**
|
||||
```diff
|
||||
+ 'Content-Type': 'shmapplication/json'
|
||||
```
|
||||
|
||||
**AI:**
|
||||
❌ ERROR - Опечатка в Content-Type
|
||||
(не проверяет соответствие описанию, т.к. описания нет)
|
||||
|
||||
---
|
||||
|
||||
### Сценарий 3: Противоречие
|
||||
|
||||
**PR:**
|
||||
```
|
||||
Название: Добавление логирования
|
||||
Описание: Добавлены логи для отладки
|
||||
```
|
||||
|
||||
**Код:**
|
||||
```diff
|
||||
- console.log('debug:', data);
|
||||
- console.error('error:', err);
|
||||
```
|
||||
|
||||
**AI:**
|
||||
❌ WARNING - Удаляются логи, но в описании PR указано
|
||||
"Добавление логирования". Это противоречие!
|
||||
|
||||
## ✅ Преимущества
|
||||
|
||||
1. **Логические ошибки** - находит несоответствия между кодом и описанием
|
||||
2. **Контекст** - AI понимает что ДОЛЖНО быть сделано
|
||||
3. **Качество PR** - мотивирует писать хорошие описания
|
||||
4. **Отладка** - видно весь контекст в логах
|
||||
|
||||
## 🧪 Как проверить
|
||||
|
||||
1. Создайте PR с описанием:
|
||||
```
|
||||
Название: Добавление валидации формы
|
||||
Описание: Добавлена проверка email и телефона
|
||||
```
|
||||
|
||||
2. Сделайте изменение НЕ связанное с валидацией:
|
||||
```javascript
|
||||
+ const newColor = 'blue';
|
||||
```
|
||||
|
||||
3. Запустите ревью
|
||||
|
||||
4. Смотрите логи backend - видите контекст PR?
|
||||
|
||||
5. Проверьте комментарии - AI должна заметить несоответствие!
|
||||
|
||||
## 📝 Измененные файлы
|
||||
|
||||
- `backend/app/agents/reviewer.py` - получение и логирование PR info
|
||||
- `backend/app/agents/tools.py` - передача PR context в промпт
|
||||
- `backend/app/agents/prompts.py` - добавлен PR context в промпт
|
||||
- `backend/app/services/gitea.py` - уже получал description (не изменено)
|
||||
- `backend/app/services/base.py` - PRInfo уже содержал description
|
||||
|
||||
## 🚀 Готово!
|
||||
|
||||
Теперь агент **понимает контекст PR** и может:
|
||||
- ✅ Проверять соответствие кода описанию
|
||||
- ✅ Находить логические противоречия
|
||||
- ✅ Давать более осмысленные комментарии
|
||||
|
||||
**Все логи видны в терминале backend!** 📊
|
||||
|
||||
106
docs/QUICKSTART.md
Normal file
106
docs/QUICKSTART.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# 🚀 Быстрый старт за 5 минут
|
||||
|
||||
## 1️⃣ Установка Ollama (1 мин)
|
||||
|
||||
```bash
|
||||
# Скачайте и установите с https://ollama.ai/
|
||||
|
||||
# Загрузите модель
|
||||
ollama pull codellama
|
||||
|
||||
# Проверьте, что Ollama запущен
|
||||
ollama list
|
||||
```
|
||||
|
||||
## 2️⃣ Backend (2 мин)
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
|
||||
# Создайте venv и установите зависимости
|
||||
python -m venv venv
|
||||
source venv/bin/activate # Windows: venv\Scripts\activate
|
||||
pip install -r requirements.txt
|
||||
|
||||
# Создайте .env
|
||||
echo "SECRET_KEY=$(openssl rand -hex 32)" > .env
|
||||
echo "ENCRYPTION_KEY=$(openssl rand -hex 32)" >> .env
|
||||
echo "OLLAMA_BASE_URL=http://localhost:11434" >> .env
|
||||
echo "OLLAMA_MODEL=codellama" >> .env
|
||||
|
||||
# Запустите backend
|
||||
uvicorn app.main:app --reload
|
||||
```
|
||||
|
||||
✅ Backend запущен на http://localhost:8000
|
||||
|
||||
## 3️⃣ Frontend (2 мин)
|
||||
|
||||
```bash
|
||||
# Новый терминал
|
||||
cd frontend
|
||||
|
||||
# Установите зависимости
|
||||
npm install
|
||||
|
||||
# Запустите frontend
|
||||
npm run dev
|
||||
```
|
||||
|
||||
✅ Frontend запущен на http://localhost:5173
|
||||
|
||||
## 4️⃣ Первый репозиторий
|
||||
|
||||
1. Откройте http://localhost:5173
|
||||
2. Перейдите в **Репозитории** → **+ Добавить репозиторий**
|
||||
3. Заполните:
|
||||
- **Название**: test-repo
|
||||
- **Платформа**: Gitea
|
||||
- **URL**: https://your-gitea.com/owner/repo
|
||||
- **API Token**: ваш токен
|
||||
4. Скопируйте **Webhook URL**
|
||||
5. Добавьте webhook в Gitea (Settings → Webhooks)
|
||||
|
||||
## 5️⃣ Тест
|
||||
|
||||
Создайте Pull Request в вашем репозитории → AI агент автоматически начнет ревью! 🎉
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Проблемы?
|
||||
|
||||
### Ollama не запускается
|
||||
```bash
|
||||
# Проверьте статус
|
||||
ollama list
|
||||
|
||||
# Перезапустите
|
||||
ollama serve
|
||||
```
|
||||
|
||||
### Backend ошибка
|
||||
```bash
|
||||
# Проверьте .env файл
|
||||
cat backend/.env
|
||||
|
||||
# Проверьте логи
|
||||
tail -f logs/app.log
|
||||
```
|
||||
|
||||
### Frontend не подключается
|
||||
```bash
|
||||
# Проверьте что backend запущен
|
||||
curl http://localhost:8000/health
|
||||
|
||||
# Очистите кеш
|
||||
cd frontend
|
||||
rm -rf node_modules .vite
|
||||
npm install
|
||||
```
|
||||
|
||||
## 📚 Дальше
|
||||
|
||||
- [Полная документация](README.md)
|
||||
- [API документация](http://localhost:8000/docs)
|
||||
- [Contributing](CONTRIBUTING.md)
|
||||
|
||||
53
docs/README.md
Normal file
53
docs/README.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# Документация AI Code Review Agent
|
||||
|
||||
Здесь собрана вся документация проекта.
|
||||
|
||||
## Быстрый старт
|
||||
|
||||
- [QUICKSTART.md](QUICKSTART.md) - Быстрый старт проекта
|
||||
- [START_PROJECT.md](START_PROJECT.md) - Детальная инструкция по запуску
|
||||
|
||||
## Развертывание
|
||||
|
||||
- [DEPLOYMENT.md](DEPLOYMENT.md) - Общая информация о развертывании
|
||||
- [UBUNTU_DEPLOYMENT.md](UBUNTU_DEPLOYMENT.md) - Развертывание на Ubuntu/Debian
|
||||
- [REDEPLOY_GUIDE.md](REDEPLOY_GUIDE.md) - Руководство по обновлению
|
||||
- [REDEPLOY_UBUNTU_QUICK.md](REDEPLOY_UBUNTU_QUICK.md) - Быстрое обновление на Ubuntu
|
||||
- [cloud.md](cloud.md) - Развертывание в облаке
|
||||
|
||||
## Функционал
|
||||
|
||||
- [FEATURES_UPDATE.md](FEATURES_UPDATE.md) - Обновления функционала
|
||||
- [REVIEW_FEATURES.md](REVIEW_FEATURES.md) - Возможности review
|
||||
- [ORGANIZATION_FEATURE.md](ORGANIZATION_FEATURE.md) - Работа с организациями
|
||||
- [ORGANIZATION_QUICKSTART.md](ORGANIZATION_QUICKSTART.md) - Быстрый старт с организациями
|
||||
- [MASTER_TOKEN_FEATURE.md](MASTER_TOKEN_FEATURE.md) - Мастер токены
|
||||
- [PR_CONTEXT_FEATURE.md](PR_CONTEXT_FEATURE.md) - Контекст Pull Request
|
||||
- [HTML_ESCAPE_FIX.md](HTML_ESCAPE_FIX.md) - Исправление экранирования HTML
|
||||
|
||||
## Архитектура и разработка
|
||||
|
||||
- [ARCHITECTURE.md](ARCHITECTURE.md) - Архитектура проекта
|
||||
- [PROJECT_STATUS.md](PROJECT_STATUS.md) - Статус проекта
|
||||
- [CONTRIBUTING.md](CONTRIBUTING.md) - Как внести вклад
|
||||
|
||||
## Changelog
|
||||
|
||||
- [CHANGELOG.md](CHANGELOG.md) - История изменений
|
||||
- [CHANGELOG_ORGANIZATIONS.md](CHANGELOG_ORGANIZATIONS.md) - История изменений организаций
|
||||
|
||||
## Команды и отладка
|
||||
|
||||
- [COMMANDS.md](COMMANDS.md) - Полезные команды
|
||||
- [DEBUG_GUIDE.md](DEBUG_GUIDE.md) - Руководство по отладке
|
||||
|
||||
## Настройки и рекомендации
|
||||
|
||||
- [MODEL_RECOMMENDATION.md](MODEL_RECOMMENDATION.md) - Рекомендации по выбору модели
|
||||
- [PRODUCTION_URLS.md](PRODUCTION_URLS.md) - Настройка production URL
|
||||
- [SUMMARY.md](SUMMARY.md) - Краткое резюме проекта
|
||||
|
||||
## Дополнительно
|
||||
|
||||
- [TEST_STREAMING.md](TEST_STREAMING.md) - Тестирование WebSocket стриминга
|
||||
|
||||
437
docs/REDEPLOY_GUIDE.md
Normal file
437
docs/REDEPLOY_GUIDE.md
Normal file
@@ -0,0 +1,437 @@
|
||||
# 🔄 Руководство по обновлению (Redeploy)
|
||||
|
||||
## 📋 Содержание
|
||||
|
||||
- [Быстрый старт](#-быстрый-старт)
|
||||
- [Что делает скрипт](#-что-делает-скрипт)
|
||||
- [Использование](#-использование)
|
||||
- [Откат изменений](#-откат-изменений)
|
||||
- [Troubleshooting](#-troubleshooting)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Быстрый старт
|
||||
|
||||
После внесения изменений в код на сервере:
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
Скрипт автоматически:
|
||||
1. Создаст backup
|
||||
2. Обновит код
|
||||
3. Применит изменения
|
||||
4. Перезапустит сервис
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Что делает скрипт
|
||||
|
||||
### Шаг 1: Остановка сервиса
|
||||
```bash
|
||||
systemctl stop ai-review
|
||||
```
|
||||
Безопасно останавливает работающий сервис.
|
||||
|
||||
### Шаг 2: Создание backup
|
||||
```bash
|
||||
# Backup сохраняется в:
|
||||
/opt/ai-review-backups/backup-YYYYMMDD-HHMMSS/
|
||||
```
|
||||
Создается копия базы данных на случай проблем.
|
||||
|
||||
### Шаг 3: Обновление кода
|
||||
```bash
|
||||
git fetch --all
|
||||
git pull origin <current-branch>
|
||||
```
|
||||
Загружает последние изменения из репозитория.
|
||||
|
||||
### Шаг 4: Обновление зависимостей Backend
|
||||
```bash
|
||||
cd backend
|
||||
source venv/bin/activate
|
||||
pip install --upgrade pip
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
Устанавливает новые Python пакеты, если добавлены.
|
||||
|
||||
### Шаг 5: Применение миграций БД
|
||||
```bash
|
||||
python migrate.py
|
||||
```
|
||||
Создает новые таблицы или изменяет существующие.
|
||||
|
||||
### Шаг 6: Сборка Frontend
|
||||
```bash
|
||||
cd frontend
|
||||
npm install # если нужно
|
||||
npm run build
|
||||
```
|
||||
Собирает React приложение в production режиме.
|
||||
|
||||
### Шаг 7: Запуск сервиса
|
||||
```bash
|
||||
systemctl start ai-review
|
||||
```
|
||||
Запускает обновленный сервис.
|
||||
|
||||
---
|
||||
|
||||
## 📖 Использование
|
||||
|
||||
### Стандартное обновление
|
||||
|
||||
```bash
|
||||
# 1. Зайти на сервер
|
||||
ssh user@your-server
|
||||
|
||||
# 2. Перейти в директорию проекта
|
||||
cd /opt/ai-review
|
||||
|
||||
# 3. Обновить код (если нужно)
|
||||
git pull
|
||||
|
||||
# 4. Запустить redeploy
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Обновление конкретной ветки
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review
|
||||
git checkout feature-branch
|
||||
git pull
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Обновление без Git
|
||||
|
||||
Если проект не в Git:
|
||||
|
||||
```bash
|
||||
# 1. Скопировать новые файлы на сервер
|
||||
scp -r ./backend user@server:/opt/ai-review/
|
||||
scp -r ./frontend user@server:/opt/ai-review/
|
||||
|
||||
# 2. Запустить redeploy
|
||||
ssh user@server 'cd /opt/ai-review && sudo ./redeploy-ubuntu.sh'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⏮️ Откат изменений
|
||||
|
||||
### Быстрый откат
|
||||
|
||||
Если после обновления что-то сломалось:
|
||||
|
||||
```bash
|
||||
# 1. Остановить сервис
|
||||
sudo systemctl stop ai-review
|
||||
|
||||
# 2. Найти последний backup
|
||||
ls -lt /opt/ai-review-backups/
|
||||
|
||||
# 3. Восстановить БД
|
||||
sudo cp /opt/ai-review-backups/backup-YYYYMMDD-HHMMSS/review.db /opt/ai-review/backend/
|
||||
|
||||
# 4. Откатить код (если использовался git pull)
|
||||
cd /opt/ai-review
|
||||
sudo -u $USER git reset --hard HEAD~1
|
||||
|
||||
# 5. Запустить redeploy снова
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Откат к конкретному коммиту
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review
|
||||
|
||||
# Посмотреть историю
|
||||
git log --oneline -10
|
||||
|
||||
# Откатиться к нужному коммиту
|
||||
sudo -u $USER git reset --hard <commit-hash>
|
||||
|
||||
# Redeploy
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Восстановление из backup
|
||||
|
||||
Если нужно только восстановить БД:
|
||||
|
||||
```bash
|
||||
# Остановить сервис
|
||||
sudo systemctl stop ai-review
|
||||
|
||||
# Восстановить БД
|
||||
sudo cp /opt/ai-review-backups/backup-YYYYMMDD-HHMMSS/review.db /opt/ai-review/backend/
|
||||
|
||||
# Запустить сервис
|
||||
sudo systemctl start ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Troubleshooting
|
||||
|
||||
### Ошибка: "Сервис не запустился"
|
||||
|
||||
```bash
|
||||
# Посмотреть логи
|
||||
journalctl -u ai-review -n 50 --no-pager
|
||||
|
||||
# Проверить конфигурацию
|
||||
cat /opt/ai-review/backend/.env
|
||||
|
||||
# Попробовать запустить вручную
|
||||
cd /opt/ai-review/backend
|
||||
source venv/bin/activate
|
||||
uvicorn app.main:app --host 0.0.0.0 --port 8000
|
||||
```
|
||||
|
||||
### Ошибка: "Virtual environment не найден"
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review/backend
|
||||
|
||||
# Пересоздать venv
|
||||
python3 -m venv venv
|
||||
source venv/bin/activate
|
||||
pip install --upgrade pip
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
### Ошибка: "Frontend не собрался"
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review/frontend
|
||||
|
||||
# Удалить node_modules и пересобрать
|
||||
rm -rf node_modules
|
||||
npm install
|
||||
npm run build
|
||||
|
||||
# Проверить результат
|
||||
ls -lh ../backend/public/
|
||||
```
|
||||
|
||||
### Ошибка: "Permission denied"
|
||||
|
||||
```bash
|
||||
# Исправить права доступа
|
||||
sudo chown -R $USER:$USER /opt/ai-review
|
||||
sudo chmod +x /opt/ai-review/redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Сервис постоянно перезапускается
|
||||
|
||||
```bash
|
||||
# Остановить автоматический перезапуск
|
||||
sudo systemctl stop ai-review
|
||||
sudo systemctl disable ai-review
|
||||
|
||||
# Запустить в режиме отладки
|
||||
cd /opt/ai-review/backend
|
||||
source venv/bin/activate
|
||||
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
||||
|
||||
# Когда найдете проблему, включить обратно
|
||||
sudo systemctl enable ai-review
|
||||
sudo systemctl start ai-review
|
||||
```
|
||||
|
||||
### База данных заблокирована
|
||||
|
||||
```bash
|
||||
# Остановить все процессы, использующие БД
|
||||
sudo systemctl stop ai-review
|
||||
sudo lsof /opt/ai-review/backend/review.db
|
||||
|
||||
# Если процессы остались, убить их
|
||||
sudo kill -9 <PID>
|
||||
|
||||
# Запустить сервис
|
||||
sudo systemctl start ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Проверка после обновления
|
||||
|
||||
### Checklist:
|
||||
|
||||
1. **Сервис запущен:**
|
||||
```bash
|
||||
systemctl status ai-review
|
||||
```
|
||||
Должно быть: `Active: active (running)`
|
||||
|
||||
2. **API отвечает:**
|
||||
```bash
|
||||
curl http://localhost:8000/docs
|
||||
```
|
||||
Должно вернуть HTML страницу Swagger UI
|
||||
|
||||
3. **Frontend доступен:**
|
||||
```bash
|
||||
curl http://localhost:8000/ | grep "AI Review"
|
||||
```
|
||||
Должно найти "AI Review" в HTML
|
||||
|
||||
4. **WebSocket работает:**
|
||||
```bash
|
||||
curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" http://localhost:8000/ws/reviews
|
||||
```
|
||||
Должно вернуть `101 Switching Protocols`
|
||||
|
||||
5. **База данных обновлена:**
|
||||
```bash
|
||||
cd /opt/ai-review/backend
|
||||
source venv/bin/activate
|
||||
sqlite3 review.db ".tables"
|
||||
```
|
||||
Должны быть все таблицы, включая новые
|
||||
|
||||
6. **Логи чистые:**
|
||||
```bash
|
||||
journalctl -u ai-review -n 20 --no-pager
|
||||
```
|
||||
Не должно быть ERROR сообщений
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Best Practices
|
||||
|
||||
### 1. Перед обновлением
|
||||
|
||||
- ✅ Проверить текущий статус: `systemctl status ai-review`
|
||||
- ✅ Посмотреть логи: `journalctl -u ai-review -n 50`
|
||||
- ✅ Убедиться, что нет активных review
|
||||
- ✅ Предупредить пользователей о downtime
|
||||
|
||||
### 2. Во время обновления
|
||||
|
||||
- ✅ Следить за выводом скрипта
|
||||
- ✅ Не прерывать процесс
|
||||
- ✅ Записать версию, на которую обновляетесь
|
||||
|
||||
### 3. После обновления
|
||||
|
||||
- ✅ Проверить все пункты из Checklist
|
||||
- ✅ Протестировать основной функционал
|
||||
- ✅ Проверить, что старые review не сломались
|
||||
- ✅ Убедиться, что новые фичи работают
|
||||
|
||||
### 4. В случае проблем
|
||||
|
||||
- ✅ Сохранить логи: `journalctl -u ai-review > error.log`
|
||||
- ✅ Откатиться к предыдущей версии
|
||||
- ✅ Разобраться с проблемой в dev окружении
|
||||
- ✅ Повторить обновление после исправления
|
||||
|
||||
---
|
||||
|
||||
## 📅 Регулярное обслуживание
|
||||
|
||||
### Еженедельно:
|
||||
|
||||
```bash
|
||||
# Проверить место на диске
|
||||
df -h /opt
|
||||
|
||||
# Очистить старые backups (старше 30 дней)
|
||||
find /opt/ai-review-backups/ -type d -mtime +30 -exec rm -rf {} \;
|
||||
|
||||
# Проверить обновления системы
|
||||
sudo apt update
|
||||
sudo apt list --upgradable
|
||||
```
|
||||
|
||||
### Ежемесячно:
|
||||
|
||||
```bash
|
||||
# Обновить Python пакеты
|
||||
cd /opt/ai-review/backend
|
||||
source venv/bin/activate
|
||||
pip list --outdated
|
||||
pip install --upgrade pip
|
||||
pip install --upgrade -r requirements.txt
|
||||
|
||||
# Обновить Node.js пакеты
|
||||
cd /opt/ai-review/frontend
|
||||
npm outdated
|
||||
npm update
|
||||
|
||||
# Redeploy
|
||||
cd /opt/ai-review
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Автоматизация
|
||||
|
||||
### Настроить автоматическое обновление (не рекомендуется для production)
|
||||
|
||||
```bash
|
||||
# Создать cron job для автоматического обновления каждую ночь
|
||||
sudo crontab -e
|
||||
|
||||
# Добавить строку:
|
||||
0 3 * * * cd /opt/ai-review && ./redeploy-ubuntu.sh >> /var/log/ai-review-redeploy.log 2>&1
|
||||
```
|
||||
|
||||
**⚠️ Внимание:** Автоматическое обновление может сломать сервис. Используйте только если уверены.
|
||||
|
||||
### Уведомления о завершении
|
||||
|
||||
```bash
|
||||
# Установить mail utils
|
||||
sudo apt install mailutils
|
||||
|
||||
# Отправить email после redeploy
|
||||
sudo ./redeploy-ubuntu.sh && echo "Redeploy completed" | mail -s "AI Review Updated" admin@example.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Резюме
|
||||
|
||||
**Команда для обновления:**
|
||||
```bash
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
**Команда для отката:**
|
||||
```bash
|
||||
sudo systemctl stop ai-review
|
||||
sudo cp /opt/ai-review-backups/backup-*/review.db /opt/ai-review/backend/
|
||||
cd /opt/ai-review && sudo -u $USER git reset --hard HEAD~1
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
**Логи:**
|
||||
```bash
|
||||
journalctl -u ai-review -f
|
||||
```
|
||||
|
||||
**Проверка работы:**
|
||||
```bash
|
||||
systemctl status ai-review
|
||||
curl http://localhost:8000/docs
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 См. также
|
||||
|
||||
- [UBUNTU_DEPLOYMENT.md](UBUNTU_DEPLOYMENT.md) - Первичная установка
|
||||
- [DEPLOYMENT.md](DEPLOYMENT.md) - Общее руководство по развертыванию
|
||||
- [README.md](README.md) - Основная документация
|
||||
|
||||
150
docs/REDEPLOY_UBUNTU_QUICK.md
Normal file
150
docs/REDEPLOY_UBUNTU_QUICK.md
Normal file
@@ -0,0 +1,150 @@
|
||||
# 🚀 Быстрое обновление на Ubuntu
|
||||
|
||||
## Важно! ⚠️
|
||||
|
||||
Скрипт `redeploy-ubuntu.sh` **требует bash**, не используйте `sh`.
|
||||
|
||||
## ✅ Правильный способ запуска:
|
||||
|
||||
```bash
|
||||
# Вариант 1: Через bash явно
|
||||
cd ~/code-review-agent # или /opt/ai-review
|
||||
sudo bash redeploy-ubuntu.sh
|
||||
|
||||
# Вариант 2: Сделать исполняемым
|
||||
chmod +x redeploy-ubuntu.sh
|
||||
sudo ./redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
## ❌ Неправильно:
|
||||
|
||||
```bash
|
||||
sudo sh redeploy-ubuntu.sh # НЕ ИСПОЛЬЗУЙТЕ sh!
|
||||
```
|
||||
|
||||
## 🔧 Что исправлено:
|
||||
|
||||
1. ✅ Проверка наличия bash
|
||||
2. ✅ Работа из любой директории проекта (не обязательно /opt/ai-review)
|
||||
3. ✅ Backup создается в локальной директории `./backups/`
|
||||
4. ✅ Работает без systemd сервиса (для dev окружения)
|
||||
5. ✅ Не требует интерактивного подтверждения для non-git репозиториев
|
||||
6. ✅ Более надежная обработка ошибок
|
||||
|
||||
## 📋 Workflow обновления:
|
||||
|
||||
### 1. Подготовка (на локальной машине):
|
||||
|
||||
```bash
|
||||
# Внести изменения в код
|
||||
git add .
|
||||
git commit -m "Update feature"
|
||||
git push
|
||||
```
|
||||
|
||||
### 2. На сервере:
|
||||
|
||||
```bash
|
||||
# Зайти на сервер
|
||||
ssh user@your-server
|
||||
|
||||
# Перейти в директорию проекта
|
||||
cd ~/code-review-agent # или где у вас установлен проект
|
||||
|
||||
# Обновить код (если git)
|
||||
git pull
|
||||
|
||||
# ИЛИ скопировать новые файлы вручную:
|
||||
# scp -r ./backend user@server:~/code-review-agent/
|
||||
# scp -r ./frontend user@server:~/code-review-agent/
|
||||
|
||||
# Запустить redeploy
|
||||
sudo bash redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### 3. Проверка:
|
||||
|
||||
```bash
|
||||
# Проверить статус
|
||||
systemctl status ai-review
|
||||
|
||||
# Или если без systemd:
|
||||
ps aux | grep uvicorn
|
||||
|
||||
# Проверить логи
|
||||
journalctl -u ai-review -f
|
||||
# Или:
|
||||
tail -f nohup.out
|
||||
```
|
||||
|
||||
## 🐛 Troubleshooting:
|
||||
|
||||
### Ошибка: "This script requires bash"
|
||||
|
||||
```bash
|
||||
# Используйте bash явно
|
||||
sudo bash redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Ошибка: Permission denied при создании backup
|
||||
|
||||
Это нормально - скрипт создаст backup в локальной директории `./backups/`
|
||||
|
||||
### Ошибка: Service не найден
|
||||
|
||||
Это нормально если вы не устанавливали systemd сервис. Скрипт все равно соберет проект.
|
||||
|
||||
### Frontend не собрался
|
||||
|
||||
```bash
|
||||
cd frontend
|
||||
rm -rf node_modules
|
||||
npm install
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Backend зависимости не установились
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
source venv/bin/activate
|
||||
pip install --upgrade pip
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
## 📊 Что делает скрипт:
|
||||
|
||||
1. **Останавливает сервис** (если установлен в systemd)
|
||||
2. **Создает backup БД** в `./backups/backup-YYYYMMDD-HHMMSS/`
|
||||
3. **Обновляет код** через git pull (если это git репозиторий)
|
||||
4. **Обновляет зависимости backend** (Python пакеты)
|
||||
5. **Применяет миграции БД** (создает новые таблицы)
|
||||
6. **Собирает frontend** (React → static files)
|
||||
7. **Запускает сервис** (если установлен в systemd)
|
||||
|
||||
## 🎯 Быстрые команды:
|
||||
|
||||
```bash
|
||||
# Полное обновление
|
||||
cd ~/code-review-agent && git pull && sudo bash redeploy-ubuntu.sh
|
||||
|
||||
# Только пересборка (без git pull)
|
||||
cd ~/code-review-agent && sudo bash redeploy-ubuntu.sh
|
||||
|
||||
# Откат к предыдущей версии
|
||||
cd ~/code-review-agent
|
||||
sudo systemctl stop ai-review
|
||||
sudo cp backups/backup-YYYYMMDD-HHMMSS/review.db backend/
|
||||
git reset --hard HEAD~1
|
||||
sudo bash redeploy-ubuntu.sh
|
||||
```
|
||||
|
||||
## ✅ Готово!
|
||||
|
||||
Скрипт теперь работает:
|
||||
- ✅ С bash (не sh)
|
||||
- ✅ Из любой директории проекта
|
||||
- ✅ Без интерактивных вопросов
|
||||
- ✅ С локальными backups
|
||||
- ✅ С или без systemd
|
||||
|
||||
303
docs/REVIEW_FEATURES.md
Normal file
303
docs/REVIEW_FEATURES.md
Normal file
@@ -0,0 +1,303 @@
|
||||
# ✨ Новые возможности ревью
|
||||
|
||||
## 🎯 Что добавлено
|
||||
|
||||
### 1. **Inline комментарии в PR** 💬
|
||||
|
||||
Теперь комментарии публикуются **на конкретных строках кода**!
|
||||
|
||||
**Было:**
|
||||
- Один общий комментарий в PR
|
||||
|
||||
**Стало:**
|
||||
- Комментарии прямо на проблемных строках
|
||||
- Видно в какой строке какого файла ошибка
|
||||
- Удобнее исправлять
|
||||
|
||||
**Пример в Gitea:**
|
||||
```
|
||||
src/pages/search-character.tsx
|
||||
Строка 58: 'Content-Type': 'shmapplication/json'
|
||||
↑
|
||||
[AI Comment] ❌ ERROR: Опечатка в строке: 'shmapplication/json'
|
||||
должно быть 'application/json'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. **Автоматический статус PR** 🚦
|
||||
|
||||
Агент **сам устанавливает статус** PR в зависимости от найденных проблем:
|
||||
|
||||
- ✅ **APPROVE** - Если проблем не найдено
|
||||
- 💬 **COMMENT** - Если найдены только WARNING/INFO
|
||||
- ❌ **REQUEST_CHANGES** - Если найдены ERROR (критичные проблемы)
|
||||
|
||||
**В Gitea:**
|
||||
```
|
||||
PR Status: Changes Requested ❌
|
||||
AI Code Review: 4 критичные проблемы найдены
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. **Markdown summary** 📄
|
||||
|
||||
Красивый общий комментарий в markdown с:
|
||||
|
||||
#### **Если есть проблемы:**
|
||||
|
||||
```markdown
|
||||
## 🤖 AI Code Review
|
||||
|
||||
### 📊 Статистика
|
||||
|
||||
- **Всего проблем:** 4
|
||||
- ❌ **Критичных:** 4
|
||||
|
||||
### 🔍 Детали
|
||||
|
||||
#### ❌ Критичные проблемы
|
||||
|
||||
- **src/pages/search-character.tsx:58**
|
||||
Опечатка в строке: 'shmapplication/json' должно быть 'application/json'
|
||||
|
||||
- **src/pages/search-character.tsx:104**
|
||||
Незакрытая скобка в JSX: {searchValueError && ( ... }
|
||||
|
||||
### 💡 Рекомендации
|
||||
|
||||
Пожалуйста, исправьте найденные проблемы перед мержем в main.
|
||||
Детальные комментарии оставлены inline на соответствующих строках кода.
|
||||
```
|
||||
|
||||
#### **Если проблем нет:**
|
||||
|
||||
```markdown
|
||||
## 🤖 AI Code Review
|
||||
|
||||
✅ **Отличная работа!** Серьезных проблем не обнаружено.
|
||||
|
||||
Код выглядит хорошо и соответствует стандартам.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. **Фильтрация `<think>` блоков** 🧹
|
||||
|
||||
Если LLM создает блоки `<think>...</think>` (рассуждения), они **автоматически удаляются**:
|
||||
|
||||
**Ответ LLM:**
|
||||
```
|
||||
<think>
|
||||
Сначала проверю синтаксис... затем логику...
|
||||
</think>
|
||||
Опечатка в Content-Type: 'shmapplication/json'
|
||||
```
|
||||
|
||||
**В Gitea видно:**
|
||||
```
|
||||
Опечатка в Content-Type: 'shmapplication/json'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Как это работает
|
||||
|
||||
### 1. Генерация комментариев
|
||||
|
||||
```python
|
||||
# backend/app/agents/reviewer.py
|
||||
|
||||
# Для каждого файла AI генерирует комментарии
|
||||
comments = await analyzer.analyze_diff(
|
||||
file_path=file_path,
|
||||
diff=patch,
|
||||
pr_title=pr_info.get("title"),
|
||||
pr_description=pr_info.get("description")
|
||||
)
|
||||
|
||||
# Результат:
|
||||
[
|
||||
{
|
||||
"file_path": "src/pages/search-character.tsx",
|
||||
"line": 58,
|
||||
"severity": "ERROR",
|
||||
"message": "Опечатка: 'shmapplication/json'"
|
||||
},
|
||||
...
|
||||
]
|
||||
```
|
||||
|
||||
### 2. Генерация summary
|
||||
|
||||
```python
|
||||
# Создаем markdown summary
|
||||
summary = await analyzer.generate_summary(
|
||||
all_comments=db_comments,
|
||||
pr_title=pr_info.get("title"),
|
||||
pr_description=pr_info.get("description")
|
||||
)
|
||||
|
||||
# summary - это markdown текст
|
||||
```
|
||||
|
||||
### 3. Определение статуса
|
||||
|
||||
```python
|
||||
# Если есть ERROR - требуем изменения
|
||||
has_errors = any(c.get('severity') == 'ERROR' for c in comments)
|
||||
event = "REQUEST_CHANGES" if has_errors else "COMMENT"
|
||||
|
||||
# Если вообще проблем нет - approve
|
||||
if not comments:
|
||||
event = "APPROVE"
|
||||
```
|
||||
|
||||
### 4. Публикация в Gitea
|
||||
|
||||
```python
|
||||
# Одним запросом:
|
||||
# - Inline комментарии
|
||||
# - Общий summary
|
||||
# - Статус PR
|
||||
await git_service.create_review(
|
||||
pr_number=pr_number,
|
||||
comments=formatted_comments, # Inline комментарии
|
||||
body=summary, # Markdown summary
|
||||
event=event # APPROVE/COMMENT/REQUEST_CHANGES
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Gitea API
|
||||
|
||||
### Формат запроса:
|
||||
|
||||
```json
|
||||
POST /repos/{owner}/{repo}/pulls/{pr}/reviews
|
||||
|
||||
{
|
||||
"body": "## 🤖 AI Code Review\n...",
|
||||
"commit_id": "abc123...",
|
||||
"event": "REQUEST_CHANGES",
|
||||
"comments": [
|
||||
{
|
||||
"path": "src/pages/search-character.tsx",
|
||||
"body": "**ERROR**: Опечатка...",
|
||||
"new_position": 58
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Поля:
|
||||
|
||||
- **body** - общий markdown комментарий
|
||||
- **commit_id** - SHA последнего коммита
|
||||
- **event** - статус (APPROVE/COMMENT/REQUEST_CHANGES)
|
||||
- **comments** - массив inline комментариев
|
||||
- **path** - путь к файлу
|
||||
- **body** - текст комментария (markdown)
|
||||
- **new_position** - номер строки
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Что видит пользователь в Gitea
|
||||
|
||||
### В списке PR:
|
||||
|
||||
```
|
||||
PR #5: Добавление функционала аватара
|
||||
Status: ❌ Changes Requested
|
||||
Reviews: 🤖 AI Code Review (4 комментария)
|
||||
```
|
||||
|
||||
### В самом PR:
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ 🤖 AI Code Review │
|
||||
│ Status: ❌ Changes Requested │
|
||||
├─────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ## 🤖 AI Code Review │
|
||||
│ │
|
||||
│ ### 📊 Статистика │
|
||||
│ - Всего проблем: 4 │
|
||||
│ - ❌ Критичных: 4 │
|
||||
│ │
|
||||
│ ### 🔍 Детали │
|
||||
│ ... │
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
Files Changed (1):
|
||||
|
||||
┌─────────────────────────────────────────┐
|
||||
│ src/pages/search-character.tsx │
|
||||
├─────────────────────────────────────────┤
|
||||
│ 55 | search: searchValue │
|
||||
│ 56 | }), │
|
||||
│ 57 | headers: { │
|
||||
│ 58 | 'Content-Type': 'shmap... │ 👈 [AI Comment]
|
||||
│ │ │ ❌ ERROR: Опечатка
|
||||
│ 59 | } │
|
||||
│ ... | │
|
||||
│ 104 | {searchValueError && ( │ 👈 [AI Comment]
|
||||
│ | │ ❌ ERROR: Незакрытая
|
||||
│ | │ скобка
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Преимущества
|
||||
|
||||
1. **Наглядность** - видно ЧТО и ГДЕ не так
|
||||
2. **Статус PR** - сразу понятно можно ли мержить
|
||||
3. **Markdown** - красивое форматирование
|
||||
4. **Inline** - комментарии прямо на коде
|
||||
5. **Чистота** - `<think>` блоки удаляются
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Как проверить
|
||||
|
||||
1. Запустите ревью на любом PR
|
||||
2. Дождитесь завершения
|
||||
3. Откройте PR в Gitea
|
||||
4. Проверьте:
|
||||
- ✅ Inline комментарии на строках
|
||||
- ✅ Общий markdown summary
|
||||
- ✅ Статус PR (Approved/Changes Requested)
|
||||
- ✅ Красивое форматирование
|
||||
|
||||
---
|
||||
|
||||
## 📝 Измененные файлы
|
||||
|
||||
- `backend/app/agents/reviewer.py`:
|
||||
- Генерация summary
|
||||
- Определение статуса
|
||||
- Фильтрация `<think>` блоков
|
||||
|
||||
- `backend/app/agents/tools.py`:
|
||||
- Метод `generate_summary()`
|
||||
|
||||
- `backend/app/services/gitea.py`:
|
||||
- Параметр `event` в `create_review()`
|
||||
- Детальное логирование
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Готово!
|
||||
|
||||
Теперь ревью полноценное:
|
||||
- ✅ Inline комментарии
|
||||
- ✅ Статус PR
|
||||
- ✅ Markdown summary
|
||||
- ✅ Чистый вывод
|
||||
|
||||
**Попробуйте!** 🎉
|
||||
|
||||
132
docs/START_PROJECT.md
Normal file
132
docs/START_PROJECT.md
Normal file
@@ -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) - все команды
|
||||
|
||||
271
docs/SUMMARY.md
Normal file
271
docs/SUMMARY.md
Normal file
@@ -0,0 +1,271 @@
|
||||
# 📋 AI Code Review Agent - Резюме проекта
|
||||
|
||||
## 🎯 Что создано
|
||||
|
||||
Полнофункциональный **AI агент для автоматического ревью Pull Request** с поддержкой:
|
||||
- **Gitea** (приоритет)
|
||||
- **GitHub**
|
||||
- **Bitbucket**
|
||||
|
||||
Работает на **LangChain/LangGraph** с локальной LLM через **Ollama**.
|
||||
|
||||
## 📦 Структура проекта
|
||||
|
||||
```
|
||||
platform/review/
|
||||
├── 📄 Документация (10 файлов)
|
||||
│ ├── README.md - Полная документация
|
||||
│ ├── QUICKSTART.md - Быстрый старт за 5 минут
|
||||
│ ├── ARCHITECTURE.md - Архитектура системы
|
||||
│ ├── COMMANDS.md - Полезные команды
|
||||
│ ├── CONTRIBUTING.md - Гайд для контрибьюторов
|
||||
│ ├── PROJECT_STATUS.md - Статус и TODO
|
||||
│ ├── cloud.md - План разработки
|
||||
│ ├── LICENSE - MIT License
|
||||
│ └── .gitignore
|
||||
│
|
||||
├── 🔧 Backend (25+ файлов)
|
||||
│ ├── app/
|
||||
│ │ ├── agents/ - LangGraph агент (3 файла)
|
||||
│ │ ├── api/ - REST endpoints (4 файла)
|
||||
│ │ ├── models/ - SQLAlchemy модели (5 файлов)
|
||||
│ │ ├── schemas/ - Pydantic схемы (4 файла)
|
||||
│ │ ├── services/ - Git платформы (5 файлов)
|
||||
│ │ ├── webhooks/ - Webhook handlers (4 файла)
|
||||
│ │ ├── config.py
|
||||
│ │ ├── database.py
|
||||
│ │ ├── main.py
|
||||
│ │ └── utils.py
|
||||
│ ├── requirements.txt
|
||||
│ ├── start.sh / start.bat
|
||||
│ └── README.md
|
||||
│
|
||||
└── 🎨 Frontend (20+ файлов)
|
||||
├── src/
|
||||
│ ├── api/ - API клиент (2 файла)
|
||||
│ ├── components/ - React компоненты (6 файлов)
|
||||
│ ├── pages/ - Страницы (4 файла)
|
||||
│ ├── types/ - TypeScript типы
|
||||
│ ├── App.tsx
|
||||
│ ├── main.tsx
|
||||
│ └── index.css
|
||||
├── package.json
|
||||
├── vite.config.ts
|
||||
├── tsconfig.json
|
||||
├── tailwind.config.js
|
||||
├── start.sh / start.bat
|
||||
└── README.md
|
||||
```
|
||||
|
||||
**Всего: ~60+ файлов, ~5000+ строк кода**
|
||||
|
||||
## ✨ Ключевые функции
|
||||
|
||||
### Backend
|
||||
- ✅ FastAPI с async/await
|
||||
- ✅ LangGraph агент с workflow
|
||||
- ✅ Ollama интеграция (codellama)
|
||||
- ✅ SQLAlchemy + SQLite (легко мигрировать на PostgreSQL)
|
||||
- ✅ Pydantic схемы для валидации
|
||||
- ✅ Webhook handlers для всех платформ
|
||||
- ✅ WebSocket для real-time
|
||||
- ✅ Шифрование API токенов
|
||||
- ✅ Background tasks
|
||||
- ✅ Swagger документация
|
||||
|
||||
### Frontend
|
||||
- ✅ React 18 + TypeScript
|
||||
- ✅ Vite для быстрой разработки
|
||||
- ✅ TanStack Query для state management
|
||||
- ✅ React Router для навигации
|
||||
- ✅ Tailwind CSS для стилей
|
||||
- ✅ WebSocket клиент с auto-reconnect
|
||||
- ✅ Real-time обновления
|
||||
- ✅ Современный UI/UX
|
||||
|
||||
### Интеграции
|
||||
- ✅ Gitea API (полная поддержка)
|
||||
- ✅ GitHub API (полная поддержка)
|
||||
- ✅ Bitbucket API (полная поддержка)
|
||||
- ✅ Webhook signature validation
|
||||
- ✅ Автоматическая отправка комментариев в PR
|
||||
|
||||
## 🚀 Быстрый запуск
|
||||
|
||||
### 3 простых шага:
|
||||
|
||||
```bash
|
||||
# 1. Ollama
|
||||
ollama pull codellama && ollama serve
|
||||
|
||||
# 2. Backend
|
||||
cd backend && ./start.sh
|
||||
|
||||
# 3. Frontend
|
||||
cd frontend && ./start.sh
|
||||
```
|
||||
|
||||
Откройте http://localhost:5173 - готово! 🎉
|
||||
|
||||
## 📊 Что анализирует AI
|
||||
|
||||
- 🐛 **Баги**: логические ошибки, null/undefined
|
||||
- 🔒 **Безопасность**: SQL injection, XSS, утечки
|
||||
- 📝 **Best practices**: SOLID, clean code
|
||||
- ⚡ **Производительность**: алгоритмы, память
|
||||
- 📖 **Читаемость**: структура, комментарии
|
||||
|
||||
## 🎨 UI Страницы
|
||||
|
||||
1. **Dashboard** (`/`) - статистика и метрики
|
||||
2. **Repositories** (`/repositories`) - управление репозиториями
|
||||
3. **Reviews** (`/reviews`) - история ревью с фильтрами
|
||||
4. **Review Detail** (`/reviews/:id`) - детали и комментарии
|
||||
|
||||
## 🔌 API Endpoints
|
||||
|
||||
```
|
||||
POST /api/repositories - создать репозиторий
|
||||
GET /api/repositories - список
|
||||
PUT /api/repositories/{id} - обновить
|
||||
DELETE /api/repositories/{id} - удалить
|
||||
|
||||
GET /api/reviews - список ревью
|
||||
GET /api/reviews/{id} - детали
|
||||
POST /api/reviews/{id}/retry - повторить
|
||||
GET /api/reviews/stats/dashboard - статистика
|
||||
|
||||
POST /api/webhooks/gitea/{repo_id}
|
||||
POST /api/webhooks/github/{repo_id}
|
||||
POST /api/webhooks/bitbucket/{repo_id}
|
||||
|
||||
WS /ws/reviews - real-time
|
||||
```
|
||||
|
||||
## 🎯 Workflow
|
||||
|
||||
```
|
||||
1. User создает PR в Git репозитории
|
||||
↓
|
||||
2. Git платформа отправляет webhook
|
||||
↓
|
||||
3. Backend получает webhook, создает Review
|
||||
↓
|
||||
4. LangGraph агент запускается:
|
||||
- Получает файлы PR
|
||||
- Анализирует через Ollama
|
||||
- Генерирует комментарии
|
||||
↓
|
||||
5. Комментарии отправляются в PR
|
||||
↓
|
||||
6. WebSocket уведомляет Frontend
|
||||
↓
|
||||
7. UI обновляется в реальном времени
|
||||
```
|
||||
|
||||
## 💻 Технологический стек
|
||||
|
||||
| Компонент | Технология |
|
||||
|-----------|------------|
|
||||
| Backend Framework | FastAPI |
|
||||
| AI Framework | LangChain/LangGraph |
|
||||
| LLM Server | Ollama (codellama) |
|
||||
| Database | SQLite → PostgreSQL |
|
||||
| API Schema | Pydantic |
|
||||
| ORM | SQLAlchemy |
|
||||
| HTTP Client | httpx |
|
||||
| Frontend Framework | React 18 |
|
||||
| Language | TypeScript |
|
||||
| Build Tool | Vite |
|
||||
| State Management | TanStack Query |
|
||||
| Routing | React Router |
|
||||
| Styling | Tailwind CSS |
|
||||
| Real-time | WebSocket |
|
||||
|
||||
## 📖 Документация
|
||||
|
||||
| Файл | Описание |
|
||||
|------|----------|
|
||||
| README.md | Полная документация проекта |
|
||||
| QUICKSTART.md | Быстрый старт за 5 минут |
|
||||
| ARCHITECTURE.md | Детальная архитектура |
|
||||
| COMMANDS.md | Полезные команды |
|
||||
| CONTRIBUTING.md | Гайд для контрибьюторов |
|
||||
| PROJECT_STATUS.md | Статус и TODO список |
|
||||
| cloud.md | Изначальный план |
|
||||
| backend/README.md | Backend документация |
|
||||
| frontend/README.md | Frontend документация |
|
||||
|
||||
## 🎓 Что изучено/применено
|
||||
|
||||
- ✅ FastAPI с async/await
|
||||
- ✅ LangChain/LangGraph для AI агентов
|
||||
- ✅ Ollama для локального LLM
|
||||
- ✅ SQLAlchemy ORM
|
||||
- ✅ React 18 с хуками
|
||||
- ✅ TypeScript строгая типизация
|
||||
- ✅ TanStack Query
|
||||
- ✅ WebSocket real-time
|
||||
- ✅ Git платформы API (Gitea, GitHub, Bitbucket)
|
||||
- ✅ Webhook интеграция
|
||||
- ✅ Шифрование данных
|
||||
- ✅ Background tasks
|
||||
|
||||
## 🔐 Безопасность
|
||||
|
||||
- ✅ API токены шифруются (Fernet)
|
||||
- ✅ Webhook signature validation
|
||||
- ✅ CORS настроен
|
||||
- ✅ Environment variables
|
||||
- ⚠️ Рекомендуется rate limiting для prod
|
||||
|
||||
## 📈 Производительность
|
||||
|
||||
- Анализ файла: ~5-30 сек
|
||||
- PR (5-10 файлов): ~1-3 мин
|
||||
- WebSocket latency: <100ms
|
||||
|
||||
## 🚧 Будущие улучшения
|
||||
|
||||
**High Priority:**
|
||||
- Docker контейнеризация
|
||||
- Unit & integration тесты
|
||||
- CI/CD pipeline
|
||||
|
||||
**Medium Priority:**
|
||||
- PostgreSQL
|
||||
- Redis кеширование
|
||||
- Rate limiting
|
||||
- Email уведомления
|
||||
|
||||
**Low Priority:**
|
||||
- GitLab поддержка
|
||||
- Множественные LLM
|
||||
- Grafana мониторинг
|
||||
|
||||
## ✅ Готовность
|
||||
|
||||
- ✅ **Полностью функционален**
|
||||
- ✅ **Готов к использованию**
|
||||
- ✅ **Документирован**
|
||||
- ⚠️ **Production**: добавить Docker, тесты, PostgreSQL
|
||||
|
||||
## 🎉 Итоговый результат
|
||||
|
||||
**Создан полнофункциональный AI Code Review Agent**:
|
||||
- 60+ файлов
|
||||
- 5000+ строк кода
|
||||
- Все требования выполнены
|
||||
- Полная документация
|
||||
- Готов к использованию
|
||||
|
||||
**Можно сразу использовать для автоматического ревью кода!** 🚀
|
||||
|
||||
---
|
||||
|
||||
**Разработано с ❤️ и 🤖 AI**
|
||||
|
||||
Версия: 0.1.0
|
||||
Дата создания: 2024
|
||||
Лицензия: MIT
|
||||
|
||||
181
docs/TEST_STREAMING.md
Normal file
181
docs/TEST_STREAMING.md
Normal file
@@ -0,0 +1,181 @@
|
||||
# Тестирование LangGraph Streaming
|
||||
|
||||
Эти скрипты помогут проверить, как работает стриминг событий из LangGraph.
|
||||
|
||||
## Скрипты
|
||||
|
||||
### 1. `test_simple_graph.py` - Простой тест (БЕЗ БД)
|
||||
|
||||
**Рекомендуется запустить ПЕРВЫМ** для понимания как работает стриминг.
|
||||
|
||||
Тестирует простой граф с 3 нодами без реального review.
|
||||
|
||||
```bash
|
||||
# Активировать venv
|
||||
cd backend
|
||||
source venv/Scripts/activate # Windows Git Bash
|
||||
# или
|
||||
source venv/bin/activate # Linux/Mac
|
||||
|
||||
# Запустить
|
||||
python ../test_simple_graph.py
|
||||
```
|
||||
|
||||
**Что тестирует:**
|
||||
- ✅ `stream_mode=['updates']` - обновления нод
|
||||
- ✅ `stream_mode=['messages']` - сообщения (LLM calls)
|
||||
- ✅ `stream_mode=['updates', 'messages']` - оба режима
|
||||
- ✅ `stream_mode=['values']` - значения состояния
|
||||
- ✅ `stream_mode=['debug']` - режим отладки
|
||||
- ✅ Callback обработка событий
|
||||
|
||||
**Ожидаемый результат:**
|
||||
Должны появиться события для каждой ноды (node_1, node_2, node_3).
|
||||
|
||||
---
|
||||
|
||||
### 2. `test_langgraph_events.py` - Полный тест (С БД)
|
||||
|
||||
Тестирует реальный ReviewerAgent с настоящими данными из БД.
|
||||
|
||||
⚠️ **Требует:**
|
||||
- Работающую БД с данными
|
||||
- Существующий Review ID, PR Number, Repository ID
|
||||
- Настроенный `.env` файл
|
||||
|
||||
```bash
|
||||
# Активировать venv
|
||||
cd backend
|
||||
source venv/Scripts/activate # Windows
|
||||
# или
|
||||
source venv/bin/activate # Linux/Mac
|
||||
|
||||
# Запустить
|
||||
python ../test_langgraph_events.py
|
||||
```
|
||||
|
||||
**Перед запуском:**
|
||||
Отредактируйте в файле `test_langgraph_events.py`:
|
||||
|
||||
```python
|
||||
TEST_REVIEW_ID = 1 # ID существующего review
|
||||
TEST_PR_NUMBER = 5 # Номер PR
|
||||
TEST_REPOSITORY_ID = 1 # ID репозитория
|
||||
```
|
||||
|
||||
**Что тестирует:**
|
||||
- ✅ Полный цикл review с callback
|
||||
- ✅ RAW стриминг напрямую из графа
|
||||
- ✅ Все режимы: `updates`, `messages`, `updates + messages`
|
||||
|
||||
---
|
||||
|
||||
## Запуск локально (быстрый старт)
|
||||
|
||||
### Шаг 1: Простой тест
|
||||
```bash
|
||||
cd backend
|
||||
source venv/Scripts/activate
|
||||
python ../test_simple_graph.py
|
||||
```
|
||||
|
||||
Смотрите вывод - должны быть события от каждой ноды.
|
||||
|
||||
### Шаг 2: Проверка формата событий
|
||||
|
||||
Обратите внимание на **тип** и **структуру** событий:
|
||||
|
||||
```
|
||||
📨 Event #1
|
||||
Type: <class 'dict'>
|
||||
Keys: ['node_1']
|
||||
Content: {'node_1': {...}}
|
||||
```
|
||||
|
||||
или
|
||||
|
||||
```
|
||||
📨 Event #1
|
||||
Type: <class 'tuple'>
|
||||
Tuple[0]: 'messages'
|
||||
Tuple[1]: [AIMessage(...)]
|
||||
```
|
||||
|
||||
### Шаг 3: Полный тест (если нужно)
|
||||
|
||||
Отредактируйте параметры в `test_langgraph_events.py` и запустите:
|
||||
|
||||
```bash
|
||||
python ../test_langgraph_events.py
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Что искать в выводе
|
||||
|
||||
### ✅ ХОРОШО:
|
||||
|
||||
```
|
||||
📨 Event #1
|
||||
Type: <class 'dict'>
|
||||
Content: {'node_1': {...}}
|
||||
|
||||
📨 Event #2
|
||||
Type: <class 'dict'>
|
||||
Content: {'node_2': {...}}
|
||||
```
|
||||
|
||||
**События приходят!** Граф работает.
|
||||
|
||||
### ❌ ПЛОХО:
|
||||
|
||||
```
|
||||
✅ Получено событий: 0
|
||||
```
|
||||
|
||||
**События НЕ приходят!** Проблема с графом или версией LangGraph.
|
||||
|
||||
---
|
||||
|
||||
## Отладка
|
||||
|
||||
Если события не приходят:
|
||||
|
||||
1. **Проверьте версию LangGraph:**
|
||||
```bash
|
||||
pip show langgraph
|
||||
```
|
||||
Должна быть >= 0.1.0
|
||||
|
||||
2. **Проверьте, что граф компилируется:**
|
||||
```python
|
||||
graph = workflow.compile()
|
||||
print(graph) # Должен вывести информацию о графе
|
||||
```
|
||||
|
||||
3. **Попробуйте `ainvoke` вместо `astream`:**
|
||||
```python
|
||||
result = await graph.ainvoke(initial_state)
|
||||
print(result) # Должен вернуть финальное состояние
|
||||
```
|
||||
|
||||
4. **Проверьте логи:**
|
||||
Включите DEBUG логирование:
|
||||
```python
|
||||
import logging
|
||||
logging.basicConfig(level=logging.DEBUG)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Результаты
|
||||
|
||||
После запуска тестов вы узнаете:
|
||||
|
||||
1. ✅ **Работает ли стриминг вообще?**
|
||||
2. ✅ **Какой формат у событий?**
|
||||
3. ✅ **Какие режимы стриминга поддерживаются?**
|
||||
4. ✅ **Как правильно обрабатывать события?**
|
||||
|
||||
Это поможет понять, почему события не доходят до фронтенда.
|
||||
|
||||
522
docs/UBUNTU_DEPLOYMENT.md
Normal file
522
docs/UBUNTU_DEPLOYMENT.md
Normal file
@@ -0,0 +1,522 @@
|
||||
# 🐧 Развертывание на Ubuntu с Systemd
|
||||
|
||||
Руководство по развертыванию AI Code Review Platform на Ubuntu Server с systemd.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Быстрая установка
|
||||
|
||||
### Одна команда:
|
||||
|
||||
```bash
|
||||
sudo ./deploy-ubuntu.sh
|
||||
```
|
||||
|
||||
Скрипт автоматически:
|
||||
- ✅ Установит зависимости (Python, Node.js)
|
||||
- ✅ Соберет frontend
|
||||
- ✅ Создаст systemd service
|
||||
- ✅ Настроит логирование
|
||||
- ✅ Запустит сервис
|
||||
- ✅ (Опционально) Настроит nginx
|
||||
|
||||
---
|
||||
|
||||
## 📋 Требования
|
||||
|
||||
### Системные требования:
|
||||
|
||||
- **OS:** Ubuntu 20.04+ / Debian 11+
|
||||
- **Python:** 3.10+
|
||||
- **Node.js:** 18+
|
||||
- **RAM:** минимум 2GB
|
||||
- **Disk:** минимум 5GB
|
||||
|
||||
### Права:
|
||||
|
||||
Скрипт должен быть запущен с **sudo**
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Пошаговая установка
|
||||
|
||||
### 1. Клонирование репозитория
|
||||
|
||||
```bash
|
||||
cd ~
|
||||
git clone <repository-url>
|
||||
cd platform/review
|
||||
```
|
||||
|
||||
### 2. Подготовка скрипта
|
||||
|
||||
```bash
|
||||
chmod +x deploy-ubuntu.sh
|
||||
chmod +x uninstall-ubuntu.sh
|
||||
```
|
||||
|
||||
### 3. Запуск установки
|
||||
|
||||
```bash
|
||||
sudo ./deploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### 4. Следуйте инструкциям
|
||||
|
||||
Скрипт спросит:
|
||||
- Установить ли nginx?
|
||||
- Доменное имя (для nginx)
|
||||
|
||||
---
|
||||
|
||||
## 📁 Структура после установки
|
||||
|
||||
```
|
||||
/opt/ai-review/ # Основная директория
|
||||
├── backend/
|
||||
│ ├── app/
|
||||
│ ├── public/ # Frontend build
|
||||
│ ├── venv/ # Python venv
|
||||
│ ├── .env # Конфигурация
|
||||
│ └── review.db # База данных
|
||||
├── frontend/
|
||||
└── ...
|
||||
|
||||
/var/log/ai-review/ # Логи
|
||||
├── access.log
|
||||
└── error.log
|
||||
|
||||
/etc/systemd/system/ # Systemd
|
||||
└── ai-review.service
|
||||
|
||||
/etc/nginx/ # Nginx (опционально)
|
||||
└── sites-available/
|
||||
└── ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Конфигурация
|
||||
|
||||
### Редактирование .env:
|
||||
|
||||
```bash
|
||||
sudo nano /opt/ai-review/backend/.env
|
||||
```
|
||||
|
||||
**Обязательно настройте:**
|
||||
|
||||
```bash
|
||||
# Ollama
|
||||
OLLAMA_BASE_URL=http://localhost:11434
|
||||
OLLAMA_MODEL=mistral:7b
|
||||
|
||||
# Мастер токены
|
||||
MASTER_GITEA_TOKEN=your_token_here
|
||||
MASTER_GITHUB_TOKEN=your_token_here
|
||||
|
||||
# Ключ шифрования (уже создан)
|
||||
ENCRYPTION_KEY=...
|
||||
```
|
||||
|
||||
**После изменений:**
|
||||
|
||||
```bash
|
||||
sudo systemctl restart ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Управление сервисом
|
||||
|
||||
### Systemd команды:
|
||||
|
||||
```bash
|
||||
# Статус
|
||||
sudo systemctl status ai-review
|
||||
|
||||
# Запуск
|
||||
sudo systemctl start ai-review
|
||||
|
||||
# Остановка
|
||||
sudo systemctl stop ai-review
|
||||
|
||||
# Перезапуск
|
||||
sudo systemctl restart ai-review
|
||||
|
||||
# Автозапуск при загрузке
|
||||
sudo systemctl enable ai-review
|
||||
|
||||
# Отключить автозапуск
|
||||
sudo systemctl disable ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Мониторинг
|
||||
|
||||
### Просмотр логов:
|
||||
|
||||
**Systemd журнал:**
|
||||
```bash
|
||||
# Последние 50 строк
|
||||
sudo journalctl -u ai-review -n 50
|
||||
|
||||
# В реальном времени
|
||||
sudo journalctl -u ai-review -f
|
||||
|
||||
# Только ошибки
|
||||
sudo journalctl -u ai-review -p err
|
||||
```
|
||||
|
||||
**Файлы логов:**
|
||||
```bash
|
||||
# Access log
|
||||
tail -f /var/log/ai-review/access.log
|
||||
|
||||
# Error log
|
||||
tail -f /var/log/ai-review/error.log
|
||||
|
||||
# Последние 100 строк
|
||||
tail -n 100 /var/log/ai-review/error.log
|
||||
```
|
||||
|
||||
### Проверка состояния:
|
||||
|
||||
```bash
|
||||
# Health check
|
||||
curl http://localhost:8000/health
|
||||
|
||||
# API
|
||||
curl http://localhost:8000/api/repositories
|
||||
|
||||
# Статус процесса
|
||||
ps aux | grep uvicorn
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🌐 Nginx как Reverse Proxy
|
||||
|
||||
### Конфигурация создается автоматически:
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name yourdomain.com;
|
||||
|
||||
location / {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
}
|
||||
|
||||
location /ws {
|
||||
proxy_pass http://localhost:8000;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection "upgrade";
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Ручная настройка nginx:
|
||||
|
||||
```bash
|
||||
# Редактировать конфиг
|
||||
sudo nano /etc/nginx/sites-available/ai-review
|
||||
|
||||
# Проверить синтаксис
|
||||
sudo nginx -t
|
||||
|
||||
# Перезагрузить nginx
|
||||
sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔒 SSL/HTTPS с Let's Encrypt
|
||||
|
||||
### Установка Certbot:
|
||||
|
||||
```bash
|
||||
sudo apt-get install certbot python3-certbot-nginx
|
||||
```
|
||||
|
||||
### Получение сертификата:
|
||||
|
||||
```bash
|
||||
sudo certbot --nginx -d yourdomain.com
|
||||
```
|
||||
|
||||
Certbot автоматически настроит nginx для HTTPS!
|
||||
|
||||
### Автопродление:
|
||||
|
||||
```bash
|
||||
# Проверка таймера
|
||||
sudo systemctl status certbot.timer
|
||||
|
||||
# Тестовое продление
|
||||
sudo certbot renew --dry-run
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔥 Firewall
|
||||
|
||||
### UFW (Ubuntu Firewall):
|
||||
|
||||
```bash
|
||||
# Разрешить SSH
|
||||
sudo ufw allow 22
|
||||
|
||||
# Разрешить HTTP
|
||||
sudo ufw allow 80
|
||||
|
||||
# Разрешить HTTPS
|
||||
sudo ufw allow 443
|
||||
|
||||
# Включить firewall
|
||||
sudo ufw enable
|
||||
|
||||
# Статус
|
||||
sudo ufw status
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Сервис не запускается:
|
||||
|
||||
```bash
|
||||
# Проверить логи
|
||||
sudo journalctl -u ai-review -n 100
|
||||
|
||||
# Проверить статус
|
||||
sudo systemctl status ai-review
|
||||
|
||||
# Проверить права
|
||||
ls -la /opt/ai-review/backend/
|
||||
|
||||
# Проверить .env
|
||||
cat /opt/ai-review/backend/.env
|
||||
```
|
||||
|
||||
### База данных не создается:
|
||||
|
||||
```bash
|
||||
# Проверить права на директорию
|
||||
sudo chown -R $USER:$USER /opt/ai-review/backend/
|
||||
|
||||
# Пересоздать БД
|
||||
rm /opt/ai-review/backend/review.db
|
||||
sudo systemctl restart ai-review
|
||||
```
|
||||
|
||||
### Ollama недоступен:
|
||||
|
||||
```bash
|
||||
# Проверить Ollama
|
||||
curl http://localhost:11434/api/version
|
||||
|
||||
# Установить Ollama
|
||||
curl -fsSL https://ollama.com/install.sh | sh
|
||||
|
||||
# Скачать модель
|
||||
ollama pull mistral:7b
|
||||
```
|
||||
|
||||
### Nginx ошибка:
|
||||
|
||||
```bash
|
||||
# Проверить конфигурацию
|
||||
sudo nginx -t
|
||||
|
||||
# Проверить логи nginx
|
||||
sudo tail -f /var/log/nginx/error.log
|
||||
|
||||
# Проверить что backend работает
|
||||
curl http://localhost:8000/health
|
||||
```
|
||||
|
||||
### Нет места на диске:
|
||||
|
||||
```bash
|
||||
# Проверить место
|
||||
df -h
|
||||
|
||||
# Очистить старые логи
|
||||
sudo journalctl --vacuum-time=7d
|
||||
|
||||
# Очистить логи приложения
|
||||
sudo truncate -s 0 /var/log/ai-review/*.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📦 Обновление
|
||||
|
||||
### Автоматическое обновление:
|
||||
|
||||
```bash
|
||||
cd /opt/ai-review
|
||||
sudo git pull
|
||||
sudo ./deploy-ubuntu.sh
|
||||
```
|
||||
|
||||
### Ручное обновление:
|
||||
|
||||
```bash
|
||||
# 1. Остановить сервис
|
||||
sudo systemctl stop ai-review
|
||||
|
||||
# 2. Обновить код
|
||||
cd /opt/ai-review
|
||||
sudo git pull
|
||||
|
||||
# 3. Пересобрать frontend
|
||||
cd frontend
|
||||
npm install
|
||||
npm run build
|
||||
|
||||
# 4. Обновить Python зависимости
|
||||
cd ../backend
|
||||
source venv/bin/activate
|
||||
pip install -r requirements.txt
|
||||
deactivate
|
||||
|
||||
# 5. Запустить сервис
|
||||
sudo systemctl start ai-review
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🗑️ Удаление
|
||||
|
||||
### Полное удаление:
|
||||
|
||||
```bash
|
||||
sudo ./uninstall-ubuntu.sh
|
||||
```
|
||||
|
||||
Это удалит:
|
||||
- Systemd service
|
||||
- Все файлы в `/opt/ai-review`
|
||||
- Nginx конфигурацию
|
||||
- Логи
|
||||
|
||||
---
|
||||
|
||||
## 📊 Мониторинг производительности
|
||||
|
||||
### Использование ресурсов:
|
||||
|
||||
```bash
|
||||
# CPU и память
|
||||
top -p $(pgrep -f "uvicorn app.main")
|
||||
|
||||
# Детальная информация
|
||||
htop
|
||||
|
||||
# Использование диска
|
||||
du -sh /opt/ai-review/*
|
||||
```
|
||||
|
||||
### Systemd ресурсы:
|
||||
|
||||
```bash
|
||||
# Статистика сервиса
|
||||
systemctl show ai-review --property=CPUUsageNSec
|
||||
systemctl show ai-review --property=MemoryCurrent
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Backup
|
||||
|
||||
### Создание резервной копии:
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# backup.sh
|
||||
|
||||
BACKUP_DIR="/backup/ai-review"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
mkdir -p "$BACKUP_DIR"
|
||||
|
||||
# Резервная копия БД
|
||||
cp /opt/ai-review/backend/review.db \
|
||||
"$BACKUP_DIR/review_$DATE.db"
|
||||
|
||||
# Резервная копия .env
|
||||
cp /opt/ai-review/backend/.env \
|
||||
"$BACKUP_DIR/env_$DATE"
|
||||
|
||||
# Сжать старые бэкапы
|
||||
find "$BACKUP_DIR" -name "*.db" -mtime +7 -exec gzip {} \;
|
||||
|
||||
echo "Backup создан: $BACKUP_DIR/review_$DATE.db"
|
||||
```
|
||||
|
||||
### Автоматический backup через cron:
|
||||
|
||||
```bash
|
||||
# Редактировать crontab
|
||||
sudo crontab -e
|
||||
|
||||
# Добавить строку (каждый день в 3:00)
|
||||
0 3 * * * /opt/ai-review/backup.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Checklist после установки
|
||||
|
||||
- [ ] Сервис запущен (`systemctl status ai-review`)
|
||||
- [ ] Health check работает (`curl localhost:8000/health`)
|
||||
- [ ] Frontend открывается в браузере
|
||||
- [ ] Настроен .env с токенами
|
||||
- [ ] Ollama запущен и модель скачана
|
||||
- [ ] Nginx настроен (если используется)
|
||||
- [ ] SSL сертификат получен (если нужен)
|
||||
- [ ] Firewall настроен
|
||||
- [ ] Логи пишутся (`tail -f /var/log/ai-review/access.log`)
|
||||
- [ ] Автозапуск включен (`systemctl is-enabled ai-review`)
|
||||
- [ ] Backup настроен
|
||||
|
||||
---
|
||||
|
||||
## 📞 Поддержка
|
||||
|
||||
Если возникли проблемы:
|
||||
|
||||
1. Проверьте логи: `sudo journalctl -u ai-review -n 100`
|
||||
2. Проверьте конфигурацию: `cat /opt/ai-review/backend/.env`
|
||||
3. Проверьте статус: `sudo systemctl status ai-review`
|
||||
4. Откройте issue в репозитории
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Готово!
|
||||
|
||||
Сервис развернут и готов к работе!
|
||||
|
||||
**Доступ:**
|
||||
- Local: http://localhost:8000
|
||||
- External: http://your-domain.com
|
||||
|
||||
**Управление:**
|
||||
```bash
|
||||
sudo systemctl {start|stop|restart|status} ai-review
|
||||
```
|
||||
|
||||
**Логи:**
|
||||
```bash
|
||||
sudo journalctl -u ai-review -f
|
||||
```
|
||||
|
||||
**Наслаждайтесь автоматическим ревью кода! 🚀**
|
||||
|
||||
365
docs/cloud.md
Normal file
365
docs/cloud.md
Normal file
@@ -0,0 +1,365 @@
|
||||
# План создания AI агента-ревьювера
|
||||
|
||||
## Обзор проекта
|
||||
|
||||
AI агент-ревьювер для автоматического анализа Pull Request с поддержкой Gitea, GitHub и Bitbucket. Работает на LangChain/LangGraph с Ollama.
|
||||
|
||||
## Архитектура
|
||||
|
||||
```
|
||||
platform/review/
|
||||
├── backend/
|
||||
│ ├── app/
|
||||
│ │ ├── __init__.py
|
||||
│ │ ├── main.py # FastAPI приложение
|
||||
│ │ ├── config.py # Конфигурация
|
||||
│ │ ├── database.py # Database setup
|
||||
│ │ ├── models/ # SQLAlchemy модели
|
||||
│ │ │ ├── __init__.py
|
||||
│ │ │ ├── repository.py
|
||||
│ │ │ ├── pull_request.py
|
||||
│ │ │ ├── review.py
|
||||
│ │ │ └── comment.py
|
||||
│ │ ├── schemas/ # Pydantic схемы
|
||||
│ │ │ ├── __init__.py
|
||||
│ │ │ ├── repository.py
|
||||
│ │ │ ├── review.py
|
||||
│ │ │ └── webhook.py
|
||||
│ │ ├── agents/ # LangGraph агенты
|
||||
│ │ │ ├── __init__.py
|
||||
│ │ │ ├── reviewer.py # Основной агент-ревьювер
|
||||
│ │ │ ├── tools.py # Инструменты агента
|
||||
│ │ │ └── prompts.py # Промпты для агента
|
||||
│ │ ├── services/ # Сервисы интеграций
|
||||
│ │ │ ├── __init__.py
|
||||
│ │ │ ├── base.py # Базовый класс
|
||||
│ │ │ ├── gitea.py # Gitea API
|
||||
│ │ │ ├── github.py # GitHub API
|
||||
│ │ │ └── bitbucket.py # Bitbucket API
|
||||
│ │ ├── webhooks/ # Webhook обработчики
|
||||
│ │ │ ├── __init__.py
|
||||
│ │ │ ├── gitea.py
|
||||
│ │ │ ├── github.py
|
||||
│ │ │ └── bitbucket.py
|
||||
│ │ └── api/ # API endpoints
|
||||
│ │ ├── __init__.py
|
||||
│ │ ├── repositories.py
|
||||
│ │ ├── reviews.py
|
||||
│ │ └── webhooks.py
|
||||
│ ├── requirements.txt
|
||||
│ └── .env.example
|
||||
├── frontend/
|
||||
│ ├── src/
|
||||
│ │ ├── App.tsx
|
||||
│ │ ├── main.tsx
|
||||
│ │ ├── api/
|
||||
│ │ │ ├── client.ts
|
||||
│ │ │ └── websocket.ts
|
||||
│ │ ├── components/
|
||||
│ │ │ ├── RepositoryForm.tsx
|
||||
│ │ │ ├── RepositoryList.tsx
|
||||
│ │ │ ├── ReviewProgress.tsx
|
||||
│ │ │ ├── ReviewList.tsx
|
||||
│ │ │ ├── CommentsList.tsx
|
||||
│ │ │ └── WebSocketStatus.tsx
|
||||
│ │ ├── pages/
|
||||
│ │ │ ├── Dashboard.tsx
|
||||
│ │ │ ├── Repositories.tsx
|
||||
│ │ │ ├── Reviews.tsx
|
||||
│ │ │ └── ReviewDetail.tsx
|
||||
│ │ └── types/
|
||||
│ │ └── index.ts
|
||||
│ ├── package.json
|
||||
│ ├── vite.config.ts
|
||||
│ ├── tsconfig.json
|
||||
│ └── index.html
|
||||
├── cloud.md # Этот файл
|
||||
└── README.md
|
||||
```
|
||||
|
||||
## Технологический стек
|
||||
|
||||
### Backend
|
||||
- **FastAPI** - веб-фреймворк
|
||||
- **LangChain/LangGraph** - фреймворк для AI агента
|
||||
- **Ollama** - локальная LLM (модель codellama)
|
||||
- **SQLAlchemy** - ORM
|
||||
- **SQLite** - база данных
|
||||
- **WebSockets** - real-time обновления
|
||||
- **httpx** - HTTP клиент для API запросов
|
||||
|
||||
### Frontend
|
||||
- **React 18** - UI библиотека
|
||||
- **TypeScript** - типизация
|
||||
- **Vite** - сборщик
|
||||
- **TanStack Query** - управление состоянием сервера
|
||||
- **WebSocket API** - real-time обновления
|
||||
- **Tailwind CSS** - стилизация
|
||||
|
||||
## Детальный план реализации
|
||||
|
||||
### 1. Backend: Модели данных (SQLAlchemy)
|
||||
|
||||
**Repository**
|
||||
```python
|
||||
- id: int (PK)
|
||||
- name: str
|
||||
- platform: enum (gitea, github, bitbucket)
|
||||
- url: str
|
||||
- api_token: str (encrypted)
|
||||
- webhook_secret: str
|
||||
- config: JSON (настройки ревью)
|
||||
- is_active: bool
|
||||
- created_at: datetime
|
||||
```
|
||||
|
||||
**PullRequest**
|
||||
```python
|
||||
- id: int (PK)
|
||||
- repository_id: int (FK)
|
||||
- pr_number: int
|
||||
- title: str
|
||||
- author: str
|
||||
- source_branch: str
|
||||
- target_branch: str
|
||||
- status: enum (open, reviewing, reviewed, closed)
|
||||
- url: str
|
||||
- created_at: datetime
|
||||
- updated_at: datetime
|
||||
```
|
||||
|
||||
**Review**
|
||||
```python
|
||||
- id: int (PK)
|
||||
- pull_request_id: int (FK)
|
||||
- status: enum (pending, analyzing, commenting, completed, failed)
|
||||
- started_at: datetime
|
||||
- completed_at: datetime
|
||||
- files_analyzed: int
|
||||
- comments_generated: int
|
||||
- error_message: str (nullable)
|
||||
```
|
||||
|
||||
**Comment**
|
||||
```python
|
||||
- id: int (PK)
|
||||
- review_id: int (FK)
|
||||
- file_path: str
|
||||
- line_number: int
|
||||
- content: str
|
||||
- severity: enum (info, warning, error)
|
||||
- posted: bool
|
||||
- posted_at: datetime (nullable)
|
||||
```
|
||||
|
||||
### 2. LangGraph агент-ревьювер
|
||||
|
||||
**Граф состояний:**
|
||||
```
|
||||
START → fetch_pr_info → fetch_changed_files → analyze_files → generate_comments → post_comments → END
|
||||
↓
|
||||
(параллельный анализ файлов)
|
||||
```
|
||||
|
||||
**Узлы графа:**
|
||||
1. **fetch_pr_info** - получение информации о PR
|
||||
2. **fetch_changed_files** - получение списка измененных файлов
|
||||
3. **analyze_files** - анализ каждого файла через Ollama
|
||||
4. **generate_comments** - генерация комментариев
|
||||
5. **post_comments** - отправка комментариев в PR
|
||||
|
||||
**Промпты для Ollama:**
|
||||
```
|
||||
Системный промпт: "Ты опытный code reviewer. Анализируй код на:
|
||||
- Потенциальные баги
|
||||
- Проблемы безопасности
|
||||
- Нарушения best practices
|
||||
- Проблемы производительности
|
||||
- Читаемость кода"
|
||||
```
|
||||
|
||||
### 3. API интеграции (приоритет - Gitea)
|
||||
|
||||
**Gitea API endpoints:**
|
||||
- `GET /repos/{owner}/{repo}/pulls/{index}` - информация о PR
|
||||
- `GET /repos/{owner}/{repo}/pulls/{index}/files` - измененные файлы
|
||||
- `GET /repos/{owner}/{repo}/pulls/{index}/commits` - коммиты
|
||||
- `POST /repos/{owner}/{repo}/pulls/{index}/reviews` - создание ревью
|
||||
- `POST /repos/{owner}/{repo}/pulls/comments` - добавление комментария
|
||||
|
||||
**GitHub API** - аналогичные endpoints через REST API v3
|
||||
**Bitbucket API** - через REST API 2.0
|
||||
|
||||
### 4. Webhook обработчики
|
||||
|
||||
**Gitea webhook payload:**
|
||||
```json
|
||||
{
|
||||
"action": "opened" | "synchronized",
|
||||
"pull_request": {
|
||||
"id": 123,
|
||||
"number": 42,
|
||||
"title": "Fix bug",
|
||||
...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Обработка:**
|
||||
1. Валидация webhook secret
|
||||
2. Проверка, что репозиторий отслеживается
|
||||
3. Запуск LangGraph агента асинхронно
|
||||
4. Отправка WebSocket уведомлений
|
||||
|
||||
### 5. REST API endpoints
|
||||
|
||||
**Repositories:**
|
||||
- `GET /api/repositories` - список репозиториев
|
||||
- `POST /api/repositories` - добавить репозиторий
|
||||
- `PUT /api/repositories/{id}` - обновить репозиторий
|
||||
- `DELETE /api/repositories/{id}` - удалить репозиторий
|
||||
- `GET /api/repositories/{id}/webhook-url` - получить webhook URL
|
||||
|
||||
**Reviews:**
|
||||
- `GET /api/reviews` - список ревью (с фильтрами)
|
||||
- `GET /api/reviews/{id}` - детали ревью
|
||||
- `GET /api/reviews/{id}/comments` - комментарии ревью
|
||||
- `POST /api/reviews/{id}/retry` - повторить ревью
|
||||
|
||||
**Stats:**
|
||||
- `GET /api/stats/dashboard` - статистика для дашборда
|
||||
|
||||
### 6. WebSocket
|
||||
|
||||
**Endpoint:** `ws://localhost:8000/ws/reviews`
|
||||
|
||||
**События:**
|
||||
```json
|
||||
{
|
||||
"type": "review_started",
|
||||
"review_id": 123,
|
||||
"pr_id": 42
|
||||
}
|
||||
|
||||
{
|
||||
"type": "review_progress",
|
||||
"review_id": 123,
|
||||
"status": "analyzing",
|
||||
"files_processed": 3,
|
||||
"total_files": 10
|
||||
}
|
||||
|
||||
{
|
||||
"type": "review_completed",
|
||||
"review_id": 123,
|
||||
"comments_count": 5
|
||||
}
|
||||
```
|
||||
|
||||
### 7. Frontend: Страницы
|
||||
|
||||
**Dashboard** (`/`)
|
||||
- Статистика: всего ревью, активных PR, комментариев
|
||||
- График активности
|
||||
- Последние ревью
|
||||
|
||||
**Repositories** (`/repositories`)
|
||||
- Таблица репозиториев
|
||||
- Кнопка "Add Repository"
|
||||
- Webhook URL для каждого
|
||||
- Статус (active/inactive)
|
||||
|
||||
**Reviews** (`/reviews`)
|
||||
- Таблица всех ревью
|
||||
- Фильтры: по репозиторию, статусу, дате
|
||||
- Ссылки на детали
|
||||
|
||||
**Review Detail** (`/reviews/:id`)
|
||||
- Информация о PR
|
||||
- Прогресс бар
|
||||
- Список сгенерированных комментариев
|
||||
- Real-time обновления
|
||||
|
||||
### 8. Конфигурация
|
||||
|
||||
**Backend (.env):**
|
||||
```env
|
||||
# Ollama
|
||||
OLLAMA_BASE_URL=http://localhost:11434
|
||||
OLLAMA_MODEL=codellama
|
||||
|
||||
# Database
|
||||
DATABASE_URL=sqlite:///./review.db
|
||||
|
||||
# Security
|
||||
SECRET_KEY=your-secret-key-here
|
||||
WEBHOOK_SECRET=your-webhook-secret
|
||||
|
||||
# Server
|
||||
HOST=0.0.0.0
|
||||
PORT=8000
|
||||
```
|
||||
|
||||
**Frontend (.env):**
|
||||
```env
|
||||
VITE_API_URL=http://localhost:8000
|
||||
VITE_WS_URL=ws://localhost:8000
|
||||
```
|
||||
|
||||
### 9. Развертывание
|
||||
|
||||
**Требования:**
|
||||
- Python 3.11+
|
||||
- Node.js 18+
|
||||
- Ollama установлен и запущен
|
||||
|
||||
**Запуск Backend:**
|
||||
```bash
|
||||
cd backend
|
||||
pip install -r requirements.txt
|
||||
uvicorn app.main:app --reload
|
||||
```
|
||||
|
||||
**Запуск Frontend:**
|
||||
```bash
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
**Настройка Ollama:**
|
||||
```bash
|
||||
ollama pull codellama
|
||||
ollama serve
|
||||
```
|
||||
|
||||
### 10. Безопасность
|
||||
|
||||
- API токены храним зашифрованными (Fernet)
|
||||
- Webhook secret для валидации запросов
|
||||
- CORS настроен только для frontend домена
|
||||
- Rate limiting на webhook endpoints
|
||||
- Валидация всех входных данных
|
||||
|
||||
## Этапы разработки
|
||||
|
||||
1. ✅ Создание структуры проекта
|
||||
2. ⏳ Backend: Модели и база данных
|
||||
3. ⏳ Backend: LangGraph агент
|
||||
4. ⏳ Backend: Интеграции с Git платформами
|
||||
5. ⏳ Backend: Webhook обработчики
|
||||
6. ⏳ Backend: REST API
|
||||
7. ⏳ Backend: WebSocket
|
||||
8. ⏳ Frontend: Базовая структура
|
||||
9. ⏳ Frontend: Компоненты и страницы
|
||||
10. ⏳ Frontend: Интеграция с Backend
|
||||
11. ⏳ Тестирование
|
||||
12. ⏳ Документация
|
||||
|
||||
## Примечания
|
||||
|
||||
- Gitea имеет приоритет в разработке
|
||||
- Агент работает в одном экземпляре (можно масштабировать через очереди позже)
|
||||
- Real-time обновления через WebSocket для UX
|
||||
- Модульная архитектура для легкого добавления новых платформ
|
||||
|
||||
Reference in New Issue
Block a user