> 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 tabelas principais para análise SQL Este esquema contém mais de 40 tabelas cuidadosamente selecionadas para abranger diversos aspectos de negócios e casos de uso. Essas tabelas representam suas principais entidades de negócio, estrutura organizacional e dados operacionais. {% hint style="info" %} O diagrama interativo do esquema raw\_business\_data está disponível em **dbdiagram.io**: {% endhint %} Encontre abaixo os detalhes do esquema de dados de negócios brutos. {% code title="esquema raw\_business\_data" expandable="true" %} ```sql Table "vehicle_service_tasks" { "record_added_at" timestamp [not null] "start_mileage" numérico "comment" "character varying(255)" "status" "character varying(10)" [not null] "completion_date" timestamp "start_engine_hours" numérico "service_task_id" inteiro [não nulo] "is_notification_push_enabled" boolean [not null] intervalo "date_notification_interval" "predicted_datetime" timestamp "cost" numérico [não nulo] "mileage_limit" numérico "notification_emails" texto "is_unplanned" boolean [not null] "is_repeat" boolean [not null] "completion_engine_hours" integer "engine_hours_limit" numérico "mileage_repeat_interval" inteiro "vehicle_id" integer [not null] "engine_hours_notification_interval" integer "start_date" timestamp "mileage_notification_interval" inteiro "date_repeat_interval" intervalo "descrição" "character varying(255)" "notification_sms_phone_numbers" texto "end_date" carimbo de data/hora "engine_hours_repeat_interval" integer "completion_mileage" inteiro } Table "garages" { "record_added_at" timestamp [not null] "garage_id" integer [not null] "longitude" numérico "mechanic_name" "character varying(255)" "radius" inteiro [não nulo] "latitude" numérico "organization_label" "character varying(255)" "user_id" integer [not null] "dispatcher_name" "character varying(255)" "address" "character varying(255)" } Tabela "driver_history" { "server_datetime" timestamp [not null] "address" "character varying(255)" "updated_by" inteiro [não nulo] "object_id" inteiro "longitude" numérico "latitude" numérico "driver_history_id" integer [not null] "hardware_key" "character varying(64)" "new_employee_id" inteiro "changed_datetime" carimbo de data/hora "record_added_at" timestamp [not null] "old_employee_id" integer } Tabela "departments" { "record_added_at" timestamp [not null] "department_label" "character varying(255)" [not null] "latitude" numérico "department_id" integer [not null] "address" "character varying(255)" "radius" inteiro [não nulo] "longitude" numérico "user_id" integer [not null] } Table "checkins" { "radius" inteiro [não nulo] "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" inteiro [não nulo] "address" "character varying(255)" "planned_datetime" timestamp [not null] "Objeto_id" inteiro [não nulo] "checkin_id" integer [not null] "comentário" texto } Tabela "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] } Tabela "places_linked_entity_fields" { "value" bigint [not null] "record_added_at" timestamp [not null] "place_id" integer [not null] "field_id" integer [not null] } Table "places_text_fields" { "place_id" integer [not null] "record_added_at" timestamp [not null] "value" text [not null] "field_id" integer [not null] } Tabela "users2zones" { "zone_id" integer [not null] "record_added_at" timestamp [not null] "user_id" integer [not null] } Tabela "objects" { "record_added_at" timestamp [not null] "create_datetime" timestamp [not null] "client_id" integer [not null] "group_id" inteiro "object_label" "character varying(100)" "model" "character varying(64)" "is_clone" boolean [not null] "is_deleted" boolean [not null] "device_id" integer [not null] "Objeto_id" inteiro [não nulo] } Tabela "device_output_name" { "device_id" integer [not null] "record_added_at" timestamp [not null] "label" "character varying(100)" [not null] "number" integer [not null] } Tabela "geofence_points" { "longitude" numeric [not null] "number" integer [not null] "zone_id" integer [not null] "record_added_at" timestamp [not null] "latitude" numeric [not null] } Table "custom_fields" { "record_added_at" timestamp [not null] "entity_id" integer [not null] "is_required" boolean [not null] "custom_field_label" text [not null] "parâmetros" jsonb "custom_field_type" integer [not null] "descrição" texto "custom_field_id" integer [not null] } Tabela "places_decimal_fields" { "field_id" integer [not null] "record_added_at" timestamp [not null] "place_id" integer [not null] "value" numeric [not null] } Tabela "task_history" { "task_id" inteiro [não nulo] "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" texto } Table "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" inteiro [não nulo] } Tabela "locais" { "descrição" texto "custom_fields" jsonb "place_id" integer [not null] "external_id" "character varying(32)" "record_added_at" timestamp [not null] "user_id" integer "latitude" numérico "radius" inteiro "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] "record_added_at" timestamp [not null] "status_listing_label" "character varying(200)" [not null] } Tabela "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] } Tabela "vehicle_trackers_history" { "vehicle_id" integer [not null] "record_added_at" timestamp [not null] "Objeto_id" inteiro [não nulo] "changed_datetime" timestamp [não nulo] "vehicle_tracker_history_id" integer [not null] } Table "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] } Tabela "sensor_description" { "record_added_at" timestamp [not null] "parâmetros" 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" inteiro [não nulo] "calibration_data" jsonb } Table "entities" { "entity_label" jsonb "record_added_at" timestamp [not null] "entity_id" integer [not null] "builtin_type" integer [not null] "user_id" integer [not null] } Table "zones" { "address" "character varying(255)" "radius" inteiro [não nulo] "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 [não nulo] "latitude" numeric [not null] "record_added_at" timestamp [not null] "longitude" numeric [not null] } Table "vehicles" { "vehicle_id" integer [not null] "payload_length" numérico "VIN" "character varying(20)" "free_Seguro_policy_number" "character varying(50)" "vehicle_label" "character varying(100)" "payload_width" numérico "color" "character varying(6)" "reboque" "character varying(255)" "object_id" inteiro "vehicle_status_id" inteiro "liability_insurance_valid_till" timestamp "manufacture_year" inteiro "fuel_grade" "character varying(16)" "custo_de_combustível" numeric "fuel_tank_volume" numérico "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 "record_added_at" timestamp [not null] "trailer_reg_number" "character varying(32)" "free_insurance_valid_till_date" timestamp "gross_weight" numérico "standard_fuel_consumption" numérico "fuel_type" inteiro "payload_weight" numérico "additional_info" texto "vehicle_subtype" "character varying(32)" "número_da_apólice_de_Seguro_de_responsabilidade_civil" "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" inteiro "wheel_arrangement" "character varying(16)" } Tabela "tag_links" { "entity_id" integer [not null] "record_added_at" timestamp [not null] "entity_type" integer [not null] "ordinal" integer [not null] "tag_id" inteiro [não nulo] } Table "rules" { "rule_id" integer [not null] "Objeto_id" inteiro [não nulo] "parâmetros" 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" inteiro [não nulo] "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] } Tabela "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" numérico "record_added_at" timestamp [not null] "server_datetime" timestamp [not null] "changed_datetime" carimbo de data/hora "old_status_id" integer } Tabela "rules2zones" { "zone_id" integer [not null] "record_added_at" timestamp [not null] "rule_id" integer [not null] } Tabela "forms" { "Objeto_id" inteiro [não nulo] "descrição" texto "form_label" "character varying(255)" [not null] texto "campos" "created_at" timestamp [not null] "submission_address" "character varying(255)" "submission_latitude" numérico "form_id" inteiro [não nulo] "submission_longitude" numérico "is_submission_in_zone" boolean [not null] "valores" texto "record_added_at" timestamp [not null] "task_id" inteiro "submitted_at" carimbo de data/hora } Tabela "rules2objects" { "object_params" jsonb "param_group_number" inteiro [não nulo] "Objeto_id" inteiro [não nulo] "record_added_at" timestamp [not null] "rule_id" integer [not null] } Table "tasks" { "time_from" carimbo de data/hora "stay_duration_minutes" intervalo "external_id" "character varying(100)" "object_id" inteiro "task_type" inteiro intervalo "arrival_duration_minutes" "status" inteiro "arrival_datetime" timestamp "record_added_at" timestamp [not null] "task_id" inteiro [não nulo] "user_id" integer "status_change_datetime" carimbo de data/hora "order_sort" inteiro "time_to" carimbo de data/hora "max_delay_minuts" integer "is_stay_control_enabled" boolean "address" "character varying(255)" "task_label" "character varying(200)" [not null] "longitude" numérico "created_by" inteiro "description" text [not null] "radius" inteiro "latitude" numérico "stay_duration" integer "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] "record_added_at" timestamp [not null] } Table "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] "id_do_proprietário" inteiro [não nulo] "record_added_at" timestamp [not null] } Table "description_parameters" { "description" "character varying(150)" "record_added_at" timestamp [not null] "type" "character varying(100)" [not null] "key" integer [not null] } Table "users" { "company_label" "character varying(255)" [not null] "registration_datetime" timestamp "first_name" "character varying(100)" [not null] "master_id" integer "last_name" "character varying(100)" [not null] "birth_date" timestamp "timezone_label" "character varying(30)" "middle_name" "character varying(100)" [not null] "user_id" integer [not null] "locale" "character varying(10)" [not null] "record_added_at" timestamp [not null] } Tabela "counters" { "sensor_id" inteiro "multiplier" numeric [not null] "counter_id" integer [not null] "device_id" integer [not null] "counter_type" integer [not null] "record_added_at" timestamp [not null] } Table "employees" { "driver_license_valid_till" carimbo de data e hora "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" inteiro "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" numérico "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" inteiro [não nulo] "longitude" numérico } Tabela "places_longtext_fields" { "field_id" integer [not null] "value" text [not null] "record_added_at" timestamp [not null] "place_id" integer [not null] } Table "groups_objects" { "groups_client_id" integer "objects_client_id" integer Índices { (groups_client_id, objects_client_id) [pk] } } Tabela "device_settings" { "device_id" integer [not null] "key" "character varying" [não nulo] "value" texto Índices { (device_id, key) [pk] } } Table "event_description" { "event_id" integer [not null, pk] "descrição" texto } 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" < "Departamentos"."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" < "Tarefas"."task_type" Ref:\"description_parameters\".\"key\" < \"Veículos\".\"Combustível_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:\"Tarefas\".\"task_id\" < \"forms\".\"task_id\" Ref:"objects"."object_id" < "forms"."object_id" Ref:"Objeto"."object_id" < "Tarefas"."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" < "Locais"."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:"Locais"."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" < "Etiquetas"."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" < "Tarefas"."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" < "Veículos"."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 neste esquema são sincronizados com o DB central. As atualizações ocorrem de forma incremental à medida que as alterações acontecem no banco de dados MySQL de origem, normalmente em menos de 5 minutos após a alteração na origem. ## `description_parameters` O sistema inclui dados de referência para padronizar valores em todo o banco de dados:
Tipo de referênciaDescriçãoValores de exemplo
Definições de tipoTipos de entidade padrãovehicle_type: car, truck, bus
Códigos de statusValores de status da Tarefa e do sistemaTarefas_status: não atribuído, atribuído, concluído
Definições de unidadesUnidades de medida para sensoresunits_type: litro, galão, celsius
Classificações de entidadesCategorias de entidades de negócioentities_type: Lugar, Tarefa, cliente
## Principais tabelas por categoria As tabelas no **`raw_business_data`** Os schemas são organizados em categorias funcionais para facilitar a navegação. A tabela abaixo resume as tabelas principais por sua finalidade de negócios: Entidades principais de negócios
usuários **Descrição**: Contas de usuário que contêm informações de Perfil, vínculo com a empresa, configurações de localização (fuso horário, localidade) e relacionamentos hierárquicos via master\_id para estruturas de conta multinível
AtributoDetalhes
Campos principais- user_id - Identificador exclusivo do usuário
- company_label - Nome da empresa associada ao usuário
- first_name - Nome de usuário
- last_name - Sobrenome do usuário
- middle_name - Patronímico do usuário
- locale - Configurações de idioma do usuário
- timezone_label - Fuso horário no formato IANA
- master_id - ID do usuário principal (se o atual for um subordinado)
- registration_datetime - Data de cadastro no sistema
- birth_date - Data de nascimento do usuário
RelacionamentosUsuário pai via master_id, vinculado a funcionários, Departamentos, Locais, Tarefas por meio de user_id
Notas especiaisEntidade central que conecta dados organizacionais; master_id permite hierarquias de usuários para estruturas de conta multinível
funcionários **Descrição**: Registros de funcionários e motoristas usados para representar pessoas que trabalham para a organização, incluindo informações pessoais, detalhes de licença, atribuições de departamento, chaves de hardware para identificação iButton/RFID e dados de localização com suporte a geocercas
AtributoDetalhes
Campos principais- employee_id - Identificador da entidade de funcionário
- user_id - Identificador da entidade do usuário
- Objeto_id - Objeto identificador da entidade
- department_id - Um ID do departamento ao qual o funcionário foi atribuído
- first_name - O atributo first_name da tabela employees
- last_name - O atributo last_name da tabela employees
- middle_name - O atributo middle_name da tabela employees
- número_da_carteira_de_motorista - número da carteira de Motorista
- categorias_da_carteira_de_motorista - categorias de carteira de Motorista
- data_de_emissão_da_carteira_de_motorista - Data de emissão de uma carteira de motorista
- carteira_de_motorista_valida_ate - Data até uma carteira de Motorista válida
- hardware_key - Uma chave de hardware
- e-mail - E-mail do funcionário
- phone_number - Telefone do funcionário sem o sinal "+"
- address - Endereço do local
- personnel_number - Número pessoal do funcionário/motorista
- citizen_id_number - Número de Seguro Social
- latitude - Local associado a este funcionário
- longitude - Local associado a este funcionário
- radius - Local associado a este funcionário em metros
- consumo_de_Combustível - O atributo fuel_consumption da tabela de funcionários
- custo_de_Combustível - O atributo fuel_cost da tabela de funcionários
- is_deleted - O atributo is_deleted da tabela employees
RelacionamentosLinks para usuários, Departamentos, objetos (rastreador atribuído), rastreado em histórico_do_motorista e check-ins
Notas especiaisA chave de hardware permite a identificação do Motorista via iButton ou RFID; oferece suporte a geocercas com latitude, longitude, radius campos
Departamentos **Descrição**: Unidades organizacionais com dados de localização geográfica (latitude, longitude, raio) que permitem análises baseadas em geocerca para relatórios em nível de departamento e associação da localização do funcionário
AtributoDetalhes
Campos principais- department_id - Identificador da entidade Department
- user_id - Identificador da entidade do usuário
- department_label - O atributo department_label da tabela Departamentos
- latitude - Localização associada a estes Departamentos
- longitude - Localização associada a estes Departamentos
- radius - Tamanho da geolocalização em metros
- address - O atributo address da tabela Departamentos
RelacionamentosVincula os funcionários à estrutura organizacional por meio de department_id
Notas especiaisOs campos de localização oferecem suporte a análises baseadas em Geocerca para relatórios no nível de departamento
Monitor e monitoramento
dispositivos **Descrição**: Registro de dispositivos de rastreamento físico com identificadores de hardware (IMEI), informações do cartão SIM, status de conectividade de rede (intensidade do sinal, itinerância, operadora) e atribuições de listagem de status para o gerenciamento do ciclo de vida do dispositivo
AtributoDetalhes
Campos principais- device_id - ID do dispositivo
- id_do_Proprietário - ID do Proprietário do dispositivo em cuja conta o beacon foi adicionado
- device_imei - IMEI do dispositivo
- telefone - O número do cartão SIM do dispositivo
- status_listing_id - ID do Status do dispositivo
- network_label - O nome da rede à qual o cartão SIM está conectado
- signal_level - Intensidade do sinal do dispositivo
- has_roaming - Indicador de disponibilidade de roaming
- is_sim_blocked - Indicador de bloqueio do cartão SIM
- created_at - Data e hora em que a entrada foi criada
RelacionamentosEntidade principal vinculada a objetos, modelos, sensor_description, contadores; id_do_Proprietário referências users.user_id
Notas especiaisTodos os dados telemáticos em raw_telematics_data o esquema faz referência a esta tabela por meio de device_id
objetos **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
AtributoDetalhes
Campos principais- Objeto_id - Objeto identificador da entidade
- client_id - identificador da entidade cliente
- device_id - Identificador da entidade do dispositivo
- rótulo_do_objeto - Nome do objeto
- modelo - Modelo do dispositivo
- group_id - Grupo de ID de entidade
- create_datetime - Data e hora de criação de uma nova linha no servidor
- is_deleted - O atributo is_deleted da tabela objects
- is_clone - Sinal de clone
RelacionamentosHub central conectando dispositivos a usuários (client_id), detalhes do veículo, histórico de rastreamento, tarefas e regras
Notas especiaisRepresenta a "unidade rastreável" no sistema; um objeto por dispositivo em uso ativo
modelos **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
AtributoDetalhes
Campos principais- model_id - Identificador do modelo da entidade
- modelo - O atributo model da tabela models
- vendor - O nome da empresa que lançou o rastreador
- alternative_label - O atributo alternative_label da tabela models
- analog_amount - Número de entradas analógicas do rastreador
- digital_amount - Número de entradas discretas do rastreador
- outputs_amount - Número de saídas discretas do rastreador
- has_battery_level - Determina se o rastreador transmite leituras de carga da bateria
- has_altitude - Determina se o rastreador transmite altitude
- has_phone - Há um cartão SIM?
- has_gsm_level - Um rastreador pode transmitir a intensidade do sinal GSM?
- has_gsm_name - O rastreador pode transmitir o nome da rede GSM ou o código da operadora (MCC + MNC)?
- has_gsm_roaming - O rastreador pode transmitir o status de roaming?
- has_detach_button - O rastreador tem um sensor de remoção?
- type_output_control - Perfil de controle das saídas do rastreador
- type_special_control - Contém configurações especializadas e módulos funcionais para modelos individuais de dispositivo, como o modo de condução perigosa (hbm_telfm) para equipamentos Teltonika
- is_clone - O modelo é um clone de outro modelo?
ConteúdoSinalizadores booleanos de capacidade indicam quais campos de dados estão disponíveis para este tipo de dispositivo
Notas especiaisUse os sinalizadores de capacidade para determinar os sensores e entradas válidos ao consultar dados telemáticos
sensor_description **Descrição**: Configuração abrangente de sensores que vincula as entradas do dispositivo à lógica de negócio, 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
AtributoDetalhes
Campos principais- sensor_id - Identificador da entidade do sensor
- device_id - Identificador da entidade do dispositivo
- sensor_label - Nome do sensor para a interface
- input_label - O nome do campo da mensagem (atributo) do qual os dados do sensor são obtidos. Se for igual a "input_status", é um Sensor discreto
- sensor_type - Tipo de sensor
- units_type - Unidades de medida
- multiplier - Multiplicador - o número pelo qual multiplicar o valor do campo. Apenas para Sensores de medida
- divider - Divisor - o número pelo qual dividir o valor do campo. Apenas para Sensores de medida
- accuracy - 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 apenas para sensores de combustível
- calibration_data - O atributo calibration_data da tabela sensor_description
- input_id - Número da entrada para Sensor discreto
- group_id - Sensores do mesmo tipo com o mesmo group_id e source_id são considerados como pertencendo ao mesmo Grupo. Os dados deles são somados ou em média, dependendo do valor do group_type. Isso é necessário para sensores agregados. É usado em sensores de medição
- tipo_do_Grupo - 0 - somar os valores dos sensores dentro de um Grupo, 1 - média
- sensor_units - Nome da unidade inserido pelo usuário se units_type=0 (personalizado)
- parâmetros - Objeto opcional com parâmetros adicionais parent_ids - opcional array de parent_ids para sensor composto. volume - double. Opcional. Volume para sensor composto. parent_ids - opcional array de int. Array de parent_ids para sensor composto. volume - opcional. Double. Volume para 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. Valor máximo legal de redução por hora. max_lowering_by_mileage - opcional. Double. Valor máximo legal de redução 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, 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 faz sentido somente se o modelo do rastreador tiver o recurso has_custom_fields
RelacionamentosVincula entradas do dispositivo (de raw_telematics_data.inputs) para a lógica de negócios por meio de device_id e input_label correspondente
Notas especiaiscalibration_data (JSONB) armazena tabelas de calibração específicas do sensor para sensores de nível de Combustível; multiplier e divider converter valores brutos em unidades
Gerenciamento de Ativo
Veículos **Descrição**: Registro abrangente de veículos que contém 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 via object\_id para Gestão de Frotas e Monitor de conformidade
AtributoDetalhes
Campos principais- vehicle_id - Identificador da entidade do veículo
- user_id - Identificador da entidade do usuário
- Objeto_id - Objeto identificador da entidade
- garage_id - Identificador da entidade da garagem
- vehicle_label - O atributo vehicle_label da tabela Veículos
- registration_number - Número de registro/ Placa de um veículo
- VIN - O atributo VIN da tabela Veículos
- manufacture_year - O atributo manufacture_year da tabela de Veículos
- tipo_de_Combustível - O atributo fuel_type da tabela Veículos
- custo_de_Combustível - O atributo fuel_cost da tabela Veículos
- volume_tanque_de_Combustível - O atributo fuel_tank_volume da tabela Veículos
- max_speed - O atributo max_speed da tabela Veículos
- modelo - O atributo model da tabela Veículos
- cor - O atributo color da tabela de Veículos
- reboque - O atributo trailer da tabela de Veículos
- additional_info - O atributo additional_info da tabela de Veículos
- vehicle_type - O atributo vehicle_type da tabela Veículos
- vehicle_subtype - O atributo vehicle_subtype da tabela de veículos
- vehicle_status_id - Identificador da entidade status do veículo
- chassis_number - O atributo chassis_number da tabela Veículos
- frame_number - O atributo frame_number da tabela Veículos
- trailer_reg_number - O atributo trailer_reg_number da tabela Veículos
- payload_weight - O atributo payload_weight da tabela Veículos
- payload_height - O atributo payload_height da tabela Veículos
- payload_length - O atributo payload_length da tabela Veículos
- payload_width - O atributo payload_width da tabela Veículos
- passenger_capacity - um número máximo de passageiros
- gross_weight - O atributo gross_weight da tabela Veículos
- consumo padrão de Combustível - Consumo de combustível médio normal em litros por 100 km
- grau_de_combustível - O atributo fuel_grade da tabela Veículos
- wheel_arrangement - O atributo wheel_arrangement da tabela Veículos
- tyre_size - Tamanho do veículo: dimensões e tamanho das rodas
- tyres_number - Número de rodas
- número_da_apólice_de_seguro_de_responsabilidade_civil - O atributo liability_insurance_policy_number da tabela vehicles
- responsabilidade_Seguro_válido_até - A data até a qual o Seguro de responsabilidade civil é válido
- numero_da_apolice_de_seguro_gratis - O atributo free_insurance_policy_number da tabela de Veículos
- free_Seguro_valid_till_date - A data até a qual o Seguro gratuito é válido
RelacionamentosLinks para objetos (rastreador atual), garagens (local de serviço), tarefas_de_serviço_de_veículos; rastreado em vehicle_trackers_history
Notas especiaisCampos de dimensões físicas (payload_length, payload_width, payload_height, gross_weight) oferece suporte a análises de planejamento de carga; as datas de Seguro permitem Monitor de conformidade
garagens **Descrição**: Locais de instalações de serviço e Manutenção com coordenadas geográficas (latitude, longitude, raio), informações de contato de mecânicos e despachantes, permitindo detecção de visitas de serviço baseada em Geocerca e análise de proximidade
AtributoDetalhes
Campos principais- garage_id - Identificador da entidade da garagem
- user_id - Identificador da entidade do usuário
- latitude - Objeto de localização
- longitude - Objeto de localização
- radius - Tamanho da geolocalização em metros
- address - Objeto de localização
- organization_label - Garagem ID
- mechanic_name - Nome do mecânico
- dispatcher_name - Nome do despachante
RelacionamentosReferenciado por Veículos.garage_id para atribuição de local de serviço
Notas especiaisOs campos de localização permitem a detecção de visitas de serviço baseada em Geocerca e a análise de proximidade
tarefas_de_serviço_de_veículos **Descrição**: cronograma de Manutenção e Monitor do histórico de serviços com vários tipos de gatilho (baseados em data, baseados em Quilometragem, baseados em horas do motor), intervalos recorrentes de Tarefa, notificações multicanal (email, SMS, push) e distinção entre eventos de Manutenção planejados (is\_repeat) e não planejados
AtributoDetalhes
Campos principais- service_task_id - Identificador da entidade de tarefa de serviço
- vehicle_id - Identificador da entidade do veículo
- descrição - O atributo description da tabela vehicle_service_tasks
- status - O valor de status do atributo status
- custo - O atributo de custo da tabela vehicle_service_tasks
- start_date - A data e a hora associadas ao atributo start_date
- end_date - A data e hora associadas ao atributo end_date
- completion_date - A data e a hora associadas ao atributo completion_date
- predicted_datetime - A data e a hora associadas ao atributo predicted_datetime
- limite_de_quilometragem - O atributo mileage_limit da tabela vehicle_service_tasks
- engine_hours_limit - O atributo engine_hours_limit da tabela vehicle_service_tasks
- start_Quilometragem - O atributo start_mileage da tabela vehicle_service_tasks
- start_engine_hours - O atributo start_engine_hours da tabela vehicle_service_tasks
- intervalo_de_notificação_de_Quilometragem - O atributo mileage_notification_interval da tabela vehicle_service_tasks
- engine_hours_notification_interval - O atributo engine_hours_notification_interval da tabela vehicle_service_tasks
- date_notification_interval - Convertendo um inteiro N para N dias
- Quilometragem_repeat_interval - O atributo mileage_repeat_interval da tabela vehicle_service_tasks
- engine_hours_repeat_interval - O atributo engine_hours_repeat_interval da tabela vehicle_service_tasks
- date_repeat_interval - Convertendo um inteiro N para N dias
- notification_emails - O atributo notification_emails da tabela vehicle_service_tasks
- notification_sms_phone_numbers - O atributo notification_sms_phone_numbers da tabela vehicle_service_tasks
- is_notification_push_enabled - O atributo is_notification_push_enabled da tabela vehicle_service_tasks
- completion_quilometragem - O atributo completion_mileage da tabela vehicle_service_tasks
- completion_engine_hours - O atributo completion_engine_hours da tabela vehicle_service_tasks
- is_repeat - O atributo is_repeat da tabela vehicle_service_tasks
- is_unplanned - O atributo is_unplanned da tabela vehicle_service_tasks
- comentário - O atributo de comentário da tabela vehicle_service_tasks
ConteúdoOferece suporte a três tipos de gatilho: baseados em data, baseados em Quilometragem, baseados em horas de motor; configurações de notificação para email, SMS, push
Notas especiaisis_repeat e os campos de intervalo permitem agendamentos recorrentes de Manutenção; is_unplanned distingue Manutenção programada vs. reativa
Localização e roteamento
zonas **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ículo/Ativo, oferecendo suporte à automação baseada em regras e à análise de localização com codificação por cores para diferenciação visual
AtributoDetalhes
Campos principais- zone_id - Identificador da entidade zona
- client_id - identificador da entidade cliente
- zone_label - O atributo zone_label da tabela zones
- zone_type - O atributo zone_type da tabela zones
- latitude - Objeto opcional, a caixa delimitadora que pode conter totalmente o resultado retornado
- longitude - Objeto opcional, a caixa delimitadora que pode conter totalmente o resultado retornado
- circle_center_latitude - O atributo circle_center_latitude da tabela zones
- circle_center_longitude - O atributo circle_center_longitude da tabela zones
- radius - Tamanho da geolocalização em metros
- address - O atributo address da tabela zones
- cor - O atributo de cor da tabela de zonas
ConteúdoOs tipos de zona incluem círculo, polígono (definido via Geocerca_pontos), e classificações de áreas especiais
RelacionamentosReferenciado por rules2zones, users2zones; vértices do polígono armazenados em Geocerca_pontos
Notas especiaisFunções do PostGIS podem ser usadas para verificar ponto em polígono em análises complexas de Geocerca
Locais **Descrição**: Pontos de interesse com coordenadas geográficas, definições de raio e suporte extensível a campos personalizados para armazenar informações de contato do cliente e dados específicos do negócio, permitindo integração com CRM/ERP via external\_id e relatórios com base na localização
AtributoDetalhes
Campos principais- place_id - Lugar identificador de entidade
- user_id - Identificador da entidade do usuário
- lugar_label - O atributo place_label da tabela places
- latitude - Objeto de localização
- longitude - Objeto de localização
- radius - Tamanho da geolocalização em metros
- address - O atributo address da tabela Locais
- descrição - O atributo description da tabela de Locais
- external_id - ID para integração com sistemas externos (CRM)
- custom_fields - Campos adicionais
- assigned_datetime - Data e hora da atribuição do ponto de interesse ao usuário
RelacionamentosEstendido com valores de campos personalizados por meio de locais_campos_de_texto, Locais_decimal_fields, Locais_bigint_fields, Locais_longtext_fields, Locais_campos_de_entidades_vinculadas
Notas especiaiscustom_fields JSONB fornece acesso rápido; tabelas relacionadas permitem filtrar e classificar por atributos personalizados
Geocerca_pontos **Descrição**: Coordenadas ordenadas dos vértices (o campo number determina a sequência) definindo os limites do polígono para formas complexas de geocerca, permitindo perímetros geográficos precisos além de zonas circulares simples, usado com PostGIS ST\_MakePolygon para operações geométricas
AtributoDetalhes
Campos principais- zone_id - Um ID da zona à qual este Formulário está anexado
- number - Número de série
- latitude - Localização
- longitude - Localização
RelacionamentosVários registros por zone_id definem os limites do polígono; number o campo determina a ordem dos vértices
Notas especiaisConsultar com ORDER BY number para reconstruir o caminho do polígono; use com PostGIS ST_MakePolygon para operações geométricas
Gerenciamento de Tarefa e fluxo de trabalho
Tarefas **Descrição**: Atribuições de ordens de serviço com validação de localização (latitude, longitude, radius), janelas de tempo (time\_from, time\_to), requisitos de duração da visita (stay\_duration\_minutes, arrival\_duration\_minutes), estrutura hierárquica via parent\_task\_id e Monitor de status para gerenciamento de Serviço de Campo e operações de entrega
AtributoDetalhes
Campos principais- Tarefa_id - identificador da entidade Tarefa
- user_id - Identificador da entidade do usuário
- Objeto_id - Objeto identificador da entidade
- parent_task_id - Identificador da entidade da tarefa pai
- rótulo_da_tarefa - O atributo task_label da tabela Tarefas
- status - O valor de status do atributo status
- tipo de tarefa - Tipo de Tarefa, Tarefa, Rota ou ponto de controle
- latitude - O atributo de latitude da tabela Tarefas
- longitude - O atributo longitude da tabela de tarefas
- radius - Tamanho da geolocalização em metros
- arrival_datetime - Quando o rastreador chegar na área da Tarefa. IGNORADO ao criar/atualizar
- created_at - O atributo created_at da tabela Tarefas
- status_change_datetime - Data e hora da atualização da Tarefa
- time_from - A data e hora associadas ao atributo time_from
- time_to - A data e hora associadas ao atributo time_to
- stay_duration - O atributo stay_duration da tabela Tarefas
- stay_duration_minutes - Duração da visita. O tempo que um trabalhador móvel deve passar no local da atribuição para concluir a Tarefa com êxito. Várias visitas são cumulativas
- arrival_duration_minutes - Ignore visitas aleatórias mais curtas do que a duração especificada. Ao calcular a duração mínima, visitas mais curtas do que a duração especificada serão ignoradas
- max_delay_minuts - 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"
- is_stay_control_enabled - O atributo is_stay_control_enabled da tabela de Tarefas
- address - O atributo address da tabela de Tarefas
- descrição - O atributo Description da tabela de Tarefas
- custom_fields - O atributo custom_fields da tabela de Tarefas
- external_id - Identificador da entidade externa
- order_sort - O atributo order_sort da tabela de Tarefas
- created_by - Fonte da Tarefa criada
ConteúdoOferece suporte a Tarefas hierárquicas via parent_task_id; janelas de tempo definidas por time_from/time_to; validação de Geocerca com localização e raio
RelacionamentosLinks para formulários (coleta de dados), Tarefa_history (alterações de status), objetos (rastreador atribuído)
Notas especiaisstay_duration e arrival_duration_minutes habilite o monitoramento de conformidade para tarefas de entrega e serviço
formulários **Descrição**: Formulários configuráveis de coleta de dados para capturar informações estruturadas durante a conclusão da Tarefa 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 obrigatórios de envio quando anexados às Tarefas
AtributoDetalhes
Campos principais- form_id - Identificador da entidade do Formulário
- Tarefa_id - Um ID da Tarefa à qual este Formulário está anexado
- Objeto_id - Objeto identificador da entidade
- formulário_label - Rótulo de formulário definido pelo usuário
- campos - Se verdadeiro, Formulário pode ser enviado apenas na zona da Tarefa
- valores - Um mapa com IDs dos campos como chaves e objetos field_value como valores. Chave usada para vincular o campo e seu valor correspondente
- submitted_at - Data em que os valores do Formulário foram enviados pela última vez
- submission_latitude - Local em que os valores do Formulário foram enviados pela última vez
- submission_longitude - Local em que os valores do Formulário foram enviados pela última vez
- submission_address - Local em que os valores do Formulário foram enviados pela última vez
- is_submission_in_zone - Se verdadeiro, Formulário pode ser enviado apenas na zona da Tarefa
- descrição - Data em que este Formulário foi criado (ou anexado à Tarefa)
- created_at - Data em que este Formulário foi criado (ou anexado à Tarefa)
Conteúdocampos define a estrutura do Formulário (JSON); valores contém os dados enviados (JSON)
RelacionamentosLinks para Tarefas (ordem de serviço associada), objetos (remetente), referenciado em check-ins
Notas especiaisSinalizador de validação de localização is_submission_in_zone permite regras de envio de Formulário baseadas em Geocerca
check-ins **Descrição**: Registros de presença e atividade baseados na localização enviados por meio do aplicativo móvel, com rastreamento dos horários de chegada planejados versus reais (planned\_datetime vs actual\_datetime) com coordenadas geográficas e medições de precisão de localização (raio) para relatórios de pontualidade
AtributoDetalhes
Campos principais- checkin_id - Identificador da entidade Checkin
- employee_id - O identificador da entidade funcionário também é o identificador dos Motoristas
- Objeto_id - Dispositivo do funcionário
- form_id - Identificador da entidade do Formulário
- user_id - Usuário do funcionário
- planned_datetime - Hora do dispositivo quando o check-in foi realizado
- actual_datetime - Hora do servidor quando a solicitação/mensagem foi processada
- latitude - Local em que os check-ins foram enviados
- longitude - Local em que os check-ins foram enviados
- radius - Erro de posicionamento em um ponto em metros
- address - Endereço do check-in
- comentário - O atributo comment da tabela checkins
RelacionamentosConecta funcionários a formulários e locais; rastreia o desvio do cronograma planejado
Notas especiaisVariação de tempo entre planned_datetime e actual_datetime permite o relatório de pontualidade; o raio define a tolerância de localização aceitável
Tarefa_history **Descrição**: Trilha completa de auditoria 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 carimbos de data e hora (event\_datetime), atribuição de usuário e tipos de atividade (create, update, assign, status\_change) armazenados no campo payload para análise de conformidade e fluxo de trabalho
AtributoDetalhes
Campos principais- task_history_id - Identificador da entidade do histórico de Tarefa
- Tarefa_id - identificador da entidade Tarefa
- user_id - Identificador da entidade do usuário
- atividade - Operação que ocorreu. Pode ser "create", "update", "assign" ou "status_change"
- event_datetime - Data e hora do evento
- carga útil - Depende da operação. Normalmente, contém campos que foram alterados durante a operação
ConteúdoTipos de atividade definidos em description_parameters; carga útil armazena detalhes específicos do evento (texto)
Notas especiaisEssencial para a análise da conclusão de Tarefa, relatórios de transição de status e rastreamento da atividade do usuário
Regras e automação
regras **Descrição**: Regras de detecção de eventos com condições de acionamento configuráveis (excesso de velocidade, violações de Geocerca, limites de sensor, tempo ocioso) armazenadas em parâmetros (JSONB), e configurações de notificação multicanal (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) para monitoramento automatizado e alertas com base nos dados do dispositivo e do servidor
AtributoDetalhes
Campos principais- rule_id - Identificador da entidade da regra
- Objeto_id - Objeto identificador da entidade
- client_id - identificador da entidade cliente
- event_type - O atributo event_type da tabela rules
- event_label - O atributo event_label da tabela rules
- grupo_de_evento - O atributo event_group da tabela de regras
- descrição - Atributo de descrição da tabela de regras
- parâmetros - Parâmetros do evento. Para mais detalhes sobre os parâmetros disponíveis, veja Documentação da API da Navixy.
- alert_email - E-mail para notificações
- alert_sms - Números de telefone para notificações por SMS
- alert_phone - Telefones para chamadas de voz
- is_push_enabled - Se verdadeiro, as notificações por push estão disponíveis
- created_at - O atributo created_at da tabela de regras
- is_deleted - O atributo is_deleted da tabela de regras
- maximum - Limites aplicados a várias regras. Por exemplo, para a regra de tempo ocioso com o motor em funcionamento, em minutos
- event_comment1 - O atributo event_comment1 da tabela de regras
- event_comment2 - o atributo event_comment2 da tabela de regras
ConteúdoOs parâmetros da regra (JSONB) definem as condições de disparo; oferece suporte a e-mail, SMS, telefone e notificações push
RelacionamentosLinks para objetos via rules2objects, zonas via rules2zones
Notas especiaisevent_type define cenário específico de monitoramento (excesso de velocidade, violação de Geocerca, limite do sensor); maximum campo habilita a agregação de eventos para alertas baseados em limiar
rules2objects **Descrição**: relacionamento muitos-para-muitos que vincula regras a Objeto monitorado com personalização de parâmetros por Objeto via object\_params (JSONB), permitindo valores de limite diferentes (por exemplo, limites de velocidade) para cada veículo ou Ativo dentro da mesma regra
AtributoDetalhes
Campos principais- rule_id - Identificador da entidade da regra
- Objeto_id - Objeto identificador da entidade
- param_group_number - O atributo param_group_number da tabela rules2objects
- objeto_params - O atributo object_params da tabela rules2objects
Conteúdoobjeto_params (JSONB) permite a personalização de regras por Objeto (por exemplo, limites de velocidade diferentes por veículo)
Notas especiaisRelação muitos-para-muitos permite que uma regra monitore vários objetos com parâmetros diferentes
rules2zones **Descrição**: relação muitos-para-muitos que associa regras a zonas de geocerca, permitindo que uma única regra monitore eventos de entrada/saída em várias áreas geográficas para cenários complexos de monitoramento espacial
AtributoDetalhes
Campos principais- rule_id - Identificador da entidade da regra
- zone_id - Identificador da entidade de zona
Notas especiaisO relacionamento muitos-para-muitos permite monitoramento multizona para uma única regra (por exemplo, alerta ao entrar em qualquer uma de várias áreas restritas)
Status e categorização
status **Descrição**: Definições personalizadas de status nas listagens de status, incluindo propriedades de exibição (cor para exibição no site, order\_sort para posicionamento) usadas para representar estados de trabalho do dispositivo ou do funcionário com suporte a exclusão lógica por meio do sinalizador is\_deleted
AtributoDetalhes
Campos principais- status_id - Identificador da entidade de status
- listing_id - Identificador da entidade da listagem
- status_label - Valor de status do atributo status_label
- cor - Cor usada para exibição no site
- order_sort - Posição de ordenação dentro da listagem de status
- is_deleted - O atributo is_deleted da tabela statuses
RelacionamentosGrupos de status organizados por listing_id (referências status_listings); usado em status_history
Notas especiaisorder_sort define a sequência de exibição; a cor permite diferenciação visual em relatórios
status_listings **Descrição**: Definições dos conjuntos de status que controlam quais valores de status estão disponíveis para dispositivos ou funcionários, com sinalizadores de permissão (is\_supervisor\_controlled, is\_employee\_controlled) determinando se supervisores, funcionários ou ambos podem alterar os valores de status
AtributoDetalhes
Campos principais- status_listing_id - Identificador da entidade de listagem de status
- user_id - Identificador da entidade do usuário
- status_listing_label - Valor do status do atributo status_listing_label
- is_supervisor_controlled - Se verdadeiro, supervisores podem alterar o status de trabalho, por exemplo, usando o aplicativo de monitoramento móvel
- is_employee_controlled - Se verdadeiro, os funcionários podem alterar seu próprio status de trabalho, por exemplo, usando o aplicativo móvel de Monitor
- is_deleted - O atributo is_deleted da tabela status_listings
RelacionamentosReferenciado por devices.status_listing_id e statuses.listing_id
Notas especiaisAs flags de controle determinam quem pode alterar os status: somente supervisor, autoatendimento do funcionário ou ambos
status_history **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 de usuário (updated\_by) e captura de localização (latitude, longitude, address), permitindo análise geográfica das alterações de status e geração de relatórios de localização de início/fim da jornada de trabalho
AtributoDetalhes
Campos principais- status_history_id - Identificador da entidade do histórico de status
- device_id - Identificador da entidade do dispositivo
- old_status_id - Identificador da entidade do status antigo
- new_status_id - Identificador da entidade do novo status
- updated_by - A data e a hora associadas ao atributo updated_by
- changed_datetime - Data e hora da atribuição de um novo status no dispositivo
- server_datetime - Data e hora da atribuição do novo status do servidor
- latitude - Localização de dispositivos durante mudanças de status
- longitude - Localização de dispositivos durante mudanças de status
- address - Localização de dispositivos durante mudanças de status
RelacionamentosLinks para dispositivos, status (antigo e novo), description_parameters (para updated_by Função)
Notas especiaisA captura de localização permite análise geográfica das transições de status; útil para relatórios de localização de início/fim do expediente
Etiquetas **Descrição**: Rótulos de categorização definidos pelo usuário com codificação por cor que permitem filtragem e busca rápidas entre vários tipos de entidades (Locais, geocercas, funcionários, Tarefas, rastreadores, Veículos) para organização flexível
AtributoDetalhes
Campos principais- tag_id - Etiqueta de ID da entidade
- user_id - Identificador da entidade do usuário
- etiqueta_label - O atributo tag_label da tabela tags
- cor - O atributo de cor da tabela de Etiquetas
RelacionamentosAplicado às entidades via etiqueta_links; escopo definido pelo usuário
Notas especiaisSistema flexível de categorização que oferece suporte a várias Etiquetas por entidade
etiqueta_links **Descrição**: Tabela de relacionamento polimórfico que associa Etiquetas a qualquer tipo de entidade por meio de entity\_type e entity\_id, com campo ordinal para gerenciamento da ordem de exibição, permitindo etiquetagem flexível de múltiplas entidades
AtributoDetalhes
Campos principais- tag_id - Etiqueta de ID da entidade
- entity_type - O atributo entity_type da tabela tag_links
- entity_id - Identificador da entidade
- ordinal - O atributo ordinal da tabela tag_links
Conteúdoentity_type identifica a tabela (veículo, funcionário, tarefa, etc.); ordinal define a ordem de exibição
Notas especiaisRelacionamento polimórfico permite a marcação entre diferentes tipos de entidade
Grupos e hierarquia
grupos **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
AtributoDetalhes
Campos principais- group_id - Grupo do rastreador (vinculado por objects.group_id). A divisão em grupos pode ser vista na lista de balizas, por exemplo
- client_id - identificador da entidade cliente
- grupo_label - Título do Grupo especificado pelo usuário, de 1 a 60 caracteres imprimíveis, por exemplo, "Employees"
- cor_do_grupo - Cor do Grupo em formato web (sem #), por exemplo "FF6DDC". Determina a cor dos marcadores do rastreador no mapa
RelacionamentosReferenciado por objects.group_id; propriedade do cliente via client_id (referências usuários)
Notas especiaisPermite a organização semelhante a pastas de entidades de monitoramento para relatórios e permissões
groups_objects **Descrição**: Relação muitos-para-muitos entre grupos e objetos usando chave primária composta (groups\_client\_id, objects\_client\_id), permitindo que objetos pertençam a múltiplos grupos simultaneamente para estruturas organizacionais flexíveis
AtributoDetalhes
Campos principais- groups_client_id - Identificador da entidade cliente para grupos
- objects_client_id - Identificador da entidade cliente para objetos
Notas especiaisPermite que objetos pertençam a múltiplos grupos simultaneamente; consulte com ambos client_id valores para associação a grupos
Campos customizados e entidades
entidades **Descrição**: Registro de tipos de entidade que define quais entidades de negócio oferecem suporte a Campos customizados e sua estrutura de layout dos campos (sections, 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
AtributoDetalhes
Campos principais- entity_id - Identificador da entidade
- user_id - Identificador da entidade do usuário
- entity_label - id - int. Identificador da entidade. type - enum. Atualmente, apenas "Lugar" é suportado. layout - Objeto descreve o layout dos campos da entidade. sections - array de objetos. Cada seção pode conter um ou mais campos. Pelo menos uma seção deve existir em um layout. label - string. Nome da seção. field_order - array de strings. Campos integrados e IDs de Campos customizados (como strings)
- builtin_type - O atributo builtin_type da tabela entities
RelacionamentosReferenciado por custom_fields para definir quais Campos customizados se aplicam a quais tipos de entidade
Notas especiaisbuiltin_type links para description_parameters para classificações de entidades definidas pelo sistema
custom_fields **Descrição**: definições de campos personalizados 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 parameters (JSONB), e sinalizadores de obrigatoriedade (is\_required) para captura flexível de dados em Locais, Tarefas e outras entidades
AtributoDetalhes
Campos principais- custom_field_id - Identificador da entidade do campo personalizado
- entity_id - Identificador da entidade
- custom_field_label - Nome do campo
- custom_field_type - Tipo de dado no campo
- descrição - Descrição do campo
- is_required - Isto é obrigatório ou não?
- parâmetros - Parâmetros do campo
Conteúdoparâmetros (JSONB) armazena a configuração específica do tipo de campo (regras de validação, opções de lista suspensa, etc.)
RelacionamentosDefine os atributos personalizados disponíveis para entidades; o tipo de campo se vincula a description_parameters
Notas especiaisPermite a extensão dinâmica do esquema sem alterações no banco de dados; usado extensivamente em Locais e Tarefas
Monitor histórico
histórico_do_motorista **Descrição**: Trilha completa de auditoria das atribuições de funcionário para Veículos ao longo do tempo Monitorando transições de old\_employee\_id para new\_employee\_id com carimbos de data e hora (changed\_datetime, server\_datetime), dados de localização (latitude, longitude, address), informações de chave de hardware e atribuição de usuário (updated\_by), permitindo análises específicas do Motorista quando Motoristas alternam entre Veículos
AtributoDetalhes
Campos principais- id_historico_do_motorista - Identificador da entidade de histórico do Motorista
- Objeto_id - Objeto identificador da entidade
- old_employee_id - Identificador da entidade de funcionário anterior
- new_employee_id - Identificador da entidade de novo funcionário
- hardware_key - O atributo hardware_key da tabela driver_history
- changed_datetime - Alterações de data e hora foram feitas no dispositivo
- server_datetime - Data e hora das alterações feitas no servidor
- updated_by - A data e a hora associadas ao atributo updated_by
- latitude - O atributo latitude da tabela driver_history
- longitude - O atributo de longitude da tabela driver_history
- address - O atributo de endereço da tabela driver_history
RelacionamentosRastreia as atribuições de Motorista aos Veículos ao longo do tempo; vincula-se a funcionários e objetos
Notas especiaisEssencial para relatórios específicos de Motoristas quando os Motoristas trocam de Veículos; a captura de localização permite a análise de localização da mudança de atribuição
vehicle_trackers_history **Descrição**: Monitor do registro de auditoria de quais dispositivos GPS (object\_id) foram instalados em quais Veículos (vehicle\_id) ao longo do tempo com carimbos de data e hora de alteração (changed\_datetime), permitindo atribuição precisa de dados históricos e cálculo de Quilometragem quando os rastreadores são movidos entre Veículos
AtributoDetalhes
Campos principais- vehicle_tracker_history_id - Identificador da entidade do histórico do rastreador do veículo
- vehicle_id - Identificador da entidade do veículo
- Objeto_id - Objeto identificador da entidade
- changed_datetime - A data e a hora associadas ao atributo changed_datetime
RelacionamentosRegistra qual dispositivo GPS foi instalado em qual veículo ao longo do tempo
Notas especiaisCrítico para a análise de dados históricos quando rastreadores são movidos entre Veículos; permite atribuição precisa de Quilometragem e de uso
Dados de referência e consulta
description_parameters **Descrição**Dados de referência globais que fornecem rótulos legíveis por humanos (descrição) para valores inteiros enumerados (chave) 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 IU
AtributoDetalhes
Campos principais- chave - Valor possível no atributo
- tipo - Um atributo composto consistente no nome da tabela seguido de um sublinhado e do nome de um atributo na tabela
- descrição - Valor implícito de um atributo
ConteúdoFornece rótulos legíveis por humanos para valores codificados em todo o banco de dados (status de tarefa, tipos de combustível, tipos de contador, etc.)
RelacionamentosReferenciada por chaves estrangeiras de várias tabelas para categorização padronizada
Notas especiaisEssencial para traduzir códigos inteiros em valores legíveis em relatórios; tipo agrupamentos de campos de enumerações relacionadas
contadores **Descrição**: Configurações de contador de Odômetro e horas de 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
AtributoDetalhes
Campos principais- counter_id - ID interno
- device_id - Identificador da entidade do dispositivo
- counter_type - Tipo de contador
- sensor_id - Identificador da entidade do sensor
- multiplier - Coeficiente para converter valores em uma das métricas (km, l, etc.)
RelacionamentosVincula dispositivos a leituras de sensores que representam contadores de distância ou tempo
Notas especiaismultiplier converte pulsos do sensor em unidades reais (km, milhas, horas); counter_type de description_parameters define o tipo de medição
device_output_name **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 "Trava da porta" ou "Bloqueio do motor", para relatórios e análises legíveis de comandos e estados de saída do dispositivo
AtributoDetalhes
Campos principais- device_id - Identificador da entidade do dispositivo
- number - O atributo number da tabela device_output_name
- label - O atributo label da tabela device_output_name
ConteúdoMapeia números de canais de saída para nomes definidos pelo usuário (por exemplo, "Trava da porta" ou "Bloqueio do motor")
Notas especiaisPermite relatórios legíveis ao analisar comandos e estados de saída do dispositivo
device_settings **Descrição**: Pares de chave-valor de configuração do dispositivo sincronizados da plataforma de origem. Cada linha armazena uma configuração para um dispositivo específico.
AtributoDetalhes
Campos principais- device_id - Identificador da entidade do dispositivo
- chave - Nome da configuração
- valor - Valor da configuração
Chave primáriaComposto: (device_id, key)
Notas especiaisPreenchida durante a sincronização completa do cliente. Use esta tabela para ler valores de configuração no nível do dispositivo junto com dados de telemetria ou de negócios.
event_description **Descrição**: Tabela de referência dos códigos de eventos do rastreador com descrições legíveis por humanos. Contém 134 entradas que abrangem eventos comuns do rastreador, como SOS, Modo de repouso, Ignição e alterações de entrada/saída digital.
AtributoDetalhes
Campos principais- event_id - Código do evento (chave primária)
- descrição - Nome do evento legível por humanos
Notas especiaisAssocie a raw_telematics_data.rastreamento_data_core em event_id para exibir nomes de eventos em relatórios e painéis em vez de códigos numéricos.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/pt-br/iot-query/schema-overview/bronze-layer/raw-business-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.