Initial commit: ERV Platform MVP - FastAPI + React

QUICK_START.md

@@ -0,0 +1,183 @@
+# 🚀 Быстрый запуск 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
+```
+
+---
+
+## ❓ Вопросы?
+
+Если что-то не работает - смотри логи или пиши мне!
+
+**Удачи!** 🚀
+