Fondations de la plateforme¶
À quoi sert cette section ?¶
Cette section explique les fondations de CMonChoix : les idées qui doivent rester stables même lorsque le code, les serveurs ou les technologies évoluent.
Si tu reprends le projet sans connaître son fonctionnement, commence ici avant de modifier l'architecture. Le but n'est pas d'apprendre chaque fichier du dépôt, mais de comprendre pourquoi la plateforme a été construite de cette manière.
Ce qu'il faut retenir¶
CMonChoix n'est pas seulement un site WordPress. Le projet est organisé comme une plateforme qui reçoit des données marchands, les normalise, identifie les produits, construit des données canoniques puis les expose au site public.
Les fondations servent de garde-fou : lorsqu'une modification paraît pratique mais contredit ces principes, il faut d'abord comprendre pourquoi avant de l'appliquer.
Ordre de lecture conseillé¶
- Lis Fondations de la plateforme pour comprendre les principes essentiels.
- Passe ensuite à Architecture globale pour voir comment les grandes parties du système s'assemblent.
- Consulte le Glossaire dès qu'un terme comme identité canonique, projection ou resolver n'est pas clair.
- Pour intervenir sur le serveur, utilise ensuite la section Exploitation plutôt que d'improviser une commande.
Document principal¶
Pour une reprise du projet¶
Avant toute modification importante, pose-toi trois questions :
- Quelle donnée ou quel composant est réellement responsable de ce que je veux changer ?
- Est-ce que je modifie la source canonique ou seulement une représentation dérivée ?
- Existe-t-il déjà une procédure ou un contrat documenté pour cette opération ?
Si la réponse n'est pas claire, ne modifie pas directement la production : remonte d'abord de la page concernée vers l'architecture, puis vers la source de données ou le service responsable.