Rapports de validation¶
Vue d'ensemble¶
Les rapports de validation constituent l'aboutissement d'un cycle d'analyse de la Platform.
Ils synthétisent les observations réalisées pendant les audits, les simulations et les comparaisons afin de déterminer si une évolution peut être considérée comme validée.
Un rapport de validation n'est pas un simple compte-rendu.
Il représente une décision d'architecture.
Il documente pourquoi une évolution est acceptée, rejetée ou nécessite des investigations complémentaires.
Objectif¶
Le principal objectif d'un rapport de validation est de conserver une trace durable des décisions prises pendant le développement.
Chaque rapport doit permettre de répondre aux questions suivantes :
- Quel était le problème initial ?
- Quelle solution a été envisagée ?
- Comment cette solution a-t-elle été évaluée ?
- Quels indicateurs ont été mesurés ?
- Quels risques ont été identifiés ?
- Pourquoi la solution a-t-elle été retenue ?
Le rapport devient ainsi une référence pour les évolutions futures.
Position dans le cycle industriel¶
Le rapport intervient à la fin d'un processus d'analyse.
Audit
│
▼
Simulation
│
▼
Comparaison
│
▼
Validation
│
▼
Rapport
Il formalise la décision finale.
Contenu d'un rapport¶
Chaque rapport de validation doit être structuré de manière homogène.
Contexte¶
Le rapport commence par rappeler le problème étudié.
Par exemple :
- industrialisation d'une nouvelle verticale ;
- amélioration d'un algorithme de résolution ;
- réduction des conflits ;
- amélioration d'un score de qualité.
Le contexte doit être suffisamment précis pour comprendre le rapport plusieurs mois après sa rédaction.
Hypothèse¶
Le rapport présente ensuite l'hypothèse testée.
Par exemple :
L'ajout d'une nouvelle règle de résolution devrait réduire les conflits entre plusieurs modèles partageant le même identifiant marchand.
Une hypothèse claire facilite l'interprétation des résultats.
Méthode¶
Cette section décrit les outils utilisés :
- audits exécutés ;
- simulations réalisées ;
- jeux de données analysés ;
- comparaisons effectuées ;
- indicateurs calculés.
L'objectif est de rendre la validation reproductible.
Résultats¶
Les résultats présentent les observations obtenues.
Ils peuvent inclure :
- évolution des KPI ;
- nombre de conflits résolus ;
- taux de correspondance ;
- produits impactés ;
- anomalies détectées.
Les résultats doivent être factuels.
Ils ne doivent pas contenir d'interprétation prématurée.
Analyse¶
Cette partie explique les résultats observés.
Elle répond notamment aux questions :
- pourquoi les résultats sont-ils satisfaisants ?
- quelles limites subsistent ?
- quelles situations restent non résolues ?
- quels compromis ont été acceptés ?
Cette analyse constitue la partie la plus importante du rapport.
Décision¶
Le rapport se termine par une décision explicite.
Par exemple :
- évolution validée ;
- évolution validée avec réserves ;
- évolution refusée ;
- investigations complémentaires nécessaires.
Cette décision doit être argumentée.
Indicateurs¶
Un rapport de validation s'appuie systématiquement sur des mesures.
Selon le contexte, il peut notamment présenter :
- taux de correspondance ;
- conflits restants ;
- identités ambiguës ;
- produits non résolus ;
- qualité des données ;
- temps d'exécution ;
- couverture des projections.
Les KPI utilisés doivent rester comparables entre plusieurs rapports.
Traçabilité¶
Chaque rapport doit être associé :
- à une évolution du code ;
- à un ensemble d'audits ;
- à une ou plusieurs simulations ;
- à une période d'analyse.
Cette traçabilité facilite les investigations ultérieures.
Ce qu'un rapport ne doit pas contenir¶
Un rapport de validation ne doit jamais :
- modifier les données ;
- contenir des décisions implicites ;
- remplacer une documentation d'architecture ;
- masquer des résultats défavorables.
Il doit présenter les observations de manière objective.
Exemple¶
L'industrialisation d'une nouvelle verticale suit généralement le processus suivant :
- réalisation des audits ;
- simulations des nouvelles règles ;
- comparaison avec l'existant ;
- mesure des KPI ;
- rédaction du rapport ;
- validation ou rejet de l'évolution.
Ce rapport devient ensuite la référence officielle de cette étape d'industrialisation.
Évolution¶
À mesure que la Platform évoluera, les rapports de validation constitueront un historique des décisions d'architecture.
Ils permettront notamment :
- d'expliquer les choix passés ;
- de comparer plusieurs stratégies ;
- d'évaluer les progrès réalisés ;
- de faciliter l'arrivée de nouveaux développeurs.
Ils participent ainsi à la mémoire technique de CMonChoix.