Soft-merge CCDS docs repository

git-subtree-dir: convergence/ccds-docs
git-subtree-mainline: 03a8059fec332cefdfab496d02ebd6e9ffb39af7
git-subtree-split: e61f3dc5534db993a82a518c64505eeae432e75c
This commit is contained in:
keke 2026-08-15 16:15:01 -03:00 committed by Selecta Keke
parent 16964d6c79
commit a8ec7fd113
28 changed files with 729 additions and 0 deletions

View file

@ -0,0 +1 @@

View file

@ -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.

View file

@ -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.

View file

@ -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.

View file

@ -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.