Couche Bronze

La couche Bronze contient deux schémas de données distincts, chacun couvrant 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és 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és aux données télématiques transmises par les appareils sous surveillance, telles que les localisations, entrées, sorties et événements.

Chaque schéma est optimisé pour son domaine de données et ses modes d'accès spécifiques, 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'utilisation. 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

Trouvez les détails du schéma raw business data 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]
  "calibration_data" jsonb
}

Table "entities" {
  "entity_label" jsonb
  "record_added_at" timestamp [not null]
  "entity_id" integer [not null]
  "builtin_type" integer [not null]
  "user_id" integer [not null]
}

Table "zones" {
  "address" "character varying(255)"
  "radius" 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 "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:"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"

Fréquence de mise à jour

Les données de ce schéma sont synchronisées avec la base de données centrale. Les mises à jour se produisent de manière incrémentielle lorsque des modifications surviennent dans la base de données 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 l'ensemble de la base de données :

Type de référence	Description	Valeurs exemples
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 du 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 :

Entités métier principales

users

But: Informations de compte et de profil utilisateur

Attribut	Détails
Champs clés	user_id, company_label, first_name, last_name, middle_name, locale, timezone_label, master_id, registration_datetime
Relations	Utilisateur parent via master_id, lié à employés, départements, lieux, tâches par user_id
Notes spéciales	Entité centrale connectant les données organisationnelles ; master_id permet des hiérarchies d'utilisateurs pour des structures de comptes à plusieurs niveaux

employés

But: Enregistrements d'employés et de conducteurs avec détails sur les licences et les affectations

Attribut	Détails
Champs clés	employee_id, user_id, object_id, department_id, first_name, last_name, driver_license_number, driver_license_valid_till, hardware_key
Relations	Liens vers users, départements, objects (traceur assigné), suivi dans driver_history et checkins
Notes spéciales	La clé matérielle permet l'identification du conducteur via iButton ou RFID ; prend en charge la géoclausure avec latitude, longitude, rayon champs

départements

But: Unités organisationnelles avec localisation géographique

Attribut	Détails
Champs clés	department_id, user_id, department_label, latitude, longitude, rayon, adresse
Relations	Relie les employés à la structure organisationnelle via department_id
Notes spéciales	Les champs de localisation prennent en charge les analyses basées sur des géofences pour les rapports au niveau des départements

Suivi et surveillance

devices

But: Informations sur le dispositif de suivi physique et l'état réseau

Attribut	Détails
Champs clés	device_id, owner_id, device_imei, phone, status_listing_id, network_label, signal_level, has_roaming, created_at
Relations	Entité centrale reliant à objects, models, sensor_description, counters; owner_id references users.user_id
Notes spéciales	Toutes les données télématiques dans raw_telematics_data le schéma référencent cette table via device_id

objects

But: Entités surveillées (véhicules, biens, personnel)

Attribut	Détails
Champs clés	object_id, client_id, device_id, object_label, model, group_id, create_datetime, is_deleted
Relations	Point central connectant les dispositifs aux utilisateurs (client_id), détails du véhicule, historique de suivi, tâches et règles
Notes spéciales	Représente « l'unité traçable » dans le système ; un objet par dispositif en utilisation active

models

But: Spécifications matérielles et capacités du dispositif

Attribut	Détails
Champs clés	model_id, model, vendor, alternative_label, analog_amount, digital_amount, outputs_amount, has_battery_level, has_altitude, has_phone
Contenu	Des indicateurs de capacité booléens indiquent quels champs de données sont disponibles pour ce type d'appareil
Notes spéciales	Utilisez les indicateurs de capacité pour déterminer les capteurs et entrées valides lors de l'interrogation des données télématiques

sensor_description

But: Données de configuration et d'étalonnage des capteurs

Attribut	Détails
Champs clés	sensor_id, device_id, sensor_label, input_label, sensor_type, units_type, multiplier, divider, accuracy, calibration_data
Relations	Relie les entrées de l'appareil (depuis raw_telematics_data.inputs) à la logique métier via device_id et input_label matching
Notes spéciales	calibration_data (JSONB) stocke des tables d'étalonnage spécifiques aux capteurs pour les jauges de carburant ; multiplier et divider convertir les valeurs brutes en unités

Gestion des actifs

vehicles

But: Spécifications du véhicule, documentation et paramètres opérationnels

Attribut	Détails
Champs clés	vehicle_id, user_id, object_id, garage_id, vehicle_label, registration_number, vin, manufacture_year, fuel_type, fuel_cost, standard_fuel_consumption, max_speed
Relations	Liens vers objects (traceur actuel), garages (lieu de service), vehicle_service_tasks; suivi dans vehicle_trackers_history
Notes spéciales	Les champs de dimension physique (payload_length, payload_width, payload_height, gross_weight) prennent en charge l'analyse de planification de charge ; les dates d'assurance permettent le suivi de conformité

garages

But: Emplacements des ateliers et installations de maintenance

Attribut	Détails
Champs clés	garage_id, user_id, latitude, longitude, rayon, adresse, organization_label, mechanic_name, dispatcher_name
Relations	Référencé par vehicles.garage_id pour l'affectation du lieu de service
Notes spéciales	Les champs de localisation permettent la détection des visites de service basées sur la géofence et l'analyse de proximité

vehicle_service_tasks

But: Calendriers de maintenance et historique des services

Attribut	Détails
Champs clés	service_task_id, vehicle_id, description, status, cost, start_date, end_date, completion_date, predicted_datetime, mileage_limit, engine_hours_limit
Contenu	Prend en charge trois types de déclencheurs : basés sur la date, le kilométrage et les heures moteur ; paramètres de notification pour e‑mail, SMS, push
Notes spéciales	is_repeat et les champs d'intervalle permettent des calendriers de maintenance récurrents ; is_unplanned distingué entre maintenance planifiée et réactive

Localisation et routage

zones

But: Zones géoclavées pour la surveillance et l'automatisation

Attribut	Détails
Champs clés	zone_id, client_id, zone_label, zone_type, latitude, longitude, circle_center_latitude, circle_center_longitude, rayon, adresse, color
Contenu	Les types de zone incluent cercle, polygone (défini via geofence_points), et des classifications de zones spéciales
Relations	Référencé par rules2zones, users2zones; sommets de polygone stockés dans geofence_points
Notes spéciales	Les fonctions PostGIS peuvent être utilisées pour vérifier si un point est dans un polygone pour des analyses complexes de géofence

lieux

But: Points d'intérêt avec attributs personnalisés

Attribut	Détails
Champs clés	place_id, user_id, place_label, latitude, longitude, rayon, adresse, description, external_id, custom_fields
Relations	Étendu avec des valeurs de champs personnalisés via places_text_fields, places_decimal_fields, places_bigint_fields, places_longtext_fields, places_linked_entity_fields
Notes spéciales	custom_fields JSONB fournit un accès rapide ; les tables associées permettent le filtrage et le tri sur les attributs personnalisés

geofence_points

But: Coordonnées des sommets de polygone pour des formes de géofence complexes

Attribut	Détails
Champs clés	zone_id, number, latitude, longitude
Relations	Plusieurs enregistrements par zone_id définissent les limites du polygone ; number le champ détermine l'ordre des sommets
Notes spéciales	Interroger avec ORDER BY number pour reconstruire le chemin du polygone ; utiliser avec PostGIS ST_MakePolygon pour les opérations géométriques

Gestion des tâches et des flux de travail

tâches

But: Affectations d'ordres de travail et suivi d'exécution

Attribut	Détails
Champs clés	task_id, user_id, object_id, parent_task_id, task_label, status, task_type, latitude, longitude, rayon, arrival_datetime, created_at, status_change_datetime, custom_fields
Contenu	Prend en charge les tâches hiérarchiques via parent_task_id; fenêtres temporelles définies par time_from/time_to; validation de géofence avec localisation et rayon
Relations	Liens vers forms (collecte de données), task_history (changements d'état), objects (traceur assigné)
Notes spéciales	stay_duration et arrival_duration_minutes permettent le suivi de conformité pour les tâches de livraison et de service

forms

But: Formulaires de collecte de données et soumissions

Attribut	Détails
Champs clés	form_id, task_id, object_id, form_label, champs, values, submitted_at, submission_latitude, submission_longitude, is_submission_in_zone
Contenu	champs définit la structure du formulaire (JSON) ; values contient les données soumises (JSON)
Relations	Liens vers tâches (ordre de travail associé), objects (soumettant), référencé dans checkins
Notes spéciales	Indicateur de validation de localisation is_submission_in_zone active des règles de soumission de formulaire basées sur la géofence

checkins

But: Enregistrements de présence et d'activité basés sur la localisation

Attribut	Détails
Champs clés	checkin_id, employee_id, object_id, form_id, user_id, planned_datetime, actual_datetime, latitude, longitude, rayon, adresse, comment
Relations	Relie les employés aux formulaires et aux lieux ; suit les écarts par rapport au planning prévu
Notes spéciales	Variance temporelle entre planned_datetime et actual_datetime permet la production de rapports de ponctualité ; le rayon définit la tolérance de localisation acceptable

task_history

But: Piste d'audit pour les événements du cycle de vie des tâches

Attribut	Détails
Champs clés	task_history_id, task_id, user_id, activity, event_datetime, payload
Contenu	Types d'activités définis dans description_parametrs; payload stocke les détails spécifiques à l'événement (texte)
Notes spéciales	Essentiel pour l'analyse d'achèvement des tâches, les rapports de transition d'état et le suivi de l'activité des utilisateurs

Règles et automatisation

rules

But: Déclencheurs d'événements et configurations d'alerte

Attribut	Détails
Champs clés	rule_id, object_id, client_id, event_type, event_label, event_group, description, parameters, alert_email, alert_sms, alert_phone, is_push_enabled, created_at, is_deleted
Contenu	Les paramètres de règle (JSONB) définissent les conditions de déclenchement ; prennent en charge les notifications par e‑mail, SMS, téléphone et push
Relations	Lie aux objets via rules2objects, aux zones via rules2zones
Notes spéciales	event_type définit un scénario de surveillance spécifique (excès de vitesse, infraction de géofence, seuil de capteur) ; maximum le champ permet l'agrégation d'événements pour les alertes basées sur seuil

rules2objects

But: Associations règle‑vers‑objet avec paramètres spécifiques à l'instance

Attribut	Détails
Champs clés	rule_id, object_id, param_group_number, object_params
Contenu	object_params (JSONB) permet la personnalisation des règles par objet (par ex., différentes limites de vitesse par véhicule)
Notes spéciales	La relation plusieurs‑à‑plusieurs permet à une règle de surveiller plusieurs objets avec des paramètres différents

rules2zones

But: Associe les règles aux déclencheurs de géofence

Attribut	Détails
Champs clés	rule_id, zone_id
Notes spéciales	La relation plusieurs‑à‑plusieurs permet la surveillance multi‑zones pour une seule règle (par ex., alerter lors de l'entrée dans l'une de plusieurs zones restreintes)

Statut et catégorisation

statuses

But: Définitions de statuts personnalisés pour les listes de statuts

Attribut	Détails
Champs clés	status_id, listing_id, status_label, color, order_sort, is_deleted
Relations	Groupes de statuts organisés par listing_id (références status_listings); utilisés dans status_history
Notes spéciales	order_sort définit la séquence d'affichage ; la couleur permet une différenciation visuelle dans les rapports

status_listings

But: Définitions d'ensembles de statuts pour dispositifs ou employés

Attribut	Détails
Champs clés	status_listing_id, user_id, status_listing_label, is_supervisor_controlled, is_employee_controlled, is_deleted
Relations	Référencé par devices.status_listing_id et statuses.listing_id
Notes spéciales	Les indicateurs de contrôle déterminent qui peut changer les statuts : uniquement le superviseur, auto‑service employé, ou les deux

status_history

But: Piste d'audit pour les changements de statut

Attribut	Détails
Champs clés	status_history_id, device_id, old_status_id, new_status_id, updated_by, changed_datetime, server_datetime, latitude, longitude, adresse
Relations	Liens vers devices, statuses (ancien et nouveau), description_parametrs (pour updated_by rôle)
Notes spéciales	La capture de localisation permet l'analyse géographique des transitions d'état ; utile pour les rapports de lieu de début/fin de journée de travail

tags

But: Étiquettes de catégorisation définies par l'utilisateur

Attribut	Détails
Champs clés	tag_id, user_id, tag_label, color
Relations	Appliqué aux entités via tag_links; portée définie par l'utilisateur
Notes spéciales	Système de catégorisation flexible supportant plusieurs tags par entité

tag_links

Purpose: Associe les tags aux entités taguées

Attribut	Détails
Champs clés	tag_id, entity_type, entity_id, ordinal
Contenu	entity_type identifie la table (véhicule, employé, tâche, etc.) ; ordinal définit l'ordre d'affichage
Notes spéciales	La relation polymorphe permet le marquage à travers différents types d'entités

Groupes et hiérarchie

groups

But: Regroupement organisationnel pour les objets (traceurs)

Attribut	Détails
Champs clés	group_id, client_id, group_label, group_color
Relations	Référencé par objects.group_id; propriété client via client_id (références users)
Notes spéciales	Permet une organisation de type dossier des entités de surveillance pour les rapports et les permissions

groups_objects

But: Relation plusieurs‑à‑plusieurs entre groupes et objets

Attribut	Détails
Champs clés	Clé primaire composite : groups_client_id, objects_client_id
Notes spéciales	Permet aux objets d'appartenir simultanément à plusieurs groupes ; interroger avec les deux client_id valeurs pour l'appartenance au groupe

Champs personnalisés et entités

entities

But: Définitions de types d'entité pour le cadre de champs personnalisés

Attribut	Détails
Champs clés	entity_id, user_id, entity_label, builtin_type
Relations	Référencé par custom_fields pour définir quels champs personnalisés s'appliquent à quels types d'entités
Notes spéciales	builtin_type liens vers description_parametrs pour les classifications d'entités définies par le système

custom_fields

But: Définitions de champs personnalisés

Attribut	Détails
Champs clés	custom_field_id, entity_id, custom_field_label, custom_field_type, description, is_required, parameters
Contenu	parameters (JSONB) stocke la configuration spécifique au type de champ (règles de validation, options de liste déroulante, etc.)
Relations	Définit les attributs personnalisés disponibles pour les entités ; le type de champ est lié à description_parametrs
Notes spéciales	Permet une extension dynamique du schéma sans modifications de la base de données ; utilisé intensivement dans lieux et tâches

Suivi historique

driver_history

But: Journal des changements d'affectation employé→objet

Attribut	Détails
Champs clés	driver_history_id, object_id, old_employee_id, new_employee_id, hardware_key, changed_datetime, server_datetime, updated_by, latitude, longitude, adresse
Relations	Suit les affectations de conducteurs aux véhicules au fil du temps ; lié à employés et objects
Notes spéciales	Essentiel pour les rapports spécifiques aux conducteurs lorsque ceux‑ci changent de véhicule ; la capture de localisation permet l'analyse du lieu de changement d'affectation

vehicle_trackers_history

But: Journal des changements d'affectation véhicule→traceur

Attribut	Détails
Champs clés	vehicle_tracker_history_id, vehicle_id, object_id, changed_datetime
Relations	Suit quel appareil GPS a été installé dans quel véhicule au fil du temps
Notes spéciales	Critique pour l'analyse des données historiques lorsque les traceurs sont déplacés entre véhicules ; permet une attribution précise du kilométrage et de l'utilisation

Données de référence et de recherche

description_parametrs

But: Données de référence système et valeurs d'énumération

Attribut	Détails
Champs clés	key, type, description
Contenu	Fournit des libellés lisibles par l'humain pour des valeurs codées dans toute la base de données (statut des tâches, types de carburant, types de compteurs, etc.)
Relations	Référencé via des clés étrangères depuis plusieurs tables pour une catégorisation standardisée
Notes spéciales	Essentiel pour traduire des codes entiers en valeurs lisibles dans les rapports ; type les groupes de champs liés aux énumérations

counters

But: Configuration du suivi du kilométrage et des heures moteur

Attribut	Détails
Champs clés	counter_id, device_id, counter_type, sensor_id, multiplier
Relations	Relie les dispositifs aux relevés de capteurs représentant des compteurs de distance ou de temps
Notes spéciales	multiplier convertit les impulsions du capteur en unités réelles (km, miles, heures) ; counter_type from description_parametrs définit le type de mesure

device_output_name

But: Étiquettes personnalisées pour les canaux de sortie de l'appareil

Attribut	Détails
Champs clés	device_id, number, étiquette
Contenu	Mappe les numéros de canal de sortie vers des noms définis par l'utilisateur (par ex., "Door Lock", "Engine Block")
Notes spéciales	Active des rapports lisibles lors de l'analyse des commandes et états de sortie de l'appareil

raw_telematics_data structure

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

ERD des données télématiques brutes de la couche Bronze

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

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

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 sert un objectif spécifique pour capturer différents aspects de l'information sur l'appareil :

tracking_data_core

But: 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)
Notes spéciales	Les données de localisation (latitude et longitude) utilisent le format entier avec une précision de 10⁷ pour des performances optimales avec TimescaleDB La vitesse est également stockée en entier, il faut donc la diviser par 100

inputs

But: Mesures des capteurs provenant des appareils

Attribut	Détails
Champs clés	input_id, device_id, device_time, sensor_name, value
Contenu	Mesures 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

But: Indicateurs d'état de l'appareil et modes de fonctionnement

Attribut	Détails
Champs clés	state_id, device_id, device_time, state_name, value
Contenu	Indicateurs de mode de fonctionnement (travail, inactif, éteint), états des composants (allumage, portes)
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 appareils, avec une latence minimale (typiquement en secondes). Le schéma est optimisé pour les séries temporelles en utilisant TimescaleDB pour un stockage et une récupération efficaces.

Informations complé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 garantir que les relations entre les tables restent cohérentes

• contraintes NOT NULL garantir que les champs requis ont toujours des valeurs

• valeurs DEFAULT fournir un secours 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 basés sur le temps sur record_added_at

• Les colonnes de clés étrangères disposent d'index dédiés pour les performances de jointure

• 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 de données

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

Le repo le schéma fournit un cadre complet pour gérer les structures organisationnelles, les actifs, les appareils et leurs relations dans des environnements multi‑locataires. Construit 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 répond à des scénarios complexes de gestion des données incluant les hiérarchies d'actifs de flotte à travers les niveaux organisationnels, les plateformes SaaS multi‑locataires nécessitant l'isolation 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 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ÉTIERS 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ÉTIERS
// ============================================

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
// ============================================

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

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

Données dans le repo schéma sont synchronisées en temps réel avec les systèmes sources. Les mises à jour se produisent immédiatement au fur et à mesure des changements, les pistes d'audit capturant toutes les modifications pour la conformité et l'analyse historique.

ci_base

Le repo 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 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 l'utilisateur en une structure unifiée, offrant cohérence et flexibilité dans l'ensemble du schéma.

Architecture :

Le ci_base table sert de fondation pour toutes les données de référence, en utilisant un champ discriminant pour identifier le type de référence spécifique. Chaque type de référence possède une table correspondante (comme ci_device_type, ci_asset_type) qui partage le même id 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 des sous‑types pour définir leur classification et leur comportement :

• organisation → référence ci_organization_type (qui hérite de ci_entity_type → ci_base)

• utilisateur → référence ci_user_type (qui hérite de ci_entity_type → ci_base)

• appareil → 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)

• inventaire → référence ci_inventory_type (qui hérite de ci_entity_type → ci_base)

• groupe_d_actifs → 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	But
Configuration système	ci_module, ci_country, ci_role	Définir les modules système, les références géographiques et les rôles utilisateur
Définitions de 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
État 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 quelles permissions peuvent être accordées (connecté à ci_module et ci_entity_type)
Relations	ci_device_relation_type	Définir les types de relations entre appareils (maître‑esclave, sauvegarde, etc.)
Catégorisation	ci_tag, ci_catalog_category	Permettre un balisage flexible et une organisation du catalogue

Exemples de motifs de requête

-- 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;

Tables clés par catégorie

Les tables du repo les schémas sont organisés en catégories fonctionnelles. Les descriptions ci‑dessous résument les tables les plus importantes selon leur objectif métier.

organisation

Objectif : Gestion hiérarchique des organisations

Attribut	Détails
Champs clés	id, parent_id, path, organization_type_id, title_en, is_active, deleted_at
Indexation	Index GiST sur path pour les requêtes hiérarchiques, index sur parent_id et organization_type_id
Notes spéciales	Utilise ltree pour les hiérarchies multi‑niveaux, hérite de customizable_entity pour la prise en charge des champs personnalisés

utilisateur

Objectif : Comptes utilisateur et authentification

Attribut	Détails
Champs clés	id, organization_id, user_type_id, identity_provider, identity_provider_id, full_name, is_active
Indexation	Index unique sur (organization_id, identity_provider, identity_provider_id)
Notes spéciales	Intégration de fournisseurs d'identité externes (Keycloak, Auth0, Okta), hérite de customizable_entity

appareil

Objectif : Appareils de suivi physiques

Attribut	Détails
Champs clés	id, organization_id, device_type_id, status_id, hw_id, étiquette
Indexation	Index sur organization_id, device_type_id, status_id, hw_id
Notes spéciales	Identifiant matériel pour le suivi des appareils, hérite de customizable_entity pour les champs personnalisés

asset

Objectif : Actifs physiques ou virtuels

Attribut	Détails
Champs clés	id, organization_id, asset_type_id, étiquette, description
Indexation	Index sur organization_id et asset_type_id
Notes spéciales	Hérite de customizable_entity, lié aux appareils via device_asset_link

inventaire

Objectif : Enregistrements d'inventaire et d'entrepôt

Attribut	Détails
Champs clés	id, organization_id, inventory_type_id, code
Indexation	Index unique sur (organization_id, code)
Notes spéciales	Codes uniques au sein de l'organisation, liés aux appareils via device_inventory_link

groupe_d_actifs

Objectif : Regroupement d'actifs avec suivi historique

Attribut	Détails
Champs clés	id, organization_id, group_type_id, title_en, description
Relations	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
Notes spéciales	Adhésion temporelle via asset_group_item, interroger les membres actuels avec WHERE detached_at IS NULL

custom_field_def

Objectif : Définitions de champs personnalisés et méta‑données

Attribut	Détails
Champs clés	id, organization_id, owner_entity_type_id, code, field_type, is_multi, is_required
Contenu	Les types de champs incluent texte, nombre, booléen, date, datetime, entity_ref, catalog_item_ref
Notes spéciales	Permet des champs personnalisés flexibles pour tout type d'entité, les valeurs sont stockées dans des custom_field_value_* tables

acl_role_permission

Objectif : Gestion des permissions basée sur les rôles

Attribut	Détails
Champs clés	id, role_id, permission_scope_id, target_entity_id, actions
Contenu	Masque de bits d'action (READ=1, UPDATE=2, DELETE=4, CREATE=8), permissions ciblées ou étendues à un type d'entité
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
Notes spéciales	Travaille avec user_role et acl_user_scope pour déterminer les permissions finales de l'utilisateur

audit_event

Objectif : Journal d'audit unifié pour tous les changements 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)
Notes spéciales	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 relation 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

Schémas d'héritage

• Héritage de table : customizable_entity → entités métier (organisation, utilisateur, appareil, asset, inventaire, groupe_d_actifs)

• Héritage d'ID : ci_base → tables de type de référence

• Discrimination de type via entity_type_id et champ 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 quelle customizable_entity

• acl_user_scope.target_entity_id → n'importe quelle customizable_entity

• entity_tag.entity_id → n'importe quelle customizable_entity

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

Informations complémentaires

Validation des données

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

Contraintes de base de données

• Contraintes UNIQUE avec prise en charge de la suppression logique (index partiels WHERE deleted_at IS NULL)

• Contraintes CHECK (par ex., device_relation assure master_id ≠ slave_id)

• Contraintes NOT NULL sur les champs obligatoires

• Valeurs DEFAULT pour les horodatages et les drapeaux booléens

Validation au niveau de l'application

• Validation du type d'entité pour les références polymorphes

• Validation du catalogue pour les références de champs personnalisés

• Validation du type de champ personnalisé

• Gestion des tableaux de champs à valeurs multiples

Optimisation des requêtes

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

Indexes standard :

• Toutes les clés étrangères ont des index dédiés

• Indexes temporels sur created_at, updated_at, deleted_at

• Index composites pour les colonnes fréquemment jointes

Indexes spécialisés :

• Indexes GiST sur les chemins ltree pour les requêtes hiérarchiques

• Index uniques partiels prenant en charge la suppression logique

• Index des valeurs de champs personnalisés pour le filtrage et le tri

• Index d'événements d'audit sur le temps + l'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 appareil table par organization_id

• Vues matérialisées pour des calculs complexes de contrôle d'accès