Document ownership
Cette page définit qui maintient quoi dans la documentation Nex. Toute page doit avoir un
ownerexplicite (dans son frontmatter), responsable de sa mise à jour, de sa revue périodique et de sa suppression ou dépréciation.
1. Principes
- Un owner par page (équipe ou personne, format
@nom-équipe). - Le code et la doc évoluent ensemble : toute MR qui modifie un composant doit mettre à jour la doc correspondante et rafraîchir
last_review. - Owner par défaut par section (si pas surchargé dans le frontmatter d'une page).
- Délégation possible : un owner peut nommer un mainteneur secondaire pour une page spécifique.
2. Owners par section
| Section | Owner par défaut | Périmètre |
|---|---|---|
/overview/ | @platform-team | Glossaire, produit, personas, parcours |
/architecture/ | @architecture-team | Monorepo, C4, ADRs, diagrammes architecture |
/architecture/adr/ | @architecture-team | Architecture Decision Records |
/services/<service>/ | équipe propriétaire du service | Fiche service (cf. table §3) |
/flows/ | @product-team | Flows monétaires (cash-in, cash-out, P2P, merchant…) |
/security/ | @security-team | ISP, ACM, encryption, secrets, SDLC, vuln mgmt, mobile, qr-code, known gaps |
/compliance/ | @compliance-team | ISO 27001 SoA, BEAC/COBAC, AML/CFT, customer funds, vendors, RGPD, PCI scope |
/operations/ | @platform-ops | Infra, CI/CD, monitoring, BCP/DRP, IRP, runbooks |
/qa/ | @qa-team | Test strategy, AC, environnements, data sets, devices, compliance tests |
/dev/ | @platform-team | Onboarding dev, conventions Git, design system |
/usage/ | @support-ops | Guide métier CMMS (procédures non-tech) |
/partners/ | @partners-team | Doc destinée aux développeurs partenaires intégrateurs externes (concepts, procédures, référence API, webhooks) |
/governance/ | @platform-team | Conventions doc, review cadence, changelog |
3. Owners par service
| Service / package | Owner | Page |
|---|---|---|
auth | @auth-team | /services/auth/overview |
ledger-wallets | @ledger-team | /services/ledger-wallets/ |
customer-profiles-kyc | @kyc-team | /services/customer-profiles-kyc/ |
orchestrator | @platform-team | /services/orchestrator/overview |
notifications | @platform-team | /services/notifications/ |
configuration | @platform-team | /services/configuration/overview |
file-service | @platform-team | /services/file-service/ |
providers-gateway | @platform-team | /services/providers-gateway/ |
risk-engine | @security-team | /services/risk-engine/ |
service-catalog | @platform-team | /services/service-catalog/ |
logs-reporting | @platform-team | /services/logs-reporting/ |
@nex/mobile-auth | @platform-team | /services/mobile-auth/ |
Les noms d'équipes ci-dessus sont des handles génériques. La correspondance précise équipe ↔ personnes est tenue à jour dans
[À CONFIRMER : outil interne].
4. Responsabilités de l'owner
Pour chaque page dont il est propriétaire, l'owner est garant :
- Exactitude : la page reflète la réalité du système.
- Fraîcheur :
last_reviewà jour, revue trimestrielle minimum. - Cohérence : la page n'entre pas en conflit avec d'autres pages — sinon arbitrage avec les autres owners.
- Audit-readiness : la page peut être présentée à un auditeur sans honte.
- Évolution : déprécation ou suppression quand le contenu n'est plus pertinent.
5. Quand changer l'owner ?
- Réorganisation interne (équipe dissoute, fusionnée).
- Transfert de scope (un service change de squad propriétaire).
- Départ d'une personne propriétaire (si
ownerétait nominal, transférer immédiatement).
La modification de l'owner doit être faite dans le frontmatter de la page et réfléchie dans cette page de référence.
6. Owners "à pourvoir"
Sections dont l'owner par défaut nécessite confirmation ou nomination explicite :
| Section | Owner par défaut actuel | À confirmer ? |
|---|---|---|
/compliance/* | @compliance-team | Oui — désigner un compliance officer responsable |
/security/* | @security-team | Oui — désigner un RSSI nominal |
/operations/business-continuity /operations/disaster-recovery /operations/incident-response | @platform-ops | partagé avec @security-team |
7. Revue de cette page
Cette page elle-même est versionnée comme les autres. Toute modif de l'arbre des owners passe par une MR avec review d'au moins un mainteneur de @platform-team.