feat: Add review events persistence, version display, and auto-versioning system
This commit is contained in:
Primakov Alexandr Alexandrovich
@@ -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'
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user