# 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](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.