portail-associations/convergence/ccds-docs/projet/decisions/accepted/ADR-0001-separation-des-depots-ccds.md
keke a8ec7fd113 Soft-merge CCDS docs repository
git-subtree-dir: convergence/ccds-docs
git-subtree-mainline: 03a8059fec332cefdfab496d02ebd6e9ffb39af7
git-subtree-split: e61f3dc5534db993a82a518c64505eeae432e75c
2026-08-15 16:16:01 -03:00

2.3 KiB

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.