aiform_prod/START_HERE.md

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

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

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

---

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

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

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

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 (новый!) и выполни:

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

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

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

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

# Проверь 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:

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
   • И т.д.

---

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

# Остановить 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

---

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