Aller au contenu

Interfaces

Statut

Document de design cible.

Ce document décrit l'architecture attendue des Interfaces dans CMonChoix Platform V2.


Mission

Les Interfaces exposent la Platform vers l'extérieur.

Elles adaptent les entrées et sorties sans contenir la logique métier profonde.


Responsabilités

  • CLI
  • HTTP endpoints
  • Admin
  • WordPress hooks
  • adaptation des requêtes
  • validation d'entrée
  • formatage de sortie
  • déclenchement contrôlé des services

Ce qui leur appartient

  • commandes CLI
  • endpoints HTTP
  • pages admin légères
  • handlers WordPress
  • adapters entrée/sortie
  • validation de paramètres

Ce qui leur est interdit

  • logique métier profonde
  • résolution d'identité
  • scoring
  • classification
  • persistance directe non contrôlée
  • SQL dispersé
  • patchs marchands
  • rendu frontend catalogue

Dépendances autorisées

Les Interfaces peuvent dépendre de :

  • Read Services
  • Write Services
  • Runtime
  • Infrastructure d'adaptation
  • contrats d'entrée/sortie

Dépendances interdites

Les Interfaces ne doivent pas dépendre directement de :

  • Domain Core
  • Vertical Modules
  • SQL brut
  • logique frontend
  • patchs legacy
  • fichiers temporaires non encapsulés

Entrées

  • requêtes CLI
  • requêtes HTTP
  • actions admin
  • hooks WordPress
  • paramètres utilisateur
  • payloads techniques

Sorties

  • réponse CLI
  • réponse HTTP
  • message admin
  • erreur contrôlée
  • statut d'opération
  • rapport formaté

Contrats utilisés

Les Interfaces respectent :

  • contrats d'entrée
  • contrats de sortie
  • contrats Read Services
  • contrats Write Services
  • contrats Runtime

Organisation cible

interfaces/

cli/
  commands
  formatters

http/
  endpoints
  request
  response

admin/
  pages
  actions
  notices

wordpress/
  hooks
  adapters