Un domaine isolé, des adaptateurs interchangeables, des décisions écrites et une dette gérée.
Mission
Conçois et livre une petite application métier (réservation, gestion de bibliothèque, suivi d'apprentissage…) en architecture hexagonale. Le cœur est indépendant de la technique ; deux adaptateurs de stockage et une interface en ligne de commande l'utilisent. Le projet est accompagné d'un dossier d'ingénierie montrant ses décisions et ses limites.
Livrables
- Domaine (entités, objets-valeurs, services) sans dépendance technique, vérifié par un test d'architecture
- Ports et au moins deux adaptateurs de stockage (mémoire, SQLite) validés par un test de contrat commun
- Au moins 30 tests (domaine, cas d'usage, contrat, intégration)
- Utilisation justifiée d'au moins trois patrons de conception ou principes SOLID
-
ADR/: au moins 3 décisions documentées, dont une avec matrice pondérée et sensibilité -
DETTE.md: registre de dette, priorités et plan de remboursement -
REVUE.md: relecture de ton propre code avec la checklist (au moins 8 commentaires classés) -
README.md: architecture (schéma Mermaid décrit en texte), installation, extension
Critères d'évaluation
| Critère | Ce qu'on regarde | Poids |
|---|---|---|
| Architecture | Domaine isolé, dépendances vers le centre, interfaces claires | 25 % |
| Qualité du code | Cohésion, couplage, lisibilité, absence de duplication | 20 % |
| Tests | Domaine, contrat et intégration ; cas limites | 20 % |
| Décisions | ADR argumentés, alternatives et conséquences | 15 % |
| Dette et revue | Registre prioritisé, commentaires constructifs | 10 % |
| Documentation | Lisible, schéma décrit en texte, extension expliquée | 10 % |
Le projet est validé à 60 % ou plus. Chaque critère se démontre par une preuve visible (code, tests, texte).
HEF-080 — Génie logiciel

