Règles globales DMV

Statut

Document de règles projet — version initiale.

Objectif

Ce document définit les règles communes applicables au projet DMV, aux développeurs, aux agents IA, à la documentation et aux futures équipes.

Règles strictes

• Ne pas inventer de fonctionnalité livrée : distinguer toujours état actuel, cible et hypothèse.
• Ne pas modifier du code hors périmètre de la tâche.
• Ne pas dupliquer une logique métier déjà portée par un module existant.
• Ne pas déplacer une règle métier sensible dans un frontend.
• Ne pas introduire une dépendance irréversible sans justification.
• Ne pas exposer de secret, token, donnée bancaire ou donnée personnelle inutile.
• Ne pas présenter DMV comme un simple annuaire ou un réseau social généraliste.
• Ne pas laisser l'IA prendre seule une décision critique.

Principes directeurs

• Simplicité avant sophistication.
• Maintenabilité avant vitesse apparente.
• Mobile-first avant desktop-first.
• Backend métier avant logique dispersée.
• Modularité avant fragmentation.
• Documentation vivante avant mémoire orale.
• Cloud-agnostic autant que possible.
• Expérience humaine avant démonstration technique.

Recommandations

• Préférer une solution claire à une abstraction prématurée.
• Réutiliser les modules, services et composants existants.
• Écrire du code lisible par une future équipe.
• Documenter les décisions structurantes.
• Mesurer avant d'optimiser.
• Corriger la cause racine plutôt qu'un symptôme.

Rôles des IA et agents

Les IA et agents doivent :

• lire le contexte avant d'agir ;
• respecter les fichiers autorisés ;
• expliciter les hypothèses ;
• signaler les points à confirmer ;
• éviter les changements hors demande ;
• préserver la cohérence produit, architecture, sécurité et documentation.

Anti-patterns à éviter

• Sur-ingénierie.
• Jargon technocratique.
• Duplication entre apps.
• Mélange entre état livré et vision cible.
• Fonctionnalités gadgets.
• Accès direct non gouverné aux données.
• Automatisation sans supervision humaine.
• Documentation décorative non maintenue.

État actuel vs cible

Sujet	État actuel	Cible
Écosystème	Multi-apps amorcé.	Socle cohérent et gouverné.
Backend	Laravel modulaire visible.	Source métier principale.
Frontends	Next.js et React/Vite.	Interfaces autonomes mais cohérentes.
Supabase	Présence historique.	Rôle clarifié progressivement.
IA	Doctrine documentée.	Assistance contrôlée via gateway.

Points à clarifier

• Propriétaire final des règles.
• Processus de mise à jour.
• Priorité entre règles en cas de conflit.
• Règles propres aux futures apps.