Glossaire

Référence rapide des termes spécifiques à Aptli utilisés sur l'ensemble de la plateforme et dans ce guide.

Données et enregistrements

Modèle versionné

Enregistrements qui suivent un cycle brouillon → diff → validation avant que les modifications ne deviennent définitives. Les enregistrements versionnés prennent en charge l’édition hors ligne, les fonctions annuler/rétablir, la détection des conflits et un historique complet des versions. Dans Aptli, les entités cartographiques (points, chaînes de points, polygones, couches, schémas) et les tâches utilisent le modèle versionné.

À distinguer du : modèle en temps réel

Modèle en temps réel

Enregistrements enregistrés immédiatement sur le serveur sans étape intermédiaire. Les modifications sont visibles instantanément par tous les utilisateurs. Les ordres de travail, les rapports, les validations, les transactions et les sites utilisent le modèle en temps réel.

À distinguer de : Modèle versionné

Brouillon

Ensemble de modifications locales apportées à des enregistrements versionnés qui n’ont pas encore été validées sur le serveur. Les brouillons sont stockés dans le navigateur et persistent lors des actualisations de page, même sans accès au réseau. Un utilisateur peut avoir un seul brouillon actif par version. Les brouillons peuvent être téléchargés sur le serveur pour être examinés par un administrateur avant leur mise en production.

Validation

Action consistant à appliquer de manière permanente les modifications d’un brouillon à l’ensemble de données en production. Les validations créent une nouvelle entrée immuable dans l’historique des versions. Seuls les utilisateurs disposant du droit d’administration allowCommits peuvent effectuer des validations.

Conflit de versions

Se produit lorsque deux utilisateurs ont modifié la même entité dans des brouillons hors ligne distincts. Aptli détecte les conflits lors de la validation en comparant la version de base à partir de laquelle chaque brouillon a été créé avec la version active actuelle. Les validations en conflit sont signalées pour examen par l’administrateur et ne peuvent être appliquées tant qu’elles ne sont pas résolues — aucune écrasement silencieux n’est autorisé.

Inventaire

Ressource

Définition d’un matériau, d’un consommable, d’un type d’équipement ou d’une catégorie de main-d’œuvre. Les ressources définissent leurs unités de mesure et leur politique de retrait, et constituent ce qu’un chantier consomme. Le travail effectué sur les ressources est répertorié séparément en tant qu’activité. Exemples : 500 m de câble à fibre optique, boulon d’ancrage en béton, heure de travail de l’équipe d’installation.

Activité

Définition d’un type de travail effectué par une équipe — épissure, tirage de câble, excavation, inspection. Les activités sont le pendant « côté travail » des ressources : un registre autonome avec ses propres unités de mesure (§193), référencé par une ligne d’activité d’un ordre de travail, soit sélectionnée dans le catalogue, soit saisie de manière ponctuelle. Facultatif — un ordre de travail n’est pas tenu d’en mentionner une. Exemples : épissure par fusion, tirage de fibre (m), forage directionnel (m). Gérées sous Administration → Activités (activitiesCreate / activitiesUpdate / activitiesDelete).

Article en stock

Le solde actuel d’une ressource spécifique sur un site spécifique. Les articles en stock sont mis à jour exclusivement par des transactions — ils ne sont jamais modifiés directement. Une ressource peut avoir des articles en stock sur plusieurs sites simultanément.

Site

Emplacement physique ou logique où est stocké le matériel. Les sites comprennent les entrepôts, les parcs de stockage, les dépôts de terrain, les « sites personnels » des travailleurs et les véhicules. Chaque utilisateur peut disposer d’un site personnel qui reçoit du matériel via des scans de codes-barres lors des enlèvements.

Transaction

Une écriture comptable immuable enregistrant chaque mouvement de stock. Les transactions ne peuvent être ni modifiées ni supprimées — les corrections s’effectuent toujours en créant une nouvelle transaction d’ajustement. Types de transactions :

Code de retrait

Code QR à durée limitée et inviolable, émis lors de l’attribution d’un ordre de travail. Les intervenants sur le terrain scannent le code de retrait dans un entrepôt pour valider et réceptionner les matériaux qui leur sont attribués. Les codes de retrait contiennent les quantités de ressources autorisées, l’affectation à laquelle ils se rapportent et une date d’expiration. Seul le collaborateur désigné — ou un utilisateur disposant du droit canFacilitatePickups — peut les scanner.

Code de transfert

Code QR inviolable qui autorise un transfert de stock de pair à pair entre sites. Contrairement aux codes de retrait, les codes de transfert ne sont pas liés à un ordre de travail. Ils peuvent être générés pour tout mouvement de site à site et scannés par le destinataire afin d’exécuter le transfert et d’enregistrer automatiquement la transaction.

Ressource en attente

Une désignation temporaire de « mise en attente » utilisée lors de la réception d’un envoi contenant des articles qui n’existent pas encore dans le catalogue de ressources. Le personnel de terrain enregistre l’envoi dans la ressource de mise en attente afin de ne pas bloquer le travail ; le personnel administratif reclassifie ensuite le stock vers la ressource appropriée une fois celle-ci définie. Cela évite l’impasse du type « Je ne peux pas réceptionner cet article car il n’est pas dans le système ».

Politique de retrait

Paramètre unique de niveau de contrôle sur une ressource qui détermine qui peut la distribuer ou la retirer, dans chaque flux (retrait de commande, libre-service, transfert). L’une des trois valeurs suivantes :

Retrait facilité

Comportement d’une ressource dont la politique de retrait est définie sur facilité. Un collaborateur ne peut pas la retirer lui-même ; c’est le personnel de l’entrepôt (titulaire du droit canFacilitatePickups) qui effectue le retrait pour le compte du collaborateur en sa présence. La transaction enregistre les deux parties ainsi que la méthode de scan utilisée.

Exécution des travaux

Tâche

Unité de travail planifiée associée à une localisation géospatiale, avec des besoins en ressources facultatifs. Les tâches sont gérées par versions — elles passent par les étapes « brouillon » → « validation », à l’instar des entités cartographiques. Une mission peut être localisée en un point (un regard), sur une ligne (un tronçon de route), dans un polygone (un lotissement), ou ne pas être localisée du tout s’il s’agit d’un travail administratif. Les missions appartiennent à des projets et sont exécutées via des ordres de travail ; le travail effectué est consigné dans la ligne d’activité de l’ordre de travail.

Ordre de travail

Attribution d’une tâche à une équipe, avec une date d’échéance, une ligne d’activité facultative (le travail à effectuer) et un code de retrait facultatif pour les matériaux. Les ordres de travail suivent leur statut (en attente → en cours → terminé) en temps réel. Également appelé affectation.

Affectation

Terme utilisé de manière interchangeable avec Ordre de travail dans l’ensemble d’Aptli. Certaines interfaces utilisateur continuent d’utiliser le terme « affectation », mais l’enregistrement sous-jacent et ses droits d’administration sont nommés ordre de travail (workOrdersCreate, workOrdersUpdate, workOrdersDelete). Ils désignent la même chose.

Rapport

Compte rendu du travail effectué par un intervenant sur le terrain. Les rapports consignent les tâches réalisées, la localisation GPS, les ressources effectivement consommées et des photos. Les rapports peuvent être soumis dans le cadre d’une mission formelle ou de manière ponctuelle pour des interventions de maintenance imprévues. La soumission d’un rapport déclenche des déductions automatiques des stocks et en informe les superviseurs.

Validation

Examen de contrôle qualité effectué par un superviseur sur un rapport soumis. Les validations consignent le résultat (réussite / échec / à réviser / approuvé avec remarques) ainsi que toute observation. Une validation ayant abouti à un échec ou à une demande de révision renvoie le rapport à l’intervenant ; une validation approuvée peut déclencher les calculs de déblocage du paiement.

Projet

Un ensemble de missions liées entre elles, partageant une même date d’échéance et une même affectation d’équipe. Les projets offrent une vue d’ensemble de l’avancement de toutes leurs missions et de tous leurs rapports.

Sécurité et accès

Droits d’administrateur

Des autorisations permissives qui contrôlent ce qu’un utilisateur peut faire. Aptli propose des droits d’administrateur granulaires couvrant toutes les actions de création, de lecture, de mise à jour et de suppression dans le système. Exemples : workOrdersCreate, reportsDelete, allowCommits, canFacilitatePickups, auditView. Les droits d’administrateur sont cumulatifs : un utilisateur ne disposant d’aucun droit ne peut consulter que ses propres missions.

Restrictions liées aux rôles

Des filtres restrictifs au niveau des champs qui contrôlent les données qu’un utilisateur ne peut pas voir. Les restrictions de rôle sont appliquées côté serveur : les données non autorisées ne sont jamais envoyées au client, elles ne sont pas simplement masquées dans l’interface utilisateur. Exemple : une restriction sur assignedTo = currentUser limite un prestataire à ne voir que ses propres ordres de travail. Les restrictions de rôle et les droits d’administration fonctionnent comme deux couches indépendantes.

Demande d’accès

Compte en attente créé lorsqu’une personne s’inscrit de manière autonome via la page de connexion. Les demandes d’accès restent en attente dans Admin → Demandes d’accès jusqu’à ce qu’un administrateur les approuve ou les refuse. En cas d’approbation, le compte devient un compte d’utilisateur standard ; en cas de refus, la demande est supprimée de manière temporaire.

Session active unique

Le modèle de session d’Aptli autorise une seule connexion active par compte sur tous les appareils à tout moment. Se connecter sur un nouvel appareil met fin à la session précédente ; l’appareil déconnecté affiche un message d’avertissement unique et est redirigé vers la page de connexion. Deux onglets d’un même profil de navigateur partagent une session et ne se déconnectent pas mutuellement.

Verrouillage définitif

État d’un compte empêchant toute connexion, quelle que soit la méthode utilisée. Déclenché automatiquement après des tentatives de connexion infructueuses répétées (par défaut : 10 échecs consécutifs) ou activé manuellement par un administrateur. Ne peut être désactivé que par un administrateur disposant du droit usersUpdate.

Mode maintenance

Mode activé par un administrateur qui bloque les écritures des utilisateurs non administrateurs et affiche une bannière à tous les utilisateurs. Destiné à de brèves périodes pendant lesquelles une migration ou une tâche batch est en cours d’exécution et où les écritures des utilisateurs risqueraient d’interférer avec les opérations courantes. Les administrateurs conservent un accès complet.

Journal d’audit

Un journal à ajout seul répertoriant les actions significatives sur l’ensemble du déploiement : connexions, créations et modifications d’enregistrements, téléchargements de fichiers, transitions de statut, attributions de droits d’administrateur. Visible en détail pour chaque enregistrement dans la chronologie intégrée aux pages de détail, et globalement sous Admin → Historique d’audit (nécessite auditView). Exportable au format CSV pour un examen externe (nécessite auditExport).

Archivé (suppression temporaire)

Enregistrement marqué comme supprimé mais conservé physiquement. Les enregistrements archivés sont masqués dans les listes et requêtes normales ; les utilisateurs disposant du droit viewDeleted peuvent les afficher et les restaurer si nécessaire. Aptli procède rarement à des suppressions définitives — l’archivage préserve l’historique d’audit et l’historique opérationnel.

Cartes et SIG

Couche

Ensemble nommé d’éléments cartographiques partageant un type de géométrie (points, chaînes de points ou polygones) et un style visuel (icône, couleur, épaisseur de trait). Les couches définissent ce qu’un élément est — par exemple, une couche « Poteaux téléphoniques » ou une couche « Tracés de conduits ». Les couches sont gérées par versions.

Schéma

Diagramme de relations modélisant les connexions entre des éléments cartographiques ou des objets abstraits. Les schémas utilisent un éditeur de graphes (nœuds et arêtes orientées) pour représenter la topologie d’un réseau, le tracé des câbles, le remplissage des conduits ou toute autre relation difficile à exprimer sur une carte géographique seule. Les schémas sont gérés par versions.

Espace de travail de dessin

Zone d’édition temporaire où la géométrie est dessinée et affinée avant d’être validée en tant qu’éléments cartographiques permanents. L’espace de travail de dessin permet de vérifier les modifications complexes — dessin à main levée, accrochage, opérations sur plusieurs éléments — avant leur mise en ligne.

Enregistrements de terrain

Nom de la surface cartographique dans la navigation d’Aptli — où les entités géographiques sont hébergées, dessinées, modifiées et tracées. (Les outils de la carte s’ouvrent sous forme de fenêtres à partir de sa barre d’outils.)

Fenêtre

Panneau flottant et déplaçable ouvert depuis la barre d’outils de la carte. Chaque fenêtre active un outil : Entités sélectionnées, Recherche, Transfert de données et Gestionnaire de couches sont toujours présents ; Projets, Relations entre couches et Générateur apparaissent lorsque leur fonctionnalité est disponible sous licence. Une fenêtre peut être détachée dans une fenêtre de navigateur distincte pour permettre le travail sur plusieurs écrans.

Lentille d’exécution

Une superposition cartographique qui recolore les éléments existants en fonction de leur statut de travail dérivé, afin que l’état d’une zone soit lisible d’un seul coup d’œil. Plusieurs peuvent être actives simultanément. Les filtres disponibles sont Progression, Mes ordres de travail, À valider, En échec, Validé, À réviser, Approuvé avec remarques et Non attribué. À activer depuis Gestionnaire de couches → Superpositions.

Lentille de présence

Un complément aux lentilles d’exécution qui met en évidence les entités associées à un type particulier d’enregistrement : A une mission, A un schéma, A un site.

Recherche universelle

La palette de commandes à l’échelle de l’application, accessible via Cmd/Ctrl-K depuis n’importe quelle page. Elle effectue une recherche de vos enregistrements dans toute l’application et vous redirige vers un résultat. Elle se distingue de la fenêtre Recherche de la carte, qui localise les entités et vous y achemine directement.

Travailler depuis un appareil

Le commutateur « Lire depuis la source » (anciennement « Mode hors ligne ») qui fait en sorte que les pages de liste et la carte s’affichent à partir d’une copie locale sur l’appareil plutôt que depuis le serveur en ligne, ce qui vous permet de continuer à travailler sans connexion. À associer à la sauvegarde automatique sur l’appareil (la cadence d’écriture locale) et au Gestionnaire de versions. Voir Gestion des versions.

Automatisations et surveillance

Hook

Une destination sortante signée, abonnée aux événements de votre choix : fournissez-lui une URL et une clé de signature, et chaque événement correspondant y sera envoyé via une requête POST. L’intégration sortante la plus simple. Voir Automatisations et surveillance.

Déclencheur d’événement

Une règle d’automatisation suivant un modèle déclencheur → conditions → actions : lorsqu’un événement se produit et que les conditions sont remplies, une ou plusieurs actions sont exécutées (notification, création d’un ordre de travail, appel d’un webhook, écriture dans Postgres, etc.).

Connecteur d’ingestion

Une source de données externe qui transmet les relevés de capteurs/appareils à Aptli — soit en pull (Aptli interroge l’API d’un fournisseur selon une fréquence définie), soit en push (l’expéditeur envoie une requête POST vers un point de terminaison du connecteur à l’aide d’une clé API d’ingestion).

Station

Une entité cartographique par rapport à laquelle un capteur transmet ses données. Une fois les relevés reçus, la fiche de l’entité affiche la dernière valeur de chaque indicateur ainsi qu’un graphique sparkline sur 7 jours.

Alarme

Un enregistrement déclenché lorsqu’une mesure surveillée dépasse un seuil (avec hystérésis, afin d’éviter les fluctuations intempestives) ou lorsqu’une source cesse d’émettre (détection de capteur hors service). Les alarmes passent par les états Active → Acquittée → Résolue, notifient les destinataires et peuvent s’escalader vers un deuxième niveau si elles ne sont pas acquittées à temps.

Résultat

Dans le cadre d’un projet, un graphique représentant l’évolution des séries de métriques surveillées par rapport aux jalons de travail achevé — les valeurs sont présentées à côté des tâches susceptibles de les avoir influencées (corrélation à titre de contexte, et non affirmation de causalité). Peut être publié sous forme de lien de partage en lecture seule et révocable.

Quota de connexion

Le compteur commercial pour les automatisations : chaque connecteur d’ingestion, clé API et hook réutilisable consomme une unité provenant d’un pool partagé (les règles internes de déclenchement d’événements ne sont pas comptabilisées). Les automatisations elles-mêmes sont incluses dans tous les forfaits.

Réception publique (portail de services)

Soumission

Enregistrement créé lorsqu’un membre du public dépose une demande via un portail de services public — aucune connexion requise. Il comporte un numéro de référence public, une géométrie facultative et des pièces jointes. Le personnel procède à son tri et peut le convertir en ordre de travail, en rapport ou en élément cartographique.

Numéro de référence

Code court et partageable reçu par l’auteur de la demande. Il ne contient aucun identifiant interne et constitue le moyen durable de suivre ou de répondre à une demande — et, sur l’appareil de l’auteur, de répertorier toutes ses demandes (« Mes demandes »).

Transfert pour suivi

Transfert d’une soumission vers un système externe sous la forme d’un transfert unidirectionnel simple, accompagné d’un lien de rappel à usage unique et à durée limitée afin que le système externe puisse renvoyer son résultat une seule fois. Ne modifie pas le statut de la soumission ; s’affiche comme Transféré → En attente de réponse → Répondu (ou Expiré / Révoqué).

Répondre pour agir

Envoi d’un ordre de travail par e-mail ou SMS afin que le destinataire puisse remplir le rapport d’achèvement en répondant au message — sans connexion. Les liens de réponse sont à usage unique et expirent.

Collaboration et durabilité

Session multijoueur

Une session de co-édition en direct et en temps réel (module complémentaire de co-conception) identifiée par un code à 6 chiffres : deux personnes ou plus modifient ensemble la même carte ou le même enregistrement avec des curseurs visibles, et l’hôte valide le résultat convenu dans la branche principale. Voir Multijoueur.

Ressource de commande / Profil d’émissions

La fonctionnalité de l’extension Carbon (sur la fiche d’un élément de carte) qui associe un profil d’émissions — reliant l’élément à ce qu’il consomme à un certain rythme — afin que son empreinte carbone soit suivie par rapport à des facteurs d’émission standard. Voir Carbon.

Jeton de débit

Un petit compteur intégré à l’application indiquant à quel point vous vous rapprochez de la limite de débit de requêtes — orange lorsque vous vous en approchez, rouge lorsque vous atteignez le plafond, avec un état « Rattrapage en cours… » lorsque l’application espace délibérément les requêtes. À titre informatif ; cela permet de préserver la réactivité en cas d’utilisation intensive.