188 lines
6.8 KiB
Markdown
188 lines
6.8 KiB
Markdown
# Документация проекта ERV (Единая Реестровая Выплата)
|
||
|
||
## Обзор проекта
|
||
|
||
**ERV** - веб-система для подачи обращений за страховыми выплатами по туристическим полисам ЕРВ (Единая Реестровая Выплата).
|
||
|
||
### Основная информация
|
||
- **Домен**: erv.clientright.ru
|
||
- **Путь**: /var/www/fastuser/data/www/erv.clientright.ru/
|
||
- **Статус**: Продакшен
|
||
- **Версия PHP**: 7.4+
|
||
- **База данных**: MySQL (ci20465_erv)
|
||
|
||
## Архитектура
|
||
|
||
### Структура файлов
|
||
```
|
||
erv.clientright.ru/
|
||
├── index.php # Основная форма (старая версия)
|
||
├── ervws/index.php # Активная рабочая версия ⭐
|
||
├── database.php # Подключение к БД и проверка полисов
|
||
├── file-server.php # Загрузка файлов
|
||
├── sms-test.php # SMS уведомления
|
||
├── css/ # Стили
|
||
├── js/ # JavaScript функционал
|
||
├── libs/ # Библиотеки
|
||
├── uploads/ # Загруженные файлы
|
||
└── vendor/ # Внешние зависимости
|
||
```
|
||
|
||
### Основные компоненты
|
||
|
||
1. **Frontend**
|
||
- HTML/PHP формы с многоэтапной валидацией
|
||
- JavaScript для интерактивности
|
||
- CSS для стилизации
|
||
- Адаптивный дизайн
|
||
|
||
2. **Backend**
|
||
- PHP скрипты для обработки данных
|
||
- MySQL база данных
|
||
- Интеграции с внешними API
|
||
|
||
3. **Интеграции**
|
||
- SigmaSMS (SMS уведомления)
|
||
- DaData API (автодополнение)
|
||
- CRM ClientRight
|
||
- IP-API (геолокация)
|
||
|
||
## Функциональность
|
||
|
||
### Многоэтапная форма подачи обращения
|
||
|
||
1. **SMS-верификация**
|
||
- Ввод номера телефона
|
||
- Отправка SMS кода
|
||
- Подтверждение кода
|
||
|
||
2. **Проверка полиса**
|
||
- Ввод номера полиса
|
||
- Проверка в базе данных
|
||
- Автозаполнение данных
|
||
|
||
3. **Личные данные**
|
||
- ФИО, дата рождения
|
||
- Банковские реквизиты
|
||
- Документы удостоверяющие личность
|
||
|
||
4. **Информация о средстве размещения**
|
||
- Название и адрес
|
||
- Контактные данные
|
||
- Документы бронирования
|
||
|
||
5. **Страховой случай**
|
||
- Дата наступления
|
||
- Тип случая (6 вариантов)
|
||
- Подтверждающие документы
|
||
|
||
6. **Финальные данные**
|
||
- Адрес регистрации
|
||
- ИНН, документы
|
||
- Согласие на обработку данных
|
||
|
||
### Типы страховых случаев
|
||
|
||
- Отсутствие индивидуальной сауны в номере
|
||
- Отказ в заселении в номер/бунгало/каюту
|
||
- Отсутствие вида, заявленного в бронировании
|
||
- Отсутствие туалета/душа/ванны
|
||
- Отсутствие кондиционера
|
||
- Отсутствие кухонного оборудования
|
||
|
||
## База данных
|
||
|
||
### Подключение
|
||
- **Хост**: localhost
|
||
- **База**: ci20465_erv
|
||
- **Пользователь**: ci20465_erv
|
||
- **Пароль**: c7vOXbmG
|
||
|
||
### Таблица lexrpiority
|
||
```sql
|
||
- voucher (номер полиса)
|
||
- insured_from (дата начала действия)
|
||
- insured_to (дата окончания действия)
|
||
```
|
||
|
||
## Внешние сервисы
|
||
|
||
### SMS (SigmaSMS)
|
||
- **API**: https://online.sigmasms.ru/api/
|
||
- **Логин**: kfv.advokat@gmail.com
|
||
- **Токен**: bbdbe4516d8935e1169a1b7a7c0914dcabcad53dd6bee56bcc77974d4334b650
|
||
|
||
### DaData API
|
||
- **URL**: https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party
|
||
- **Токен**: f5d6928d7490cd44124ccae11a08c7fa5625d48c
|
||
|
||
### CRM ClientRight
|
||
- **URL**: https://form.clientright.ru/server_webservice2.php
|
||
- **Назначение**: Отправка обработанных данных
|
||
|
||
## Безопасность
|
||
|
||
### Защита файлов
|
||
- Разрешенные форматы: PDF, JPG, PNG, GIF, JPEG
|
||
- Максимальный размер: 5 МБ
|
||
- Запрещенные расширения: PHP, JS, HTML, CSS, SQL, EXE
|
||
- Автоматическое преобразование в PDF
|
||
|
||
### Валидация данных
|
||
- Проверка всех входных полей
|
||
- Валидация email адресов
|
||
- Проверка форматов телефонов
|
||
- SMS-верификация пользователей
|
||
|
||
## Мониторинг и логирование
|
||
|
||
### Критические папки
|
||
- `/cache` - КРИТИЧЕСКИ ВАЖНА для работы крона
|
||
- `/uploads` - Загруженные пользователями файлы
|
||
- `/logs` - Логи системы (если есть)
|
||
|
||
### Важные файлы
|
||
- `database.php` - Подключение к БД
|
||
- `sms-test.php` - SMS функционал
|
||
- `file-server.php` - Загрузка файлов
|
||
|
||
## Развертывание
|
||
|
||
### Требования
|
||
- PHP 7.4+
|
||
- MySQL 5.7+
|
||
- Apache/Nginx
|
||
- SSL сертификат
|
||
- Доступ к внешним API
|
||
|
||
### Настройка
|
||
1. Настроить подключение к БД
|
||
2. Настроить SMS API
|
||
3. Настроить DaData API
|
||
4. Настроить права доступа к папкам
|
||
5. Настроить SSL
|
||
|
||
## Обслуживание
|
||
|
||
### Регулярные задачи
|
||
- Мониторинг размера папки uploads
|
||
- Проверка работоспособности API
|
||
- Резервное копирование БД
|
||
- Очистка временных файлов
|
||
|
||
### Безопасность
|
||
- Регулярное обновление зависимостей
|
||
- Мониторинг логов на подозрительную активность
|
||
- Проверка целостности файлов
|
||
- Резервное копирование критических данных
|
||
|
||
## Контакты и поддержка
|
||
|
||
- **Разработчик**: Фёдор
|
||
- **Система**: Ubuntu 22.04
|
||
- **Статус**: Продакшен
|
||
|
||
---
|
||
|
||
**ВНИМАНИЕ**: Проект находится в продакшене. Все изменения должны быть согласованы и протестированы!
|