Validations

Les validations constituent l'étape de contrôle qualité après la soumission d'un rapport. Dans la version actuelle, les validations ne sont plus une page autonome — elles se trouvent aux côtés du rapport auquel elles s'appliquent, sous la forme d'un badge tricolore dans la liste des rapports et d'une rangée de badges regroupés par statut dans la vue développée du rapport.

Un superviseur ou inspecteur CQ ouvre un rapport, clique sur un badge de validation pour afficher ou créer une validation dans une fenêtre modale superposée, vérifie les mesures et la qualité d'installation, et consigne les constats sur les postes précis du rapport. Chaque constat possède un niveau de gravité (critique, avertissement, information) et le statut global de la validation détermine si le paiement est libéré ou si le travailleur doit corriger son travail.

Emplacement des Validations

Liste des rapports : Chaque ligne de rapport affiche un badge de validation agrégé (gris/rouge/jaune/vert) dans sa propre colonne. Le badge affiche le statut le plus grave accompagné d'un compteur — par exemple, FAILED · 3 s'il y a trois validations échouées sur ce rapport. Survoler le badge révèle un détail par statut, comme failed: 1, passed: 2.

Rapport développé : Ouvrir un rapport dans la liste affiche une rangée de badges de validation regroupés par statut. Cliquer sur un badge ouvre la ValidationEditModal — une fenêtre superposée complète permettant d'afficher, modifier ou créer une validation sans quitter le rapport.

Mobile : La file de supervision mobile à /m/validations est inchangée. Les validateurs mobiles continuent de traiter les validations qui leur sont attribuées depuis une liste dédiée.

Vue impression : La page autonome /fulfillment/validations/:id est conservée comme vue d'impression uniquement. La fenêtre modale comporte un bouton Imprimer dans son en-tête qui ouvre la page d'impression dans un nouvel onglet. Les liens profonds issus d'anciens favoris continuent de fonctionner.

Ouvrir une Validation

Depuis la liste des rapports :

Repérer le rapport à valider
Cliquer sur le badge de validation dans la ligne du rapport (ou développer la ligne pour voir les badges regroupés par statut)
La ValidationEditModal s'ouvre par-dessus la page
Consulter la validation existante, ou cliquer sur Créer une validation si aucune n'existe
Consigner les constats, télécharger des photos, définir le statut, enregistrer

Droits d'accès :

La consultation des validations ne requiert aucun droit particulier
La création requiert le droit admin validationsCreate
La modification requiert le droit admin validationsUpdate

Soumission Unifiée (Rapport + Validation Ensemble)

La refonte unifie la modification du rapport et de ses validations. Lorsque vous avez le rapport et une validation ouverts simultanément, le bouton Soumettre enregistre toutes les modifications ensemble — les modifications du rapport et celles de la validation sont validées en une seule étape. Vous n'enregistrez pas les validations séparément du rapport.

Structure de Validation

Champs de Base :

Rapport - Référence au rapport validé (défini automatiquement à l'ouverture depuis le rapport)
Validateur - Utilisateur qui effectua la vérification CQ
Statut - pass, fail, needs-revision, approved-with-notes
Date de Validation - Quand CQ effectuée
Notes Globales - Observations générales, résumé

Conclusions Détaillées :

Conclusions - Tableau des problèmes spécifiques découverts
Photos - Documentation des problèmes de qualité
Actions Recommandées - Tâches de suivi, corrections nécessaires

Structure des Conclusions

Chaque constat dans une validation cible un poste précis de la liste Travail Terminé du rapport. Les constats comprennent :

Quel poste de travail présente le problème (par position dans la liste du travail terminé)
Type de problème — la catégorie du problème (ex., écart de volume, problème de qualité)
Gravité — critique, avertissement ou information
Description — une explication en langage courant du problème

Exemple : Un rapport enregistre du Câble Cat6 (45 m), des Boîtes de Jonction (8 unités) et de la Main-d'œuvre Électricien (3,5 heures). La validation relève un écart de volume sur le câble (42 m mesurés physiquement contre 45 m déclarés, gravité : avertissement) et un problème de qualité critique sur deux boîtes de jonction mal montées.

Points Clés :

Chaque constat référence un poste précis, ce qui permet aux validateurs d'approuver certains travaux et d'en signaler d'autres dans le même rapport
Plusieurs constats peuvent être ajoutés par rapport
Des notes détaillées préservent le contexte pour la révision par le travailleur

Statut de Validation

pass - Le travail rencontre les standards de qualité

Toutes mesures exactes
Installation selon spécifications
Matériaux correctement documentés

fail - Le travail ne rencontre pas les standards

Problèmes de qualité critiques
Écarts de mesure significatifs
Nécessite retravail

needs-revision - Problèmes mineurs, corrections nécessaires

Petites différences de mesure (dans tolérance)
Documentation incomplète
Photos nécessaires

approved-with-notes - Acceptable avec mises en garde

Le travail rencontre les standards minimums
Problèmes notés pour suivi
Motifs à adresser dans formation

Types de Problème

volume_mismatch - Volume rapporté ne correspond pas à mesure physique

Exemple : Rapport prétend 50 m câble, mesure montre 45 m
Gravité : avertissement (petite différence) ou critique (écart important)

quality_issue - Installation ne rencontre pas les standards

Exemple : Montage impropre, étanchéité manquante, dommage
Gravité : critique (risque sécurité) ou avertissement (cosmétique)

documentation_incomplete - Information requise manquante

Exemple : Pas de photos, description vague, certifications manquantes
Gravité : information (mineur) ou avertissement (exigence réglementaire)

location_discrepancy - Travail effectué à mauvais emplacement

Exemple : Géométrie rapport ne correspond pas à géométrie tâche
Gravité : critique (site complètement faux) ou avertissement (légèrement décalé)

consumption_mismatch - Matériaux consommés ne s'alignent pas avec travail terminé

Exemple : Rapporté 50 m travail câble, consommé 80 m depuis stock
Gravité : avertissement (enquêter gaspillage/vol)

safety_violation - Pratiques dangereuses observées

Exemple : Équipement sécurité manquant, procédures impropres
Gravité : critique (toujours)

Niveaux de Gravité

critical - Nécessite correction immédiate, travail non acceptable

Violations de sécurité
Défauts de qualité majeurs
Erreurs de mesure significatives
Impact financier > seuil

warning - Nécessite attention, mais travail marginalement acceptable

Problèmes de qualité mineurs
Petits écarts de mesure
Lacunes de documentation
Opportunités de formation

info - Noté pour suivi, pas d'action immédiate requise

Suggestions de meilleures pratiques
Améliorations d'efficacité
Observations informatives

Création de Validations

Accès Requis : Droit admin validationsCreate

Flux de Travail :

Naviguer vers Exécution → Rapports
Ouvrir (ou développer) le rapport à valider
Cliquer sur un badge de validation pour ouvrir la ValidationEditModal, ou cliquer sur Créer une validation si aucune n'existe
Examiner le travail terminé par rapport au site physique
Pour chaque ressource dans le travail terminé :
- Vérifier les mesures
- Vérifier la qualité d'installation
- Documenter tout problème dans les constats
Télécharger des photos des problèmes de qualité
Définir le statut global (pass/fail/needs-revision/approved-with-notes)
Ajouter des notes globales (résumé)
Cliquer Soumettre pour enregistrer le rapport + les modifications de validation ensemble

Validation de Terrain : Flux de travail validateur mobile (/m/validations) :

Vérification GPS (êtes-vous sur le site ?)
Intégration caméra pour photos de problèmes de qualité
Voix vers texte pour descriptions
Mode hors ligne (soumettre quand de retour en ligne)

Flux de Travail de Validation

Processus Typique :

Rapport Soumis - Travailleur termine le rapport
Badge Visible - La liste des rapports affiche un badge gris « aucune » pour les rapports sans validation
Validateur Ouvre le Rapport - Clique sur le badge, ouvre la fenêtre modale
Visite de Site - Le validateur se rend sur place (ou révise à partir des photos + données)
Mesures - Vérification physique du travail
Photos - Documenter la qualité (bonne ou mauvaise)
Constats - Enregistrer tout écart dans la fenêtre modale
Statut - Définir pass/fail/needs-revision sur la validation
Soumettre - Enregistre le rapport + la validation atomiquement
Suivi - Si needs-revision, le travailleur adresse les problèmes
Re-Validation - Rouvrir le badge, ajouter des constats à la validation existante ou en créer une nouvelle
Approbation Finale - Rapport approuvé, paiement libéré

Filtrage des Rapports par Statut de Validation

Les validations étant désormais sur la page des rapports, la liste des rapports accepte un filtre de statut de validation :

all — tous les rapports (par défaut)
none — rapports sans aucune validation (nécessitent une attention CQ)
any — rapports avec au moins une validation
failed — rapports avec au moins une validation échouée
revision — rapports avec au moins une validation needs-revision
passed — rapports dont toutes les validations passent

Les filtres personnalisés s'appliquent toujours :

Validateur (qui effectua CQ)
Plage de dates
Gravité (constats critiques uniquement)
Type de problème (volume_mismatch, quality_issue, etc.)

Intégration de Paiement

Les validations contrôlent la libération de paiement :

Retenue de Paiement :

Rapports avec statut fail → paiement retenu
Rapports avec needs-revision → paiement partiel (configurable)
Rapports avec approved-with-notes → paiement complet, notes suivies

Libération de Paiement :

Rapport soumis
Validation effectuée via le badge/la fenêtre modale
Si pass ou approved-with-notes → paiement libéré
Si needs-revision → paiement partiel, re-validation requise
Si fail → pas de paiement, retravail requis

Protection Financière :

Empêche paiement pour travail sous-standard
Incite à la qualité
Piste d'audit pour décisions de paiement

Analytiques de Validation

Suivre les tendances de qualité dans le temps :

Par Travailleur :

Taux de réussite par travailleur
Types de problème communs
Tendances d'amélioration
Identification des besoins de formation

Par Type de Tâche :

Quelles tâches ont le taux d'échec le plus élevé
Problèmes de qualité spécifiques à ressource (câble vs. main-d'œuvre vs. équipement)
Exactitude d'estimation (écarts de volume indiquent mauvaises estimations)

Par Validateur :

Vérifications de cohérence (un validateur trop strict/laxiste ?)
Temps de traitement de validation
Distribution de gravité des constats

Meilleures Pratiques

Validation Opportune :

Utiliser le filtre none de la liste des rapports pour repérer les rapports en attente de CQ
Valider dans les 24 à 48 heures suivant la soumission du rapport
Preuves fraîches (matériaux encore visibles, travailleur se souvient encore)
Paiement plus rapide aux travailleurs

Constats Spécifiques :

Référencer le poste de travail terminé précis par sa position (premier élément, deuxième élément, etc.) pour rendre les constats exploitables
Des descriptions détaillées aident le travailleur à comprendre le problème
Les photos fournissent une preuve indiscutable

Retour Constructif :

Encadrer comme opportunité de formation
Expliquer pourquoi le problème importe (sécurité, standards, coût)
Offrir des suggestions d'amélioration

Standards Cohérents :

Appliquer les mêmes critères à tous les travailleurs
Documenter les standards de qualité clairement
Calibration régulière des validateurs (assurer la cohérence)

Utiliser la Vue Impression pour les Copies Papier :

Ouvrir la ValidationEditModal sur une validation existante
Cliquer sur le bouton Imprimer dans l'en-tête de la fenêtre modale
La page d'impression s'ouvre dans un nouvel onglet, prête pour l'impression papier ou l'export PDF

Immuabilité de Validation

Suppressions Logiques : Les validations peuvent être marquées supprimées mais restent dans la base de données :

Préserve l'historique CQ
Maintient la piste d'audit de paiement
Période de rétention configurable
Droit admin viewDeleted pour voir les validations supprimées

Restrictions d'Édition : Après libération de paiement :

Les validations deviennent en lecture seule (la fenêtre modale est en consultation uniquement)
Les corrections nécessitent une nouvelle validation avec notes
Préserve l'intégrité financière
L'historique de version suit tous les changements avant finalisation