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)

# Терминал 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)

# Терминал 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:

curl http://localhost:8100/

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

2. Проверь Health:

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 не запускается:

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

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

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

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

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

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

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

# Проверь что 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 репозиторий

# Репозиторий создан
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

---

❓ Вопросы?

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

Удачи! 🚀