erv-clientright/README.md

Проект ЕРВ - Форма обращений за выплатой страховки

Описание проекта

Веб-приложение для обработки обращений за выплатой страхового возмещения по полисам ЕРВ (Евроинс). Проект представляет собой многошаговую форму с интеграцией в CRM-систему ClientRight.

Технологический стек

• Backend: PHP 7.4+
• Frontend: HTML5, CSS3, JavaScript (jQuery)
• База данных: MySQL
• Интеграции:
  • CRM ClientRight (веб-сервисы)
  • DaData API (автодополнение адресов и организаций)
  • SMS-сервис для подтверждения телефона
  • IP-геолокация (ip-api.com)

Структура проекта

erv.clientright.ru/
├── ticket/              # Основная рабочая версия формы
│   ├── index.php        # Главная страница формы
│   ├── database.php     # Проверка полисов в БД
│   ├── sms-test.php     # Тестирование SMS
│   ├── css/             # Стили
│   ├── js/              # JavaScript файлы
│   └── libs/            # Внешние библиотеки
├── ticket3/             # Альтернативная версия
├── ervws/               # Версия для веб-сервисов
├── test/                # Тестовая версия
├── public_html/         # Публичная версия
├── vendor/              # PHP зависимости (Composer)
├── libs/                # Общие библиотеки
└── Документация API.txt # Документация по API CRM

Основные функции

1. Многошаговая форма (3 шага):

   • Шаг 1: Подтверждение телефона через SMS
   • Шаг 2: Информация о страховом случае
   • Шаг 3: Персональные данные и документы

2. Проверка полиса:

   • Валидация номера полиса в базе данных
   • Проверка тарифов и сроков действия

3. Загрузка файлов:

   • Поддержка форматов: PDF, JPG, PNG, GIF, JPEG, HEIC
   • Конвертация HEIC в JPEG
   • Максимальный размер файла: 5 МБ
   • Максимум 10 файлов на поле

4. Интеграция с CRM:

   • Создание/обновление клиента (CreateContact)
   • Создание/обновление контрагента (CreateAccount)
   • Создание проекта (CreateProject)
   • Загрузка файлов в CRM

Конфигурация

База данных

• Хост: localhost
• База: ci20465_erv
• Таблица для проверки полисов: lexrpiority

CRM API

• Endpoint: https://crm.clientright.ru/webservice.php
• Username: api
• Access Key: 4r9ANex8PT2IuRV

Внешние сервисы

• DaData API Token: f5d6928d7490cd44124ccae11a08c7fa5625d48c
• Форма обработки: https://form.clientright.ru/server_new.php
• Загрузка файлов: https://form.clientright.ru/fileupload_v2.php

Установка и запуск

1. Убедитесь, что установлены:

   • PHP 7.4 или выше
   • MySQL
   • Composer (для зависимостей)

2. Установите зависимости:

composer install

3. Настройте подключение к базе данных в database.php

4. Настройте права доступа для загрузки файлов

Рабочие версии

• Основная рабочая версия: /ticket/
• Тестовая версия: /test/
• Публичная версия: /public_html/

API CRM - Основные операции

1. Авторизация

operation = getchallenge
operation = login

2. Работа с клиентами

operation = CreateContact

3. Работа с контрагентами

operation = CreateAccount

4. Работа с проектами

operation = CreateProject

5. Получение списка файлов

operation = GetFilesList

Подробная документация в файле Документация API.txt

Особенности реализации

• Валидация форм: Проверка обязательных полей на каждом шаге
• Маски ввода: Телефон, ИНН, даты, банковские реквизиты
• Адаптивность: Поддержка мобильных устройств
• Логирование: Логи операций в logs/logfile.log
• Обработка ошибок: Try-catch блоки и валидация ответов

Безопасность

• Проверка типов файлов при загрузке
• Валидация размеров файлов
• Защита от XSS через экранирование данных
• Использование сессий для изоляции данных пользователей

Разработка

Для разработки используйте версию в директории /ticket/ или /test/.

Тестовый режим

Добавьте параметр ?demodata=1 к URL для автоматического заполнения формы тестовыми данными.

Контакты

• Разработчик: TG: @wwdev

Лицензия

Проект разработан для ЕРВ (Евроинс).