565 lines
21 KiB
Markdown
565 lines
21 KiB
Markdown
|
# Техническая документация: Потоки данных и процессы
|
|||
|
|
|
|||
|
|
## 🔄 Диаграмма основного потока
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ ПОЛЬЗОВАТЕЛЬ │
|
|||
|
|
│ (Браузер) │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
│ GET index.php
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ INDEX.PHP │
|
|||
|
|
│ - Определение IP через ip-api.com │
|
|||
|
|
│ - Генерация session_id для sub_dir │
|
|||
|
|
│ - Рендеринг формы (3 шага) │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
│ [SMS ВЕРИФИКАЦИЯ]
|
|||
|
|
│
|
|||
|
|
├─► POST sms-test.php
|
|||
|
|
│ • Генерация кода (6 цифр)
|
|||
|
|
│ • Отправка через SigmaSMS API
|
|||
|
|
│ • Возврат success/error
|
|||
|
|
│
|
|||
|
|
│ Пользователь вводит код
|
|||
|
|
│ Проверка на клиенте (JS)
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ ШАГ 1: Проверка полиса │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
├─► POST database.php
|
|||
|
|
│ {
|
|||
|
|
│ action: "user_verify",
|
|||
|
|
│ birthday: "DD.MM.YYYY",
|
|||
|
|
│ inn: "полис номер"
|
|||
|
|
│ }
|
|||
|
|
│ ↓
|
|||
|
|
│ SELECT * FROM ci20465_erv.lexrpiority
|
|||
|
|
│ WHERE voucher = 'полис номер'
|
|||
|
|
│ ↓
|
|||
|
|
│ Response:
|
|||
|
|
│ {
|
|||
|
|
│ success: "true|false",
|
|||
|
|
│ message: "Полис найден|не найден",
|
|||
|
|
│ result: {
|
|||
|
|
│ insured_from: "дата",
|
|||
|
|
│ insured_to: "дата"
|
|||
|
|
│ }
|
|||
|
|
│ }
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ Заполнение персональных данных │
|
|||
|
|
│ • ФИО │
|
|||
|
|
│ • Дата рождения → проверка возраста │
|
|||
|
|
│ • Если < 18: показать поля законного представителя │
|
|||
|
|
│ • Банковские реквизиты │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ ШАГ 2: Описание события │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
├─► Выбор типа события (select)
|
|||
|
|
│ • Задержка рейса
|
|||
|
|
│ • Отмена рейса → показать поле подтверждения
|
|||
|
|
│ • Стыковочный → показать доп. поля
|
|||
|
|
│ • Посадка на запасной
|
|||
|
|
│ • Поезд/паром
|
|||
|
|
│
|
|||
|
|
├─► Загрузка документов
|
|||
|
|
│ ├─► Выбор файлов (макс 10, до 5MB)
|
|||
|
|
│ │ • Валидация формата
|
|||
|
|
│ │ • Валидация размера
|
|||
|
|
│ │
|
|||
|
|
│ ├─► POST fileupload_v2.php
|
|||
|
|
│ │ FormData:
|
|||
|
|
│ │ • files: field_name-0, field_name-1, ...
|
|||
|
|
│ │ • lastname
|
|||
|
|
│ │ • files_names[]
|
|||
|
|
│ │ • docs_names[]
|
|||
|
|
│ │ • sub_dir (session_id)
|
|||
|
|
│ │ ↓
|
|||
|
|
│ │ [ImageMagick convert] → PDF
|
|||
|
|
│ │ [Ghostscript merge] → единый PDF
|
|||
|
|
│ │ ↓
|
|||
|
|
│ │ Response:
|
|||
|
|
│ │ {
|
|||
|
|
│ │ success: "true",
|
|||
|
|
│ │ empty_file: "путь/к/объединенному.pdf",
|
|||
|
|
│ │ real_file: "путь/к/оригиналу.pdf"
|
|||
|
|
│ │ }
|
|||
|
|
│ │
|
|||
|
|
│ └─► Сохранение upload_url в data-атрибут input
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ ШАГ 3: Документы и согласия │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
├─► Адрес (с автозаполнением через DaData)
|
|||
|
|
├─► Документ удостоверяющий личность
|
|||
|
|
├─► Страна события
|
|||
|
|
├─► Email
|
|||
|
|
├─► Загрузка скана паспорта
|
|||
|
|
└─► Чекбокс согласия
|
|||
|
|
│
|
|||
|
|
│ [SUBMIT FORM]
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|||
|
|
│ ФИНАЛЬНАЯ ОТПРАВКА │
|
|||
|
|
└────────────┬────────────────────────────────────────────────────┘
|
|||
|
|
│
|
|||
|
|
├─► Сбор всех данных формы
|
|||
|
|
│ FormData {
|
|||
|
|
│ upload_urls[]: массив путей к файлам
|
|||
|
|
│ upload_urls_real[]: оригинальные пути
|
|||
|
|
│ files_names[]: имена полей
|
|||
|
|
│ docs_names[]: названия документов
|
|||
|
|
│ docs_ticket_files_ids[]: индексы файлов билетов
|
|||
|
|
│ appends[]: массив JSON-объектов с полями
|
|||
|
|
│ {
|
|||
|
|
│ ws_name: "имя поля",
|
|||
|
|
│ ws_type: "client|contractor|project|other|ticket",
|
|||
|
|
│ field_val: "значение"
|
|||
|
|
│ }
|
|||
|
|
│ lastname: фамилия
|
|||
|
|
│ sub_dir: session_id
|
|||
|
|
│ }
|
|||
|
|
│
|
|||
|
|
├─► POST https://form.clientright.ru/server_webservice2.php
|
|||
|
|
│ ↓
|
|||
|
|
│ [Обработка на стороне server_webservice2.php]
|
|||
|
|
│ ├─► Создание записей в CRM
|
|||
|
|
│ ├─► Привязка файлов
|
|||
|
|
│ └─► Отправка email
|
|||
|
|
│
|
|||
|
|
├─► Показ модалки успеха (Fancybox)
|
|||
|
|
│
|
|||
|
|
└─► Redirect → https://lexpriority.ru/ok (через 30ms)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 Детализация процессов
|
|||
|
|
|
|||
|
|
### 1. SMS Верификация
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
// Генерация кода
|
|||
|
|
sended_code = Math.floor(Math.random()*(999999-100000+1)+100000)
|
|||
|
|
|
|||
|
|
// Отправка
|
|||
|
|
POST sms-test.php
|
|||
|
|
{
|
|||
|
|
smscode: "123456",
|
|||
|
|
phonenumber: "9991234567"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// SigmaSMS API
|
|||
|
|
POST https://online.sigmasms.ru/api/sendings
|
|||
|
|
Headers: {
|
|||
|
|
Authorization: "Token 27f89492e00973263ff746a655663678fae7203bac8b62919700e489e33b3902"
|
|||
|
|
}
|
|||
|
|
Body: {
|
|||
|
|
type: "sms",
|
|||
|
|
recipient: "79991234567",
|
|||
|
|
payload: {
|
|||
|
|
sender: "Clientright",
|
|||
|
|
text: "Код подтверждения: 123456"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Таймер**: 30 секунд до повторной отправки
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2. Проверка полиса в БД
|
|||
|
|
|
|||
|
|
```sql
|
|||
|
|
-- Запрос
|
|||
|
|
SELECT * FROM ci20465_erv.lexrpiority
|
|||
|
|
WHERE voucher = ?
|
|||
|
|
|
|||
|
|
-- Замена букв (Русская → Латинская)
|
|||
|
|
Е → E
|
|||
|
|
А → A
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Результат**:
|
|||
|
|
- ✅ Найден → `cf_2446 = "1"`, скрыть загрузку полиса
|
|||
|
|
- ❌ Не найден → `cf_2446 = "0"`, показать загрузку полиса
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 3. Загрузка и обработка файлов
|
|||
|
|
|
|||
|
|
#### Клиентская валидация:
|
|||
|
|
```javascript
|
|||
|
|
Проверки:
|
|||
|
|
1. Количество ≤ 10
|
|||
|
|
2. Формат ∈ ['pdf', 'jpg', 'png', 'gif', 'jpeg']
|
|||
|
|
3. Размер ≤ 5 МБ
|
|||
|
|
|
|||
|
|
Если валидация прошла:
|
|||
|
|
→ upload_file(elem)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Серверная обработка (fileupload.php):
|
|||
|
|
```php
|
|||
|
|
1. Получение файлов (field_name-0, field_name-1, ...)
|
|||
|
|
|
|||
|
|
2. Для каждого файла:
|
|||
|
|
IF расширение != 'pdf':
|
|||
|
|
convert image.jpg image_timestamp.pdf
|
|||
|
|
→ Добавить в массив $pdfFiles[]
|
|||
|
|
ELSE:
|
|||
|
|
→ Добавить в массив $pdfFiles[]
|
|||
|
|
→ Подсчитать страницы: identify file.pdf
|
|||
|
|
|
|||
|
|
3. Объединение всех PDF:
|
|||
|
|
gs -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite \
|
|||
|
|
-sOutputFile=output.pdf file1.pdf file2.pdf ...
|
|||
|
|
|
|||
|
|
4. Имя результата:
|
|||
|
|
{docname}_{дата}_{фамилия}_{кол-во страниц}_CTP.pdf
|
|||
|
|
|
|||
|
|
Пример:
|
|||
|
|
Podtverzhdayushchie_dokumenty_23-10-2025_Ivanov_15_CTP.pdf
|
|||
|
|
|
|||
|
|
5. Response:
|
|||
|
|
{
|
|||
|
|
success: "true",
|
|||
|
|
message: "uploads/path/to/file.pdf"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Сохранение пути:
|
|||
|
|
```javascript
|
|||
|
|
thisfile.attr('data-uploadurl', res.empty_file)
|
|||
|
|
thisfile.attr('data-uploadurl_real', res.real_file)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 4. Формирование данных для CRM
|
|||
|
|
|
|||
|
|
#### Структура appends[]:
|
|||
|
|
```javascript
|
|||
|
|
appends[] = [
|
|||
|
|
// Клиент
|
|||
|
|
'{"ws_name":"lastname","ws_type":"client","field_val":"Иванов"}',
|
|||
|
|
'{"ws_name":"firstname","ws_type":"client","field_val":"Иван"}',
|
|||
|
|
'{"ws_name":"mobile","ws_type":"client","field_val":"9991234567"}',
|
|||
|
|
'{"ws_name":"email","ws_type":"client","field_val":"ivan@mail.ru"}',
|
|||
|
|
|
|||
|
|
// Контрагент (ERV)
|
|||
|
|
'{"ws_name":"inn","ws_type":"contractor","field_val":"7714312079"}',
|
|||
|
|
'{"ws_name":"accountname","ws_type":"contractor","field_val":"Филиал ООО РСО ЕВРОИНС..."}',
|
|||
|
|
|
|||
|
|
// Проект (кастомные поля)
|
|||
|
|
'{"ws_name":"cf_1885","ws_type":"other","field_val":"E123-456789"}', // Номер полиса
|
|||
|
|
'{"ws_name":"cf_1887","ws_type":"other","field_val":"01-01-2025"}', // Дата от
|
|||
|
|
'{"ws_name":"cf_1889","ws_type":"other","field_val":"31-12-2025"}', // Дата до
|
|||
|
|
|
|||
|
|
// Тикет
|
|||
|
|
'{"ws_name":"cf_1726","ws_type":"ticket","field_val":"delay_flight"}', // Тип события
|
|||
|
|
'{"ws_name":"description","ws_type":"other","field_val":"Описание..."}',
|
|||
|
|
|
|||
|
|
// Другие
|
|||
|
|
'{"ws_name":"cf_2446","ws_type":"other","field_val":"1"}', // В базе
|
|||
|
|
'{"ws_name":"cf_2502","ws_type":"project","field_val":"1"}' // Согласие
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Маппинг ws_type:
|
|||
|
|
- `client` → Модуль Contacts (Контакты)
|
|||
|
|
- `contractor` → Модуль Organizations (Организации)
|
|||
|
|
- `project` → Модуль HelpDesk или кастомный модуль
|
|||
|
|
- `ticket` → Модуль Tickets
|
|||
|
|
- `other` → Общие поля
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 5. Отправка в CRM (server.php или server_webservice2.php)
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
// Подготовка данных
|
|||
|
|
$new_post = [
|
|||
|
|
'__vtrftk' => 'sid:session_token',
|
|||
|
|
'publicid' => '3ddc71c2d79ef101c09b0d4e9c6bd08b',
|
|||
|
|
'urlencodeenable' => '1',
|
|||
|
|
'name' => 'websiteticket'
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// Добавление полей из appends[]
|
|||
|
|
foreach($appends as $item) {
|
|||
|
|
$data = json_decode($item);
|
|||
|
|
$new_post[$data->crm_name] = $data->field_val;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Добавление файлов
|
|||
|
|
foreach($upload_urls as $index => $url) {
|
|||
|
|
$files_array[$files_names[$index]] = new CURLFile(realpath($url));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Отправка
|
|||
|
|
$final_post = array_merge($new_post, $files_array);
|
|||
|
|
|
|||
|
|
CURL POST → https://crm.clientright.ru/modules/Webforms/capture.php
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🧩 Динамическая логика (JavaScript)
|
|||
|
|
|
|||
|
|
### Возрастная валидация:
|
|||
|
|
```javascript
|
|||
|
|
function getAge(dateString) {
|
|||
|
|
// Преобразование DD-MM-YYYY → Date
|
|||
|
|
var birthDate = new Date(dateString.replace(/(\d{2})-(\d{2})-(\d{4})/, "$2/$1/$3"))
|
|||
|
|
var today = new Date()
|
|||
|
|
var age = today.getFullYear() - birthDate.getFullYear()
|
|||
|
|
|
|||
|
|
// Корректировка если день рождения еще не наступил
|
|||
|
|
var m = today.getMonth() - birthDate.getMonth()
|
|||
|
|
if (m < 0 || (m === 0 && today.getDate() < birthDate.getDate())) {
|
|||
|
|
age--
|
|||
|
|
}
|
|||
|
|
return age
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Применение
|
|||
|
|
if (getAge(birthday) < 18) {
|
|||
|
|
// Показать поля законного представителя
|
|||
|
|
$("input[data-enableby=birthday]").removeClass('disabled')
|
|||
|
|
$("input[data-disabledby=birthday]").removeClass('disabled')
|
|||
|
|
} else {
|
|||
|
|
// Скрыть
|
|||
|
|
$("input[data-enableby=birthday]").addClass('disabled')
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Динамика типа события:
|
|||
|
|
```javascript
|
|||
|
|
$('select[name="event_type"]').on('change', function() {
|
|||
|
|
const selectedValue = $(this).val()
|
|||
|
|
|
|||
|
|
// Скрыть все доп. поля
|
|||
|
|
$('.connection-fields, .connection-date-fields, .cancel-flight-docs').hide()
|
|||
|
|
|
|||
|
|
switch(selectedValue) {
|
|||
|
|
case 'miss_connection':
|
|||
|
|
// Стыковочный рейс
|
|||
|
|
$('#transport_number_label').text('Укажите номер рейса прибытия')
|
|||
|
|
$('.connection-fields, .connection-date-fields').show()
|
|||
|
|
break
|
|||
|
|
|
|||
|
|
case 'cancel_flight':
|
|||
|
|
// Отмена рейса
|
|||
|
|
$('.cancel-flight-docs').show()
|
|||
|
|
break
|
|||
|
|
|
|||
|
|
default:
|
|||
|
|
// Остальные типы
|
|||
|
|
$('#transport_number_label').text('Номер рейса/поезда/парома')
|
|||
|
|
}
|
|||
|
|
})
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔍 Валидация шагов
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
function validate_step(step_index) {
|
|||
|
|
// Найти все обязательные поля на текущем шаге
|
|||
|
|
let inputs = $('.form-step.active').find(
|
|||
|
|
'input[type="text"], input[type="file"], input[type="email"], textarea, input[type="checkbox"]'
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
let res_array = []
|
|||
|
|
|
|||
|
|
inputs.each(function() {
|
|||
|
|
let field_fill = false
|
|||
|
|
|
|||
|
|
// Пропустить disabled и notvalidate
|
|||
|
|
if ($(this).hasClass('disabled') || $(this).hasClass('notvalidate')) {
|
|||
|
|
field_fill = true
|
|||
|
|
}
|
|||
|
|
// Пропустить поля с ошибками
|
|||
|
|
else if ($(this).hasClass('error')) {
|
|||
|
|
field_fill = false
|
|||
|
|
}
|
|||
|
|
// Проверить заполненность
|
|||
|
|
else if ($(this).val() == '') {
|
|||
|
|
$(this).closest('.form-item').find('.form-item__warning')
|
|||
|
|
.text('Пожалуйста, заполните все обязательные поля')
|
|||
|
|
field_fill = false
|
|||
|
|
}
|
|||
|
|
// Email валидация
|
|||
|
|
else if ($(this).attr('type') == 'email') {
|
|||
|
|
if (validateEmail($(this).val())) {
|
|||
|
|
field_fill = true
|
|||
|
|
} else {
|
|||
|
|
$(this).closest('.form-item').find('.form-item__warning')
|
|||
|
|
.text($(this).data('warmes'))
|
|||
|
|
field_fill = false
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
// Checkbox
|
|||
|
|
else if ($(this).attr('type') == 'checkbox') {
|
|||
|
|
field_fill = $(this).is(':checked')
|
|||
|
|
}
|
|||
|
|
// Остальные поля
|
|||
|
|
else {
|
|||
|
|
field_fill = true
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
res_array.push(field_fill)
|
|||
|
|
})
|
|||
|
|
|
|||
|
|
// Проверка на шаге 3: обязательно согласие
|
|||
|
|
if (step_index == 3 &&
|
|||
|
|
$('.form-step[data-step=3]').find('input[type="checkbox"]:checked').length < 1) {
|
|||
|
|
$('.form__warning').text('Необходимо согласие с политикой...')
|
|||
|
|
return false
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Если все поля валидны
|
|||
|
|
if (!res_array.includes(false)) {
|
|||
|
|
$('.form__warning').hide()
|
|||
|
|
return true
|
|||
|
|
} else {
|
|||
|
|
$('.form__warning').show()
|
|||
|
|
return false
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📊 Состояния формы
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
INITIAL STATE
|
|||
|
|
├─ .sms-check (visible)
|
|||
|
|
│ └─ Поле телефона
|
|||
|
|
│ └─ Кнопка "Отправить SMS"
|
|||
|
|
│
|
|||
|
|
├─ .sms-success (hidden, d-none)
|
|||
|
|
│ ├─ .db-validate (проверка полиса)
|
|||
|
|
│ └─ .db-success (hidden, d-none)
|
|||
|
|
│ ├─ .form-step[data-step=1] (персональные данные)
|
|||
|
|
│ ├─ .form-step[data-step=2] (событие)
|
|||
|
|
│ └─ .form-step[data-step=3] (документы)
|
|||
|
|
│
|
|||
|
|
└─ Модалки
|
|||
|
|
├─ #confirm_sms (подтверждение SMS)
|
|||
|
|
└─ #success_modal (успешная отправка)
|
|||
|
|
|
|||
|
|
AFTER SMS VERIFICATION
|
|||
|
|
├─ .sms-check (disabled)
|
|||
|
|
├─ .sms-success (visible)
|
|||
|
|
└─ .db-validate (visible)
|
|||
|
|
|
|||
|
|
AFTER POLICY CHECK
|
|||
|
|
├─ .db-success (visible)
|
|||
|
|
└─ .form-step[data-step=1].active
|
|||
|
|
|
|||
|
|
NAVIGATION
|
|||
|
|
index = 1 (default)
|
|||
|
|
├─ Кнопка "Вперед" → index++, переход на следующий шаг
|
|||
|
|
├─ Кнопка "Назад" → index--, переход на предыдущий шаг
|
|||
|
|
└─ index == 3 → Показать кнопку "Подать обращение"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🌐 Внешние зависимости
|
|||
|
|
|
|||
|
|
### API:
|
|||
|
|
1. **ip-api.com** - Геолокация по IP
|
|||
|
|
```
|
|||
|
|
GET http://ip-api.com/json/{IP}?lang=ru
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. **SigmaSMS** - Отправка SMS
|
|||
|
|
```
|
|||
|
|
POST https://online.sigmasms.ru/api/login
|
|||
|
|
POST https://online.sigmasms.ru/api/sendings
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. **DaData** - Автозаполнение реквизитов
|
|||
|
|
```
|
|||
|
|
POST https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. **form.clientright.ru** - Обработка файлов и отправка
|
|||
|
|
```
|
|||
|
|
POST https://form.clientright.ru/fileupload_v2.php
|
|||
|
|
POST https://form.clientright.ru/server_webservice2.php
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Системные утилиты:
|
|||
|
|
- **ImageMagick convert** - конвертация изображений в PDF
|
|||
|
|
- **Ghostscript gs** - объединение PDF
|
|||
|
|
- **PHPMailer** - отправка email
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔄 Обработка ошибок
|
|||
|
|
|
|||
|
|
### JavaScript AJAX:
|
|||
|
|
```javascript
|
|||
|
|
error: function(jqXHR, exception) {
|
|||
|
|
if (jqXHR.status === 0) {
|
|||
|
|
alert('Not connect. Verify Network.')
|
|||
|
|
} else if (jqXHR.status == 404) {
|
|||
|
|
alert('Requested page not found (404).')
|
|||
|
|
} else if (jqXHR.status == 500) {
|
|||
|
|
alert('Internal Server Error (500).')
|
|||
|
|
} else if (exception === 'parsererror') {
|
|||
|
|
// Парсинг JSON ошибка
|
|||
|
|
} else if (exception === 'timeout') {
|
|||
|
|
alert('Time out error.')
|
|||
|
|
} else if (exception === 'abort') {
|
|||
|
|
alert('Ajax request aborted.')
|
|||
|
|
} else {
|
|||
|
|
alert('Uncaught Error. ' + jqXHR.responseText)
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### PHP (пока отсутствует нормальная обработка):
|
|||
|
|
- Только базовые try-catch в PHPMailer
|
|||
|
|
- Нет логирования ошибок
|
|||
|
|
- Нет пользовательских сообщений
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📁 Структура session storage
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
uploads/{session_id}/
|
|||
|
|
├─ original_file1.jpg
|
|||
|
|
├─ original_file1_timestamp.pdf
|
|||
|
|
├─ original_file2.pdf
|
|||
|
|
├─ ...
|
|||
|
|
└─ Podtverzhdayushchie_dokumenty_23-10-2025_Ivanov_15_CTP.pdf
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
После успешной отправки → удаление всех файлов из `uploads/`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
Документация обновлена: **23.10.2025**
|
|||
|
|
|