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

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

1. weigh_session#

Назначение: карточка полного или частичного цикла взвешивания.

Ключевые поля:

  • id

  • tenant_id, site_id, industry_code

  • lane_id, direction

  • vehicle_plate

  • trip_token

  • status (detected|stabilizing|tare_recorded|gross_recorded|completed|rejected|manual_review)

  • operation_mode (automatic|assisted|manual_review)

  • phase_sequence (single_partial|tare_then_gross|gross_then_tare)

  • active_phase (tare|gross|none)

  • tare_kg, gross_kg, net_kg

  • tare_captured_at, gross_captured_at

  • tare_direction, gross_direction

  • tare_lane_id, gross_lane_id

  • stability_state (moving|stabilizing|stable|unstable)

  • stability_window_ms

  • driver_identity_id

  • cargo_media_id

  • plate_media_in_id, plate_media_out_id

  • scale_indicator_id

  • anpr_source

  • review_reason

  • close_reason

  • created_at, updated_at

1.1. Правила состояния#

  • detected:

    • сессия создана по факту въезда или ANPR, но вес еще не признан стабильным;

  • stabilizing:

    • ТС находится на платформе, идет ожидание стабильного веса;

  • tare_recorded:

    • записана фаза tare, вторая фаза еще не завершена;

  • gross_recorded:

    • записана фаза gross, вторая фаза еще не завершена;

  • completed:

    • есть обе фазы и рассчитан net_kg;

  • rejected:

    • цикл признан невалидным;

  • manual_review:

    • цикл не может быть автоматически завершен и требует разбора.

1.2. State machine phase-1#

detected -> stabilizing -> tare_recorded|gross_recorded -> completed

Ветка исключений:

detected|stabilizing|tare_recorded|gross_recorded -> manual_review|rejected

1.3. Инварианты#

  • vehicle_plate обязателен для automatic flow;

  • net_kg вычисляется только если одновременно заданы tare_kg и gross_kg;

  • completed запрещен без двух фаз;

  • manual_review допускает частичную карточку и пропуск identity enrichment;

  • manual_review обязателен для anpr_mismatch, missing_required_media, missing_phase и неразрешенного duplicate_session;

  • rejected не используется как silent fallback и задается только явным review-решением после exception flow;

  • повторный detect в той же фазе должен переиспользовать существующий session_id, а не создавать дубль карточки;

  • tare_direction и gross_direction могут отличаться на двусторонних весах.

2. driver_identity#

Назначение: контур идентификации водителя и сопроводительных данных рейса.

Ключевые поля:

  • id

  • tenant_id, site_id

  • driver_id

  • driver_name

  • carrier_id

  • vehicle_plate

  • trailer_plate

  • rfid_uid

  • qr_payload

  • trip_reference

  • cargo_reference

  • source (rfid|qr|mixed|manual_override)

  • resolved_at

Правило:

  • identity contour может отсутствовать в automatic baseline и не должен блокировать карточку;

  • если QR и RFID оба присутствуют, source=mixed.

3. media_evidence#

Назначение: фото и кадры, прикрепленные к карточке взвешивания.

Ключевые поля:

  • id

  • tenant_id, site_id

  • session_id

  • kind (plate_in|plate_out|cargo_top|overview)

  • phase (tare|gross|unknown)

  • camera_id

  • storage_ref

  • preview_ref

  • captured_at

  • classifier_payload

  • hash

  • required_for_close

Правило media policy:

  • cargo_top с phase=gross обязателен для automatic close;

  • cargo_top с phase=tare обязателен только для спорных и непустых кейсов;

  • отсутствие обязательного evidence переводит сессию в manual_review;

  • storage_ref хранит оригинальный evidence path и не должен заменяться preview-ссылкой;

  • preview_ref допустим только как пользовательская копия для UI/handover и не является основанием для automatic close;

  • для manual_review и rejected storage refs сохраняются вместе с alarm/evidence bundle до завершенного handover и ERP sync.

4. weigh_alarm_event#

Назначение: ошибки цикла, отказ оборудования и антифрод.

Ключевые поля:

  • id

  • tenant_id, site_id

  • session_id

  • alarm_code

  • severity, priority

  • status (open|acknowledged|resolved|closed)

  • message

  • source

  • correlation_id

  • payload

  • triggered_at, acked_at, resolved_at

Базовые alarm codes phase-1:

  • weighbridge_weight_unstable

  • weighbridge_duplicate_entry

  • weighbridge_partial_exit

  • weighbridge_anpr_mismatch

  • weighbridge_camera_unavailable

  • weighbridge_scale_timeout

  • weighbridge_gate_interlock_fault

5. Связи#

  • weigh_session.driver_identity_id -> driver_identity.id

  • media_evidence.session_id -> weigh_session.id

  • weigh_alarm_event.session_id -> weigh_session.id

6. Duplicate session policy#

  • duplicate определяется по сочетанию vehicle_plate, lane_id, активной фазы и текущего открытого cycle context;

  • runtime должен вернуть уже существующую карточку и поднять weighbridge_duplicate_entry вместо создания второй weigh_session;

  • если duplicate возникает на фоне failover или рассинхронизации панелей, authoritative session определяется по последнему подтвержденному correlation_id.

7. Минимальный phase-1 storage scope#

В первую реализационную очередь обязательно входят:

  • weigh_session

  • driver_identity

  • media_evidence

  • weigh_alarm_event

Во phase-1 не требуется отдельный реестр ERP-документов и номенклатуры; они могут приходить как refs в driver_identity.

Содержание