Soft-merge CCDS docs repository
git-subtree-dir: convergence/ccds-docs git-subtree-mainline: 03a8059fec332cefdfab496d02ebd6e9ffb39af7 git-subtree-split: e61f3dc5534db993a82a518c64505eeae432e75c
This commit is contained in:
parent
16964d6c79
commit
a8ec7fd113
28 changed files with 729 additions and 0 deletions
1
convergence/ccds-docs/projet/decisions/accepted/.gitkeep
Normal file
1
convergence/ccds-docs/projet/decisions/accepted/.gitkeep
Normal file
|
|
@ -0,0 +1 @@
|
|||
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
# ADR-0001 - Separation des depots CCDS
|
||||
|
||||
- Statut : accepted
|
||||
- Date : 2026-06-24
|
||||
- Domaine : gouvernance
|
||||
|
||||
## Contexte
|
||||
|
||||
Le projet portail-association973 a besoin d'un cadre de travail plus lisible et plus durable.
|
||||
|
||||
Au fil des evolutions, quatre besoins differents se sont affirmes :
|
||||
|
||||
- faire vivre le code applicatif ;
|
||||
- piloter l'infrastructure et l'exploitation ;
|
||||
- centraliser la documentation transverse, la conformite et les procedures ;
|
||||
- versionner separement les styles et ressources cartographiques.
|
||||
|
||||
Garder tout dans un seul depot aurait augmente le bruit, melange les responsabilites et rendu l'audit plus difficile.
|
||||
|
||||
## Decision
|
||||
|
||||
L'organisation `ccds` adopte une separation en depots specialises :
|
||||
|
||||
- `portail-associations` pour le produit et le code applicatif ;
|
||||
- `infra` pour le deploiement, l'exploitation, les sauvegardes et la maintenance ;
|
||||
- `docs` pour la gouvernance, la conformite, les procedures et les livrables transverses ;
|
||||
- `cartographie` pour les styles, variantes, ressources et decisions cartographiques ;
|
||||
- `templates` pour les conventions de tickets, checklists et modeles communs ;
|
||||
- `.profile` pour presenter l'organisation et le role de chaque depot.
|
||||
|
||||
## Consequences
|
||||
|
||||
### Positives
|
||||
|
||||
- meilleure lisibilite des sujets ;
|
||||
- responsabilites plus claires ;
|
||||
- meilleure auditabilite RGPD / ISO 27001 / exploitation ;
|
||||
- cartographie mieux isolee comme brique metier ;
|
||||
- organisation Forgejo plus simple a lire pour les equipes.
|
||||
|
||||
### Vigilances
|
||||
|
||||
- eviter les duplications entre `docs`, `infra` et `portail-associations` ;
|
||||
- garder des conventions communes de tickets, labels et milestones ;
|
||||
- relier les depots par des references claires plutot que par des copies.
|
||||
|
||||
## Regles de fonctionnement retenues
|
||||
|
||||
1. Le code produit vit dans `portail-associations`.
|
||||
2. Les procedures d'exploitation et la logique VPS vivent dans `infra`.
|
||||
3. Les documents de conformite, gouvernance et arbitrage vivent dans `docs`.
|
||||
4. Les styles cartographiques et leurs variantes vivent dans `cartographie`.
|
||||
5. Les modeles reutilisables vivent dans `templates`.
|
||||
6. Les decisions structurantes du projet sont historisees dans `docs/projet/decisions`.
|
||||
|
||||
## Mise en oeuvre
|
||||
|
||||
- organisation Forgejo `ccds` creee ;
|
||||
- equipes `technique`, `pilotage` et `lecture` configurees ;
|
||||
- depots specialises initialises ;
|
||||
- labels communs et milestones poses ;
|
||||
- premieres conventions documentaires ajoutees.
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
# ADR-0002 - Conventions de labels et milestones Forgejo
|
||||
|
||||
- Statut : accepted
|
||||
- Date : 2026-06-24
|
||||
- Domaine : gouvernance
|
||||
|
||||
## Contexte
|
||||
|
||||
Une organisation multi-depots devient vite brouillonne si chaque depot emploie ses propres labels et ses propres reperes calendaires.
|
||||
|
||||
Le projet CCDS a besoin d'un langage commun pour :
|
||||
|
||||
- prioriser les sujets ;
|
||||
- reconnaitre les domaines metier ;
|
||||
- suivre les lots dans le temps ;
|
||||
- garder une lecture simple pour le pilotage.
|
||||
|
||||
## Decision
|
||||
|
||||
Les depots CCDS adoptent :
|
||||
|
||||
- un socle commun de labels transverses ;
|
||||
- des labels metier additionnels quand ils apportent un gain reel ;
|
||||
- des milestones datees partagees a l'echelle de l'organisation.
|
||||
|
||||
## Labels communs retenus
|
||||
|
||||
- `bug`
|
||||
- `ux`
|
||||
- `infra`
|
||||
- `conformite`
|
||||
- `cartographie`
|
||||
- `priorite-haute`
|
||||
- `priorite-moyenne`
|
||||
- `a-valider`
|
||||
- `admin`
|
||||
- `association`
|
||||
- `public`
|
||||
- `logistique`
|
||||
- `rgpd-iso27001`
|
||||
|
||||
## Milestones datees retenues
|
||||
|
||||
- `T3 2026 - Socle organisationnel`
|
||||
- `T3 2026 - Exploitation & conformité`
|
||||
- `T3 2026 - UX portail & admin`
|
||||
- `T3 2026 - Cartographie premium`
|
||||
|
||||
## Consequences
|
||||
|
||||
### Positives
|
||||
|
||||
- tickets plus lisibles ;
|
||||
- tri plus rapide ;
|
||||
- pilotage inter-depots plus coherent ;
|
||||
- moins de bruit dans l'organisation.
|
||||
|
||||
### Vigilances
|
||||
|
||||
- eviter de multiplier les labels sans besoin reel ;
|
||||
- fermer les anciennes milestones generiques quand les versions datees existent.
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
# ADR-0003 - Discipline des acces par equipe
|
||||
|
||||
- Statut : accepted
|
||||
- Date : 2026-06-24
|
||||
- Domaine : securite
|
||||
|
||||
## Contexte
|
||||
|
||||
L'organisation Forgejo ne devait pas rester ouverte par defaut sur tous les depots pour toutes les equipes.
|
||||
|
||||
Il fallait distinguer :
|
||||
|
||||
- le besoin de production technique ;
|
||||
- le besoin de pilotage ;
|
||||
- le besoin de simple lecture.
|
||||
|
||||
## Decision
|
||||
|
||||
Les equipes CCDS adoptent la discipline suivante :
|
||||
|
||||
- `technique` : acces fort sur les depots de travail et d'exploitation ;
|
||||
- `pilotage` : acces cible aux depots utiles au suivi projet ;
|
||||
- `lecture` : acces restreint aux depots de consultation et de gouvernance.
|
||||
|
||||
## Repartition retenue
|
||||
|
||||
### technique
|
||||
|
||||
- `portail-associations`
|
||||
- `infra`
|
||||
- `docs`
|
||||
- `cartographie`
|
||||
- `templates`
|
||||
|
||||
### pilotage
|
||||
|
||||
- `.profile`
|
||||
- `docs`
|
||||
- `templates`
|
||||
- `portail-associations`
|
||||
- `cartographie`
|
||||
|
||||
### lecture
|
||||
|
||||
- `.profile`
|
||||
- `docs`
|
||||
- `templates`
|
||||
|
||||
## Consequences
|
||||
|
||||
### Positives
|
||||
|
||||
- meilleure hygiene d'acces ;
|
||||
- exposition reduite des depots sensibles ;
|
||||
- pilotage plus clair ;
|
||||
- verification reelle possible avec comptes non proprietaires.
|
||||
|
||||
### Vigilances
|
||||
|
||||
- revoir les acces si de nouveaux depots ou de nouveaux usages apparaissent ;
|
||||
- tester periodiquement les permissions reelles.
|
||||
|
|
@ -0,0 +1,31 @@
|
|||
# ADR-0004 - Depot templates communs de travail
|
||||
|
||||
- Statut : accepted
|
||||
- Date : 2026-06-24
|
||||
- Domaine : gouvernance
|
||||
|
||||
## Contexte
|
||||
|
||||
Les modeles utiles etaient en train de se disperser entre les depots : tickets, checklists, exemples ADR et conventions de redaction.
|
||||
|
||||
## Decision
|
||||
|
||||
Un depot dedie `templates` sert de reference commune pour :
|
||||
|
||||
- conventions de tickets ;
|
||||
- checklists simples ;
|
||||
- exemples ADR ;
|
||||
- bases de travail reutilisables.
|
||||
|
||||
## Consequences
|
||||
|
||||
### Positives
|
||||
|
||||
- moins de duplication inutile ;
|
||||
- meilleur point d'entree pour les futurs projets ;
|
||||
- pratiques plus homogènes dans l'organisation.
|
||||
|
||||
### Vigilances
|
||||
|
||||
- les modeles actifs specifiques a un depot peuvent rester localement quand cela a du sens ;
|
||||
- le depot `templates` doit rester leger et utile.
|
||||
Loading…
Add table
Add a link
Reference in a new issue