0f82eef08d
✅ Инфраструктура: PostgreSQL, Redis, RabbitMQ, S3 ✅ Backend: SMS сервис + API endpoints ✅ Frontend: React форма (3 шага) + SMS верификация
185 lines
4.4 KiB
Markdown
185 lines
4.4 KiB
Markdown
# 🚀 Быстрый запуск 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
|
||
```
|
||
|
||
---
|
||
|
||
## ❓ Вопросы?
|
||
|
||
Если что-то не работает - смотри логи или пиши мне!
|
||
|
||
**Удачи!** 🚀
|
||
|
||
|