45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
# 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.
|