Write Service Contract¶
Le contrat Write Service définit les règles communes applicables à tous les services capables de modifier les données métier.
Il constitue la frontière officielle entre les traitements read-only et les traitements d'écriture.
Sommaire¶
- Rôle
- Pourquoi un Write Service ?
- Les objectifs
- Types d'opérations
- Cycle d'exécution
- Responsabilités
- Garde-fous
- Auditabilité
- État actuel
- Voir aussi
Rôle¶
Les Write Services sont les seuls composants autorisés à modifier les données métier.
Toutes les autres couches restent en lecture seule.
Pourquoi un contrat ?¶
Les écritures représentent le risque principal d'une architecture.
Les isoler dans une couche dédiée permet :
- de réduire les régressions ;
- de faciliter les audits ;
- de rendre les opérations reproductibles ;
- de simplifier les rollbacks.
Les objectifs¶
Le contrat garantit :
- des écritures explicites ;
- des traitements traçables ;
- des opérations reproductibles ;
- des validations avant exécution.
Types d'opérations¶
Les Write Services pourront notamment réaliser :
- réparation ;
- nettoyage ;
- fusion ;
- migration ;
- reclassification ;
- backfill.
Chaque opération reste indépendante.
Cycle d'exécution¶
Audit
↓
Validation
↓
Write Service
↓
Contrôles
↓
Journalisation
↓
Rapport
Responsabilités¶
Le contrat est responsable :
- d'encadrer les écritures ;
- de définir les étapes minimales ;
- de garantir la traçabilité.
Il n'est pas responsable :
- de détecter les conflits ;
- de construire une identité ;
- d'afficher les données.
Garde-fous¶
Chaque Write Service doit :
- être explicite ;
- être documenté ;
- être réversible autant que possible ;
- être précédé d'un audit ;
- produire un rapport d'exécution.
Auditabilité¶
Une opération d'écriture doit toujours permettre de répondre aux questions suivantes :
- Quoi ?
- Pourquoi ?
- Quand ?
- Par quel service ?
- Avec quel résultat ?
État actuel¶
La couche Write Services est volontairement peu développée.
Le projet s'est d'abord concentré sur les Read Services afin de valider les concepts métier sans modifier les données.
Les premiers Write Services apparaîtront progressivement lors des futures migrations Platform.
Voir aussi¶
- Contracts
- Read Services
- Operations
- Domain Core