Définir une structure de modules claire, testable et évolutive

Périmètre fonctionnel

Un module couvre un usage métier unique (ex. panier, paiement, recherche). Il expose des capacités via des interfaces (API/événements) et ne connaît pas l’UI.

Livrables : description fonctionnelle, invariants, cas limites, glossaire.

Contrat de données

Schémas d’entrée/sortie versionnés, validation stricte, gestion des erreurs normalisée (codes, messages, retrys idempotents).

Livrables : schémas JSON/Protobuf, exemples, règles de validation.

APIs synchrones

REST/GraphQL avec compatibilité ascendante. Pagination, filtrage, tri, et rate limiting.

• Version dans l’URL/header
• Schémas publiés (OpenAPI)
• Codes d’erreur stables

Événements asynchrones

Événements domain pour propager les changements sans couplage fort. Rejeu et DLQ pour résilience.

• Nomenclature claire
• Contrats immuables
• Garantie au moins une fois

Politiques d’erreurs

Timeouts, retrys exponentiels, circuit breaker, idempotence. Traçage des corrélations requête/événement.

• Codes métiers dédiés
• Journalisation normalisée
• Playbooks incident

Couplage minimal

Dépendances uniquement sur interfaces stables. Aucun accès direct aux tables d’un autre module. Préférer les façades internes ou les API.

Contrôles : revues d’architecture, analyse de graphe des imports, tests de contrat.

Composition par orchestration

Les scénarios s’assemblent via un orchestrateur (service de workflow) ou par chorégraphie d’événements.

• Workflows idempotents
• États persistés
• Timeouts globaux

Règles de versions

SemVer : MAJOR (rupture), MINOR (ajouts compatibles), PATCH (correctifs).

Annonce des changements via changelog et RFC internes.

Fenêtre de compatibilité

Maintenir N-1 versions d’API et d’événements. Planifier les suppressions, fournir des guides de migration.

Contrats testés

Tests de contrat producteurs/consommateurs (Pact), vérifiés en CI pour éviter les régressions inter-modules.

Stratégie de tests

• Unitaires sur la logique métier
• Contrat API/événements
• Intégration avec doubles (stubs/mocks)
• E2E sur parcours critiques

Pipelines

• Lint + SCA + SAST
• Build & artefacts versionnés
• Scans de vulnérabilités image
• Déploiements en pré-prod + smoke tests

Logs & traces

Corrélation requêtes/événements, IDs de corrélation propagés, niveaux standards (DEBUG→ERROR).

Métriques

SLI/SLO : latence P95, erreurs, saturation, débit. Tableaux de bord par domaine.

Alerting

Alertes actionnables, seuils dynamiques, garde-fous sur faux positifs.

Principes

• Moindre privilège & secrets gérés (vault)
• Chiffrement en transit & au repos
• Journalisation d’accès & durcissement

RGPD & données

• Minimisation & rétention
• Traçabilité des consentements
• Registre des traitements tenu à jour

Design docs

Rédiger des ADR (Architecture Decision Records) courts et datés. Lier code, schémas et tests.

Catalogue des modules

Inventaire : propriétaire, SLA, versions exposées, dépendances, alertes, tableaux de bord.