Aller au contenu

Namespace Convergence Plan

Objectif

Définir le plan officiel de convergence des namespaces PHP du repository CMonChoix Platform.

Constat

Le repository contient plusieurs familles de namespaces :

Namespace Statut
CMonChoix\Platform\... Canonique
CMonChoix\Domain\... Legacy / expérimental
CMonChoix\Application\... Legacy / expérimental
CMonChoix\Infrastructure\... Legacy / expérimental

Namespace cible

Le namespace cible unique est CMonChoix\Platform\.

Composer charge actuellement CMonChoix\Platform\ depuis src/.

Règle principale

Aucun nouveau code de production ne doit utiliser les namespaces legacy :

  • CMonChoix\Domain\
  • CMonChoix\Application\
  • CMonChoix\Infrastructure\

Toute nouvelle classe de production doit utiliser CMonChoix\Platform\.

Ordre de migration

  1. Domain utile et testé.
  2. Application stable.
  3. Infrastructure technique.
  4. Suppression legacy après preuve.

Critères de validation

Chaque patch doit passer :

  • composer dump-autoload
  • composer test
  • docs-check-platform
  • php -l pour chaque fichier PHP modifié.

Interdictions

  • Pas de migration massive.
  • Pas de renommage global automatique sans revue.
  • Pas de suppression de prototype sans inventaire.
  • Pas de modification Composer tant que la migration n’est pas planifiée.

Décision

Le repository converge vers un namespace unique CMonChoix\Platform\.

Les autres namespaces sont tolérés uniquement comme dette contrôlée, documentée et progressivement éliminée.