SAMA Suite Docs
Un site documentaire commun pour SAMA MAIRIE, Wooryoon et la Bourse, avec une logique de plateforme publique interconnectée, des parcours métier et des intégrations à gouvernance explicite.
Modules municipaux
État civil, citoyen, urbanisme, environnement, services techniques, santé sociale, fiscalité, équipements et services citoyens.
Voir la verticaleProduits et workflows
Santé digitale, parcours usagers, opérations, données partagées, portails, traçabilité et moteurs de service.
Voir la verticaleTrading et supervision
Front office, back office, conformité, comparateurs, offres, clients, traders et moteurs d’alertes.
Voir la verticaleArchitecture documentaire
Le hub `Docs` doit devenir la porte d’entrée commune pour comprendre les produits, les sous-modules, les rôles, les flux de données et les dépendances de la suite. Il ne doit pas seulement lister des pages, mais aider à comprendre comment une verticale vit, se pilote, s’administre et s’ouvre à d’autres systèmes.
L’objectif est de fournir un langage partagé entre métier, produit, support, direction et partenaires d’intégration. Chaque verticale doit donc être décrite à la fois comme un ensemble de modules, un portefeuille de parcours et une architecture de confiance.
Ce que le lecteur doit trouver
- Le périmètre métier d’une verticale.
- Les objets de données principaux.
- Les workflows et écrans clés.
- Les indicateurs de pilotage.
- Les ponts avec les autres systèmes.
Lecture produit
Comment la verticale sert le citoyen, l’agent, le manager et les opérations.
Lecture data
Quelles données font foi, comment elles circulent et où elles sont réutilisées.
Lecture gouvernance
Quels contrôles, responsabilités et journaux rendent le système explicable.
Méthode de lecture
Commencer par la verticale, poursuivre avec les sous-modules, puis croiser avec les rôles `Academy` et les récits `Press`. Le site doit accompagner à la fois une découverte rapide et une lecture approfondie par thème.
Publics visés
Directions générales, chefs de projet, agents d’accueil, managers métier, intégrateurs, support fonctionnel et partenaires institutionnels. La documentation doit rester suffisamment profonde pour les experts, sans devenir illisible pour les non-techniciens.
Niveau attendu
Décrire non seulement les écrans, mais aussi la logique métier, les dépendances de données, les cas limites, la posture attendue des équipes et les indicateurs qui permettent de piloter la qualité de service.
Feuille de route documentaire
À terme, chaque verticale doit être documentée à quatre niveaux: vue d’ensemble, sous-modules, rôles opérationnels et intégrations transversales. Le hub `Docs` doit aussi faire apparaître la manière dont les portails publics, les back-offices et les moteurs de règles s’emboîtent dans une même narration.
Cette profondeur est particulièrement importante pour `SAMA MAIRIE`, car plusieurs modules ont été stabilisés puis enrichis directement sur la copie. Le site doit donc devenir une mémoire de conception aussi bien qu’un support d’exploitation.
Questions à documenter partout
- Qui crée la donnée de référence?
- Qui la réutilise?
- Quels sont les écrans par rôle?
- Quels KPI disent si le service fonctionne?
- Quels journaux prouvent la confiance?