docs: Обновлен SESSION_LOG с работой 25 октября
Добавлена документация: - 9 новых коммитов - Split-screen UI + Debug панель - OCR + AI анализ (Gemini Vision) - S3 Upload + Draft автосохранение - Step2 переделан под erv_ticket - MySQL валидация полисов - Безопасность и UX улучшения Статистика: - ~1500 строк кода - 20 файлов изменено - 12 проблем решено - 3 часа работы
This commit is contained in:
220
QUICK_START.md
220
QUICK_START.md
@@ -1,184 +1,74 @@
|
||||
# 🚀 Быстрый запуск ERV Platform (MVP)
|
||||
# ⚡ Quick Start - ERV Platform
|
||||
|
||||
## ✅ Что уже готово:
|
||||
|
||||
- ✅ Структура проекта создана
|
||||
- ✅ 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
|
||||
# В SSH терминале выполни:
|
||||
cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform
|
||||
|
||||
cd /var/www/fastuser/data/www/crm.clientright.ru/erv_platform/backend
|
||||
# 1. Git Push (сохранить работу)
|
||||
bash git_push_all.sh
|
||||
|
||||
# Активировать виртуальное окружение
|
||||
source venv/bin/activate
|
||||
# 2. Перезапуск Backend
|
||||
bash /var/www/fastuser/data/www/crm.clientright.ru/restart_backend.sh
|
||||
|
||||
# Если зависимости ещё не установлены:
|
||||
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
|
||||
# 3. Проверка
|
||||
curl http://localhost:8100/health
|
||||
|
||||
# Увидишь статус всех сервисов:
|
||||
# {"status":"healthy","services":{"api":"ok","redis":"ok","postgres":"ok"}}
|
||||
```
|
||||
|
||||
### 3. **Открой в браузере:**
|
||||
|
||||
```
|
||||
http://147.45.146.17:5173/
|
||||
|
||||
Увидишь:
|
||||
- Информацию о платформе
|
||||
- Статус сервисов (Redis, PostgreSQL, OCR)
|
||||
- Список возможностей
|
||||
- Технологический стек
|
||||
docker ps | grep frontend
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Если что-то не работает:
|
||||
## 📊 Статус платформы
|
||||
|
||||
### **Backend не запускается:**
|
||||
### Что работает:
|
||||
- ✅ Frontend (React): http://147.45.146.17:5173
|
||||
- ✅ Backend (FastAPI): http://147.45.146.17:8100
|
||||
- ✅ PostgreSQL: 147.45.189.234:5432
|
||||
- ✅ Redis: crm.clientright.ru:6379
|
||||
- ✅ RabbitMQ: 185.197.75.249:5672
|
||||
- ✅ MySQL: localhost/ci20465_erv (33,963 полисов)
|
||||
- ✅ S3: https://s3.twcstorage.ru
|
||||
|
||||
### Что нужно сделать:
|
||||
- ⚠️ Перезапустить backend (процесс умер)
|
||||
- ⚠️ Git push (SESSION_LOG обновлен)
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Полезные ссылки
|
||||
|
||||
- **Frontend:** http://147.45.146.17:5173
|
||||
- **Swagger API:** http://147.45.146.17:8100/docs
|
||||
- **Gitea:** http://147.45.146.17:3002/negodiy/erv-platform
|
||||
- **Логи:** /var/www/fastuser/data/www/crm.clientright.ru/erv_platform_backend.log
|
||||
|
||||
---
|
||||
|
||||
## 📋 Основные фичи
|
||||
|
||||
1. **Проверка полиса** - MySQL БД (33,963 полисов)
|
||||
2. **Загрузка файлов** - S3 Timeweb (10 файлов x 15MB)
|
||||
3. **OCR + AI** - Gemini Vision (полис или шляпа)
|
||||
4. **Debug панель** - Real-time события справа
|
||||
5. **Draft** - автосохранение в PostgreSQL
|
||||
6. **7 типов страховых случаев** - из erv_ticket
|
||||
7. **Безопасность** - защита от инъекций
|
||||
|
||||
---
|
||||
|
||||
## 🐛 Debug режим
|
||||
|
||||
**Смотреть логи в реальном времени:**
|
||||
```bash
|
||||
# Проверь логи
|
||||
tail -f ../logs/backend.log
|
||||
|
||||
# Проверь занят ли порт
|
||||
netstat -tuln | grep 8100
|
||||
|
||||
# Если занят - измени порт в команде запуска
|
||||
tail -f /var/www/fastuser/data/www/crm.clientright.ru/erv_platform_backend.log
|
||||
```
|
||||
|
||||
### **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
|
||||
```
|
||||
**Проверить OCR:**
|
||||
1. Загрузи файл через форму
|
||||
2. Смотри логи - увидишь OCR процесс
|
||||
3. Debug панель справа покажет результаты
|
||||
|
||||
---
|
||||
|
||||
## 📊 Что показывает 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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ❓ Вопросы?
|
||||
|
||||
Если что-то не работает - смотри логи или пиши мне!
|
||||
|
||||
**Удачи!** 🚀
|
||||
|
||||
|
||||
**Последнее обновление:** 25 октября 2025, 09:45
|
||||
|
||||
Reference in New Issue
Block a user