first commit

docs/MODULES.md

@@ -0,0 +1,35 @@
+# Modules fournis par netslim-core
+
+## Kernel
+Socle technique : bootstrap, DI, routing, Twig, migrations, checks de démarrage.
+
+Les layouts `@Kernel` fournissent la structure HTML partagée, mais l'application consommatrice reste responsable de servir ses assets front (`/assets/css/main.css`).
+
+## Identity
+Gestion des comptes, authentification, administration des utilisateurs et autorisation fine basée sur des permissions.
+
+## Settings
+Paramètres applicatifs clé / valeur typés, utilisables par plusieurs projets sans recréer un mini back-office de configuration dans chaque application.
+
+## AuditLog
+Journal d'audit transversal pour tracer les actions sensibles ou structurantes sur des ressources métier.
+
+## Notifications
+Envoi et suivi des emails transactionnels. Le module s'appuie sur le service mail du noyau et conserve un historique des envois réussis ou échoués.
+
+Une application consommatrice qui active ce module doit fournir les variables d'environnement `MAIL_*` nécessaires au transport SMTP.
+
+## Taxonomy
+Gestion de termes de taxonomie réutilisables. Les modules consommateurs gardent la propriété des relations d’usage.
+
+## Media
+Gestion de la médiathèque. Les modules consommateurs utilisent les contrats publics pour exposer les usages des médias.
+
+L'UI admin de `Media` suppose qu'un projet consommateur serve un script applicatif sous `/assets/js/media-admin.js`.
+
+Le module `Identity` peut être intégré sans module éditorial : la redirection vers le back-office après connexion ou refus d'autorisation est pilotée par `ADMIN_HOME_PATH` (défaut : `/admin`).
+
+
+## Frontière publique
+
+Les points d'intégration supportés pour une application consommatrice sont détaillés dans `docs/PUBLIC_API.md`.