Модель данных

Полный перечень полей — в глоссарии.

​

Модель данных

Модуль сервиса автоштрафов хранит данные о штрафах ПДД и обо всём, что с ними связано: об автомобилях, водителях, компаниях-нарушителях, о привязке машин к компаниям-арендодателям, о журнале синхронизации и об отправленных клиентам уведомлениях. Все справочники (авто, водители, компании, штрафы) — общие: они живут в общей части системы и наполняются данными, которые приходят из внешнего сервиса автоштрафов. А вот привязки авто, кастомные статусы и уведомления привязаны к конкретной компании. Ключевая идея всей модели — каждая внешняя сущность сервиса автоштрафов имеет собственный внешний ID (уникальный идентификатор во внешнем сервисе). Именно по нему система узнаёт «тот же самый» объект при повторной синхронизации и не создаёт дубликаты.

​

Автомобиль сервиса автоштрафов

Автомобиль, известный сервису автоштрафов, — именно по нему подтягиваются штрафы.

​

Водитель сервиса автоштрафов

Водитель-нарушитель, которого сервис связывает со штрафом. Записи не дублируются — совпадение определяется по внешнему ID. Все поля, кроме идентификатора, могут быть пустыми — сервис не всегда присылает полный набор данных о водителе.

​

Компания сервиса автоштрафов

Компания-нарушитель, то есть владелец автомобиля со стороны сервиса автоштрафов. Не путать с компанией-арендодателем внутри системы. Дедупликация — по внешнему ID.

​

Кастомный статус штрафа

Пользовательский статус, который компания заводит для себя, чтобы вручную помечать штрафы (например «Передан клиенту», «Оспаривается», «Закрыт»).

​

Штраф

Центральная модель модуля. Хранит штраф ПДД со всеми реквизитами оплаты, документами и связями. Штрафы не дублируются — совпадение по внешнему ID. Основные данные Адрес и время нарушения Статус оплаты Реквизиты оплаты Документы Связи

​

Привязка авто компании к сервису автоштрафов

Связывает конкретную единицу инвентаря компании-арендодателя с автомобилем сервиса автоштрафов. Это мост между внутренним автопарком и справочником сервиса автоштрафов.

​

Уведомление о штрафе

Запись о том, что клиенту было отправлено WhatsApp-уведомление о штрафе. Служит одновременно и историей отправок, и защитой от повторов.

​

Лог синхронизации

Журнал операций обмена данными с сервисом автоштрафов: выгрузка штрафов, приём уведомлений, авторизация. Статус по умолчанию — «В процессе», что позволяет завести запись в начале операции и дополнить её итогами по завершении.

​

Логика и побочные эффекты

​

Сохранение PDF протокола в облачном хранилище

При сохранении штрафа, если у него задана ссылка на PDF протокола, система скачивает файл по этой ссылке и кладёт его в поле «PDF протокола» в облачное хранилище. Имя файла берётся из последней части ссылки (то, что идёт после последнего слэша). Скачивание выполняется только когда в этом есть смысл — в одном из трёх случаев:

• ссылка на протокол появилась впервые;
• ссылка сменилась на другую;
• файла ещё нет в хранилище (например, предыдущая попытка скачивания не удалась — тогда следующее сохранение попробует снова).

​

Автоматическая отправка WhatsApp при появлении уведомления

Создание записи «Уведомление о штрафе» само по себе запускает отправку. Как только запись впервые создаётся (не при последующих изменениях), происходит две вещи:

1. Отправка сообщения в WhatsApp клиенту на указанный номер — фоновой задачей, поставленной в очередь после того, как запись фактически сохранилась. Текст сообщения — двуязычный (казахский и русский) — содержит госномер автомобиля, дату нарушения, сумму штрафа и орган, зафиксировавший нарушение. К сообщению прикладывается PDF протокола под именем «penalty.pdf». Имя клиента и название компании подставляются из поля «Доп. данные».
2. Создание системного уведомления внутри платформы (веб, push и Telegram) о новом штрафе по автомобилю — с номером авто, датой нарушения и суммой.

​

Как это используется

• Автомобиль сервиса автоштрафов, Водитель сервиса автоштрафов, Компания сервиса автоштрафов — наполняются автоматически из данных внешнего сервиса при синхронизации; связываются со штрафами по внешним идентификаторам.
• Штраф — основной объект, который видит оператор: по нему видно нарушение, реквизиты оплаты, документы и связи. Просмотр и управление вынесены в админку.
• Привязка авто компании к сервису автоштрафов — определяет, какие машины компании отслеживаются в сервисе автоштрафов; через неё штраф сопоставляется с конкретной единицей инвентаря и активной арендой.
• Уведомление о штрафе — фиксирует факт рассылки и не даёт задвоить сообщение клиенту; создание записи и есть команда «отправить».
• Лог синхронизации — источник для диагностики: показывает, когда и с каким результатом проходил обмен с сервисом автоштрафов.
• Кастомный статус штрафа — инструмент ручной пометки штрафов внутри компании.

​

Особенности поведения

• Если у штрафа не заполнен автомобиль, ни сообщение в WhatsApp, ни системное уведомление не отправляются — запись уведомления создаётся, но клиент ничего не получает.
• Протокол скачивается только при появлении или смене ссылки либо когда файла ещё нет; неудачная попытка не затирает уже сохранённый файл.
• Сообщение в WhatsApp уходит фоновой задачей и повторяется до трёх раз с интервалом 5 минут при недоступности сервиса; если протокол ещё не скачан, сообщение не отправляется, а в журнал пишется предупреждение.
• Уведомление уникально по паре «телефон + штраф», поэтому повторно отправить тот же штраф на тот же номер нельзя; но один и тот же штраф можно разослать на разные номера, создав несколько записей.
• Дата нарушения подставляется в текст системного уведомления без проверки на пустоту, поэтому штраф без даты нарушения приведёт к ошибке при отправке.
• При удалении связанного объекта ссылки штрафа на авто, водителя, компанию и кастомный статус обнуляются (сам штраф сохраняется), а привязки авто и уведомления удаляются вместе с компанией-арендодателем.

​

Связанные страницы