81963d18c37ac65dca6d77c7516a8f63ecc7d5b4
Problem: - Multiple records created with same claim_id but different IDs - Example: ID=0eb051ec... (correct) vs ID=b532b1b3... (duplicate) - Different SQL queries used different approaches: * Some used claim_id as UUID for ID (partial.claim_id_str::uuid) * Others searched by payload->>'claim_id' and created new UUID if not found Root Cause: - SQL_CLAIMSAVE_UPSERT_SIMPLE.sql only searched by ID: WHERE id = claim_id_str::uuid - If record existed with different ID but same claim_id in payload, it wasn't found and new record was created Solution: 1. existing_claim now searches both by ID and payload->>'claim_id': WHERE id = claim_id_str::uuid OR payload->>'claim_id' = claim_id_str ORDER BY priority (ID match first), then updated_at DESC 2. INSERT uses ID from existing_claim if found: COALESCE((SELECT id FROM existing_claim), partial.claim_id_str::uuid) 3. This ensures same record is always used, preventing duplicates Files: - docs/SQL_CLAIMSAVE_UPSERT_SIMPLE.sql: Fixed search logic and INSERT ID
🚀 Ticket Form Intake Platform
Платформа цифровой приёмки обращений для other.clientright.ru
- Backend: Python FastAPI (async)
- Frontend: React 18 + TypeScript
- Database: PostgreSQL + MySQL + Redis
- Queue: RabbitMQ
- Storage: S3 Timeweb Cloud
🎯 Быстрый старт
📍 Визуальный доступ:
После запуска доступны по адресам:
Frontend (форма):
http://147.45.146.17:5175/
Backend API:
http://147.45.146.17:8200/
API Документация (Swagger UI):
http://147.45.146.17:8200/docs ← Интерактивная!
Gitea (Git репозиторий):
http://147.45.146.17:3002/
🔧 Установка и запуск
Backend (FastAPI):
cd backend
# Создаём виртуальное окружение
python3 -m venv venv
source venv/bin/activate
# Устанавливаем зависимости
pip install -r requirements.txt
# Запускаем сервер
uvicorn app.main:app --reload --host 0.0.0.0 --port 8200
Frontend (React):
cd frontend
# Устанавливаем зависимости
npm install
# Запускаем dev сервер
npm run dev -- --host 0.0.0.0 --port 5175
📊 Архитектура
Поток данных:
React (5175) → FastAPI (8200) → [Redis, RabbitMQ, PostgreSQL]
↓
OCR Service (8001)
OpenRouter AI
FlightAware API
↓
PHP Bridge → Vtiger CRM
Что НЕ трогаем:
✅ CRM Vtiger (работает как работала)
✅ MySQL полисы (только READ)
✅ Существующий PHP код
🗄️ Базы данных
| База | Назначение | Хост |
|---|---|---|
| PostgreSQL | Логи, метрики, новые данные | 147.45.189.234:5432 |
| MySQL | Проверка полисов (READ) | localhost:3306 |
| Redis | Кеш, Rate Limiting | localhost:6379 |
📁 Структура проекта
ticket_form/
├─ backend/ ← Python FastAPI
│ ├─ app/
│ │ ├─ main.py
│ │ ├─ api/
│ │ ├─ services/
│ │ └─ models/
│ └─ requirements.txt
│
├─ frontend/ ← React TypeScript
│ ├─ src/
│ │ ├─ components/
│ │ ├─ pages/
│ │ └─ api/
│ └─ package.json
│
└─ .env ← Конфигурация
🔌 API Endpoints
Документы:
POST /api/v1/documents/upload- Загрузка в S3POST /api/v1/documents/scan- OCR + Vision
Рейсы:
GET /api/v1/flights/check- Проверка статуса
Обращения:
POST /api/v1/claims/submit- Создание обращения
Полисы:
GET /api/v1/policies/verify- Проверка полиса
🐛 Отладка
Логи:
# FastAPI
tail -f backend/logs/app.log
# PostgreSQL логи
SELECT * FROM logs ORDER BY created_at DESC LIMIT 50;
📝 Git
# Репозиторий
http://147.45.146.17:3002/negodiy/erv-platform
# Клонирование
git clone http://147.45.146.17:3002/negodiy/erv-platform.git
# Push изменений
git add .
git commit -m "Your message"
git push origin main
Автор: AI Assistant + Фёдор
Дата: 24.10.2025
Description
Languages
TypeScript
57.4%
Python
37%
Shell
1.9%
CSS
1.6%
PLpgSQL
1%
Other
0.9%