> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/fr/iot-query/schema-overview/bronze-layer/raw-business-data.md).

# Schéma raw\_business\_data

raw\_business\_data contient plus de 40 tables couvrant les utilisateurs, les objets, les véhicules, les missions et les géozones. Parcourez la définition du schéma et les descriptions des tables clés pour l'analyse SQL

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

{% hint style="info" %}
Le diagramme interactif du schéma raw\_business\_data est disponible sur **dbdiagram.io**: <https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a>
{% endhint %}

Vous trouverez ci-dessous les détails du schéma des données métier brutes.

{% code title="Schéma raw\_business\_data" expandable="true" %}

```sql
Table "vehicle_service_tasks" {
  Horodatage « record_added_at » [non nul]
  "start_mileage" numérique
  "commentaire" "character varying(255)"
  "status" "character varying(10)" [non nul]
  Horodatage de « completion_date »
  "start_engine_hours" numérique
  "service_task_id" integer [not null]
  "is_notification_push_enabled" booléen [non nul]
  intervalle « date_notification_interval »
  Horodatage « predicted_datetime »
  "coût" numérique [non nul]
  "mileage_limit" numérique
  Texte « notification_emails »
  "is_unplanned" booléen [non nul]
  "is_repeat" booléen [non nul]
  "completion_engine_hours" entier
  "engine_hours_limit" numérique
  "mileage_repeat_interval" integer
  "vehicle_id" entier [non nul]
  "engine_hours_notification_interval" entier
  Horodatage « start_date »
  "mileage_notification_interval" entier
  intervalle « date_repeat_interval »
  "description" "character varying(255)"
  Texte « notification_sms_phone_numbers »
  Horodatage « end_date »
  "engine_hours_repeat_interval" entier
  "completion_mileage" entier
}

Table "garages" {
  Horodatage « record_added_at » [non nul]
  "garage_id" integer [non nul]
  "longitude" numérique
  "mechanic_name" "character varying(255)"
  "radius" entier [non null]
  "latitude" numérique
  "organization_label" "character varying(255)"
  "user_id" entier [non nul]
  "dispatcher_name" "character varying(255)"
  "adresse" "character varying(255)"
}

Table "driver_history" {
  Horodatage « server_datetime » [non nul]
  "adresse" "character varying(255)"
  "updated_by" entier [non nul]
  "object_id" integer
  "longitude" numérique
  "latitude" numérique
  "driver_history_id" integer [not null]
  "hardware_key" "character varying(64)"
  "new_employee_id" entier
  Horodatage "changed_datetime"
  Horodatage « record_added_at » [non nul]
  "old_employee_id" entier
}

Table "departments" {
  Horodatage « record_added_at » [non nul]
  "department_label" "character varying(255)" [non nul]
  "latitude" numérique
  "department_id" entier [non nul]
  "adresse" "character varying(255)"
  "radius" entier [non null]
  "longitude" numérique
  "user_id" entier [non nul]
}

Tableau "checkins" {
  "radius" entier [non null]
  "latitude" numérique [non null]
  "employee_id" integer [non nul]
  "longitude" numérique [non null]
  Horodatage « record_added_at » [non nul]
  Horodatage « actual_datetime » [non nul]
  "user_id" entier [non nul]
  "form_id" integer [not null]
  "adresse" "character varying(255)"
  Horodatage "planned_datetime" [non nul]
  "object_id" integer [not null]
  "checkin_id" integer [not null]
  Texte « comment »
}

Tableau "statuses" {
  "order_sort" entier [non nul]
  "listing_id" entier [non nul]
  "color" "character varying(6)" [not null]
  "status_id" integer [not null]
  "libellé d’état" "character varying(200)" [not null]
  Horodatage « record_added_at » [non nul]
  "is_deleted" booléen [non nul]
}

Table "places_linked_entity_fields" {
  "value" bigint [not null]
  Horodatage « record_added_at » [non nul]
  "place_id" entier [not null]
  "field_id" integer [not null]
}

Table "places_text_fields" {
  "place_id" entier [not null]
  Horodatage « record_added_at » [non nul]
  Texte « value » [non nul]
  "field_id" integer [not null]
}

Tableau « users2zones » {
  "zone_id" entier [not null]
  Horodatage « record_added_at » [non nul]
  "user_id" entier [non nul]
}

Table « objects » {
  Horodatage « record_added_at » [non nul]
  Horodatage « create_datetime » [non nul]
  "client_id" integer [not null]
  "group_id" integer
  "object_label" "character varying(100)"
  "model" "character varying(64)"
  "is_clone" booléen [non nul]
  "is_deleted" booléen [non nul]
  "device_id" integer [not null]
  "object_id" integer [not null]
}

Table "device_output_name" {
  "device_id" integer [not null]
  Horodatage « record_added_at » [non nul]
  "label" "character varying(100)" [not null]
  "number" entier [non nul]
}

Table "geofence_points" {
  "longitude" numérique [non null]
  "number" entier [non nul]
  "zone_id" entier [not null]
  Horodatage « record_added_at » [non nul]
  "latitude" numérique [non null]
}

Table "custom_fields" {
  Horodatage « record_added_at » [non nul]
  "entity_id" entier [not null]
  "is_required" booléen [non nul]
  Texte « custom_field_label » [non nul]
  "parameters" jsonb
  "custom_field_type" entier [non nul]
  Texte de la "description"
  "custom_field_id" entier [non nul]
}

Table "places_decimal_fields" {
  "field_id" integer [not null]
  Horodatage « record_added_at » [non nul]
  "place_id" entier [not null]
  "value" numérique [non nul]
}

Table "task_history" {
  "task_id" integer [not null]
  "activity" entier [non nul]
  "task_history_id" integer [not null]
  Horodatage « record_added_at » [non nul]
  "user_id" entier [non nul]
  Horodatage « event_datetime » [non nul]
  texte « payload »
}

Table "Mots clés" {
  "tag_label" "character varying(64)" [not null]
  "color" "character varying(6)"
  "user_id" entier [non nul]
  Horodatage « record_added_at » [non nul]
  "tag_id" integer [not null]
}

Table "Lieux" {
  Texte de la "description"
  "custom_fields" jsonb
  "place_id" entier [not null]
  "external_id" "character varying(32)"
  Horodatage « record_added_at » [non nul]
  "user_id" entier
  "latitude" numérique
  "radius" entier
  "place_label" "character varying(256)"
  "assigned_datetime" timestamp
  "address" "character varying(256)"
  "longitude" numérique
}

Table "status_listings" {
  "user_id" entier [non nul]
  "is_supervisor_controlled" boolean [not null]
  "is_deleted" booléen [non nul]
  "status_listing_id" integer [not null]
  "is_employee_controlled" boolean [not null]
  Horodatage « record_added_at » [non nul]
  "status_listing_label" "character varying(200)" [not null]
}

Table "models" {
  Horodatage « record_added_at » [non nul]
  "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" entier [non nul]
  "has_detach_button" booléen [non nul]
  "has_gsm_name" booléen [non nul]
  "analog_amount" entier [non nul]
  "outputs_amount" entier [non nul]
}

Tableau "vehicle_trackers_history" {
  "vehicle_id" entier [non nul]
  Horodatage « record_added_at » [non nul]
  "object_id" integer [not null]
  Horodatage « changed_datetime » [non nul]
  "vehicle_tracker_history_id" integer [not null]
}

Tableau "groups" {
  "group_id" entier [non nul]
  "group_color" "character varying(6)" [not null]
  "group_label" "character varying(255)" [not null]
  "client_id" integer [not null]
  Horodatage « record_added_at » [non nul]
}

Table "sensor_description" {
  Horodatage « record_added_at » [non nul]
  "parameters" jsonb
  "input_id" entier [non nul]
  "précision" numeric [not null]
  "sensor_units" "character varying(10)"
  "multiplier" doubleprecision [not null]
  "input_label" "character varying(64)"
  "sensor_label" "character varying(100)"
  "units_type" entier [non nul]
  "divider" doubleprecision [not null]
  "group_id" entier [non nul]
  "sensor_id" integer [not null]
  "device_id" integer [not null]
  "sensor_type" "character varying(45)" [not null]
  "group_type" entier [non nul]
  "calibration_data" jsonb
}

Table "entities" {
  "entity_label" jsonb
  Horodatage « record_added_at » [non nul]
  "entity_id" entier [not null]
  "builtin_type" entier [non nul]
  "user_id" entier [non nul]
}

Table "zones" {
  "adresse" "character varying(255)"
  "radius" entier [non null]
  "zone_id" entier [not null]
  "circle_center_latitude" numérique [non nul]
  "client_id" integer [not null]
  "zone_label" "character varying(100)"
  "color" "character varying(6)" [not null]
  "zone_type" "character varying(20)" [non nul]
  "circle_center_longitude" numérique [non nul]
  "latitude" numérique [non null]
  Horodatage « record_added_at » [non nul]
  "longitude" numérique [non null]
}

Table "vehicles" {
  "vehicle_id" entier [non nul]
  « payload_length » numérique
  "vin" "character varying(20)"
  "free_insurance_policy_number" "character varying(50)"
  "vehicle_label" "character varying(100)"
  "payload_width" numérique
  "color" "character varying(6)"
  "remorque" "character varying(255)"
  "object_id" integer
  "vehicle_status_id" entier
  horodatage "liability_insurance_valid_till"
  "manufacture_year" entier
  "qualité_carburant" "character varying(16)"
  "fuel_cost" numérique
  "fuel_tank_volume" numeric
  "model" "character varying(100)"
  "garage_id" entier
  "payload_height" numérique
  "max_speed" numérique
  "registration_number" "character varying(32)"
  "tyre_size" "character varying(50)"
  "passenger_capacity" entier
  Horodatage « record_added_at » [non nul]
  "trailer_reg_number" "character varying(32)"
  horodatage de "free_insurance_valid_till_date"
  "gross_weight" numérique
  "standard_fuel_consumption" numérique
  "fuel_type" entier
  "payload_weight" numérique
  texte "additional_info"
  "vehicle_subtype" "character varying(32)"
  "liability_insurance_policy_number" "character varying(50)"
  "frame_number" "character varying(32)"
  "user_id" entier [non nul]
  "vehicle_type" entier [non nul]
  "numéro_de_châssis" "character varying(32)"
  "tyres_number" entier
  "wheel_arrangement" "character varying(16)"
}

Table "Mots clés_links" {
  "entity_id" entier [not null]
  Horodatage « record_added_at » [non nul]
  "entity_type" entier [non nul]
  "ordinal" entier [non nul]
  "tag_id" integer [not null]
}

Table « rules » {
  "rule_id" entier [non nul]
  "object_id" integer [not null]
  "parameters" jsonb
  "alert_phone" "character varying(210)" [non nul]
  "event_type" "character varying(100)" [non nul]
  "client_id" integer [not null]
  "is_push_enabled" booléen [non nul]
  "event_comment1" "character varying(255)" [non nul]
  "event_label" "character varying(255)" [non nul]
  "description" "character varying(255)" [non nul]
  Horodatage « record_added_at » [non nul]
  Texte « alert_sms » [non nul]
  "event_group" integer [not null]
  "created_at" timestamp [not null]
  "maximum" integer [not null]
  "is_deleted" booléen [non nul]
  "alert_email" text [not null]
  "event_comment2" "character varying(255)" [not null]
}

Table "status_history" {
  "longitude" numérique
  "new_status_id" integer
  "status_history_id" integer [not null]
  "device_id" integer [not null]
  "updated_by" entier [non nul]
  "adresse" "character varying(255)"
  "latitude" numérique
  Horodatage « record_added_at » [non nul]
  Horodatage « server_datetime » [non nul]
  Horodatage "changed_datetime"
  "old_status_id" integer
}

Table "rules2zones" {
  "zone_id" entier [not null]
  Horodatage « record_added_at » [non nul]
  "rule_id" entier [non nul]
}

Table "forms" {
  "object_id" integer [not null]
  Texte de la "description"
  "form_label" "character varying(255)" [not null]
  Texte « fields »
  "created_at" timestamp [not null]
  "submission_address" "character varying(255)"
  "submission_latitude" numérique
  "form_id" integer [not null]
  "submission_longitude" numérique
  "is_submission_in_zone" booléen [non nul]
  Texte « values »
  Horodatage « record_added_at » [non nul]
  "task_id" entier
  Horodatage « submitted_at »
}


Table "rules2objects" {
  "object_params" jsonb
  "param_group_number" integer [not null]
  "object_id" integer [not null]
  Horodatage « record_added_at » [non nul]
  "rule_id" entier [non nul]
}

Table "tasks" {
  Horodatage « time_from »
  intervalle « stay_duration_minutes »
  "external_id" "character varying(100)"
  "object_id" integer
  "task_type" entier
  intervalle « arrival_duration_minutes »
  entier « status »
  Horodatage « arrival_datetime »
  Horodatage « record_added_at » [non nul]
  "task_id" integer [not null]
  "user_id" entier
  horodatage « status_change_datetime »
  "order_sort" entier
  Horodatage « time_to »
  "max_delay_minuts" entier
  « is_stay_control_enabled » booléen
  "adresse" "character varying(255)"
  "task_label" "character varying(200)" [not null]
  "longitude" numérique
  "created_by" entier
  Texte « description » [non nul]
  "radius" entier
  "latitude" numérique
  "stay_duration" entier
  "created_at" timestamp [not null]
  "custom_fields" jsonb
  "parent_task_id" entier
}

Table "places_bigint_fields" {
  "field_id" integer [not null]
  "value" bigint [not null]
  "place_id" entier [not null]
  Horodatage « record_added_at » [non nul]
}

Tableau "devices" {
  "is_sim_blocked" booléen [non nul]
  "device_id" integer [not null]
  "device_imei" "character varying(64)" [non nul]
  "network_label" "character varying(50)" [non nul]
  "status_listing_id" integer [not null]
  "signal_level" numérique [not null]
  "phone" "character varying(32)" [non nul]
  "has_roaming" booléen [non nul]
  "created_at" timestamp [not null]
  "owner_id" integer [not null]
  Horodatage « record_added_at » [non nul]
}

Table « description_parameters » {
  "description" "character varying(150)"
  Horodatage « record_added_at » [non nul]
  "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)" [non nul]
  "user_id" entier [non nul]
  "locale" "character varying(10)" [not null]
  Horodatage « record_added_at » [non nul]
}

Table « compteurs » {
  "sensor_id" entier
  "multiplier" numérique [non nul]
  "counter_id" entier [non nul]
  "device_id" integer [not null]
  "counter_type" entier [non nul]
  Horodatage « record_added_at » [non nul]
}

Table "employees" {
  "driver_license_valid_till" horodatage
  Horodatage « record_added_at » [non nul]
  "last_name" "character varying(100)"
  "department_id" entier
  "citizen_id_number" "character varying(32)"
  "first_name" "character varying(100)"
  "catégories_de_permis_de_conduire" "caractère variable(32)"
  "user_id" entier [non nul]
  "phone_number" "character varying(32)"
  "object_id" integer
  "is_deleted" booléen [non nul]
  "driver_license_issue_date" boolean
  "hardware_key" "character varying(64)"
  "middle_name" "character varying(100)"
  "adresse" "character varying(255)"
  "latitude" numérique
  "employee_id" integer [non nul]
  "personnel_number" "character varying(15)"
  "fuel_cost" doubleprecision
  "numéro_de_permis_de_conduire" "character varying(32)"
  "e-mail" "character varying(100)"
  "consommation_de_carburant" doubleprecision
  "radius" entier [non null]
  "longitude" numérique
}

Table "champs_texte_long_lieux" {
  "field_id" integer [not null]
  Texte « value » [non nul]
  Horodatage « record_added_at » [non nul]
  "place_id" entier [not null]
}

Table "groupes_objets" {
  "identifiant_client_groupes" integer
  "identifiant_client_objets" integer

  Indexes {
    (identifiant_client_groupes, identifiant_client_objets) [pk]
  }
}

Table "paramètres_appareil" {
  "device_id" integer [not null]
  "key" "character varying" [non nul]
  Texte « valeur »

  Indexes {
    (device_id, key) [pk]
  }
}

Table "event_description" {
  "event_id" entier [not null, pk]
  Texte de la "description"
}

Ref:"employees"."employee_id" < "checkins"."employee_id"

Ref:"objects"."object_id" < "checkins"."object_id"

Ref:"forms"."form_id" < "checkins"."form_id"

Réf. : « sensor_description ». « sensor_id » < « counters ». « sensor_id »

Ref:"devices"."device_id" < "counters"."device_id"

Réf. : «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"

Réf. : "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"

Réf. :"groups"."client_id" < "groups_objects"."groups_client_id"

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

Réf. : « modèles » . « modèle » < « objets » . « modèle »

Réf. :"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"

Réf. :"statuses"."status_id" < "status_history"."new_status_id"

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

Réf. : "devices"."device_id" < "status_history"."device_id"

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

Réf. : « 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"

Réf.:"users"."user_id" < "vehicles"."user_id"

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

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

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

```

{% endcode %}

## Fréquence de mise à jour

Les données de ce schéma sont synchronisées avec la base de données centrale. Les mises à jour sont effectuées de manière incrémentielle, au fur et à mesure des modifications dans la base de données MySQL source, généralement moins de 5 minutes après la modification de la source.

## `description_parameters`

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

<table><thead><tr><th width="167.1817626953125">Type de référence</th><th width="173.9090576171875">Description</th><th>Exemples de valeurs</th></tr></thead><tbody><tr><td>Définitions de types</td><td>Types d'entités standard</td><td><code>vehicle_type: car, truck, bus</code></td></tr><tr><td>Codes d'état</td><td>Valeurs de statut des missions et du système</td><td><code>tasks_status: unassigned, assigned, done</code></td></tr><tr><td>Définitions des unités</td><td>Unités de mesure des capteurs</td><td><code>units_type: liter, gallon, celsius</code></td></tr><tr><td>Classifications des entités</td><td>Catégories d’entités commerciales</td><td><code>entities_type: place, task, customer</code></td></tr></tbody></table>

## Tables clés par catégorie

Les tableaux de l’ **`raw_business_data`** Les schémas sont organisés en catégories fonctionnelles pour faciliter la navigation. Le tableau ci-dessous récapitule les principales tables selon leur finalité métier :

Entités métier principales

<details>

<summary><strong><code>users</code></strong></summary>

**Description**: Comptes utilisateur contenant des informations de profil, l’affiliation à une entreprise, les paramètres de localisation (fuseau horaire, paramètres régionaux) et des relations hiérarchiques via master\_id pour les structures de comptes à plusieurs niveaux

<table><thead><tr><th width="145">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>user_id</code> - Identifiant unique de l'utilisateur<br>- <code>company_label</code> - Nom de l'entreprise associée à l'utilisateur<br>- <code>first_name</code> - Nom d'utilisateur<br>- <code>last_name</code> - Nom de famille de l'utilisateur<br>- <code>middle_name</code> - Patronyme de l'utilisateur<br>- <code>locale</code> - Paramètres de langue de l'utilisateur<br>- <code>timezone_label</code> - Fuseau horaire au format IANA<br>- <code>master_id</code> - ID de l'utilisateur principal (si l'utilisateur actuel est un utilisateur subordonné)<br>- <code>registration_datetime</code> - Date d'inscription dans le système<br>- <code>birth_date</code> - Date de naissance de l'utilisateur</td></tr><tr><td><strong>Relations</strong></td><td>Utilisateur parent via <code>master_id</code>, associé à <code>employees</code>, <code>departments</code>, <code>Lieux</code>, <code>tasks</code> via <code>user_id</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Entité centrale reliant les données organisationnelles ; <code>master_id</code> permet de créer des hiérarchies d’utilisateurs pour les structures de compte à plusieurs niveaux</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>employees</code></strong></summary>

**Description**: Enregistrements des employés et des conducteurs représentant les personnes travaillant pour l’organisation, y compris les informations personnelles, les détails des permis, les affectations aux services, les clés matérielles pour l’identification iButton/RFID et les données de localisation avec prise en charge du géorepérage

<table><thead><tr><th width="143">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>employee_id</code> - Identifiant de l’entité employé<br>- <code>user_id</code> - Identifiant de l’entité utilisateur<br>- <code>object_id</code> - Identifiant de l’entité objet<br>- <code>department_id</code> - Un identifiant du service auquel l’employé est affecté<br>- <code>first_name</code> - L’attribut first_name de la table employees<br>- <code>last_name</code> - L’attribut last_name de la table des employés<br>- <code>middle_name</code> - L’attribut middle_name de la table employees<br>- <code>driver_license_number</code> - Numéro de permis de conduire<br>- <code>driver_license_categories</code> - Catégories de permis de conduire<br>- <code>driver_license_issue_date</code> - Date de délivrance d’un permis de conduire<br>- <code>driver_license_valid_till</code> - Date jusqu'à laquelle le permis de conduire d'un Conducteur est valide<br>- <code>hardware_key</code> - Une clé matérielle<br>- <code>email</code> - Adresse e-mail de l'employé<br>- <code>phone_number</code> - Numéro de téléphone de l'employé sans le signe "+"<br>- <code>address</code> - Adresse du lieu<br>- <code>personnel_number</code> - Numéro de matricule de l'employé/du conducteur<br>- <code>citizen_id_number</code> - Numéro de sécurité sociale<br>- <code>latitude</code> - Emplacement associé à cet employé<br>- <code>longitude</code> - Emplacement associé à cet employé<br>- <code>radius</code> - Emplacement associé à cet employé, en mètres<br>- <code>fuel_consumption</code> - L’attribut fuel_consumption de la table employees<br>- <code>fuel_cost</code> - L'attribut fuel_cost de la table des employés<br>- <code>is_deleted</code> - L’attribut is_deleted de la table employees</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>users</code>, <code>departments</code>, <code>objects</code> (tracker attribué), suivi dans <code>driver_history</code> et <code>checkins</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>La clé matérielle permet d’identifier le conducteur via iButton ou RFID ; elle prend en charge la géolocalisation avec <code>latitude</code>, <code>longitude</code>, <code>radius</code> champs</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Départements</code></strong></summary>

**Description**: Unités organisationnelles avec des données de localisation géographique (latitude, longitude, rayon) permettant des analyses basées sur des zones géographiques pour les rapports par service et l’association des employés à leur emplacement

<table><thead><tr><th width="156">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>department_id</code> - Identifiant de l'entité du département<br>- <code>user_id</code> - Identifiant de l’entité utilisateur<br>- <code>department_label</code> - L’attribut department_label de la table des départements<br>- <code>latitude</code> - Emplacement associé à ces départements<br>- <code>longitude</code> - Emplacement associé à ces départements<br>- <code>radius</code> - Taille de la géolocalisation en mètres<br>- <code>address</code> - L’attribut address de la table des départements</td></tr><tr><td><strong>Relations</strong></td><td>Relie les employés à la structure organisationnelle par le biais de <code>department_id</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Les champs de localisation permettent de réaliser des analyses basées sur les zones géographiques pour établir des rapports par service.</td></tr></tbody></table>

</details>

Suivi et surveillance

<details>

<summary><strong><code>devices</code></strong></summary>

**Description** : Registre des appareils de suivi physiques avec leurs identifiants matériels (IMEI), les informations relatives aux cartes SIM, l’état de la connectivité réseau (puissance du signal, itinérance, opérateur) et l’état des affectations pour la gestion du cycle de vie des appareils

<table><thead><tr><th width="138">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>device_id</code> - ID de l'appareil<br>- <code>owner_id</code> - ID du propriétaire de l’appareil dans le compte duquel la balise a été ajoutée<br>- <code>device_imei</code> - IMEI de l’appareil<br>- <code>phone</code> - Numéro de la carte SIM de l’appareil<br>- <code>status_listing_id</code> - ID du rapport du matériel<br>- <code>network_label</code> - Nom du réseau auquel la carte SIM est connectée<br>- <code>signal_level</code> - Puissance du signal de l’appareil<br>- <code>has_roaming</code> - Indicateur de disponibilité de l’itinérance<br>- <code>is_sim_blocked</code> - Indicateur de verrouillage de la carte SIM<br>- <code>created_at</code> - Date et heure de création de l’entrée</td></tr><tr><td><strong>Relations</strong></td><td>Entité principale liée à <code>objects</code>, <code>models</code>, <code>sensor_description</code>, <code>counters</code>; <code>owner_id</code> références <code>users.user_id</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Toutes les données télématiques dans <code>raw_telematics_data</code> le schéma fait référence à cette table via <code>device_id</code></td></tr></tbody></table>

</details>

<details>

<summary><strong><code>objects</code></strong></summary>

**Description**: Registre central des entités surveillées (véhicules, actifs, personnel) reliant les appareils physiques à la structure organisationnelle via client\_id et group\_id, représentant l’« unité suivie » avec un objet actif par appareil

<table><thead><tr><th width="148">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>object_id</code> - Objet identifiant de l’entité<br>- <code>client_id</code> - Identifiant de l’entité cliente<br>- <code>device_id</code> - Identifiant de l'entité appareil<br>- <code>object_label</code> - Nom de l'objet<br>- <code>model</code> - Modèle d’appareil<br>- <code>group_id</code> - Groupe d’ID d’entité<br>- <code>create_datetime</code> - Date et heure de création d’une nouvelle ligne sur le serveur<br>- <code>is_deleted</code> - L'attribut is_deleted de la table objects<br>- <code>is_clone</code> - Signe de clonage</td></tr><tr><td><strong>Relations</strong></td><td>Hub central qui relie les appareils aux utilisateurs (<code>client_id</code>), aux détails des véhicules, à l'historique de suivi, aux missions et aux règles</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Représente l'« unité suivie » dans le système ; un objet par appareil utilisé activement</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>models</code></strong></summary>

**Description**: Registre central des entités surveillées (véhicules, actifs, personnel) reliant les appareils physiques à la structure organisationnelle via client\_id et group\_id, représentant l’« unité suivie » avec un objet actif par appareil

<table><thead><tr><th width="135">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>model_id</code> - Identifiant du modèle de l'entité<br>- <code>model</code> - Attribut de modèle de la table models<br>- <code>vendor</code> - Le nom de l’entreprise qui a commercialisé le tracker<br>- <code>alternative_label</code> - L’attribut alternative_label de la table models<br>- <code>analog_amount</code> - Nombre d’entrées analogiques du tracker<br>- <code>digital_amount</code> - Nombre d’entrées discrètes du tracker<br>- <code>outputs_amount</code> - Nombre de sorties discrètes du tracker<br>- <code>has_battery_level</code> - Indique si le tracker transmet des relevés du niveau de charge de la batterie<br>- <code>has_altitude</code> - Indique si le tracker transmet l’altitude<br>- <code>has_phone</code> - Y a-t-il une carte SIM ?<br>- <code>has_gsm_level</code> - Le tracker peut-il transmettre la puissance du signal GSM ?<br>- <code>has_gsm_name</code> - Le tracker peut-il transmettre le nom du réseau GSM ou le code de l’opérateur (MCC + MNC) ?<br>- <code>has_gsm_roaming</code> - Le tracker peut-il transmettre le statut d’itinérance ?<br>- <code>has_detach_button</code> - Le tracker dispose-t-il d’un capteur de détachement ?<br>- <code>type_output_control</code> - Profil de contrôle des sorties du tracker<br>- <code>type_special_control</code> - Contient des paramètres spécialisés et des modules fonctionnels propres à certains modèles d’appareils, comme le mode de conduite dangereuse (hbm_telfm) pour les appareils Teltonika<br>- <code>is_clone</code> - Le modèle est-il un clone d’un autre modèle ?</td></tr><tr><td><strong>Contenu</strong></td><td>Les indicateurs de capacité booléens indiquent les champs de données disponibles pour ce type d’appareil</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Utilisez les indicateurs de capacité pour déterminer les capteurs et les entrées valides lors de l’interrogation des données télématiques</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>sensor_description</code></strong></summary>

**Description**: Configuration complète des capteurs reliant les entrées de l’appareil à la logique métier, comprenant les mappages d’entrées, les unités de mesure, les facteurs de conversion (multiplicateur/diviseur), les tables d’étalonnage des capteurs de carburant, les seuils de précision et la logique de regroupement des relevés de capteurs agrégés

<table><thead><tr><th width="142">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>sensor_id</code> - Identifiant de l’entité du capteur<br>- <code>device_id</code> - Identifiant de l’entité de l’appareil<br>- <code>sensor_label</code> - Nom du capteur dans l’interface utilisateur<br>- <code>input_label</code> - Nom du champ du message (attribut) dont sont extraites les données du capteur. Si sa valeur est égale à "input_status", il s’agit d’un Capteur discret<br>- <code>sensor_type</code> - Type de capteur<br>- <code>units_type</code> - Unités de mesure<br>- <code>multiplier</code> - Multiplicateur : nombre par lequel multiplier la valeur du champ. Uniquement pour les Capteurs de mesure<br>- <code>divider</code> - Diviseur - le nombre par lequel diviser la valeur du champ. Pour les capteurs de mesure uniquement<br>- <code>accuracy</code> - Un pourcentage défini pour calculer l’erreur absolue du volume du réservoir. Cette erreur sert à déterminer quand des ravitaillements ou des vidanges ont lieu. Ce paramètre est utilisé uniquement pour les capteurs de Carburant<br>- <code>calibration_data</code> - L’attribut calibration_data de la table sensor_description<br>- <code>input_id</code> - Numéro d’entrée du capteur discret<br>- <code>group_id</code> - Les capteurs du même type ayant le même group_id et le même source_id sont considérés comme appartenant au même groupe. Leurs données sont additionnées ou moyennées, selon la valeur de group_type. Cela est requis pour les capteurs agrégés. Elle est utilisée dans les capteurs de mesure<br>- <code>group_type</code> - 0 - somme des valeurs des capteurs au sein d'un groupe, 1 - moyenne<br>- <code>sensor_units</code> - Nom d’unité saisi par l’utilisateur si units_type=0 (personnalisé)<br>- <code>parameters</code> - Objet facultatif avec des paramètres supplémentaires : parent_ids - tableau facultatif de parent_ids pour un capteur composite. volume - double. Facultatif. Volume du capteur composite. parent_ids - facultatif. tableau int. Tableau de parent_ids pour un capteur composite. volume - facultatif. Double. Volume du capteur composite. min - facultatif. Double. Valeur brute minimale acceptable pour un capteur. max - facultatif. Double. Valeur brute maximale acceptable pour un capteur. max_lowering_by_time - facultatif. Double. Diminution maximale autorisée de la valeur par heure. max_lowering_by_mileage - facultatif. Double. Diminution maximale autorisée de la valeur par 100 km. ignore_drains_in_move - facultatif. Boolean. La valeur par défaut est false. Si la valeur est true, les vidanges de carburant ne seront pas détectées pendant le mouvement. ignore_refuels_in_move - facultatif. Boolean. La valeur par défaut est false. Si la valeur est true, les ravitaillements ne seront pas détectés pendant le mouvement. refuel_gap_minutes - facultatif. Integer. La valeur par défaut est 5. Les ravitaillements seront détectés pendant le mouvement au nombre de minutes indiqué après le début du mouvement. custom_field_name - facultatif. Boolean. La valeur par défaut est false. Ce paramètre détermine si le champ input_name contient une valeur personnalisée saisie par l'utilisateur. Cela n'a de sens que si le modèle du tracker dispose de la fonctionnalité has_custom_fields</td></tr><tr><td><strong>Relations</strong></td><td>Relie les entrées de l’appareil (à partir de <code>raw_telematics_data.inputs</code>) à la logique métier via <code>device_id</code> et <code>input_label</code> correspondance</td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>calibration_data</code> (JSONB) stocke les tables d’étalonnage spécifiques aux capteurs de niveau de carburant ; <code>multiplier</code> et <code>divider</code> convertir les valeurs brutes en unités</td></tr></tbody></table>

</details>

Gestion des actifs

<details>

<summary><strong><code>Véhicules</code></strong></summary>

**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 tracker via object\_id pour la gestion de flotte et le suivi de la conformité

<table><thead><tr><th width="144">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>vehicle_id</code> - Identifiant de l’entité véhicule<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>object_id</code> - Identifiant de l’entité objet<br>- <code>garage_id</code> - Identifiant de l’entité garage<br>- <code>vehicle_label</code> - L'attribut vehicle_label de la table Véhicules<br>- <code>registration_number</code> - Numéro d’immatriculation/Plaque d'immatriculation d’un véhicule<br>- <code>vin</code> - L’attribut VIN de la table des véhicules<br>- <code>manufacture_year</code> - L’attribut manufacture_year de la table des véhicules<br>- <code>fuel_type</code> - L’attribut fuel_type de la table des véhicules<br>- <code>fuel_cost</code> - L'attribut fuel_cost de la table des véhicules<br>- <code>fuel_tank_volume</code> - L’attribut fuel_tank_volume de la table des véhicules<br>- <code>max_speed</code> - L’attribut max_speed de la table des véhicules<br>- <code>model</code> - L’attribut model de la table des véhicules<br>- <code>color</code> - L’attribut de couleur du tableau des véhicules<br>- <code>trailer</code> - L’attribut remorque de la table des véhicules<br>- <code>additional_info</code> - L’attribut additional_info de la table des véhicules<br>- <code>vehicle_type</code> - L’attribut vehicle_type de la table des véhicules<br>- <code>vehicle_subtype</code> - L’attribut vehicle_subtype de la table des véhicules<br>- <code>vehicle_status_id</code> - Identifiant de l’entité statut du véhicule<br>- <code>chassis_number</code> - L’attribut chassis_number de la table des véhicules<br>- <code>frame_number</code> - L’attribut frame_number de la table des véhicules<br>- <code>trailer_reg_number</code> - L’attribut trailer_reg_number de la table des véhicules<br>- <code>payload_weight</code> - L’attribut payload_weight de la table des véhicules<br>- <code>payload_height</code> - L’attribut payload_height de la table des véhicules<br>- <code>payload_length</code> - L’attribut payload_length de la table Véhicules<br>- <code>payload_width</code> - L’attribut payload_width de la table Véhicules<br>- <code>passenger_capacity</code> - Un nombre maximal de passagers<br>- <code>gross_weight</code> - L’attribut gross_weight de la table des Véhicules<br>- <code>standard_fuel_consumption</code> - Consommation moyenne normale de carburant en litres aux 100 km<br>- <code>fuel_grade</code> - L'attribut fuel_grade de la table des véhicules<br>- <code>wheel_arrangement</code> - L’attribut wheel_arrangement de la table des véhicules<br>- <code>tyre_size</code> - Dimensions du véhicule : dimensions et taille des roues<br>- <code>tyres_number</code> - Nombre de roues<br>- <code>liability_insurance_policy_number</code> - L’attribut liability_insurance_policy_number de la table des véhicules<br>- <code>liability_insurance_valid_till</code> - La date jusqu’à laquelle l’assurance responsabilité civile est valable<br>- <code>free_insurance_policy_number</code> - L’attribut free_insurance_policy_number de la table des véhicules<br>- <code>free_insurance_valid_till_date</code> - La date jusqu’à laquelle l’assurance gratuite est valide</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>objects</code> (tracker actuel), <code>garages</code> (lieu de service), <code>vehicle_service_tasks</code> ; suivi dans <code>vehicle_trackers_history</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Champs de dimensions physiques (<code>payload_length</code>, <code>payload_width</code>, <code>payload_height</code>, <code>gross_weight</code>) permettent d’analyser la planification de la charge ; les dates d’Assurance permettent d’assurer le suivi de la conformité</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>garages</code></strong></summary>

**Description**: Emplacements des installations de réparation et d'Entretien avec leurs coordonnées géographiques (latitude, longitude, rayon) et les coordonnées des mécaniciens et des répartiteurs, permettant la détection des visites d'entretien fondée sur la Zone géographique et l'analyse de proximité

<table><thead><tr><th width="135">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>garage_id</code> - Identifiant de l'entité garage<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>latitude</code> - Traceur de localisation<br>- <code>longitude</code> - Traceur de localisation<br>- <code>radius</code> - Taille de la géolocalisation en mètres<br>- <code>address</code> - Traceur de localisation<br>- <code>organization_label</code> - ID du Garage<br>- <code>mechanic_name</code> - Nom du mécanicien<br>- <code>dispatcher_name</code> - Nom du répartiteur</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>vehicles.garage_id</code> pour l’attribution du lieu de service</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Les champs de localisation permettent de détecter les visites de service en fonction des zones géographiques et d’analyser la proximité.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>vehicle_service_tasks</code></strong></summary>

**Description** : Suivi du calendrier d’entretien et de l’historique des interventions avec plusieurs types de déclencheurs (basés sur la date, le kilométrage ou les heures moteur), des intervalles de mission récurrents, des notifications multicanales (e-mail, SMS, notifications push) et distinction entre les interventions planifiées (is\_repeat) et non planifiées.

<table><thead><tr><th width="132">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>service_task_id</code> - Identifiant de l’entité de mission de service<br>- <code>vehicle_id</code> - Identifiant de l’entité véhicule<br>- <code>description</code> - L’attribut description de la table vehicle_service_tasks<br>- <code>status</code> - La valeur d’état de l’attribut d’état<br>- <code>cost</code> - L’attribut cost de la table vehicle_service_tasks<br>- <code>start_date</code> - La date et l’heure associées à l’attribut start_date<br>- <code>end_date</code> - La date et l’heure associées à l’attribut end_date<br>- <code>completion_date</code> - La date et l’heure associées à l’attribut completion_date<br>- <code>predicted_datetime</code> - La date et l’heure associées à l’attribut predicted_datetime<br>- <code>mileage_limit</code> - L’attribut mileage_limit de la table vehicle_service_tasks<br>- <code>engine_hours_limit</code> - L’attribut engine_hours_limit de la table vehicle_service_tasks<br>- <code>start_mileage</code> - L’attribut start_mileage de la table vehicle_service_tasks<br>- <code>start_engine_hours</code> - L’attribut start_engine_hours de la table vehicle_service_tasks<br>- <code>mileage_notification_interval</code> - L’attribut mileage_notification_interval de la table vehicle_service_tasks<br>- <code>engine_hours_notification_interval</code> - L’attribut engine_hours_notification_interval de la table vehicle_service_tasks<br>- <code>date_notification_interval</code> - Conversion d’un entier N en N jours<br>- <code>mileage_repeat_interval</code> - L’attribut mileage_repeat_interval de la table vehicle_service_tasks<br>- <code>engine_hours_repeat_interval</code> - L’attribut engine_hours_repeat_interval de la table vehicle_service_tasks<br>- <code>date_repeat_interval</code> - Conversion d’un entier N en N jours<br>- <code>notification_emails</code> - L'attribut notification_emails de la table vehicle_service_tasks<br>- <code>notification_sms_phone_numbers</code> - L’attribut notification_sms_phone_numbers de la table vehicle_service_tasks<br>- <code>is_notification_push_enabled</code> - L'attribut is_notification_push_enabled de la table vehicle_service_tasks<br>- <code>completion_mileage</code> - L’attribut completion_mileage de la table vehicle_service_tasks<br>- <code>completion_engine_hours</code> - L’attribut completion_engine_hours de la table vehicle_service_tasks<br>- <code>is_repeat</code> - L’attribut is_repeat de la table vehicle_service_tasks<br>- <code>is_unplanned</code> - L’attribut is_unplanned de la table vehicle_service_tasks<br>- <code>comment</code> - L’attribut comment de la table vehicle_service_tasks</td></tr><tr><td><strong>Contenu</strong></td><td>Prend en charge trois types de déclencheurs : selon la date, le kilométrage ou les heures moteur ; paramètres de notification par e-mail, SMS et notification push</td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>is_repeat</code> et les champs d’intervalle permettent de définir des calendriers d’entretien récurrents ; <code>is_unplanned</code> distingue l’entretien planifié de l’entretien réactif</td></tr></tbody></table>

</details>

Emplacement et itinéraires

<details>

<summary><strong><code>zones</code></strong></summary>

**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, et permettre l’automatisation basée sur des règles ainsi que l’analyse de localisation, avec un code couleur pour les différencier visuellement

<table><thead><tr><th width="150">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>zone_id</code> - Identifiant de l’entité zone<br>- <code>client_id</code> - Identifiant de l’entité client<br>- <code>zone_label</code> - L’attribut zone_label de la table zones<br>- <code>zone_type</code> - L’attribut zone_type de la table zones<br>- <code>latitude</code> - Objet facultatif : la boîte englobante pouvant contenir entièrement le résultat renvoyé<br>- <code>longitude</code> - Objet facultatif : la boîte englobante pouvant contenir entièrement le résultat renvoyé<br>- <code>circle_center_latitude</code> - L’attribut circle_center_latitude de la table zones<br>- <code>circle_center_longitude</code> - L’attribut circle_center_longitude de la table zones<br>- <code>radius</code> - Taille de la zone géographique en mètres<br>- <code>address</code> - L’attribut address de la table zones<br>- <code>color</code> - L’attribut color de la table zones</td></tr><tr><td><strong>Contenu</strong></td><td>Les types de zones comprennent les cercles et les polygones (définis via <code>geofence_points</code>), et les classifications spéciales des zones</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>rules2zones</code>, <code>users2zones</code>; sommets du polygone stockés dans <code>geofence_points</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Les fonctions PostGIS peuvent être utilisées pour vérifier si un point se trouve dans un polygone lors d’une analyse complexe de zone géographique.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Lieux</code></strong></summary>

**Description** : Points d’intérêt avec coordonnées géographiques, définitions de rayon et prise en charge de champs personnalisés extensibles pour stocker les coordonnées des clients et les données propres à l’entreprise, permettant l’intégration CRM/ERP via external\_id et la génération de rapports basés sur la localisation

<table><thead><tr><th width="129">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>place_id</code> - Indiquez l’identifiant de l’entité<br>- <code>user_id</code> - Identifiant de l’entité utilisateur<br>- <code>place_label</code> - L’attribut place_label de la table des lieux<br>- <code>latitude</code> - Objet de localisation<br>- <code>longitude</code> - Objet de localisation<br>- <code>radius</code> - Taille de la géolocalisation en mètres<br>- <code>address</code> - Attribut d’adresse de la table des lieux<br>- <code>description</code> - Attribut de description de la table des lieux<br>- <code>external_id</code> - ID pour l’intégration avec des systèmes externes (CRM)<br>- <code>custom_fields</code> - Champs supplémentaires<br>- <code>assigned_datetime</code> - Date et heure d’attribution du point d’intérêt à l’utilisateur</td></tr><tr><td><strong>Relations</strong></td><td>Étendu avec les valeurs des champs personnalisés jusqu’à <code>places_text_fields</code>, <code>places_decimal_fields</code>, <code>places_bigint_fields</code>, <code>places_longtext_fields</code>, <code>places_linked_entity_fields</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>custom_fields</code> JSONB offre un accès rapide ; les tables associées permettent de filtrer et de trier les attributs personnalisés.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>geofence_points</code></strong></summary>

**Description** : Coordonnées ordonnées des sommets (le champ numérique détermine la séquence) définissant les limites des polygones pour les zones géographiques complexes, permettant de délimiter avec précision des périmètres géographiques au-delà des simples zones circulaires, utilisées avec PostGIS ST\_MakePolygon pour les opérations géométriques

<table><thead><tr><th width="133">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>zone_id</code> - Un identifiant de la zone à laquelle ce formulaire est associé<br>- <code>number</code> - Numéro de série<br>- <code>latitude</code> - Emplacement<br>- <code>longitude</code> - Emplacement</td></tr><tr><td><strong>Relations</strong></td><td>Plusieurs enregistrements par <code>zone_id</code> définissent les limites du polygone ; <code>number</code> le champ détermine l’ordre des sommets</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Interrogez avec <code>ORDER BY number</code> pour reconstituer le tracé du polygone ; à utiliser avec PostGIS ST_MakePolygon pour les opérations géométriques</td></tr></tbody></table>

</details>

Gestion des missions et des flux de travail

<details>

<summary><strong><code>tasks</code></strong></summary>

**Description**: Affectations de missions avec validation de la position (latitude, longitude, rayon), plages horaires (time\_from, time\_to), exigences relatives à la durée des visites (stay\_duration\_minutes, arrival\_duration\_minutes), structure hiérarchique via parent\_task\_id et suivi des statuts pour la gestion des missions et tâches et les opérations de livraison

<table><thead><tr><th width="130">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>task_id</code> - Identifiant de l’entité Mission<br>- <code>user_id</code> - Identifiant de l’entité utilisateur<br>- <code>object_id</code> - Identifiant de l’entité objet<br>- <code>parent_task_id</code> - Identifiant de l’entité de la mission parente<br>- <code>task_label</code> - L’attribut task_label de la table tasks<br>- <code>status</code> - La valeur d’état de l’attribut d’état<br>- <code>task_type</code> - Type de mission, mission, itinéraire ou point de contrôle<br>- <code>latitude</code> - L’attribut de latitude de la table des missions<br>- <code>longitude</code> - L’attribut de longitude de la table des missions<br>- <code>radius</code> - Taille de la géolocalisation en mètres<br>- <code>arrival_datetime</code> - Date à laquelle le tracker arrive dans la zone de la mission. IGNORÉ lors de la création ou de la mise à jour<br>- <code>created_at</code> - L’attribut created_at de la table des missions<br>- <code>status_change_datetime</code> - Date et heure de mise à jour de la mission<br>- <code>time_from</code> - La date et l'heure associées à l'attribut time_from<br>- <code>time_to</code> - La date et l'heure associées à l'attribut time_to<br>- <code>stay_duration</code> - L'attribut stay_duration de la table des missions<br>- <code>stay_duration_minutes</code> - Durée de la visite. Temps qu'un intervenant mobile doit passer sur le site de l'affectation pour mener à bien la mission. Plusieurs visites sont cumulées<br>- <code>arrival_duration_minutes</code> - 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<br>- <code>max_delay_minuts</code> - Retard acceptable. Durée maximale pendant laquelle un employé peut être en retard. Toute mission terminée pendant cette période sera marquée comme "late"<br>- <code>is_stay_control_enabled</code> - L'attribut is_stay_control_enabled de la table des missions<br>- <code>address</code> - L'attribut address de la table des missions<br>- <code>description</code> - L'attribut description de la table des missions<br>- <code>custom_fields</code> - L'attribut custom_fields de la table des missions<br>- <code>external_id</code> - Identifiant d’entité externe<br>- <code>order_sort</code> - L’attribut order_sort de la table Missions<br>- <code>created_by</code> - Source de la mission créée</td></tr><tr><td><strong>Contenu</strong></td><td>Prend en charge les missions hiérarchiques via <code>parent_task_id</code> ; plages horaires définies par <code>time_from</code>/<code>time_to</code>; validation de zone géographique avec emplacement et rayon</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>forms</code> (collecte de données), <code>task_history</code> (changements d’état), <code>objects</code> (tracker attribué)</td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>stay_duration</code> et <code>arrival_duration_minutes</code> activer le suivi de conformité pour les missions de livraison et de service</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>forms</code></strong></summary>

**Description** : Formulaires de collecte de données configurables permettant de recueillir des informations structurées lors de l’exécution d’une mission ou des check-in dans l’application mobile, avec des champs et des valeurs stockés au format JSON, une validation facultative de la localisation (is\_submission\_in\_zone) et des exigences de soumission obligatoire lorsqu’ils sont associés à des missions

<table><thead><tr><th width="141">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>form_id</code> - Identifiant de l'entité Formulaire<br>- <code>task_id</code> - Un identifiant de la mission à laquelle ce formulaire est associé<br>- <code>object_id</code> - Identifiant de l’entité objet<br>- <code>form_label</code> - Libellé de formulaire défini par l’utilisateur<br>- <code>fields</code> - Si cette option est activée, le formulaire ne peut être soumis que dans la zone de la mission<br>- <code>values</code> - Une carte dont les clés sont les ID des champs et les valeurs, des objets field_value. Clé utilisée pour associer un champ à la valeur correspondante<br>- <code>submitted_at</code> - Date de la dernière soumission des valeurs du formulaire<br>- <code>submission_latitude</code> - Emplacement où les valeurs du formulaire ont été soumises pour la dernière fois<br>- <code>submission_longitude</code> - Emplacement où les valeurs du formulaire ont été soumises pour la dernière fois<br>- <code>submission_address</code> - Emplacement où les valeurs du formulaire ont été soumises pour la dernière fois<br>- <code>is_submission_in_zone</code> - Si cette option est activée, le formulaire ne peut être soumis que dans la zone de la mission<br>- <code>description</code> - Date de création de ce formulaire (ou de son association à la mission)<br>- <code>created_at</code> - Date de création de ce formulaire (ou de son association à la mission)</td></tr><tr><td><strong>Contenu</strong></td><td><code>fields</code> définit la structure du formulaire (JSON); <code>values</code> contient les données soumises (JSON)</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>Missions</code> (ordre de travail associé), <code>objects</code> (auteur de la demande), mentionné dans <code>checkins</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Indicateur de validation de la localisation <code>is_submission_in_zone</code> permet de définir des règles d’envoi de formulaires basées sur les zones géographiques</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>checkins</code></strong></summary>

**Description** : Relevés de présence et d’activité géolocalisés transmis via une application mobile, comparant les heures d’arrivée prévues et réelles (planned\_datetime vs actual\_datetime), avec les coordonnées géographiques et les mesures de précision de la localisation (radius), pour établir des rapports de ponctualité

<table><thead><tr><th width="129">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>checkin_id</code> - Identifiant de l’entité de pointage<br>- <code>employee_id</code> - L’identifiant de l’entité employé est également l’identifiant des conducteurs<br>- <code>object_id</code> - Appareil de l’employé<br>- <code>form_id</code> - Identifiant de l’entité du formulaire<br>- <code>user_id</code> - Utilisateur employé<br>- <code>planned_datetime</code> - Heure de l’appareil à laquelle l’enregistrement a été effectué<br>- <code>actual_datetime</code> - Heure du serveur à laquelle la requête/le message a été traité<br>- <code>latitude</code> - Emplacement auquel les enregistrements de présence sont soumis<br>- <code>longitude</code> - Emplacement auquel les enregistrements de présence sont soumis<br>- <code>radius</code> - Erreur de positionnement en un point, en mètres<br>- <code>address</code> - Adresse d'enregistrement<br>- <code>comment</code> - L'attribut de commentaire de la table checkins</td></tr><tr><td><strong>Relations</strong></td><td>Associe les employés aux formulaires et aux emplacements ; suit les écarts par rapport au planning prévu</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Écart de temps entre <code>planned_datetime</code> et <code>actual_datetime</code> permet d’établir des rapports de ponctualité ; le rayon définit la tolérance de localisation acceptable</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>task_history</code></strong></summary>

**Description** : Piste d’audit complète des événements du cycle de vie des missions, qui consigne tous les changements de statut, les affectations, les mises à jour et les modifications de champs, avec les horodatages (event\_datetime), l’identification de l’utilisateur et les types d’activité (create, update, assign, status\_change) stockés dans le champ payload à des fins de conformité et d’analyse des flux de travail

<table><thead><tr><th width="137">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>task_history_id</code> - Identifiant de l’entité d’historique des missions<br>- <code>task_id</code> - Identifiant de l’entité Mission<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>activity</code> - Opération effectuée. Peut être "create", "update", "assign" ou "status_change"<br>- <code>event_datetime</code> - Date et heure de l'événement<br>- <code>payload</code> - Dépend de l'opération. Contient généralement les champs qui ont été modifiés lors de l'opération</td></tr><tr><td><strong>Contenu</strong></td><td>Types d'activité définis dans <code>description_parameters</code>; <code>payload</code> stocke les détails spécifiques à l’événement (texte)</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Essentiel pour l’analyse de l’accomplissement des missions, le suivi des changements de statut et le suivi de l’activité des utilisateurs.</td></tr></tbody></table>

</details>

Règles et automatisation

<details>

<summary><strong><code>rules</code></strong></summary>

**Description** : Règles de détection d’événements avec des conditions de déclenchement configurables (excès de vitesse, violations de zones géographiques, seuils des capteurs, durée d’inactivité) stockées dans les paramètres (JSONB), et paramètres de notification multicanal (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) pour la surveillance et les alertes automatisées basées sur les données des appareils et du serveur

<table><thead><tr><th width="131">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>rule_id</code> - Identifiant de l’entité de règle<br>- <code>object_id</code> - Objet identifiant de l’entité<br>- <code>client_id</code> - Identifiant de l’entité cliente<br>- <code>event_type</code> - L’attribut event_type de la table rules<br>- <code>event_label</code> - L’attribut event_label de la table rules<br>- <code>event_group</code> - L'attribut event_group de la table des règles<br>- <code>description</code> - Attribut de description de la table des règles<br>- <code>parameters</code> - Paramètres de l’événement. Pour plus de détails sur les paramètres disponibles, consultez <a href="https://www.navixy.com/docs/navixy-api/user-api/resources/tracking/tracker/rules/rule_types/">la documentation de l’API Navixy</a>.<br>- <code>alert_email</code> - Adresses e-mail pour les notifications<br>- <code>alert_sms</code> - Numéros de téléphone pour les notifications par SMS<br>- <code>alert_phone</code> - Numéros de téléphone pour les appels vocaux<br>- <code>is_push_enabled</code> - Si cette valeur est vraie, les notifications push sont disponibles<br>- <code>created_at</code> - L’attribut created_at de la table rules<br>- <code>is_deleted</code> - L’attribut is_deleted de la table rules<br>- <code>maximum</code> - Limites appliquées à diverses règles. Par exemple, pour la règle de durée au ralenti avec le moteur en marche, en minutes<br>- <code>event_comment1</code> - L’attribut event_comment1 de la table rules<br>- <code>event_comment2</code> - L’attribut event_comment2 de la table des règles</td></tr><tr><td><strong>Contenu</strong></td><td>Les paramètres des règles (JSONB) définissent les conditions de déclenchement ; prennent en charge les notifications par e-mail, SMS, téléphone et push</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers les objets via <code>rules2objects</code>, vers les zones via <code>rules2zones</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>event_type</code> définit un scénario de suivi spécifique (excès de vitesse, intrusion dans une zone géographique, seuil de capteur) ; <code>maximum</code> Le champ active l’agrégation des événements pour les alertes basées sur un seuil.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2objects</code></strong></summary>

**Description**: Relation plusieurs-à-plusieurs reliant les règles aux objets surveillés, avec personnalisation des paramètres par objet via object\_params (JSONB), permettant de définir différentes valeurs de seuil (par exemple, les limitations de vitesse) pour chaque véhicule ou actif au sein d’une même règle

<table><thead><tr><th width="140">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>rule_id</code> - Identifiant de l’entité de règle<br>- <code>object_id</code> - Objet identifiant de l’entité<br>- <code>param_group_number</code> - L’attribut param_group_number de la table rules2objects<br>- <code>object_params</code> - L’attribut object_params de la table rules2objects</td></tr><tr><td><strong>Contenu</strong></td><td><code>object_params</code> (JSONB) permet de personnaliser les règles par objet (par exemple, des limites de vitesse différentes selon le véhicule)</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Une relation plusieurs-à-plusieurs permet à une règle de surveiller plusieurs objets avec des paramètres différents.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2zones</code></strong></summary>

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

<table><thead><tr><th width="144">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>rule_id</code> - Identifiant de l'entité règle<br>- <code>zone_id</code> - Identifiant de l'entité zone</td></tr><tr><td><strong>Remarques particulières</strong></td><td>La relation plusieurs-à-plusieurs permet de surveiller plusieurs zones pour une seule règle (par exemple, déclencher une alerte lorsqu'un tracker entre dans l'une des zones à accès restreint)</td></tr></tbody></table>

</details>

Statut et catégorisation

<details>

<summary><strong><code>statuses</code></strong></summary>

**Description**: Définitions de statuts personnalisés dans les listes de statuts, comprenant 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 suppression logique prise en charge via l'indicateur is\_deleted

<table><thead><tr><th width="128">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>status_id</code> - Identifiant de l'entité statut<br>- <code>listing_id</code> - Identifiant de l’entité de la liste<br>- <code>status_label</code> - Valeur de statut de l’attribut status_label<br>- <code>color</code> - Couleur utilisée pour l’affichage sur le site web<br>- <code>order_sort</code> - Position de tri dans la liste des statuts<br>- <code>is_deleted</code> - Attribut is_deleted de la table statuses</td></tr><tr><td><strong>Relations</strong></td><td>Groupes de statuts organisés par <code>listing_id</code> (fait référence à <code>status_listings</code>); utilisé dans <code>status_history</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>order_sort</code> définit l'ordre d'affichage ; la couleur permet une différenciation visuelle dans les rapports</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_listings</code></strong></summary>

**Description**: Définitions des ensembles de statuts qui déterminent les valeurs de statut disponibles pour les appareils ou les employés, avec des indicateurs d'autorisation (is\_supervisor\_controlled, is\_employee\_controlled) déterminant si les superviseurs, les employés ou les deux peuvent modifier les valeurs de statut

<table><thead><tr><th width="144">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>status_listing_id</code> - Identifiant de l’entité de liste de statuts<br>- <code>user_id</code> - Identifiant de l’entité utilisateur<br>- <code>status_listing_label</code> - Valeur de statut de l’attribut status_listing_label<br>- <code>is_supervisor_controlled</code> - Si cette valeur est vraie, les superviseurs peuvent modifier le statut de travail, par exemple à l’aide de l’application mobile de suivi<br>- <code>is_employee_controlled</code> - Si cette valeur est vraie, les employés peuvent modifier leur propre statut de travail, par exemple à l’aide de l’application mobile de suivi<br>- <code>is_deleted</code> - L’attribut is_deleted de la table status_listings</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>devices.status_listing_id</code> et <code>statuses.listing_id</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Les indicateurs de contrôle déterminent qui peut modifier les statuts : les superviseurs uniquement, les employés en libre-service ou les deux</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_history</code></strong></summary>

**Description**: Historique d’audit de toutes les transitions de statut des appareils, avec les horodatages (changed\_datetime sur l’appareil, server\_datetime sur le serveur), l’attribution à l’utilisateur (updated\_by) et la capture de la localisation (latitude, longitude, adresse), permettant l’analyse géographique des changements de statut et la création de rapports sur les lieux de début et de fin de journée de travail

<table><thead><tr><th width="143">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>status_history_id</code> - Identifiant de l’entité de l’historique des statuts<br>- <code>device_id</code> - Identifiant de l’entité appareil<br>- <code>old_status_id</code> - Identifiant de l’ancien statut de l’entité<br>- <code>new_status_id</code> - Identifiant du nouveau statut de l’entité<br>- <code>updated_by</code> - La date et l’heure associées à l’attribut updated_by<br>- <code>changed_datetime</code> - Date et heure d’attribution d’un nouveau statut sur l’appareil<br>- <code>server_datetime</code> - Date et heure d’attribution du nouveau statut sur le serveur<br>- <code>latitude</code> - Localisation des appareils lors des changements de statut<br>- <code>longitude</code> - Localisation des appareils lors des changements de statut<br>- <code>address</code> - Localisation des appareils lors des changements de statut</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>devices</code>, <code>statuses</code> (ancien et nouveau), <code>description_parameters</code> (pour <code>updated_by</code> modèle d'accès)</td></tr><tr><td><strong>Remarques particulières</strong></td><td>La capture de localisation permet d’analyser géographiquement les changements d’état ; elle est utile pour créer des rapports sur le lieu de début et de fin de la journée de travail.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>tags</code></strong></summary>

**Description** : Libellés de catégorisation personnalisés avec code couleur, qui permettent de filtrer et de rechercher rapidement parmi plusieurs types d'entités (lieux, zones géographiques, employés, missions, trackers, véhicules) pour une organisation flexible

<table><thead><tr><th width="149">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>tag_id</code> - Balise d’identifiant d’entité<br>- <code>user_id</code> - Identifiant de l’entité utilisateur<br>- <code>tag_label</code> - L’attribut tag_label de la table des Mots clés<br>- <code>color</code> - L’attribut de couleur de la table des mots clés</td></tr><tr><td><strong>Relations</strong></td><td>Appliqué aux entités via <code>tag_links</code>; portée définie par l'utilisateur</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Système de catégorisation flexible prenant en charge plusieurs mots clés par entité</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>tag_links</code></strong></summary>

**Description** : Table de relation polymorphe associant des mots clés à tout type d’entité via entity\_type et entity\_id, avec un champ ordinal pour gérer l’ordre d’affichage, permettant l’attribution flexible de mots clés à plusieurs entités

<table><thead><tr><th width="127">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>tag_id</code> - Mots clés d’identifiant d’entité<br>- <code>entity_type</code> - L’attribut entity_type de la table tag_links<br>- <code>entity_id</code> - Identifiant de l’entité<br>- <code>ordinal</code> - L’attribut ordinal de la table tag_links</td></tr><tr><td><strong>Contenu</strong></td><td><code>entity_type</code> identifie la table (véhicule, employé, mission, etc.) ; <code>ordinal</code> définit l’ordre d’affichage</td></tr><tr><td><strong>Remarques particulières</strong></td><td>La relation polymorphe permet d’ajouter des étiquettes à différents types d’entités.</td></tr></tbody></table>

</details>

Groupes et hiérarchie

<details>

<summary><strong><code>groups</code></strong></summary>

**Description**: Structure de regroupement organisationnel des trackers permettant une organisation visuelle dans l’interface utilisateur avec des couleurs personnalisables (group\_color) et une gestion hiérarchique semblable à celle de dossiers, remplissant actuellement une fonction purement visuelle

<table><thead><tr><th width="148">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>group_id</code> - Groupe de trackers (lié par objects.group_id). La division en groupes est visible dans la liste des balises, par exemple<br>- <code>client_id</code> - Identifiant de l'entité client<br>- <code>group_label</code> - Titre du groupe défini par l’utilisateur, de 1 à 60 caractères imprimables, par exemple "Employees"<br>- <code>group_color</code> - Couleur du groupe au format Web (sans #), par exemple "FF6DDC". Détermine la couleur des marqueurs du tracker sur la carte.</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>objects.group_id</code> ; propriété du client via <code>client_id</code> (références <code>users</code>)</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Permet d’organiser les entités de surveillance comme dans des dossiers, pour les rapports et les autorisations.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>groups_objects</code></strong></summary>

**Description** : Relation plusieurs-à-plusieurs entre les groupes et les objets à l'aide d'une clé primaire composite (groups\_client\_id, objects\_client\_id), permettant aux objets d'appartenir simultanément à plusieurs groupes pour une organisation flexible

<table><thead><tr><th width="135">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>groups_client_id</code> - Identifiant de l'entité client pour les groupes<br>- <code>objects_client_id</code> - Identifiant de l'entité client pour les objets</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Permet aux objets d'appartenir simultanément à plusieurs groupes ; effectuez la requête avec les deux <code>client_id</code> valeurs d'appartenance aux groupes</td></tr></tbody></table>

</details>

Champs personnalisés et entités

<details>

<summary><strong><code>entities</code></strong></summary>

**Description**: Registre des types d'entités définissant les entités métier qui prennent en charge les Champs personnalisés et la structure de disposition de leurs champs (sections, field\_order), stockée dans entity\_label (JSONB). Il permet d'étendre dynamiquement le schéma des Lieux, des Missions et d'autres entités sans modifier la base de données

<table><thead><tr><th width="141">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>entity_id</code> - Identifiant de l'entité<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>entity_label</code> - id - int. Identifiant de l'entité. type - enum. Actuellement, seul "place" est pris en charge. layout - objet décrivant la disposition des champs de l'entité. sections - tableau d'objets. Chaque section peut contenir un ou plusieurs champs. Une disposition doit comporter au moins une section. label - chaîne. Nom de la section. field_order - tableau de chaînes. Champs intégrés et identifiants des Champs personnalisés (sous forme de chaînes)<br>- <code>builtin_type</code> - L'attribut builtin_type de la table entities</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>custom_fields</code> pour définir quels champs personnalisés s’appliquent à quels types d’entités</td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>builtin_type</code> est lié à <code>description_parameters</code> pour les classifications d’entités définies par le système</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>custom_fields</code></strong></summary>

**Description**: Définitions des champs personnalisés permettant d’étendre dynamiquement le schéma pour différents types d’entités, avec des types de champs configurables (custom\_field\_type), des règles de validation et des options dans les paramètres (JSONB), ainsi que des indicateurs de champ obligatoire (is\_required) pour une collecte de données flexible sur les lieux, les missions et d’autres entités

<table><thead><tr><th width="146">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>custom_field_id</code> - Identifiant de l'entité du champ personnalisé<br>- <code>entity_id</code> - Identifiant de l'entité<br>- <code>custom_field_label</code> - Nom du champ<br>- <code>custom_field_type</code> - Type de données du champ<br>- <code>description</code> - Description du champ<br>- <code>is_required</code> - Est-ce obligatoire ou non ?<br>- <code>parameters</code> - Paramètres du champ</td></tr><tr><td><strong>Contenu</strong></td><td><code>parameters</code> (JSONB) stocke la configuration propre au type de champ (règles de validation, options de liste déroulante, etc.)</td></tr><tr><td><strong>Relations</strong></td><td>Définit les attributs personnalisés disponibles pour les entités ; le type de champ renvoie à <code>description_parameters</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Permet d’étendre dynamiquement le schéma sans modifier la base de données ; largement utilisé dans <code>Lieux</code> et <code>Missions</code></td></tr></tbody></table>

</details>

Suivi historique

<details>

<summary><strong><code>driver_history</code></strong></summary>

**Description** : Historique complet des affectations des employés aux véhicules au fil du temps, avec le suivi des transitions de old\_employee\_id à new\_employee\_id et leurs horodatages (changed\_datetime, server\_datetime), des données de localisation (latitude, longitude, address), des informations sur la clé matérielle et l’identification de l’utilisateur (updated\_by), permettant des analyses propres à chaque conducteur lorsque les conducteurs changent de véhicule

<table><thead><tr><th width="146">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>driver_history_id</code> - Identifiant de l’entité d’historique du conducteur<br>- <code>object_id</code> - Identifiant d’entité objet<br>- <code>old_employee_id</code> - Identifiant de l’ancienne entité employé<br>- <code>new_employee_id</code> - Nouvel identifiant d’entité de l’employé<br>- <code>hardware_key</code> - L’attribut hardware_key de la table driver_history<br>- <code>changed_datetime</code> - Date et heure auxquelles les modifications ont été apportées à l’appareil<br>- <code>server_datetime</code> - Date et heure des modifications effectuées sur le serveur<br>- <code>updated_by</code> - La date et l’heure associées à l’attribut updated_by<br>- <code>latitude</code> - L’attribut de latitude de la table driver_history<br>- <code>longitude</code> - L’attribut de longitude de la table driver_history<br>- <code>address</code> - L’attribut d’adresse de la table driver_history</td></tr><tr><td><strong>Relations</strong></td><td>Suit dans le temps les affectations des conducteurs aux véhicules ; liens vers <code>employees</code> et <code>objects</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Indispensable pour les rapports par conducteur lorsque les conducteurs changent de véhicule ; la capture de la localisation permet d’analyser le lieu du changement d’affectation.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>vehicle_trackers_history</code></strong></summary>

**Description**: Piste d’audit retraçant quels appareils GPS (object\_id) ont été installés dans quels véhicules (vehicle\_id) au fil du temps, avec les horodatages des modifications (changed\_datetime), afin de permettre une attribution précise des données historiques et un calcul fiable du kilométrage lorsque les trackers sont déplacés d’un véhicule à l’autre

<table><thead><tr><th width="144">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>vehicle_tracker_history_id</code> - Identifiant de l’entité d’historique du tracker du véhicule<br>- <code>vehicle_id</code> - Identifiant de l'entité véhicule<br>- <code>object_id</code> - Identifiant d’entité objet<br>- <code>changed_datetime</code> - La date et l’heure associées à l’attribut changed_datetime</td></tr><tr><td><strong>Relations</strong></td><td>Suit dans le temps quel appareil GPS a été installé dans quel véhicule</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Indispensable pour l’analyse des données historiques lorsque les trackers sont déplacés d’un véhicule à un autre ; permet d’attribuer avec précision le kilometrage et l’utilisation.</td></tr></tbody></table>

</details>

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

<details>

<summary><strong><code>description_parameters</code></strong></summary>

**Description**: Données de référence à l’échelle du système fournissant des libellés lisibles par l’utilisateur (description) pour les valeurs entières énumérées (key) utilisées dans toute la base de données, organisées par champ type (par exemple, task\_status, fuel\_type, counter\_type, entity\_classification) afin d’assurer une traduction cohérente des valeurs dans les rapports et l’affichage de l’interface utilisateur

<table><thead><tr><th width="146">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>key</code> - Valeur possible de l'attribut<br>- <code>type</code> - Attribut composite composé du nom de la table, suivi d'un trait de soulignement et du nom d'un attribut de la table<br>- <code>description</code> - Valeur implicite d'un attribut</td></tr><tr><td><strong>Contenu</strong></td><td>Fournit des libellés lisibles par l'humain pour les valeurs codées dans toute la base de données (statut des missions, types de carburant, types de compteurs, etc.)</td></tr><tr><td><strong>Relations</strong></td><td>Référencée par des clés étrangères depuis plusieurs tables pour une catégorisation standardisée</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Essentielle pour convertir les codes entiers en valeurs lisibles dans les rapports ; <code>type</code> regroupe les énumérations associées aux champs</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>counters</code></strong></summary>

**Description**: Configurations de compteurs kilométriques et de compteurs d'heures moteur reliant les relevés des capteurs de l'appareil (sensor\_id) aux mesures de distance ou de durée, avec des coefficients multiplicateurs pour la conversion des unités (km, miles, heures) et un counter\_type provenant de description\_parameters qui définit le type de mesure

<table><thead><tr><th width="140">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>counter_id</code> - ID interne<br>- <code>device_id</code> - Identifiant de l'entité appareil<br>- <code>counter_type</code> - Type de compteur<br>- <code>sensor_id</code> - Identifiant de l'entité capteur<br>- <code>multiplier</code> - Coefficient de conversion des valeurs vers l'une des unités (km, l, etc.)</td></tr><tr><td><strong>Relations</strong></td><td>Associe les appareils aux relevés des capteurs qui représentent des compteurs de distance ou de durée</td></tr><tr><td><strong>Remarques particulières</strong></td><td><code>multiplier</code> convertit les impulsions du capteur en unités réelles (km, miles, heures) ; <code>counter_type</code> de <code>description_parameters</code> définit le type de mesure</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_output_name</code></strong></summary>

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

<table><thead><tr><th width="140">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>device_id</code> - Identifiant de l'entité appareil<br>- <code>number</code> - Attribut number de la table device_output_name<br>- <code>label</code> - Attribut label de la table device_output_name</td></tr><tr><td><strong>Contenu</strong></td><td>Associe les numéros des canaux de sortie à des noms définis par l'utilisateur (par exemple, "Door Lock", "Engine Block")</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Permet de générer des rapports lisibles lors de l'analyse des commandes et des états de sortie de l'appareil</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_settings</code></strong></summary>

**Description**: Paires clé-valeur de configuration de l'appareil synchronisées depuis la plateforme source. Chaque ligne stocke un paramètre de configuration pour un appareil donné.

<table><thead><tr><th width="140">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>device_id</code> - Identifiant de l'entité appareil<br>- <code>key</code> - Nom du paramètre<br>- <code>value</code> - Valeur du paramètre</td></tr><tr><td><strong>Clé primaire</strong></td><td>Composite : <code>(device_id, key)</code></td></tr><tr><td><strong>Remarques particulières</strong></td><td>Renseigné lors de la synchronisation complète du client. Utilisez cette table pour consulter les valeurs de configuration au niveau de l’appareil avec les données télématiques ou métier.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>event_description</code></strong></summary>

**Description**: Table de référence des codes d’événement des trackers avec des descriptions compréhensibles. Contient 134 entrées couvrant les événements courants des trackers, tels que SOS, le Mode "veille", le Contact et les changements d’état des entrées/sorties numériques.

<table><thead><tr><th width="140">Attribut</th><th>Détails</th></tr></thead><tbody><tr><td><strong>Champs clés</strong></td><td>- <code>event_id</code> - Code d’événement (clé primaire)<br>- <code>description</code> - Nom de l’événement en langage clair</td></tr><tr><td><strong>Remarques particulières</strong></td><td>Joindre à <code>raw_telematics_data.tracking_data_core</code> sur <code>event_id</code> pour afficher les noms des événements dans les rapports et les tableaux de bord au lieu des codes numériques.</td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/fr/iot-query/schema-overview/bronze-layer/raw-business-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
