Camada Bronze

A camada Bronze contém dois esquemas de dados distintos, cada um servindo a diferentes aspectos da plataforma de telemática e inteligência de negócios:

• raw_business_data - contendo tabelas, atributos e valores relacionados às informações de negócios, como veículos, funcionários, geocercas adicionadas por usuários, etc.

• raw_telematics_data - contendo tabelas, atributos e valores relacionados aos dados telemáticos transmitidos pelos dispositivos em monitoramento, como localizações, entradas, saídas e eventos.

Cada esquema é otimizado para seu domínio de dados e padrões de acesso específicos, fornecendo cobertura abrangente das necessidades de gerenciamento operacional, telemático e de ativos.

raw_business_data estrutura

Este esquema contém mais de 40 tabelas cuidadosamente selecionadas para cobrir vários aspectos de negócios e casos de uso. Essas tabelas representam suas entidades centrais de negócios, estrutura organizacional e dados operacionais.

O diagrama interativo do esquema raw_business_data está disponível em dbdiagram.io: https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a

Encontre detalhes do esquema raw business data abaixo.

esquema raw_business_data

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

Tabela "garages" {
  "record_added_at" timestamp [not null]
  "garage_id" integer [not null]
  "longitude" numeric
  "mechanic_name" "character varying(255)"
  "radius" integer [not null]
  "latitude" numeric
  "organization_label" "character varying(255)"
  "user_id" integer [not null]
  "dispatcher_name" "character varying(255)"
  "address" "character varying(255)"
}

Tabela "driver_history" {
  "server_datetime" timestamp [not null]
  "address" "character varying(255)"
  "updated_by" integer [not null]
  "object_id" integer
  "longitude" numeric
  "latitude" numeric
  "driver_history_id" integer [not null]
  "hardware_key" "character varying(64)"
  "new_employee_id" integer
  "changed_datetime" timestamp
  "record_added_at" timestamp [not null]
  "old_employee_id" integer
}

Tabela "departments" {
  "record_added_at" timestamp [not null]
  "department_label" "character varying(255)" [not null]
  "latitude" numeric
  "department_id" integer [not null]
  "address" "character varying(255)"
  "radius" integer [not null]
  "longitude" numeric
  "user_id" integer [not null]
}

Tabela "checkins" {
  "radius" integer [not null]
  "latitude" numeric [not null]
  "employee_id" integer [not null]
  "longitude" numeric [not null]
  "record_added_at" timestamp [not null]
  "actual_datetime" timestamp [not null]
  "user_id" integer [not null]
  "form_id" integer [not null]
  "address" "character varying(255)"
  "planned_datetime" timestamp [not null]
  "object_id" integer [not null]
  "checkin_id" integer [not null]
  "comment" text
}

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]
}

Tabela "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" integer
  "object_label" "character varying(100)"
  "model" "character varying(64)"
  "is_clone" boolean [not null]
  "is_deleted" boolean [not null]
  "device_id" integer [not null]
  "object_id" integer [not null]
}

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]
}

Tabela "custom_fields" {
  "record_added_at" timestamp [not null]
  "entity_id" integer [not null]
  "is_required" boolean [not null]
  "custom_field_label" text [not null]
  "parameters" jsonb
  "custom_field_type" integer [not null]
  "description" text
  "custom_field_id" integer [not null]
}

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" integer [not null]
  "activity" integer [not null]
  "task_history_id" integer [not null]
  "record_added_at" timestamp [not null]
  "user_id" integer [not null]
  "event_datetime" timestamp [not null]
  "payload" text
}

Tabela "tags" {
  "tag_label" "character varying(64)" [not null]
  "color" "character varying(6)"
  "user_id" integer [not null]
  "record_added_at" timestamp [not null]
  "tag_id" integer [not null]
}

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

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]
  "object_id" integer [not null]
  "changed_datetime" timestamp [not null]
  "vehicle_tracker_history_id" integer [not null]
}

Tabela "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]
  "parameters" jsonb
  "input_id" integer [not null]
  "accuracy" numeric [not null]
  "sensor_units" "character varying(10)"
  "multiplier" doubleprecision [not null]
  "input_label" "character varying(64)"
  "sensor_label" "character varying(100)"
  "units_type" integer [not null]
  "divider" doubleprecision [not null]
  "group_id" integer [not null]
  "sensor_id" integer [not null]
  "device_id" integer [not null]
  "sensor_type" "character varying(45)" [not null]
  "group_type" integer [not null]
  "calibration_data" jsonb
}

Tabela "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]
}

Tabela "zones" {
  "address" "character varying(255)"
  "radius" integer [not null]
  "zone_id" integer [not null]
  "circle_center_latitude" numeric [not null]
  "client_id" integer [not null]
  "zone_label" "character varying(100)"
  "color" "character varying(6)" [not null]
  "zone_type" "character varying(20)" [not null]
  "circle_center_longitude" numeric [not null]
  "latitude" numeric [not null]
  "record_added_at" timestamp [not null]
  "longitude" numeric [not null]
}

Tabela "vehicles" {
  "vehicle_id" integer [not null]
  "payload_length" numeric
  "vin" "character varying(20)"
  "free_insurance_policy_number" "character varying(50)"
  "vehicle_label" "character varying(100)"
  "payload_width" numeric
  "color" "character varying(6)"
  "trailer" "character varying(255)"
  "object_id" integer
  "vehicle_status_id" integer
  "liability_insurance_valid_till" timestamp
  "manufacture_year" integer
  "fuel_grade" "character varying(16)"
  "fuel_cost" numeric
  "fuel_tank_volume" numeric
  "model" "character varying(100)"
  "garage_id" integer
  "payload_height" numeric
  "max_speed" numeric
  "registration_number" "character varying(32)"
  "tyre_size" "character varying(50)"
  "passenger_capacity" integer
  "record_added_at" timestamp [not null]
  "trailer_reg_number" "character varying(32)"
  "free_insurance_valid_till_date" timestamp
  "gross_weight" numeric
  "standard_fuel_consumption" numeric
  "fuel_type" integer
  "payload_weight" numeric
  "additional_info" text
  "vehicle_subtype" "character varying(32)"
  "liability_insurance_policy_number" "character varying(50)"
  "frame_number" "character varying(32)"
  "user_id" integer [not null]
  "vehicle_type" integer [not null]
  "chassis_number" "character varying(32)"
  "tyres_number" integer
  "wheel_arrangement" "character varying(16)"
}

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" 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)" [not null]
  "client_id" integer [not null]
  "is_push_enabled" boolean [not null]
  "event_comment1" "character varying(255)" [not null]
  "event_label" "character varying(255)" [not null]
  "description" "character varying(255)" [not null]
  "record_added_at" timestamp [not null]
  "alert_sms" text [not null]
  "event_group" integer [not null]
  "created_at" timestamp [not null]
  "maximum" integer [not null]
  "is_deleted" boolean [not null]
  "alert_email" text [not null]
  "event_comment2" "character varying(255)" [not null]
}

Tabela "status_history" {
  "longitude" numeric
  "new_status_id" integer
  "status_history_id" integer [not null]
  "device_id" integer [not null]
  "updated_by" integer [not null]
  "address" "character varying(255)"
  "latitude" numeric
  "record_added_at" timestamp [not null]
  "server_datetime" timestamp [not null]
  "changed_datetime" timestamp
  "old_status_id" integer
}

Tabela "rules2zones" {
  "zone_id" integer [not null]
  "record_added_at" timestamp [not null]
  "rule_id" integer [not null]
}

Tabela "forms" {
  "object_id" integer [not null]
  "description" text
  "form_label" "character varying(255)" [not null]
  "fields" text
  "created_at" timestamp [not null]
  "submission_address" "character varying(255)"
  "submission_latitude" numeric
  "form_id" integer [not null]
  "submission_longitude" numeric
  "is_submission_in_zone" boolean [not null]
  "values" text
  "record_added_at" timestamp [not null]
  "task_id" integer
  "submitted_at" timestamp
}


Tabela "rules2objects" {
  "object_params" jsonb
  "param_group_number" integer [not null]
  "object_id" integer [not null]
  "record_added_at" timestamp [not null]
  "rule_id" integer [not null]
}

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

Tabela "places_bigint_fields" {
  "field_id" integer [not null]
  "value" bigint [not null]
  "place_id" integer [not null]
  "record_added_at" timestamp [not null]
}

Tabela "devices" {
  "is_sim_blocked" boolean [not null]
  "device_id" integer [not null]
  "device_imei" "character varying(64)" [not null]
  "network_label" "character varying(50)" [not null]
  "status_listing_id" integer [not null]
  "signal_level" numeric [not null]
  "phone" "character varying(32)" [not null]
  "has_roaming" boolean [not null]
  "created_at" timestamp [not null]
  "owner_id" integer [not null]
  "record_added_at" timestamp [not null]
}

Tabela "description_parametrs" {
  "description" "character varying(150)"
  "record_added_at" timestamp [not null]
  "type" "character varying(100)" [not null]
  "key" integer [not null]
}

Tabela "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" integer
  "multiplier" numeric [not null]
  "counter_id" integer [not null]
  "device_id" integer [not null]
  "counter_type" integer [not null]
  "record_added_at" timestamp [not null]
}

Tabela "employees" {
  "driver_license_valid_till" timestamp
  "record_added_at" timestamp [not null]
  "last_name" "character varying(100)"
  "department_id" integer
  "citizen_id_number" "character varying(32)"
  "first_name" "character varying(100)"
  "driver_license_categories" "character varying(32)"
  "user_id" integer [not null]
  "phone_number" "character varying(32)"
  "object_id" integer
  "is_deleted" boolean [not null]
  "driver_license_issue_date" boolean
  "hardware_key" "character varying(64)"
  "middle_name" "character varying(100)"
  "address" "character varying(255)"
  "latitude" numeric
  "employee_id" integer [not null]
  "personnel_number" "character varying(15)"
  "fuel_cost" doubleprecision
  "driver_license_number" "character varying(32)"
  "email" "character varying(100)"
  "fuel_consumption" doubleprecision
  "radius" integer [not null]
  "longitude" numeric
}

Tabela "places_longtext_fields" {
  "field_id" integer [not null]
  "value" text [not null]
  "record_added_at" timestamp [not null]
  "place_id" integer [not null]
}

Tabela "raw_device_data" {
  "device_id" integer
  "device_time" timestamp
  "created_at" timestamp
  "gps_fix_type" integer
  "longitude" integer
  "latitude" integer
  "altitude" integer
  "speed" integer
  "satellites" integer
  "hdop" integer
  "event_id" integer
  "inputs" jsonb
  "states" jsonb
}

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

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

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_parametrs"."key" < "counters"."counter_type"

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

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

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

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

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

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

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

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

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

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

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

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

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

Frequência de atualização

Os dados neste esquema são sincronizados com o banco de dados principal. As atualizações ocorrem de forma incremental à medida que ocorrem alterações no banco de dados MySQL de origem, tipicamente 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ência	Descrição	Valores de exemplo
Definições de tipo	Tipos de entidade padrão	vehicle_type: car, truck, bus
Códigos de status	Valores de status de tarefas e do sistema	tasks_status: unassigned, assigned, done
Definições de unidade	Unidades de medida para sensores	units_type: liter, gallon, celsius
Classificações de entidade	Categorias de entidade de negócio	entities_type: place, task, customer

Tabelas-chave por categoria

As tabelas no raw_business_data esquema estão organizadas em categorias funcionais para facilitar a navegação. A tabela abaixo resume as tabelas principais por seu propósito de negócio:

Entidades de negócio principais

users

Finalidade: Informações da conta de usuário e perfil

Atributo	Detalhes
Campos-chave	user_id, company_label, first_name, last_name, middle_name, locale, timezone_label, master_id, registration_datetime
Relacionamentos	Usuário pai via master_id, vinculado a employees, departments, places, tasks através de user_id
Notas especiais	Entidade central que conecta dados organizacionais; master_id habilita hierarquias de usuário para estruturas de conta em múltiplos níveis

employees

Finalidade: Registros de empregados e motoristas com detalhes de habilitação e designação

Atributo	Detalhes
Campos-chave	employee_id, user_id, object_id, department_id, first_name, last_name, driver_license_number, driver_license_valid_till, hardware_key
Relacionamentos	Vínculos com users, departments, objects (rastreado atribuído), rastreado em driver_history e checkins
Notas especiais	A chave de hardware permite identificação do motorista via iButton ou RFID; oferece suporte a geofencing com latitude, longitude, raio campos

departments

Finalidade: Unidades organizacionais com localização geográfica

Atributo	Detalhes
Campos-chave	department_id, user_id, department_label, latitude, longitude, raio, endereço
Relacionamentos	Vincula empregados à estrutura organizacional através de department_id
Notas especiais	Campos de localização suportam análises baseadas em geocercas para relatórios em nível de departamento

Rastreamento e monitoramento

devices

Finalidade: Informações do dispositivo físico de rastreamento e status de rede

Atributo	Detalhes
Campos-chave	device_id, owner_id, device_imei, phone, status_listing_id, network_label, signal_level, has_roaming, created_at
Relacionamentos	Entidade central vinculada a objects, models, sensor_description, counters; owner_id references users.user_id
Notas especiais	Todos os dados telemáticos no raw_telematics_data esquema referenciam esta tabela via device_id

objects

Finalidade: Entidades monitoradas (veículos, ativos, pessoal)

Atributo	Detalhes
Campos-chave	object_id, client_id, device_id, object_label, model, group_id, create_datetime, is_deleted
Relacionamentos	Nexus central conectando dispositivos a usuários (client_id), detalhes do veículo, histórico de rastreamento, tarefas e regras
Notas especiais	Representa a "unidade rastreável" no sistema; um objeto por dispositivo em uso ativo

models

Finalidade: Especificações de hardware e capacidades do dispositivo

Atributo	Detalhes
Campos-chave	model_id, model, vendor, alternative_label, analog_amount, digital_amount, outputs_amount, has_battery_level, has_altitude, has_phone
Conteúdo	Flags booleanas de capacidade indicam quais campos de dados estão disponíveis para este tipo de dispositivo
Notas especiais	Use as flags de capacidade para determinar sensores e entradas válidos ao consultar dados telemáticos

sensor_description

Finalidade: Configuração e dados de calibração do sensor

Atributo	Detalhes
Campos-chave	sensor_id, device_id, sensor_label, input_label, sensor_type, units_type, multiplier, divider, accuracy, calibration_data
Relacionamentos	Vincula entradas do dispositivo (de raw_telematics_data.inputs) à lógica de negócio por meio de device_id e input_label matching
Notas especiais	calibration_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 para unidades

Gestão de ativos

vehicles

Finalidade: Especificações do veículo, documentação e parâmetros operacionais

Atributo	Detalhes
Campos-chave	vehicle_id, user_id, object_id, garage_id, vehicle_label, registration_number, vin, manufacture_year, fuel_type, fuel_cost, standard_fuel_consumption, max_speed
Relacionamentos	Vínculos com objects (rastreador atual), garages (local de serviço), vehicle_service_tasks; rastreado em vehicle_trackers_history
Notas especiais	Campos de dimensão física (payload_length, payload_width, payload_height, gross_weight) suportam análises de planejamento de carga; datas de seguro permitem acompanhamento de conformidade

garages

Finalidade: Localizações de serviço e manutenção

Atributo	Detalhes
Campos-chave	garage_id, user_id, latitude, longitude, raio, endereço, organization_label, mechanic_name, dispatcher_name
Relacionamentos	Referenciado por vehicles.garage_id para atribuição de local de serviço
Notas especiais	Campos de localização permitem detecção de visitas de serviço baseada em geocerca e análise de proximidade

vehicle_service_tasks

Finalidade: Programações de manutenção e histórico de serviço

Atributo	Detalhes
Campos-chave	service_task_id, vehicle_id, descrição, status, custo, start_date, end_date, completion_date, predicted_datetime, mileage_limit, engine_hours_limit
Conteúdo	Suporta três tipos de gatilho: baseado em data, baseado em quilometragem, baseado em horas de motor; configurações de notificação por e-mail, SMS, push
Notas especiais	is_repeat e campos de intervalo permitem cronogramas de manutenção recorrentes; is_unplanned distingue manutenção programada de reativa

Localização e roteamento

zones

Finalidade: Áreas geocercadas para monitoramento e automação

Atributo	Detalhes
Campos-chave	zone_id, client_id, zone_label, zone_type, latitude, longitude, circle_center_latitude, circle_center_longitude, raio, endereço, color
Conteúdo	Os tipos de zona incluem círculo, polígono (definido via geofence_points), e classificações de área especiais
Relacionamentos	Referenciado por rules2zones, users2zones; vértices do polígono armazenados em geofence_points
Notas especiais	Funções PostGIS podem ser usadas para verificar ponto-em-polígono para análises complexas de geocercas

places

Finalidade: Pontos de interesse com atributos personalizados

Atributo	Detalhes
Campos-chave	place_id, user_id, place_label, latitude, longitude, raio, endereço, descrição, external_id, custom_fields
Relacionamentos	Estendido com valores de campos personalizados através de places_text_fields, places_decimal_fields, places_bigint_fields, places_longtext_fields, places_linked_entity_fields
Notas especiais	custom_fields JSONB fornece acesso rápido; tabelas relacionadas permitem filtragem e ordenação por atributos personalizados

geofence_points

Finalidade: Coordenadas de vértice do polígono para formas complexas de geocerca

Atributo	Detalhes
Campos-chave	zone_id, number, latitude, longitude
Relacionamentos	Múltiplos registros por zone_id definem limites do polígono; number campo determina a ordem dos vértices
Notas especiais	Consulte com ORDER BY number para reconstruir o caminho do polígono; use com PostGIS ST_MakePolygon para operações geométricas

Gestão de tarefas e fluxo de trabalho

tasks

Finalidade: Atribuições de ordens de trabalho e acompanhamento de execução

Atributo	Detalhes
Campos-chave	task_id, user_id, object_id, parent_task_id, task_label, status, task_type, latitude, longitude, raio, arrival_datetime, created_at, status_change_datetime, custom_fields
Conteúdo	Suporta tarefas hierárquicas via parent_task_id; janelas de tempo definidas por time_from/time_to; validação por geocerca com localização e raio
Relacionamentos	Vínculos com forms (coleta de dados), task_history (mudanças de status), objects (rastreador atribuído)
Notas especiais	stay_duration e arrival_duration_minutes habilitam monitoramento de conformidade para tarefas de entrega e serviço

forms

Finalidade: Formulários de coleta de dados e submissões

Atributo	Detalhes
Campos-chave	form_id, task_id, object_id, form_label, campos, values, submitted_at, submission_latitude, submission_longitude, is_submission_in_zone
Conteúdo	campos define a estrutura do formulário (JSON); values contém dados submetidos (JSON)
Relacionamentos	Vínculos com tasks (ordem de trabalho associada), objects (remetente), referenciado em checkins
Notas especiais	Flag de validação de localização is_submission_in_zone habilita regras de submissão de formulário baseadas em geocerca

checkins

Finalidade: Registros de presença e atividade baseados em localização

Atributo	Detalhes
Campos-chave	checkin_id, employee_id, object_id, form_id, user_id, planned_datetime, actual_datetime, latitude, longitude, raio, endereço, comentário
Relacionamentos	Conecta empregados a formulários e locais; rastreia desvio do cronograma planejado
Notas especiais	Variação de tempo entre planned_datetime e actual_datetime habilita relatórios de pontualidade; o raio define a tolerância aceitável de localização

task_history

Finalidade: Trilho de auditoria para eventos do ciclo de vida da tarefa

Atributo	Detalhes
Campos-chave	task_history_id, task_id, user_id, atividade, event_datetime, payload
Conteúdo	Tipos de atividade definidos em description_parametrs; payload armazena detalhes específicos do evento (texto)
Notas especiais	Essencial para análise de conclusão de tarefas, relatórios de transição de status e rastreamento de atividade do usuário

Regras e automação

rules

Finalidade: Gatilhos de eventos e configurações de alerta

Atributo	Detalhes
Campos-chave	rule_id, object_id, client_id, event_type, event_label, event_group, descrição, parâmetros, alert_email, alert_sms, alert_phone, is_push_enabled, created_at, is_deleted
Conteúdo	Parâmetros da regra (JSONB) definem condições de disparo; suporta e-mail, SMS, telefone e notificações push
Relacionamentos	Vínculos a objetos via rules2objects, zonas via rules2zones
Notas especiais	event_type define cenário de monitoramento específico (excesso de velocidade, violação de geocerca, limite de sensor); máximo campo possibilita agregação de eventos para alertas baseados em limiar

rules2objects

Finalidade: Associações regra-para-objeto com parâmetros específicos da instância

Atributo	Detalhes
Campos-chave	rule_id, object_id, param_group_number, object_params
Conteúdo	object_params (JSONB) permite personalização da regra por objeto (por exemplo, diferentes limites de velocidade por veículo)
Notas especiais	Relacionamento muitos-para-muitos permite que uma regra monitore múltiplos objetos com parâmetros diferentes

rules2zones

Finalidade: Associa regras a gatilhos de geocerca

Atributo	Detalhes
Campos-chave	rule_id, zone_id
Notas especiais	Relacionamento muitos-para-muitos habilita monitoramento multi-zona para uma única regra (por exemplo, alertar ao entrar em qualquer uma de várias áreas restritas)

Status e categorização

statuses

Finalidade: Definições de status personalizadas para listagens de status

Atributo	Detalhes
Campos-chave	status_id, listing_id, status_label, color, order_sort, is_deleted
Relacionamentos	Grupos de status organizados por listing_id (referências status_listings); usados em status_history
Notas especiais	order_sort define sequência de exibição; a cor permite diferenciação visual em relatórios

status_listings

Finalidade: Definições de conjunto de status para dispositivos ou empregados

Atributo	Detalhes
Campos-chave	status_listing_id, user_id, status_listing_label, is_supervisor_controlled, is_employee_controlled, is_deleted
Relacionamentos	Referenciado por devices.status_listing_id e statuses.listing_id
Notas especiais	Flags de controle determinam quem pode alterar status: somente supervisor, autoatendimento do empregado ou ambos

status_history

Finalidade: Trilho de auditoria para mudanças de status

Atributo	Detalhes
Campos-chave	status_history_id, device_id, old_status_id, new_status_id, updated_by, changed_datetime, server_datetime, latitude, longitude, endereço
Relacionamentos	Vínculos com devices, statuses (antigo e novo), description_parametrs (para updated_by role)
Notas especiais	Captura de localização permite análise geográfica de transições de status; útil para relatórios de início/fim do dia de trabalho por localização

tags

Finalidade: Etiquetas de categorização definidas pelo usuário

Atributo	Detalhes
Campos-chave	tag_id, user_id, tag_label, color
Relacionamentos	Aplicado a entidades via tag_links; escopo definido pelo usuário
Notas especiais	Sistema de categorização flexível suportando múltiplas tags por entidade

tag_links

Purpose: Associa tags a entidades etiquetadas

Atributo	Detalhes
Campos-chave	tag_id, entity_type, entity_id, ordinal
Conteúdo	entity_type identifica a tabela (veículo, empregado, tarefa, etc.); ordinal define ordem de exibição
Notas especiais	Relacionamento polimórfico permite etiquetagem através de diferentes tipos de entidade

Grupos e hierarquia

groups

Finalidade: Agrupamento organizacional para objetos (rastreadores)

Atributo	Detalhes
Campos-chave	group_id, client_id, group_label, group_color
Relacionamentos	Referenciado por objects.group_id; propriedade do cliente via client_id (referências users)
Notas especiais	Permite organização em pastas de entidades de monitoramento para relatórios e permissões

groups_objects

Finalidade: Relacionamento muitos-para-muitos entre grupos e objetos

Atributo	Detalhes
Campos-chave	Chave primária composta: groups_client_id, objects_client_id
Notas especiais	Permite que objetos pertençam a múltiplos grupos simultaneamente; consulte com ambos client_id valores para associação ao grupo

Campos e entidades personalizadas

entities

Finalidade: Definições de tipo de entidade para o framework de campos personalizados

Atributo	Detalhes
Campos-chave	entity_id, user_id, entity_label, builtin_type
Relacionamentos	Referenciado por custom_fields para definir quais campos personalizados se aplicam a quais tipos de entidade
Notas especiais	builtin_type vínculos com description_parametrs para classificações de entidade definidas pelo sistema

custom_fields

Finalidade: Definições de campo personalizado

Atributo	Detalhes
Campos-chave	custom_field_id, entity_id, custom_field_label, custom_field_type, descrição, is_required, parâmetros
Conteúdo	parâmetros (JSONB) armazena configuração específica do tipo de campo (regras de validação, opções de dropdown, etc.)
Relacionamentos	Define atributos personalizados disponíveis para entidades; o tipo de campo se vincula a description_parametrs
Notas especiais	Permite extensão dinâmica do esquema sem alterações no banco de dados; usado extensivamente em places e tasks

Rastreamento histórico

driver_history

Finalidade: Registro de alteração de atribuição de empregado para objeto

Atributo	Detalhes
Campos-chave	driver_history_id, object_id, old_employee_id, new_employee_id, hardware_key, changed_datetime, server_datetime, updated_by, latitude, longitude, endereço
Relacionamentos	Rastreia atribuições de motoristas a veículos ao longo do tempo; vincula a employees e objects
Notas especiais	Essencial para relatórios específicos por motorista quando motoristas trocam de veículo; a captura de localização permite análise do local de mudança de atribuição

vehicle_trackers_history

Finalidade: Registro de alteração de atribuição de veículo para rastreador

Atributo	Detalhes
Campos-chave	vehicle_tracker_history_id, vehicle_id, object_id, changed_datetime
Relacionamentos	Rastreia qual dispositivo GPS foi instalado em qual veículo ao longo do tempo
Notas especiais	Crítico para análise histórica de dados quando rastreadores são movidos entre veículos; possibilita atribuição precisa de quilometragem e uso

Dados de referência e consulta

description_parametrs

Finalidade: Dados de referência do sistema e valores enumerados

Atributo	Detalhes
Campos-chave	key, type, descrição
Conteúdo	Fornece rótulos legíveis para valores codificados em todo o banco de dados (status de tarefa, tipos de combustível, tipos de contador, etc.)
Relacionamentos	Referenciado via chaves estrangeiras de múltiplas tabelas para categorização padronizada
Notas especiais	Essencial para traduzir códigos inteiros em valores legíveis em relatórios; type grupos de campos relacionados a enumerações

counters

Finalidade: Configuração de rastreamento de odômetro e horas de motor

Atributo	Detalhes
Campos-chave	counter_id, device_id, counter_type, sensor_id, multiplier
Relacionamentos	Vincula dispositivos a leituras de sensores que representam contadores de distância ou tempo
Notas especiais	multiplier converte pulsos do sensor em unidades reais (km, milhas, horas); counter_type de description_parametrs define o tipo de medição

device_output_name

Finalidade: Rótulos personalizados para canais de saída do dispositivo

Atributo	Detalhes
Campos-chave	device_id, number, label
Conteúdo	Mapeia números de canais de saída para nomes definidos pelo usuário (por exemplo, "Door Lock", "Engine Block")
Notas especiais	Habilita relatórios legíveis ao analisar comandos e estados de saída do dispositivo

raw_telematics_data estrutura

O raw_telematics_data esquema contém três tipos principais de tabelas que trabalham em conjunto para fornecer dados abrangentes do dispositivo.

ERD de telemetria bruta da camada Bronze

O diagrama interativo do esquema raw_telematics_data está disponível em dbdiagram.io: https://dbdiagram.io/d/v1-schema-telematics-bd-67a0acef263d6cf9a0d8e750

Encontre detalhes do esquema de telemetria bruta abaixo.

esquema raw_telematics_data

Tabela tracking_data_core {

  device_id integer [primary key]

  device_time timestampz [primary key]

  platform_time timestampz

  record_added_at timestampz [default: `now()`]

  latitude integer

  longitude integer

  speed integer

  altitude integer

  satellites integer

  event_id integer

  gps_fix_type integer

  hdop integer

  

  índices {(device_id, device_time)}

}

  

Tabela inputs {

  event_id integer [primary key]

  device_id integer [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  sensor_name text [primary key]

  value text

  índices {(device_id, device_time)}

}

  

Tabela states {

  event_id integer [primary key]

  device_id serial [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  state_name text [primary key]

  value text

  índices {(device_id, device_time)}

}

  

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

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

Tabelas-chave por categoria

Cada tabela tem um propósito específico na captura de diferentes aspectos das informações do dispositivo:

tracking_data_core

Finalidade: Dados centrais de localização e movimento

Atributo	Detalhes
Campos-chave	device_id, device_time, platform_time, latitude, longitude, speed, altitude, satellites, hdop, event_id
Indexação	Otimizado com índice em (device_id, device_time)
Notas especiais	Os dados de localização (latitude e longitude) usam formato inteiro com precisão de 10⁷ para desempenho ideal no TimescaleDB A velocidade também é armazenada em inteiro, portanto é necessário dividi-la por 100

inputs

Finalidade: Leituras de sensores dos dispositivos

Atributo	Detalhes
Campos-chave	input_id, device_id, device_time, sensor_name, value
Conteúdo	Leituras analógicas (nível de combustível, temperatura, voltagem), valores calculados (RPM do motor)
Relacionamentos	FROM raw_telematics_data.inputs AS i JOIN raw_business_data.sensor_description AS sd ON i.device_id = sd.device_id AND i.sensor_name = sd.input_label JOIN raw_telematics_data.tacking_data_core AS tdc ON i.device_id = tdc.device_id AND i.device_time = tdc.device_time

states

Finalidade: Indicadores de status do dispositivo e modos operacionais

Atributo	Detalhes
Campos-chave	state_id, device_id, device_time, state_name, value
Conteúdo	Indicadores de modo de operação (trabalhando, ocioso, desligado), status de componentes (ignição, portas)
Formato do valor	Valores booleanos (1/0) ou códigos de status específicos

Os dados neste esquema são ingeridos diretamente dos dispositivos, com baixa latência (tipicamente segundos). O esquema é otimizado para dados de séries temporais usando TimescaleDB para armazenamento e recuperação eficientes.

Informações adicionais

Validação de dados

O banco de dados impõe integridade dos dados por meio de múltiplos mecanismos:

• restrições CHECK validam que os valores estejam dentro de intervalos aceitáveis

• chaves estrangeiras garantem que os relacionamentos entre tabelas permaneçam consistentes

• restrições NOT NULL garantem que campos obrigatórios sempre tenham valores

• valores DEFAULT fornecem um fallback quando os dados não são explicitamente fornecidos

Otimização de consultas

As tabelas são organizadas com estratégias específicas de indexação:

• Todas as tabelas incluem índices baseados em tempo em record_added_at

• Colunas de chave estrangeira possuem índices dedicados para performance de joins

• Combinações de colunas usadas com frequência têm índices compostos

• O TimescaleDB fornece índices especializados para consultas de séries temporais

repo estrutura de dados

Este esquema está atualmente em desenvolvimento. Se estiver interessado em acesso antecipado ou tiver dúvidas sobre esta funcionalidade, entre em contato com [email protected].

O repo o esquema fornece uma estrutura abrangente para gerenciar estruturas organizacionais, ativos, dispositivos e seus relacionamentos em ambientes multitenant. Construído sobre PostgreSQL 14+ com a extensão ltree, o esquema suporta organizações hierárquicas, definições de campos personalizados para qualquer tipo de entidade, controle de acesso baseado em funções com restrições a nível de objeto e trilhas de auditoria completas com rastreamento de alteração a nível de campo. Todas as entidades podem ser estendidas sem modificações no esquema, localizadas para implantações internacionais e vinculadas por meio de relacionamentos polimórficos flexíveis.

O esquema aborda cenários complexos de gerenciamento de dados, incluindo hierarquias de ativos de frota em níveis organizacionais, plataformas SaaS multitenant que exigem isolamento de dados, operações orientadas à conformidade com requisitos detalhados de auditoria e sistemas que precisam de modelos de dados dinâmicos adaptáveis por meio de campos personalizados em vez de migrações de banco de dados.

O diagrama interativo derepo esquema de dados está disponível em dbdiagram.io: https://dbdiagram.io/d/Navixy-Repo-data-schema-68ad788c1e7a611967a0930e

Encontre os repo detalhes do esquema abaixo.

repo esquema de dados

// ============================================
// Novo Esquema DataHub - Jornada do Cliente
// PostgreSQL 14+ com extensão ltree
// Versão: 2.0 (Conceito)
// ============================================

// ============================================
// TABELAS DE REFERÊNCIA BASE (hierarquia ci_base)
// ============================================

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

Tabela ci_module {
  id uuid [primary key]
}

Tabela ci_catalog_category {
  id uuid [primary key]
}

Tabela ci_country {
  id uuid [primary key]
}

Tabela ci_role {
  id uuid [primary key]
}

Tabela ci_entity_type {
  id uuid [primary key]
}

Tabela ci_device_status {
  id uuid [primary key]
}

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

Tabela ci_device_type {
  id uuid [primary key]
}

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

Tabela ci_asset_type_category {
  id uuid [primary key]
}

Tabela ci_inventory_type {
  id uuid [primary key]
}

Tabela ci_organization_type {
  id uuid [primary key]
}

Tabela ci_user_type {
  id uuid [primary key]
}

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

Tabela ci_device_relation_type {
  id uuid [primary key]
}

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

// ============================================
// ENTIDADE BASE COM SUPORTE A CAMPOS PERSONALIZADOS
// ============================================

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

// ============================================
// ENTIDADES CORE DE NEGÓCIO
// ============================================

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

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

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

// ============================================
// CONTROLE DE ACESSO (ACL)
// ============================================

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

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

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

// ============================================
// ENTIDADES DE NEGÓCIO
// ============================================

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

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

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

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

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

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

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

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

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

// ============================================
// LOCALIZAÇÃO
// ============================================

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

// ============================================
// CAMPOS PERSONALIZADOS - DEFINIÇÕES
// ============================================

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

// ============================================
// CAMPOS PERSONALIZADOS - VALORES (por tipo)
// ============================================

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

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

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

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

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

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

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

// ============================================
// AUDITORIA
// ============================================

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

// ============================================
// RELACIONAMENTOS
// ============================================

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

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

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

Ref: customizable_entity.entity_type_id > ci_entity_type.id

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ref: entity_tag.tag_id > ci_tag.id

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

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

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

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

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

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

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

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

Ref: audit_event.user_id > user.id

Frequência de atualização

Dados no repo esquema são sincronizados em tempo real com os sistemas de origem. As atualizações ocorrem imediatamente à medida que as alterações acontecem, com trilhas de auditoria registrando todas as modificações para conformidade e análise histórica.

ci_base

O repo o esquema usa um padrão Single Table Inheritance para todos os dados de referência através da ci_base tabela:

O repo o esquema usa um Single Table Inheritance padrão para todos os dados de referência através da ci_base tabela. Este design consolida dicionários do sistema, classificações e itens de referência definidos pelo usuário em uma estrutura unificada, fornecendo consistência e flexibilidade em todo o esquema.

Arquitetura:

O ci_base a tabela serve como base para todos os dados de referência, usando um discriminador campo para identificar o tipo de referência específico. Cada tipo de referência tem uma tabela correspondente (como ci_device_type, ci_asset_type) que compartilha o mesmo id como ci_base, criando uma relação de herança segura por tipo.

Como as entidades de negócio se conectam ao ci_base:

Todas as entidades de negócio no repo esquema referenciam ci_base subtipos para definir sua classificação e comportamento:

• organization → referencia ci_organization_type (que herda de ci_entity_type → ci_base)

• user → referencia ci_user_type (que herda de ci_entity_type → ci_base)

• device → referencia ci_device_type e ci_device_status (ambos herdam de ci_base)

• asset → referencia ci_asset_type (que herda de ci_entity_type → ci_base)

• inventory → referencia ci_inventory_type (que herda de ci_entity_type → ci_base)

• asset_group → referencia ci_asset_group_type (que herda de ci_entity_type → ci_base)

Categorias de tipos de referência:

Categoria	Tabelas	Finalidade
Configuração do sistema	ci_module, ci_country, ci_role	Definem módulos do sistema, referências geográficas e funções de usuário
Definições de tipo de entidade	ci_entity_type, ci_device_type, ci_asset_type, ci_inventory_type, ci_organization_type, ci_user_type, ci_asset_group_type	Classificam todas as entidades de negócio por tipo
Status e classificação	ci_device_status, ci_asset_type_category	Acompanham estados de entidades e agrupam tipos em categorias
Controle de acesso	ci_permission_scope	Definem quais permissões podem ser concedidas (conectado a ci_module e ci_entity_type)
Relacionamentos	ci_device_relation_type	Definem tipos de relacionamento entre dispositivos (master-slave, backup, etc.)
Categorização	ci_tag, ci_catalog_category	Habilitam marcação flexível e organização de catálogo

Padrões de consulta de exemplo

-- Obter todos os tipos de dispositivo para uma organização (sistema + personalizado)
SELECT cb.id, cb.code, cb.title_en, cb.is_system
FROM repo.ci_base cb
JOIN repo.ci_device_type dt ON dt.id = cb.id
WHERE cb.discriminator = 'device_type'
  AND (cb.is_system = true OR cb.organization_id = $org_id)
  AND cb.deleted_at IS NULL;

-- Obter tipo de ativo com sua categoria
SELECT 
  cb.code as asset_type_code,
  cb.title_en as asset_type_name,
  cat_cb.title_en as category_name
FROM repo.ci_base cb
JOIN repo.ci_asset_type at ON at.id = cb.id
LEFT JOIN repo.ci_asset_type_category cat ON cat.id = at.category_id
LEFT JOIN repo.ci_base cat_cb ON cat_cb.id = cat.id
WHERE cb.discriminator = 'asset_type'
  AND cb.deleted_at IS NULL;

-- Obter estrutura hierárquica de tags
SELECT cb.id, cb.code, cb.title_en, cb.path, cb.parent_id
FROM repo.ci_base cb
JOIN repo.ci_tag t ON t.id = cb.id
WHERE cb.discriminator = 'tag'
  AND cb.deleted_at IS NULL
ORDER BY cb.path;

Tabelas-chave por categoria

As tabelas no repo os esquemas são organizados em categorias funcionais. As descrições abaixo resumem as tabelas mais importantes por sua finalidade de negócio.

organization

Finalidade: Gerenciamento organizacional hierárquico

Atributo	Detalhes
Campos-chave	id, parent_id, path, organization_type_id, title_en, is_active, deleted_at
Indexação	Índice GiST em path para consultas hierárquicas, índices em parent_id e organization_type_id
Notas especiais	Usa ltree para hierarquias multinível, herda de customizable_entity para suporte a campos personalizados

user

Finalidade: Contas de usuário e autenticação

Atributo	Detalhes
Campos-chave	id, organization_id, user_type_id, identity_provider, identity_provider_id, full_name, is_active
Indexação	Índice único em (organization_id, identity_provider, identity_provider_id)
Notas especiais	Integração com provedores de identidade externos (Keycloak, Auth0, Okta), herda de customizable_entity

device

Finalidade: Rastreadores físicos de dispositivos

Atributo	Detalhes
Campos-chave	id, organization_id, device_type_id, status_id, hw_id, label
Indexação	Índices em organization_id, device_type_id, status_id, hw_id
Notas especiais	Identificador de hardware para rastreamento de dispositivo, herda de customizable_entity para campos personalizados

asset

Finalidade: Ativos físicos ou virtuais

Atributo	Detalhes
Campos-chave	id, organization_id, asset_type_id, label, descrição
Indexação	Índices em organization_id e asset_type_id
Notas especiais	Herdado de customizable_entity, vinculado a dispositivos via device_asset_link

inventory

Finalidade: Registros de inventário e armazém

Atributo	Detalhes
Campos-chave	id, organization_id, inventory_type_id, code
Indexação	Índice único em (organization_id, code)
Notas especiais	Códigos únicos dentro da organização, vinculados a dispositivos via device_inventory_link

asset_group

Finalidade: Agrupamento de ativos com rastreamento histórico

Atributo	Detalhes
Campos-chave	id, organization_id, group_type_id, title_en, descrição
Relacionamentos	FROM repo.asset_group AS ag JOIN repo.asset_group_item AS agi ON agi.group_id = ag.id JOIN repo.asset AS a ON a.id = agi.asset_id WHERE agi.detached_at IS NULL
Notas especiais	Membro baseado em tempo via asset_group_item, consulte membros atuais com WHERE detached_at IS NULL

custom_field_def

Finalidade: Definições de campo personalizado e metadados

Atributo	Detalhes
Campos-chave	id, organization_id, owner_entity_type_id, code, field_type, is_multi, is_required
Conteúdo	Tipos de campo incluem texto, número, booleano, data, datetime, entity_ref, catalog_item_ref
Notas especiais	Habilita campos personalizados flexíveis para qualquer tipo de entidade, valores armazenados em custom_field_value_* tabelas

acl_role_permission

Finalidade: Gerenciamento de permissões baseado em função

Atributo	Detalhes
Campos-chave	id, role_id, permission_scope_id, target_entity_id, actions
Conteúdo	Máscara de bits de ação (READ=1, UPDATE=2, DELETE=4, CREATE=8), permissões específicas por alvo ou por tipo de entidade
Relacionamentos	FROM repo.user_role AS ur JOIN repo.acl_role_permission AS rp ON rp.role_id = ur.role_id WHERE ur.user_id = $user_id
Notas especiais	Funciona com user_role e acl_user_scope para determinar as permissões finais do usuário

audit_event

Finalidade: Registro de auditoria unificado para todas as alterações do sistema

Atributo	Detalhes
Campos-chave	id, event_category, user_id, aggregate_type, aggregate_id, event_type, event_data, occurred_at
Indexação	Índices em (user_id, occurred_at), (aggregate_type, aggregate_id, occurred_at), (event_category, occurred_at)
Notas especiais	Particionado por occurred_at (mensal), duas categorias: auth (autenticação) e domain (eventos de negócio), armazena deltas de alteração ao nível de campo em event_data JSONB

Relacionamentos de dados

O repo o esquema implementa padrões sofisticados de relacionamento para modelagem de dados flexível:

Estruturas hierárquicas

• Organizações usam caminhos ltree para consultas eficientes em árvore

• Itens de referência (ci_base) suportam hierarquias opcionais

• Manutenção automática de caminhos via triggers de banco de dados

Padrões de herança

• Herança de tabela: customizable_entity → entidades de negócio (organization, user, device, asset, inventory, asset_group)

• Herança de ID: ci_base → tabelas de tipo de referência

• Discriminação de tipo via entity_type_id e discriminador campos

Relacionamentos polimórficos

Certas tabelas usam referências polimórficas sem restrições de chave estrangeira para máxima flexibilidade:

• acl_role_permission.target_entity_id → qualquer customizable_entity

• acl_user_scope.target_entity_id → qualquer customizable_entity

• entity_tag.entity_id → qualquer customizable_entity

Esses relacionamentos são validados no nível da aplicação.

Informações adicionais

Validação de dados

O repo o esquema aplica integridade de dados por meio de múltiplos mecanismos:

Restrições de banco de dados

• Restrições UNIQUE com suporte a soft delete (índices parciais WHERE deleted_at IS NULL)

• Restrições CHECK (por exemplo, device_relation garante master_id ≠ slave_id)

• Restrições NOT NULL em campos obrigatórios

• Valores DEFAULT para timestamps e flags booleanas

Validação em nível de aplicação

• Validação de tipo de entidade para referências polimórficas

• Validação de catálogo para referências de campos personalizados

• Validação de tipo de campo personalizado

• Gerenciamento de arrays para campos multivalorados

Otimização de consultas

As tabelas são organizadas com estratégias específicas de indexação:

Índices padrão:

• Todas as chaves estrangeiras têm índices dedicados

• Índices baseados em tempo em created_at, updated_at, deleted_at

• Índices compostos para colunas frequentemente unidas

Índices especializados:

• Índices GiST em caminhos ltree para consultas hierárquicas

• Índices únicos parciais suportando soft delete

• Índices de valor de campo personalizado para filtragem e ordenação

• Índices de eventos de auditoria por tempo + entidade para buscas eficientes

Considerações de performance:

• Pool de conexões recomendado (PgBouncer)

• Manutenção regular VACUUM para tabelas grandes

• Possível partionamento futuro para device tabela por organization_id

• Views materializadas para cálculos complexos de controle de acesso