> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview/bronze-layer/raw-business-data.md).

# Esquema raw\_business\_data

raw\_business\_data contém mais de 40 tabelas que abrangem usuários, objetos, veículos, tarefas e geocercas. Navegue pela definição do esquema e pelas descrições das principais tabelas para análise SQL

Este esquema contém mais de 40 tabelas cuidadosamente selecionadas para abranger vários aspectos do negócio e casos de uso. Essas tabelas representam as principais entidades do negócio, a estrutura organizacional e os dados operacionais.

{% hint style="info" %}
O diagrama interativo do esquema raw\_business\_data está disponível em **dbdiagram.io**: <https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a>
{% endhint %}

Veja abaixo os detalhes do esquema dos dados brutos de negócios.

{% code title="esquema de raw\_business\_data" expandable="true" %}

```sql
Table "vehicle_service_tasks" {
  Timestamp de "record_added_at" [não nulo]
  "start_mileage" numérico
  "comment" "character varying(255)"
  "status" "character varying(10)" [não nulo]
  timestamp de "completion_date"
  "start_engine_hours" numérico
  "service_task_id" integer [not null]
  "is_notification_push_enabled" boolean [not null]
  intervalo de "date_notification_interval"
  timestamp de "predicted_datetime"
  "cost" numeric [not null]
  "mileage_limit" numeric
  texto "notification_emails"
  boolean "is_unplanned" [não nulo]
  "is_repeat" boolean [not null]
  "completion_engine_hours" inteiro
  "engine_hours_limit" numérico
  "mileage_repeat_interval" inteiro
  "vehicle_id" inteiro [não nulo]
  inteiro "engine_hours_notification_interval"
  Timestamp de "start_date"
  "mileage_notification_interval" inteiro
  intervalo de "date_repeat_interval"
  "description" "character varying(255)"
  texto de "notification_sms_phone_numbers"
  timestamp de "end_date"
  "engine_hours_repeat_interval" inteiro
  "completion_mileage" inteiro
}

Tabela "garages" {
  Timestamp de "record_added_at" [não nulo]
  "garage_id" inteiro [não nulo]
  "longitude" numérico
  "mechanic_name" "character varying(255)"
  "radius" integer [não nulo]
  "latitude" numeric
  "organization_label" "character varying(255)"
  "user_id" integer [not null]
  "dispatcher_name" "character varying(255)"
  "address" "character varying(255)"
}

Table "driver_history" {
  timestamp "server_datetime" [não nulo]
  "address" "character varying(255)"
  "updated_by" inteiro [não nulo]
  "object_id" integer
  "longitude" numérico
  "latitude" numeric
  "driver_history_id" integer [not null]
  "hardware_key" "character varying(64)"
  "new_employee_id" inteiro
  timestamp de "changed_datetime"
  Timestamp de "record_added_at" [não nulo]
  "old_employee_id" integer
}

Table "departments" {
  Timestamp de "record_added_at" [não nulo]
  "department_label" "character varying(255)" [não nulo]
  "latitude" numeric
  "department_id" integer [not null]
  "address" "character varying(255)"
  "radius" integer [não nulo]
  "longitude" numérico
  "user_id" integer [not null]
}

Tabela "checkins" {
  "radius" integer [não nulo]
  "latitude" numérico [não nulo]
  "employee_id" integer [not null]
  "longitude" numérico [não nulo]
  Timestamp de "record_added_at" [não nulo]
  timestamp "actual_datetime" [não nulo]
  "user_id" integer [not null]
  "form_id" integer [not null]
  "address" "character varying(255)"
  timestamp "planned_datetime" [não nulo]
  "object_id" integer [not null]
  "checkin_id" integer [not null]
  texto de "comentário"
}

Tabela "statuses" {
  "order_sort" integer [not null]
  "listing_id" integer [not null]
  "color" "character varying(6)" [not null]
  "status_id" inteiro [não nulo]
  "status_label" "character varying(200)" [não nulo]
  Timestamp de "record_added_at" [não nulo]
  "is_deleted" boolean [not null]
}

Tabela "places_linked_entity_fields" {
  "value" bigint [not null]
  Timestamp de "record_added_at" [não nulo]
  "place_id" integer [not null]
  "field_id" integer [not null]
}

Table "places_text_fields" {
  "place_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  texto "value" [não nulo]
  "field_id" integer [not null]
}

Tabela "users2zones" {
  "zone_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "user_id" integer [not null]
}

Tabela "objects" {
  Timestamp de "record_added_at" [não nulo]
  "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 [não nulo]
  "is_deleted" boolean [not null]
  "device_id" integer [not null]
  "object_id" integer [not null]
}

Tabela "device_output_name" {
  "device_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "label" "character varying(100)" [not null]
  "number" inteiro [não nulo]
}

Table "geofence_points" {
  "longitude" numérico [não nulo]
  "number" inteiro [não nulo]
  "zone_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "latitude" numérico [não nulo]
}

Tabela "custom_fields" {
  Timestamp de "record_added_at" [não nulo]
  "entity_id" inteiro [não nulo]
  "is_required" boolean [not null]
  texto de "custom_field_label" [não nulo]
  "parameters" jsonb
  "custom_field_type" integer [não nulo]
  texto de "description"
  "custom_field_id" integer [not null]
}

Tabela "places_decimal_fields" {
  "field_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "place_id" integer [not null]
  "value" numérico [não nulo]
}

Tabela "task_history" {
  "task_id" integer [not null]
  "activity" integer [not null]
  "task_history_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "user_id" integer [not null]
  timestamp de "event_datetime" [não nulo]
  texto "payload"
}

Table "tags" {
  "tag_label" "character varying(64)" [não nulo]
  "color" "character varying(6)"
  "user_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "tag_id" integer [not null]
}

Tabela "places" {
  texto de "description"
  "custom_fields" jsonb
  "place_id" integer [not null]
  "external_id" "character varying(32)"
  Timestamp de "record_added_at" [não nulo]
  "user_id" inteiro
  "latitude" numeric
  inteiro "radius"
  "place_label" "character varying(256)"
  "assigned_datetime" timestamp
  "address" "character varying(256)"
  "longitude" numérico
}

Tabela "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]
  Timestamp de "record_added_at" [não nulo]
  "status_listing_label" "character varying(200)" [not null]
}

Tabela "models" {
  Timestamp de "record_added_at" [não nulo]
  "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" inteiro [não nulo]
  "outputs_amount" inteiro [não nulo]
}

Tabela "vehicle_trackers_history" {
  "vehicle_id" inteiro [não nulo]
  Timestamp de "record_added_at" [não nulo]
  "object_id" integer [not null]
  timestamp "changed_datetime" [não nulo]
  "vehicle_tracker_history_id" integer [not null]
}

Tabela "groups" {
  "group_id" integer [not null]
  "group_color" "character varying(6)" [not null]
  "rótulo_do_grupo" "character varying(255)" [não nulo]
  "client_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
}

Tabela "sensor_description" {
  Timestamp de "record_added_at" [não nulo]
  "parameters" jsonb
  "input_id" integer [not null]
  "accuracy" numérico [não nulo]
  "sensor_units" "character varying(10)"
  "multiplicador" doubleprecision [não nulo]
  "input_label" "character varying(64)"
  "sensor_label" "character varying(100)"
  "units_type" inteiro [não nulo]
  "divider" doubleprecision [not null]
  "group_id" integer [not null]
  "sensor_id" integer [not null]
  "device_id" integer [not null]
  "sensor_type" "character varying(45)" [não nulo]
  "group_type" integer [not null]
  "calibration_data" jsonb
}

Tabela "entities" {
  "entity_label" jsonb
  Timestamp de "record_added_at" [não nulo]
  "entity_id" inteiro [não nulo]
  "builtin_type" integer [not null]
  "user_id" integer [not null]
}

Tabela "zones" {
  "address" "character varying(255)"
  "radius" integer [não nulo]
  "zone_id" integer [not null]
  "circle_center_latitude" numérico [não nulo]
  "client_id" integer [not null]
  "zone_label" "character varying(100)"
  "color" "character varying(6)" [not null]
  "zone_type" "character varying(20)" [não nulo]
  "circle_center_longitude" numérico [não nulo]
  "latitude" numérico [não nulo]
  Timestamp de "record_added_at" [não nulo]
  "longitude" numérico [não nulo]
}

Tabela "vehicles" {
  "vehicle_id" inteiro [não nulo]
  "payload_length" numérico
  "vin" "character varying(20)"
  "free_insurance_policy_number" "character varying(50)"
  "vehicle_label" "character varying(100)"
  "payload_width" numérico
  "color" "character varying(6)"
  "trailer" "character varying(255)"
  "object_id" integer
  "vehicle_status_id" inteiro
  "liability_insurance_valid_till" timestamp
  "manufacture_year" inteiro
  "fuel_grade" "character varying(16)"
  "fuel_cost" numérico
  "fuel_tank_volume" numeric
  "model" "character varying(100)"
  "garage_id" inteiro
  "payload_height" numérico
  "max_speed" numérico
  "registration_number" "character varying(32)"
  "tyre_size" "character varying(50)"
  "passenger_capacity" inteiro
  Timestamp de "record_added_at" [não nulo]
  "trailer_reg_number" "character varying(32)"
  "free_insurance_valid_till_date" carimbo de data/hora
  "gross_weight" numérico
  "standard_fuel_consumption" numeric
  "fuel_type" inteiro
  "payload_weight" numérico
  texto de "additional_info"
  "vehicle_subtype" "character varying(32)"
  "liability_insurance_policy_number" "character varying(50)"
  "frame_number" "character varying(32)"
  "user_id" integer [not null]
  "vehicle_type" inteiro [não nulo]
  "chassis_number" "character varying(32)"
  "tyres_number" inteiro
  "wheel_arrangement" "character varying(16)"
}

Table \"tag_links\" {
  "entity_id" inteiro [não nulo]
  Timestamp de "record_added_at" [não nulo]
  "entity_type" inteiro [não nulo]
  "ordinal" integer [not null]
  "tag_id" integer [not null]
}

Tabela "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)" [não nulo]
  "client_id" integer [not null]
  "is_push_enabled" boolean [not null]
  "event_comment1" "character varying(255)" [não nulo]
  "event_label" "character varying(255)" [não nulo]
  "description" "character varying(255)" [not null]
  Timestamp de "record_added_at" [não nulo]
  texto "alert_sms" [não nulo]
  "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]
}

Table "status_history" {
  "longitude" numérico
  "new_status_id" integer
  "status_history_id" integer [not null]
  "device_id" integer [not null]
  "updated_by" inteiro [não nulo]
  "address" "character varying(255)"
  "latitude" numeric
  Timestamp de "record_added_at" [não nulo]
  timestamp "server_datetime" [não nulo]
  timestamp de "changed_datetime"
  "old_status_id" integer
}

Table "rules2zones" {
  "zone_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "rule_id" integer [not null]
}

Table "forms" {
  "object_id" integer [not null]
  texto de "description"
  "form_label" "character varying(255)" [not null]
  texto "fields"
  "created_at" timestamp [not null]
  "submission_address" "character varying(255)"
  "submission_latitude" numérico
  "form_id" integer [not null]
  "submission_longitude" numérico
  "is_submission_in_zone" boolean [not null]
  texto "values"
  Timestamp de "record_added_at" [não nulo]
  "task_id" inteiro
  Carimbo de data e hora "submitted_at"
}


Tabela "rules2objects" {
  "object_params" jsonb
  "param_group_number" integer [not null]
  "object_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
  "rule_id" integer [not null]
}

Table "tasks" {
  carimbo de data/hora "time_from"
  intervalo de "stay_duration_minutes"
  "external_id" "character varying(100)"
  "object_id" integer
  "task_type" inteiro
  intervalo de "arrival_duration_minutes"
  inteiro "status"
  timestamp "arrival_datetime"
  Timestamp de "record_added_at" [não nulo]
  "task_id" integer [not null]
  "user_id" inteiro
  Carimbo de data/hora de "status_change_datetime"
  inteiro "order_sort"
  Carimbo de data e hora "time_to"
  "max_delay_minuts" inteiro
  booleano "is_stay_control_enabled"
  "address" "character varying(255)"
  "task_label" "character varying(200)" [not null]
  "longitude" numérico
  "created_by" inteiro
  Texto de "description" [não nulo]
  inteiro "radius"
  "latitude" numeric
  inteiro "stay_duration"
  "created_at" timestamp [not null]
  "custom_fields" jsonb
  "parent_task_id" inteiro
}

Tabela "places_bigint_fields" {
  "field_id" integer [not null]
  "value" bigint [not null]
  "place_id" integer [not null]
  Timestamp de "record_added_at" [não nulo]
}

Tabela "devices" {
  "is_sim_blocked" boolean [not null]
  "device_id" integer [not null]
  "device_imei" "character varying(64)" [não nulo]
  "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 [não nulo]
  "created_at" timestamp [not null]
  "owner_id" inteiro [não nulo]
  Timestamp de "record_added_at" [não nulo]
}

Tabela "description_parameters" {
  "description" "character varying(150)"
  Timestamp de "record_added_at" [não nulo]
  "type" "character varying(100)" [not null]
  "key" integer [not null]
}

Table "users" {
  "company_label" "character varying(255)" [not null]
  "registration_datetime" timestamp
  "first_name" "character varying(100)" [not null]
  "master_id" integer
  "last_name" "character varying(100)" [not null]
  "birth_date" timestamp
  "timezone_label" "character varying(30)"
  "middle_name" "character varying(100)" [não nulo]
  "user_id" integer [not null]
  "locale" "character varying(10)" [não nulo]
  Timestamp de "record_added_at" [não nulo]
}

Tabela "counters" {
  "sensor_id" inteiro
  "multiplier" numérico [não nulo]
  "counter_id" integer [not null]
  "device_id" integer [not null]
  "counter_type" integer [not null]
  Timestamp de "record_added_at" [não nulo]
}

Tabela "employees" {
  carimbo de data e hora de "driver_license_valid_till"
  Timestamp de "record_added_at" [não nulo]
  "last_name" "character varying(100)"
  "department_id" inteiro
  "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 [não nulo]
  "longitude" numérico
}

Table "places_longtext_fields" {
  "field_id" integer [not null]
  texto "value" [não nulo]
  Timestamp de "record_added_at" [não nulo]
  "place_id" integer [not null]
}

Tabela "groups_objects" {
  "groups_client_id" integer
  "objects_client_id" inteiro

  Índices {
    (groups_client_id, objects_client_id) [pk]
  }
}

Tabela "device_settings" {
  "device_id" integer [not null]
  "key" "character varying" [não nulo]
  Texto "value"

  Índices {
    (device_id, key) [pk]
  }
}

Tabela "event_description" {
  "event_id" integer [not null, pk]
  texto de "description"
}

Ref:"employees"."employee_id" < "checkins"."employee_id"

Ref:"objects"."object_id" < "checkins"."object_id"

Ref:"forms"."form_id" < "checkins"."form_id"

Ref:"sensor_description"."sensor_id" < "counters"."sensor_id"

Ref:"devices"."device_id" < "counters"."device_id"

Ref:"entities"."entity_id" < "custom_fields"."entity_id"

Ref:"departments"."department_id" < "employees"."department_id"

Ref:"users"."user_id" < "departments"."user_id"

Ref:"description_parameters"."key" < "counters"."counter_type"

Ref:"description_parameters"."key" < "custom_fields"."custom_field_type"

Ref:"description_parameters"."key" < "driver_history"."updated_by"

Ref:"description_parameters"."key" < "entities"."builtin_type"

Ref:"description_parameters"."key" < "sensor_description"."units_type"

Ref:"description_parameters"."key" < "status_history"."updated_by"

Ref:"description_parameters"."key" < "tasks"."status"

Ref:"description_parameters"."key" < "tasks"."created_at"

Ref:"description_parameters"."key" < "tasks"."task_type"

Ref:"description_parameters"."key" < "vehicles"."fuel_type"

Ref:"description_parameters"."key" < "task_history"."activity"

Ref:"description_parameters"."key" < "sensor_description"."group_type"

Ref:"devices"."device_id" < "device_output_name"."device_id"

Ref:"status_listings"."status_listing_id" < "devices"."status_listing_id"

Ref:"employees"."employee_id" < "driver_history"."new_employee_id"

Ref:"employees"."employee_id" < "driver_history"."old_employee_id"

Ref:"objects"."object_id" < "driver_history"."object_id"

Ref:\"objects\".\"object_id\" < \"employees\".\"object_id\"

Ref:"users"."user_id" < "employees"."user_id"

Ref:"users"."user_id" < "entities"."user_id"

Ref:"tasks"."task_id" < "forms"."task_id"

Ref:"objects"."object_id" < "forms"."object_id"

Ref:"objects"."object_id" < "tasks"."object_id"

Ref:"users"."user_id" < "garages"."user_id"

Ref:"groups"."client_id" < "groups_objects"."groups_client_id"

Ref:"objects"."client_id" < "groups_objects"."objects_client_id"

Ref:"models"."model" < "objects"."model"

Ref:"devices"."device_id" < "objects"."device_id"

Ref:"users"."user_id" < "places"."user_id"

Ref:"custom_fields"."custom_field_id" < "places_bigint_fields"."field_id"

Ref:"places"."place_id" < "places_bigint_fields"."place_id"

Ref:"custom_fields"."custom_field_id" < "places_decimal_fields"."field_id"

Ref:"places"."place_id" < "places_decimal_fields"."place_id"

Ref:"custom_fields"."custom_field_id" < "places_linked_entity_fields"."field_id"

Ref:"places"."place_id" < "places_linked_entity_fields"."place_id"

Ref:"custom_fields"."custom_field_id" < "places_longtext_fields"."field_id"

Ref:"places"."place_id" < "places_longtext_fields"."place_id"

Ref:"custom_fields"."custom_field_id" < "places_text_fields"."field_id"

Ref:"places"."place_id" < "places_text_fields"."place_id"

Ref:"rules"."rule_id" < "rules2zones"."rule_id"

Ref:"objects"."object_id" < "rules2objects"."object_id"

Ref:"rules"."rule_id" < "rules2objects"."object_id"

Ref:"zones"."zone_id" < "rules2zones"."zone_id"

Ref:"devices"."device_id" < "sensor_description"."device_id"

Ref:"statuses"."status_id" < "status_history"."new_status_id"

Ref:"statuses"."status_id" < "status_history"."old_status_id"

Ref:"devices"."device_id" < "status_history"."device_id"

Ref:"users"."user_id" < "status_listings"."user_id"

Ref:"status_listings"."status_listing_id" < "statuses"."listing_id"

Ref:"tags"."tag_id" < "tag_links"."tag_id"

Ref:"users"."user_id" < "tags"."user_id"

Ref:"tasks"."task_id" < "task_history"."task_id"

Ref:"users"."user_id" < "task_history"."user_id"

Ref:"tasks"."parent_task_id" < "tasks"."task_id"

Ref:"users"."user_id" < "tasks"."user_id"

Ref:"users"."master_id" < "users"."user_id"

Ref:"users"."user_id" < "users2zones"."user_id"

Ref:"zones"."zone_id" < "users2zones"."zone_id"

Ref:"vehicles"."vehicle_id" < "vehicle_service_tasks"."vehicle_id"

Ref:"objects"."object_id" < "vehicle_trackers_history"."object_id"

Ref:"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:"users"."user_id" < "devices"."owner_id"

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

```

{% endcode %}

## Frequência de atualização

Os dados deste esquema são sincronizados com o banco de dados principal. As atualizações ocorrem de forma incremental, conforme as alterações acontecem no banco de dados MySQL de origem, geralmente em menos de 5 minutos após a alteração na origem.

## `description_parameters`

O sistema inclui dados de referência para padronizar os valores em todo o banco de dados:

<table><thead><tr><th width="167.1817626953125">Tipo de referência</th><th width="173.9090576171875">Descrição</th><th>Valores de exemplo</th></tr></thead><tbody><tr><td>Definições de tipo</td><td>Tipos de entidade padrão</td><td><code>vehicle_type: car, truck, bus</code></td></tr><tr><td>Códigos de status</td><td>Valores de status da Tarefa e do sistema</td><td><code>tasks_status: unassigned, assigned, done</code></td></tr><tr><td>Definições de unidades</td><td>Unidades de medida dos sensores</td><td><code>units_type: liter, gallon, celsius</code></td></tr><tr><td>Classificações de entidades</td><td>Categorias de entidades empresariais</td><td><code>entities_type: place, task, customer</code></td></tr></tbody></table>

## Principais tabelas por categoria

As tabelas no **`raw_business_data`** Os esquemas são organizados em categorias funcionais para facilitar a navegação. A tabela abaixo resume as principais tabelas de acordo com sua finalidade comercial:

Entidades centrais do negócio

<details>

<summary><strong><code>users</code></strong></summary>

**Descrição**: Contas de usuário que contêm informações do perfil, vínculo com a empresa, configurações de localização (fuso horário, localidade) e relações hierárquicas por meio de master\_id para estruturas de conta multinível

<table><thead><tr><th width="145">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>user_id</code> - Identificador exclusivo do usuário<br>- <code>company_label</code> - Nome da empresa associada ao usuário<br>- <code>first_name</code> - Nome de usuário<br>- <code>last_name</code> - Sobrenome do usuário<br>- <code>middle_name</code> - Nome do meio do usuário<br>- <code>locale</code> - Configurações de idioma do usuário<br>- <code>timezone_label</code> - Fuso horário no formato IANA<br>- <code>master_id</code> - ID do usuário principal (se o atual for subordinado)<br>- <code>registration_datetime</code> - Data de registro no sistema<br>- <code>birth_date</code> - Data de nascimento do usuário</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Usuário pai via <code>master_id</code>, vinculada a <code>employees</code>, <code>departments</code>, <code>Locais</code>, <code>tasks</code> por meio de <code>user_id</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Entidade central que conecta os dados organizacionais; <code>master_id</code> permite hierarquias de usuários em estruturas de conta multinível</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>employees</code></strong></summary>

**Descrição**: Registros de funcionários e Motoristas usados para representar as pessoas que trabalham para a organização, incluindo informações pessoais, dados da carteira de habilitação, atribuições de departamento, chaves de hardware para identificação por iButton/RFID e dados de localização com suporte a geocercas

<table><thead><tr><th width="143">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>employee_id</code> - Identificador da entidade de funcionário<br>- <code>user_id</code> - Identificador da entidade de usuário<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>department_id</code> - Um ID do departamento ao qual o funcionário está atribuído<br>- <code>first_name</code> - O atributo first_name da tabela employees<br>- <code>last_name</code> - O atributo last_name da tabela employees<br>- <code>middle_name</code> - O atributo middle_name da tabela de funcionários<br>- <code>driver_license_number</code> - Número da carteira de motorista<br>- <code>driver_license_categories</code> - Categorias da carteira de motorista<br>- <code>driver_license_issue_date</code> - Data de emissão da carteira de motorista<br>- <code>driver_license_valid_till</code> - Data até quando a carteira de motorista é válida<br>- <code>hardware_key</code> - Uma chave de hardware<br>- <code>email</code> - E-mail do funcionário<br>- <code>phone_number</code> - Telefone do funcionário sem o sinal "+"<br>- <code>address</code> - Endereço do local<br>- <code>personnel_number</code> - Número de registro do funcionário/motorista<br>- <code>citizen_id_number</code> - Número do Seguro Social<br>- <code>latitude</code> - Localização associada a este funcionário<br>- <code>longitude</code> - Localização associada a este funcionário<br>- <code>radius</code> - Localização associada a este funcionário, em metros<br>- <code>fuel_consumption</code> - O atributo fuel_consumption da tabela employees<br>- <code>fuel_cost</code> - O atributo fuel_cost da tabela employees<br>- <code>is_deleted</code> - O atributo is_deleted da tabela de funcionários</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Links para <code>users</code>, <code>departments</code>, <code>objects</code> (rastreador atribuído), rastreado em <code>driver_history</code> e <code>checkins</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>A chave de hardware permite a identificação do motorista por iButton ou RFID; oferece suporte a cercas geográficas com <code>latitude</code>, <code>longitude</code>, <code>radius</code> campos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>departments</code></strong></summary>

**Descrição**: Unidades organizacionais com dados de localização geográfica (latitude, longitude, raio) que permitem análises baseadas em geocercas para relatórios por departamento e associação de funcionários a locais

<table><thead><tr><th width="156">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>department_id</code> - Identificador da entidade de departamento<br>- <code>user_id</code> - Identificador da entidade do usuário<br>- <code>department_label</code> - O atributo department_label da tabela de Departamentos<br>- <code>latitude</code> - Localização associada a estes Departamentos<br>- <code>longitude</code> - Localização associada a estes Departamentos<br>- <code>radius</code> - Tamanho da geolocalização em metros<br>- <code>address</code> - O atributo address da tabela de Departamentos</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Vincula funcionários à estrutura organizacional por meio de <code>department_id</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Os campos de localização permitem análises baseadas em geocercas para relatórios por departamento</td></tr></tbody></table>

</details>

Rastreamento e monitoramento

<details>

<summary><strong><code>devices</code></strong></summary>

**Descrição**: Registro de dispositivos físicos de rastreamento com identificadores de hardware (IMEI), informações do cartão SIM, status de conectividade de rede (intensidade do sinal, roaming, operadora) e status que lista as atribuições para o gerenciamento do ciclo de vida do dispositivo

<table><thead><tr><th width="138">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>device_id</code> - ID do dispositivo<br>- <code>owner_id</code> - ID do proprietário do dispositivo em cuja conta o beacon foi adicionado<br>- <code>device_imei</code> - IMEI do dispositivo<br>- <code>phone</code> - Número do cartão SIM do dispositivo<br>- <code>status_listing_id</code> - ID do status do dispositivo<br>- <code>network_label</code> - Nome da rede à qual o cartão SIM está conectado<br>- <code>signal_level</code> - Intensidade do sinal do dispositivo<br>- <code>has_roaming</code> - Indicador de disponibilidade de roaming<br>- <code>is_sim_blocked</code> - Indicador de bloqueio do cartão SIM<br>- <code>created_at</code> - Data e hora em que a entrada foi criada</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Entidade principal vinculada a <code>objects</code>, <code>models</code>, <code>sensor_description</code>, <code>counters</code>; <code>owner_id</code> referências <code>users.user_id</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Todos os dados telemáticos em <code>raw_telematics_data</code> o esquema faz referência a esta tabela por meio de <code>device_id</code></td></tr></tbody></table>

</details>

<details>

<summary><strong><code>objects</code></strong></summary>

**Descrição**: Registro central de entidades monitoradas (Veículos, ativos, pessoal) que vincula dispositivos físicos à estrutura organizacional por meio de client\_id e group\_id, representando a "unidade rastreável" com um Objeto ativo por dispositivo

<table><thead><tr><th width="148">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>client_id</code> - Identificador da entidade do cliente<br>- <code>device_id</code> - Identificador da entidade do dispositivo<br>- <code>object_label</code> - Nome do objeto<br>- <code>model</code> - Modelo do dispositivo<br>- <code>group_id</code> - Grupo de IDs da entidade<br>- <code>create_datetime</code> - Data e hora de criação de uma nova linha no servidor<br>- <code>is_deleted</code> - O atributo is_deleted da tabela objects<br>- <code>is_clone</code> - Sinal de clone</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Núcleo central que conecta dispositivos a usuários (<code>client_id</code>), detalhes dos veículos, histórico de rastreamento, tarefas e regras</td></tr><tr><td><strong>Observações especiais</strong></td><td>Representa a "unidade rastreável" no sistema; um objeto por dispositivo em uso ativo</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>models</code></strong></summary>

**Descrição**: Registro central de entidades monitoradas (Veículos, ativos, pessoal) que vincula dispositivos físicos à estrutura organizacional por meio de client\_id e group\_id, representando a "unidade rastreável" com um Objeto ativo por dispositivo

<table><thead><tr><th width="135">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>model_id</code> - Identificador do modelo da entidade<br>- <code>model</code> - O atributo de modelo da tabela models<br>- <code>vendor</code> - O nome da empresa que lançou o rastreador<br>- <code>alternative_label</code> - O atributo alternative_label da tabela models<br>- <code>analog_amount</code> - Número de entradas analógicas do rastreador<br>- <code>digital_amount</code> - Número de entradas discretas do rastreador<br>- <code>outputs_amount</code> - Número de saídas discretas do rastreador<br>- <code>has_battery_level</code> - Determina se o rastreador transmite leituras de carga da bateria<br>- <code>has_altitude</code> - Determina se o rastreador transmite a altitude<br>- <code>has_phone</code> - Há um cartão SIM?<br>- <code>has_gsm_level</code> - O rastreador pode transmitir a intensidade do sinal GSM?<br>- <code>has_gsm_name</code> - O rastreador pode transmitir o nome da rede GSM ou o código da operadora (MCC + MNC)?<br>- <code>has_gsm_roaming</code> - O rastreador pode transmitir o status de roaming?<br>- <code>has_detach_button</code> - O rastreador tem um sensor de desconexão?<br>- <code>type_output_control</code> - Perfil de controle das saídas do rastreador<br>- <code>type_special_control</code> - Contém configurações especializadas e módulos funcionais para modelos específicos de dispositivos, como o modo de direção perigosa (hbm_telfm) para equipamentos Teltonika<br>- <code>is_clone</code> - O modelo é um clone de outro modelo?</td></tr><tr><td><strong>Conteúdo</strong></td><td>Os indicadores booleanos de capacidade informam quais campos de dados estão disponíveis para esse tipo de dispositivo</td></tr><tr><td><strong>Observações especiais</strong></td><td>Use os indicadores de capacidade para determinar os sensores e as entradas válidos ao consultar dados telemáticos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>sensor_description</code></strong></summary>

**Descrição**: Configuração abrangente do sensor que associa as entradas do dispositivo à lógica de negócios, incluindo mapeamentos de entradas, unidades de medida, fatores de conversão (multiplicador/divisor), tabelas de calibração para sensores de combustível, limites de precisão e lógica de agrupamento para leituras agregadas de sensores

<table><thead><tr><th width="142">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>sensor_id</code> - Identificador da entidade do sensor<br>- <code>device_id</code> - Identificador da entidade do dispositivo<br>- <code>sensor_label</code> - Nome do sensor na interface<br>- <code>input_label</code> - Nome do campo da mensagem (atributo) do qual os dados do sensor são extraídos. Se for igual a "input_status", trata-se de um Sensor discreto<br>- <code>sensor_type</code> - Tipo de sensor<br>- <code>units_type</code> - Unidades de medida<br>- <code>multiplier</code> - Multiplicador: o número pelo qual o valor do campo deve ser multiplicado. Somente para Sensores de medida<br>- <code>divider</code> - Divisor - o número pelo qual dividir o valor do campo. Somente para sensores de medida<br>- <code>accuracy</code> - Uma porcentagem especificada para calcular o erro absoluto do volume do tanque. Esse erro é usado para determinar quando estão ocorrendo abastecimentos ou drenagens. Isso é usado somente para sensores de combustível<br>- <code>calibration_data</code> - O atributo calibration_data da tabela sensor_description<br>- <code>input_id</code> - Número de entrada para Sensor discreto<br>- <code>group_id</code> - Sensores do mesmo tipo com o mesmo group_id e source_id são considerados parte do mesmo grupo. Os dados deles são somados ou calculados como média, dependendo do valor de group_type. Isso é necessário para sensores agregados. É usado nos sensores de medição<br>- <code>group_type</code> - 0 - somar os valores dos sensores dentro de um grupo, 1 - calcular a média<br>- <code>sensor_units</code> - Nome da unidade informado pelo usuário se units_type=0 (personalizado)<br>- <code>parameters</code> - Objeto opcional com parâmetros adicionais parent_ids - array opcional de parent_ids para sensor composto. volume - double. Opcional. Volume do sensor composto. parent_ids - opcional. int array. Array de parent_ids para sensor composto. volume - opcional. Double. Volume do sensor composto. min - opcional. Double. Valor bruto mínimo aceitável para um sensor. max - opcional. Double. Valor bruto máximo aceitável para um sensor. max_lowering_by_time - opcional. Double. Redução máxima permitida por hora. max_lowering_by_mileage - opcional. Double. Redução máxima permitida por 100 km. ignore_drains_in_move - opcional. Boolean. O padrão é false. Se true, as drenagens de combustível não serão detectadas durante o movimento. ignore_refuels_in_move - opcional. Boolean. O padrão é false. Se true, os abastecimentos não serão detectados durante o movimento. refuel_gap_minutes - opcional. Integer. O padrão é 5. O tempo em minutos após o início do movimento durante o qual os abastecimentos serão detectados durante o movimento. custom_field_name - opcional. Boolean. O padrão é false. O parâmetro determina se o campo input_name é um valor personalizado inserido pelo usuário. Isso só faz sentido se o modelo do rastreador tiver o recurso has_custom_fields</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Vincula as entradas do dispositivo (de <code>raw_telematics_data.inputs</code>) à lógica de negócios por meio de <code>device_id</code> e <code>input_label</code> correspondência</td></tr><tr><td><strong>Observações especiais</strong></td><td><code>calibration_data</code> (JSONB) armazena tabelas de calibração específicas do sensor para sensores de nível de combustível; <code>multiplier</code> e <code>divider</code> converter valores brutos em unidades</td></tr></tbody></table>

</details>

Gestão de ativos

<details>

<summary><strong><code>vehicles</code></strong></summary>

**Descrição**: Cadastro abrangente de veículos contendo especificações (dimensões, peso, capacidade), documentação (VIN, registro, seguro), parâmetros operacionais (consumo de combustível, volume do tanque) e a atribuição atual do rastreador por meio de object\_id para gestão de frotas e rastreamento de conformidade

<table><thead><tr><th width="144">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>vehicle_id</code> - Identificador da entidade do veículo<br>- <code>user_id</code> - Identificador da entidade do usuário<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>garage_id</code> - Identificador da entidade de garagem<br>- <code>vehicle_label</code> - O atributo vehicle_label da tabela Veículos<br>- <code>registration_number</code> - Número de registro/ Placa de um veículo<br>- <code>vin</code> - O atributo VIN da tabela de Veículos<br>- <code>manufacture_year</code> - O atributo manufacture_year da tabela de veículos<br>- <code>fuel_type</code> - O atributo fuel_type da tabela de veículos<br>- <code>fuel_cost</code> - O atributo fuel_cost da tabela de veículos<br>- <code>fuel_tank_volume</code> - O atributo fuel_tank_volume da tabela vehicles<br>- <code>max_speed</code> - O atributo max_speed da tabela de veículos<br>- <code>model</code> - O atributo model da tabela Veículos<br>- <code>color</code> - O atributo de cor da tabela de veículos<br>- <code>trailer</code> - O atributo trailer da tabela de veículos<br>- <code>additional_info</code> - O atributo additional_info da tabela de veículos<br>- <code>vehicle_type</code> - O atributo vehicle_type da tabela de veículos<br>- <code>vehicle_subtype</code> - O atributo vehicle_subtype da tabela de veículos<br>- <code>vehicle_status_id</code> - Identificador da entidade de status do veículo<br>- <code>chassis_number</code> - O atributo chassis_number da tabela de veículos<br>- <code>frame_number</code> - O atributo frame_number da tabela de veículos<br>- <code>trailer_reg_number</code> - O atributo trailer_reg_number da tabela de veículos<br>- <code>payload_weight</code> - O atributo payload_weight da tabela de veículos<br>- <code>payload_height</code> - O atributo payload_height da tabela de veículos<br>- <code>payload_length</code> - O atributo payload_length da tabela de veículos<br>- <code>payload_width</code> - O atributo payload_width da tabela de veículos<br>- <code>passenger_capacity</code> - Um número máximo de passageiros<br>- <code>gross_weight</code> - O atributo gross_weight da tabela de veículos<br>- <code>standard_fuel_consumption</code> - Consumo médio normal de combustível em litros por 100 km<br>- <code>fuel_grade</code> - O atributo fuel_grade da tabela vehicles<br>- <code>wheel_arrangement</code> - O atributo wheel_arrangement da tabela de veículos<br>- <code>tyre_size</code> - Tamanho do veículo: dimensões e tamanho das rodas<br>- <code>tyres_number</code> - Número de rodas<br>- <code>liability_insurance_policy_number</code> - O atributo liability_insurance_policy_number da tabela de Veículos<br>- <code>liability_insurance_valid_till</code> - A data até a qual o seguro de responsabilidade civil é válido<br>- <code>free_insurance_policy_number</code> - O atributo free_insurance_policy_number da tabela de veículos<br>- <code>free_insurance_valid_till_date</code> - A data até a qual o Seguro gratuito é válido</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Links para <code>objects</code> (rastreador atual), <code>garages</code> (localização do serviço), <code>vehicle_service_tasks</code>; rastreado em <code>vehicle_trackers_history</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Campos de dimensão física (<code>payload_length</code>, <code>payload_width</code>, <code>payload_height</code>, <code>gross_weight</code>) oferecem suporte à análise de planejamento de carga; as datas do Seguro permitem o rastreamento da conformidade</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>garages</code></strong></summary>

**Descrição**: Locais de oficinas e instalações de manutenção com coordenadas geográficas (latitude, longitude, raio) e informações de contato de mecânicos e despachantes, permitindo detectar visitas de serviço com base em geocercas e analisar a proximidade

<table><thead><tr><th width="135">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>garage_id</code> - Identificador da entidade oficina<br>- <code>user_id</code> - Identificador da entidade usuário<br>- <code>latitude</code> - Objeto de localização<br>- <code>longitude</code> - Objeto de localização<br>- <code>radius</code> - Tamanho da geolocalização em metros<br>- <code>address</code> - Objeto de localização<br>- <code>organization_label</code> - ID da Garagem<br>- <code>mechanic_name</code> - Nome do mecânico<br>- <code>dispatcher_name</code> - Nome do despachante</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Referenciado por <code>vehicles.garage_id</code> para atribuição de locais de atendimento</td></tr><tr><td><strong>Observações especiais</strong></td><td>Os campos de localização permitem detectar visitas de serviço com base em geocercas e analisar a proximidade</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>vehicle_service_tasks</code></strong></summary>

**Descrição**: Programação de manutenção e monitoramento do histórico de serviços com vários tipos de gatilho (baseados em data, Quilometragem e horas do motor), intervalos recorrentes de tarefas, notificações multicanal (e-mail, SMS, push) e distinção entre eventos de manutenção planejados (is\_repeat) e não planejados

<table><thead><tr><th width="132">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>service_task_id</code> - Identificador da entidade da tarefa de serviço<br>- <code>vehicle_id</code> - Identificador da entidade do veículo<br>- <code>description</code> - O atributo description da tabela vehicle_service_tasks<br>- <code>status</code> - O valor de status do atributo de status<br>- <code>cost</code> - O atributo de custo da tabela vehicle_service_tasks<br>- <code>start_date</code> - A data e a hora associadas ao atributo start_date<br>- <code>end_date</code> - A data e a hora associadas ao atributo end_date<br>- <code>completion_date</code> - A data e a hora associadas ao atributo completion_date<br>- <code>predicted_datetime</code> - A data e a hora associadas ao atributo predicted_datetime<br>- <code>mileage_limit</code> - O atributo mileage_limit da tabela vehicle_service_tasks<br>- <code>engine_hours_limit</code> - O atributo engine_hours_limit da tabela vehicle_service_tasks<br>- <code>start_mileage</code> - O atributo start_mileage da tabela vehicle_service_tasks<br>- <code>start_engine_hours</code> - O atributo start_engine_hours da tabela vehicle_service_tasks<br>- <code>mileage_notification_interval</code> - O atributo mileage_notification_interval da tabela vehicle_service_tasks<br>- <code>engine_hours_notification_interval</code> - O atributo engine_hours_notification_interval da tabela vehicle_service_tasks<br>- <code>date_notification_interval</code> - Convertendo um número inteiro N em N dias<br>- <code>mileage_repeat_interval</code> - O atributo mileage_repeat_interval da tabela vehicle_service_tasks<br>- <code>engine_hours_repeat_interval</code> - O atributo engine_hours_repeat_interval da tabela vehicle_service_tasks<br>- <code>date_repeat_interval</code> - Convertendo um número inteiro N em N dias<br>- <code>notification_emails</code> - O atributo notification_emails da tabela vehicle_service_tasks<br>- <code>notification_sms_phone_numbers</code> - O atributo notification_sms_phone_numbers da tabela vehicle_service_tasks<br>- <code>is_notification_push_enabled</code> - O atributo is_notification_push_enabled da tabela vehicle_service_tasks<br>- <code>completion_mileage</code> - O atributo completion_mileage da tabela vehicle_service_tasks<br>- <code>completion_engine_hours</code> - O atributo completion_engine_hours da tabela vehicle_service_tasks<br>- <code>is_repeat</code> - O atributo is_repeat da tabela vehicle_service_tasks<br>- <code>is_unplanned</code> - O atributo is_unplanned da tabela vehicle_service_tasks<br>- <code>comment</code> - O atributo comment da tabela vehicle_service_tasks</td></tr><tr><td><strong>Conteúdo</strong></td><td>Oferece suporte a três tipos de acionamento: por data, por quilometragem e por horas do motor; configurações de notificação por e-mail, SMS e push</td></tr><tr><td><strong>Observações especiais</strong></td><td><code>is_repeat</code> e os campos de intervalo permitem criar cronogramas de manutenção recorrente; <code>is_unplanned</code> distingue a manutenção programada da reativa</td></tr></tbody></table>

</details>

Localização e roteirização

<details>

<summary><strong><code>zones</code></strong></summary>

**Descrição**: áreas geocercadas que definem perímetros virtuais usando círculos ou polígonos para monitorar eventos de entrada e saída de veículos/ativos, oferecendo suporte à automação baseada em regras e à análise de localização, com codificação por cores para diferenciação visual

<table><thead><tr><th width="150">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>zone_id</code> - Identificador da entidade de zona<br>- <code>client_id</code> - Identificador da entidade do cliente<br>- <code>zone_label</code> - O atributo zone_label da tabela zones<br>- <code>zone_type</code> - O atributo zone_type da tabela zones<br>- <code>latitude</code> - Objeto opcional: a caixa delimitadora que pode conter totalmente o resultado retornado<br>- <code>longitude</code> - Objeto opcional: a caixa delimitadora que pode conter totalmente o resultado retornado<br>- <code>circle_center_latitude</code> - O atributo circle_center_latitude da tabela zones<br>- <code>circle_center_longitude</code> - O atributo circle_center_longitude da tabela zones<br>- <code>radius</code> - Tamanho da geolocalização em metros<br>- <code>address</code> - O atributo address da tabela zones<br>- <code>color</code> - O atributo color da tabela zones</td></tr><tr><td><strong>Conteúdo</strong></td><td>Os tipos de zona incluem círculo, polígono (definido por meio de <code>geofence_points</code>) e classificações especiais de áreas</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Referenciado por <code>rules2zones</code>, <code>users2zones</code>; vértices do polígono armazenados em <code>geofence_points</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>As funções do PostGIS podem ser usadas para verificar se um ponto está dentro de um polígono em análises complexas de geocercas.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Locais</code></strong></summary>

**Descrição**: Pontos de interesse com coordenadas geográficas, definições de raio e suporte a campos personalizados extensíveis para armazenar informações de contato do cliente e dados específicos do negócio, permitindo a integração com CRM/ERP por meio de external\_id e a geração de relatórios baseados em localização

<table><thead><tr><th width="129">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>place_id</code> - Identificador da entidade Lugar<br>- <code>user_id</code> - Identificador da entidade do usuário<br>- <code>place_label</code> - O atributo place_label da tabela de locais<br>- <code>latitude</code> - Objeto de localização<br>- <code>longitude</code> - Objeto de localização<br>- <code>radius</code> - Tamanho da geolocalização em metros<br>- <code>address</code> - O atributo de endereço da tabela Locais<br>- <code>description</code> - O atributo de descrição da tabela de locais<br>- <code>external_id</code> - ID para integração com sistemas externos (CRM)<br>- <code>custom_fields</code> - Campos adicionais<br>- <code>assigned_datetime</code> - Data e hora da atribuição do ponto de interesse ao usuário</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Estendido com valores de campos personalizados por meio de <code>places_text_fields</code>, <code>places_decimal_fields</code>, <code>places_bigint_fields</code>, <code>places_longtext_fields</code>, <code>places_linked_entity_fields</code></td></tr><tr><td><strong>Observações especiais</strong></td><td><code>custom_fields</code> O JSONB oferece acesso rápido; as tabelas relacionadas permitem filtrar e ordenar atributos personalizados</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>geofence_points</code></strong></summary>

**Descrição**: Coordenadas ordenadas dos vértices (o campo number determina a sequência) que definem os limites de polígonos para geocercas de formas complexas, permitindo perímetros geográficos precisos além de zonas circulares simples, usadas com PostGIS ST\_MakePolygon para operações geométricas

<table><thead><tr><th width="133">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>zone_id</code> - Um ID da zona à qual este formulário está associado<br>- <code>number</code> - Número de série<br>- <code>latitude</code> - Localização<br>- <code>longitude</code> - Localização</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Vários registros por <code>zone_id</code> definem os limites do polígono; <code>number</code> o campo determina a ordem dos vértices</td></tr><tr><td><strong>Observações especiais</strong></td><td>Consulte com <code>ORDER BY number</code> para reconstruir o caminho do polígono; use com o PostGIS ST_MakePolygon para operações geométricas</td></tr></tbody></table>

</details>

Gerenciamento de Tarefas e fluxos de trabalho

<details>

<summary><strong><code>Tarefas</code></strong></summary>

**Descrição**: Atribuições de ordens de serviço com validação de localização (latitude, longitude, raio), janelas de tempo (time\_from, time\_to), requisitos de duração da visita (stay\_duration\_minutes, arrival\_duration\_minutes), estrutura hierárquica por meio de parent\_task\_id e rastreamento de status para gestão de Serviço de campo e operações de entrega

<table><thead><tr><th width="130">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>task_id</code> - Identificador da entidade Tarefa<br>- <code>user_id</code> - Identificador da entidade de usuário<br>- <code>object_id</code> - Objeto de identificador da entidade<br>- <code>parent_task_id</code> - Identificador da entidade da tarefa pai<br>- <code>Tarefa</code> - O atributo task_label da tabela de Tarefas<br>- <code>status</code> - O valor de status do atributo de status<br>- <code>task_type</code> - Tipo de tarefa, tarefa, rota ou ponto de controle<br>- <code>latitude</code> - O atributo de latitude da tabela de tarefas<br>- <code>longitude</code> - O atributo de longitude da tabela de Tarefas<br>- <code>radius</code> - Tamanho da geolocalização em metros<br>- <code>arrival_datetime</code> - Quando o rastreador chega à área da Tarefa. IGNORADO ao criar/atualizar<br>- <code>created_at</code> - O atributo created_at da tabela de Tarefas<br>- <code>status_change_datetime</code> - Data e hora da atualização da Tarefa<br>- <code>time_from</code> - A data e hora associadas ao atributo time_from<br>- <code>time_to</code> - A data e hora associadas ao atributo time_to<br>- <code>stay_duration</code> - O atributo stay_duration da tabela de tarefas<br>- <code>stay_duration_minutes</code> - Duração da visita. O tempo que um trabalhador móvel deve permanecer no local da tarefa para concluí-la com sucesso. Visitas múltiplas são cumulativas<br>- <code>arrival_duration_minutes</code> - Ignorar visitas aleatórias mais curtas que a duração especificada. Ao calcular a duração mínima, as visitas mais curtas que a duração especificada serão ignoradas<br>- <code>max_delay_minuts</code> - Atraso aceitável. O tempo máximo que um funcionário pode se atrasar. Qualquer tarefa concluída durante esse período será marcada como "atrasada"<br>- <code>is_stay_control_enabled</code> - O atributo is_stay_control_enabled da tabela de tarefas<br>- <code>address</code> - O atributo address da tabela de tarefas<br>- <code>description</code> - Atributo description da tabela de tarefas<br>- <code>custom_fields</code> - O atributo custom_fields da tabela de tarefas<br>- <code>external_id</code> - Identificador da entidade externa<br>- <code>order_sort</code> - O atributo order_sort da tabela de tarefas<br>- <code>created_by</code> - Fonte da tarefa criada</td></tr><tr><td><strong>Conteúdo</strong></td><td>Oferece suporte a tarefas hierárquicas por meio de <code>parent_task_id</code>; janelas de tempo definidas por <code>time_from</code>/<code>time_to</code>; validação de geocerca com localização e raio</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Links para <code>forms</code> (coleta de dados), <code>task_history</code> (alterações de status), <code>objects</code> (rastreador atribuído)</td></tr><tr><td><strong>Observações especiais</strong></td><td><code>stay_duration</code> e <code>arrival_duration_minutes</code> ativar o monitoramento de conformidade para tarefas de entrega e serviço</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>forms</code></strong></summary>

**Descrição**: Formulários configuráveis de coleta de dados para registrar informações estruturadas durante a conclusão de tarefas ou check-ins no aplicativo móvel, com campos e valores armazenados como JSON, validação opcional de localização (is\_submission\_in\_zone) e requisitos de envio obrigatório quando anexados a tarefas

<table><thead><tr><th width="141">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>form_id</code> - Identificador da entidade do Formulário<br>- <code>task_id</code> - Um ID da tarefa à qual este formulário está associado<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>Formulário</code> - Rótulo do formulário definido pelo usuário<br>- <code>fields</code> - Se verdadeiro, o Formulário só pode ser enviado na zona da Tarefa<br>- <code>values</code> - Um mapa com IDs de campos como chaves e objetos field_value como valores. Chave usada para vincular o campo ao valor correspondente<br>- <code>submitted_at</code> - Data em que os valores do formulário foram enviados pela última vez<br>- <code>submission_latitude</code> - Local em que os valores do formulário foram enviados pela última vez<br>- <code>submission_longitude</code> - Local em que os valores do formulário foram enviados pela última vez<br>- <code>submission_address</code> - Local em que os valores do formulário foram enviados pela última vez<br>- <code>is_submission_in_zone</code> - Se verdadeiro, o Formulário só pode ser enviado na zona da Tarefa<br>- <code>description</code> - Data em que este Formulário foi criado (ou anexado à Tarefa)<br>- <code>created_at</code> - Data em que este Formulário foi criado (ou anexado à Tarefa)</td></tr><tr><td><strong>Conteúdo</strong></td><td><code>fields</code> define a estrutura do formulário (JSON); <code>values</code> contém os dados enviados (JSON)</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Links para <code>Tarefas</code> (ordem de serviço associada), <code>objects</code> (solicitante), mencionado em <code>checkins</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Sinalizador de validação de localização <code>is_submission_in_zone</code> permite regras de envio de formulários com base em geocercas</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>checkins</code></strong></summary>

**Descrição**: Registros de presença e atividade baseados em localização, enviados por meio de um aplicativo móvel, que monitoram os horários planejados e reais de chegada (planned\_datetime vs actual\_datetime), com coordenadas geográficas e medições de precisão da localização (radius) para relatórios de pontualidade

<table><thead><tr><th width="129">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>checkin_id</code> - Identificador da entidade de check-in<br>- <code>employee_id</code> - O identificador da entidade de funcionários também é o identificador dos Motoristas<br>- <code>object_id</code> - Dispositivo do funcionário<br>- <code>form_id</code> - Identificador da entidade do formulário<br>- <code>user_id</code> - Usuário funcionário<br>- <code>planned_datetime</code> - Horário do dispositivo em que o check-in foi realizado<br>- <code>actual_datetime</code> - Horário do servidor em que a solicitação/mensagem foi processada<br>- <code>latitude</code> - Localização em que os check-ins foram enviados<br>- <code>longitude</code> - Localização em que os check-ins foram enviados<br>- <code>radius</code> - Erro de posicionamento em um ponto, em metros<br>- <code>address</code> - Endereço do check-in<br>- <code>comment</code> - O atributo de comentário da tabela checkins</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Vincula funcionários a formulários e locais; rastreia desvios do cronograma planejado</td></tr><tr><td><strong>Observações especiais</strong></td><td>Variação de tempo entre <code>planned_datetime</code> e <code>actual_datetime</code> permite gerar relatórios de pontualidade; o raio define a tolerância aceitável de localização</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>task_history</code></strong></summary>

**Descrição**: Trilha de auditoria completa dos eventos do ciclo de vida da tarefa, registrando todas as alterações de status, atribuições, atualizações e modificações de campos com registros de data e hora (event\_datetime), identificação do usuário e tipos de atividade (create, update, assign, status\_change) armazenados no campo payload para fins de conformidade e análise do fluxo de trabalho

<table><thead><tr><th width="137">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>task_history_id</code> - Identificador da entidade do histórico de tarefas<br>- <code>task_id</code> - Identificador da entidade Tarefa<br>- <code>user_id</code> - Identificador da entidade do usuário<br>- <code>activity</code> - Operação realizada. Pode ser "create", "update", "assign" ou "status_change"<br>- <code>event_datetime</code> - Data e hora do evento<br>- <code>payload</code> - Depende da operação. Normalmente, contém os campos que foram alterados durante a operação</td></tr><tr><td><strong>Conteúdo</strong></td><td>Tipos de atividade definidos em <code>description_parameters</code>; <code>payload</code> armazena detalhes específicos do evento (texto)</td></tr><tr><td><strong>Observações especiais</strong></td><td>Essencial para a análise da conclusão de tarefas, a geração de relatórios sobre transições de status e o monitoramento da atividade do usuário</td></tr></tbody></table>

</details>

Regras e automação

<details>

<summary><strong><code>rules</code></strong></summary>

**Descrição**: Regras de detecção de eventos com condições de acionamento configuráveis (excesso de velocidade, violações de geocerca, limites de sensores, tempo em marcha lenta) armazenadas em parameters (JSONB), e configurações de notificação multicanal (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) para monitoramento e envio automático de alertas com base em dados do dispositivo e do servidor

<table><thead><tr><th width="131">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>rule_id</code> - Identificador da entidade da regra<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>client_id</code> - Identificador da entidade do cliente<br>- <code>event_type</code> - O atributo event_type da tabela rules<br>- <code>event_label</code> - O atributo event_label da tabela rules<br>- <code>event_group</code> - O atributo event_group da tabela de regras<br>- <code>description</code> - Atributo de descrição da tabela de regras<br>- <code>parameters</code> - Parâmetros do evento. Para mais detalhes sobre os parâmetros disponíveis, consulte <a href="https://www.navixy.com/docs/navixy-api/user-api/resources/tracking/tracker/rules/rule_types/">documentação da API da Navixy</a>.<br>- <code>alert_email</code> - E-mail para notificações<br>- <code>alert_sms</code> - Números de telefone para notificações por SMS<br>- <code>alert_phone</code> - Telefones para chamadas de voz<br>- <code>is_push_enabled</code> - Se true, as notificações push estão disponíveis<br>- <code>created_at</code> - O atributo created_at da tabela rules<br>- <code>is_deleted</code> - O atributo is_deleted da tabela rules<br>- <code>maximum</code> - Limites aplicados a várias regras. Por exemplo, para a regra de tempo ocioso com o motor ligado, em minutos<br>- <code>event_comment1</code> - O atributo event_comment1 da tabela rules<br>- <code>event_comment2</code> - O atributo event_comment2 da tabela rules</td></tr><tr><td><strong>Conteúdo</strong></td><td>Os parâmetros da regra (JSONB) definem as condições de acionamento; oferecem suporte a notificações por e-mail, SMS, telefone e push</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Vincula-se a objetos por meio de <code>rules2objects</code>, e a zonas por meio de <code>rules2zones</code></td></tr><tr><td><strong>Observações especiais</strong></td><td><code>event_type</code> define um cenário de monitoramento específico (excesso de velocidade, violação de geocerca, limite de sensor); <code>maximum</code> O campo habilita a agregação de eventos para alertas baseados em limites</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2objects</code></strong></summary>

**Descrição**: Relação muitos-para-muitos que vincula regras a objetos monitorados, com personalização de parâmetros por objeto por meio de object\_params (JSONB), permitindo diferentes valores de limite (por exemplo, limites de velocidade) para cada veículo ou ativo dentro da mesma regra

<table><thead><tr><th width="140">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>rule_id</code> - Identificador da entidade da regra<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>param_group_number</code> - O atributo param_group_number da tabela rules2objects<br>- <code>object_params</code> - O atributo object_params da tabela rules2objects</td></tr><tr><td><strong>Conteúdo</strong></td><td><code>object_params</code> (JSONB) permite a personalização de regras por objeto (por exemplo, limites de velocidade diferentes por veículo)</td></tr><tr><td><strong>Observações especiais</strong></td><td>O relacionamento muitos para muitos permite que uma regra monitore vários objetos com parâmetros diferentes.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2zones</code></strong></summary>

**Descrição**: Relacionamento muitos para muitos que associa regras a zonas delimitadas por geocercas, permitindo que uma única regra monitore eventos de entrada e saída em várias áreas geográficas para cenários complexos de monitoramento espacial

<table><thead><tr><th width="144">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>rule_id</code> - Identificador da entidade da regra<br>- <code>zone_id</code> - Identificador da entidade de zona</td></tr><tr><td><strong>Observações especiais</strong></td><td>A relação muitos para muitos permite o monitoramento de várias zonas para uma única regra (por exemplo, alertar ao entrar em qualquer uma de várias áreas restritas)</td></tr></tbody></table>

</details>

Status e categorização

<details>

<summary><strong><code>statuses</code></strong></summary>

**Descrição**: Definições personalizadas de status nas listas de status, incluindo propriedades de exibição (color para exibição no site, order\_sort para posicionamento), usadas para representar os estados de trabalho de dispositivos ou funcionários, com suporte à exclusão lógica por meio da flag is\_deleted

<table><thead><tr><th width="128">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>status_id</code> - Identificador da entidade de status<br>- <code>listing_id</code> - Identificador da entidade de listagem<br>- <code>status_label</code> - Valor do status do atributo status_label<br>- <code>color</code> - Cor usada para exibição no site<br>- <code>order_sort</code> - Posição de ordenação dentro do status da listagem<br>- <code>is_deleted</code> - O atributo is_deleted da tabela statuses</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Grupos de status organizados por <code>listing_id</code> (faz referência a <code>status_listings</code>); usado em <code>status_history</code></td></tr><tr><td><strong>Observações especiais</strong></td><td><code>order_sort</code> define a sequência de exibição; a cor permite a diferenciação visual nos relatórios</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_listings</code></strong></summary>

**Descrição**: Definições do conjunto de status que controlam quais valores de status estão disponíveis para dispositivos ou funcionários, com flags de permissão (is\_supervisor\_controlled, is\_employee\_controlled) que determinam se supervisores, funcionários ou ambos podem alterar os valores de status

<table><thead><tr><th width="144">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>status_listing_id</code> - Identificador da entidade de listagem de status<br>- <code>user_id</code> - Identificador da entidade do usuário<br>- <code>status_listing_label</code> - Valor de status do atributo status_listing_label<br>- <code>is_supervisor_controlled</code> - Se for true, os supervisores poderão alterar o status de trabalho, por exemplo, usando o aplicativo móvel de monitoramento<br>- <code>is_employee_controlled</code> - Se for true, os funcionários poderão alterar o próprio status de trabalho, por exemplo, usando o aplicativo móvel de rastreamento<br>- <code>is_deleted</code> - O atributo is_deleted da tabela status_listings</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Referenciado por <code>devices.status_listing_id</code> e <code>statuses.listing_id</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Os sinalizadores de controle determinam quem pode alterar os status: somente o supervisor, autoatendimento dos funcionários ou ambos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_history</code></strong></summary>

**Descrição**: Trilha de auditoria de todas as transições de status do dispositivo, com carimbos de data e hora (changed\_datetime no dispositivo, server\_datetime no servidor), atribuição ao usuário (updated\_by) e captura de localização (latitude, longitude, address), permitindo a análise geográfica das alterações de status e a geração de relatórios sobre os locais de início e término da jornada de trabalho

<table><thead><tr><th width="143">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>status_history_id</code> - Identificador da entidade do histórico de status<br>- <code>device_id</code> - Identificador da entidade do dispositivo<br>- <code>old_status_id</code> - Identificador da entidade do status antigo<br>- <code>new_status_id</code> - Identificador da entidade do status novo<br>- <code>updated_by</code> - A data e hora associadas ao atributo updated_by<br>- <code>changed_datetime</code> - Data e hora da atribuição de um novo status ao dispositivo<br>- <code>server_datetime</code> - Data e hora da atribuição do novo status do servidor<br>- <code>latitude</code> - Localização dos dispositivos durante alterações de status<br>- <code>longitude</code> - Localização dos dispositivos durante alterações de status<br>- <code>address</code> - Localização dos dispositivos durante alterações de status</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Links para <code>devices</code>, <code>statuses</code> (antigos e novos), <code>description_parameters</code> (para <code>updated_by</code> Função)</td></tr><tr><td><strong>Observações especiais</strong></td><td>A captura de localização permite analisar geograficamente as transições de status; é útil para gerar relatórios sobre os locais de início e término da jornada de trabalho.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>tags</code></strong></summary>

**Descrição**: Rótulos de categorização definidos pelo usuário e identificados por cores, que permitem filtrar e pesquisar rapidamente vários tipos de entidades (locais, geocercas, funcionários, tarefas, rastreadores, veículos) para uma organização flexível

<table><thead><tr><th width="149">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>tag_id</code> - Etiqueta de ID da entidade<br>- <code>user_id</code> - Identificador da entidade do usuário<br>- <code>tag_label</code> - O atributo tag_label da tabela tags<br>- <code>color</code> - O atributo de cor da tabela de Etiquetas</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Aplicado às entidades por meio de <code>tag_links</code>; escopo definido pelo usuário</td></tr><tr><td><strong>Observações especiais</strong></td><td>Sistema flexível de categorização que oferece suporte a várias etiquetas por entidade</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>tag_links</code></strong></summary>

**Descrição**: Tabela de relacionamento polimórfico que associa etiquetas a qualquer tipo de entidade por meio de entity\_type e entity\_id, com um campo ordinal para gerenciar a ordem de exibição, permitindo a aplicação flexível de etiquetas a várias entidades

<table><thead><tr><th width="127">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>tag_id</code> - Etiqueta de ID da entidade<br>- <code>entity_type</code> - O atributo entity_type da tabela tag_links<br>- <code>entity_id</code> - Identificador da entidade<br>- <code>ordinal</code> - O atributo ordinal da tabela tag_links</td></tr><tr><td><strong>Conteúdo</strong></td><td><code>entity_type</code> identifica a tabela (veículo, funcionário, Tarefa etc.); <code>ordinal</code> define a ordem de exibição</td></tr><tr><td><strong>Observações especiais</strong></td><td>A relação polimórfica permite adicionar tags a diferentes tipos de entidades</td></tr></tbody></table>

</details>

Grupos e hierarquia

<details>

<summary><strong><code>groups</code></strong></summary>

**Descrição**: Estrutura de agrupamento organizacional para rastreadores que permite a organização visual na interface do usuário com cores personalizáveis (group\_color) e gerenciamento hierárquico semelhante a pastas, atualmente com função puramente visual

<table><thead><tr><th width="148">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>group_id</code> - Grupo de rastreadores (vinculado por objects.group_id). A divisão em grupos pode ser vista na lista de beacons, por exemplo<br>- <code>client_id</code> - Identificador da entidade do cliente<br>- <code>group_label</code> - Título do grupo definido pelo usuário, de 1 a 60 caracteres imprimíveis, por exemplo, "Employees"<br>- <code>group_color</code> - Cor do Grupo no formato web (sem #), por exemplo, "FF6DDC". Determina a cor dos marcadores do rastreador no mapa</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Referenciado por <code>objects.group_id</code>; propriedade do cliente por meio de <code>client_id</code> (referências <code>users</code>)</td></tr><tr><td><strong>Observações especiais</strong></td><td>Permite organizar entidades de monitoramento em uma estrutura semelhante a pastas para relatórios e permissões</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>groups_objects</code></strong></summary>

**Descrição**: Relação muitos para muitos entre grupos e objetos usando uma chave primária composta (groups\_client\_id, objects\_client\_id), permitindo que os objetos pertençam a vários grupos simultaneamente para estruturas organizacionais flexíveis

<table><thead><tr><th width="135">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>groups_client_id</code> - Identificador da entidade cliente para grupos<br>- <code>objects_client_id</code> - Identificador da entidade cliente para objetos</td></tr><tr><td><strong>Observações especiais</strong></td><td>Permite que os objetos pertençam a vários grupos simultaneamente; consulte usando ambos os <code>client_id</code> valores para associação ao grupo</td></tr></tbody></table>

</details>

Campos customizados e entidades

<details>

<summary><strong><code>entities</code></strong></summary>

**Descrição**: Registro de tipos de entidade que define quais entidades de negócio oferecem suporte a campos customizados e a estrutura de organização de seus campos (seções, field\_order), armazenada em entity\_label (JSONB), permitindo a extensão dinâmica do esquema em locais, tarefas e outras entidades sem alterações no banco de dados

<table><thead><tr><th width="141">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>entity_id</code> - Identificador da entidade<br>- <code>user_id</code> - Identificador da entidade de usuário<br>- <code>entity_label</code> - id - int. Identificador da entidade. type - enum. Atualmente, apenas "Lugar" é compatível. layout - Objeto que descreve o layout dos campos da entidade. sections - array de objetos. Cada seção pode conter um ou mais campos. Um layout deve ter pelo menos uma seção. label - string. Nome da seção. field_order - array de strings. Campos integrados e IDs de Campos customizados (como strings)<br>- <code>builtin_type</code> - O atributo builtin_type da tabela entities</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Referenciado por <code>custom_fields</code> para definir quais campos customizados se aplicam a quais tipos de entidade</td></tr><tr><td><strong>Observações especiais</strong></td><td><code>builtin_type</code> se vincula a <code>description_parameters</code> para classificações de entidade definidas pelo sistema</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>custom_fields</code></strong></summary>

**Descrição**: Definições de campos customizados que permitem a extensão dinâmica do esquema para tipos de entidade, com tipos de campo configuráveis (custom\_field\_type), regras de validação e opções em parâmetros (JSONB), além de sinalizadores de obrigatoriedade (is\_required) para a captura flexível de dados em Locais, Tarefas e outras entidades

<table><thead><tr><th width="146">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>custom_field_id</code> - Identificador da entidade do campo personalizado<br>- <code>entity_id</code> - Identificador da entidade<br>- <code>custom_field_label</code> - Nome do campo<br>- <code>custom_field_type</code> - Tipo de dado do campo<br>- <code>description</code> - Descrição do campo<br>- <code>is_required</code> - Isso é obrigatório ou não?<br>- <code>parameters</code> - Parâmetros do campo</td></tr><tr><td><strong>Conteúdo</strong></td><td><code>parameters</code> (JSONB) armazena configurações específicas do tipo de campo (regras de validação, opções de lista suspensa etc.)</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Define os atributos personalizados disponíveis para entidades; o tipo de campo está vinculado a <code>description_parameters</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Permite a extensão dinâmica do esquema sem alterações no banco de dados; amplamente utilizado em <code>Locais</code> e <code>Tarefas</code></td></tr></tbody></table>

</details>

Rastreamento histórico

<details>

<summary><strong><code>driver_history</code></strong></summary>

**Descrição**: Registro completo de auditoria das atribuições de funcionários a veículos ao longo do tempo, monitorando as transições de old\_employee\_id para new\_employee\_id com registros de data e hora (changed\_datetime, server\_datetime), dados de localização (latitude, longitude, address), informações da chave de hardware e atribuição de usuário (updated\_by), permitindo análises específicas por motorista quando os motoristas trocam de veículo

<table><thead><tr><th width="146">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>driver_history_id</code> - Identificador da entidade de histórico do Motorista<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>old_employee_id</code> - Identificador da entidade do funcionário antigo<br>- <code>new_employee_id</code> - Identificador da entidade do novo funcionário<br>- <code>hardware_key</code> - O atributo hardware_key da tabela driver_history<br>- <code>changed_datetime</code> - Data e hora em que foram feitas alterações no dispositivo<br>- <code>server_datetime</code> - Data e hora das alterações feitas no servidor<br>- <code>updated_by</code> - A data e a hora associadas ao atributo updated_by<br>- <code>latitude</code> - O atributo de latitude da tabela driver_history<br>- <code>longitude</code> - O atributo de longitude da tabela driver_history<br>- <code>address</code> - O atributo de endereço da tabela driver_history</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Registra as atribuições de Motorista a Veículos ao longo do tempo; vincula a <code>employees</code> e <code>objects</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Essencial para relatórios específicos por motorista quando os motoristas trocam de veículo; a captura de localização permite analisar o local da mudança de atribuição</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>vehicle_trackers_history</code></strong></summary>

**Descrição**: Trilha de auditoria que rastreia quais dispositivos GPS (object\_id) foram instalados em quais veículos (vehicle\_id) ao longo do tempo, com registros de data e hora das alterações (changed\_datetime), permitindo a atribuição precisa de dados históricos e o cálculo da quilometragem quando os rastreadores são transferidos entre veículos

<table><thead><tr><th width="144">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>vehicle_tracker_history_id</code> - Identificador da entidade do histórico do rastreador veicular<br>- <code>vehicle_id</code> - Identificador da entidade do veículo<br>- <code>object_id</code> - Objeto identificador da entidade<br>- <code>changed_datetime</code> - A data e a hora associadas ao atributo changed_datetime</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Rastreia qual dispositivo GPS foi instalado em cada veículo ao longo do tempo</td></tr><tr><td><strong>Observações especiais</strong></td><td>Essencial para a análise de dados históricos quando os rastreadores são transferidos entre veículos; permite atribuir com precisão a quilometragem e o uso.</td></tr></tbody></table>

</details>

Dados de referência e consulta

<details>

<summary><strong><code>description_parameters</code></strong></summary>

**Descrição**: Dados de referência de todo o sistema que fornecem rótulos legíveis para humanos (description) para valores inteiros enumerados (key) usados em todo o banco de dados, organizados pelo campo type (por exemplo, task\_status, fuel\_type, counter\_type, entity\_classification) para uma tradução consistente dos valores em relatórios e na exibição da interface

<table><thead><tr><th width="146">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>key</code> - Valor possível no atributo<br>- <code>type</code> - Um atributo composto pelo nome da tabela, seguido de um sublinhado e do nome de um atributo da tabela<br>- <code>description</code> - Valor implícito de um atributo</td></tr><tr><td><strong>Conteúdo</strong></td><td>Fornece rótulos legíveis para valores codificados em todo o banco de dados (status da tarefa, tipos de combustível, tipos de contador etc.)</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Referenciado por chaves estrangeiras de várias tabelas para categorização padronizada</td></tr><tr><td><strong>Observações especiais</strong></td><td>Essencial para converter códigos inteiros em valores legíveis nos relatórios; <code>type</code> enumerações relacionadas aos grupos de campos</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>counters</code></strong></summary>

**Descrição**: Configurações de contadores de odômetro e de horas do motor que vinculam leituras de sensores do dispositivo (sensor\_id) a medições de distância ou tempo, com coeficientes multiplicadores para conversão de unidades (km, milhas, horas) e counter\_type de description\_parameters, que define o tipo de medição

<table><thead><tr><th width="140">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>counter_id</code> - ID interno<br>- <code>device_id</code> - Identificador da entidade do dispositivo<br>- <code>counter_type</code> - Tipo de contador<br>- <code>sensor_id</code> - Identificador da entidade do sensor<br>- <code>multiplier</code> - Coeficiente para converter valores em uma das métricas (km, l etc.)</td></tr><tr><td><strong>Relacionamentos</strong></td><td>Vincula dispositivos a leituras de sensores que representam contadores de distância ou tempo</td></tr><tr><td><strong>Observações especiais</strong></td><td><code>multiplier</code> converte pulsos do sensor em unidades reais (km, milhas, horas); <code>counter_type</code> de <code>description_parameters</code> define o tipo de medição</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_output_name</code></strong></summary>

**Descrição**: Rótulos personalizados para canais de saída do dispositivo, que mapeiam identificadores numéricos de saída (number) para nomes definidos pelo usuário (label), como "Door Lock" ou "Engine Block", para facilitar a leitura em relatórios e análises de comandos e estados de saída do dispositivo

<table><thead><tr><th width="140">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>device_id</code> - Identificador da entidade do dispositivo<br>- <code>number</code> - O atributo number da tabela device_output_name<br>- <code>label</code> - O atributo label da tabela device_output_name</td></tr><tr><td><strong>Conteúdo</strong></td><td>Mapeia os números dos canais de saída para nomes definidos pelo usuário (por exemplo, "Door Lock", "Engine Block")</td></tr><tr><td><strong>Observações especiais</strong></td><td>Permite gerar relatórios legíveis ao analisar comandos e estados de saída do dispositivo</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_settings</code></strong></summary>

**Descrição**: Pares de chave e valor de configuração do dispositivo, sincronizados a partir da plataforma de origem. Cada linha armazena uma configuração para um dispositivo específico.

<table><thead><tr><th width="140">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>device_id</code> - Identificador da entidade do dispositivo<br>- <code>key</code> - Nome da configuração<br>- <code>value</code> - Valor da configuração</td></tr><tr><td><strong>Chave primária</strong></td><td>Composta: <code>(device_id, key)</code></td></tr><tr><td><strong>Observações especiais</strong></td><td>Preenchida durante a sincronização completa do cliente. Use esta tabela para ler valores de configuração no nível do dispositivo junto com dados telemáticos ou comerciais.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>event_description</code></strong></summary>

**Descrição**: Tabela de referência dos códigos de eventos do rastreador com descrições legíveis. Contém 134 entradas que abrangem eventos comuns do rastreador, como SOS, Modo de repouso, Ignição e alterações nas entradas/saídas digitais.

<table><thead><tr><th width="140">Atributo</th><th>Detalhes</th></tr></thead><tbody><tr><td><strong>Campos principais</strong></td><td>- <code>event_id</code> - Código do evento (chave primária)<br>- <code>description</code> - Nome do evento legível</td></tr><tr><td><strong>Observações especiais</strong></td><td>Fazer junção com <code>raw_telematics_data.tracking_data_core</code> ligado <code>event_id</code> para exibir os nomes dos eventos em relatórios e painéis em vez de códigos numéricos.</td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview/bronze-layer/raw-business-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
