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

47 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Architecture de netslim-blog
`netslim-blog` est une application qui consomme `netslim-core` et ajoute deux modules locaux :
- `Post` pour le domaine éditorial ;
- `Site` pour les intégrations applicatives propres au blog.
## Dépendances vers le core
Le projet sappuie sur :
- `Netig\Netslim\Kernel\...`
- `Netig\Netslim\Identity\...`
- `Netig\Netslim\Settings\...`
- `Netig\Netslim\AuditLog\...`
- `Netig\Netslim\Notifications\...`
- `Netig\Netslim\Taxonomy\...`
- `Netig\Netslim\Media\...`
`ADMIN_HOME_PATH` pointe vers `/admin`, qui sert de tableau de bord au back-office du blog.
## Frontière entre le dépôt et le core
Dans ce dépôt, le code applicatif local est essentiellement :
- `src/Post/`
- `src/Site/`
- `templates/`
- `assets/`
- `config/`
- `public/`
Le code transverse et les modules partagés vivent dans `vendor/netig/netslim-core/` après installation Composer.
Les répertoires runtime persistants (`var/`, `database/`, `public/media/`) restent toutefois ceux du projet blog lui-même.
## Démonstration des capacités du core
Le module `Site` démontre concrètement :
- `Settings` via les réglages de titre, baseline, meta description et pagination ;
- `Authorization` via les pages dadministration réservées aux permissions dadmin ;
- `AuditLog` via la traçabilité des actions sur les réglages, notifications et articles ;
- `Notifications` via une page denvoi manuel et lhistorique des dispatches.
Le module `Post` reste propriétaire :
- des routes publiques et dadministration des contenus ;
- des migrations `posts`, `post_media`, `posts_fts` ;
- des usages concrets de `Taxonomy` et `Media`.
En pratique, si une évolution relève de `Kernel`, `Identity`, `Settings`, `AuditLog`, `Notifications`, `Taxonomy` ou `Media`, elle doit être développée dans le dépôt `netslim-core`, puis intégrée ici via Composer.