🚀 MVP: FastAPI + React форма с SMS верификацией

✅ Инфраструктура: PostgreSQL, Redis, RabbitMQ, S3
✅ Backend: SMS сервис + API endpoints
✅ Frontend: React форма (3 шага) + SMS верификация

START_HERE.md

@@ -0,0 +1,173 @@
+# ⚡ ЗАПУСК 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
+```
+
+---
+
+**ЗАПУСКАЙ И ПИШИ ЧТО ПОЛУЧИЛОСЬ!** 🚀
+
+