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é

Les enregistrements 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 de : Modèle en temps réel

Modèle en temps réel

Enregistrements qui sont immédiatement sauvegardés 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 brouillon actif par version. Les brouillons peuvent être téléchargés sur le serveur pour être examinés par l'administrateur avant leur mise en ligne.

Validation

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

Conflit de version

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 l'unité de mesure, les conversions d'unités facultatives et si le retrait de la ressource nécessite un facilitateur. Exemples : 500 m de câble à fibre optique, boulon d'ancrage en béton, heure de travail de l'équipe d'installation.

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 retrait par QR code.

Transaction

Enregistrement comptable immuable consignant 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 d'enlèvement

Un code QR à durée limitée et inviolable émis lorsqu'un ordre de travail est attribué. Les travailleurs sur le terrain scannent le code d'enlèvement dans un entrepôt pour autoriser et recevoir les matériaux qui leur sont attribués. Les codes d'enlèvement contiennent les quantités de ressources autorisées, l'affectation à laquelle ils appartiennent et une date d'expiration. Seul le travailleur désigné — ou un utilisateur disposant du droit canFacilitatePickups — peut les scanner.

Code de transfert

Un 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 pour exécuter le transfert et 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 des ressources. Le personnel de terrain accepte l'envoi dans la ressource en attente afin que le travail ne soit pas bloqué ; le personnel administratif reclassifie ensuite le stock vers une ressource appropriée une fois celle-ci définie. Cela évite l'impasse du type « Je ne peux pas réceptionner cela car ce n'est pas dans le système ».

Enlèvement facilité

Enlèvement effectué au nom d'un travailleur par le personnel de l'entrepôt (généralement parce que la ressource est marquée comme nécessitant une supervision). Le personnel scanne le code QR de l'affectation du travailleur en présence de ce dernier ; la transaction enregistre les deux parties ainsi que la méthode de scan utilisée. Nécessite le droit canFacilitatePickups.

Exécution des tâches

Tâche

Unité de travail planifiée géolocalisée avec des besoins en ressources définis. Les tâches sont gérées par versions — elles passent par les étapes brouillon → validation, comme les entités cartographiques. Une tâche peut être localisée en un point (un regard), une ligne (un tronçon de route), un polygone (un lotissement), ou rester non localisée pour le travail de bureau. Les tâches appartiennent à des projets et sont exécutées via des ordres de travail.

Ordre de travail

Attribution d'une ou plusieurs tâches à une équipe, avec une date d'échéance 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 bon de travail dans l'ensemble d'Aptli. Certaines interfaces utilisateur et certains noms de droits d'administration (assignmentsCreate, assignmentsUpdate) utilisent le terme « affectation » ; d'autres (workOrdersCreate) utilisent « bon de travail ». Ils font référence au même concept sous-jacent.

Rapport

Compte rendu d'un intervenant sur le terrain concernant le travail effectué. Les rapports consignent ce qui a été réalisé, la localisation GPS, les ressources effectivement consommées et des photos. Les rapports peuvent être soumis dans le cadre d'une tâche formelle ou de manière ponctuelle pour des opérations de maintenance imprévues. La soumission d'un rapport déclenche des déductions automatiques des stocks et notifie les superviseurs.

Validation

Examen de contrôle qualité effectué par un superviseur sur un rapport soumis. Les validations enregistrent le résultat (réussite / échec / à réviser / approuvé) et toute observation. Une validation « Échec » ou « À réviser » renvoie le rapport au collaborateur ; une validation « Approuvé » peut déclencher les calculs de déblocage des paiements.

Projet

Un groupe de tâches liées partageant une date d'échéance et une affectation d'équipe. Les projets offrent une vue d'ensemble de l'avancement de toutes leurs tâches 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 fournit des droits d'administration granulaires couvrant toutes les actions de création, lecture, mise à jour et suppression dans le système. Exemples : workOrdersCreate, reportsDelete, allowCommits, canFacilitatePickups, canRunAiQueries. Les droits d'administrateur sont cumulatifs : un utilisateur sans droits ne peut consulter que ses propres missions.

Restrictions de rôle

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 à la consultation de ses propres bons de travail. Les restrictions de rôle et les droits d'administrateur fonctionnent comme deux couches indépendantes.

Demande d'accès

Un compte en attente créé lorsqu'une personne s'inscrit 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 utilisateur régulier ; 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. La connexion sur un nouvel appareil met fin à la session précédente ; l'appareil déconnecté affiche un message unique et est redirigé vers la page de connexion. Deux onglets dans le 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 plusieurs tentatives de connexion infructueuses (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 l'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 un traitement par lots est en cours et où les écritures des utilisateurs risqueraient d'interférer avec les opérations. Les administrateurs conservent un accès complet.

Journal d'audit

Enregistrement en ajout uniquement des 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 par enregistrement dans la chronologie intégrée sur les 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)

Un 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 opérationnel.

Carte et SIG

Calque

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 calques définissent ce qu'un élément est — par exemple, un calque « Poteaux téléphoniques » ou un calque « Tracés de conduits ». Les calques sont versionnés.

Schéma

Diagramme de relations modélisant les connexions entre des entités 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, les tracés de 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.

Zone de travail

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. La zone de travail permet de réviser les modifications complexes — dessin à main levée, accrochage, opérations multi-éléments — avant leur mise en ligne.