Couche Bronze

La couche Bronze contient deux schémas de données distincts, chacun servant des aspects différents de la plateforme de télématique et d’intelligence d’affaires :

raw_business_data - contenant des tables, attributs et valeurs liées aux informations métier, telles que véhicules, employés, géorepères ajoutés par les utilisateurs, etc.
raw_telematics_data - contenant des tables, attributs et valeurs liées aux données télématiques transmises depuis les appareils sous surveillance, telles que les positions, entrées, sorties et événements.

Chaque schéma est optimisé pour son domaine de données spécifique et ses schémas d’accès, offrant une couverture complète des besoins opérationnels, télématiques et de gestion des actifs.

`raw_business_data` structure

Ce schéma contient plus de 40 tables soigneusement sélectionnées pour couvrir divers aspects métier et cas d’usage. Ces tables représentent vos entités métier principales, la structure organisationnelle et les données opérationnelles.

Le diagramme interactif du schéma raw_business_data est disponible sur dbdiagram.io: https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a

Consultez les détails du schéma des données métier brutes ci‑dessous.

schéma raw_business_data


Table "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

}

  

Table "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)"

}

  

Table "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

}

  

Table "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]

}

  

Table "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

}

  

Table "statuses" {

  "order_sort" integer [not null]

  "listing_id" integer [not null]

  "color" "character varying(6)" [not null]

  "status_id" integer [not null]

  "status_label" "character varying(200)" [not null]

  "record_added_at" timestamp [not null]

  "is_deleted" boolean [not null]

}

  

Table "places_linked_entity_fields" {

  "value" bigint [not null]

  "record_added_at" timestamp [not null]

  "place_id" integer [not null]

  "field_id" integer [not null]

}

  

Table "places_text_fields" {

  "place_id" integer [not null]

  "record_added_at" timestamp [not null]

  "value" text [not null]

  "field_id" integer [not null]

}

  

Table "users2zones" {

  "zone_id" integer [not null]

  "record_added_at" timestamp [not null]

  "user_id" integer [not null]

}

  

Table "objects" {

  "record_added_at" timestamp [not null]

  "create_datetime" timestamp [not null]

  "client_id" integer [not null]

  "group_id" 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]

}

  

Table "device_output_name" {

  "device_id" integer [not null]

  "record_added_at" timestamp [not null]

  "label" "character varying(100)" [not null]

  "number" integer [not null]

}

  

Table "geofence_points" {

  "longitude" numeric [not null]

  "number" integer [not null]

  "zone_id" integer [not null]

  "record_added_at" timestamp [not null]

  "latitude" numeric [not null]

}

  

Table "custom_fields" {

  "record_added_at" timestamp [not null]

  "entity_id" integer [not null]

  "is_required" boolean [not null]

  "custom_field_label" text [not null]

  "parameters" jsonb

  "custom_field_type" integer [not null]

  "description" text

  "custom_field_id" integer [not null]

}

  

Table "places_decimal_fields" {

  "field_id" integer [not null]

  "record_added_at" timestamp [not null]

  "place_id" integer [not null]

  "value" numeric [not null]

}

  

Table "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

}

  

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" integer [not null]

}

  

Table "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

}

  

Table "status_listings" {

  "user_id" integer [not null]

  "is_supervisor_controlled" boolean [not null]

  "is_deleted" boolean [not null]

  "status_listing_id" integer [not null]

  "is_employee_controlled" boolean [not null]

  "record_added_at" timestamp [not null]

  "status_listing_label" "character varying(200)" [not null]

}

  

Table "models" {

  "record_added_at" timestamp [not null]

  "model_id" integer [not null]

  "has_battery_level" boolean [not null]

  "alternative_label" "character varying(50)" [not null]

  "vendor" "character varying(30)" [not null]

  "is_clone" boolean

  "has_altitude" boolean [not null]

  "has_phone" boolean [not null]

  "type_output_control" "character varying(30)" [not null]

  "has_gsm_roaming" boolean [not null]

  "has_gsm_level" boolean [not null]

  "model" "character varying(255)" [not null]

  "type_special_control" "character varying(255)" [not null]

  "digital_amount" integer [not null]

  "has_detach_button" boolean [not null]

  "has_gsm_name" boolean [not null]

  "analog_amount" integer [not null]

  "outputs_amount" integer [not null]

}

  

Table "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]

}

  

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]

}

  

Table "sensor_description" {

  "record_added_at" timestamp [not null]

  "parameters" jsonb

  "input_id" integer [not null]

  "accuracy" numeric [not null]

  "sensor_units" "character varying(10)"

  "multiplier" doubleprecision [not null]

  "input_label" "character varying(64)"

  "sensor_label" "character varying(100)"

  "units_type" integer [not null]

  "divider" doubleprecision [not null]

  "group_id" 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]

}

  

Table "entities" {

  "entity_label" jsonb

  "record_added_at" timestamp [not null]

  "entity_id" integer [not null]

  "builtin_type" integer [not null]

  "user_id" integer [not null]

}

  

Table "zones" {

  "address" "character varying(255)"

  "radius" integer [not null]

  "zone_id" integer [not null]

  "circle_center_latitude" numeric [not null]

  "client_id" integer [not null]

  "zone_label" "character varying(100)"

  "color" "character varying(6)" [not null]

  "zone_type" "character varying(20)" [not null]

  "circle_center_longitude" numeric [not null]

  "latitude" numeric [not null]

  "record_added_at" timestamp [not null]

  "longitude" numeric [not null]

}

  

Table "vehicles" {

  "vehicle_id" integer [not null]

  "payload_length" 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)"

}

  

Table "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]

}

  

Table "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]

}

  

Table "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

}

  

Table "rules2zones" {

  "zone_id" integer [not null]

  "record_added_at" timestamp [not null]

  "rule_id" integer [not null]

}

  

Table "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

}

  

Table "sensor_calibration_data" {

  "value" numeric [not null]

  "sensor_id" integer [not null]

  "record_added_at" timestamp [not null]

  "volume" numeric [not null]

  "device_id" integer [not null]

  "sensor_calibration_id" bigint [not null]

}

  

Table "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]

}

  

Table "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

}

  

Table "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]

  "owner_id" integer [not null]

  "record_added_at" timestamp [not null]

}

  

Table "description_parametrs" {

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

}

  

Table "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]

}

  

Table "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

}

  

Table "places_longtext_fields" {

  "field_id" integer [not null]

  "value" text [not null]

  "record_added_at" timestamp [not null]

  "place_id" integer [not null]

}

  

Table "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

}

  

Table "groups_objects" {

  "groups_client_id" integer

  "objects_client_id" integer

  

  Indexes {

    (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:"sensor_description"."sensor_id" < "sensor_calibration_data"."device_id"

  

Ref:"sensor_description"."device_id" < "sensor_calibration_data"."sensor_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:"sensor_calibration_data"."value" < "sensor_calibration_data"."device_id"

  

Ref:"devices"."device_id" < "raw_device_data"."device_id"

  

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

  

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

Fréquence de mise à jour

Les données de ce schéma sont synchronisées avec la base de données principale. Les mises à jour se produisent de manière incrémentielle lorsque des modifications surviennent dans la base MySQL source, généralement en moins de 5 minutes après la modification source.

`description_parameters`

Le système inclut des données de référence pour standardiser les valeurs dans la base de données :

Type de référence

Description

Valeurs d'exemple

Définitions de type

Types d'entités standard

vehicle_type: car, truck, bus

Codes d'état

Valeurs d'état des tâches et du système

tasks_status: unassigned, assigned, done

Définitions d'unités

Unités de mesure pour les capteurs

units_type: liter, gallon, celsius

Classifications d'entités

Catégories d'entités métier

entities_type: place, task, customer

Tables clés par catégorie

Les tables dans le raw_business_data schéma sont organisées en catégories fonctionnelles pour faciliter la navigation. Le tableau ci‑dessous résume les tables clés selon leur finalité métier :

Aperçu du schéma de base de données

Catégorie

Nom de la table

Description

Structure organisationnelle

users
departments
employees
groups

Comptes utilisateur avec informations de profil
Départements avec données de géolocalisation
Détails des employés et des conducteurs
Groupes d'organisation des traceurs

Objets et dispositifs

devices
models
objects
vehicles
sensor_description

Dispositifs de suivi physiques
Spécifications des modèles de dispositifs
Objets surveillés
Détails et spécifications des véhicules
Détails de configuration des capteurs

Lieux et zones

places
zones
garages
tags

Points d'intérêt avec géolocalisation
Zones de surveillance géofencées
Lieux de service des véhicules
Libellés organisationnels

Données opérationnelles

tasks
forms
checkins
events
statuses
vehicle_service_tasks

Affectation et suivi des tâches
Formulaires de collecte de données
Enregistrements de présence basés sur la localisation
Événements système et notifications
Définitions des statuts
Dossiers de maintenance des véhicules

`raw_telematics_data` structure

Le raw_telematics_data schéma contient trois principaux types de tables qui travaillent ensemble pour fournir des données complètes sur les dispositifs.

Le diagramme interactif du schéma raw_telematics_data est disponible sur dbdiagram.io: https://dbdiagram.io/d/v1-schema-telematics-bd-67a0acef263d6cf9a0d8e750

Trouvez ci‑dessous les détails du schéma des données télématiques brutes.

schéma raw_telematics_data

Table tracking_data_core {

  device_id integer [primary key]

  device_time timestampz [primary key]

  platform_time timestampz

  record_added_at timestampz [default: `now()`]

  latitude integer

  longitude integer

  speed integer

  altitude integer

  satellites integer

  event_id integer

  gps_fix_type integer

  hdop integer

  

  indexes {(device_id, device_time)}

}

  

Table inputs {

  event_id integer [primary key]

  device_id integer [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  sensor_name text [primary key]

  value text

  indexes {(device_id, device_time)}

}

  

Table states {

  event_id integer [primary key]

  device_id serial [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  state_name text [primary key]

  value text

  indexes {(device_id, device_time)}

}

  

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

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

Tables clés par catégorie

Chaque table remplit une fonction spécifique pour capturer différents aspects de l'information sur les dispositifs :

`tracking_data_core`

Objectif: Données principales de localisation et de mouvement

Attribut

Détails

Champs clés

device_id, device_time, platform_time, latitude, longitude, speed, altitude, satellites, hdop, event_id

Indexation

Optimisé avec un index sur (device_id, device_time)

Remarques particulières

Les données de localisation (latitude et longitude) utilisent un format entier avec une précision de 10⁷ pour des performances optimales sur TimescaleDB La vitesse est également stockée en entier ; vous devez donc la diviser par 100

`inputs`

Objectif: Lectures de capteurs provenant des dispositifs

Attribut

Détails

Champs clés

input_id, device_id, device_time, sensor_name, value

Contenu

Lectures analogiques (niveau de carburant, température, tension), valeurs calculées (régime moteur)

Relations

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`

Objectif: Indicateurs d'état du dispositif et modes opérationnels

Attribut

Détails

Champs clés

state_id, device_id, device_time, state_name, value

Contenu

Indicateurs de mode de fonctionnement (working, idle, off), états des composants (ignition, doors)

Format de valeur

Valeurs booléennes (1/0) ou codes d'état spécifiques

Les données de ce schéma sont ingérées directement depuis les dispositifs, avec une latence minimale (typiquement quelques secondes). Le schéma est optimisé pour les séries temporelles en utilisant TimescaleDB pour un stockage et une récupération efficaces.

Informations supplémentaires

Validation des données

La base de données applique l'intégrité des données via plusieurs mécanismes :

Contraintes CHECK valider que les valeurs se situent dans des plages acceptables
Clés étrangères assurer que les relations entre les tables restent cohérentes
Contraintes NOT NULL garantir que les champs obligatoires ont toujours des valeurs
Valeurs DEFAULT fournir un repli lorsque les données ne sont pas fournies explicitement

Optimisation des requêtes

Les tables sont organisées avec des stratégies d'indexation spécifiques :

Toutes les tables incluent index temporels sur record_added_at
Les colonnes de clés étrangères ont des index dédiés pour améliorer les performances des jointures
Les combinaisons de colonnes fréquemment utilisées ont des index composites
TimescaleDB fournit des index spécialisés pour les requêtes sur séries temporelles

`repo` structure des données

Ce schéma est actuellement en développement. Si vous êtes intéressé par un accès anticipé ou si vous avez des questions concernant cette fonctionnalité, veuillez contacter [email protected].

Le repo le schéma fournit un cadre complet pour gérer les structures organisationnelles, les actifs, les dispositifs et leurs relations dans des environnements multi‑locataires. Basé sur PostgreSQL 14+ avec l'extension ltree, le schéma prend en charge des organisations hiérarchiques, des définitions de champs personnalisés pour tout type d'entité, un contrôle d'accès basé sur les rôles avec restrictions au niveau des objets et des pistes d'audit complètes avec suivi des modifications au niveau des champs. Toutes les entités peuvent être étendues sans modification du schéma, localisées pour des déploiements internationaux et liées via des relations polymorphes flexibles.

Le schéma traite des scénarios complexes de gestion des données, y compris les hiérarchies d'actifs de flotte à travers les niveaux organisationnels, les plateformes SaaS multi‑locataires nécessitant l'isolement des données, les opérations soumises à conformité avec exigences d'audit détaillées, et les systèmes nécessitant des modèles de données dynamiques adaptables via des champs personnalisés plutôt que des migrations de base de données.

Le diagramme interactif derepo schéma de données est disponible sur dbdiagram.io: https://dbdiagram.io/d/Navixy-Repo-data-schema-68ad788c1e7a611967a0930e

Trouvez le repo détails du schéma ci‑dessous.

repo schéma de données

// ============================================
// Nouveau schéma DataHub - Parcours client
// PostgreSQL 14+ avec l'extension ltree
// Version : 2.0 (Concept)
// ============================================

// ============================================
// TABLES DE RÉFÉRENCE DE BASE (hiérarchie ci_base)
// ============================================

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

Table ci_module {
  id uuid [primary key]
}

Table ci_catalog_category {
  id uuid [primary key]
}

Table ci_country {
  id uuid [primary key]
}

Table ci_role {
  id uuid [primary key]
}

Table ci_entity_type {
  id uuid [primary key]
}

Table ci_device_status {
  id uuid [primary key]
}

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

Table ci_device_type {
  id uuid [primary key]
}

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

Table ci_asset_type_category {
  id uuid [primary key]
}

Table ci_inventory_type {
  id uuid [primary key]
}

Table ci_organization_type {
  id uuid [primary key]
}

Table ci_user_type {
  id uuid [primary key]
}

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

Table ci_device_relation_type {
  id uuid [primary key]
}

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

// ============================================
// ENTITÉ DE BASE AVEC SUPPORT DES CHAMPS PERSONNALISÉS
// ============================================

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

// ============================================
// ENTITÉS MÉTIER PRINCIPALES
// ============================================

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

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

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

// ============================================
// CONTRÔLE D'ACCÈS (ACL)
// ============================================

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

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

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

// ============================================
// ENTITÉS MÉTIER
// ============================================

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

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

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

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

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

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

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

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

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

// ============================================
// LOCALISATION
// ============================================

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

// ============================================
// CHAMPS PERSONNALISÉS - DÉFINITIONS
// ============================================

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

// ============================================
// CHAMPS PERSONNALISÉS - VALEURS (par type)
// ============================================

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

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

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

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

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

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

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

// ============================================
// AUDIT
// ============================================

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

// ============================================
// RELATIONS
// ============================================

Réf : ci_base.catalog_id > catalog.id
Réf : ci_base.organization_id > organization.id
Réf : ci_base.parent_id > ci_base.id

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

Réf : ci_permission_scope.module_id > ci_module.id
Réf : ci_permission_scope.entity_type_id > ci_entity_type.id
Réf : ci_asset_type.category_id > ci_asset_type_category.id
Réf : ci_asset_group_type.allowed_asset_type_id > ci_asset_type.id
Réf : ci_tag.entity_type_id > ci_entity_type.id

Réf : customizable_entity.entity_type_id > ci_entity_type.id

Réf : organization.id - customizable_entity.id
Réf : organization.parent_id > organization.id
Réf : organization.organization_type_id > ci_organization_type.id
Réf : organization.deleted_by > user.id

Réf : catalog.organization_id > organization.id
Réf : catalog.module_id > ci_module.id
Réf : catalog.category_id > ci_catalog_category.id

Réf : user.id - customizable_entity.id
Réf : user.organization_id > organization.id
Réf : user.user_type_id > ci_user_type.id
Réf : user.deleted_by > user.id

Réf : user_role.user_id > user.id
Réf : user_role.role_id > ci_role.id
Réf : user_role.assigned_by > user.id

Réf : acl_role_permission.role_id > ci_role.id
Réf : acl_role_permission.permission_scope_id > ci_permission_scope.id
Réf : acl_role_permission.granted_by > user.id

Réf : acl_user_scope.user_id > user.id
Réf : acl_user_scope.permission_scope_id > ci_permission_scope.id

Réf : asset.id - customizable_entity.id
Réf : asset.organization_id > organization.id
Réf : asset.asset_type_id > ci_asset_type.id
Réf : asset.deleted_by > user.id

Réf : inventory.id - customizable_entity.id
Réf : inventory.organization_id > organization.id
Réf : inventory.inventory_type_id > ci_inventory_type.id
Réf : inventory.deleted_by > user.id

Réf : device.id - customizable_entity.id
Réf : device.organization_id > organization.id
Réf : device.device_type_id > ci_device_type.id
Réf : device.status_id > ci_device_status.id
Réf : device.deleted_by > user.id

Réf : device_asset_link.device_id - device.id
Réf : device_asset_link.asset_id > asset.id
Réf : device_asset_link.linked_by > user.id

Réf : device_inventory_link.device_id - device.id
Réf : device_inventory_link.inventory_id > inventory.id
Réf : device_inventory_link.linked_by > user.id

Réf : device_relation.master_id > device.id
Réf : device_relation.slave_id > device.id
Réf : device_relation.relation_type_id > ci_device_relation_type.id

Réf : asset_group.id - customizable_entity.id
Réf : asset_group.organization_id > organization.id
Réf : asset_group.group_type_id > ci_asset_group_type.id
Réf : asset_group.deleted_by > user.id

Réf : asset_group_item.group_id > asset_group.id
Réf : asset_group_item.asset_id > asset.id

Réf : entity_tag.tag_id > ci_tag.id

Réf : custom_field_def.organization_id > organization.id
Réf : custom_field_def.owner_entity_type_id > ci_entity_type.id
Réf : custom_field_def.ref_entity_type_id > ci_entity_type.id
Réf : custom_field_def.ref_catalog_id > catalog.id

Réf : custom_field_value_text.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_text.field_def_id > custom_field_def.id

Réf : custom_field_value_number.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_number.field_def_id > custom_field_def.id

Réf : custom_field_value_boolean.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_boolean.field_def_id > custom_field_def.id

Réf : custom_field_value_date.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_date.field_def_id > custom_field_def.id

Réf : custom_field_value_datetime.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_datetime.field_def_id > custom_field_def.id

Réf : custom_field_value_entity.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_entity.field_def_id > custom_field_def.id
Réf : custom_field_value_entity.ref_entity_id > customizable_entity.id

Réf : custom_field_value_catalog.customizable_entity_id > customizable_entity.id
Réf : custom_field_value_catalog.field_def_id > custom_field_def.id
Réf : custom_field_value_catalog.ref_item_id > ci_base.id

Réf : audit_event.user_id > user.id

Fréquence de mise à jour

Les données dans le repo schéma sont synchronisées en temps réel avec les systèmes sources. Les mises à jour sont effectuées immédiatement dès qu’un changement survient, les pistes d’audit capturant toutes les modifications pour la conformité et l’analyse historique.

`ci_base`

Le repo le schéma utilise un modèle Single Table Inheritance pour toutes les données de référence via la ci_base table :

Le repo le schéma utilise un Single Table Inheritance modèle pour toutes les données de référence via la ci_base table. Cette conception consolide les dictionnaires système, les classifications et les éléments de référence définis par les utilisateurs en une structure unifiée, offrant cohérence et flexibilité à travers tout le schéma.

Architecture :

Le ci_base la table sert de base pour toutes les données de référence, en utilisant un discriminateur champ pour identifier le type de référence spécifique. Chaque type de référence a une table correspondante (comme ci_device_type, ci_asset_type) qui partage le même id en tant que ci_base, créant une relation d’héritage sûre par type.

Comment les entités métier se connectent à ci_base :

Toutes les entités métier du repo schéma référencent ci_base les sous-types pour définir leur classification et leur comportement :

organization → référence ci_organization_type (qui hérite de ci_entity_type → ci_base)
user → référence ci_user_type (qui hérite de ci_entity_type → ci_base)
device → référence ci_device_type et ci_device_status (les deux héritent de ci_base)
asset → référence ci_asset_type (qui hérite de ci_entity_type → ci_base)
inventory → référence ci_inventory_type (qui hérite de ci_entity_type → ci_base)
asset_group → référence ci_asset_group_type (qui hérite de ci_entity_type → ci_base)

Catégories de types de référence :

Catégorie

Tables

Objectif

Configuration du système

ci_module, ci_country, ci_role

Définir les modules du système, les références géographiques et les rôles utilisateur

Définitions des types d’entités

ci_entity_type, ci_device_type, ci_asset_type, ci_inventory_type, ci_organization_type, ci_user_type, ci_asset_group_type

Classer toutes les entités métier par type

Statut et classification

ci_device_status, ci_asset_type_category

Suivre les états des entités et regrouper les types en catégories

Contrôle d’accès

ci_permission_scope

Définir les permissions pouvant être accordées (connectées à ci_module et ci_entity_type)

Relations

ci_device_relation_type

Définir les types de relations entre appareils (maître-esclave, secours, etc.)

Catégorisation

ci_tag, ci_catalog_category

Permettre le balisage flexible et l’organisation du catalogue

Exemples de modèles de requêtes

-- Obtenir tous les types d’appareils pour une organisation (système + personnalisé)
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;

-- Obtenir le type d’actif avec sa catégorie
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;

-- Obtenir la structure hiérarchique des 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;

Relations

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

Remarques particulières

Fonctionne avec user_role et acl_user_scope pour déterminer les permissions finales de l’utilisateur

`audit_event`

Finalité : Journal d’audit unifié pour toutes les modifications du système

Attribut

Détails

Champs clés

id, event_category, user_id, aggregate_type, aggregate_id, event_type, event_data, occurred_at

Indexation

Index sur (user_id, occurred_at), (aggregate_type, aggregate_id, occurred_at), (event_category, occurred_at)

Remarques particulières

Partitionné par occurred_at (mensuel), deux catégories : auth (authentification) et domain (événements métier), stocke les deltas de changement au niveau des champs en event_data JSONB

Relations de données

Le repo le schéma implémente des modèles de relations sophistiqués pour une modélisation de données flexible :

Structures hiérarchiques

Les organisations utilisent des chemins ltree pour des requêtes d’arbre efficaces
Les éléments de référence (ci_base) prennent en charge des hiérarchies optionnelles
Maintenance automatique des chemins via des triggers de base de données

Modèles d’héritage

Héritage de table : customizable_entity → entités métier (organization, user, device, asset, inventory, asset_group)
Héritage d’ID : ci_base → tables de types de référence
Discrimination de type via entity_type_id et discriminateur champs

Relations polymorphes

Certaines tables utilisent des références polymorphes sans contraintes de clé étrangère pour une flexibilité maximale :

acl_role_permission.target_entity_id → n’importe quel customizable_entity
acl_user_scope.target_entity_id → n’importe quel customizable_entity
entity_tag.entity_id → n’importe quel customizable_entity

Ces relations sont validées au niveau de l’application.

Informations supplémentaires

Validation des données

Le repo le schéma applique l’intégrité des données via plusieurs mécanismes :

Contraintes de base de données

Contraintes UNIQUE avec support de suppression douce (index partiels WHERE deleted_at IS NULL)
Contraintes CHECK (par ex., device_relation assure que master_id ≠ slave_id)
Contraintes NOT NULL sur les champs requis
Valeurs DEFAULT pour les timestamps et les drapeaux booléens

Validation au niveau de l’application

Validation du type d’entité pour les références polymorphes
Validation de catalogue pour les références de champs personnalisés
Validation du type de champ personnalisé
Gestion des tableaux pour les champs à valeurs multiples

Optimisation des requêtes

Les tables sont organisées avec des stratégies d'indexation spécifiques :

Index standards :

Toutes les clés étrangères disposent d’index dédiés
Index temporels sur created_at, updated_at, deleted_at
Index composites pour les colonnes fréquemment jointes

Index spécialisés :

Index GiST sur les chemins ltree pour les requêtes hiérarchiques
Index uniques partiels supportant la suppression douce
Index des valeurs de champs personnalisés pour le filtrage et le tri
Index des événements d’audit sur le temps + entité pour des recherches efficaces

Considérations de performance :

Pool de connexions recommandé (PgBouncer)
Maintenance VACUUM régulière pour les grandes tables
Partitionnement futur possible pour device table par organization_id
Vues matérialisées pour des calculs complexes de contrôle d’accès

PrécédentAperçu du schéma SuivantExplorateur pour DataHub

Mis à jour il y a 14 jours

Ce contenu vous a-t-il été utile ?

raw_business_data structure

Fréquence de mise à jour

description_parameters

Tables clés par catégorie

Aperçu du schéma de base de données

raw_telematics_data structure

Tables clés par catégorie

tracking_data_core

inputs

states

Informations supplémentaires

Validation des données

Optimisation des requêtes

repo structure des données

Fréquence de mise à jour

ci_base

Tables clés par catégorie

organization

user

device

asset

inventory

asset_group

custom_field_def

acl_role_permission

audit_event

Relations de données

Informations supplémentaires

Validation des données

Optimisation des requêtes

`raw_business_data` structure

`description_parameters`

`raw_telematics_data` structure

`tracking_data_core`

`inputs`

`states`

`repo` structure des données

`ci_base`

`organization`

`user`

`device`

`asset`

`inventory`

`asset_group`

`custom_field_def`

`acl_role_permission`

`audit_event`