Couche de données brutes

Consultez les jeux de données source pour les entités métier, la télémétrie des appareils et les actifs/inventaire, ainsi que les tables clés et la fréquence de mise à jour.

La couche Raw data contient 3 schémas de données distincts, chacun répondant à différents aspects 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 les véhicules, les employés, les géofences 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 positions, entrées, sorties et événements.

• repo - contenant des tables pour la gestion des actifs et des inventaires, y compris les types d'actifs configurables, champs personnalisés, relations d'actifs et données géospatiales pour le suivi des ressources organisationnelles.

Chaque schéma est optimisé pour son domaine de données spécifique et ses schémas d'accès, fournissant 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étiers 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_parameters" {
  "description" "character varying(150)"
  "record_added_at" timestamp [not null]
  "type" "character varying(100)" [not null]
  "key" integer [not null]
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ref:"vehicles"."vehicle_id" < "vehicle_trackers_history"."vehicle_id"

Ref:"garages"."garage_id" < "vehicles"."garage_id"

Ref:"objects"."object_id" < "vehicles"."object_id"

Ref:"users"."user_id" < "vehicles"."user_id"

Ref:"zones"."zone_id" < "geofence_points"."zone_id"

Ref:"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 au fur et à mesure des modifications 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 toute la base de données :

Type de référence	Description	Exemples de valeurs
Définitions de type	Types d'entité 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étiers	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

Description: Comptes utilisateurs contenant des informations de profil, l'affiliation à une société, les paramètres de localisation (fuseau horaire, locale) et des relations hiérarchiques via master_id pour les structures de comptes multi-niveaux

Attribut	Détails
Champs clés	- user_id - Identifiant unique de l'utilisateur - company_label - Nom de la société associée à l'utilisateur - first_name - Nom d'utilisateur - last_name - Nom de famille de l'utilisateur - middle_name - Deuxième prénom de l'utilisateur - locale - Paramètres linguistiques de l'utilisateur - timezone_label - Fuseau horaire au format IANA - master_id - Identifiant principal de l'utilisateur (si l'actuel est un subordonné) - registration_datetime - Date d'enregistrement dans le système - birth_date - Date de naissance de l'utilisateur
Relations	Utilisateur parent via master_id, lié à employees, departments, places, tasks via user_id
Notes particulières	Entité centrale reliant les données organisationnelles ; master_id permet des hiérarchies d'utilisateurs pour des structures de comptes multi-niveaux

employees

Description: Enregistrements d'employés et de conducteurs utilisés pour représenter les personnes travaillant pour l'organisation, incluant les informations personnelles, les détails de permis, les affectations de département, les clés matérielles pour identification iButton/RFID, et les données de localisation avec prise en charge du géorepérage

Attribut	Détails
Champs clés	- employee_id - Identifiant de l'entité employé - user_id - Identifiant de l'entité utilisateur - object_id - Identifiant de l'entité objet - department_id - Identifiant du département auquel l'employé est affecté - first_name - L'attribut first_name de la table employees - last_name - L'attribut last_name de la table employees - middle_name - L'attribut middle_name de la table employees - driver_license_number - Numéro de permis de conduire - driver_license_categories - Catégories du permis de conduire - driver_license_issue_date - Date de délivrance du permis de conduire - driver_license_valid_till - Date jusqu'à laquelle le permis de conduire est valide - hardware_key - Clé matérielle - email - Email de l'employé - phone_number - Téléphone de l'employé sans le signe "+" - address - Adresse du lieu - personnel_number - Numéro de personnel de l'employé/conducteur - citizen_id_number - Numéro de sécurité sociale - latitude - Localisation associée à cet employé - longitude - Localisation associée à cet employé - radius - Localisation associée à cet employé en mètres - fuel_consumption - L'attribut fuel_consumption de la table employees - fuel_cost - L'attribut fuel_cost de la table employees - is_deleted - L'attribut is_deleted de la table employees
Relations	Liens vers users, departments, objects (traceur assigné), suivi dans driver_history et checkins
Notes particulières	La clé matérielle permet l'identification du conducteur via iButton ou RFID ; prend en charge le géorepérage avec latitude, longitude, radius champs

departments

Description: Unités organisationnelles avec données de localisation géographique (latitude, longitude, radius) permettant des analyses basées sur des géorepères pour les rapports au niveau des départements et l'association de localisation des employés

Attribut	Détails
Champs clés	- department_id - Identifiant de l'entité département - user_id - Identifiant de l'entité utilisateur - department_label - L'attribut department_label de la table departments - latitude - Localisation associée à ce département - longitude - Localisation associée à ce département - radius - Taille de la géolocalisation en mètres - address - L'attribut address de la table departments
Relations	Relie les employés à la structure organisationnelle via department_id
Notes particulières	Les champs de localisation prennent en charge des analyses basées sur des géorepères pour les rapports au niveau des départements

Suivi et surveillance

devices

Description: Registre des dispositifs de suivi physiques avec identifiants matériels (IMEI), informations sur la carte SIM, état de la connectivité réseau (force du signal, itinérance, opérateur) et listing d'état pour la gestion du cycle de vie des dispositifs

Attribut	Détails
Champs clés	- device_id - ID du dispositif - owner_id - ID du propriétaire du dispositif dans le compte duquel le beacon a été ajouté - device_imei - IMEI du dispositif - phone - Numéro de la carte SIM du dispositif - status_listing_id - ID d'état du dispositif - network_label - Nom du réseau auquel la carte SIM est connectée - signal_level - Intensité du signal du dispositif - has_roaming - Indicateur de disponibilité de l'itinérance - is_sim_blocked - Indicateur de verrouillage de la SIM - created_at - Date et heure de création de l'entrée
Relations	Entité centrale liée à objects, models, sensor_description, counters; owner_id references users.user_id
Notes particulières	Toutes les données télématiques dans raw_telematics_data schéma référencent cette table via device_id

objects

Description: Registre central des entités surveillées (véhicules, actifs, personnel) liant les dispositifs physiques à la structure organisationnelle via client_id et group_id, représentant l'« unité traçable » avec un objet actif par dispositif

Attribut	Détails
Champs clés	- object_id - Identifiant de l'entité objet - client_id - Identifiant de l'entité client - device_id - Identifiant de l'entité dispositif - object_label - Nom de l'objet - model - Modèle du dispositif - group_id - Identifiant de groupe d'entité - create_datetime - Date et heure de création d'une nouvelle ligne sur le serveur - is_deleted - L'attribut is_deleted de la table objects - is_clone - Indicateur de clone
Relations	Hub central reliant les dispositifs aux utilisateurs (client_id), aux détails du véhicule, à l'historique de suivi, aux tâches et aux règles
Notes particulières	Représente l'« unité traçable » dans le système ; un objet par dispositif en usage actif

models

Description: Registre central des entités surveillées (véhicules, actifs, personnel) liant les dispositifs physiques à la structure organisationnelle via client_id et group_id, représentant l'« unité traçable » avec un objet actif par dispositif

Attribut	Détails
Champs clés	- model_id - Identifiant du modèle d'entité - model - L'attribut model de la table models - vendor - Nom de la société qui a commercialisé le traceur - alternative_label - L'attribut alternative_label de la table models - analog_amount - Nombre d'entrées analogiques du traceur - digital_amount - Nombre d'entrées discrètes du traceur - outputs_amount - Nombre de sorties discrètes du traceur - has_battery_level - Indique si le traceur transmet les lectures de charge de batterie - has_altitude - Indique si le traceur transmet l'altitude - has_phone - Y a-t-il une carte SIM ? - has_gsm_level - Un traceur peut-il transmettre la puissance du signal GSM ? - has_gsm_name - Le traceur peut-il transmettre le nom du réseau GSM ou le code de l'opérateur (MCC + MNC) ? - has_gsm_roaming - Le traceur peut-il transmettre l'état d'itinérance ? - has_detach_button - Le traceur possède-t-il un capteur de détachement ? - type_output_control - Profil de contrôle de sortie du traceur - type_special_control - Contient des réglages spécialisés et des modules fonctionnels pour des modèles de dispositifs individuels, tels que le mode conduite dangereuse (hbm_telfm) pour l'équipement Teltonika - is_clone - Le modèle est-il un clone d'un autre modèle ?
Contenu	Les indicateurs de capacité booléens indiquent quels champs de données sont disponibles pour ce type de dispositif
Notes particulières	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

Description: Configuration complète des capteurs liant les entrées du dispositif à la logique métier, incluant les mappages d'entrées, les unités de mesure, les facteurs de conversion (multiplicateur/diviseur), les tables d'étalonnage pour les capteurs de carburant, les seuils de précision et la logique de regroupement pour les lectures de capteurs agrégées

Attribut	Détails
Champs clés	- sensor_id - Identifiant de l'entité capteur - device_id - Identifiant de l'entité dispositif - sensor_label - Nom du capteur pour l'interface utilisateur - input_label - Le nom du champ du message (attribut) à partir duquel les données du capteur sont prélevées. Si égal à "input_status", il s'agit d'un capteur discret - sensor_type - Type de capteur - units_type - Unités de mesure - multiplier - Multiplicateur - le nombre par lequel multiplier la valeur du champ. Pour capteurs de mesure uniquement - divider - Diviseur - le nombre par lequel diviser la valeur du champ. Pour capteurs de mesure uniquement - accuracy - Pourcentage spécifié pour calculer l'erreur absolue du volume du réservoir. Cette erreur est utilisée pour déterminer quand des remplissages ou des vidanges se produisent. Utilisé uniquement pour les capteurs de carburant - calibration_data - L'attribut calibration_data de la table sensor_description - input_id - Numéro d'entrée pour capteur discret - group_id - Les capteurs du même type avec le même group_id et source_id sont considérés comme appartenant au même groupe. Leurs données sont sommées ou moyennées, selon la valeur de group_type. Ceci est requis pour les capteurs agrégés. Utilisé pour les capteurs de mesure - group_type - 0 - sommer les valeurs des capteurs au sein d'un groupe, 1 - faire la moyenne - sensor_units - Nom d'unité saisi par l'utilisateur si units_type=0 (personnalisé) - parameters - Objet optionnel avec paramètres additionnels parent_ids - tableau optionnel de parent_ids pour capteur composite. volume - double. Optionnel. Volume pour capteur composite. parent_ids - optionnel. tableau d'entiers. Tableau de parent_ids pour capteur composite. volume - optionnel. Double. Volume pour capteur composite. min - optionnel. Double. Valeur brute minimale acceptable pour un capteur. max - optionnel. Double. Valeur brute maximale acceptable pour un capteur. max_lowering_by_time - optionnel. Double. Valeur maximale légale de diminution par heure. max_lowering_by_mileage - optionnel. Double. Valeur maximale légale de diminution par 100 km. ignore_drains_in_move - optionnel. Boolean. Par défaut false. Si true, les vidanges de carburant ne seront pas détectées lors du mouvement. ignore_refuels_in_move - optionnel. Boolean. Par défaut false. Si true, les ravitaillements ne seront pas détectés lors du mouvement. refuel_gap_minutes - optionnel. Integer. Par défaut 5. Temps en minutes après le début du mouvement pendant lequel les ravitaillements seront détectés lors du mouvement. custom_field_name - optionnel. Boolean. Par défaut false. Le paramètre détermine si le champ input_name est une valeur personnalisée saisie par l'utilisateur. Cela n'a de sens que si le modèle de traceur possède la fonctionnalité has_custom_fields
Relations	Relie les entrées du dispositif (depuis raw_telematics_data.inputs) à la logique métier via device_id et input_label matching
Notes particulières	calibration_data (JSONB) stocke des tables d'étalonnage spécifiques aux capteurs pour les capteurs de niveau de carburant ; multiplier et divider convertir les valeurs brutes en unités

Gestion des actifs

vehicles

Description: Registre complet des véhicules contenant les spécifications (dimensions, poids, capacité), la documentation (VIN, immatriculation, assurance), les paramètres opérationnels (consommation de carburant, volume du réservoir) et l'affectation actuelle du traceur via object_id pour la gestion de flotte et le suivi de conformité

Attribut	Détails
Champs clés	- vehicle_id - Identifiant de l'entité véhicule - user_id - Identifiant de l'entité utilisateur - object_id - Identifiant de l'entité objet - garage_id - Identifiant de l'entité garage - vehicle_label - L'attribut vehicle_label de la table vehicles - registration_number - Numéro d'immatriculation / plaque d'immatriculation d'un véhicule - vin - L'attribut vin de la table vehicles - manufacture_year - L'attribut manufacture_year de la table vehicles - fuel_type - L'attribut fuel_type de la table vehicles - fuel_cost - L'attribut fuel_cost de la table vehicles - fuel_tank_volume - L'attribut fuel_tank_volume de la table vehicles - max_speed - L'attribut max_speed de la table vehicles - model - L'attribut model de la table vehicles - color - L'attribut color de la table vehicles - trailer - L'attribut trailer de la table vehicles - additional_info - L'attribut additional_info de la table vehicles - vehicle_type - L'attribut vehicle_type de la table vehicles - vehicle_subtype - L'attribut vehicle_subtype de la table vehicles - vehicle_status_id - Identifiant de l'entité statut véhicule - chassis_number - L'attribut chassis_number de la table vehicles - frame_number - L'attribut frame_number de la table vehicles - trailer_reg_number - L'attribut trailer_reg_number de la table vehicles - payload_weight - L'attribut payload_weight de la table vehicles - payload_height - L'attribut payload_height de la table vehicles - payload_length - L'attribut payload_length de la table vehicles - payload_width - L'attribut payload_width de la table vehicles - passenger_capacity - Nombre maximal de passagers - gross_weight - L'attribut gross_weight de la table vehicles - standard_fuel_consumption - Consommation de carburant moyenne normale en litres par 100 km - fuel_grade - L'attribut fuel_grade de la table vehicles - wheel_arrangement - L'attribut wheel_arrangement de la table vehicles - tyre_size - Taille du véhicule : dimensions et taille des roues - tyres_number - Nombre de roues - liability_insurance_policy_number - L'attribut liability_insurance_policy_number de la table vehicles - liability_insurance_valid_till - Date jusqu'à laquelle l'assurance responsabilité civile est valide - free_insurance_policy_number - L'attribut free_insurance_policy_number de la table vehicles - free_insurance_valid_till_date - Date jusqu'à laquelle l'assurance gratuite est valide
Relations	Liens vers objects (traceur actuel), garages (lieu de service), vehicle_service_tasks; suivi dans vehicle_trackers_history
Notes particulières	Les champs de dimension physique (payload_length, payload_width, payload_height, gross_weight) prennent en charge l'analyse de la planification des charges ; les dates d'assurance permettent le suivi de conformité

garages

Description: Emplacements d'entretien et de maintenance avec coordonnées géographiques (latitude, longitude, radius), informations de contact pour mécaniciens et répartiteurs, permettant la détection des visites de service basées sur des géorepères et l'analyse de proximité

Attribut	Détails
Champs clés	- garage_id - Identifiant de l'entité garage - user_id - Identifiant de l'entité utilisateur - latitude - Objet localisation - longitude - Objet localisation - radius - Taille de la géolocalisation en mètres - address - Objet localisation - organization_label - ID du dépôt - mechanic_name - Nom du mécanicien - dispatcher_name - Nom du répartiteur
Relations	Référencé par vehicles.garage_id pour l'affectation du lieu de service
Notes particulières	Les champs de localisation permettent la détection des visites de service basées sur des géorepères et l'analyse de proximité

vehicle_service_tasks

Description: Planification de maintenance et suivi de l'historique des services avec plusieurs types de déclencheurs (basés sur la date, le kilométrage, les heures moteur), intervalles de tâches récurrentes, notifications multi-canaux (email, SMS, push), et distinction entre événements de maintenance planifiés (is_repeat) et non planifiés

Attribut	Détails
Champs clés	- service_task_id - Identifiant de l'entité tâche de service - vehicle_id - Identifiant de l'entité véhicule - description - L'attribut description de la table vehicle_service_tasks - status - La valeur d'état de l'attribut status - cost - L'attribut cost de la table vehicle_service_tasks - start_date - La date et l'heure associées à l'attribut start_date - end_date - La date et l'heure associées à l'attribut end_date - completion_date - La date et l'heure associées à l'attribut completion_date - predicted_datetime - La date et l'heure associées à l'attribut predicted_datetime - mileage_limit - L'attribut mileage_limit de la table vehicle_service_tasks - engine_hours_limit - L'attribut engine_hours_limit de la table vehicle_service_tasks - start_mileage - L'attribut start_mileage de la table vehicle_service_tasks - start_engine_hours - L'attribut start_engine_hours de la table vehicle_service_tasks - mileage_notification_interval - L'attribut mileage_notification_interval de la table vehicle_service_tasks - engine_hours_notification_interval - L'attribut engine_hours_notification_interval de la table vehicle_service_tasks - date_notification_interval - Conversion d'un entier N en N jours - mileage_repeat_interval - L'attribut mileage_repeat_interval de la table vehicle_service_tasks - engine_hours_repeat_interval - L'attribut engine_hours_repeat_interval de la table vehicle_service_tasks - date_repeat_interval - Conversion d'un entier N en N jours - notification_emails - L'attribut notification_emails de la table vehicle_service_tasks - notification_sms_phone_numbers - L'attribut notification_sms_phone_numbers de la table vehicle_service_tasks - is_notification_push_enabled - L'attribut is_notification_push_enabled de la table vehicle_service_tasks - completion_mileage - L'attribut completion_mileage de la table vehicle_service_tasks - completion_engine_hours - L'attribut completion_engine_hours de la table vehicle_service_tasks - is_repeat - L'attribut is_repeat de la table vehicle_service_tasks - is_unplanned - L'attribut is_unplanned de la table vehicle_service_tasks - comment - L'attribut comment de la table vehicle_service_tasks
Contenu	Prend en charge trois types de déclencheurs : basé sur la date, le kilométrage, les heures moteur ; paramètres de notification pour email, SMS, push
Notes particulières	is_repeat et les champs d'intervalle permettent des calendriers de maintenance récurrents ; is_unplanned distinction entre maintenance planifiée et réactive

Localisation et routage

zones

Description: Zones géorepérées définissant des périmètres virtuels à l'aide de cercles ou de polygones pour surveiller les événements d'entrée et de sortie des véhicules/actifs, prenant en charge l'automatisation basée sur des règles et l'analyse de localisation avec codage couleur pour différenciation visuelle

Attribut	Détails
Champs clés	- zone_id - Identifiant de l'entité zone - client_id - Identifiant de l'entité client - zone_label - L'attribut zone_label de la table zones - zone_type - L'attribut zone_type de la table zones - latitude - Objet optionnel, la boîte englobante qui peut contenir entièrement le résultat retourné - longitude - Objet optionnel, la boîte englobante qui peut contenir entièrement le résultat retourné - circle_center_latitude - L'attribut circle_center_latitude de la table zones - circle_center_longitude - L'attribut circle_center_longitude de la table zones - radius - Taille de la géolocalisation en mètres - address - L'attribut address de la table zones - color - L'attribut color de la table zones
Contenu	Les types de zone incluent circle, polygon (défini via geofence_points), et des classifications de zones spéciales
Relations	Référencé par rules2zones, users2zones; sommets du polygone stockés dans geofence_points
Notes particulières	Les fonctions PostGIS peuvent être utilisées pour vérifier si un point est dans un polygone pour une analyse de géorepérage complexe

places

Description: Points d'intérêt avec coordonnées géographiques, définitions de rayon et prise en charge extensible des champs personnalisés pour stocker les informations de contact client et les données spécifiques à l'entreprise, permettant l'intégration CRM/ERP via external_id et les rapports basés sur la localisation

Attribut	Détails
Champs clés	- place_id - Identifiant de l'entité place - user_id - Identifiant de l'entité utilisateur - place_label - L'attribut place_label de la table places - latitude - Objet localisation - longitude - Objet localisation - radius - Taille de la géolocalisation en mètres - address - L'attribut address de la table places - description - L'attribut description de la table places - external_id - ID pour l'intégration avec des systèmes externes (CRM) - custom_fields - Champs supplémentaires - assigned_datetime - Date et heure d'affectation du point d'intérêt à l'utilisateur
Relations	Étiré avec les valeurs des champs personnalisés via places_text_fields, places_decimal_fields, places_bigint_fields, places_longtext_fields, places_linked_entity_fields
Notes particulières	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

Description: Coordonnées ordonnées des sommets (le champ number détermine la séquence) définissant les limites du polygone pour des formes de géorepérage complexes, permettant des périmètres géographiques précis au-delà des zones circulaires simples, utilisé avec PostGIS ST_MakePolygon pour les opérations géométriques

Attribut	Détails
Champs clés	- zone_id - Un ID de la zone auquel ce formulaire est attaché - number - Numéro de série - latitude - Emplacement - longitude - Emplacement
Relations	Enregistrements multiples par zone_id définir les limites du polygone; number le champ détermine l'ordre des sommets
Notes particulières	Requêter 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

tasks

Description: Affectations d'ordres de travail avec validation de localisation (latitude, longitude, radius), fenêtres temporelles (time_from, time_to), exigences de durée de visite (stay_duration_minutes, arrival_duration_minutes), structure hiérarchique via parent_task_id, et suivi du statut pour la gestion des services sur le terrain et les opérations de livraison

Attribut	Détails
Champs clés	- task_id - Identifiant de l'entité task - user_id - Identifiant de l'entité utilisateur - object_id - Identifiant de l'entité objet - parent_task_id - Identifiant de l'entité tâche parente - task_label - L'attribut task_label de la table tasks - status - La valeur d'état de l'attribut status - task_type - Type de tâche : task, route ou checkpoint - latitude - L'attribut latitude de la table tasks - longitude - L'attribut longitude de la table tasks - radius - Taille de la géolocalisation en mètres - arrival_datetime - Lorsque le traceur arrive dans la zone de la tâche. IGNORÉ lors de la création/mise à jour - created_at - L'attribut created_at de la table tasks - status_change_datetime - Date et heure de mise à jour de la tâche - time_from - La date et l'heure associées à l'attribut time_from - time_to - La date et l'heure associées à l'attribut time_to - stay_duration - L'attribut stay_duration de la table tasks - stay_duration_minutes - Durée de visite. Le temps qu'un travailleur mobile doit passer sur le site d'affectation pour réussir la tâche. Plusieurs visites sont cumulatives - arrival_duration_minutes - Ignorer les visites aléatoires plus courtes que la durée spécifiée. Lors du calcul de la durée minimale, les visites plus courtes que la durée spécifiée seront ignorées - max_delay_minuts - Retard acceptable. Le temps maximum pendant lequel un employé peut être en retard. Toute tâche terminée pendant ce délai sera marquée comme « late » - is_stay_control_enabled - L'attribut is_stay_control_enabled de la table tasks - address - L'attribut address de la table tasks - description - L'attribut description de la table tasks - custom_fields - L'attribut custom_fields de la table tasks - external_id - Identifiant d'entité externe - order_sort - L'attribut order_sort de la table tasks - created_by - Source de la tâche créée
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éorepérage avec emplacement et rayon
Relations	Liens vers forms (collecte de données), task_history (changements de statut), objects (tracker assigné)
Notes particulières	stay_duration et arrival_duration_minutes permettre la surveillance de conformité pour les tâches de livraison et de service

forms

Description: Formulaires de collecte de données configurables pour capturer des informations structurées lors de l'exécution d'une tâche ou des enregistrements via l'application mobile, avec champs et valeurs stockés en JSON, validation de localisation optionnelle (is_submission_in_zone) et exigences de soumission obligatoires lorsqu'ils sont attachés aux tâches

Attribut	Détails
Champs clés	- form_id - Identifiant de l'entité form - task_id - Un ID de la tâche auquel ce formulaire est attaché - object_id - Identifiant de l'entité objet - form_label - Libellé du formulaire défini par l'utilisateur - champs - Si true, le formulaire ne peut être soumis que dans la zone de la tâche - values - Une carte avec les IDs des champs comme clés et des objets field_value comme valeurs. Clé utilisée pour lier le champ et sa valeur correspondante - submitted_at - Date à laquelle les valeurs du formulaire ont été soumises pour la dernière fois - submission_latitude - Emplacement auquel les valeurs du formulaire ont été soumises pour la dernière fois - submission_longitude - Emplacement auquel les valeurs du formulaire ont été soumises pour la dernière fois - submission_address - Emplacement auquel les valeurs du formulaire ont été soumises pour la dernière fois - is_submission_in_zone - Si true, le formulaire ne peut être soumis que dans la zone de la tâche - description - Date à laquelle ce formulaire a été créé (ou attaché à la tâche) - created_at - Date à laquelle ce formulaire a été créé (ou attaché à la tâche)
Contenu	champs définit la structure du formulaire (JSON) ; values contient les données soumises (JSON)
Relations	Liens vers tasks (ordre de travail associé), objects (soumetteur), référencé dans checkins
Notes particulières	Indicateur de validation de localisation is_submission_in_zone active les règles de soumission de formulaire basées sur la géorepérage

checkins

Description: Registres d'assiduité et d'activité basés sur la localisation soumis via l'application mobile, suivant les heures d'arrivée planifiées par rapport aux heures réelles (planned_datetime vs actual_datetime) avec coordonnées géographiques et mesures de précision de localisation (radius) pour les rapports de ponctualité

Attribut	Détails
Champs clés	- checkin_id - Identifiant de l'entité checkin - employee_id - L'identifiant de l'entité employé est également l'identifiant pour les conducteurs - object_id - Appareil de l'employé - form_id - Identifiant de l'entité form - user_id - Utilisateur employé - planned_datetime - Heure de l'appareil lorsque le check-in a été effectué - actual_datetime - Heure du serveur lorsque la requête/le message a été traité - latitude - Emplacement auquel les checkins ont été soumis - longitude - Emplacement auquel les checkins ont été soumis - radius - Erreur de positionnement en mètres - address - Adresse du check-in - comment - L'attribut comment de la table checkins
Relations	Relie les employés aux formulaires et aux emplacements ; suit l'écart par rapport au planning prévu
Notes particulières	Variance temporelle entre planned_datetime et actual_datetime active les rapports de ponctualité ; le rayon définit la tolérance de localisation acceptable

task_history

Description: Traçabilité complète des événements du cycle de vie des tâches capturant tous les changements de statut, affectations, mises à jour et modifications de champ avec horodatages (event_datetime), attribution utilisateur, et types d'activité (create, update, assign, status_change) stockés dans le champ payload pour l'analyse de conformité et des flux de travail

Attribut	Détails
Champs clés	- task_history_id - Identifiant de l'entité historique de tâche - task_id - Identifiant de l'entité task - user_id - Identifiant de l'entité utilisateur - activity - Opération qui s'est produite. Peut être "create", "update", "assign" ou "status_change" - event_datetime - Date et heure de l'événement - payload - Dépend de l'opération. Contient typiquement les champs qui ont été modifiés lors de l'opération
Contenu	Types d'activité définis dans description_parameters; payload stocke les détails spécifiques à l'événement (texte)
Notes particulières	Essentiel pour l'analyse de l'achèvement des tâches, les rapports de transition de statut et le suivi de l'activité des utilisateurs

Règles et automatisation

rules

Description: Règles de détection d'événements avec conditions de déclenchement configurables (excès de vitesse, violations de géorepérage, seuils de capteur, temps d'inactivité) stockées dans parameters (JSONB), et paramètres de notification multicanal (alert_email, alert_sms, alert_phone, is_push_enabled) pour la surveillance automatisée et les alertes basées sur les données des appareils et du serveur

Attribut	Détails
Champs clés	- rule_id - Identifiant de l'entité rule - object_id - Identifiant de l'entité objet - client_id - Identifiant de l'entité client - event_type - L'attribut event_type de la table rules - event_label - L'attribut event_label de la table rules - event_group - L'attribut event_group de la table rules - description - L'attribut description de la table rules - parameters - Paramètres de l'événement. Pour plus de détails sur les paramètres disponibles, voir Navixy API docs. - alert_email - E-mail pour les notifications - alert_sms - Numéros de téléphone pour les notifications SMS - alert_phone - Téléphones pour les appels vocaux - is_push_enabled - Si true, les notifications push sont disponibles - created_at - L'attribut created_at de la table rules - is_deleted - L'attribut is_deleted de la table rules - maximum - Limites appliquées à diverses règles. Par exemple, pour la règle de temps d'inactivité avec le moteur en marche en minutes - event_comment1 - L'attribut event_comment1 de la table rules - event_comment2 - L'attribut event_comment2 de la table rules
Contenu	Les paramètres de règle (JSONB) définissent les conditions de déclenchement ; prend en charge les notifications par e-mail, SMS, téléphone et push
Relations	Liens vers des objets via rules2objects, zones via rules2zones
Notes particulières	event_type définit un scénario de surveillance spécifique (excès de vitesse, violation de géorepérage, seuil de capteur) ; maximum le champ permet l'agrégation d'événements pour les alertes basées sur des seuils

rules2objects

Description: Relation plusieurs-à-plusieurs reliant les règles aux objets surveillés avec personnalisation des paramètres par objet via object_params (JSONB), permettant différentes valeurs de seuil (par ex. limites de vitesse) pour chaque véhicule ou actif au sein de la même règle

Attribut	Détails
Champs clés	- rule_id - Identifiant de l'entité rule - object_id - Identifiant de l'entité objet - param_group_number - L'attribut param_group_number de la table rules2objects - object_params - L'attribut object_params de la table rules2objects
Contenu	object_params (JSONB) permet la personnalisation des règles par objet (par ex. différentes limites de vitesse par véhicule)
Notes particulières	La relation plusieurs-à-plusieurs permet qu'une règle surveille plusieurs objets avec des paramètres différents

rules2zones

Description: Relation plusieurs-à-plusieurs associant les règles à des zones géorepérées, permettant à une seule règle de surveiller les événements d'entrée/sortie sur plusieurs zones géographiques pour des scénarios de surveillance spatiale complexes

Attribut	Détails
Champs clés	- rule_id - Identifiant de l'entité rule - zone_id - Identifiant de l'entité zone
Notes particulières	La relation plusieurs-à-plusieurs permet la surveillance multi-zone pour une seule règle (par ex. alerter lorsqu'on entre dans n'importe quelle zone restreinte parmi plusieurs)

Statut et catégorisation

statuses

Description: Définitions de statuts personnalisés au sein des listes de statuts, incluant des propriétés d'affichage (color pour l'affichage sur le site web, order_sort pour le positionnement) utilisées pour représenter les états de travail des appareils ou des employés avec prise en charge de la suppression logique via le drapeau is_deleted

Attribut	Détails
Champs clés	- status_id - Identifiant de l'entité status - listing_id - Identifiant de l'entité listing - status_label - Valeur de statut de l'attribut status_label - color - Couleur utilisée pour l'affichage sur le site web - order_sort - Position de tri au sein de la liste de statuts - is_deleted - L'attribut is_deleted de la table statuses
Relations	Groupes de statuts organisés par listing_id (références status_listings); utilisé dans status_history
Notes particulières	order_sort définit la séquence d'affichage ; la couleur permet une différenciation visuelle dans les rapports

status_listings

Description: Définitions d'ensembles de statuts contrôlant quelles valeurs de statut sont disponibles pour les appareils ou les employés, avec des drapeaux de permission (is_supervisor_controlled, is_employee_controlled) déterminant si les superviseurs, les employés ou les deux peuvent modifier les valeurs de statut

Attribut	Détails
Champs clés	- status_listing_id - Identifiant de l'entité status listing - user_id - Identifiant de l'entité utilisateur - status_listing_label - Valeur de statut de l'attribut status_listing_label - is_supervisor_controlled - Si true, les superviseurs peuvent changer le statut de travail, par ex. en utilisant l'application de surveillance mobile - is_employee_controlled - Si true, les employés peuvent changer leur propre statut de travail, par ex. en utilisant l'application de suivi mobile - is_deleted - L'attribut is_deleted de la table status_listings
Relations	Référencé par devices.status_listing_id et statuses.listing_id
Notes particulières	Les drapeaux de contrôle déterminent qui peut changer les statuts : superviseur uniquement, autoservice employé, ou les deux

status_history

Description: Piste d'audit de toutes les transitions de statut des appareils avec horodatages (changed_datetime sur l'appareil, server_datetime sur le serveur), attribution utilisateur (updated_by), et capture de localisation (latitude, longitude, address) permettant l'analyse géographique des changements de statut et les rapports d'emplacement de début/fin de journée de travail

Attribut	Détails
Champs clés	- status_history_id - Identifiant de l'entité historique de statut - device_id - Identifiant de l'entité dispositif - old_status_id - Identifiant de l'entité ancien statut - new_status_id - Identifiant de l'entité nouveau statut - updated_by - La date et l'heure associées à l'attribut updated_by - changed_datetime - Date et heure d'affectation d'un nouveau statut sur l'appareil - server_datetime - Date et heure d'affectation du nouveau statut serveur - latitude - Localisation des appareils lors des changements de statut - longitude - Localisation des appareils lors des changements de statut - address - Localisation des appareils lors des changements de statut
Relations	Liens vers devices, statuses (ancien et nouveau), description_parameters (pour updated_by role)
Notes particulières	La capture de localisation permet l'analyse géographique des transitions de statut ; utile pour les rapports d'emplacement de début/fin de journée de travail

tags

Description: Étiquettes de catégorisation définies par l'utilisateur avec codage couleur permettant un filtrage et une recherche rapides à travers plusieurs types d'entités (places, geofences, employés, tâches, trackers, véhicules) pour une organisation flexible

Attribut	Détails
Champs clés	- tag_id - ID de l'entité tag - user_id - Identifiant de l'entité utilisateur - tag_label - L'attribut tag_label de la table tags - color - L'attribut color de la table tags
Relations	Appliqué aux entités via tag_links; portée définie par l'utilisateur
Notes particulières	Système de catégorisation flexible supportant plusieurs tags par entité

tag_links

Description: Table de relation polymorphe associant des tags à n'importe quel type d'entité via entity_type et entity_id, avec un champ ordinal pour la gestion de l'ordre d'affichage, permettant un étiquetage multi-entités flexible

Attribut	Détails
Champs clés	- tag_id - ID de l'entité tag - entity_type - L'attribut entity_type de la table tag_links - entity_id - Identifiant de l'entité - ordinal - L'attribut ordinal de la table tag_links
Contenu	entity_type identifie la table (vehicle, employee, task, etc.) ; ordinal définit l'ordre d'affichage
Notes particulières	La relation polymorphe permet le marquage à travers différents types d'entités

Groupes et hiérarchie

groups

Description: Structure de regroupement organisationnel pour les trackers permettant une organisation visuelle dans l'interface utilisateur avec des couleurs personnalisables (group_color) et une gestion hiérarchique de type dossier, servant actuellement une fonction purement visuelle

Attribut	Détails
Champs clés	- group_id - Groupe de traceurs (lié par objects.group_id). La division en groupes peut être visualisée dans la liste des balises, par exemple - client_id - Identifiant de l'entité client - group_label - Titre de groupe spécifié par l'utilisateur, 1 à 60 caractères imprimables, par ex. "Employees" - group_color - Couleur du groupe au format web (sans #), par ex. "FF6DDC". Détermine la couleur des marqueurs de traceur sur la carte
Relations	Référencé par objects.group_id; propriété client via client_id (références users)
Notes particulières	Permet une organisation de type dossier des entités de surveillance pour les rapports et les permissions

groups_objects

Description: Relation plusieurs-à-plusieurs entre groups et objects utilisant une clé primaire composite (groups_client_id, objects_client_id), permettant aux objets d'appartenir à plusieurs groupes simultanément pour des structures organisationnelles flexibles

Attribut	Détails
Champs clés	- groups_client_id - Identifiant de l'entité client pour les groupes - objects_client_id - Identifiant de l'entité client pour les objets
Notes particulières	Permet aux objets d'appartenir à plusieurs groupes simultanément ; requêter avec les deux client_id valeurs pour l'appartenance au groupe

Champs personnalisés et entités

entities

Description: Registre des types d'entités définissant quelles entités métier prennent en charge les champs personnalisés et leur structure de disposition de champs (sections, field_order) stockée dans entity_label (JSONB), permettant l'extension dynamique du schéma pour places, tasks et autres entités sans modifications de la base de données

Attribut	Détails
Champs clés	- entity_id - Identifiant de l'entité - user_id - Identifiant de l'entité utilisateur - entity_label - id - int. Identifiant de l'entité. type - enum. Actuellement, seul "place" est pris en charge. layout - objet décrivant la disposition des champs pour l'entité. sections - tableau d'objets. Chaque section peut contenir un ou plusieurs champs. Au moins une section doit exister dans une disposition. label - chaîne. Nom de la section. field_order - tableau de chaînes. Champs intégrés et IDs des champs personnalisés (en tant que chaînes) - builtin_type - L'attribut builtin_type de la table entities
Relations	Référencé par custom_fields pour définir quels champs personnalisés s'appliquent à quels types d'entités
Notes particulières	builtin_type liens vers description_parameters pour les classifications d'entités définies par le système

custom_fields

Description: Définitions de champs personnalisés permettant l'extension dynamique du schéma pour les types d'entités, avec types de champs configurables (custom_field_type), règles de validation et options dans parameters (JSONB), et indicateurs d'obligation (is_required) pour une capture de données flexible sur places, tasks et autres entités

Attribut	Détails
Champs clés	- custom_field_id - Identifiant de l'entité custom field - entity_id - Identifiant de l'entité - custom_field_label - Nom du champ - custom_field_type - Type de données dans le champ - description - Description du champ - is_required - Est-ce requis ou non ? - parameters - Paramètres du champ
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_parameters
Notes particulières	Permet l'extension dynamique du schéma sans modifications de la base de données ; utilisé largement dans places et tasks

Suivi historique

driver_history

Description: Traçabilité complète des affectations employé-vers-véhicule au fil du temps suivant les transitions old_employee_id vers new_employee_id avec horodatages (changed_datetime, server_datetime), données de localisation (latitude, longitude, address), informations sur la clé matérielle et attribution utilisateur (updated_by) permettant des analyses spécifiques au conducteur lorsque les conducteurs changent de véhicule

Attribut	Détails
Champs clés	- driver_history_id - Identifiant de l'entité historique du conducteur - object_id - Identifiant de l'entité objet - old_employee_id - Identifiant de l'ancienne entité employé - new_employee_id - Identifiant de la nouvelle entité employé - hardware_key - L'attribut hardware_key de la table driver_history - changed_datetime - Date et heure des modifications apportées à l'appareil - server_datetime - Date et heure des modifications effectuées sur le serveur - updated_by - La date et l'heure associées à l'attribut updated_by - latitude - L'attribut latitude de la table driver_history - longitude - L'attribut longitude de la table driver_history - address - L'attribut address de la table driver_history
Relations	Suit les affectations des conducteurs aux véhicules au fil du temps ; liens vers employees et objects
Notes particulières	Essentiel pour les rapports spécifiques au conducteur lorsque les conducteurs changent de véhicule ; la capture de localisation permet l'analyse des lieux de changement d'affectation

vehicle_trackers_history

Description: Piste d'audit suivant quels appareils GPS (object_id) ont été installés dans quels véhicules (vehicle_id) au fil du temps avec horodatages de changement (changed_datetime), permettant une attribution historique précise des données et le calcul du kilométrage lorsque les traceurs sont déplacés entre véhicules

Attribut	Détails
Champs clés	- vehicle_tracker_history_id - Identifiant de l'entité historique du traceur véhicule - vehicle_id - Identifiant de l'entité véhicule - object_id - Identifiant de l'entité objet - changed_datetime - La date et l'heure associées à l'attribut changed_datetime
Relations	Suit quel appareil GPS a été installé dans quel véhicule au fil du temps
Notes particulières	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_parameters

Description: Données de référence à l'échelle du système fournissant des libellés lisibles par l'humain (description) pour des valeurs entières énumérées (key) utilisées dans toute la base de données, organisées par champ type (par ex. task_status, fuel_type, counter_type, entity_classification) pour une traduction cohérente des valeurs dans les rapports et l'affichage de l'interface utilisateur

Attribut	Détails
Champs clés	- key - Valeur possible dans l'attribut - type - Un attribut composite consistant du nom de la table suivi d'un underscore et du nom d'un attribut dans la table - description - Valeur implicite d'un attribut
Contenu	Fournit des libellés lisibles pour les valeurs codées dans toute la base de données (statut de tâche, types de carburant, types de compteur, etc.)
Relations	Référencé via des clés étrangères depuis plusieurs tables pour une catégorisation standardisée
Notes particulières	Essentiel pour traduire les codes entiers en valeurs lisibles dans les rapports ; type groupes de champs liés aux énumérations

counters

Description: Configurations des compteurs d'odomètre et d'heures moteur liant les lectures des capteurs d'appareil (sensor_id) aux mesures de distance ou de temps avec coefficients multiplicateurs pour la conversion d'unités (km, miles, heures) et counter_type depuis description_parameters définissant le type de mesure

Attribut	Détails
Champs clés	- counter_id - ID interne - device_id - Identifiant de l'entité dispositif - counter_type - Type de compteur - sensor_id - Identifiant de l'entité capteur - multiplier - Coefficient pour convertir les valeurs en une des métriques (km, l, etc.)
Relations	Relie les appareils aux lectures de capteurs qui représentent des compteurs de distance ou de temps
Notes particulières	multiplier convertit les impulsions du capteur en unités réelles (km, miles, heures) ; counter_type from description_parameters définit le type de mesure

device_output_name

Description: Libellés personnalisés pour les canaux de sortie de l'appareil mappant les identifiants numériques de sortie (number) à des noms définis par l'utilisateur (label) tels que "Door Lock" ou "Engine Block" pour des rapports lisibles et l'analyse des commandes et états de sortie de l'appareil

Attribut	Détails
Champs clés	- device_id - Identifiant de l'entité dispositif - number - L'attribut number de la table device_output_name - label - L'attribut label de la table device_output_name
Contenu	Mappe les numéros de canaux de sortie à des noms définis par l'utilisateur (par ex., "Door Lock", "Engine Block")
Notes particulières	Permet 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 l'appareil.

ERD des données télématiques brutes de 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 remplit un rôle spécifique dans la capture de différents aspects des informations de l'appareil :

tracking_data_core

Objectif: Données de position et de mouvement principales

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 particulières	Les données de localisation (latitude et longitude) utilisent le 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: Relevés de capteurs provenant des appareils

Attribut	Détails
Champs clés	input_id, device_id, device_time, sensor_name, value
Contenu	Relevés 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 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 (en service, au ralenti, éteint), états des composants (allumage, portes)
Format de la 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 (généralement 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 garantit l'intégrité des données par 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 requis contiennent toujours des valeurs

• Valeurs DEFAULT fournir un repli lorsque les données ne sont pas explicitement fournies

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 possèdent des index dédiés pour les performances des jointures

• Les combinaisons de colonnes fréquemment utilisées disposent de index composites

• TimescaleDB fournit des index spécialisés pour les requêtes de 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 si vous avez des questions concernant cette fonctionnalité, veuillez contacter [e-mail].

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 les organisations hiérarchiques, les définitions de champs personnalisés pour tout type d'entité, le 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 modifications du schéma, localisées pour des déploiements internationaux et reliées via des relations polymorphes flexibles.

Le schéma traite 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 à la conformité avec des 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 data schema

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

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

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

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

Ref: customizable_entity.entity_type_id > ci_entity_type.id

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ref: entity_tag.tag_id > ci_tag.id

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

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

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

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

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

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

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

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

Ref: audit_event.user_id > user.id

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 se produisent immédiatement lorsque des changements interviennent, avec des 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 l'utilisateur en une structure unifiée, offrant cohérence et flexibilité sur l'ensemble du schéma.

Architecture :

Le ci_base la table sert de fondation pour toutes les données de référence, en utilisant un discriminator 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 de type sécurisé.

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

Toutes les entités métier dans le repo schéma référencent ci_base des 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érences :

Catégorie	Tables	Objectif
Configuration du 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 des types d'entité	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é à 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 l'organisation du catalogue

Exemples de requêtes

-- Récupérer 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;

-- Récupérer 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;

-- Récupérer 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 finalité métier.

organization

Finalité : Gestion de l'organisation hiérarchique

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, indexes sur parent_id et organization_type_id
Notes particulières	Utilise ltree pour les hiérarchies multi-niveaux, hérite de customizable_entity pour la prise en charge des champs personnalisés

user

Finalité : 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 particulières	Intégration de fournisseurs d'identité externes (Keycloak, Auth0, Okta), hérite de customizable_entity

device

Finalité : Appareils de suivi physiques

Attribut	Détails
Champs clés	id, organization_id, device_type_id, status_id, hw_id, label
Indexation	Indexes sur organization_id, device_type_id, status_id, hw_id
Notes particulières	Identifiant matériel pour le suivi des appareils, hérite de customizable_entity pour les champs personnalisés

asset

Finalité : Actifs physiques ou virtuels

Attribut	Détails
Champs clés	id, organization_id, asset_type_id, label, description
Indexation	Indexes sur organization_id et asset_type_id
Notes particulières	Hérite de customizable_entity, lié aux appareils via device_asset_link

inventory

Finalité : 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 particulières	Codes uniques au sein de l'organisation, liés aux appareils via device_inventory_link

asset_group

Finalité : 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 particulières	Adhésion basée sur le temps via asset_group_item, interroger les membres actuels avec WHERE detached_at IS NULL

custom_field_def

Finalité : Définitions et métadonnées des champs personnalisés

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 text, number, boolean, date, datetime, entity_ref, catalog_item_ref
Notes particulières	Permet des champs personnalisés flexibles pour tout type d'entité, valeurs stockées dans des custom_field_value_* tables

acl_role_permission

Finalité : 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 d'actions (READ=1, UPDATE=2, DELETE=4, CREATE=8), permissions spécifiques à une cible ou à 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 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 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	Indexes sur (user_id, occurred_at), (aggregate_type, aggregate_id, occurred_at), (event_category, occurred_at)
Notes 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 dans event_data JSONB

Relations de données

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

Structures hiérarchiques

• Les organisations utilisent des chemins ltree pour des requêtes d'arbre efficaces

• É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 (organization, user, device, asset, inventory, asset_group)

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

• Discrimination de type via entity_type_id et discriminator 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 prise en charge de la suppression douce (index partiels WHERE deleted_at IS NULL)

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

• Contraintes NOT NULL sur les champs requis

• Valeurs DEFAULT pour les horodatages et les indicateurs 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 :

Index standards :

• Toutes les clés étrangères ont des 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 d'événements d'audit sur le temps + entité pour des recherches efficaces

Considérations de performance :

• Pool de connexions recommandé (PgBouncer)

• Entretien VACUUM régulier 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