aiform_dev/START_HERE.md

# ⚡ ЗАПУСК MVP - ИНСТРУКЦИЯ ДЛЯ ФЁДОРА

## 🎯 Что сделано:

✅ FastAPI backend (Python)  
✅ React frontend (TypeScript)  
✅ Git репозиторий (Gitea)  
✅ Конфигурация (.env)  

---

## 🚀 КАК ЗАПУСТИТЬ (2 команды):

### **Команда 1: Backend (FastAPI)**

Открой **ТЕРМИНАЛ 1** и выполни:

```bash
cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform/backend
source venv/bin/activate
uvicorn app.main:app --reload --host 0.0.0.0 --port 8100
```

Увидишь:
```
🚀 ERV Insurance Platform запускается...
📍 Backend URL: http://localhost:8100
📍 API Docs: http://localhost:8100/docs
INFO: Uvicorn running on http://0.0.0.0:8100
```

**НЕ ЗАКРЫВАЙ этот терминал!** Сервер должен работать.

---

### **Команда 2: Frontend (React)**

Открой **ТЕРМИНАЛ 2** (новый!) и выполни:

```bash
cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform/frontend
npm install
npm run dev
```

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

**НЕ ЗАКРЫВАЙ этот терминал!** Сервер должен работать.

---

## 🌐 ОТКРОЙ В БРАУЗЕРЕ:

### **1. Frontend (главная страница):**
```
http://147.45.146.17:5173/
```

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

### **2. API Документация (Swagger UI):**
```
http://147.45.146.17:8100/docs
```

**Увидишь:**
- ✅ Список всех API endpoints
- ✅ Можно тестировать прямо в браузере!
- ✅ Автоматическая документация

### **3. Health Check:**
```
http://147.45.146.17:8100/health
```

**Увидишь:**
- ✅ Статус каждого сервиса (Redis, PostgreSQL, OCR)
- ✅ OK или ERROR для каждого

---

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

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

```bash
# Проверь порт 8100 свободен
netstat -tuln | grep 8100

# Если занят - используй другой порт:
uvicorn app.main:app --reload --host 0.0.0.0 --port 8200
# Тогда меняй везде 8100 на 8200
```

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

```bash
# Проверь Node.js версию
node --version

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

### **Нет соединения между Frontend и Backend?**

Проверь в `frontend/vite.config.ts`:
```typescript
proxy: {
  '/api': {
    target: 'http://localhost:8100',  ← Должен совпадать с портом backend
  }
}
```

---

## ✅ Проверка что всё работает:

После запуска **ОБОИХ** серверов, проверь:

1. ✅ `http://147.45.146.17:8100/` → должен вернуть JSON
2. ✅ `http://147.45.146.17:8100/health` → статус сервисов
3. ✅ `http://147.45.146.17:5173/` → красивая страница с информацией

---

## 📊 Что дальше:

После того как убедишься что **МВП работает**:

1. Скажешь мне: "Работает!" или "Не работает, вот ошибка..."
2. Если работает → я продолжу создавать полную функциональность:
   - API для OCR документов
   - API для проверки рейсов
   - React компоненты формы
   - Автозаполнение
   - WebSocket real-time
   - И т.д.

---

## 🎁 Бонус - полезные команды:

```bash
# Остановить Backend
# Ctrl+C в терминале где запущен uvicorn

# Остановить Frontend  
# Ctrl+C в терминале где запущен npm run dev

# Посмотреть логи Backend
tail -f /var/www/fastuser/data/www/crm.clientright.ru/erv_platform/logs/backend.log

# Gitea репозиторий
http://147.45.146.17:3002/negodiy/erv-platform
```

---

**ЗАПУСКАЙ И ПИШИ ЧТО ПОЛУЧИЛОСЬ!** 🚀