Слой необработанных данных

Просмотрите исходные наборы данных для бизнес-сущностей, телеметрии устройств и активов/инвентаря, а также ключевые таблицы и время их обновления.

Слой Raw data содержит 3 различных схемы данных, каждая из которых обслуживает разные аспекты платформы телематики и бизнес-аналитики:

• raw_business_data - содержит таблицы, атрибуты и значения, связанные с бизнес-информацией, такими как транспортные средства, сотрудники, геозоны, добавленные пользователями, и т.д.

• raw_telematics_data - содержит таблицы, атрибуты и значения, связанные с телематическими данными, передаваемыми от устройств под мониторингом, такими как местоположения, входы, выходы и события.

• repo - содержит таблицы для управления активами и инвентарём, включая настраиваемые типы активов, пользовательские поля, связи между активами и геопространственные данные для отслеживания ресурсов организации.

Каждая схема оптимизирована для своей доменной области данных и шаблонов доступа, обеспечивая всестороннее покрытие потребностей в операционном, телематическом и управлении активами.

raw_business_data structure

Эта схема содержит более 40 тщательно отобранных таблиц для охвата различных бизнес-аспектов и вариантов использования. Эти таблицы представляют ваши основные бизнес-сущности, организационную структуру и операционные данные.

Интерактивная диаграмма схемы raw_business_data доступна на dbdiagram.io: https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a

Ниже приведены сведения о схеме raw_business_data.

Схема raw_business_data

Таблица "vehicle_service_tasks" {
  "record_added_at" timestamp [not null]
  "start_mileage" numeric
  "comment" "character varying(255)"
  "status" "character varying(10)" [not null]
  "completion_date" timestamp
  "start_engine_hours" numeric
  "service_task_id" integer [not null]
  "is_notification_push_enabled" boolean [not null]
  "date_notification_interval" interval
  "predicted_datetime" timestamp
  "cost" numeric [not null]
  "mileage_limit" numeric
  "notification_emails" text
  "is_unplanned" boolean [not null]
  "is_repeat" boolean [not null]
  "completion_engine_hours" integer
  "engine_hours_limit" numeric
  "mileage_repeat_interval" integer
  "vehicle_id" integer [not null]
  "engine_hours_notification_interval" integer
  "start_date" timestamp
  "mileage_notification_interval" integer
  "date_repeat_interval" interval
  "description" "character varying(255)"
  "notification_sms_phone_numbers" text
  "end_date" timestamp
  "engine_hours_repeat_interval" integer
  "completion_mileage" integer
}

Таблица "garages" {
  "record_added_at" timestamp [not null]
  "garage_id" integer [not null]
  "longitude" numeric
  "mechanic_name" "character varying(255)"
  "radius" integer [not null]
  "latitude" numeric
  "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" integer
  "longitude" numeric
  "latitude" numeric
  "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
}

Таблица "departments" {
  "record_added_at" timestamp [not null]
  "department_label" "character varying(255)" [not null]
  "latitude" numeric
  "department_id" integer [not null]
  "address" "character varying(255)"
  "radius" integer [not null]
  "longitude" numeric
  "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" integer [not null]
  "address" "character varying(255)"
  "planned_datetime" timestamp [not null]
  "object_id" integer [not null]
  "checkin_id" integer [not null]
  "comment" text
}

Таблица "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]
}

Таблица "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" text [not null]
  "field_id" integer [not null]
}

Таблица "users2zones" {
  "zone_id" integer [not null]
  "record_added_at" timestamp [not null]
  "user_id" integer [not null]
}

Таблица "objects" {
  "record_added_at" timestamp [not null]
  "create_datetime" timestamp [not null]
  "client_id" integer [not null]
  "group_id" integer
  "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]
}

Таблица "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]
}

Таблица "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]
  "description" text
  "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" integer [not null]
  "activity" integer [not null]
  "task_history_id" integer [not null]
  "record_added_at" timestamp [not null]
  "user_id" integer [not null]
  "event_datetime" timestamp [not null]
  "payload" text
}

Таблица "tags" {
  "tag_label" "character varying(64)" [not null]
  "color" "character varying(6)"
  "user_id" integer [not null]
  "record_added_at" timestamp [not null]
  "tag_id" integer [not null]
}

Таблица "places" {
  "description" text
  "custom_fields" jsonb
  "place_id" integer [not null]
  "external_id" "character varying(32)"
  "record_added_at" timestamp [not null]
  "user_id" integer
  "latitude" numeric
  "radius" integer
  "place_label" "character varying(256)"
  "assigned_datetime" timestamp
  "address" "character varying(256)"
  "longitude" numeric
}

Таблица "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]
}

Таблица "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" integer [not null]
}

Таблица "groups" {
  "group_id" integer [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]
}

Таблица "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" integer [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
}

Таблица "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]
}

Таблица "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]
}

Таблица "vehicles" {
  "vehicle_id" integer [not null]
  "payload_length" numeric
  "vin" "character varying(20)"
  "free_insurance_policy_number" "character varying(50)"
  "vehicle_label" "character varying(100)"
  "payload_width" numeric
  "color" "character varying(6)"
  "trailer" "character varying(255)"
  "object_id" integer
  "vehicle_status_id" integer
  "liability_insurance_valid_till" timestamp
  "manufacture_year" integer
  "fuel_grade" "character varying(16)"
  "fuel_cost" numeric
  "fuel_tank_volume" numeric
  "model" "character varying(100)"
  "garage_id" integer
  "payload_height" numeric
  "max_speed" numeric
  "registration_number" "character varying(32)"
  "tyre_size" "character varying(50)"
  "passenger_capacity" integer
  "record_added_at" timestamp [not null]
  "trailer_reg_number" "character varying(32)"
  "free_insurance_valid_till_date" timestamp
  "gross_weight" numeric
  "standard_fuel_consumption" numeric
  "fuel_type" integer
  "payload_weight" numeric
  "additional_info" text
  "vehicle_subtype" "character varying(32)"
  "liability_insurance_policy_number" "character varying(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" integer [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" text [not null]
  "event_group" integer [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" numeric
  "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" numeric
  "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]
  "description" text
  "form_label" "character varying(255)" [not null]
  "fields" text
  "created_at" timestamp [not null]
  "submission_address" "character varying(255)"
  "submission_latitude" numeric
  "form_id" integer [not null]
  "submission_longitude" numeric
  "is_submission_in_zone" boolean [not null]
  "values" text
  "record_added_at" timestamp [not null]
  "task_id" integer
  "submitted_at" timestamp
}


Таблица "rules2objects" {
  "object_params" jsonb
  "param_group_number" integer [not null]
  "object_id" integer [not null]
  "record_added_at" timestamp [not null]
  "rule_id" integer [not null]
}

Таблица "tasks" {
  "time_from" timestamp
  "stay_duration_minutes" interval
  "external_id" "character varying(100)"
  "object_id" integer
  "task_type" integer
  "arrival_duration_minutes" interval
  "status" integer
  "arrival_datetime" timestamp
  "record_added_at" timestamp [not null]
  "task_id" integer [not null]
  "user_id" integer
  "status_change_datetime" timestamp
  "order_sort" integer
  "time_to" timestamp
  "max_delay_minuts" integer
  "is_stay_control_enabled" boolean
  "address" "character varying(255)"
  "task_label" "character varying(200)" [not null]
  "longitude" numeric
  "created_by" integer
  "description" text [not null]
  "radius" integer
  "latitude" numeric
  "stay_duration" integer
  "created_at" timestamp [not null]
  "custom_fields" jsonb
  "parent_task_id" integer
}

Таблица "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" integer [not 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]
}

Таблица "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" integer
  "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]
}

Таблица "employees" {
  "driver_license_valid_till" timestamp
  "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" integer
  "is_deleted" boolean [not null]
  "driver_license_issue_date" boolean
  "hardware_key" "character varying(64)"
  "middle_name" "character varying(100)"
  "address" "character varying(255)"
  "latitude" numeric
  "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" numeric
}

Таблица "places_longtext_fields" {
  "field_id" integer [not null]
  "value" text [not null]
  "record_added_at" timestamp [not null]
  "place_id" integer [not null]
}

Таблица "raw_device_data" {
  "device_id" integer
  "device_time" timestamp
  "created_at" timestamp
  "gps_fix_type" integer
  "longitude" integer
  "latitude" integer
  "altitude" integer
  "speed" integer
  "satellites" integer
  "hdop" integer
  "event_id" integer
  "inputs" jsonb
  "states" jsonb
}

Таблица "groups_objects" {
  "groups_client_id" integer
  "objects_client_id" integer

  Индексы {
    (groups_client_id, objects_client_id) [pk]
  }
}

Связь:"employees"."employee_id" < "checkins"."employee_id"

Связь:"objects"."object_id" < "checkins"."object_id"

Связь:"forms"."form_id" < "checkins"."form_id"

Связь:"sensor_description"."sensor_id" < "counters"."sensor_id"

Связь:"devices"."device_id" < "counters"."device_id"

Связь:"entities"."entity_id" < "custom_fields"."entity_id"

Связь:"departments"."department_id" < "employees"."department_id"

Связь:"users"."user_id" < "departments"."user_id"

Связь:"description_parameters"."key" < "counters"."counter_type"

Связь:"description_parameters"."key" < "custom_fields"."custom_field_type"

Связь:"description_parameters"."key" < "driver_history"."updated_by"

Связь:"description_parameters"."key" < "entities"."builtin_type"

Связь:"description_parameters"."key" < "sensor_description"."units_type"

Связь:"description_parameters"."key" < "status_history"."updated_by"

Связь:"description_parameters"."key" < "tasks"."status"

Связь:"description_parameters"."key" < "tasks"."created_at"

Связь:"description_parameters"."key" < "tasks"."task_type"

Связь:"description_parameters"."key" < "vehicles"."fuel_type"

Связь:"description_parameters"."key" < "task_history"."activity"

Связь:"description_parameters"."key" < "sensor_description"."group_type"

Связь:"devices"."device_id" < "device_output_name"."device_id"

Связь:"status_listings"."status_listing_id" < "devices"."status_listing_id"

Связь:"employees"."employee_id" < "driver_history"."new_employee_id"

Связь:"employees"."employee_id" < "driver_history"."old_employee_id"

Связь:"objects"."object_id" < "driver_history"."object_id"

Связь:"objects"."object_id" < "employees"."object_id"

Связь:"users"."user_id" < "employees"."user_id"

Связь:"users"."user_id" < "entities"."user_id"

Связь:"tasks"."task_id" < "forms"."task_id"

Связь:"objects"."object_id" < "forms"."object_id"

Связь:"objects"."object_id" < "tasks"."object_id"

Связь:"users"."user_id" < "garages"."user_id"

Связь:"groups"."client_id" < "groups_objects"."groups_client_id"

Связь:"objects"."client_id" < "groups_objects"."objects_client_id"

Связь:"models"."model" < "objects"."model"

Связь:"devices"."device_id" < "objects"."device_id"

Связь:"users"."user_id" < "places"."user_id"

Связь:"custom_fields"."custom_field_id" < "places_bigint_fields"."field_id"

Связь:"places"."place_id" < "places_bigint_fields"."place_id"

Связь:"custom_fields"."custom_field_id" < "places_decimal_fields"."field_id"

Связь:"places"."place_id" < "places_decimal_fields"."place_id"

Связь:"custom_fields"."custom_field_id" < "places_linked_entity_fields"."field_id"

Связь:"places"."place_id" < "places_linked_entity_fields"."place_id"

Связь:"custom_fields"."custom_field_id" < "places_longtext_fields"."field_id"

Связь:"places"."place_id" < "places_longtext_fields"."place_id"

Связь:"custom_fields"."custom_field_id" < "places_text_fields"."field_id"

Связь:"places"."place_id" < "places_text_fields"."place_id"

Связь:"rules"."rule_id" < "rules2zones"."rule_id"

Связь:"objects"."object_id" < "rules2objects"."object_id"

Связь:"rules"."rule_id" < "rules2objects"."object_id"

Связь:"zones"."zone_id" < "rules2zones"."zone_id"

Связь:"devices"."device_id" < "sensor_description"."device_id"

Связь:"statuses"."status_id" < "status_history"."new_status_id"

Связь:"statuses"."status_id" < "status_history"."old_status_id"

Связь:"devices"."device_id" < "status_history"."device_id"

Связь:"users"."user_id" < "status_listings"."user_id"

Связь:"status_listings"."status_listing_id" < "statuses"."listing_id"

Связь:"tags"."tag_id" < "tag_links"."tag_id"

Связь:"users"."user_id" < "tags"."user_id"

Связь:"tasks"."task_id" < "task_history"."task_id"

Связь:"users"."user_id" < "task_history"."user_id"

Связь:"tasks"."parent_task_id" < "tasks"."task_id"

Связь:"users"."user_id" < "tasks"."user_id"

Связь:"users"."master_id" < "users"."user_id"

Связь:"users"."user_id" < "users2zones"."user_id"

Связь:"zones"."zone_id" < "users2zones"."zone_id"

Связь:"vehicles"."vehicle_id" < "vehicle_service_tasks"."vehicle_id"

Связь:"objects"."object_id" < "vehicle_trackers_history"."object_id"

Ref:"vehicles"."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:"devices"."device_id" < "raw_device_data"."device_id"

Ref:"users"."user_id" < "devices"."owner_id"

Ref:"users"."user_id" < "objects"."client_id"

Частота обновления

Данные в этой схеме синхронизируются с основной БД. Обновления происходят инкрементально по мере изменений в исходной базе данных MySQL, как правило, менее чем через 5 минут после изменения в источнике.

description_parameters

Система включает справочные данные для стандартизации значений по всей базе данных:

Тип справочника	Описание	Примеры значений
Определения типов	Стандартные типы сущностей	vehicle_type: car, truck, bus
Коды статусов	Значения статусов задач и системы	tasks_status: unassigned, assigned, done
Определения единиц	Единицы измерения для датчиков	units_type: liter, gallon, celsius
Классификации сущностей	Категории бизнес-сущностей	entities_type: place, task, customer

Ключевые таблицы по категориям

Таблицы в raw_business_data схеме организованы по функциональным категориям для облегчения навигации. В таблице ниже приведены ключевые таблицы по их делевому назначению:

Основные бизнес-сущности

users

Описание: Учетные записи пользователей, содержащие информацию профиля, принадлежность к компании, настройки локализации (часовой пояс, локаль) и иерархические связи через master_id для многоуровневых структур аккаунтов

Атрибут	Детали
Ключевые поля	- user_id - Уникальный идентификатор пользователя - company_label - Название компании, связанной с пользователем - first_name - Имя пользователя - last_name - Фамилия пользователя - middle_name - Отчество пользователя - locale - Настройки языка пользователя - timezone_label - Часовой пояс в формате IANA - master_id - Идентификатор основного пользователя (если текущий является подчиненным) - registration_datetime - Дата регистрации в системе - birth_date - Дата рождения пользователя
Связи	Родительский пользователь через master_id, связанный с employees, departments, places, tasks через user_id
Особые замечания	Центральная сущность, связывающая организационные данные; master_id обеспечивает иерархии пользователей для многоуровневых структур аккаунтов

employees

Описание: Записи сотрудников и водителей, используемые для представления людей, работающих в организации, включая личную информацию, данные о правах, назначения в отделы, аппаратные ключи для идентификации 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_number - Номер водительского удостоверения - driver_license_categories - Категории водительского удостоверения - driver_license_issue_date - Дата выдачи водительского удостоверения - driver_license_valid_till - Дата истечения срока действия водительского удостоверения - hardware_key - Аппаратный ключ - email - Электронная почта сотрудника - phone_number - Телефон сотрудника без знака "+" - address - Адрес местоположения - personnel_number - Табельный/персональный номер сотрудника/водителя - citizen_id_number - Номер социального страхования - latitude - Местоположение, связанное с этим сотрудником - longitude - Местоположение, связанное с этим сотрудником - radius - Местоположение, связанное с этим сотрудником в метрах - fuel_consumption - Атрибут fuel_consumption таблицы employees - fuel_cost - Атрибут fuel_cost таблицы employees - is_deleted - Атрибут is_deleted таблицы employees
Связи	Связи с users, departments, objects (назначенный трекер), отслеживается в driver_history и checkins
Особые замечания	Аппаратный ключ обеспечивает идентификацию водителя через iButton или RFID; поддерживает геозоны с latitude, longitude, radius поля

departments

Описание: Организационные подразделения с данными геолокации (широта, долгота, радиус), обеспечивающие аналитику на основе геозон для отчетности по отделам и связывания местоположения сотрудников

Атрибут	Детали
Ключевые поля	- department_id - Идентификатор сущности отдела - user_id - Идентификатор сущности пользователя - department_label - Атрибут department_label таблицы departments - latitude - Местоположение, связанное с этим отделом - longitude - Местоположение, связанное с этим отделом - radius - Размер геолокации в метрах - address - Атрибут address таблицы departments
Связи	Связывает сотрудников с организационной структурой через department_id
Особые замечания	Поля местоположения поддерживают аналитику на основе геозон для отчетности по отделам

Отслеживание и мониторинг

devices

Описание: Реестр физических трекинговых устройств с аппаратными идентификаторами (IMEI), информацией о SIM-карте, статусом сетевого подключения (уровень сигнала, роуминг, оператор) и назначениями статусов для управления жизненным циклом устройства

Атрибут	Детали
Ключевые поля	- device_id - Идентификатор устройства - owner_id - Идентификатор владельца устройства в аккаунте, в котором был добавлен маяк - device_imei - IMEI устройства - phone - Номер SIM-карты устройства - status_listing_id - Идентификатор статуса устройства - network_label - Название сети, к которой подключена SIM-карта - signal_level - Уровень сигнала устройства - has_roaming - Флаг доступности роуминга - is_sim_blocked - Флаг блокировки SIM-карты - created_at - Дата и время создания записи
Связи	Основная сущность, связывающая с objects, models, sensor_description, counters; owner_id references users.user_id
Особые замечания	Вся телематическая информация в raw_telematics_data схеме ссылается на эту таблицу через device_id

objects

Описание: Центральный реестр контролируемых объектов (транспортные средства, активы, персонал), связывающий физические устройства с организационной структурой через client_id и group_id, представляющий "отслеживаемую единицу" с одним активным объектом на устройство

Атрибут	Детали
Ключевые поля	- object_id - Идентификатор сущности объекта - client_id - Идентификатор сущности клиента - device_id - Идентификатор сущности устройства - object_label - Название объекта - model - Модель устройства - group_id - Идентификатор группы сущностей - create_datetime - Дата и время создания новой строки на сервере - is_deleted - Атрибут is_deleted таблицы objects - is_clone - Признак клона
Связи	Центральный узел, связывающий устройства с пользователями (client_id), деталями транспортного средства, историей трекинга, задачами и правилами
Особые замечания	Представляет "отслеживаемую единицу" в системе; по одному объекту на устройство в активном использовании

models

Описание: Центральный реестр контролируемых объектов (транспортные средства, активы, персонал), связывающий физические устройства с организационной структурой через client_id и group_id, представляющий "отслеживаемую единицу" с одним активным объектом на устройство

Атрибут	Детали
Ключевые поля	- model_id - Идентификатор модели сущности - model - Атрибут 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

Описание: Всесторонняя конфигурация датчиков, связывающая входы устройства с бизнес-логикой, включая отображения входов, единицы измерения, коэффициенты преобразования (множитель/делитель), таблицы калибровки для датчиков топлива, пороги точности и логику группировки для агрегированных показаний датчиков

Атрибут	Детали
Ключевые поля	- sensor_id - Идентификатор сущности датчика - device_id - Идентификатор сущности устройства - sensor_label - Название датчика для интерфейса - 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. Это требуется для агрегированных датчиков. Используется в измерительных датчиках - group_type - 0 — суммировать значения датчиков в группе, 1 — усреднять - sensor_units - Название единицы, введённое пользователем, если units_type=0 (пользовательская) - parameters - Дополнительный объект с параметрами 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 matching
Особые замечания	calibration_data (JSONB) хранит специфические для датчика таблицы калибровки для датчиков уровня топлива; multiplier и divider преобразовывать необработанные значения в единицы

Управление активами

vehicles

Описание: Всесторонний реестр транспортных средств, содержащий спецификации (габариты, вес, грузоподъёмность), документацию (VIN, регистрация, страховка), эксплуатационные параметры (расход топлива, объём бака) и текущее назначение трекера через object_id для управления парком и отслеживания соответствия требованиям

Атрибут	Детали
Ключевые поля	- vehicle_id - Идентификатор сущности транспортного средства - user_id - Идентификатор сущности пользователя - object_id - Идентификатор сущности объекта - garage_id - Идентификатор сущности гаража - vehicle_label - Атрибут vehicle_label таблицы vehicles - registration_number - Регистрационный номер/номерной знак транспортного средства - vin - Атрибут vin таблицы vehicles - manufacture_year - Атрибут manufacture_year таблицы vehicles - fuel_type - Атрибут fuel_type таблицы vehicles - fuel_cost - Атрибут fuel_cost таблицы vehicles - fuel_tank_volume - Атрибут fuel_tank_volume таблицы vehicles - max_speed - Атрибут max_speed таблицы vehicles - model - Атрибут model таблицы vehicles - color - Атрибут color таблицы vehicles - trailer - Атрибут trailer таблицы vehicles - additional_info - Атрибут additional_info таблицы vehicles - vehicle_type - Атрибут vehicle_type таблицы vehicles - vehicle_subtype - Атрибут vehicle_subtype таблицы vehicles - vehicle_status_id - Идентификатор статуса транспортного средства - chassis_number - Атрибут chassis_number таблицы vehicles - frame_number - Атрибут frame_number таблицы vehicles - trailer_reg_number - Атрибут trailer_reg_number таблицы vehicles - payload_weight - Атрибут payload_weight таблицы vehicles - payload_height - Атрибут payload_height таблицы vehicles - payload_length - Атрибут payload_length таблицы vehicles - payload_width - Атрибут payload_width таблицы vehicles - passenger_capacity - Максимальное количество пассажиров - gross_weight - Атрибут gross_weight таблицы vehicles - standard_fuel_consumption - Обычный средний расход топлива в литрах на 100 км - fuel_grade - Атрибут fuel_grade таблицы vehicles - wheel_arrangement - Атрибут wheel_arrangement таблицы vehicles - tyre_size - Размеры автомобиля: габариты и размер колёс - tyres_number - Количество колёс - liability_insurance_policy_number - Атрибут liability_insurance_policy_number таблицы vehicles - liability_insurance_valid_till - Дата, до которой действует гражданская страховка - free_insurance_policy_number - Атрибут free_insurance_policy_number таблицы vehicles - free_insurance_valid_till_date - Дата, до которой действует бесплатная страховка
Связи	Связи с objects (текущий трекер), garages (место обслуживания), vehicle_service_tasks; отслеживается в vehicle_trackers_history
Особые замечания	Поля физических размеров (payload_length, payload_width, payload_height, gross_weight) поддерживают аналитику планирования загрузки; даты страховки обеспечивают отслеживание соблюдения требований

garages

Описание: Места обслуживания и техобслуживания с географическими координатами (широта, долгота, радиус), контактной информацией для механиков и диспетчеров, обеспечивающие обнаружение посещений обслуживания на основе геозон и анализ близости

Атрибут	Детали
Ключевые поля	- garage_id - Идентификатор сущности гаража - user_id - Идентификатор сущности пользователя - latitude - Объект местоположения - longitude - Объект местоположения - radius - Размер геолокации в метрах - address - Объект местоположения - organization_label - Идентификатор депо - mechanic_name - Имя механика - dispatcher_name - Имя диспетчера
Связи	Ссылается vehicles.garage_id для назначения места обслуживания
Особые замечания	Поля местоположения позволяют обнаруживать посещения обслуживания на основе геозон и выполнять анализ близости

vehicle_service_tasks

Описание: Отслеживание графика обслуживания и истории с множеством типов триггеров (по дате, по пробегу, по моточасам), периодическими интервалами задач, многоканальными уведомлениями (email, SMS, push) и разделением запланированных (is_repeat) и незапланированных событий обслуживания

Атрибут	Детали
Ключевые поля	- service_task_id - Идентификатор сущности сервисной задачи - vehicle_id - Идентификатор сущности транспортного средства - description - Атрибут description таблицы vehicle_service_tasks - status - Значение атрибута status - cost - Атрибут cost таблицы vehicle_service_tasks - start_date - Дата и время, связанные с атрибутом start_date - end_date - Дата и время, связанные с атрибутом end_date - completion_date - Дата и время, связанные с атрибутом completion_date - predicted_datetime - Дата и время, связанные с атрибутом predicted_datetime - mileage_limit - Атрибут mileage_limit таблицы vehicle_service_tasks - engine_hours_limit - Атрибут engine_hours_limit таблицы vehicle_service_tasks - start_mileage - Атрибут start_mileage таблицы vehicle_service_tasks - start_engine_hours - Атрибут start_engine_hours таблицы vehicle_service_tasks - mileage_notification_interval - Атрибут mileage_notification_interval таблицы vehicle_service_tasks - engine_hours_notification_interval - Атрибут engine_hours_notification_interval таблицы vehicle_service_tasks - date_notification_interval - Преобразование целого N в N дней - mileage_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_mileage - Атрибут 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 - comment - Атрибут comment таблицы vehicle_service_tasks
Содержимое	Поддерживает три типа триггеров: по дате, по пробегу, по моточасам; настройки уведомлений для email, SMS, push
Особые замечания	is_repeat и поля интервалов позволяют задавать периодические графики обслуживания; is_unplanned различает плановое и реактивное обслуживание

Местоположение и маршрутизация

zones

Описание: Геозоны, определяющие виртуальные периметры с использованием кругов или полигонов для мониторинга событий въезда и выезда транспортного средства/актива, поддерживающие автоматизацию на основе правил и аналитику местоположения с цветовой маркировкой для визуального различения

Атрибут	Детали
Ключевые поля	- 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 - Атрибут color таблицы zones
Содержимое	Типы зон включают circle, polygon (определяется через geofence_points), и специальные классификации областей
Связи	Ссылается rules2zones, users2zones; вершины полигона хранятся в geofence_points
Особые замечания	Функции PostGIS можно использовать для проверки принадлежности точки многоугольнику для сложного анализа геозон

places

Описание: Точки интереса с географическими координатами, определением радиуса и расширяемой поддержкой пользовательских полей для хранения контактной информации клиентов и бизнес-данных, позволяя интеграцию с CRM/ERP через external_id и формирование отчетов на основе местоположения

Атрибут	Детали
Ключевые поля	- place_id - Идентификатор сущности place - user_id - Идентификатор сущности пользователя - place_label - Атрибут place_label таблицы places - latitude - Объект местоположения - longitude - Объект местоположения - radius - Размер геолокации в метрах - address - Атрибут address таблицы places - description - Атрибут description таблицы places - external_id - Идентификатор для интеграции с внешними системами (CRM) - custom_fields - Дополнительные поля - assigned_datetime - Дата и время назначения точки интереса пользователю
Связи	Расширяется значениями пользовательских полей через places_text_fields, places_decimal_fields, places_bigint_fields, places_longtext_fields, places_linked_entity_fields
Особые замечания	custom_fields JSONB обеспечивает быстрый доступ; связанные таблицы позволяют фильтровать и сортировать по пользовательским атрибутам

geofence_points

Описание: Упорядоченные координаты вершин (поле number определяет последовательность), задающие границы полигона для сложных форм геозон, позволяющие точные географические периметры в дополнение к простым круговым зонам, используются совместно с PostGIS ST_MakePolygon для геометрических операций

Атрибут	Детали
Ключевые поля	- zone_id - ID зоны, к которой прикреплена эта форма - number - Порядковый номер - latitude - Местоположение - longitude - Местоположение
Связи	Несколько записей для zone_id определяют границы полигона; number поле определяет порядок вершин
Особые замечания	Запрос с ORDER BY number для восстановления пути полигона; используйте совместно с PostGIS ST_MakePolygon для геометрических операций

Управление задачами и рабочими процессами

tasks

Описание: Назначения заказов на работу с проверкой местоположения (latitude, longitude, radius), временными окнами (time_from, time_to), требованиями по продолжительности визита (stay_duration_minutes, arrival_duration_minutes), иерархической структурой через parent_task_id и отслеживанием статуса для управления полевыми сервисами и доставкой

Атрибут	Детали
Ключевые поля	- task_id - Идентификатор сущности task - user_id - Идентификатор сущности пользователя - object_id - Идентификатор сущности объекта - parent_task_id - Идентификатор родительской задачи - task_label - Атрибут task_label таблицы tasks - status - Значение атрибута status - task_type - Тип задачи: task, route или checkpoint - latitude - Атрибут latitude таблицы tasks - longitude - Атрибут longitude таблицы tasks - radius - Размер геолокации в метрах - arrival_datetime - Когда трекер прибывает в область задачи. ИГНОРИРУЕТСЯ при создании/обновлении - created_at - Атрибут created_at таблицы tasks - status_change_datetime - Дата и время обновления задачи - time_from - Дата и время, связанные с атрибутом time_from - time_to - Дата и время, связанные с атрибутом time_to - stay_duration - Атрибут stay_duration таблицы tasks - stay_duration_minutes - Продолжительность визита. Время, которое мобильный сотрудник должен провести на месте назначения, чтобы успешно завершить задачу. Несколько визитов суммируются - arrival_duration_minutes - Игнорировать случайные визиты короче указанной длительности. При расчете минимальной продолжительности визиты короче указанной будут игнорированы - max_delay_minuts - Допустимая опоздание. Максимальное время, на которое сотрудник может опоздать. Любая задача, завершенная в этот период, будет помечена как «опоздавшая» - is_stay_control_enabled - Атрибут is_stay_control_enabled таблицы tasks - address - Атрибут address таблицы tasks - description - Атрибут description таблицы tasks - custom_fields - Атрибут custom_fields таблицы tasks - external_id - Идентификатор внешней сущности - order_sort - Атрибут order_sort таблицы tasks - created_by - Источник созданной задачи
Содержимое	Поддерживает иерархические задачи через parent_task_id; временные окна, определяемые через time_from/time_to; проверка геозоны с местоположением и радиусом
Связи	Связи с forms (сбор данных), task_history (изменения статуса), objects (назначенный трекер)
Особые замечания	stay_duration и arrival_duration_minutes включают мониторинг соответствия для задач доставки и сервиса

forms

Описание: Конфигурируемые формы сбора данных для фиксации структурированной информации при выполнении задачи или при отметках в мобильном приложении, с полями и значениями, хранящимися в формате JSON, опционной проверкой местоположения (is_submission_in_zone) и обязательными требованиями к отправке при прикреплении к задачам

Атрибут	Детали
Ключевые поля	- form_id - Идентификатор сущности form - task_id - ID задачи, к которой прикреплена эта форма - object_id - Идентификатор сущности объекта - form_label - Метка формы, заданная пользователем - поля - Если true, форма может быть отправлена только в зоне задачи - values - Отображение с ID полей в качестве ключей и объектами field_value в качестве значений. Ключ используется для связывания поля и его соответствующего значения - submitted_at - Дата последней отправки значений формы - submission_latitude - Местоположение, в котором значения формы были отправлены в последний раз - submission_longitude - Местоположение, в котором значения формы были отправлены в последний раз - submission_address - Местоположение, в котором значения формы были отправлены в последний раз - is_submission_in_zone - Если true, форма может быть отправлена только в зоне задачи - description - Дата создания этой формы (или прикрепления к задаче) - created_at - Дата создания этой формы (или прикрепления к задаче)
Содержимое	поля определяет структуру формы (JSON); values содержит отправленные данные (JSON)
Связи	Связи с tasks (связанный work order), objects (отправитель), ссылается в checkins
Особые замечания	Флаг проверки местоположения is_submission_in_zone включает правила отправки форм на основе геозон

checkins

Описание: Записи о посещениях и активности на основе местоположения, отправляемые через мобильное приложение, отслеживающие запланированное и фактическое время прибытия (planned_datetime vs actual_datetime) с географическими координатами и измерениями точности местоположения (radius) для отчетности по пунктуальности

Атрибут	Детали
Ключевые поля	- checkin_id - Идентификатор сущности checkin - employee_id - Идентификатор сущности сотрудника, также является идентификатором водителей - object_id - Устройство сотрудника - form_id - Идентификатор сущности form - user_id - Пользователь-сотрудник - planned_datetime - Время устройства, когда был выполнен чек-ин - actual_datetime - Время сервера, когда запрос/сообщение было обработано - latitude - Местоположение, в котором были отправлены чек-ины - longitude - Местоположение, в котором были отправлены чек-ины - radius - Ошибка позиционирования в метрах - address - Адрес чек-ина - comment - Атрибут comment таблицы checkins
Связи	Соединяет сотрудников с формами и местоположениями; отслеживает отклонения от запланированного расписания
Особые замечания	Временное отклонение между planned_datetime и actual_datetime позволяет формировать отчеты о пунктуальности; радиус определяет допустимую погрешность местоположения

task_history

Описание: Полный аудиторский след событий жизненного цикла задачи, фиксирующий все изменения статусов, назначения, обновления и модификации полей с отметками времени (event_datetime), указанием пользователя и типами активности (create, update, assign, status_change), хранящимися в поле payload для целей соответствия и анализа рабочих процессов

Атрибут	Детали
Ключевые поля	- task_history_id - Идентификатор сущности истории задач - task_id - Идентификатор сущности task - user_id - Идентификатор сущности пользователя - activity - Операция, которая произошла. Может быть "create", "update", "assign" или "status_change" - event_datetime - Дата и время события - payload - Зависит от операции. Обычно содержит поля, которые были изменены в ходе операции
Содержимое	Типы активности определены в description_parameters; payload содержит детали, специфичные для события (текст)
Особые замечания	Необходимо для анализа выполнения задач, отчетности по переходам статусов и отслеживания активности пользователей

Правила и автоматизация

rules

Описание: Правила обнаружения событий с настраиваемыми условиями срабатывания (превышение скорости, нарушения геозоны, пороги датчиков, время простоя), хранящиеся в parameters (JSONB), и мультиканальными настройками уведомлений (alert_email, alert_sms, alert_phone, is_push_enabled) для автоматического мониторинга и оповещений на основе данных устройства и сервера

Атрибут	Детали
Ключевые поля	- rule_id - Идентификатор сущности rule - object_id - Идентификатор сущности объекта - client_id - Идентификатор сущности клиента - event_type - Атрибут event_type таблицы rules - event_label - Атрибут event_label таблицы rules - event_group - Атрибут event_group таблицы rules - description - Атрибут description таблицы rules - parameters - Параметры события. Для более подробной информации о доступных параметрах смотрите Navixy API docs. - alert_email - Почта для уведомлений - alert_sms - Телефоны для SMS-уведомлений - alert_phone - Телефоны для голосовых звонков - is_push_enabled - Если true, доступны push-уведомления - created_at - Атрибут created_at таблицы rules - is_deleted - Атрибут is_deleted таблицы rules - maximum - Ограничения, применяемые к различным правилам. Например, для правила времени простоя с работающим двигателем в минутах - event_comment1 - Атрибут event_comment1 таблицы rules - event_comment2 - Атрибут event_comment2 таблицы rules
Содержимое	Параметры правила (JSONB) определяют условия срабатывания; поддерживаются уведомления по email, SMS, телефону и push
Связи	Связи с объектами через rules2objects, зоны через rules2zones
Особые замечания	event_type определяет конкретный сценарий мониторинга (превышение скорости, нарушение геозоны, порог датчика); maximum поле позволяет агрегировать события для оповещений на основе порогов

rules2objects

Описание: Отношение «многие ко многим», связывающее правила с мониторируемыми объектами с возможностью настройки параметров для каждого объекта через object_params (JSONB), позволяя задать различные пороговые значения (например, скоростные лимиты) для каждого транспортного средства или актива в рамках одного правила

Атрибут	Детали
Ключевые поля	- rule_id - Идентификатор сущности rule - object_id - Идентификатор сущности объекта - param_group_number - Атрибут param_group_number таблицы rules2objects - object_params - Атрибут object_params таблицы rules2objects
Содержимое	object_params (JSONB) позволяет настраивать правило для каждого объекта (например, разные скоростные лимиты для разных транспортных средств)
Особые замечания	Отношение «многие ко многим» позволяет одному правилу мониторить несколько объектов с разными параметрами

rules2zones

Описание: Отношение «многие ко многим», связывающее правила с геозонами, что позволяет одному правилу отслеживать события входа/выхода в нескольких географических областях для сложных сценариев пространственного мониторинга

Атрибут	Детали
Ключевые поля	- rule_id - Идентификатор сущности rule - zone_id - Идентификатор сущности зоны
Особые замечания	Отношение «многие ко многим» позволяет мониторить несколько зон для одного правила (например, оповестить при входе в любую из нескольких запрещенных зон)

Статус и категоризация

statuses

Описание: Пользовательские определения статусов в списках статусов, включая свойства отображения (color для отображения на сайте, order_sort для позиционирования), используемые для представления состояний устройства или сотрудника с поддержкой мягкого удаления через флаг is_deleted

Атрибут	Детали
Ключевые поля	- status_id - Идентификатор сущности status - listing_id - Идентификатор сущности listing - status_label - Значение атрибута status_label - color - Цвет, используемый для отображения на сайте - 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 - Определение местоположения устройств при смене статусов
Связи	Связи с devices, statuses (старый и новый), description_parameters (для updated_by role)
Особые замечания	Фиксация местоположения позволяет проводить географический анализ переходов статусов; полезно для отчетности о местах начала/окончания рабочего дня

tags

Описание: Метки категоризации, задаваемые пользователем, с цветовой кодировкой, которые позволяют быстро фильтровать и искать по нескольким типам сущностей (places, geofences, employees, tasks, trackers, vehicles) для гибкой организации

Атрибут	Детали
Ключевые поля	- tag_id - Идентификатор сущности тега - user_id - Идентификатор сущности пользователя - tag_label - Атрибут tag_label таблицы tags - color - Атрибут color таблицы tags
Связи	Применяется к сущностям через tag_links; область действия определяется пользователем
Особые замечания	Гибкая система категоризации, поддерживающая несколько тегов на одну сущность

tag_links

Описание: Полиморфная таблица отношений, связывающая теги с любым типом сущности через entity_type и entity_id, с полем ordinal для управления порядком отображения, обеспечивая гибкую многосущностную маркировку

Атрибут	Детали
Ключевые поля	- tag_id - Идентификатор сущности тега - entity_type - Атрибут entity_type таблицы tag_links - entity_id - Идентификатор сущности - ordinal - Атрибут ordinal таблицы tag_links
Содержимое	entity_type идентифицирует таблицу (vehicle, employee, task и т.д.); ordinal определяет порядок отображения
Особые замечания	Полиморфная связь позволяет маркировать разные типы сущностей

Группы и иерархии

groups

Описание: Структура организационного группирования для трекеров, позволяющая визуальную организацию в пользовательском интерфейсе с настраиваемыми цветами (group_color) и иерархическим управлением, подобным папкам, в настоящее время выполняет чисто визуальную функцию

Атрибут	Детали
Ключевые поля	- group_id - Группа трекеров (связана через objects.group_id). Разделение на группы видно, например, в списке маячков - client_id - Идентификатор сущности клиента - group_label - Название группы, задаваемое пользователем, от 1 до 60 печатных символов, например "Employees" - group_color - Цвет группы в веб-формате (без #), например "FF6DDC". Определяет цвет маркеров трекеров на карте
Связи	Ссылается objects.group_id; право собственности клиента через client_id (ссылается на users)
Особые замечания	Позволяет организовывать сущности мониторинга в виде папок для отчетности и управления правами

groups_objects

Описание: Отношение «многие ко многим» между группами и объектами с использованием составного первичного ключа (groups_client_id, objects_client_id), позволяющее объектам одновременно принадлежать нескольким группам для гибкой организации

Атрибут	Детали
Ключевые поля	- groups_client_id - Идентификатор клиента для групп - objects_client_id - Идентификатор клиента для объектов
Особые замечания	Позволяет объектам одновременно принадлежать нескольким группам; запрос выполняется по обоим client_id значениям членства в группе

Пользовательские поля и сущности

entities

Описание: Реестр типов сущностей, определяющий, какие бизнес-сущности поддерживают пользовательские поля и структуру их расположения (sections, field_order), хранящуюся в entity_label (JSONB), позволяя динамическое расширение схемы для places, tasks и других сущностей без изменений в базе данных

Атрибут	Детали
Ключевые поля	- entity_id - Идентификатор сущности - user_id - Идентификатор сущности пользователя - entity_label - id - int. Идентификатор сущности. type - enum. В настоящее время поддерживается только "place". layout - объект, описывающий расположение полей для сущности. sections - массив объектов. Каждый раздел может содержать одно или несколько полей. В макете должен присутствовать как минимум один раздел. label - строка. Название раздела. field_order - массив строк. Встроенные поля и идентификаторы пользовательских полей (как строки) - builtin_type - Атрибут builtin_type таблицы entities
Связи	Ссылается custom_fields для определения, какие пользовательские поля применимы к каким типам сущностей
Особые замечания	builtin_type связан с description_parameters для системно определенных классификаций сущностей

custom_fields

Описание: Определения пользовательских полей, позволяющие динамически расширять схему для типов сущностей, с настраиваемыми типами полей (custom_field_type), правилами валидации и опциями в parameters (JSONB), а также флагами обязательности (is_required) для гибкого сбора данных по places, tasks и другим сущностям

Атрибут	Детали
Ключевые поля	- custom_field_id - Идентификатор сущности пользовательского поля - entity_id - Идентификатор сущности - custom_field_label - Название поля - custom_field_type - Тип данных в поле - description - Описание поля - is_required - Обязательно ли это поле? - parameters - Параметры поля
Содержимое	parameters (JSONB) хранит конфигурацию, специфичную для типа поля (правила валидации, варианты выпадающего списка и т.д.)
Связи	Определяет доступные пользовательские атрибуты для сущностей; тип поля связан с description_parameters
Особые замечания	Позволяет динамически расширять схему без изменений в базе данных; широко используется в places и tasks

Историческое отслеживание

driver_history

Описание: Полный аудиторский след назначений сотрудников на транспортные средства с течением времени, отслеживающий переходы от old_employee_id к new_employee_id с отметками времени (changed_datetime, server_datetime), данными о местоположении (latitude, longitude, address), информацией о аппаратных ключах и указанием пользователя (updated_by), что позволяет проводить аналитику, специфичную для водителей, когда они меняют транспортные средства

Атрибут	Детали
Ключевые поля	- driver_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 - Атрибут latitude таблицы driver_history - longitude - Атрибут longitude таблицы driver_history - address - Атрибут address таблицы driver_history
Связи	Отслеживает назначения водителей на транспортные средства с течением времени; связано с employees и objects
Особые замечания	Необходимо для отчетности по водителям при смене транспортных средств; фиксация местоположения позволяет анализировать место изменения назначения

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

Описание: Справочные данные системы, предоставляющие человекочитаемые метки (description) для перечисляемых целочисленных значений (key), используемых по всей базе данных, организованные по полю type (например, task_status, fuel_type, counter_type, entity_classification) для согласованного перевода значений в отчетах и интерфейсе

Атрибут	Детали
Ключевые поля	- key - Возможное значение атрибута - type - Составной атрибут, состоящий из имени таблицы, за которым следует нижнее подчеркивание и имя атрибута в таблице - description - Подразумеваемое значение атрибута
Содержимое	Предоставляет человекочитаемые метки для кодированных значений по всей базе данных (статус задачи, типы топлива, типы счетчиков и т.д.)
Связи	Ссылается через внешние ключи из нескольких таблиц для стандартизированной категоризации
Особые замечания	Необходимо для преобразования целочисленных кодов в читаемые значения в отчетах; type группы полей связанные перечисления

counters

Описание: Конфигурации одометра и счетчика моточасов, связывающие показания датчиков устройства (sensor_id) с измерениями расстояния или времени с коэффициентами умножения для преобразования единиц (км, мили, часы) и counter_type из description_parameters, определяющего тип измерения

Атрибут	Детали
Ключевые поля	- counter_id - Внутренний ID - device_id - Идентификатор сущности устройства - counter_type - Тип счетчика - sensor_id - Идентификатор сущности датчика - multiplier - Коэффициент для преобразования значений в одну из метрик (км, л и т.д.)
Связи	Связывает устройства с показаниями датчиков, представляющими счётчики расстояния или времени
Особые замечания	multiplier преобразует импульсы датчика в реальные единицы (км, мили, часы); counter_type from 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")
Особые замечания	Обеспечивает читаемые отчеты при анализе команд и состояний выходов устройства

raw_telematics_data structure

Схема raw_telematics_data содержит три основных типа таблиц, которые совместно обеспечивают всесторонние данные устройства.

ERD слоя Bronze для необработанных телематических данных

Интерактивная диаграмма схемы raw_telematics_data доступна на dbdiagram.io: https://dbdiagram.io/d/v1-schema-telematics-bd-67a0acef263d6cf9a0d8e750

Ниже приведены сведения о схеме raw telematics data.

Схема raw_telematics_data

Таблица tracking_data_core {

  device_id integer [primary key]

  device_time timestampz [primary key]

  platform_time timestampz

  record_added_at timestampz [default: `now()`]

  latitude integer

  longitude integer

  speed integer

  altitude integer

  satellites integer

  event_id integer

  gps_fix_type integer

  hdop integer

  

  indexes {(device_id, device_time)}

}

  

Таблица inputs {

  event_id integer [primary key]

  device_id integer [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  sensor_name text [primary key]

  value text

  indexes {(device_id, device_time)}

}

  

Таблица states {

  event_id integer [primary key]

  device_id serial [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  state_name text [primary key]

  value text

  indexes {(device_id, device_time)}

}

  

Ref: inputs.(device_id, device_time) > tracking_data_core.(device_id, device_time)

Ref: states.(device_id, device_time) > tracking_data_core.(device_id, device_time)

Ключевые таблицы по категориям

Каждая таблица служит определенной цели при фиксации разных аспектов информации об устройстве:

tracking_data_core

Назначение: Основные данные о местоположении и движении

Атрибут	Детали
Ключевые поля	device_id, device_time, platform_time, latitude, longitude, speed, altitude, satellites, hdop, event_id
Индексация	Оптимизировано с индексом на (device_id, device_time)
Особые замечания	Данные о местоположении (широта и долгота) используют целочисленный формат с точностью 10⁷ для оптимальной производительности TimescaleDB Скорость также хранится в целочисленном формате, поэтому её нужно делить на 100

inputs

Назначение: Показания датчиков от устройств

Атрибут	Детали
Ключевые поля	input_id, device_id, device_time, sensor_name, value
Содержимое	Аналоговые показания (уровень топлива, температура, напряжение), вычисляемые значения (обороты двигателя)
Связи	FROM raw_telematics_data.inputs AS i JOIN raw_business_data.sensor_description AS sd ON i.device_id = sd.device_id AND i.sensor_name = sd.input_label JOIN raw_telematics_data.tacking_data_core AS tdc ON i.device_id = tdc.device_id AND i.device_time = tdc.device_time

states

Назначение: Индикаторы состояния устройства и режимы работы

Атрибут	Детали
Ключевые поля	state_id, device_id, device_time, state_name, value
Содержимое	Индикаторы режимов работы (работа, простои, выключено), состояния компонентов (зажигание, двери)
Формат значения	Булевы значения (1/0) или специальные коды состояния

Данные в этой схеме поступают непосредственно от устройств с минимальной задержкой (как правило — секунды). Схема оптимизирована для временных рядов с использованием TimescaleDB для эффективного хранения и выборки.

Дополнительная информация

Валидация данных

База данных обеспечивает целостность данных посредством нескольких механизмов:

• CHECK ограничения проверяют, что значения находятся в допустимых пределах

• Внешние ключи обеспечивают согласованность связей между таблицами

• NOT NULL ограничения гарантируют, что обязательные поля всегда имеют значения

• Значения по умолчанию обеспечивают запасной вариант, когда данные не предоставлены явно

Оптимизация запросов

Таблицы организованы со специфическими стратегиями индексирования:

• Во всех таблицах присутствуют индексы по времени по record_added_at

• Колонки внешних ключей имеют выделенные индексы для ускорения объединений

• Часто используемые комбинации колонок имеют составные индексы

• TimescaleDB предоставляет специализированные индексы для запросов по временным рядам

repo структура данных

Эта схема в настоящее время находится в разработке. Если вы заинтересованы в раннем доступе или у вас есть вопросы по этой функциональности, пожалуйста, свяжитесь с [e-mail].

Схема repo схема предоставляет всестороннюю основу для управления организационными структурами, активами, устройствами и их отношениями в многопользовательских средах. Построенная на PostgreSQL 14+ с расширением ltree, схема поддерживает иерархические организации, определения пользовательских полей для любых типов сущностей, ролевой доступ с ограничениями на уровне объектов и полные журналы аудита с отслеживанием изменений на уровне полей. Все сущности могут быть расширены без модификации схемы, локализованы для международных развертываний и связаны через гибкие полиморфные отношения.

Схема решает сложные сценарии управления данными, включая иерархии активов автопарка на разных уровнях организации, многопользовательские SaaS-платформы, требующие изоляции данных, операции, требующие соответствия с подробными требованиями аудита, и системы, нуждающиеся в динамических моделях данных, адаптируемых через пользовательские поля вместо миграций базы данных.

Интерактивная диаграммаrepo схемы данных доступна на dbdiagram.io: https://dbdiagram.io/d/Navixy-Repo-data-schema-68ad788c1e7a611967a0930e

Найдите repo подробности схемы ниже.

repo data schema

// ============================================
// Новая схема DataHub - Путь клиента
// PostgreSQL 14+ с расширением ltree
// Версия: 2.0 (Концепция)
// ============================================

// ============================================
// БАЗОВЫЕ ТАБЛИЦЫ ССЫЛОЧНЫХ ДАННЫХ (иерархия ci_base)
// ============================================

Table ci_base {
  id uuid [primary key]
  code text [not null]
  title_en text [not null]
  order int
  is_system boolean [not null, default: false]
  discriminator text [not null]
  catalog_id uuid
  organization_id uuid
  parent_id uuid
  path ltree
  is_hierarchical boolean [default: false]
  extra jsonb
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  
  indexes {
    (parent_id) [name: 'idx_ci_parent']
    (path) [type: gist, name: 'idx_ci_path_gist']
    (catalog_id) [name: 'idx_ci_catalog']
    (organization_id) [name: 'idx_ci_org']
    (discriminator) [name: 'idx_ci_discriminator']
    (code) [unique, name: 'uq_ci_code_per_type']
    (organization_id, code) [unique, name: 'uq_ci_org_code']
  }
}

Table ci_module {
  id uuid [primary key]
}

Table ci_catalog_category {
  id uuid [primary key]
}

Table ci_country {
  id uuid [primary key]
}

Table ci_role {
  id uuid [primary key]
}

Table ci_entity_type {
  id uuid [primary key]
}

Table ci_device_status {
  id uuid [primary key]
}

Table ci_permission_scope {
  id uuid [primary key]
  module_id uuid
  entity_type_id uuid
  category text
}

Table ci_device_type {
  id uuid [primary key]
}

Table ci_asset_type {
  id uuid [primary key]
  category_id uuid
}

Table ci_asset_type_category {
  id uuid [primary key]
}

Table ci_inventory_type {
  id uuid [primary key]
}

Table ci_organization_type {
  id uuid [primary key]
}

Table ci_user_type {
  id uuid [primary key]
}

Table ci_asset_group_type {
  id uuid [primary key]
  max_items int
  color text
  icon text
  allowed_asset_type_id uuid
}

Table ci_device_relation_type {
  id uuid [primary key]
}

Table ci_tag {
  id uuid [primary key]
  entity_type_id uuid
  color text
}

// ============================================
// БАЗОВАЯ СУЩНОСТЬ С ПОДДЕРЖКОЙ ПОЛЕЙ ПО УМОЛЧАНИЮ
// ============================================

Table customizable_entity {
  id uuid [primary key]
  entity_type_id uuid [not null]
  cf_data jsonb
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (entity_type_id) [name: 'idx_customizable_entity_type']
  }
}

// ============================================
// ОСНОВНЫЕ ДЕЛОВЫЕ СУЩНОСТИ
// ============================================

Table organization {
  id uuid [primary key]
  parent_id uuid
  path ltree
  organization_type_id uuid [not null]
  title_en text [not null]
  is_active boolean [not null, default: true]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (parent_id) [name: 'idx_org_parent']
    (path) [type: gist, name: 'idx_org_path_gist']
    (organization_type_id) [name: 'idx_org_type']
  }
}

Table catalog {
  id uuid [primary key]
  organization_id uuid [not null]
  module_id uuid
  category_id uuid
  title_en text [not null]
  is_system boolean [not null, default: false]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (organization_id) [name: 'idx_catalog_org']
    (module_id) [name: 'idx_catalog_module']
  }
}

Table user {
  id uuid [primary key]
  organization_id uuid [not null]
  user_type_id uuid [not null]
  identity_provider text [not null]
  identity_provider_id uuid [not null]
  full_name text [not null]
  is_active boolean [not null, default: true]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_user_org']
    (user_type_id) [name: 'idx_user_type']
    (organization_id, identity_provider, identity_provider_id) [unique, name: 'uq_user_org_idp']
  }
}

// ============================================
// УПРАВЛЕНИЕ ДОСТУПОМ (ACL)
// ============================================

Table user_role {
  id uuid [primary key]
  user_id uuid [not null]
  role_id uuid [not null]
  assigned_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  assigned_by uuid
  
  indexes {
    (user_id) [name: 'idx_user_role_user']
    (role_id) [name: 'idx_user_role_role']
    (user_id, role_id) [unique, name: 'uq_user_role']
  }
}

Table acl_role_permission {
  id uuid [primary key]
  role_id uuid [not null]
  permission_scope_id uuid [not null]
  target_entity_id uuid
  actions int [not null]
  granted_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  granted_by uuid
  
  indexes {
    (role_id) [name: 'idx_acl_role_perm_role']
    (permission_scope_id) [name: 'idx_acl_role_perm_scope']
    (role_id, permission_scope_id, target_entity_id) [unique, name: 'uq_acl_role_permission']
  }
}

Table acl_user_scope {
  id uuid [primary key]
  user_id uuid [not null]
  permission_scope_id uuid [not null]
  target_entity_id uuid [not null]
  actions int [not null]
  
  indexes {
    (user_id, permission_scope_id) [name: 'idx_acl_user_scope_user']
    (user_id, permission_scope_id, target_entity_id) [unique, name: 'uq_acl_user_scope']
  }
}

// ============================================
// ДЕЛОВЫЕ СУЩНОСТИ
// ============================================

Table asset {
  id uuid [primary key]
  organization_id uuid [not null]
  asset_type_id uuid [not null]
  label text [not null]
  description text
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_asset_org']
    (asset_type_id) [name: 'idx_asset_type']
  }
}

Table inventory {
  id uuid [primary key]
  organization_id uuid [not null]
  inventory_type_id uuid [not null]
  code text [not null]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_inventory_org']
    (inventory_type_id) [name: 'idx_inventory_type']
    (organization_id, code) [unique, name: 'uq_inventory_org_code']
  }
}

Table device {
  id uuid [primary key]
  organization_id uuid [not null]
  device_type_id uuid [not null]
  status_id uuid [not null]
  hw_id text
  label text [not null]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_device_org']
    (device_type_id) [name: 'idx_device_type']
    (status_id) [name: 'idx_device_status']
    (hw_id) [name: 'idx_device_hw_id']
  }
}

Table device_asset_link {
  id uuid [primary key]
  device_id uuid [unique, not null]
  asset_id uuid [not null]
  linked_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  linked_by uuid
  
  indexes {
    (device_id) [unique, name: 'idx_device_asset_link_device']
    (asset_id) [name: 'idx_device_asset_link_asset']
  }
}

Table device_inventory_link {
  id uuid [primary key]
  device_id uuid [unique, not null]
  inventory_id uuid [not null]
  linked_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  linked_by uuid
  
  indexes {
    (device_id) [unique, name: 'idx_device_inventory_link_device']
    (inventory_id) [name: 'idx_device_inventory_link_inventory']
  }
}

Table device_relation {
  id uuid [primary key]
  master_id uuid [not null]
  slave_id uuid [not null]
  relation_type_id uuid [not null]
  
  indexes {
    (master_id) [name: 'idx_device_relation_master']
    (slave_id) [name: 'idx_device_relation_slave']
    (master_id, slave_id, relation_type_id) [unique, name: 'uq_device_relation']
  }
}

Table asset_group {
  id uuid [primary key]
  organization_id uuid [not null]
  group_type_id uuid [not null]
  title_en text [not null]
  description text
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_asset_group_org']
    (group_type_id) [name: 'idx_asset_group_type']
  }
}

Table asset_group_item {
  id uuid [primary key]
  group_id uuid [not null]
  asset_id uuid [not null]
  attached_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  detached_at timestamptz
  
  indexes {
    (group_id) [name: 'idx_asset_group_item_group']
    (asset_id) [name: 'idx_asset_group_item_asset']
    (group_id, asset_id, detached_at) [unique, name: 'uq_asset_group_item']
  }
}

Table entity_tag {
  id uuid [primary key]
  tag_id uuid [not null]
  entity_id uuid [not null]
  tagged_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (tag_id) [name: 'idx_entity_tag_tag']
    (entity_id) [name: 'idx_entity_tag_entity']
    (tag_id, entity_id) [unique, name: 'uq_entity_tag']
  }
}

// ============================================
// ЛОКАЛИЗАЦИЯ
// ============================================

Table i18n_text {
  entity_id uuid [pk]
  field_code text [pk]
  locale text [pk]
  text_value text [not null]
  
  indexes {
    (entity_id) [name: 'idx_i18n_entity']
    (locale) [name: 'idx_i18n_locale']
  }
}

// ============================================
// ОПРЕДЕЛЕНИЯ ПОЛЕЙ (CUSTOM FIELDS)
// ============================================

Table custom_field_def {
  id uuid [primary key]
  organization_id uuid [not null]
  owner_entity_type_id uuid [not null]
  code text [not null]
  title_en text [not null]
  field_type text [not null]
  is_multi boolean [not null, default: false]
  is_required boolean [not null, default: false]
  order int
  ref_entity_type_id uuid
  ref_catalog_id uuid
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (organization_id) [name: 'idx_cfd_org']
    (owner_entity_type_id) [name: 'idx_cfd_owner_type']
    (organization_id, owner_entity_type_id, code) [unique, name: 'uq_cfd_org_type_code']
  }
}

// ============================================
// ЗНАЧЕНИЯ ПОЛЕЙ (ПО ТИПУ)
// ============================================

Table custom_field_value_text {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value text [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_text_value']
  }
}

Table custom_field_value_number {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value numeric [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_number_value']
  }
}

Table custom_field_value_boolean {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value boolean [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_boolean_value']
  }
}

Table custom_field_value_date {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value date [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_date_value']
  }
}

Table custom_field_value_datetime {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value timestamptz [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_datetime_value']
  }
}

Table custom_field_value_entity {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  ref_entity_id uuid [not null]
  
  indexes {
    (field_def_id, ref_entity_id) [name: 'idx_cfv_entity_value']
  }
}

Table custom_field_value_catalog {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  ref_item_id uuid [not null]
  
  indexes {
    (field_def_id, ref_item_id) [name: 'idx_cfv_catalog_value']
  }
}

// ============================================
// АУДИТ
// ============================================

Table audit_event {
  id uuid [primary key]
  event_category text [not null]
  user_id uuid
  identity_provider_id uuid
  ip_address inet
  user_agent text
  aggregate_type text
  aggregate_id uuid
  event_type text [not null]
  event_data jsonb
  occurred_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (user_id, occurred_at) [name: 'idx_audit_event_user']
    (aggregate_type, aggregate_id, occurred_at) [name: 'idx_audit_event_aggregate']
    (event_category, occurred_at) [name: 'idx_audit_event_category']
    (event_type, occurred_at) [name: 'idx_audit_event_type']
  }
}

// ============================================
// ОТНОШЕНИЯ
// ============================================

Ref: ci_base.catalog_id > catalog.id
Ref: ci_base.organization_id > organization.id
Ref: ci_base.parent_id > ci_base.id

Ref: ci_module.id - ci_base.id
Ref: ci_catalog_category.id - ci_base.id
Ref: ci_country.id - ci_base.id
Ref: ci_role.id - ci_base.id
Ref: ci_entity_type.id - ci_base.id
Ref: ci_device_status.id - ci_base.id
Ref: ci_permission_scope.id - ci_base.id
Ref: ci_device_type.id - ci_entity_type.id
Ref: ci_asset_type.id - ci_entity_type.id
Ref: ci_asset_type_category.id - ci_base.id
Ref: ci_inventory_type.id - ci_entity_type.id
Ref: ci_organization_type.id - ci_entity_type.id
Ref: ci_user_type.id - ci_entity_type.id
Ref: ci_asset_group_type.id - ci_entity_type.id
Ref: ci_device_relation_type.id - ci_base.id
Ref: ci_tag.id - ci_base.id

Ref: ci_permission_scope.module_id > ci_module.id
Ref: ci_permission_scope.entity_type_id > ci_entity_type.id
Ref: ci_asset_type.category_id > ci_asset_type_category.id
Ref: ci_asset_group_type.allowed_asset_type_id > ci_asset_type.id
Ref: ci_tag.entity_type_id > ci_entity_type.id

Ref: customizable_entity.entity_type_id > ci_entity_type.id

Ref: organization.id - customizable_entity.id
Ref: organization.parent_id > organization.id
Ref: organization.organization_type_id > ci_organization_type.id
Ref: organization.deleted_by > user.id

Ref: catalog.organization_id > organization.id
Ref: catalog.module_id > ci_module.id
Ref: catalog.category_id > ci_catalog_category.id

Ref: user.id - customizable_entity.id
Ref: user.organization_id > organization.id
Ref: user.user_type_id > ci_user_type.id
Ref: user.deleted_by > user.id

Ref: user_role.user_id > user.id
Ref: user_role.role_id > ci_role.id
Ref: user_role.assigned_by > user.id

Ref: acl_role_permission.role_id > ci_role.id
Ref: acl_role_permission.permission_scope_id > ci_permission_scope.id
Ref: acl_role_permission.granted_by > user.id

Ref: acl_user_scope.user_id > user.id
Ref: acl_user_scope.permission_scope_id > ci_permission_scope.id

Ref: asset.id - customizable_entity.id
Ref: asset.organization_id > organization.id
Ref: asset.asset_type_id > ci_asset_type.id
Ref: asset.deleted_by > user.id

Ref: inventory.id - customizable_entity.id
Ref: inventory.organization_id > organization.id
Ref: inventory.inventory_type_id > ci_inventory_type.id
Ref: inventory.deleted_by > user.id

Ref: device.id - customizable_entity.id
Ref: device.organization_id > organization.id
Ref: device.device_type_id > ci_device_type.id
Ref: device.status_id > ci_device_status.id
Ref: device.deleted_by > user.id

Ref: device_asset_link.device_id - device.id
Ref: device_asset_link.asset_id > asset.id
Ref: device_asset_link.linked_by > user.id

Ref: device_inventory_link.device_id - device.id
Ref: device_inventory_link.inventory_id > inventory.id
Ref: device_inventory_link.linked_by > user.id

Ref: device_relation.master_id > device.id
Ref: device_relation.slave_id > device.id
Ref: device_relation.relation_type_id > ci_device_relation_type.id

Ref: asset_group.id - customizable_entity.id
Ref: asset_group.organization_id > organization.id
Ref: asset_group.group_type_id > ci_asset_group_type.id
Ref: asset_group.deleted_by > user.id

Ref: asset_group_item.group_id > asset_group.id
Ref: asset_group_item.asset_id > asset.id

Ref: entity_tag.tag_id > ci_tag.id

Ref: custom_field_def.organization_id > organization.id
Ref: custom_field_def.owner_entity_type_id > ci_entity_type.id
Ref: custom_field_def.ref_entity_type_id > ci_entity_type.id
Ref: custom_field_def.ref_catalog_id > catalog.id

Ref: custom_field_value_text.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_text.field_def_id > custom_field_def.id

Ref: custom_field_value_number.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_number.field_def_id > custom_field_def.id

Ref: custom_field_value_boolean.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_boolean.field_def_id > custom_field_def.id

Ref: custom_field_value_date.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_date.field_def_id > custom_field_def.id

Ref: custom_field_value_datetime.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_datetime.field_def_id > custom_field_def.id

Ref: custom_field_value_entity.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_entity.field_def_id > custom_field_def.id
Ref: custom_field_value_entity.ref_entity_id > customizable_entity.id

Ref: custom_field_value_catalog.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_catalog.field_def_id > custom_field_def.id
Ref: custom_field_value_catalog.ref_item_id > ci_base.id

Ref: audit_event.user_id > user.id

Частота обновления

Данные в repo схема синхронизируется в режиме реального времени с исходными системами. Обновления происходят немедленно по мере внесения изменений, а журналы аудита фиксируют все модификации для целей соответствия и исторического анализа.

ci_base

Схема repo схема использует паттерн Single Table Inheritance для всех справочных данных через ci_base таблицу:

Схема repo схема использует Single Table Inheritance паттерн для всех справочных данных через ci_base таблицу. Этот подход объединяет системные словари, классификации и элементы справочников, определяемые пользователем, в единую структуру, обеспечивая согласованность и гибкость по всей схеме.

Архитектура:

Схема ci_base таблица служит основой для всех справочных данных, используя discriminator поле для идентификации конкретного типа справочной записи. Каждый тип справочника имеет соответствующую таблицу (например, ci_device_type, ci_asset_type) которая разделяет тот же id как ci_base, создавая типобезопасное отношение наследования.

Как деловые сущности подключаются к ci_base:

Все деловые сущности в repo схеме ссылаются на ci_base подтипы для определения своей классификации и поведения:

• organization → ссылается на ci_organization_type (который наследует от ci_entity_type → ci_base)

• user → ссылается на ci_user_type (который наследует от ci_entity_type → ci_base)

• device → ссылается на ci_device_type и ci_device_status (оба наследуют от ci_base)

• asset → ссылается на ci_asset_type (который наследует от ci_entity_type → ci_base)

• inventory → ссылается на ci_inventory_type (который наследует от ci_entity_type → ci_base)

• asset_group → ссылается на ci_asset_group_type (который наследует от ci_entity_type → ci_base)

Категории типов справочников:

Категория	Таблицы	Назначение
Конфигурация системы	ci_module, ci_country, ci_role	Определяют модули системы, географические справочники и роли пользователей
Определения типов сущностей	ci_entity_type, ci_device_type, ci_asset_type, ci_inventory_type, ci_organization_type, ci_user_type, ci_asset_group_type	Классифицируйте все бизнес-сущности по типу
Статус и классификация	ci_device_status, ci_asset_type_category	Отслеживайте состояния сущностей и группируйте типы в категории
Контроль доступа	ci_permission_scope	Определяет, какие права могут быть предоставлены (связано с ci_module и ci_entity_type)
Связи	ci_device_relation_type	Определяет типы отношений между устройствами (master-slave, резервирование и т.д.)
Категоризация	ci_tag, ci_catalog_category	Обеспечивает гибкую систему тегирования и организацию каталогов

Примеры шаблонов запросов

-- Получить все типы устройств для организации (системные + пользовательские)
SELECT cb.id, cb.code, cb.title_en, cb.is_system
FROM repo.ci_base cb
JOIN repo.ci_device_type dt ON dt.id = cb.id
WHERE cb.discriminator = 'device_type'
  AND (cb.is_system = true OR cb.organization_id = $org_id)
  AND cb.deleted_at IS NULL;

-- Получить тип актива с его категорией
SELECT 
  cb.code as asset_type_code,
  cb.title_en as asset_type_name,
  cat_cb.title_en as category_name
FROM repo.ci_base cb
JOIN repo.ci_asset_type at ON at.id = cb.id
LEFT JOIN repo.ci_asset_type_category cat ON cat.id = at.category_id
LEFT JOIN repo.ci_base cat_cb ON cat_cb.id = cat.id
WHERE cb.discriminator = 'asset_type'
  AND cb.deleted_at IS NULL;

-- Получить иерархическую структуру тегов
SELECT cb.id, cb.code, cb.title_en, cb.path, cb.parent_id
FROM repo.ci_base cb
JOIN repo.ci_tag t ON t.id = cb.id
WHERE cb.discriminator = 'tag'
  AND cb.deleted_at IS NULL
ORDER BY cb.path;

Ключевые таблицы по категориям

Таблицы в repo схема организована по функциональным категориям. Описания ниже суммируют наиболее важные таблицы по их бизнес-назначению.

organization

Назначение: Управление иерархической организацией

Атрибут	Детали
Ключевые поля	id, parent_id, path, organization_type_id, title_en, is_active, deleted_at
Индексация	GiST-индекс на path для иерархических запросов, индексы на parent_id и organization_type_id
Особые замечания	Использует ltree для многоуровневых иерархий, наследуется от customizable_entity для поддержки пользовательских полей

user

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

Атрибут	Детали
Ключевые поля	id, organization_id, user_type_id, identity_provider, identity_provider_id, full_name, is_active
Индексация	Уникальный индекс на (organization_id, identity_provider, identity_provider_id)
Особые замечания	Интеграция внешних провайдеров идентификации (Keycloak, Auth0, Okta), наследуется от customizable_entity

device

Назначение: Физические трекинговые устройства

Атрибут	Детали
Ключевые поля	id, organization_id, device_type_id, status_id, hw_id, label
Индексация	Индексы на organization_id, device_type_id, status_id, hw_id
Особые замечания	Аппаратный идентификатор для трекинга устройства, наследуется от customizable_entity для пользовательских полей

asset

Назначение: Физические или виртуальные активы

Атрибут	Детали
Ключевые поля	id, organization_id, asset_type_id, label, description
Индексация	Индексы на organization_id и asset_type_id
Особые замечания	Наследуется от customizable_entity, связаны с устройствами через device_asset_link

inventory

Назначение: Записи инвентаризации и складского учета

Атрибут	Детали
Ключевые поля	id, organization_id, inventory_type_id, code
Индексация	Уникальный индекс на (organization_id, code)
Особые замечания	Уникальные коды внутри организации, связаны с устройствами через device_inventory_link

asset_group

Назначение: Группировка активов с историческим отслеживанием

Атрибут	Детали
Ключевые поля	id, organization_id, group_type_id, title_en, description
Связи	FROM repo.asset_group AS ag JOIN repo.asset_group_item AS agi ON agi.group_id = ag.id JOIN repo.asset AS a ON a.id = agi.asset_id WHERE agi.detached_at IS NULL
Особые замечания	Членство на основе времени через asset_group_item, запрос текущих членов с помощью WHERE detached_at IS NULL

custom_field_def

Назначение: Определения пользовательских полей и метаданные

Атрибут	Детали
Ключевые поля	id, organization_id, owner_entity_type_id, code, field_type, is_multi, is_required
Содержимое	Типы полей включают text, number, boolean, date, datetime, entity_ref, catalog_item_ref
Особые замечания	Обеспечивает гибкие пользовательские поля для любого типа сущности, значения хранятся в типо-специфичных custom_field_value_* таблицах

acl_role_permission

Назначение: Управление правами на основе ролей

Атрибут	Детали
Ключевые поля	id, role_id, permission_scope_id, target_entity_id, actions
Содержимое	Битовая маска действий (READ=1, UPDATE=2, DELETE=4, CREATE=8), права специфичны для цели или для типа сущности в целом
Связи	FROM repo.user_role AS ur JOIN repo.acl_role_permission AS rp ON rp.role_id = ur.role_id WHERE ur.user_id = $user_id
Особые замечания	Работает совместно с user_role и acl_user_scope чтобы определить итоговые права пользователя

audit_event

Назначение: Унифицированный журнал аудита всех изменений в системе

Атрибут	Детали
Ключевые поля	id, event_category, user_id, aggregate_type, aggregate_id, event_type, event_data, occurred_at
Индексация	Индексы на (user_id, occurred_at), (aggregate_type, aggregate_id, occurred_at), (event_category, occurred_at)
Особые замечания	Разделение по партициям по occurred_at (ежемесячно), две категории: auth (аутентификация) и domain (бизнес-события), сохраняет дельты изменений полей в event_data JSONB

Связи данных

Схема repo схема реализует сложные шаблоны отношений для гибкого моделирования данных:

Иерархические структуры

• Организации используют пути ltree для эффективных запросов по дереву

• Элементы справочников (ci_base) поддерживают опциональные иерархии

• Автоматическое поддержание путей через триггеры базы данных

Шаблоны наследования

• Наследование таблиц: customizable_entity → бизнес-сущности (organization, user, device, asset, inventory, asset_group)

• Наследование ID: ci_base → таблицы типов справочников

• Различение типов через entity_type_id и discriminator поля

Полиморфные связи

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

• acl_role_permission.target_entity_id → любую customizable_entity

• acl_user_scope.target_entity_id → любую customizable_entity

• entity_tag.entity_id → любую customizable_entity

Эти связи проверяются на уровне приложения.

Дополнительная информация

Валидация данных

Схема repo схема обеспечивает целостность данных посредством нескольких механизмов:

Ограничения базы данных

• ОГРАНИЧЕНИЯ UNIQUE с поддержкой мягкого удаления (частичные индексы WHERE deleted_at IS NULL)

• Ограничения CHECK (например, device_relation обеспечивает master_id ≠ slave_id)

• Ограничения NOT NULL для обязательных полей

• ЗНАЧЕНИЯ DEFAULT для временных меток и булевых флагов

Проверки на уровне приложения

• Проверка типа сущности для полиморфных ссылок

• Проверка каталога для ссылок пользовательских полей

• Валидация типов пользовательских полей

• Управление массивами для полей с множественными значениями

Оптимизация запросов

Таблицы организованы со специфическими стратегиями индексирования:

Стандартные индексы:

• Все внешние ключи имеют выделенные индексы

• Временные индексы на created_at, updated_at, deleted_at

• Составные индексы для часто объединяемых столбцов

Специализированные индексы:

• GiST-индексы на ltree-путях для иерархических запросов

• Частичные уникальные индексы, поддерживающие мягкое удаление

• Индексы значений пользовательских полей для фильтрации и сортировки

• Индексы событий аудита по времени + сущности для эффективного поиска

Соображения по производительности:

• Рекомендуется пул соединений (PgBouncer)

• Регулярное обслуживание VACUUM для больших таблиц

• Возможное будущее партиционирование для device таблицы по organization_id

• Материализованные представления для сложных вычислений контроля доступа