aiform_dev/QUICK_START.md

# 🚀 Быстрый запуск ERV Platform (MVP)

## ✅ Что уже готово:

- ✅ Структура проекта создана
- ✅ FastAPI backend (базовый)
- ✅ React frontend (базовый)
- ✅ Git репозиторий настроен
- ✅ .env конфигурация

---

## 📍 Адреса после запуска:

```
Frontend (React):     http://147.45.146.17:5173/
Backend API:          http://147.45.146.17:8100/
API Docs (Swagger):   http://147.45.146.17:8100/docs
Health Check:         http://147.45.146.17:8100/health
Gitea:                http://147.45.146.17:3002/
```

---

## 🔧 Запуск Backend (FastAPI)

```bash
# Терминал 1: Backend

cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform/backend

# Активировать виртуальное окружение
source venv/bin/activate

# Если зависимости ещё не установлены:
pip install -r requirements.txt

# Запустить FastAPI сервер
uvicorn app.main:app --reload --host 0.0.0.0 --port 8100

# Увидишь:
# INFO: Uvicorn running on http://0.0.0.0:8100
# 🚀 ERV Insurance Platform запускается...
```

---

## 🎨 Запуск Frontend (React)

```bash
# Терминал 2: Frontend (НОВЫЙ терминал!)

cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform/frontend

# Установить зависимости (первый раз):
npm install

# Запустить React dev server
npm run dev

# Увидишь:
# VITE v5.x.x ready in XXX ms
# ➜ Local:   http://localhost:5173/
# ➜ Network: http://147.45.146.17:5173/
```

---

## 🧪 Проверка работоспособности

### 1. **Проверь Backend:**

```bash
curl http://localhost:8100/

# Ожидается:
# {"message":"🚀 ERV Insurance Platform API","version":"1.0.0","status":"running"}
```

### 2. **Проверь Health:**

```bash
curl http://localhost:8100/health

# Увидишь статус всех сервисов:
# {"status":"healthy","services":{"api":"ok","redis":"ok","postgres":"ok"}}
```

### 3. **Открой в браузере:**

```
http://147.45.146.17:5173/

Увидишь:
- Информацию о платформе
- Статус сервисов (Redis, PostgreSQL, OCR)
- Список возможностей
- Технологический стек
```

---

## 🐛 Если что-то не работает:

### **Backend не запускается:**

```bash
# Проверь логи
tail -f ../logs/backend.log

# Проверь занят ли порт
netstat -tuln | grep 8100

# Если занят - измени порт в команде запуска
```

### **Frontend не запускается:**

```bash
# Проверь Node.js версию (нужна >= 18)
node --version

# Если старая - обнови:
# curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# sudo apt-get install -y nodejs
```

### **API не отвечает:**

```bash
# Проверь что FastAPI запущен
ps aux | grep uvicorn

# Проверь firewall
sudo ufw status
```

---

## 📊 Что показывает MVP:

1. ✅ **Работающий FastAPI** с автодокументацией
2. ✅ **Работающий React** интерфейс
3. ✅ **Подключение к сервисам** (Redis, PostgreSQL, OCR)
4. ✅ **Health Check** всех компонентов
5. ✅ **API endpoints** (базовые)

---

## 🚀 Следующие шаги (после запуска MVP):

После того как убедишься что всё работает:

1. ✅ Создам полные API endpoints (документы, рейсы, обращения)
2. ✅ Создам React компоненты (форма, загрузка файлов, OCR)
3. ✅ Подключу WebSocket для real-time
4. ✅ Интегрирую все сервисы (S3, RabbitMQ, и т.д.)
5. ✅ Создам Docker окружение

---

## 📝 Git репозиторий

```bash
# Репозиторий создан
http://147.45.146.17:3002/negodiy/erv-platform

# Логин: negodiy
# Пароль: yft,fkjdj90

# Настройка remote:
git remote add origin http://negodiy:yft,fkjdj90@147.45.146.17:3002/negodiy/erv-platform.git
git push -u origin main
```

---

## ❓ Вопросы?

Если что-то не работает - смотри логи или пиши мне!

**Удачи!** 🚀