0f82eef08d
✅ Инфраструктура: PostgreSQL, Redis, RabbitMQ, S3 ✅ Backend: SMS сервис + API endpoints ✅ Frontend: React форма (3 шага) + SMS верификация
174 lines
4.4 KiB
Markdown
174 lines
4.4 KiB
Markdown
# ⚡ ЗАПУСК 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
|
||
```
|
||
|
||
---
|
||
|
||
**ЗАПУСКАЙ И ПИШИ ЧТО ПОЛУЧИЛОСЬ!** 🚀
|
||
|
||
|