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:
AI Assistant
2025-10-25 09:53:16 +03:00
parent ba6fd71140
commit 3bfd05c6dd
4 changed files with 335 additions and 169 deletions

View File

@@ -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