Centraliser la documentation de référence du projet Analyse Basket pour le suivi produit, l’architecture technique, l’exploitation et la transmission de connaissances.
Le dossier docs/ sert de base documentaire professionnelle unique pour :
- le cadrage et la gouvernance projet ;
- la description de l’architecture applicative et infrastructure ;
- les pratiques de développement, qualité, sécurité et accessibilité ;
- l’exploitation en production (MCO, monitoring, incidents) ;
- la documentation des parcours utilisateur.
cadrage/: vision, besoins, risques, priorités.architecture/: vues techniques et flux applicatifs.developpement/: pratiques d’ingénierie et qualité.exploitation/: déploiement, supervision, maintenance.pilotage/: organisation, arbitrages, suivi.utilisateur/: guides d’usage et parcours.utils/: templates et checklists opérationnelles.
| Dossier | Objectif |
|---|---|
docs/cadrage |
Formaliser le besoin métier et le cadre projet |
docs/architecture |
Décrire la conception logicielle et infra réelle |
docs/developpement |
Standardiser les pratiques de dev et de test |
docs/exploitation |
Outiller le déploiement, la supervision et le support |
docs/pilotage |
Piloter délais, risques, arbitrages et communication |
docs/utilisateur |
Accompagner les utilisateurs sur les parcours clés |
docs/utils |
Fournir des modèles et checklists réutilisables |
Cette documentation est utilisée simultanément pour :
- le suivi projet (avancement, décisions, arbitrages),
- l’exploitation (déploiement, incidents, monitoring),
- la transmission technique (onboarding, maintenance, continuité).
architecture/vue-ensemble.mdarchitecture/architecture-infrastructure.mddeveloppement/integration-continue.mddeveloppement/deploiement-continu.mdexploitation/manuel-deploiement.mdexploitation/manuel-mise-a-jour.mdexploitation/journal-versions.mdpilotage/suivi-avancement.mdutilisateur/manuel-utilisateur.md
- Politique de validation documentaire (qui valide quoi, à quelle fréquence).
- Convention de versionning de la documentation.