# Структура проекта - Детальное описание

## Обзор архитектуры

Проект состоит из нескольких версий формы, каждая из которых может иметь свои особенности. Основная рабочая версия находится в директории `/ticket/`.

## Основные компоненты

### 1. Frontend (Клиентская часть)

#### `index.php`
Главный файл формы, содержит:
- HTML-разметку многошаговой формы
- PHP-код для получения IP и региона пользователя
- Интеграцию с внешними API (ip-api.com)
- Структуру из 3 шагов:
  - Шаг 1: SMS-подтверждение и проверка полиса
  - Шаг 2: Информация о страховом случае
  - Шаг 3: Персональные данные и документы

#### `js/common.js`
Основной JavaScript файл, реализует:
- Валидацию форм на каждом шаге
- Маски ввода (телефон, ИНН, даты, банковские реквизиты)
- Логику переключения между шагами
- Отправку SMS-кодов
- Загрузку и валидацию файлов
- Конвертацию HEIC в JPEG
- AJAX-запросы к серверу
- Интеграцию с DaData API для автодополнения

#### `css/main.css` и `css/custom.css`
Стили для формы, включая:
- Адаптивный дизайн
- Стили для шагов формы
- Стили для загрузки файлов
- Модальные окна

### 2. Backend (Серверная часть)

#### `database.php`
Проверка полисов в базе данных:
- Подключение к MySQL
- Проверка номера полиса
- Валидация тарифов
- Проверка сроков действия полиса
- Возврат JSON-ответа с результатами

#### `sms-test.php`
Тестирование отправки SMS:
- Генерация кода подтверждения
- Отправка SMS на указанный номер
- Логирование операций

#### `file-server.php` (если существует)
Обработка загрузки файлов на сервер

### 3. Интеграция с CRM

#### Основной endpoint
`https://form.clientright.ru/server_new.php`

Обрабатывает:
- Данные формы из POST-запроса
- Загруженные файлы
- Отправку данных в CRM через `capture.php`
- Логирование операций

#### Веб-сервисы CRM
`https://crm.clientright.ru/webservice.php`

Операции:
1. **getchallenge** - получение токена
2. **login** - авторизация и получение sessionId
3. **CreateContact** - создание/обновление клиента
4. **CreateAccount** - создание/обновление контрагента
5. **CreateProject** - создание проекта
6. **GetFilesList** - получение списка файлов клиента

### 4. База данных

#### Структура таблицы `lexrpiority`
Поля (предположительно):
- `inn` или `police_number` - номер полиса
- `birthday` - дата рождения
- `insured_from` - дата начала действия
- `insured_to` - дата окончания действия
- `tariff` - тариф полиса

#### Валидные тарифы

**Базовые тарифы:**
- STB0048, STB1099, STB1100, STB2099
- AVS21500, AVS22500

**Дополнительные тарифы:**
- SPV0001-SPV0005, STV0090
- SPV1001-SPV1005, SPV2001-SPV2005
- OPV1001-OPV1005, OPV2001-OPV2005

### 5. Внешние библиотеки

#### JavaScript библиотеки
- **jQuery 3.6.3** - основной фреймворк
- **Inputmask** - маски ввода
- **Datepicker** - выбор дат
- **intl-tel-input** - ввод телефонных номеров
- **Fancybox** - модальные окна
- **heic2any** - конвертация HEIC в JPEG
- **suggestions-jquery** - автодополнение адресов (DaData)

#### PHP библиотеки (Composer)
- **PHPMailer** - отправка email
- **FPDF/FPDI** - работа с PDF
- **PDF Merger** - объединение PDF

### 6. Поток данных

```
Пользователь заполняет форму
    ↓
Валидация на клиенте (JavaScript)
    ↓
Отправка данных на server_new.php
    ↓
Обработка файлов и данных
    ↓
Отправка в CRM через capture.php
    ↓
Получение sessionId через веб-сервисы
    ↓
Создание/обновление клиента (CreateContact)
    ↓
Создание/обновление контрагента (CreateAccount)
    ↓
Создание проекта (CreateProject)
    ↓
Загрузка файлов в CRM
    ↓
Отправка подтверждающего email
    ↓
Возврат результата пользователю
```

## Версии проекта

### `/ticket/` - Основная рабочая версия
Используется в продакшене.

### `/ticket3/` - Альтернативная версия
Возможно, содержит изменения или эксперименты.

### `/ervws/` - Версия для веб-сервисов
Версия с акцентом на веб-сервисы.

### `/test/` - Тестовая версия
Для тестирования новых функций.

### `/public_html/` - Публичная версия
Публичная версия для клиентов.

## Конфигурация полей формы

### Поля клиента (data-ws_type="client")
- `firstname` - Имя
- `lastname` - Фамилия
- `secondname` - Отчество
- `mobile` - Телефон
- `email` - Email
- `birthday` - Дата рождения
- `mailingstreet` - Адрес регистрации
- `inn` - ИНН
- `code` - SMS-код

### Поля проекта (data-ws_type="project")
- `cf_1887` - Дата начала страхования (insured_from)
- `cf_1889` - Дата окончания страхования (insured_to)
- `cf_1899` - Код документа
- `cf_1804` - Серия и номер документа
- `cf_2502` - Согласие на обработку данных

### Поля контрагента (data-ws_type="contractor")
- `inn` - ИНН
- `ogrn` - ОГРН
- `accountname` - Наименование
- `address` - Адрес
- `email` - Email
- `phone` - Телефон
- `website` - Сайт

### Другие поля (data-ws_type="other")
- `cf_2446` - Флаг наличия в базе
- `cf_1885` - Номер полиса
- `cf_1726` - Тип события
- `cf_2566` - Дата страхового случая
- `cf_2568` - Номер рейса/поезда
- `description` - Описание ситуации
- И другие кастомные поля

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

1. **Валидация файлов:**
   - Проверка расширений
   - Проверка MIME-типов
   - Ограничение размера (5 МБ)
   - Ограничение количества (10 файлов)

2. **Валидация данных:**
   - Проверка обязательных полей
   - Валидация email
   - Валидация телефона
   - Проверка форматов дат

3. **Защита от атак:**
   - Экранирование данных
   - Использование prepared statements (рекомендуется)
   - Валидация на сервере
   - CSRF-токены (если реализованы)

## Логирование

Логи сохраняются в:
- `logs/logfile.log` - общие логи
- `formlog/` - логи форм
- JSON-файлы с префиксом `resend_log_` - логи повторной отправки

## Тестирование

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

### Тестовые данные для API
- ИНН: `643922466250`
- СМС-код: `795372`

## Рекомендации по разработке

1. Всегда тестируйте изменения в `/test/` перед применением в продакшене
2. Используйте версионирование для отслеживания изменений
3. Логируйте важные операции
4. Валидируйте данные на сервере, не только на клиенте
5. Используйте prepared statements для SQL-запросов
6. Регулярно проверяйте логи на ошибки
7. Делайте резервные копии перед крупными изменениями