Files
netslim-blog/docs/MAINTENANCE.md
2026-03-20 22:16:20 +01:00

2.1 KiB

Maintenance du dépôt

Ce document rassemble les règles simples à garder pour faire évoluer le projet sans le dégrader.

Ce qui doit rester stable

Backend

  • architecture modulaire par domaines ;
  • séparation Application / Domain / Infrastructure / UI ;
  • services applicatifs découplés du framework HTTP ;
  • tests d'architecture présents ;
  • relation explicite Post ↔ Media via post_media ;
  • démonstration vivante des modules Settings, AuditLog et Notifications via le module local Site ;
  • recherche full-text FTS5 protégée contre les entrées purement ponctuées.

Frontend

  • templates colocalisés par domaine ;
  • partials transverses dans templates/Kernel/ ;
  • SCSS centralisé dans assets/ et organisé par couches ;
  • scripts d'écran riches externalisés dans assets/js/ puis copiés dans public/assets/js/ au build ;
  • médiathèque admin et picker de l'éditeur alignés sur le même workflow métier (data-media-id).

Pour les détails de déploiement Docker, du provisionnement et d'un reverse proxy comme Caddy, voir DEPLOYMENT.md.

Règles de conduite

  1. respecter docs/ARCHITECTURE.md, docs/DEVELOPMENT.md et docs/FRONTEND.md ;
  2. éviter d'ajouter du transverse local alors que l'évolution relève de netslim-core ;
  3. préférer une amélioration locale à une nouvelle couche générique prématurée ;
  4. garder les tests et la documentation à jour quand une frontière change ;
  5. valider les parcours critiques manuellement avant une livraison importante ;
  6. préserver le découplage actuel entre Post et Media : Post garde ses VOs internes, l'adaptateur seul parle le contrat du domaine Media ;
  7. garder Site comme module d'intégration applicative du blog, sans y déplacer de responsabilités qui appartiennent au core.

Dépôt prêt à évoluer quand

  • PHPUnit est vert ;
  • PHPStan est vert ;
  • une vérification manuelle des parcours critiques a été effectuée si nécessaire ;
  • les assets frontend ont été reconstruits si besoin ;
  • aucun fichier temporaire n'est présent ;
  • la documentation reflète l'état réel du projet.