> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/bronze-layer/raw-business-data.md). # схема raw\_business\_data raw\_business\_data содержит более 40 таблиц, охватывающих пользователей, объекты, транспорт, задания и геозоны. Просмотрите определение схемы и описания основных таблиц для SQL-анализа Эта схема содержит более 40 тщательно отобранных таблиц, охватывающих различные бизнес-аспекты и сценарии использования. Эти таблицы представляют ваши ключевые бизнес-сущности, организационную структуру и операционные данные. {% hint style="info" %} Интерактивная диаграмма схемы raw\_business\_data доступна на **dbdiagram.io**: {% endhint %} Ниже приведены сведения о схеме сырых бизнес-данных. {% code title="схема raw\_business\_data" expandable="true" %} ```sql Table "vehicle_service_tasks" { "record_added_at" timestamp [not null] "start_mileage" числовое "comment" "character varying(255)" "status" "character varying(10)" [not null] "completion_date" метка времени "start_engine_hours" числовой "service_task_id" integer [not null] "is_notification_push_enabled" булево значение [не null] "date_notification_interval" интервал "predicted_datetime" метка времени "cost" numeric [not null] "mileage_limit" числовой "notification_emails" текст "is_unplanned" boolean [not null] "is_repeat" boolean [not null] "completion_engine_hours" integer "engine_hours_limit" числовое "Прбег_repeat_interval" целое число "vehicle_id" integer [not null] "engine_hours_notification_interval" integer "start_date" timestamp "mileage_notification_interval" целое число "date_repeat_interval" интервал "description" "character varying(255)" "notification_sms_phone_numbers" текст "end_date" временная метка "engine_hours_repeat_interval" целое число "completion_mileage" целое число } Таблица "Гаражи" { "record_added_at" timestamp [not null] "garage_id" integer [not null] "longitude" числовой "mechanic_name" "character varying(255)" "radius" integer [not null] "latitude" числовой "organization_label" "character varying(255)" "user_id" integer [not null] "dispatcher_name" "character varying(255)" "address" "character varying(255)" } Таблица "driver_history" { "server_datetime" timestamp [not null] "address" "character varying(255)" "updated_by" integer [not null] "object_id" целое число "longitude" числовой "latitude" числовой "driver_history_id" integer [not null] "hardware_key" "character varying(64)" "new_employee_id" integer "changed_datetime" timestamp "record_added_at" timestamp [not null] "old_employee_id" integer } Таблица "Отделы" { "record_added_at" timestamp [not null] "department_label" "character varying(255)" [not null] "latitude" числовой "department_id" integer [not null] "address" "character varying(255)" "radius" integer [not null] "longitude" числовой "user_id" integer [not null] } Таблица "checkins" { "radius" integer [not null] "latitude" numeric [not null] "employee_id" integer [not null] "longitude" numeric [not null] "record_added_at" timestamp [not null] "actual_datetime" timestamp [not null] "user_id" integer [not null] "form_id" целое число [не равно null] "address" "character varying(255)" "planned_datetime" timestamp [not null] "object_id" integer [not null] "checkin_id" integer [not null] "комментарий" текст } Table "statuses" { "order_sort" integer [not null] "listing_id" integer [not null] "color" "character varying(6)" [not null] "status_id" integer [not null] "status_label" "character varying(200)" [not null] "record_added_at" timestamp [not null] "is_deleted" boolean [not null] } Table "places_linked_entity_fields" { "value" bigint [not null] "record_added_at" timestamp [not null] "place_id" integer [not null] "field_id" integer [not null] } Таблица "places_text_fields" { "place_id" integer [not null] "record_added_at" timestamp [not null] "value" текст [not null] "field_id" integer [not null] } Table "users2zones" { "zone_id" integer [not null] "record_added_at" timestamp [not null] "user_id" integer [not null] } Table "objects" { "record_added_at" timestamp [not null] "create_datetime" timestamp [not null] "client_id" integer [not null] "group_id" целое число "object_label" "character varying(100)" "model" "character varying(64)" "is_clone" boolean [not null] "is_deleted" boolean [not null] "device_id" integer [not null] "object_id" integer [not null] } Table "device_output_name" { "device_id" integer [not null] "record_added_at" timestamp [not null] "label" "character varying(100)" [not null] "number" integer [not null] } Таблица "geofence_points" { "longitude" numeric [not null] "number" integer [not null] "zone_id" integer [not null] "record_added_at" timestamp [not null] "latitude" numeric [not null] } Table "custom_fields" { "record_added_at" timestamp [not null] "entity_id" integer [not null] "is_required" boolean [not null] "custom_field_label" text [not null] "parameters" jsonb "custom_field_type" integer [not null] "описание" текст "custom_field_id" integer [not null] } Таблица "places_decimal_fields" { "field_id" integer [not null] "record_added_at" timestamp [not null] "place_id" integer [not null] "value" numeric [not null] } Таблица "task_history" { "task_id" целое [не допускает null] "activity" integer [not null] "task_history_id" целое число [не равно null] "record_added_at" timestamp [not null] "user_id" integer [not null] "event_datetime" timestamp [not null] "payload" текст } Таблица "теги" { "tag_label" "character varying(64)" [not null] "color" "character varying(6)" "user_id" integer [not null] "record_added_at" timestamp [not null] "tag_id" целое число [not null] } Table "places" { "описание" текст "custom_fields" jsonb "place_id" integer [not null] "external_id" "character varying(32)" "record_added_at" timestamp [not null] "user_id" целое число "latitude" числовой "radius" целое число "place_label" "character varying(256)" "assigned_datetime" timestamp "address" "character varying(256)" "longitude" числовой } Table "status_listings" { "user_id" integer [not null] "is_supervisor_controlled" boolean [not null] "is_deleted" boolean [not null] "status_listing_id" integer [not null] "is_employee_controlled" boolean [not null] "record_added_at" timestamp [not null] "status_listing_label" "character varying(200)" [not null] } Table "models" { "record_added_at" timestamp [not null] "model_id" integer [not null] "has_battery_level" boolean [not null] "alternative_label" "character varying(50)" [not null] "vendor" "character varying(30)" [not null] "is_clone" boolean "has_altitude" boolean [not null] "has_phone" boolean [not null] "type_output_control" "character varying(30)" [not null] "has_gsm_roaming" boolean [not null] "has_gsm_level" boolean [not null] "model" "character varying(255)" [not null] "type_special_control" "character varying(255)" [not null] "digital_amount" integer [not null] "has_detach_button" boolean [not null] "has_gsm_name" boolean [not null] "analog_amount" integer [not null] "outputs_amount" integer [not null] } Таблица "vehicle_trackers_history" { "vehicle_id" integer [not null] "record_added_at" timestamp [not null] "object_id" integer [not null] "changed_datetime" timestamp [not null] "vehicle_tracker_history_id" целое число [не равно null] } Table "groups" { "group_id" целое число [not null] "group_color" "character varying(6)" [not null] "group_label" "character varying(255)" [not null] "client_id" integer [not null] "record_added_at" timestamp [not null] } Table "sensor_description" { "record_added_at" timestamp [not null] "parameters" jsonb "input_id" integer [not null] "accuracy" numeric [not null] "sensor_units" "character varying(10)" "multiplier" doubleprecision [not null] "input_label" "character varying(64)" "sensor_label" "character varying(100)" "units_type" integer [not null] "divider" doubleprecision [not null] "group_id" целое число [not null] "sensor_id" integer [not null] "device_id" integer [not null] "sensor_type" "character varying(45)" [not null] "group_type" integer [not null] "calibration_data" jsonb } Table "entities" { "entity_label" jsonb "record_added_at" timestamp [not null] "entity_id" integer [not null] "builtin_type" integer [not null] "user_id" integer [not null] } Table "zones" { "address" "character varying(255)" "radius" integer [not null] "zone_id" integer [not null] "circle_center_latitude" numeric [not null] "client_id" integer [not null] "zone_label" "character varying(100)" "color" "character varying(6)" [not null] "zone_type" "character varying(20)" [not null] "circle_center_longitude" numeric [not null] "latitude" numeric [not null] "record_added_at" timestamp [not null] "longitude" numeric [not null] } Table "vehicles" { "vehicle_id" integer [not null] "payload_length" числовое "vin" "character varying(20)" "free_insurance_policy_number" "character varying(50)" "vehicle_label" "character varying(100)" "payload_width" числовой "color" "character varying(6)" "trailer" "character varying(255)" "object_id" целое число "vehicle_status_id" целое число "liability_insurance_valid_till" метка времени "manufacture_year" целое число "fuel_grade" "character varying(16)" "fuel_cost" числовой "fuel_tank_volume" числовое "model" "character varying(100)" "garage_id" целое число "payload_height" числовой "max_speed" numeric "registration_number" "character varying(32)" "tyre_size" "character varying(50)" "passenger_capacity" целое число "record_added_at" timestamp [not null] "trailer_reg_number" "character varying(32)" "free_insurance_valid_till_date" метка времени "gross_weight" числовой "standard_fuel_consumption" числовой "fuel_type" целое число "payload_weight" числовой "additional_info" текст "vehicle_subtype" "character varying(32)" "номер_полиса_страхования_ответственности" "изменяемый символ(50)" "frame_number" "character varying(32)" "user_id" integer [not null] "vehicle_type" integer [not null] "chassis_number" "character varying(32)" "tyres_number" integer "wheel_arrangement" "character varying(16)" } Таблица "tag_links" { "entity_id" integer [not null] "record_added_at" timestamp [not null] "entity_type" integer [not null] "ordinal" integer [not null] "tag_id" целое число [not null] } Таблица "rules" { "rule_id" integer [not null] "object_id" integer [not null] "parameters" jsonb "alert_phone" "character varying(210)" [not null] "event_type" "character varying(100)" [not null] "client_id" integer [not null] "is_push_enabled" boolean [not null] "event_comment1" "character varying(255)" [not null] "event_label" "character varying(255)" [not null] "description" "character varying(255)" [not null] "record_added_at" timestamp [not null] "alert_sms" текст [not null] "event_group" целое [not null] "created_at" timestamp [not null] "maximum" integer [not null] "is_deleted" boolean [not null] "alert_email" text [not null] "event_comment2" "character varying(255)" [not null] } Таблица "status_history" { "longitude" числовой "new_status_id" integer "status_history_id" integer [not null] "device_id" integer [not null] "updated_by" integer [not null] "address" "character varying(255)" "latitude" числовой "record_added_at" timestamp [not null] "server_datetime" timestamp [not null] "changed_datetime" timestamp "old_status_id" integer } Таблица "rules2zones" { "zone_id" integer [not null] "record_added_at" timestamp [not null] "rule_id" integer [not null] } Таблица "forms" { "object_id" integer [not null] "описание" текст "form_label" "character varying(255)" [not null] "fields" текст "created_at" timestamp [not null] "submission_address" "character varying(255)" "submission_latitude" числовой "form_id" целое число [не равно null] "submission_longitude" числовое "is_submission_in_zone" boolean [not null] "values" текст "record_added_at" timestamp [not null] "task_id" целое число метка времени "submitted_at" } Таблица "rules2objects" { "Объект_params" jsonb "param_group_number" целое число [не допускает NULL] "object_id" integer [not null] "record_added_at" timestamp [not null] "rule_id" integer [not null] } Таблица "Задания" { "time_from" метка времени "stay_duration_minutes" интервал "external_id" "character varying(100)" "object_id" целое число "task_type" целое число "arrival_duration_minutes" интервал "status" целое число "arrival_datetime" timestamp "record_added_at" timestamp [not null] "task_id" целое [не допускает null] "user_id" целое число "status_change_datetime" метка времени "order_sort" integer "time_to" метка времени "max_delay_minuts" целое число "is_stay_control_enabled" булево "address" "character varying(255)" "task_label" "character varying(200)" [not null] "longitude" числовой "created_by" целое число "description" text [not null] "radius" целое число "latitude" числовой "stay_duration" integer "created_at" timestamp [not null] "custom_fields" jsonb "parent_task_id" целое число } Таблица "places_bigint_fields" { "field_id" integer [not null] "value" bigint [not null] "place_id" integer [not null] "record_added_at" timestamp [not null] } Таблица "devices" { "is_sim_blocked" boolean [not null] "device_id" integer [not null] "device_imei" "character varying(64)" [not null] "network_label" "character varying(50)" [not null] "status_listing_id" integer [not null] "signal_level" numeric [not null] "phone" "character varying(32)" [not null] "has_roaming" boolean [not null] "created_at" timestamp [not null] "owner_id" целое число [не допускает значение null] "record_added_at" timestamp [not null] } Таблица "description_parameters" { "description" "character varying(150)" "record_added_at" timestamp [not null] "type" "character varying(100)" [not null] "key" integer [not null] } Table "users" { "company_label" "character varying(255)" [not null] "registration_datetime" timestamp "first_name" "character varying(100)" [not null] "master_id" integer "last_name" "character varying(100)" [not null] "birth_date" timestamp "timezone_label" "character varying(30)" "middle_name" "character varying(100)" [not null] "user_id" integer [not null] "locale" "character varying(10)" [not null] "record_added_at" timestamp [not null] } Таблица "counters" { "sensor_id" целое число "multiplier" numeric [not null] "counter_id" integer [not null] "device_id" integer [not null] "counter_type" integer [not null] "record_added_at" timestamp [not null] } Table "employees" { "driver_license_valid_till" временная метка "record_added_at" timestamp [not null] "last_name" "character varying(100)" "department_id" integer "citizen_id_number" "character varying(32)" "first_name" "character varying(100)" "driver_license_categories" "character varying(32)" "user_id" integer [not null] "phone_number" "character varying(32)" "object_id" целое число "is_deleted" boolean [not null] "driver_license_issue_date" логическое "hardware_key" "character varying(64)" "middle_name" "character varying(100)" "address" "character varying(255)" "latitude" числовой "employee_id" integer [not null] "personnel_number" "character varying(15)" "fuel_cost" doubleprecision "driver_license_number" "character varying(32)" "email" "character varying(100)" "fuel_consumption" doubleprecision "radius" integer [not null] "longitude" числовой } Table "places_longtext_fields" { "field_id" integer [not null] "value" текст [not null] "record_added_at" timestamp [not null] "place_id" integer [not null] } Таблица "groups_objects" { "groups_client_id" integer "objects_client_id" целое число Индексы { (groups_client_id, objects_client_id) [pk] } } Table "device_settings" { "device_id" integer [not null] "key" "character varying" [not null] "value" текст Индексы { (device_id, key) [pk] } } Table "event_description" { "event_id" integer [not null, pk] "описание" текст } Ссылка:"employees"."employee_id" < "checkins"."employee_id" Ref:"objects"."object_id" < "checkins"."object_id" Ref:"forms"."form_id" < "checkins"."form_id" Ref:"sensor_description"."sensor_id" < "counters"."sensor_id" Ссылка:"devices"."device_id" < "counters"."device_id" Ref:"entities"."entity_id" < "custom_fields"."entity_id" Ref:"departments"."department_id" < "employees"."department_id" Ref:"users"."user_id" < "Отделы"."user_id" Ref:"description_parameters"."key" < "counters"."counter_type" Ref:"description_parameters"."key" < "custom_fields"."custom_field_type" Ref:"description_parameters"."key" < "driver_history"."updated_by" Ref:"description_parameters"."key" < "entities"."builtin_type" Ref:"description_parameters"."key" < "sensor_description"."units_type" Ref:"description_parameters"."key" < "status_history"."updated_by" Ref:"description_parameters"."key" < "Задания"."status" Ref:"description_parameters"."key" < "tasks"."created_at" Ref:"description_parameters"."key" < "tasks"."task_type" Ref:"description_parameters"."key" < "vehicles"."fuel_type" Ref:"description_parameters"."key" < "task_history"."activity" Ref:"description_parameters"."key" < "sensor_description"."group_type" Ref:"devices"."device_id" < "device_output_name"."device_id" Ref:"status_listings"."status_listing_id" < "devices"."status_listing_id" Ref:"employees"."employee_id" < "driver_history"."new_employee_id" Ref:"employees"."employee_id" < "driver_history"."old_employee_id" Ref:"objects"."object_id" < "driver_history"."object_id" Ref:"objects"."object_id" < "employees"."object_id" Ref:"users"."user_id" < "employees"."user_id" Ref:"users"."user_id" < "entities"."user_id" Ref:"tasks"."task_id" < "forms"."task_id" Ref:"objects"."object_id" < "forms"."object_id" Ref:"objects"."object_id" < "tasks"."object_id" Ref:"users"."user_id" < "Гаражи"."user_id" Ссылка:"groups"."client_id" < "groups_objects"."groups_client_id" Ref:"objects"."client_id" < "groups_objects"."objects_client_id" Ссылка:"models"."model" < "objects"."model" Ссылка:"devices"."device_id" < "objects"."device_id" Ref:"users"."user_id" < "places"."user_id" Ref:"custom_fields"."custom_field_id" < "places_bigint_fields"."field_id" Ref:"places"."place_id" < "places_bigint_fields"."place_id" Ref:"custom_fields"."custom_field_id" < "places_decimal_fields"."field_id" Ref:"places"."place_id" < "places_decimal_fields"."place_id" Ref:"custom_fields"."custom_field_id" < "places_linked_entity_fields"."field_id" Ref:"places"."place_id" < "places_linked_entity_fields"."place_id" Ref:"custom_fields"."custom_field_id" < "places_longtext_fields"."field_id" Ref:"places"."place_id" < "places_longtext_fields"."place_id" Ref:"custom_fields"."custom_field_id" < "places_text_fields"."field_id" Ref:"places"."place_id" < "places_text_fields"."place_id" Ref:"rules"."rule_id" < "rules2zones"."rule_id" Ref:"objects"."object_id" < "rules2objects"."object_id" Ref:"rules"."rule_id" < "rules2objects"."object_id" Ref:"zones"."zone_id" < "rules2zones"."zone_id" Ref:"devices"."device_id" < "sensor_description"."device_id" Ref:"statuses"."status_id" < "status_history"."new_status_id" Ссылка:"statuses"."status_id" < "status_history"."old_status_id" Ref:"devices"."device_id" < "status_history"."device_id" Ref:"users"."user_id" < "status_listings"."user_id" Ref:"status_listings"."status_listing_id" < "statuses"."listing_id" Ref:"tags"."tag_id" < "tag_links"."tag_id" Ref:"users"."user_id" < "Теги"."user_id" Ref:"tasks"."task_id" < "task_history"."task_id" Ref:"users"."user_id" < "task_history"."user_id" Ref:"tasks"."parent_task_id" < "tasks"."task_id" Ref:"users"."user_id" < "tasks"."user_id" Ссылка:"users"."master_id" < "users"."user_id" Ссылка:"users"."user_id" < "users2zones"."user_id" Ref:"zones"."zone_id" < "users2zones"."zone_id" Ref:"vehicles"."vehicle_id" < "vehicle_service_tasks"."vehicle_id" Ref:"objects"."object_id" < "vehicle_trackers_history"."object_id" Ref:"Транспорт"."vehicle_id" < "vehicle_trackers_history"."vehicle_id" Ref:"garages"."garage_id" < "vehicles"."garage_id" Ref:"objects"."object_id" < "vehicles"."object_id" Ref:"users"."user_id" < "vehicles"."user_id" Ref:"zones"."zone_id" < "geofence_points"."zone_id" Ref:"users"."user_id" < "devices"."owner_id" Ref:"users"."user_id" < "objects"."client_id" ``` {% endcode %} ## Частота обновления Данные в этой схеме синхронизируются с core DB. Обновления выполняются инкрементально по мере изменений в исходной базе данных MySQL, обычно в течение менее 5 минут после изменения в источнике. ## `description_parameters` Система включает справочные данные для стандартизации значений по всей базе данных:
Тип справочных данныхОписаниеПример значений
Определения типовСтандартные типы сущностейvehicle_type: car, truck, bus
Коды статусовЗначения статусов задания и системыtasks_status: не назначено, назначено, выполнено
Определения единицЕдиницы измерения для датчиковunits_type: литр, галлон, Цельсий
Классификации сущностейКатегории бизнес-сущностейentities_type: Место, Задание, клиент
## Основные таблицы по категориям Таблицы в **`raw_business_data`** схемы организованы по функциональным категориям для более удобной навигации. В таблице ниже приведены основные таблицы по их бизнес-назначению: Основные бизнес-сущности
пользователи **Описание**: Учетные записи пользователей, содержащие информацию профиля, привязку к компании, настройки локализации (часовой пояс, локаль) и иерархические связи через master\_id для многоуровневых структур учетных записей
АтрибутПодробности
Ключевые поля- user_id - Уникальный идентификатор пользователя
- company_label - Название компании, связанной с пользователем
- first_name - Имя пользователя
- last_name - Фамилия пользователя
- middle_name - Отчество пользователя
- locale - Языковые настройки пользователя
- timezone_label - Часовой пояс в формате IANA
- master_id - ID основного пользователя (если текущий является подчиненным)
- registration_datetime - Дата регистрации в системе
- birth_date - Дата рождения пользователя
СвязиРодительский пользователь через master_id, связанный с сотрудники, отделы, места, задания через user_id
Особые примечанияЦентральная сущность, связывающая организационные данные; master_id обеспечивает иерархии пользователей для многоуровневых структур учетных записей
сотрудники **Описание**: Записи сотрудников и водителей, используемые для представления людей, работающих в организации, включая личную информацию, данные водительских удостоверений, назначения в отделы, аппаратные ключи для идентификации с помощью iButton/RFID и данные о местоположении с поддержкой геозонирования
АтрибутПодробности
Ключевые поля- employee_id - Идентификатор сущности сотрудника
- user_id - Идентификатор сущности пользователя
- object_id - Объект идентификатора сущности
- department_id - Идентификатор отдела, к которому назначен сотрудник
- first_name - атрибут first_name таблицы employees
- last_name - Атрибут last_name таблицы employees
- middle_name - Атрибут middle_name таблицы employees
- номер_водительского_удостоверения - Номер Водительского удостоверения
- категории_водительских_прав - категории водительских прав
- дата_выдачи_водительского_удостоверения - Дата выдачи Водительского удостоверения
- driver_license_valid_till - Дата, до которой действительно Водительское удостоверение
- hardware_key - Аппаратный ключ
- электронная почта - Электронная почта сотрудника
- phone_number - Телефон сотрудника без знака "+"
- address - Адрес местоположения
- personnel_number - Табельный номер сотрудника/Водитель
- citizen_id_number - Номер социального страхования
- latitude - Локация, связанная с этим сотрудником
- longitude - Локация, связанная с этим сотрудником
- radius - Местоположение, связанное с этим сотрудником, в метрах
- расход_топлива - Атрибут fuel_consumption таблицы employees
- стоимость_топлива - Атрибут fuel_cost таблицы employees
- is_deleted - Атрибут is_deleted таблицы employees
СвязиСсылки на пользователи, отделы, объекты (назначенный трекер), отслеживается в driver_history и чекины
Особые примечанияАппаратный ключ обеспечивает идентификацию водителя через iButton или RFID; поддерживает геозонирование с latitude, longitude, radius поля
отделы **Описание**: Организационные единицы с данными о географическом местоположении (широта, долгота, радиус), обеспечивающие аналитику на основе зон для отчетности на уровне отдела и привязки местоположения сотрудника
АтрибутПодробности
Ключевые поля- department_id - Идентификатор сущности отдела
- user_id - Идентификатор сущности пользователя
- department_label - Атрибут department_label таблицы Отделы
- latitude - Местоположение, связанное с этими Отделами
- longitude - Местоположение, связанное с этими Отделами
- radius - Размер геозоны в метрах
- address - Атрибут address таблицы Отделы
СвязиСвязывает сотрудников с организационной структурой через department_id
Особые примечанияПоля местоположения поддерживают аналитику на основе Зона для отчетности на уровне подразделений
Мониторинг и мониторинг
устройства **Описание**: Реестр физических устройств для Мониторинг с аппаратными идентификаторами (IMEI), информацией о SIM-карте, статусом сетевого подключения (уровень сигнала, роуминг, оператор) и назначениями в списке статусов для управления жизненным циклом устройства
АтрибутПодробности
Ключевые поля- device_id - ID устройства
- owner_id - ID владельца устройства, в учетную запись которого было добавлено устройство
- device_imei - IMEI устройства
- телефон - Номер SIM-карты устройства
- status_listing_id - Идентификатор статуса работы устройств
- network_label - Имя сети, к которой подключена SIM-карта
- signal_level - Уровень сигнала устройства
- has_roaming - Флаг доступности роуминга
- is_sim_blocked - Флаг блокировки SIM-карты
- created_at - Дата и время создания записи
СвязиОсновная сущность, связанная с объекты, модели, sensor_description, счетчики; owner_id Ссылки users.user_id
Особые примечанияВсе телематические данные в raw_telematics_data схема ссылается на эту таблицу через device_id
объекты **Описание**: Центральный реестр отслеживаемых сущностей (vehicles, assets, персонал), связывающий физические устройства с организационной структурой через client\_id и group\_id, представляющий "trackable unit" с по одному активному объекту на устройство
АтрибутПодробности
Ключевые поля- object_id - Объект идентификатора сущности
- client_id - Идентификатор сущности клиента
- device_id - Идентификатор сущности устройства
- Объект_лейбл - Имя объекта
- модель - Модель устройства
- group_id - Группа ID сущности
- create_datetime - Дата и время создания новой строки на сервере
- is_deleted - атрибут is_deleted таблицы objects
- is_clone - Признак клона
СвязиЦентральный узел, соединяющий устройства с пользователями (client_id), сведения о транспортном средстве, история мониторинга, задания и правила
Особые примечанияПредставляет в системе "trackable unit"; по одному объекту на каждое устройство, находящееся в активном использовании
модели **Описание**: Центральный реестр отслеживаемых сущностей (vehicles, assets, персонал), связывающий физические устройства с организационной структурой через client\_id и group\_id, представляющий "trackable unit" с по одному активному объекту на устройство
АтрибутПодробности
Ключевые поля- model_id - Идентификатор модели сущности
- модель - Атрибут model таблицы models
- vendor - Название компании, выпустившей трекер
- alternative_label - Атрибут alternative_label таблицы models
- analog_amount - Количество аналоговых входов трекера
- digital_amount - Количество дискретных входов трекера
- outputs_amount - Количество дискретных выходов трекера
- has_battery_level - Определяет, передает ли трекер показания заряда батареи
- has_altitude - Определяет, передает ли трекер высоту
- has_phone - Есть ли SIM-карта?
- has_gsm_level - Может ли трекер передавать уровень сигнала GSM?
- has_gsm_name - Может ли трекер передавать название сети GSM или код оператора (MCC + MNC)?
- has_gsm_roaming - Может ли трекер передавать статус роуминга?
- has_detach_button - Есть ли у трекера датчик отсоединения?
- type_output_control - Профиль управления выходами трекера
- type_special_control - Содержит специализированные настройки и функциональные модули для отдельных моделей устройств, например режим опасного вождения (hbm_telfm) для оборудования Teltonika
- is_clone - Является ли модель клоном другой модели?
СодержимоеБулевы флаги возможностей указывают, какие поля данных доступны для этого типа устройства
Особые примечанияИспользуйте флаги возможностей, чтобы определить допустимые датчики и входы при запросе телематических данных
sensor_description **Описание**: Полная конфигурация датчиков, связывающая входы устройства с бизнес-логикой, включая сопоставления входов, единицы измерения, коэффициенты преобразования (multiplier/divider), таблицы калибровки для датчиков уровня топлива, пороги точности и логику группировки для агрегированных показаний датчиков
АтрибутПодробности
Ключевые поля- sensor_id - Идентификатор сущности датчика
- device_id - Идентификатор сущности устройства
- sensor_label - Имя датчика для UI
- input_label - Название поля сообщения (атрибута), из которого берутся данные датчиков. Если оно равно "input_status," это дискретный датчик
- sensor_type - Тип датчика
- units_type - Единицы измерения
- multiplier - Множитель - число, на которое умножается значение поля. Только для измерительных датчиков
- divider - Делитель - число, на которое делится значение поля. Только для измерительных датчиков
- accuracy - Заданный процент для расчета абсолютной погрешности объема бака. Эта погрешность используется для определения моментов заправки или слива. Это используется только для датчиков уровня топлива
- calibration_data - Атрибут calibration_data таблицы sensor_description
- input_id - Номер входа для дискретного датчика
- group_id - Датчики одного типа с одинаковыми group_id и source_id считаются принадлежащими одной Группа. Их данные суммируются или усредняются в зависимости от значения group_type. Это необходимо для агрегированных датчиков. Используется в измерительных датчиках
- тип группы - 0 - суммировать значения датчиков внутри Группа, 1 - среднее
- sensor_units - Название единицы, введенное пользователем, если units_type=0 (пользовательский)
- параметры - Необязательный объект с дополнительными параметрами parent_ids — необязательный массив parent_ids для составного датчика. volume — double. Необязательный. Объем для составного датчика. parent_ids — необязательный массив int. Массив parent_ids для составного датчика. volume — необязательный. Double. Объем для составного датчика. min — необязательный. Double. Минимально допустимое сырое значение для датчика. max — необязательный. Double. Максимально допустимое сырое значение для датчика. max_lowering_by_time - необязательный. Double. Максимально допустимое снижение за час. max_lowering_by_mileage - необязательный. Double. Максимально допустимое снижение на 100 км. ignore_drains_in_move - необязательный. Boolean. По умолчанию false. Если true, то утечки топлива не будут обнаруживаться во время движения. ignore_refuels_in_move - необязательный. Boolean. По умолчанию false. Если true, то дозаправки не будут обнаруживаться во время движения. refuel_gap_minutes - необязательный. Integer. По умолчанию 5. Время в минутах после начала движения, в течение которого дозаправки будут обнаруживаться во время движения. custom_field_name - необязательный. Boolean. По умолчанию false. Параметр определяет, является ли поле input_name пользовательским значением, введенным пользователем. Это имеет смысл только если у модели трекера есть функция has_custom_fields
СвязиСвязывает входы устройства (из raw_telematics_data.inputs) к бизнес-логике через device_id и input_label совпадение
Особые примечанияcalibration_data (JSONB) хранит таблицы калибровки, специфичные для датчиков «Уровень топлива»; multiplier и divider преобразовать необработанные значения в единицы
Управление активами
Транспорт **Описание**: Комплексный реестр транспортных средств, содержащий спецификации (размеры, вес, вместимость), документацию (VIN, регистрация, Страховка), эксплуатационные параметры (Норма расхода, объем бака) и текущее назначение Трекера через object\_id для Управление транспортом и Мониторинг соответствия
АтрибутПодробности
Ключевые поля- vehicle_id - Идентификатор сущности транспортного средства
- user_id - Идентификатор сущности пользователя
- object_id - Объект идентификатора сущности
- garage_id - Идентификатор сущности гаража
- vehicle_label - Атрибут vehicle_label таблицы Транспорт
- registration_number - Рег. номер/ Гос. номер автомобиля
- VIN - атрибут VIN таблицы Транспорт
- manufacture_year - Атрибут manufacture_year таблицы Транспорт
- тип топлива - Атрибут fuel_type таблицы Транспорт
- стоимость_топлива - Атрибут fuel_cost таблицы vehicles
- fuel_tank_volume - Атрибут fuel_tank_volume таблицы Транспорт
- max_speed - Атрибут max_speed таблицы Транспорт
- модель - Атрибут model таблицы Транспорт
- цвет - Атрибут color таблицы Транспорт
- прицеп - Атрибут прицепа таблицы Транспорт
- additional_info - Атрибут additional_info таблицы Транспорт
- vehicle_type - Атрибут vehicle_type таблицы Транспорт
- vehicle_subtype - Атрибут vehicle_subtype таблицы Транспорт
- vehicle_status_id - Идентификатор сущности статус транспортного средства
- chassis_number - атрибут chassis_number таблицы Транспорт
- frame_number - Атрибут frame_number таблицы Транспорт
- trailer_reg_number - Атрибут trailer_reg_number таблицы Транспорт
- payload_weight - Атрибут payload_weight таблицы Транспорт
- payload_height - Атрибут payload_height таблицы Транспорт
- payload_length - Атрибут payload_length таблицы Транспорт
- payload_width - Атрибут payload_width таблицы Транспорт
- passenger_capacity - Максимальное количество пассажиров
- gross_weight - Атрибут gross_weight таблицы Транспорт
- стандартное потребление топлива - Нормальная средняя Норма расхода в литрах на 100 км
- марка топлива - Атрибут fuel_grade таблицы vehicles
- wheel_arrangement - Атрибут wheel_arrangement таблицы Транспорт
- tyre_size - Размер транспортного средства: габариты и размер колес
- tyres_number - Количество колес
- liability_insurance_policy_number - Атрибут liability_insurance_policy_number таблицы vehicles
- liability_insurance_valid_till - Дата, до которой действительна Страховка гражданской ответственности
- free_Страховка_номер_полиса - Атрибут free_insurance_policy_number таблицы Транспорт
- free_Страховка_valid_till_date - Дата, до которой действует бесплатная Страховка
СвязиСсылки на объекты (текущий трекер), гаражи (место обслуживания), vehicle_service_Задания; отслеживается в vehicle_trackers_history
Особые примечанияПоля физических измерений (payload_length, payload_width, payload_height, gross_weight) поддерживают аналитику планирования загрузки; даты Страховка обеспечивают Мониторинг соответствия
гаражи **Описание**: Места расположения сервисных и Техобслуживание объектов с географическими координатами (широта, долгота, радиус), контактной информацией для механиков и диспетчеров, предназначенные для обнаружения визитов в сервис с использованием Зона и анализа близости
АтрибутПодробности
Ключевые поля- garage_id - Идентификатор сущности гаража
- user_id - Идентификатор сущности пользователя
- latitude - Объект местоположения
- longitude - Объект местоположения
- radius - Размер геозоны в метрах
- address - Объект местоположения
- organization_label - ID Гараж
- mechanic_name - Имя механика
- dispatcher_name - Имя диспетчера
СвязиНа него ссылаются Транспорт.garage_id для назначения места обслуживания
Особые примечанияПоля местоположения обеспечивают определение посещений сервиса на основе Зоны и анализ близости
vehicle_service_Задания **Описание**: график Техобслуживание и Мониторинг истории обслуживания с несколькими типами триггеров (по дате, по Пробег, по моточасам), повторяющимися интервалами Задание, многоканальными уведомлениями (email, SMS, push) и различием между плановыми (is\_repeat) и внеплановыми событиями Техобслуживание
АтрибутПодробности
Ключевые поля- service_task_id - Идентификатор сущности задания обслуживания
- vehicle_id - Идентификатор сущности транспортного средства
- описание - Атрибут description таблицы vehicle_service_tasks
- статус - Значение статуса атрибута status
- стоимость - Атрибут cost таблицы vehicle_service_tasks
- start_date - Дата и время, связанные с атрибутом start_date
- end_date - Дата и время, связанные с атрибутом end_date
- completion_date - Дата и время, связанные с атрибутом completion_date
- predicted_datetime - Дата и время, связанные с атрибутом predicted_datetime
- ограничение_пробега - Атрибут mileage_limit таблицы vehicle_service_tasks
- engine_hours_limit - Атрибут engine_hours_limit таблицы vehicle_service_tasks
- start_Пробег - Атрибут start_mileage таблицы vehicle_service_tasks
- start_engine_hours - Атрибут start_engine_hours таблицы vehicle_service_tasks
- Пробег_notification_interval - Атрибут mileage_notification_interval таблицы vehicle_service_tasks
- engine_hours_notification_interval - атрибут engine_hours_notification_interval таблицы vehicle_service_tasks
- date_notification_interval - Преобразование целого числа N в N дней
- Пробег_repeat_interval - Атрибут mileage_repeat_interval таблицы vehicle_service_tasks
- engine_hours_repeat_interval - атрибут engine_hours_repeat_interval таблицы vehicle_service_tasks
- date_repeat_interval - Преобразование целого числа N в N дней
- notification_emails - Атрибут `notification_emails` таблицы `vehicle_service_tasks`
- notification_sms_phone_numbers - Атрибут notification_sms_phone_numbers таблицы vehicle_service_tasks
- is_notification_push_enabled - Атрибут is_notification_push_enabled таблицы vehicle_service_tasks
- completion_Пробег - Атрибут completion_mileage таблицы vehicle_service_tasks
- completion_engine_hours - Атрибут completion_engine_hours в таблице vehicle_service_tasks
- is_repeat - Атрибут is_repeat таблицы vehicle_service_tasks
- is_unplanned - Атрибут is_unplanned таблицы vehicle_service_tasks
- комментарий - Атрибут комментария таблицы vehicle_service_tasks
СодержимоеПоддерживает три типа триггеров: по дате, по пробегу, по моточасам; настройки уведомлений для email, SMS, push
Особые примечанияis_repeat и поля интервала позволяют создавать повторяющиеся графики Техобслуживание; is_unplanned различает плановое и реактивное Техобслуживание
Местоположение и маршрутизация
зоны **Описание**: Геозоны, определяющие виртуальные периметры с использованием кругов или полигонов для мониторинга событий въезда и выезда транспортного средства/Актив, поддерживающие автоматизацию на основе правил и аналитику местоположения с цветовой кодировкой для визуального различения
АтрибутПодробности
Ключевые поля- zone_id - Идентификатор сущности зоны
- client_id - Идентификатор сущности клиента
- zone_label - Атрибут zone_label таблицы zones
- zone_type - Атрибут zone_type таблицы zones
- latitude - Необязательный объект, ограничивающий прямоугольник, который может полностью содержать возвращаемый результат
- longitude - Необязательный объект, ограничивающий прямоугольник, который может полностью содержать возвращаемый результат
- circle_center_latitude - Атрибут circle_center_latitude таблицы zones
- circle_center_longitude - Атрибут circle_center_longitude таблицы zones
- radius - Размер геозоны в метрах
- address - Атрибут address таблицы zones
- цвет - Атрибут color таблицы zones
СодержимоеТипы зон включают круг, полигон (определяется с помощью Зона_points), и специальные классификации зон
СвязиНа него ссылаются rules2zones, users2zones; вершины полигона, хранящиеся в Зона_points
Особые примечанияФункции PostGIS можно использовать для проверки попадания точки в полигон при сложном анализе геозон
места **Описание**: Точки интереса с географическими координатами, определениями радиуса и поддержкой настраиваемых пользовательских полей для хранения контактной информации клиентов и данных, специфичных для бизнеса, что обеспечивает интеграцию с CRM/ERP через external\_id и отчетность на основе местоположения
АтрибутПодробности
Ключевые поля- place_id - Идентификатор сущности Место
- user_id - Идентификатор сущности пользователя
- место_лейбл - Атрибут place_label таблицы Места
- latitude - Объект местоположения
- longitude - Объект местоположения
- radius - Размер геозоны в метрах
- address - Атрибут address таблицы Места
- описание - Атрибут description таблицы Места
- external_id - ID для интеграции с внешними системами (CRM)
- custom_fields - Дополнительные поля
- assigned_datetime - Дата и время назначения точки интереса пользователю
СвязиРасширено значениями пользовательских полей через Места_текстовые_поля, places_decimal_fields, places_bigint_fields, Места_longtext_fields, Места_связанных_сущностей_поля
Особые примечанияcustom_fields JSONB обеспечивает быстрый доступ; связанные таблицы позволяют фильтровать и сортировать по пользовательским атрибутам
Зона_points **Описание**: Упорядоченные координаты вершин (поле number определяет последовательность), задающие границы полигона для сложных геозон, обеспечивающие точные географические границы за пределами простых круговых зон, используются с PostGIS ST\_MakePolygon для геометрических операций
АтрибутПодробности
Ключевые поля- zone_id - Идентификатор зоны, к которой привязана эта Форма
- number - Серийный номер
- latitude - Местоположение
- longitude - Местоположение
СвязиНесколько записей на zone_id определяют границы полигона; number поле определяет порядок вершин
Особые примечанияЗапрос с ORDER BY number для восстановления контура полигона; используйте вместе с PostGIS ST_MakePolygon для геометрических операций
Управление заданиями и рабочими процессами
задания **Описание**: Назначения работ с проверкой местоположения (latitude, longitude, radius), окнами времени (time\_from, time\_to), требованиями к длительности визита (stay\_duration\_minutes, arrival\_duration\_minutes), иерархической структурой через parent\_task\_id, а также Мониторинг статуса для Управление сотрудниками и операций по доставке
АтрибутПодробности
Ключевые поля- Задание_id - идентификатор сущности Задание
- user_id - Идентификатор сущности пользователя
- object_id - Объект идентификатора сущности
- parent_task_id - Идентификатор сущности родительского задания
- задание_label - Атрибут task_label таблицы Задания
- статус - Значение статуса атрибута status
- тип задания - тип задания, задание, маршрут или контрольная точка
- latitude - Атрибут широты таблицы Задания
- longitude - Атрибут долготы таблицы Задания
- radius - Размер геозоны в метрах
- arrival_datetime - Когда Трекер прибывает в область Задание. ИГНОРИРУЕТСЯ при создании/обновлении
- created_at - Атрибут created_at таблицы Задания
- status_change_datetime - Дата и время обновления задания
- time_from - Дата и время, связанные с атрибутом time_from
- time_to - Дата и время, связанные с атрибутом time_to
- stay_duration - Атрибут stay_duration таблицы заданий
- stay_duration_minutes - Продолжительность посещения. Время, которое мобильный сотрудник должен провести на месте выполнения задания, чтобы успешно завершить задание. Несколько посещений суммируются
- arrival_duration_minutes - Игнорировать случайные посещения короче указанной продолжительности. При расчете минимальной продолжительности посещения короче указанной продолжительности будут игнорироваться
- max_delay_minuts - Допустимое опоздание. Максимальное время, на которое сотрудник может опоздать. Любое Задание, выполненное в течение этого времени, будет помечено как "опоздавшее"
- is_stay_control_enabled - Атрибут is_stay_control_enabled таблицы Задания
- address - Атрибут address таблицы Задания
- описание - Атрибут Description таблицы Задания
- custom_fields - Атрибут custom_fields таблицы Задания
- external_id - Идентификатор внешней сущности
- order_sort - Атрибут order_sort таблицы Задания
- created_by - Источник созданного задания
СодержимоеПоддерживает иерархические задания через parent_task_id; временные окна, определяемые time_from/time_to; проверка Зоны по местоположению и радиусу
СвязиСсылки на формы (сбор данных), Задание_история (изменения статуса), объекты (назначенный Трекер)
Особые примечанияstay_duration и arrival_duration_minutes включить контроль соблюдения для заданий по доставке и обслуживанию
формы **Описание**: Настраиваемые формы сбора данных для захвата структурированной информации при выполнении Задания или мобильных Отметках в приложении, с полями и значениями, хранящимися в JSON, необязательной проверкой местоположения (is\_submission\_in\_zone) и обязательными требованиями к отправке, когда они прикреплены к Заданиям
АтрибутПодробности
Ключевые поля- Форма_id - Идентификатор сущности Форма
- Задание_id - Идентификатор Задание, к которому прикреплена эта Форма
- object_id - Объект идентификатора сущности
- Форма_метка - Пользовательская метка формы
- поля - Если true, форма может быть отправлена только в зоне задания
- значения - Карта с идентификаторами полей в качестве ключей и объектами field_value в качестве значений. Ключ, используемый для связывания поля и его соответствующего значения
- submitted_at - Дата последней отправки значений Форма
- submission_latitude - Местоположение, в котором значения Форма были отправлены в последний раз
- submission_longitude - Местоположение, в котором значения Форма были отправлены в последний раз
- submission_address - Местоположение, в котором значения Форма были отправлены в последний раз
- is_submission_in_zone - Если true, форма может быть отправлена только в зоне задания
- описание - Дата создания этой Форма (или прикрепления к Задание)
- created_at - Дата создания этой Форма (или прикрепления к Задание)
Содержимоеполя определяет структуру Форма (JSON); значения содержит отправленные данные (JSON)
СвязиСсылки на задания (связанное рабочее задание), объекты (отправитель), упоминается в чекины
Особые примечанияФлаг проверки местоположения is_submission_in_zone включает правила отправки Формы на основе Зоны
чекины **Описание**: Записи посещаемости и активности по местоположению, отправляемые через мобильное приложение, с отслеживанием запланированного и фактического времени прибытия (planned\_datetime vs actual\_datetime) с географическими координатами и измерениями точности местоположения (radius) для отчетности о пунктуальности
АтрибутПодробности
Ключевые поля- checkin_id - Идентификатор сущности Checkin
- employee_id - Идентификатор сущности сотрудника также является идентификатором Водители
- object_id - Устройство сотрудника
- Форма_id - Идентификатор сущности Форма
- user_id - Пользователь сотрудника
- planned_datetime - Время устройства на момент выполнения Отметки
- actual_datetime - Время сервера на момент обработки запроса/сообщения
- latitude - Местоположение, в котором были отправлены отметки
- longitude - Местоположение, в котором были отправлены отметки
- radius - Погрешность позиционирования в точке в метрах
- address - Адрес отметки
- комментарий - Атрибут comment таблицы checkins
СвязиСвязывает сотрудников с формами и местоположениями; отслеживает отклонение от запланированного графика
Особые примечанияРазница во времени между planned_datetime и actual_datetime обеспечивает отчетность по пунктуальности; радиус определяет допустимую погрешность местоположения
Задание_история **Описание**: Полная аудиторская запись событий жизненного цикла задания, фиксирующая все изменения статуса, назначения, обновления и изменения полей с временными метками (event\_datetime), привязкой к пользователю и типами активности (create, update, assign, status\_change), хранящимися в поле payload для обеспечения соответствия и анализа рабочих процессов
АтрибутПодробности
Ключевые поля- task_history_id - Идентификатор сущности истории задания
- Задание_id - идентификатор сущности Задание
- user_id - Идентификатор сущности пользователя
- активность - Операция, которая произошла. Может быть "create", "update", "assign" или "status_change"
- event_datetime - Дата и время события
- полезная нагрузка - Зависит от операции. Обычно содержит поля, которые были изменены во время операции
СодержимоеТипы активности, определенные в description_parameters; полезная нагрузка сохраняет данные, специфичные для события (text)
Особые примечанияНеобходимо для анализа завершения Задания, отчетности по переходам статусов и Мониторинга активности пользователей
Правила и автоматизация
правила **Описание**: Правила обнаружения событий с настраиваемыми условиями срабатывания (превышение скорости, нарушения в Зонах, пороги датчиков, время простоя), хранящимися в параметрах (JSONB), и настройками многоканальных уведомлений (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) для автоматического Мониторинга и оповещения на основе данных устройства и сервера
АтрибутПодробности
Ключевые поля- rule_id - Идентификатор сущности правила
- object_id - Объект идентификатора сущности
- client_id - Идентификатор сущности клиента
- event_type - Атрибут event_type таблицы rules
- event_label - Атрибут event_label таблицы правил
- группа событий - Атрибут event_group таблицы правил
- описание - атрибут Description таблицы правил
- параметры - Параметры события. Для получения более подробной информации о доступных параметрах см. Документация API Navixy.
- alert_email - Почта для уведомлений
- alert_sms - Номера телефонов для SMS-уведомлений
- alert_phone - Телефоны для голосовых вызовов
- is_push_enabled - Если true, push-уведомления доступны
- created_at - Атрибут created_at таблицы rules
- is_deleted - Атрибут is_deleted таблицы rules
- максимум - Лимиты, применяемые к различным правилам. Например, для правила времени простоя при работающем двигателе в минутах
- event_comment1 - Атрибут event_comment1 таблицы rules
- event_comment2 - Атрибут event_comment2 таблицы rules
СодержимоеПараметры правила (JSONB) определяют условия срабатывания; поддерживаются уведомления по email, SMS, телефону и push-уведомления
СвязиСвязи с объектами через rules2objects, зоны через rules2zones
Особые примечанияevent_type определяет конкретный сценарий мониторинга (превышение скорости, нарушение Зоны, порог датчика); максимум поле позволяет агрегировать события для оповещений по пороговым значениям
rules2objects **Описание**: Связь «многие-ко-многим», связывающая правила с отслеживаемыми Объектами с индивидуальной настройкой параметров для каждого Объекта через object\_params (JSONB), позволяющая задавать разные пороговые значения (например, ограничения скорости) для каждого транспортного средства или Актив в рамках одного и того же правила
АтрибутПодробности
Ключевые поля- rule_id - Идентификатор сущности правила
- object_id - Объект идентификатора сущности
- param_group_number - Атрибут param_group_number в таблице rules2objects
- объект_params - Атрибут object_params таблицы rules2objects
Содержимоеобъект_params (JSONB) позволяет настраивать правила для каждого Объект (например, разные ограничения скорости для каждого транспортного средства)
Особые примечанияСвязь многие ко многим позволяет одному правилу контролировать несколько объектов с разными параметрами
rules2zones **Описание**: связь многие-ко-многим, связывающая правила с геозонами, что позволяет одному правилу отслеживать события въезда/выезда в нескольких географических областях для сложных сценариев пространственного мониторинга
АтрибутПодробности
Ключевые поля- rule_id - Идентификатор сущности правила
- zone_id - Идентификатор сущности зоны
Особые примечанияОтношение многие-ко-многим позволяет осуществлять мониторинг нескольких зон для одного правила (например, оповещение при въезде в любую из нескольких запрещенных зон)
Статус и категоризация
статусы **Описание**: Определения пользовательских статусов в списках статусов, включая свойства отображения (цвет для отображения на сайте, order\_sort для позиционирования), используемые для представления состояний работы устройства или сотрудника с поддержкой мягкого удаления через флаг is\_deleted
АтрибутПодробности
Ключевые поля- status_id - Идентификатор сущности статуса
- listing_id - Идентификатор сущности списка
- status_label - Значение статуса атрибута status_label
- цвет - Цвет, используемый для отображения на сайте
- order_sort - Позиция сортировки внутри статуса списка
- is_deleted - Атрибут is_deleted таблицы statuses
СвязиГруппы статусов, организованные по listing_id (ссылается на status_listings); используется в status_history
Особые примечанияorder_sort задает последовательность отображения; цвет обеспечивает визуальное различение в отчетности
status_listings **Описание**: Определения наборов статусов, определяющие, какие значения статуса доступны для устройств или сотрудников, а флаги разрешений (is\_supervisor\_controlled, is\_employee\_controlled) определяют, могут ли руководители, сотрудники или и те и другие изменять значения статуса
АтрибутПодробности
Ключевые поля- status_listing_id - Идентификатор сущности списка статусов
- user_id - Идентификатор сущности пользователя
- status_listing_label - Значение статуса атрибута status_listing_label
- is_supervisor_controlled - Если true, руководители могут изменять рабочий статус, например, с помощью мобильного приложения для мониторинга
- is_employee_controlled - Если true, сотрудники могут изменять свой рабочий статус, например, с помощью мобильного приложения для мониторинга
- is_deleted - Атрибут is_deleted таблицы status_listings
СвязиНа него ссылаются devices.status_listing_id и statuses.listing_id
Особые примечанияФлаги управления определяют, кто может изменять статусы: только руководитель, сам сотрудник или оба
status_history **Описание**: Журнал аудита всех переходов статуса работы устройств (Статус работы устройств) с временными метками (changed\_datetime на устройстве, server\_datetime на сервере), указанием пользователя (updated\_by) и фиксацией местоположения (latitude, longitude, address), что позволяет проводить географический анализ изменений статуса и формировать отчеты о местоположении начала и окончания рабочего дня
АтрибутПодробности
Ключевые поля- status_history_id - Идентификатор сущности истории статусов
- device_id - Идентификатор сущности устройства
- old_status_id - Идентификатор сущности старого статуса
- new_status_id - Идентификатор сущности нового статуса
- updated_by - Дата и время, связанные с атрибутом updated_by
- changed_datetime - Дата и время назначения нового статуса на устройстве
- server_datetime - Дата и время назначения нового статуса сервера
- latitude - Определение местоположения устройств во время смены статуса
- longitude - Определение местоположения устройств во время смены статуса
- address - Определение местоположения устройств во время смены статуса
СвязиСсылки на устройства, статусы (старого и нового), description_parameters (для updated_by Роль)
Особые примечанияОпределение местоположения позволяет проводить географический анализ переходов статуса; полезно для отчетов о местоположении начала и окончания рабочего дня
Теги **Описание**: Пользовательские метки категоризации с цветовой кодировкой, которые позволяют быстро фильтровать и искать среди нескольких типов сущностей (Места, геозоны, сотрудники, Задания, трекеры, Транспорт) для гибкой организации
АтрибутПодробности
Ключевые поля- id_тега - Тег ID сущности
- user_id - Идентификатор сущности пользователя
- Тег_label - Атрибут tag_label таблицы Теги
- цвет - Атрибут color таблицы Теги
СвязиПрименяется к сущностям через ссылки_тегов; область, определенная пользователем
Особые примечанияГибкая система категоризации, поддерживающая несколько Теги на сущность
ссылки_тегов **Описание**: Таблица полиморфной связи, связывающая Теги с любым типом сущности через entity\_type и entity\_id, с полем ordinal для управления порядком отображения, обеспечивающая гибкое тегирование нескольких сущностей
АтрибутПодробности
Ключевые поля- id_тега - Тег ID сущности
- entity_type - Атрибут entity_type таблицы tag_links
- entity_id - Идентификатор сущности
- порядковый - Порядковый атрибут таблицы tag_links
Содержимоеentity_type идентифицирует таблицу (транспортное средство, сотрудник, Задание и т. д.); порядковый определяет порядок отображения
Особые примечанияПолиморфная связь позволяет назначать теги для различных типов сущностей
Группы и иерархия
группы **Описание**: Организационная структура группировки трекеров для визуальной организации в пользовательском интерфейсе с настраиваемыми цветами (group\_color) и иерархическим управлением по принципу папок; в настоящее время функция носит исключительно визуальный характер
АтрибутПодробности
Ключевые поля- group_id - Трекер Группа (связано объектами objects.group_id). Разделение на группы можно увидеть в списке маяков, например
- client_id - Идентификатор сущности клиента
- метка группы - Заголовок Группы, заданный пользователем, от 1 до 60 печатаемых символов, напр. "Сотрудники"
- group_color - Цвет Группа в веб-формате (без #), например "FF6DDC". Определяет цвет маркеров Трекер на карте
СвязиНа него ссылаются objects.group_id; владение клиентом через client_id (ссылается на пользователи)
Особые примечанияПозволяет организовать объекты мониторинга по принципу папок для отчетности и прав доступа
groups_objects **Описание**: связь многие-ко-многим между группами и объектами с использованием составного первичного ключа (groups\_client\_id, objects\_client\_id), позволяющая объектам одновременно принадлежать нескольким группам для гибких организационных структур
АтрибутПодробности
Ключевые поля- groups_client_id - Идентификатор клиентской сущности для групп
- objects_client_id - Идентификатор клиентской сущности для объектов
Особые примечанияПозволяет объектам одновременно принадлежать нескольким группам; запрос с обоими client_id значения для членства в группе
Настраиваемые поля и сущности
сущности **Описание**: реестр типов сущностей, определяющий, какие бизнес-сущности поддерживают Настраиваемые поля и структуру расположения полей (sections, field\_order), хранящуюся в entity\_label (JSONB), что позволяет динамически расширять схему, включая Места, Задания и другие сущности, без изменений в базе данных
АтрибутПодробности
Ключевые поля- entity_id - Идентификатор сущности
- user_id - Идентификатор сущности пользователя
- entity_label - id - int. Идентификатор сущности. type - enum. В настоящее время поддерживается только "Место". layout - Объект описывает структуру полей для сущности. sections - массив объектов. Каждый раздел может содержать одно или несколько полей. В layout должен существовать хотя бы один раздел. label - string. Название раздела. field_order - массив строк. Встроенные поля и ID настраиваемых полей (в виде строк)
- builtin_type - Атрибут builtin_type таблицы entities
СвязиНа него ссылаются custom_fields определить, какие Настраиваемые поля применяются к каким типам сущностей
Особые примечанияbuiltin_type ссылки на description_parameters для классификаций сущностей, определенных системой
custom_fields **Описание**: определения пользовательских полей, обеспечивающие динамическое расширение схемы для типов сущностей, с настраиваемыми типами полей (custom\_field\_type), правилами валидации и параметрами в parameters (JSONB), а также флагами обязательности (is\_required) для гибкого сбора данных по Места, Задания и другим сущностям
АтрибутПодробности
Ключевые поля- custom_field_id - Идентификатор сущности пользовательского поля
- entity_id - Идентификатор сущности
- custom_field_label - Название поля
- custom_field_type - Тип данных в поле
- описание - Описание поля
- is_required - Это обязательно или нет?
- параметры - Параметры поля
Содержимоепараметры (JSONB) хранит конфигурацию, специфичную для типа поля (правила валидации, варианты выпадающего списка и т. д.)
СвязиОпределяет доступные пользовательские атрибуты для объектов; тип поля ссылается на description_parameters
Особые примечанияОбеспечивает динамическое расширение схемы без изменений в базе данных; широко используется в места и задания
Исторический мониторинг
driver_history **Описание**: Полный журнал аудита назначений сотрудника на Транспорт во времени, Мониторинг переходов old\_employee\_id к new\_employee\_id с временными метками (changed\_datetime, server\_datetime), данными о местоположении (latitude, longitude, address), информацией о аппаратном ключе и атрибуцией пользователя (updated\_by), что позволяет выполнять аналитику, специфичную для Водитель, когда Водители переключаются между Транспорт
АтрибутПодробности
Ключевые поля- Водитель_history_id - Идентификатор сущности истории водителя
- object_id - Объект идентификатора сущности
- old_employee_id - Идентификатор сущности старого сотрудника
- new_employee_id - Идентификатор новой сущности сотрудника
- hardware_key - Атрибут hardware_key таблицы driver_history
- changed_datetime - Были внесены изменения даты и времени на устройстве
- server_datetime - Дата и время изменений, внесенных на сервере
- updated_by - Дата и время, связанные с атрибутом updated_by
- latitude - Атрибут широты таблицы driver_history
- longitude - Атрибут долготы таблицы driver_history
- address - Атрибут адреса таблицы driver_history
СвязиОтслеживает назначения Водитель на Транспорт со временем; связывает с сотрудники и объекты
Особые примечанияНеобходимо для отчетности по Водителям, когда Водители меняют Транспорт; сбор местоположения позволяет анализировать местоположение смены назначения
vehicle_trackers_history **Описание**: Мониторинг следа аудита, который показывает, какие GPS-объекты (object\_id) были установлены в какой Транспорт (vehicle\_id) со временем с отметками изменений (changed\_datetime), обеспечивая точную атрибуцию исторических данных и вычисление Пробег при перемещении трекеров между транспортными средствами
АтрибутПодробности
Ключевые поля- vehicle_tracker_history_id - Идентификатор сущности истории Трекер транспортного средства
- vehicle_id - Идентификатор сущности транспортного средства
- object_id - Объект идентификатора сущности
- changed_datetime - Дата и время, связанные с атрибутом changed_datetime
СвязиОтслеживает, какое GPS-устройство было установлено в каком транспортном средстве с течением времени
Особые примечанияКритически важно для анализа исторических данных, когда трекеры перемещаются между Транспортом; обеспечивает точное распределение Пробега и использования
Справочные и данные подстановки
description_parameters **Описание**: Системные справочные данные, предоставляющие человекочитаемые метки (описание) для перечисляемых целочисленных значений (ключ), используемых по всей базе данных. Данные структурированы по полю type (например, task\_status, fuel\_type, counter\_type, entity\_classification) для единообразного перевода значений в отчетности и при отображении в интерфейсе
АтрибутПодробности
Ключевые поля- ключ - Возможное значение в атрибуте
- тип - Составной атрибут, состоящий из имени таблицы, за которым следует знак подчеркивания и имя атрибута в таблице
- описание - Неявное значение атрибута
СодержимоеОбеспечивает человекочитаемые метки для закодированных значений во всей базе данных (статус задания, типы топлива, типы счетчиков и т. д.)
СвязиНа них ссылаются через внешние ключи из нескольких таблиц для стандартизированной категоризации
Особые примечанияНеобходимы для перевода целочисленных кодов в читаемые значения в отчетах; тип связанные с группами полей перечисления
счетчики **Описание**: конфигурации счетчиков одометра и моточасов, связывающие показания датчиков устройства (sensor\_id) с измерениями расстояния или времени с коэффициентами-множителями для преобразования единиц (km, miles, hours) и counter\_type из description\_parameters, определяющий тип измерения
АтрибутПодробности
Ключевые поля- counter_id - Внутренний ID
- device_id - Идентификатор сущности устройства
- counter_type - Тип счетчика
- sensor_id - Идентификатор сущности датчика
- multiplier - Коэффициент для преобразования значений в одну из метрик (km, l и т. д.)
СвязиСвязывает устройства с показаниями датчиков, которые представляют счетчики расстояния или времени
Особые примечанияmultiplier преобразует импульсы датчика в фактические единицы (km, miles, hours); counter_type из description_parameters определяет тип измерения
device_output_name **Описание**: Пользовательские метки для каналов вывода устройства, сопоставляющие числовые идентификаторы выходов (number) с заданными пользователем именами (label), такими как "Door Lock" или "Engine Block", для читаемой отчетности и анализа команд и состояний выходов устройства
АтрибутПодробности
Ключевые поля- device_id - Идентификатор сущности устройства
- number - Атрибут number таблицы device_output_name
- label - Атрибут label таблицы device_output_name
СодержимоеСопоставляет номера каналов вывода с заданными пользователем именами (например, "Door Lock", "Engine Block")
Особые примечанияОбеспечивает читаемую отчетность при анализе команд и состояний выходов устройства
device_settings **Описание**: Пары ключ-значение конфигурации устройства, синхронизированные из исходной платформы. Каждая строка хранит один параметр конфигурации для конкретного устройства.
АтрибутПодробности
Ключевые поля- device_id - Идентификатор сущности устройства
- ключ - Имя параметра
- value - Значение параметра
Первичный ключСоставной ключ: (device_id, key)
Особые примечанияЗаполняется во время полной синхронизации клиента. Используйте эту таблицу, чтобы читать значения конфигурации на уровне устройства вместе с телематическими или бизнес-данными.
event_description **Описание**: Справочная таблица кодов событий трекера с человекочитаемыми описаниями. Содержит 134 записи, охватывающие распространенные события трекера, такие как SOS, режим сна, зажигание и изменения цифровых входов/выходов.
АтрибутПодробности
Ключевые поля- event_id - Код события (primary key)
- описание - Человекочитаемое имя события
Особые примечанияСоедините с raw_telematics_data.tracking_data_core по event_id чтобы отображать названия событий в отчетах и на панелях мониторинга вместо числовых кодов.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/ru/iot-query/schema-overview/bronze-layer/raw-business-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.