> 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. Ces tables représentent vos entités métier principales, la structure organisationnelle et les 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 %}

Retrouvez ci-dessous les détails du schéma raw business data.

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

```sql
Table "vehicle_service_Missions" {
  "record_added_at" timestamp [not null]
  "start_kilometrage" numeric
  "comment" "character varying(255)"
  "status" "character varying(10)" [not null]
  "completion_date" timestamp
  "start_engine_hours" numeric
  "service_Mission_id" integer [not null]
  "is_notification_push_enabled" boolean [not null]
  "date_notification_interval" interval
  "predicted_datetime" timestamp
  "cost" numeric [not null]
  "kilometrage_limit" numeric
  "notification_emails" text
  "is_unplanned" boolean [not null]
  "is_repeat" boolean [not null]
  "completion_engine_hours" integer
  "engine_hours_limit" numeric
  "kilometrage_repeat_interval" integer
  "vehicle_id" integer [not null]
  "engine_hours_notification_interval" integer
  "start_date" timestamp
  "kilometrage_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_kilometrage" 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 "Conducteur_history" {
  "server_datetime" timestamp [not null]
  "address" "character varying(255)"
  "updated_by" integer [not null]
  "Traceur_id" integer
  "longitude" numeric
  "latitude" numeric
  "Conducteur_history_id" integer [not null]
  "clé_matérielle" "character varying(64)"
  "nouvel_id_employé" integer
  "date_heure_modifiée" timestamp
  "record_added_at" timestamp [not null]
  "ancien_id_employé" integer
}

Table "Départements" {
  "record_added_at" timestamp [not null]
  "libellé_de_département" "character varying(255)" [non nul]
  "latitude" numeric
  "id_de_département" integer [non nul]
  "address" "character varying(255)"
  "radius" integer [not null]
  "longitude" numeric
  "user_id" integer [not null]
}

Table "pointages" {
  "radius" integer [not null]
  "latitude" numeric [non nul]
  "id_employé" integer [non nul]
  "longitude" numeric [non nul]
  "record_added_at" timestamp [not null]
  "date_heure_réelle" timestamp [non nul]
  "user_id" integer [not null]
  "id_de_Formulaire" integer [non nul]
  "address" "character varying(255)"
  "date_heure_prévue" timestamp [non nul]
  "id_de_Traceur" integer [non nul]
  "id_de_pointage" integer [non nul]
  "commentaire" text
}

Table "statuts" {
  "ordre_tri" integer [non nul]
  "id_de_liste" integer [non nul]
  "couleur" "character varying(6)" [non nul]
  "id_de_statut" integer [non nul]
  "libellé_de_statut" "character varying(200)" [non nul]
  "record_added_at" timestamp [not null]
  "est_supprimé" boolean [non nul]
}

Table "Lieux_champs_d'entité_liée" {
  "valeur" bigint [non nul]
  "record_added_at" timestamp [not null]
  "id_de_lieu" integer [non nul]
  "id_de_champ" integer [non nul]
}

Table "Lieux_champs_de_texte" {
  "id_de_lieu" integer [non nul]
  "record_added_at" timestamp [not null]
  "valeur" text [non nul]
  "id_de_champ" integer [non nul]
}

Table "utilisateurs2zones" {
  "id_de_zone" integer [non nul]
  "record_added_at" timestamp [not null]
  "user_id" integer [not null]
}

Table "Traceurs" {
  "record_added_at" timestamp [not null]
  "date_heure_de_création" timestamp [non nul]
  "id_client" integer [non nul]
  "id_de_Groupe" integer
  "libellé_de_Traceur" "character varying(100)"
  "modèle" "character varying(64)"
  "est_clone" boolean [non nul]
  "est_supprimé" boolean [non nul]
  "id_appareil" integer [non nul]
  "id_de_Traceur" integer [non nul]
}

Table "nom_de_sortie_appareil" {
  "id_appareil" integer [non nul]
  "record_added_at" timestamp [not null]
  "libellé" "character varying(100)" [non nul]
  "numéro" integer [non nul]
}

Table "points_de_Zone géographique" {
  "longitude" numeric [non nul]
  "numéro" integer [non nul]
  "id_de_zone" integer [non nul]
  "record_added_at" timestamp [not null]
  "latitude" numeric [non nul]
}

Table "champs_personnalisés" {
  "record_added_at" timestamp [not null]
  "id_entité" integer [non nul]
  "est_requis" boolean [non nul]
  "libellé_de_champ_personnalisé" text [non nul]
  "paramètres" jsonb
  "type_de_champ_personnalisé" integer [non nul]
  "description" texte
  "custom_field_id" entier [non null]
}

Table "lieux_decimal_fields" {
  "id_de_champ" integer [non nul]
  "record_added_at" timestamp [not null]
  "id_de_lieu" integer [non nul]
  "value" numérique [non nul]
}

Table "task_history" {
  "task_id" entier [pas null]
  "activité" entier [non nul]
  "task_history_id" entier [non nul]
  "record_added_at" timestamp [not null]
  "user_id" integer [not null]
  "event_datetime" horodatage [non null]
  "charge utile" texte
}

Table "Mots clés" {
  "Mots clés_label" "character varying(64)" [non nul]
  "color" "character varying(6)"
  "user_id" integer [not null]
  "record_added_at" timestamp [not null]
  "Mots clés_id" integer [non nul]
}

Table "Lieux" {
  "description" texte
  "custom_fields" jsonb
  "id_de_lieu" integer [non nul]
  "external_id" "character varying(32)"
  "record_added_at" timestamp [not null]
  "user_id" integer
  "latitude" numeric
  "radius" integer
  "lieu_label" "character varying(256)"
  "assigned_datetime" horodatage
  "address" "caractère variable(256)"
  "longitude" numeric
}

Table "status_listings" {
  "user_id" integer [not null]
  "is_supervisor_controlled" booléen [non nul]
  "est_supprimé" boolean [non nul]
  "status_listing_id" entier [non nul]
  "is_employee_controlled" booléen [non nul]
  "record_added_at" timestamp [not null]
  "status_listing_label" "caractère variable(200)" [non nul]
}

Table "models" {
  "record_added_at" timestamp [not null]
  "model_id" entier [non nul]
  "has_battery_level" booléen [non nul]
  "libellé_alternatif" "character varying(50)" [non nul]
  "fournisseur" "character varying(30)" [non nul]
  "est_clone" booléen
  "a_altitude" booléen [non nul]
  "a_téléphone" booléen [non nul]
  "type_de_contrôle_de_sortie" "character varying(30)" [non nul]
  "a_itinérance_GSM" booléen [non nul]
  "a_niveau_GSM" booléen [non nul]
  "modèle" "character varying(255)" [non nul]
  "type_de_contrôle_spécial" "character varying(255)" [non nul]
  "digital_amount" entier [non nul]
  "has_detach_button" booléen [non null]
  "has_gsm_name" booléen [non nul]
  "analog_amount" entier [non nul]
  "outputs_amount" entier [non nul]
}

Table "vehicle_trackers_history" {
  "vehicle_id" integer [not null]
  "record_added_at" timestamp [not null]
  "id_de_Traceur" integer [non nul]
  "changed_datetime" horodatage [non nul]
  "vehicle_tracker_history_id" entier [non nul]
}

Table "groupes" {
  "group_id" entier [non nul]
  "Groupe_couleur" "character varying(6)" [non nul]
  "Groupe_libellé" "character varying(255)" [non nul]
  "id_client" integer [non nul]
  "record_added_at" timestamp [not null]
}

Table "description_capteur" {
  "record_added_at" timestamp [not null]
  "paramètres" jsonb
  "id_entrée" integer [non nul]
  "exactitude" numeric [non nul]
  "unités_capteur" "character varying(10)"
  "multiplicateur" doubleprecision [non nul]
  "libellé_entrée" "character varying(64)"
  "libellé_capteur" "character varying(100)"
  "type_unités" integer [non nul]
  "diviseur" doubleprecision [non nul]
  "group_id" entier [non nul]
  "id_capteur" integer [non nul]
  "id_appareil" integer [non nul]
  "type_capteur" "character varying(45)" [non nul]
  "Groupe_type" integer [non nul]
  "données_calibrage" jsonb
}

Table "entités" {
  "libellé_entité" jsonb
  "record_added_at" timestamp [not null]
  "id_entité" integer [non nul]
  "type_intégré" integer [non nul]
  "user_id" integer [not null]
}

Table "zones" {
  "address" "character varying(255)"
  "radius" integer [not null]
  "id_de_zone" integer [non nul]
  "latitude_centre_cercle" numeric [non nul]
  "id_client" integer [non nul]
  "libellé_zone" "character varying(100)"
  "couleur" "character varying(6)" [non nul]
  "type_zone" "character varying(20)" [non nul]
  "longitude_centre_cercle" numeric [non nul]
  "latitude" numeric [non nul]
  "record_added_at" timestamp [not null]
  "longitude" numeric [non nul]
}

Table "Véhicules" {
  "vehicle_id" integer [not null]
  "longueur_charge_utile" numeric
  "VIN" "character varying(20)"
  "numéro_police_Assurance_gratuite" "character varying(50)"
  "libellé_véhicule" "character varying(100)"
  "largeur_charge_utile" numeric
  "color" "character varying(6)"
  "remorque" "character varying(255)"
  "Traceur_id" integer
  "id_statut_véhicule" integer
  "Assurance_responsabilité_valide_jusqu'à" timestamp
  "année_fabrication" integer
  "grade_Carburant" "character varying(16)"
  "coût_Carburant" numeric
  "volume_réservoir_Carburant" numeric
  "modèle" "character varying(100)"
  "id_garage" integer
  "hauteur_charge_utile" numeric
  "vitesse_maximale" numeric
  "numéro_immatriculation" "character varying(32)"
  "taille_pneu" "character varying(50)"
  "capacité_passagers" integer
  "record_added_at" timestamp [not null]
  "numéro_immatriculation_remorque" "character varying(32)"
  "date_fin_Assurance_gratuite" timestamp
  "poids_brut" numeric
  "consommation_standard_Carburant" numeric
  "type_Carburant" integer
  "poids_charge_utile" numeric
  "informations_supplémentaires" text
  "sous_type_de_véhicule" "character varying(32)"
  "numéro_de_police_d'Assurance" "character varying(50)"
  "numéro_de_cadre" "character varying(32)"
  "user_id" integer [not null]
  "type_de_véhicule" integer [not null]
  "numéro_de_châssis" "character varying(32)"
  "nombre_de_pneus" integer
  "disposition_des_roues" "character varying(16)"
}

Table "Mots clés_liens" {
  "id_entité" integer [non nul]
  "record_added_at" timestamp [not null]
  "type_d'entité" integer [not null]
  "ordinal" integer [not null]
  "Mots clés_id" integer [non nul]
}

Table "règles" {
  "id_de_règle" integer [not null]
  "id_de_Traceur" integer [non nul]
  "paramètres" jsonb
  "téléphone_d'alerte" "character varying(210)" [not null]
  "type_d'événement" "character varying(100)" [not null]
  "id_client" integer [non nul]
  "push_activé" boolean [not null]
  "commentaire_d'événement1" "character varying(255)" [not null]
  "libellé_d'événement" "character varying(255)" [not null]
  "description" "character varying(255)" [not null]
  "record_added_at" timestamp [not null]
  "SMS_d'alerte" text [not null]
  "Groupe_d'événement" integer [not null]
  "créé_le" timestamp [not null]
  "maximum" integer [not null]
  "est_supprimé" boolean [non nul]
  "e-mail_d'alerte" text [not null]
  "commentaire_d'événement2" "character varying(255)" [not null]
}

Table "historique_des_statuts" {
  "longitude" numeric
  "id_du_nouveau_statut" integer
  "id_de_l'historique_des_statuts" integer [not null]
  "id_appareil" integer [non nul]
  "updated_by" integer [not null]
  "address" "character varying(255)"
  "latitude" numeric
  "record_added_at" timestamp [not null]
  "server_datetime" timestamp [not null]
  "date_heure_modifiée" timestamp
  "id_de_l'ancien_statut" integer
}

Table "règles2zones" {
  "id_de_zone" integer [non nul]
  "record_added_at" timestamp [not null]
  "id_de_règle" integer [not null]
}

Table "Formulaires" {
  "id_de_Traceur" integer [non nul]
  "description" texte
  "libellé_du_Formulaire" "character varying(255)" [not null]
  "champs" text
  "créé_le" timestamp [not null]
  "adresse_de_soumission" "character varying(255)"
  "latitude_de_soumission" numeric
  "id_de_Formulaire" integer [non nul]
  "longitude_de_soumission" numeric
  "est_soumission_dans_la_zone" boolean [not null]
  "valeurs" text
  "record_added_at" timestamp [not null]
  "id_de_Mission" integer
  "soumis_le" timestamp
}


Table "règles2objets" {
  "paramètres_du_Traceur" jsonb
  "numéro_de_groupe_de_paramètres" integer [not null]
  "id_de_Traceur" integer [non nul]
  "record_added_at" timestamp [not null]
  "id_de_règle" integer [not null]
}

Table "Missions" {
  "heure_de_début" timestamp
  "durée_du_séjour_en_minutes" interval
  "id_externe" "character varying(100)"
  "Traceur_id" integer
  "type_de_Mission" integer
  "durée_d'arrivée_en_minutes" interval
  "statut" integer
  "date_heure_d'arrivée" timestamp
  "record_added_at" timestamp [not null]
  "task_id" entier [pas null]
  "user_id" integer
  "date_heure_de_changement_de_statut" timestamp
  "ordre_de_tri" integer
  "heure_de_fin" timestamp
  "délai_maximum_en_minutes" integer
  "contrôle_du_séjour_activé" boolean
  "address" "character varying(255)"
  "libellé_de_Mission" "character varying(200)" [not null]
  "longitude" numeric
  "créé_par" integer
  "description" text [not null]
  "radius" integer
  "latitude" numeric
  "durée_du_séjour" integer
  "créé_le" timestamp [not null]
  "custom_fields" jsonb
  "id_de_la_Mission_parente" integer
}

Table "champs_bigint_des_Lieux" {
  "id_de_champ" integer [non nul]
  "valeur" bigint [non nul]
  "id_de_lieu" integer [non nul]
  "record_added_at" timestamp [not null]
}

Table "appareils" {
  "sim_bloquée" boolean [not null]
  "id_appareil" integer [non nul]
  "imei_de_l'appareil" "character varying(64)" [not null]
  "libellé_du_réseau" "character varying(50)" [not null]
  "status_listing_id" entier [non nul]
  "niveau_du_signal" numeric [not null]
  "téléphone" "character varying(32)" [not null]
  "a_itinérance" boolean [not null]
  "créé_le" timestamp [not null]
  "id_du_Propriétaire" integer [not null]
  "record_added_at" timestamp [not null]
}

Table "paramètres_de_description" {
  "description" "character varying(150)"
  "record_added_at" timestamp [not null]
  "type" "character varying(100)" [not null]
  "clé" integer [not null]
}

Table "utilisateurs" {
  "libellé_de_l'entreprise" "character varying(255)" [not null]
  "date_heure_d'inscription" timestamp
  "prénom" "character varying(100)" [not null]
  "id_maître" integer
  "nom" "character varying(100)" [not null]
  "date_de_naissance" timestamp
  "libellé_du_fuseau_horaire" "character varying(30)"
  "deuxième_prénom" "character varying(100)" [not null]
  "user_id" integer [not null]
  "locale" "character varying(10)" [not null]
  "record_added_at" timestamp [not null]
}

Table "compteurs" {
  "id_du_capteur" integer
  "multiplicateur" numeric [not null]
  "id_du_compteur" integer [not null]
  "id_appareil" integer [non nul]
  "type_de_compteur" integer [not null]
  "record_added_at" timestamp [not null]
}

Table "employés" {
  "date_de_validité_du_permis_de_Conducteur" timestamp
  "record_added_at" timestamp [not null]
  "nom" "character varying(100)"
  "id_du_service" integer
  "numéro_de_carte_d'identité" "character varying(32)"
  "prénom" "character varying(100)"
  "catégories_du_permis_de_Conducteur" "character varying(32)"
  "user_id" integer [not null]
  "numéro_de_téléphone" "character varying(32)"
  "Traceur_id" integer
  "est_supprimé" boolean [non nul]
  "date_de_délivrance_du_permis_de_Conducteur" boolean
  "clé_matérielle" "character varying(64)"
  "deuxième_prénom" "character varying(100)"
  "address" "character varying(255)"
  "latitude" numeric
  "id_employé" integer [non nul]
  "matricule" "character varying(15)"
  "coût_du_Carburant" doubleprecision
  "numéro_de_permis_Conducteur" "character varying(32)"
  "email" "character varying(100)"
  "consommation_Carburant" doubleprecision
  "radius" integer [not null]
  "longitude" numeric
}

Table "Lieux_longtext_fields" {
  "id_de_champ" integer [non nul]
  "valeur" text [non nul]
  "record_added_at" timestamp [not null]
  "id_de_lieu" integer [non nul]
}

Table "Groupes_Traceurs" {
  "Groupes_client_id" integer
  "Traceurs_client_id" integer

  Index {
    (Groupes_client_id, Traceurs_client_id) [pk]
  }
}

Table "paramètres_appareil" {
  "id_appareil" integer [non nul]
  "clé" "character varying" [not null]
  "valeur" text

  Index {
    (appareil_id, clé) [pk]
  }
}

Table "description_événement" {
  "événement_id" integer [not null, pk]
  "description" texte
}

Ref:"employés"."employé_id" < "pointages"."employé_id"

Ref:"Traceurs"."Traceur_id" < "pointages"."Traceur_id"

Ref:"Formulaires"."Formulaire_id" < "pointages"."Formulaire_id"

Ref:"description_capteur"."capteur_id" < "compteurs"."capteur_id"

Ref:"appareils"."appareil_id" < "compteurs"."appareil_id"

Ref:"entités"."entité_id" < "champs_personnalisés"."entité_id"

Ref:"Départements"."département_id" < "employés"."département_id"

Ref:"utilisateurs"."utilisateur_id" < "Départements"."utilisateur_id"

Ref:"paramètres_description"."clé" < "compteurs"."type_compteur"

Ref:"paramètres_description"."clé" < "champs_personnalisés"."type_champ_personnalisé"

Ref:"paramètres_description"."clé" < "historique_Conducteur"."modifié_par"

Ref:"paramètres_description"."clé" < "entités"."type_intégré"

Ref:"paramètres_description"."clé" < "description_capteur"."type_unités"

Ref:"paramètres_description"."clé" < "historique_statut"."modifié_par"

Ref:"paramètres_description"."clé" < "Missions"."statut"

Ref:"paramètres_description"."clé" < "Missions"."created_at"

Ref:"paramètres_description"."clé" < "Missions"."type_Mission"

Ref:"paramètres_description"."clé" < "Véhicules"."type_Carburant"

Ref:"paramètres_description"."clé" < "historique_Mission"."activité"

Ref:"paramètres_description"."clé" < "description_capteur"."type_groupe"

Ref:"appareils"."appareil_id" < "nom_sortie_appareil"."appareil_id"

Ref:"listes_statut"."liste_statut_id" < "appareils"."liste_statut_id"

Ref:"employés"."employé_id" < "historique_Conducteur"."nouvel_employé_id"

Ref:"employés"."employé_id" < "historique_Conducteur"."ancien_employé_id"

Ref:"Traceurs"."Traceur_id" < "historique_Conducteur"."Traceur_id"

Ref:"Traceurs"."Traceur_id" < "employés"."Traceur_id"

Ref:"utilisateurs"."utilisateur_id" < "employés"."utilisateur_id"

Ref:"utilisateurs"."utilisateur_id" < "entités"."utilisateur_id"

Ref:"Missions"."Mission_id" < "Formulaires"."Mission_id"

Ref:"Traceurs"."Traceur_id" < "Formulaires"."Traceur_id"

Ref:"Traceurs"."Traceur_id" < "Missions"."Traceur_id"

Ref:"utilisateurs"."utilisateur_id" < "garages"."utilisateur_id"

Ref:"Groupes"."client_id" < "Groupes_Traceurs"."Groupes_client_id"

Ref:"Traceurs"."client_id" < "Groupes_Traceurs"."Traceurs_client_id"

Ref:"modèles"."modèle" < "Traceurs"."modèle"

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

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

Réf:"custom_fields"."custom_field_id" < "places_bigint_fields"."field_id"

Ref:"lieux"."place_id" < "lieux_bigint_fields"."place_id"

Réf:"custom_fields"."custom_field_id" < "Lieux_decimal_fields"."field_id"

Ref:"Lieux"."place_id" < "Lieux_decimal_fields"."place_id"

Réf.:"custom_fields"."custom_field_id" < "places_linked_entity_fields"."field_id"

Réf:"Lieux"."place_id" < "Lieux_linked_entity_fields"."place_id"

Réf :"custom_fields"."custom_field_id" < "Lieux_longtext_fields"."field_id"

Réf:"Lieux"."place_id" < "Lieux_longtext_fields"."place_id"

Réf :"custom_fields"."custom_field_id" < "Lieux_text_fields"."field_id"

Ref:"Lieux"."place_id" < "Lieux_text_fields"."place_id"

Réf. :"rules"."rule_id" < "rules2zones"."rule_id"

Réf :"traceurs"."traceur_id" < "rules2traceurs"."traceur_id"

Réf:"rules"."rule_id" < "rules2objects"."object_id"

Réf:"zones"."zone_id" < "rules2zones"."zone_id"

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

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

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

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

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

Réf. :"status_listings"."status_listing_id" < "statuses"."listing_id"

Réf :"Mots clés"."Mots clés_id" < "Mots clés_links"."Mots clés_id"

Réf:"users"."user_id" < "Mots clés"."user_id"

Ref:"Missions"."Mission_id" < "Mission_history"."Mission_id"

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

Ref:"Missions"."parent_task_id" < "Missions"."task_id"

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

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

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

Réf :"zones"."zone_id" < "users2zones"."zone_id"

Ref:"Véhicules"."vehicle_id" < "vehicle_service_tasks"."vehicle_id"

Réf:"objects"."object_id" < "vehicle_trackers_history"."object_id"

Ref:"Véhicules"."vehicle_id" < "vehicle_trackers_history"."vehicle_id"

Réf:"garages"."garage_id" < "Véhicules"."garage_id"

Réf:"objects"."object_id" < "vehicles"."object_id"

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

Réf:"zones"."zone_id" < "Zone géographique"."zone_id"

Réf : "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 principale. Les mises à jour s’effectuent de manière incrémentale à mesure que des changements se produisent dans la base MySQL source, généralement en moins de 5 minutes après la modification de la source.

## `paramètres de description`

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 des types</td><td>Types d’entités standard</td><td><code>vehicle_type : voiture, camion, bus</code></td></tr><tr><td>Codes de statut</td><td>Valeurs de mission et d'état du système</td><td><code>statut des missions : non attribué, assigné, terminé</code></td></tr><tr><td>Définitions des unités</td><td>Unités de mesure pour les capteurs</td><td><code>units_type : litre, gallon, Celsius</code></td></tr><tr><td>Classifications des entités</td><td>Catégories d'entités commerciales</td><td><code>entities_type : lieu, Mission, client</code></td></tr></tbody></table>

## Tables clés par catégorie

Les tableaux dans le **`raw_business_data`** Les schémas sont organisés en catégories fonctionnelles pour une navigation plus facile. Le tableau ci-dessous résume les tables clés selon leur finalité métier :

Entités métier principales

<details>

<summary><strong><code>utilisateurs</code></strong></summary>

**Description**: Comptes utilisateur contenant des informations de Profil, l’affiliation à l’entreprise, les paramètres de localisation (fuseau horaire, langue locale) et des relations hiérarchiques via master\_id pour des structures de compte à 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 utilisateur unique<br>- <code>company_label</code> - Nom de l'entreprise associée à l'utilisateur<br>- <code>prénom</code> - Nom d'utilisateur<br>- <code>nom de famille</code> - Nom de famille de l'utilisateur<br>- <code>deuxième prénom</code> - Patronyme de l'utilisateur<br>- <code>paramètres régionaux</code> - Paramètres de langue de l'utilisateur<br>- <code>libellé du fuseau horaire</code> - Fuseau horaire au format IANA<br>- <code>master_id</code> - ID utilisateur principal (si l'utilisateur actuel est un 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>, lié à <code>employés</code>, <code>Départements</code>, <code>Lieux</code>, <code>Missions</code> par <code>user_id</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Entité centrale reliant les données organisationnelles ; <code>master_id</code> permet des hiérarchies d'utilisateurs pour des structures de comptes à plusieurs niveaux</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>employés</code></strong></summary>

**Description**: Enregistrements des employés et des conducteurs utilisés pour représenter les personnes travaillant pour l'organisation, y compris les informations personnelles, les détails de licence, les affectations aux Départements, 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>id_objet</code> - objet identifiant d’entité<br>- <code>id_du_département</code> - Un identifiant du département auquel l'employé est affecté<br>- <code>prénom</code> - L'attribut first_name de la table employees<br>- <code>nom de famille</code> - L’attribut last_name de la table des employés<br>- <code>deuxième prénom</code> - L'attribut middle_name de la table employees<br>- <code>numéro_de_permis_de_conducteur</code> - Numéro de permis de Conducteur<br>- <code>catégories_du_permis_de_Conducteur</code> - Catégories du permis de Conducteur<br>- <code>date_d'émission_du_permis_de_Conducteur</code> - Date d'émission d'un permis de Conducteur<br>- <code>date_de_validité_du_permis_de_Conducteur</code> - Date jusqu'à laquelle un permis de Conducteur est valide<br>- <code>clé_matérielle</code> - Une clé matérielle<br>- <code>courriel</code> - E-mail de l'employé<br>- <code>numéro_de_téléphone</code> - Numéro de téléphone de l'employé sans signe "+"<br>- <code>adresse</code> - Adresse du lieu<br>- <code>numéro_de_personnel</code> - Numéro de personnel de l'employé/Conducteur<br>- <code>numéro_de_carte_d'identité</code> - Numéro de Sécurité sociale<br>- <code>latitude</code> - Lieu associé à cet employé<br>- <code>longitude</code> - Lieu associé à cet employé<br>- <code>rayon</code> - Emplacement associé à cet employé en mètres<br>- <code>consommation_de_Carburant</code> - L'attribut consommation_de_Carburant de la table des employés<br>- <code>coût_du_Carburant</code> - L'attribut coût_du_Carburant de la table des employés<br>- <code>est_supprimé</code> - L'attribut is_deleted de la table des employés</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>utilisateurs</code>, <code>Départements</code>, <code>objets</code> (traceur assigné), suivi dans <code>historique_du_Conducteur</code> et <code>pointages</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>La clé matérielle permet l’identification du conducteur via iButton ou RFID ; prend en charge le géorepérage avec <code>latitude</code>, <code>longitude</code>, <code>rayon</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 la Zone géographique pour des rapports au niveau des Départements et l’association de l’emplacement des employés

<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>id_du_département</code> - Identifiant de l’entité 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>rayon</code> - Taille de la géolocalisation en mètres<br>- <code>adresse</code> - L’attribut adresse de la table des Départements</td></tr><tr><td><strong>Relations</strong></td><td>Relie les employés à la structure organisationnelle via <code>id_du_département</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Les champs de localisation prennent en charge des analyses basées sur Zone géographique pour les rapports au niveau du service</td></tr></tbody></table>

</details>

Suivi et surveillance

<details>

<summary><strong><code>appareils</code></strong></summary>

**Description**: Registre physique des dispositifs de Suivi avec des identifiants matériels (IMEI), des informations de carte SIM, l'état de connectivité réseau (puissance du signal, itinérance, opérateur) et des affectations de liste de statuts 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>ID de l'appareil</code> - ID de l'appareil<br>- <code>Propriétaire_id</code> - ID du Propriétaire de l'appareil dans le compte duquel la balise a été ajoutée<br>- <code>imei_de_l_appareil</code> - IMEI de l'appareil<br>- <code>téléphone</code> - Le numéro de la carte SIM de l'appareil<br>- <code>identifiant_de_liste_de_statut</code> - ID du Rapport du matériel<br>- <code>libellé_du_réseau</code> - Le nom du réseau auquel la carte SIM est connectée<br>- <code>niveau_du_signal</code> - Puissance du signal de l’appareil<br>- <code>itinérance_disponible</code> - Indicateur de disponibilité de l’itinérance<br>- <code>carte_sim_bloquée</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>objets</code>, <code>modèles</code>, <code>description_du_capteur</code>, <code>compteurs</code>; <code>Propriétaire_id</code> références <code>users.user_id</code></td></tr><tr><td><strong>Notes spéciales</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>ID de l'appareil</code></td></tr></tbody></table>

</details>

<details>

<summary><strong><code>objets</code></strong></summary>

**Description**: Registre central des entités surveillées (Véhicules, actifs, personnel) reliant des dispositifs physiques à la structure organisationnelle via client\_id et Groupe\_id, représentant la "trackable unit" avec un Traceur 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>id_objet</code> - objet identifiant d’entité<br>- <code>identifiant_client</code> - Identifiant de l'entité client<br>- <code>ID de l'appareil</code> - Identifiant de l’entité de l’appareil<br>- <code>traceur_label</code> - Nom du Traceur<br>- <code>modèle</code> - Modèle de l'appareil<br>- <code>groupe_id</code> - Groupe d’identifiants d’entité<br>- <code>date_heure_de_création</code> - Date et heure de création d'une nouvelle ligne sur le serveur<br>- <code>est_supprimé</code> - L'attribut is_deleted de la table des objets<br>- <code>est_clone</code> - Signe de clonage</td></tr><tr><td><strong>Relations</strong></td><td>Centre central reliant les appareils aux utilisateurs (<code>identifiant_client</code>), détails du véhicule, historique de suivi, tâches et règles</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Représente « l'unité traçable » dans le système ; un Traceur par appareil en cours d'utilisation</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>modèles</code></strong></summary>

**Description**: Registre central des entités surveillées (Véhicules, actifs, personnel) reliant des dispositifs physiques à la structure organisationnelle via client\_id et Groupe\_id, représentant la "trackable unit" avec un Traceur 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>id_modèle</code> - Identifiant du modèle d'entité<br>- <code>modèle</code> - L'attribut de modèle de la table des modèles<br>- <code>fournisseur</code> - Le nom de l'entreprise qui a commercialisé le traceur<br>- <code>libellé_alternatif</code> - L'attribut alternative_label de la table des modèles<br>- <code>nombre_analogique</code> - Nombre d'entrées analogiques du traceur<br>- <code>nombre_numérique</code> - Nombre d'entrées discrètes du traceur<br>- <code>nombre_de_sorties</code> - Nombre de sorties discrètes du traceur<br>- <code>a_niveau_batterie</code> - Détermine si le traceur transmet les relevés de charge de la batterie<br>- <code>a_altitude</code> - Détermine si le traceur transmet l'altitude<br>- <code>a_téléphone</code> - Y a-t-il une carte SIM ?<br>- <code>a_niveau_GSM</code> - Le traceur peut-il transmettre la puissance du signal GSM ?<br>- <code>a_nom_GSM</code> - Le traceur peut-il transmettre le nom du réseau GSM ou le code de l'opérateur (MCC + MNC) ?<br>- <code>a_itinérance_GSM</code> - Le traceur peut-il transmettre l'état d'itinérance ?<br>- <code>a_bouton_de_détachement</code> - Le traceur dispose-t-il d'un capteur de détachement ?<br>- <code>type_de_contrôle_des_sorties</code> - Profil de contrôle des sorties du traceur<br>- <code>type_de_contrôle_spécial</code> - Contient des paramètres spécialisés et des modules fonctionnels pour des modèles d'appareils individuels, tels que le mode Eco conduite dangereux (hbm_telfm) pour les équipements Teltonika<br>- <code>est_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 booléens de capacités indiquent quels champs de données sont disponibles pour ce type d'appareil</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Utilisez les indicateurs de capacités 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>description_du_capteur</code></strong></summary>

**Description**: Configuration complète des capteurs reliant les entrées de l'appareil à la logique métier, y compris les correspondances 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 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>identifiant_capteur</code> - Identifiant de l'entité capteur<br>- <code>ID de l'appareil</code> - Identifiant de l’entité de l’appareil<br>- <code>libellé_du_capteur</code> - Nom du capteur pour l'interface<br>- <code>libellé_d'entrée</code> - Le nom du champ du message (attribut) à partir duquel les Données du capteur sont extraites. S'il est égal à "input_status", c'est un Capteur discret<br>- <code>type_de_capteur</code> - Type de capteur<br>- <code>type_d'unités</code> - Unités de mesure<br>- <code>multiplicateur</code> - Multiplicateur - le nombre par lequel multiplier la valeur du champ. Réservé aux Capteurs de mesure uniquement<br>- <code>diviseur</code> - Diviseur - le nombre par lequel diviser la valeur du champ. Réservé aux Capteurs de mesure uniquement<br>- <code>précision</code> - Un 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 ont lieu. Ceci est utilisé uniquement pour les capteurs de Carburant<br>- <code>données_d'étalonnage</code> - L'attribut calibration_data de la table sensor_description<br>- <code>identifiant_d'entrée</code> - Numéro d'entrée pour Capteur discret<br>- <code>groupe_id</code> - Les capteurs du même type avec le même Groupe_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 Groupe_type. Ceci est requis pour les capteurs agrégés. Il est utilisé dans les capteurs de mesure<br>- <code>Groupe_type</code> - 0 - additionner les valeurs des capteurs au sein d'un Groupe, 1 - moyenne<br>- <code>unités_du_capteur</code> - Nom d'unité saisi par l'utilisateur si units_type=0 (personnalisé)<br>- <code>paramètres</code> - Traceur 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 d'entiers. 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 légale de la valeur par heure. max_lowering_by_kilometrage - facultatif. Double. Diminution maximale légale de la valeur par 100 km. ignore_drains_in_move - facultatif. Booléen. La valeur par défaut est false. Si true, les vidanges de Carburant ne seront pas détectées pendant le Mouvement. ignore_refuels_in_move - facultatif. Booléen. La valeur par défaut est false. Si true, les ravitaillements ne seront pas détectés pendant le Mouvement. refuel_gap_minutes - facultatif. Entier. La valeur par défaut est 5. Le temps, en minutes, après le début du Mouvement, les ravitaillements seront détectés pendant le Mouvement. custom_field_name - facultatif. Booléen. La valeur par défaut est 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 dispose de la fonctionnalité has_custom_fields</td></tr><tr><td><strong>Relations</strong></td><td>Lie les entrées de l'appareil (depuis <code>raw_telematics_data.inputs</code>) à la logique métier via <code>ID de l'appareil</code> et <code>libellé_d'entrée</code> correspondance</td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>données_d'étalonnage</code> (JSONB) stocke des tables d'étalonnage spécifiques aux capteurs pour les capteurs de niveau de carburant ; <code>multiplicateur</code> et <code>diviseur</code> convertir les valeurs brutes en unités</td></tr></tbody></table>

</details>

Gestion d’Actif

<details>

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

**Description**: Registre complet des véhicules, contenant des spécifications (dimensions, poids, capacité), de la documentation (VIN, immatriculation, Assurance), des paramètres opérationnels (Consommation de carburant, volume du réservoir) et l’affectation actuelle du Traceur via object\_id pour 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>ID du véhicule</code> - Identifiant de l'entité véhicule<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>id_du_garage</code> - Identifiant de l'entité garage<br>- <code>étiquette du véhicule</code> - L'attribut libellé du véhicule de la table Véhicules<br>- <code>numéro d'immatriculation</code> - Numéro d'immatriculation / Plaque d'immatriculation d'un véhicule<br>- <code>VIN</code> - L'attribut VIN de la table Véhicules<br>- <code>année de fabrication</code> - L'attribut année de fabrication de la table Véhicules<br>- <code>type de carburant</code> - L'attribut type de carburant de la table Véhicules<br>- <code>coût_du_Carburant</code> - L'attribut coût du carburant de la table Véhicules<br>- <code>volume_du_réservoir_de_Carburant</code> - L'attribut volume_du_réservoir_de_Carburant de la table des Véhicules<br>- <code>vitesse_max</code> - L'attribut vitesse_max de la table des Véhicules<br>- <code>modèle</code> - L'attribut modèle de la table des Véhicules<br>- <code>couleur</code> - L'attribut couleur de la table des Véhicules<br>- <code>remorque</code> - L'attribut remorque de la table des Véhicules<br>- <code>informations_supplémentaires</code> - L'attribut informations_supplémentaires de la table des Véhicules<br>- <code>type de véhicule</code> - L'attribut type de véhicule de la table des Véhicules<br>- <code>sous-type de véhicule</code> - L'attribut sous-type de véhicule de la table des Véhicules<br>- <code>identifiant du statut du véhicule</code> - Identifiant de l'entité du statut du véhicule<br>- <code>numéro de châssis</code> - L'attribut numéro de châssis de la table des Véhicules<br>- <code>numéro de cadre</code> - L'attribut numéro de cadre de la table des Véhicules<br>- <code>trailer_reg_number</code> - L’attribut trailer_reg_number de la table Véhicules<br>- <code>payload_weight</code> - L’attribut payload_weight de la table Véhicules<br>- <code>payload_height</code> - L’attribut payload_height de la table 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>capacité des passagers</code> - Un nombre maximal de passagers<br>- <code>poids brut</code> - L'attribut poids brut de la table des Véhicules<br>- <code>Consommation de carburant standard</code> - Consommation de carburant moyenne normale en litres par 100 km<br>- <code>qualité du Carburant</code> - L'attribut qualité du Carburant de la table des Véhicules<br>- <code>configuration des roues</code> - L'attribut configuration des roues de la table des Véhicules<br>- <code>taille_des_pneus</code> - Taille du véhicule : dimensions et taille des roues<br>- <code>nombre_de_pneus</code> - Nombre de roues<br>- <code>numéro_de_police_d'Assurance_de_responsabilité</code> - L'attribut numéro_de_police_d'Assurance_de_responsabilité de la table des Véhicules<br>- <code>date_de_validité_d'Assurance_de_responsabilité</code> - La date jusqu'à laquelle l'Assurance de responsabilité est valide<br>- <code>numéro_de_police_d'Assurance_gratuite</code> - L'attribut numéro_de_police_d'Assurance_gratuite de la table des Véhicules<br>- <code>assurance_gratuite_valide_jusqu_a_la_date</code> - La date jusqu'à laquelle l'Assurance gratuite est valide</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>objets</code> (traceur actuel), <code>garages</code> (emplacement de service), <code>véhicule_service_Missions</code>; suivi dans <code>historique_des_traceurs_de_véhicule</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Champs de dimension physique (<code>payload_length</code>, <code>payload_width</code>, <code>payload_height</code>, <code>poids brut</code>) prennent en charge les analyses de planification de la charge ; les dates d'Assurance permettent le Suivi de conformité</td></tr></tbody></table>

</details>

<details>

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

**Description**: Emplacements des installations de service et d’Entretien avec coordonnées géographiques (latitude, longitude, rayon), informations de contact pour les mécaniciens et les répartiteurs, permettant la détection des visites de service basées sur 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>id_du_garage</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>rayon</code> - Taille de la géolocalisation en mètres<br>- <code>adresse</code> - Traceur de localisation<br>- <code>libellé_organisation</code> - ID du Garage<br>- <code>nom_du_mécanicien</code> - Nom du mécanicien<br>- <code>nom_du_répartiteur</code> - Nom du répartiteur</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>véhicules.garage_id</code> pour l'affectation de l'emplacement de service</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Les champs d'emplacement permettent la détection des visites de service basée sur une Zone géographique et l'analyse de proximité</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>véhicule_service_Missions</code></strong></summary>

**Description**: Planification de l'Entretien et Suivi de l'historique de service avec plusieurs types de déclencheurs (basés sur la date, basés sur le kilometrage, basés sur les heures moteur), des intervalles de Mission récurrents, des notifications multicanales (e-mail, SMS, push) et une distinction entre les événements d'Entretien planifiés (is\_repeat) et non planifiés

<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_mission_id</code> - Identifiant de l'entité de mission de service<br>- <code>ID du véhicule</code> - Identifiant de l'entité véhicule<br>- <code>description</code> - L'attribut description de la table vehicle_service_missions<br>- <code>statut</code> - La valeur de l'attribut statut<br>- <code>coût</code> - L'attribut coût de la table vehicle_service_missions<br>- <code>date_de_début</code> - La date et l'heure associées à l'attribut date_de_début<br>- <code>date_de_fin</code> - La date et l'heure associées à l'attribut date_de_fin<br>- <code>date_de_achèvement</code> - La date et l'heure associées à l'attribut date_de_achèvement<br>- <code>date_et_heure_prévue</code> - La date et l'heure associées à l'attribut date_et_heure_prévue<br>- <code>limite_de_kilometrage</code> - L'attribut limite_de_kilometrage de la table vehicle_service_missions<br>- <code>limite_heures_moteur</code> - L'attribut limite_heures_moteur de la table vehicle_service_missions<br>- <code>kilometrage_initial</code> - L'attribut kilometrage_initial de la table vehicle_service_missions<br>- <code>heures_moteur_initiales</code> - L'attribut heures_moteur_initiales de la table vehicle_service_missions<br>- <code>intervalle_de_notification_kilometrage</code> - L'attribut intervalle_de_notification_kilometrage de la table vehicle_service_missions<br>- <code>intervalle_de_notification_heures_moteur</code> - L'attribut intervalle_de_notification_heures_moteur de la table vehicle_service_missions<br>- <code>intervalle_de_notification_de_date</code> - Conversion d'un entier N en N jours<br>- <code>intervalle_de_répétition_du_kilometrage</code> - L'attribut intervalle_de_répétition_du_kilometrage de la table vehicle_service_missions<br>- <code>intervalle_de_répétition_des_heures_moteur</code> - L'attribut intervalle_de_répétition_des_heures_moteur de la table vehicle_service_missions<br>- <code>intervalle_de_répétition_de_date</code> - Conversion d'un entier N en N jours<br>- <code>courriels_de_notification</code> - L'attribut courriels_de_notification de la table vehicle_service_missions<br>- <code>numéros_de_téléphone_sms_de_notification</code> - L'attribut numéros_de_téléphone_sms_de_notification de la table vehicle_service_missions<br>- <code>notifications_push_activées</code> - L'attribut notifications_push_activées de la table vehicle_service_missions<br>- <code>kilometrage_de_fin</code> - L'attribut kilometrage_de_fin de la table vehicle_service_missions<br>- <code>heures_moteur_de_fin</code> - L'attribut heures_moteur_de_fin de la table vehicle_service_missions<br>- <code>est_répété</code> - L'attribut est_répété de la table vehicle_service_missions<br>- <code>est_non_planifié</code> - L’attribut is_unplanned de la table vehicle_service_tasks<br>- <code>commentaire</code> - L'attribut comment de la table vehicle_service_missions</td></tr><tr><td><strong>Contenu</strong></td><td>Prend en charge trois types de déclencheurs : basés sur la date, basés sur le kilometrage, basés sur les heures moteur ; paramètres de notification pour e-mail, SMS, push</td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>est_répété</code> et les champs d’intervalle permettent des programmes d’Entretien récurrents ; <code>est_non_planifié</code> distingue l’entretien planifié de l’entretien réactif</td></tr></tbody></table>

</details>

Localisation et routage

<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, prenant en charge l'automatisation basée sur des règles et l'analyse de localisation avec un code couleur pour une différenciation visuelle

<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>identifiant_zone</code> - Identifiant de l'entité zone<br>- <code>identifiant_client</code> - Identifiant de l'entité client<br>- <code>libellé_zone</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 optionnel, la boîte englobante qui peut contenir entièrement le résultat renvoyé<br>- <code>longitude</code> - Objet optionnel, la boîte englobante qui peut 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 des zones<br>- <code>rayon</code> - Taille de la géolocalisation en mètres<br>- <code>adresse</code> - L'attribut adresse de la table des zones<br>- <code>couleur</code> - L'attribut de couleur de la table des zones</td></tr><tr><td><strong>Contenu</strong></td><td>Les types de zone incluent le cercle, le polygone (défini via <code>points_de_zone_géographique</code>), et les classifications des zones spéciales</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>rules2zones</code>, <code>utilisateurs vers zones</code>; sommets du polygone stockés dans <code>points_de_zone_géographique</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Les fonctions PostGIS peuvent être utilisées pour vérifier si un point se trouve dans un polygone pour 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 des coordonnées géographiques, des définitions de rayon et un support extensible de champs personnalisés pour stocker les informations de contact des clients et des données spécifiques à l'entreprise, permettant l'intégration CRM/ERP via external\_id et des 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> - Identifiant de l'entité place<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>place_label</code> - L'attribut place_label de la table Lieux<br>- <code>latitude</code> - Traceur de localisation<br>- <code>longitude</code> - Traceur de localisation<br>- <code>rayon</code> - Taille de la géolocalisation en mètres<br>- <code>adresse</code> - L'attribut address de la table Lieux<br>- <code>description</code> - L'attribut description de la table 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>date_heure_affectation</code> - Date et heure d'affectation du point d'intérêt à l'utilisateur</td></tr><tr><td><strong>Relations</strong></td><td>Étendu avec des valeurs de champs personnalisés via <code>lieux_champs_texte</code>, <code>lieux_champs_decimaux</code>, <code>lieux_champs_grands_entiers</code>, <code>lieux_champs_long_texte</code>, <code>lieux_champs_entite_liee</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>custom_fields</code> JSONB fournit un accès rapide ; les tables associées permettent de filtrer et de trier sur des attributs personnalisés</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>points_de_zone_géographique</code></strong></summary>

**Description**: Coordonnées des sommets ordonnées (le champ numérique détermine la séquence) définissant les limites du polygone pour des formes de Zone géographique complexes, permettant des périmètres géographiques précis au-delà de 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>identifiant_zone</code> - Un ID de la zone à laquelle ce Formulaire est attaché<br>- <code>nombre</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>identifiant_zone</code> définir les limites du polygone ; <code>nombre</code> le champ détermine l’ordre des sommets</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Interroger avec <code>Trier par numéro</code> pour reconstruire le chemin du polygone ; à utiliser avec PostGIS ST_MakePolygon pour les opérations géométriques</td></tr></tbody></table>

</details>

Gestion des Mission et des workflows

<details>

<summary><strong><code>Missions</code></strong></summary>

**Description**: Affectations d’ordres de travail avec validation de l’emplacement (latitude, longitude, rayon), fenêtres temporelles (time\_from, time\_to), exigences de durée de visite (stay\_duration\_minutes, arrival\_duration\_minutes), structure hiérarchique via parent\_Mission\_id, et Suivi du statut 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>Mission_id</code> - Identifiant de l’entité Mission<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>parent_Mission_id</code> - Identifiant de l’entité Mission parente<br>- <code>Mission_label</code> - L’attribut Mission_label de la table des Missions<br>- <code>statut</code> - La valeur de l'attribut statut<br>- <code>type_de_mission</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>rayon</code> - Taille de la géolocalisation en mètres<br>- <code>date_heure_d_arrivée</code> - Lorsque le traceur arrive dans la zone de la mission. IGNORÉ lors de la création/de la mise à jour<br>- <code>created_at</code> - L'attribut created_at de la table des missions<br>- <code>date_heure_de_changement_de_statut</code> - Date et heure de la mise à jour de la mission<br>- <code>heure_de</code> - La date et l'heure associées à l'attribut heure de début<br>- <code>heure de fin</code> - La date et l'heure associées à l'attribut heure de fin<br>- <code>durée du séjour</code> - L'attribut durée du séjour de la table Missions<br>- <code>durée du séjour en minutes</code> - Durée de visite. Le temps qu'un travailleur mobile doit passer sur le site d'affectation pour réussir à terminer la Mission. Plusieurs visites sont cumulatives<br>- <code>durée d'arrivée en 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>délai maximal en minutes</code> - Retard acceptable. La durée maximale de retard autorisée pour un employé. Toute mission accomplie pendant cette période sera marquée comme « en retard »<br>- <code>is_stay_control_enabled</code> - L'attribut is_stay_control_enabled de la table des missions<br>- <code>adresse</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 des 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_Mission_id</code>; fenêtres temporelles définies par <code>heure_de</code>/<code>heure de fin</code>; validation de la Zone géographique avec la localisation et le rayon</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>formulaires</code> (collecte de données), <code>historique_de_Mission</code> (changements de statut), <code>objets</code> (traceur attribué)</td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>durée du séjour</code> et <code>durée d'arrivée en minutes</code> permettent la surveillance de conformité pour les Missions de livraison et de service</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>formulaires</code></strong></summary>

**Description**: Formulaires de collecte de données configurables pour capturer des informations structurées lors de l'achèvement d'une Mission ou des Check-in de l'application mobile, avec des champs et des valeurs stockés au format JSON, une validation facultative de l'emplacement (is\_submission\_in\_zone) et des exigences de soumission obligatoires lorsqu'ils sont rattaché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>Formulaire_id</code> - Identifiant de l'entité Formulaire<br>- <code>Mission_id</code> - Un ID de la Mission à laquelle ce Formulaire est rattaché<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>Formulaire_label</code> - Libellé de Formulaire défini par l'utilisateur<br>- <code>champs</code> - Si vrai, le Formulaire ne peut être soumis que dans la zone de la Mission<br>- <code>valeurs</code> - Une carte avec les ID de champ comme clés et les objets field_value comme valeurs. Clé utilisée pour lier le champ et sa valeur correspondante<br>- <code>soumis_le</code> - Date à laquelle les valeurs du Formulaire ont été soumises pour la dernière fois<br>- <code>latitude_de_soumission</code> - Emplacement où les valeurs du Formulaire ont été soumises pour la dernière fois<br>- <code>longitude_de_soumission</code> - Emplacement où les valeurs du Formulaire ont été soumises pour la dernière fois<br>- <code>adresse_de_soumission</code> - Emplacement où les valeurs du Formulaire ont été soumises pour la dernière fois<br>- <code>la_soumission_est_dans_la_zone</code> - Si vrai, le Formulaire ne peut être soumis que dans la zone de la Mission<br>- <code>description</code> - Date à laquelle ce Formulaire a été créé (ou attaché à la Mission)<br>- <code>created_at</code> - Date à laquelle ce Formulaire a été créé (ou attaché à la Mission)</td></tr><tr><td><strong>Contenu</strong></td><td><code>champs</code> définit la structure du Formulaire (JSON); <code>valeurs</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>objets</code> (soumissionnaire), mentionné dans <code>pointages</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Indicateur de validation de la localisation <code>la_soumission_est_dans_la_zone</code> permet des règles de soumission de Formulaire basées sur la Zone géographique</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>pointages</code></strong></summary>

**Description**: Enregistrements de présence et d'activité basés sur la localisation, soumis via l'application mobile, avec Suivi des heures d'arrivée prévues et réelles (planned\_datetime vs actual\_datetime), ainsi que des coordonnées géographiques et des mesures de précision de la localisation (rayon), pour le reporting 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é Checkin<br>- <code>employee_id</code> - L'identifiant de l'entité employé est également l'identifiant des Conducteurs<br>- <code>id_objet</code> - Appareil de l'employé<br>- <code>Formulaire_id</code> - Identifiant de l'entité Formulaire<br>- <code>user_id</code> - Utilisateur de l'employé<br>- <code>date et heure prévues</code> - Heure de l'appareil au moment de l'Enregistrement effectué<br>- <code>date et heure réelles</code> - Heure du serveur au moment du traitement de la requête/message<br>- <code>latitude</code> - Lieu où les enregistrements ont été soumis<br>- <code>longitude</code> - Lieu où les enregistrements ont été soumis<br>- <code>rayon</code> - Erreur de positionnement à un point, en mètres<br>- <code>adresse</code> - Adresse d'enregistrement<br>- <code>commentaire</code> - L'attribut commentaire de la table des enregistrements</td></tr><tr><td><strong>Relations</strong></td><td>Relie les employés aux formulaires et aux emplacements ; suit l'écart par rapport au planning prévu</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Écart de temps entre <code>date et heure prévues</code> et <code>date et heure réelles</code> permet le reporting de ponctualité ; le rayon définit la tolérance de localisation acceptable</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>historique_de_Mission</code></strong></summary>

**Description**: journal d’audit complet des événements du cycle de vie des missions capturant tous les changements de statut, affectations, mises à jour et modifications de champs avec horodatages (event\_datetime), attribution utilisateur et types d’activité (create, update, assign, status\_change) stockés dans le champ payload pour la conformité et l’analyse du 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>mission_history_id</code> - Identifiant de l’entité d’historique de mission<br>- <code>Mission_id</code> - Identifiant de l’entité Mission<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>activité</code> - Opération qui s’est produite. Peut être "create", "update", "assign" ou "status_change"<br>- <code>date_heure_evenement</code> - Date et heure de l’événement<br>- <code>charge utile</code> - Dépend de l’opération. Contient généralement les champs qui ont été modifiés pendant l’opération</td></tr><tr><td><strong>Contenu</strong></td><td>Types d'activité définis dans <code>paramètres de description</code>; <code>charge utile</code> stocke les détails spécifiques à l'événement (texte)</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Essentiel pour l'analyse de l'achèvement de Mission, le reporting des transitions de statut et le Suivi de l'activité des utilisateurs</td></tr></tbody></table>

</details>

Règles et automatisation

<details>

<summary><strong><code>règles</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 Zone géographique, seuils de capteurs, temps d'inactivité) stockées dans les paramètres (JSONB), et des 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 de l'appareil 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>ID de règle</code> - Identifiant de l'entité règle<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>identifiant_client</code> - Identifiant de l'entité client<br>- <code>Type d'événement</code> - L'attribut event_type de la table rules<br>- <code>libellé d'événement</code> - L'attribut event_label de la table des règles<br>- <code>event_groupe</code> - L’attribut event_group de la table des règles<br>- <code>description</code> - Attribut de description du tableau des règles<br>- <code>paramètres</code> - Paramètres d'événement. Pour plus de détails sur les paramètres disponibles, voir <a href="https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/rules/rule_types/">Documentation de l’API Navixy</a>.<br>- <code>e-mail d’alerte</code> - E-mail pour les notifications<br>- <code>alerte_sms</code> - Numéros de téléphone pour les notifications SMS<br>- <code>téléphone_alerte</code> - Téléphones pour les appels vocaux<br>- <code>push_activé</code> - Si vrai, les notifications push sont disponibles<br>- <code>created_at</code> - L'attribut created_at de la table rules<br>- <code>est_supprimé</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 temps d'inactivité avec le moteur en marche, en minutes<br>- <code>event_comment1</code> - L'attribut event_comment1 de la table des règles<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 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</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers des objets via <code>rules2objects</code>, zones via <code>rules2zones</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>Type d'événement</code> définit un scénario de surveillance spécifique (excès de vitesse, violation de Zone géographique, seuil du capteur); <code>maximum</code> Le champ permet l’agrégation des événements pour des alertes basées sur des seuils</td></tr></tbody></table>

</details>

<details>

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

**Description**: Règles de liaison de relation plusieurs-à-plusieurs entre objets surveillés avec personnalisation des paramètres par objet via object\_params (JSONB), permettant des valeurs de seuil différentes (par ex. des limites de vitesse) pour chaque véhicule ou Actif au sein de la 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>ID de règle</code> - Identifiant de l'entité règle<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>param_Groupe_numéro</code> - L’attribut param_group_number de la table rules2objects<br>- <code>Traceur_params</code> - L’attribut object_params de la table rules2objects</td></tr><tr><td><strong>Contenu</strong></td><td><code>Traceur_params</code> (JSONB) permet la personnalisation des règles par Traceur (par ex. différentes limites de vitesse par véhicule)</td></tr><tr><td><strong>Notes spéciales</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é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 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>ID de règle</code> - Identifiant de l'entité règle<br>- <code>identifiant_zone</code> - Identifiant de l'entité de zone</td></tr><tr><td><strong>Notes spéciales</strong></td><td>La relation plusieurs-à-plusieurs permet une surveillance multi-zone pour une seule règle (par exemple, alerte lors de l’entrée dans l’une de plusieurs zones restreintes)</td></tr></tbody></table>

</details>

Statut et catégorisation

<details>

<summary><strong><code>statuts</code></strong></summary>

**Description**: Définitions de statuts personnalisés dans les listes de statuts, y compris les propriétés d'affichage (couleur pour l'affichage sur le site web, order\_sort pour le positionnement) utilisées pour représenter les états de travail d'un appareil ou d'un employé, avec prise en charge de la suppression souple 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>identifiant_du_statut</code> - Identifiant d'entité du statut<br>- <code>identifiant_de_liste</code> - Identifiant de l'entité de la liste<br>- <code>libellé_du_statut</code> - Valeur de statut de l'attribut status_label<br>- <code>couleur</code> - Couleur utilisée pour l'affichage sur le site web<br>- <code>order_sort</code> - Position de tri au sein du statut de la liste<br>- <code>est_supprimé</code> - L'attribut is_deleted de la table statuses</td></tr><tr><td><strong>Relations</strong></td><td>Groupes de statuts organisés par <code>identifiant_de_liste</code> (références <code>status_listings</code>); utilisé dans <code>status_history</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>order_sort</code> définit la séquence 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 contrôlant quelles valeurs de statut sont 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>identifiant_de_liste_de_statut</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 d'état de l'attribut status_listing_label<br>- <code>is_supervisor_controlled</code> - Si c'est vrai, les superviseurs peuvent modifier le statut de travail, par exemple à l'aide d'une application de surveillance mobile<br>- <code>is_employee_controlled</code> - Si c'est vrai, les employés peuvent modifier leur propre statut de travail, par exemple à l'aide d'une application mobile de Suivi<br>- <code>est_supprimé</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>Notes spéciales</strong></td><td>Les indicateurs de contrôle déterminent qui peut modifier les statuts : superviseur uniquement, libre-service par l'employé, ou les deux</td></tr></tbody></table>

</details>

<details>

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

**Description**: Piste d'audit de toutes les transitions de Rapport du matériel 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 le reporting des 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>identifiant_historique_statut</code> - Identifiant de l'entité de l'historique du statut<br>- <code>ID de l'appareil</code> - Identifiant de l’entité de l’appareil<br>- <code>identifiant_ancien_statut</code> - Identifiant de l'entité de l'ancien statut<br>- <code>identifiant_nouveau_statut</code> - Identifiant de l'entité du nouveau statut<br>- <code>mis_à_jour_par</code> - La date et l'heure associées à l'attribut mis_à_jour_par<br>- <code>date_heure_modification</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 du 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>adresse</code> - Localisation des appareils lors des changements de statut</td></tr><tr><td><strong>Relations</strong></td><td>Liens vers <code>appareils</code>, <code>statuts</code> (ancien et nouveau), <code>paramètres de description</code> (pour <code>mis_à_jour_par</code> Modèle d'accès)</td></tr><tr><td><strong>Notes spéciales</strong></td><td>La capture de la localisation permet l’analyse géographique des transitions de statut ; utile pour la génération de rapports de localisation de début/fin de journée de travail</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Mots clés</code></strong></summary>

**Description**: Étiquettes de catégorisation définies par l’utilisateur, avec codage couleur, qui permettent un filtrage et une recherche rapides sur plusieurs types d’entités (Lieux, géofences, employés, Missions, traqueurs, 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>id_mot_clé</code> - Mots clés d’ID d’entité<br>- <code>user_id</code> - Identifiant de l'entité utilisateur<br>- <code>libellé_mot_clé</code> - L’attribut libellé_mot_clé de la table des Mots clés<br>- <code>couleur</code> - L’attribut couleur de la table des Mots clés</td></tr><tr><td><strong>Relations</strong></td><td>Appliqué aux entités via <code>liens_mots_clés</code>; portée définie par l’utilisateur</td></tr><tr><td><strong>Notes spéciales</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>liens_mots_clés</code></strong></summary>

**Description**: Table de relations polymorphes associant des Mots clés à tout type d’entité via type\_entité et id\_entité, avec un champ ordinal pour la gestion de l’ordre d’affichage, permettant un étiquetage flexible de 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>id_mot_clé</code> - Mots clés d’ID d’entité<br>- <code>type d'entité</code> - L’attribut entity_type de la table tag_links<br>- <code>ID de l'entité</code> - Identifiant d'entité<br>- <code>ordinal</code> - L’attribut ordinal de la table Mots clés_links</td></tr><tr><td><strong>Contenu</strong></td><td><code>type d'entité</code> identifie la table (véhicule, employé, Mission, etc.) ; <code>ordinal</code> définit l'ordre d'affichage</td></tr><tr><td><strong>Notes spéciales</strong></td><td>La relation polymorphe permet d’ajouter des tags à différents types d’entités</td></tr></tbody></table>

</details>

Groupes et hiérarchie

<details>

<summary><strong><code>groupes</code></strong></summary>

**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 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>groupe_id</code> - Groupe de suivi (lié par objects.group_id). La division en groupes peut être vue dans la liste des balises, par exemple<br>- <code>identifiant_client</code> - Identifiant de l'entité client<br>- <code>étiquette_de_groupe</code> - Titre de groupe défini par l’utilisateur, de 1 à 60 caractères imprimables, par ex. « Employees »<br>- <code>Groupe_couleur</code> - Couleur du Groupe au format web (sans #), par ex. « FF6DDC ». Détermine la couleur des marqueurs de suivi sur la carte</td></tr><tr><td><strong>Relations</strong></td><td>Référencé par <code>objets.id_groupe</code>; propriété du client via <code>identifiant_client</code> (références <code>utilisateurs</code>)</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Permet une organisation de type dossier des entités de surveillance pour les rapports et les autorisations</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>groupes_objets</code></strong></summary>

**Description**: Relation plusieurs-à-plusieurs entre le Groupe et les objets utilisant une clé primaire composite (groups\_client\_id, objects\_client\_id), permettant aux objets d'appartenir simultanément à plusieurs groupes pour des structures organisationnelles flexibles

<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>groupes_client_id</code> - Identifiant de l'entité client pour les groupes<br>- <code>objets_client_id</code> - Identifiant de l'entité client pour les objets</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Permet aux objets d'appartenir simultanément à plusieurs groupes ; interroger avec les deux <code>identifiant_client</code> valeurs pour l'appartenance au groupe</td></tr></tbody></table>

</details>

Champs personnalisés et entités

<details>

<summary><strong><code>entités</code></strong></summary>

**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 des champs (sections, field\_order) stockée dans entity\_label (JSONB), permettant une extension dynamique du schéma à travers Lieux, Missions et d’autres entités sans modifications de 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>ID de l'entité</code> - Identifiant d'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 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 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>Notes spéciales</strong></td><td><code>builtin_type</code> liens vers <code>paramètres de description</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 de Champs personnalisés permettant l’extension dynamique du schéma pour les types d’entités, avec des types de champs configurables (custom\_field\_type), des règles de validation et des options dans parameters (JSONB), ainsi que des indicateurs d’obligation (is\_required) pour une capture de données flexible à travers Lieux, 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>ID de l'entité</code> - Identifiant d'entité<br>- <code>libellé_du_champ_personnalisé</code> - Nom du champ<br>- <code>type_de_champ_personnalisé</code> - Type de données dans le champ<br>- <code>description</code> - Description du champ<br>- <code>est_obligatoire</code> - Est-ce obligatoire ou non ?<br>- <code>paramètres</code> - Paramètres du champ</td></tr><tr><td><strong>Contenu</strong></td><td><code>paramètres</code> (JSONB) stocke la configuration spécifique 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>paramètres de description</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Permet l’extension dynamique du schéma sans modifications de la base de données ; utilisé de manière intensive dans <code>Lieux</code> et <code>Missions</code></td></tr></tbody></table>

</details>

Suivi historique

<details>

<summary><strong><code>historique_du_Conducteur</code></strong></summary>

**Description**: Piste d’audit complète des affectations employé-Véhicules au fil du temps, suivant les transitions de old\_employee\_id vers new\_employee\_id avec des horodatages (changed\_datetime, server\_datetime), des données de localisation (latitude, longitude, address), des informations sur la clé matérielle et l’attribution utilisateur (updated\_by), permettant des analyses spécifiques aux Conducteurs lorsque les Conducteurs passent entre différents Véhicules

<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>Conducteur_history_id</code> - Identifiant de l’entité d’historique du Conducteur<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>old_employee_id</code> - Identifiant de l’entité de l’ancien employé<br>- <code>new_employee_id</code> - Identifiant de l’entité du nouvel employé<br>- <code>clé_matérielle</code> - L’attribut hardware_key de la table driver_history<br>- <code>date_heure_modification</code> - Des modifications de la date et de l'heure ont été apportées à l'appareil<br>- <code>server_datetime</code> - Date et heure des modifications apportées sur le serveur<br>- <code>mis_à_jour_par</code> - La date et l'heure associées à l'attribut mis_à_jour_par<br>- <code>latitude</code> - L'attribut de latitude de la table Conducteur_history<br>- <code>longitude</code> - L'attribut de longitude de la table Conducteur_history<br>- <code>adresse</code> - L’attribut d’adresse de la table driver_history</td></tr><tr><td><strong>Relations</strong></td><td>Suit les affectations du Conducteur aux Véhicules au fil du temps ; relie à <code>employés</code> et <code>objets</code></td></tr><tr><td><strong>Notes spéciales</strong></td><td>Essentiel pour le reporting spécifique au Conducteur lorsque les Conducteurs changent de Véhicules ; la capture de la localisation permet l’analyse de la localisation du changement d’affectation</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>historique_des_traceurs_de_véhicule</code></strong></summary>

**Description**: Piste d'audit de Suivi indiquant quels appareils GPS (Traceur\_id) ont été installés dans quels Véhicules (vehicle\_id) au fil du temps avec les horodatages des modifications (changed\_datetime), permettant une attribution historique précise des données et le calcul du kilometrage lorsque les traceurs sont déplacés entre les Véhicules

<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>identifiant_de_l_historique_du_suivi_du_véhicule</code> - Identifiant de l’entité d’historique du traceur de véhicule<br>- <code>ID du véhicule</code> - Identifiant de l'entité véhicule<br>- <code>id_objet</code> - objet identifiant d’entité<br>- <code>date_heure_modification</code> - La date et l’heure associées à l’attribut changed_datetime</td></tr><tr><td><strong>Relations</strong></td><td>Indique quel appareil GPS a été installé dans quel véhicule au fil du temps</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Essentiel pour l’analyse des données historiques lorsque les traceurs sont déplacés d’un véhicule à l’autre ; permet une attribution précise du kilometrage et de l’utilisation</td></tr></tbody></table>

</details>

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

<details>

<summary><strong><code>paramètres de description</code></strong></summary>

**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 de type (p. ex. statut\_de\_Mission, type\_de\_Carburant, type\_de\_compteur, classification\_d’entité) pour 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>clé</code> - Valeur possible dans l’attribut<br>- <code>type</code> - Un attribut composite consistant en le nom de la table suivi d’un trait de soulignement et du nom d’un attribut dans 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 de Mission, types de Carburant, types de compteurs, etc.)</td></tr><tr><td><strong>Relations</strong></td><td>Référencé via des clés étrangères depuis plusieurs tables pour une catégorisation standardisée</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Essentiel pour traduire les codes entiers en valeurs lisibles dans les Rapports ; <code>type</code> Groupes de champs et énumérations associées</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>compteurs</code></strong></summary>

**Description**: Configurations du Compteur kilométrique et du compteur d'heures moteur reliant les relevés de capteurs de l'appareil (sensor\_id) aux mesures de distance ou de temps avec des coefficients multiplicateurs pour la conversion d'unités (km, miles, heures) et counter\_type à partir de description\_parameters définissant 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> - Identifiant interne<br>- <code>ID de l'appareil</code> - Identifiant de l’entité de l’appareil<br>- <code>counter_type</code> - Type de compteur<br>- <code>identifiant_capteur</code> - Identifiant de l'entité capteur<br>- <code>multiplicateur</code> - Coefficient de conversion des valeurs vers l'une des unités (km, l, etc.)</td></tr><tr><td><strong>Relations</strong></td><td>Lie les appareils aux relevés de capteurs qui représentent des compteurs de distance ou de temps</td></tr><tr><td><strong>Notes spéciales</strong></td><td><code>multiplicateur</code> convertit les impulsions du capteur en unités réelles (km, miles, heures) ; <code>counter_type</code> de <code>paramètres de description</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 pour les canaux de sortie de l'appareil, reliant les identifiants numériques de sortie (number) aux noms définis par l'utilisateur (label) tels que "Verrouillage de porte" ou "Bloc moteur" pour des Rapports et des analyses lisibles des Commandes et des é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>ID de l'appareil</code> - Identifiant de l’entité de l’appareil<br>- <code>nombre</code> - L'attribut number de la table device_output_name<br>- <code>libellé</code> - L'attribut libellé de la table device_output_name</td></tr><tr><td><strong>Contenu</strong></td><td>Associe les numéros des canaux de sortie aux noms définis par l'utilisateur (p. ex. "Verrouillage de porte", "Bloc moteur")</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Permet 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 spécifique.

<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>ID de l'appareil</code> - Identifiant de l’entité de l’appareil<br>- <code>clé</code> - Nom du paramètre<br>- <code>valeur</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>Notes spéciales</strong></td><td>Renseigné lors de la synchronisation complète du client. Utilisez cette table pour lire les valeurs de configuration au niveau de l'appareil en parallèle des 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énements du traceur avec des descriptions lisibles par l'humain. Contient 134 entrées couvrant des événements de traceur courants tels que SOS, Mode "veille", Contact et les changements d'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 d'événement lisible par l'humain</td></tr><tr><td><strong>Notes spéciales</strong></td><td>Joindre à <code>raw_telematics_data.suivi_data_core</code> sur <code>event_id</code> pour afficher les noms d'é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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.