Formations — 1 037 leçons en français

Accueil › Architecture & design patterns › Le format court d'une décision

Le format court d'une décision

Documenter les décisionsavance

Le format d'une décision tient en cinq sections, et sa valeur vient de sa brièveté : un document d'une page est lu, un document de dix ne l'est pas.

# 12. Chiffrer les identifiants de client dans les journaux

Statut : acceptée — 2024-06-04
Remplace : aucune

## Contexte
Les journaux d'application sont conservés treize mois et consultables par
l'astreinte. Ils contiennent aujourd'hui l'identifiant client en clair.
L'audit de mai a signalé ce point.

## Options considérées
- Supprimer l'identifiant : le diagnostic d'incident devient impossible.
- Hacher avec un sel fixe : réversible par dictionnaire sur un identifiant court.
- Chiffrer avec une clé détenue par l'équipe sécurité : déchiffrement sur demande.

## Décision
Chiffrer, clé détenue hors de l'application.

## Conséquences
Le diagnostic courant passe par une demande de déchiffrement, plus lente.
Un rejeu de journaux anciens exige la rotation des clés archivées.

Cinq éléments, et chacun fait un travail précis. Le titre annonce le choix, pas le sujet. Le statut dit si le texte engage encore. Le contexte expose la pression qui a rendu la décision nécessaire. Les options prouvent qu'il y a eu arbitrage. Les conséquences nomment le prix payé.

Ce qui n'y figure pas compte autant : pas de plan de mise en œuvre, pas de schéma de base, pas de code. Ces choses changent ; la décision, non.

Les termes à connaître

Statut

L'état d'une décision : proposée, acceptée, remplacée, rejetée. Il dit si le texte engage encore ou s'il est devenu un témoin.

Titre à la forme affirmative

Un titre qui énonce le choix — « Publier les événements en JSON » — plutôt que le sujet — « Format des messages ».

Options considérées

La liste des solutions réellement examinées, avec ce qui les élimine. Une seule option signifie qu'il n'y a pas eu de décision.

Numérotation

Un numéro croissant et jamais réattribué, qui rend chaque décision citable depuis le code, un ticket ou une autre décision.

Modèle de document

Un squelette de sections imposé. Il évite la page blanche et rend deux décisions comparables en un coup d'œil.

Décision rejetée

Une proposition écrite puis refusée. On la garde : elle empêche que la même idée revienne sans son contre-argument.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.