# 0001 — Mise en place du socle

## Lot documentaire initial

Objectif : remplacer l'ancien arbre du dépôt sur une nouvelle branche locale sans upstream, conserver l'historique et poser le SPDD minimal avant tout code. La fusion vers `main` est une étape ultérieure.

Réalisé dans ce lot : cinq documents, architecture consolidée, points de reprise historiques et arborescence réservée par `.gitkeep`. Les anciennes règles `.spdd/`, anciens work items et anciens projets quittent l'arbre courant ; ils restent accessibles dans Git. Aucun transfert automatique de leurs décisions vers la cible.

Critères du lot :

- Les décisions validées sont documentées et distinguées des paramètres encore ouverts et de l'état réalisé.
- L'existant reste retrouvable par révision et chemin, notamment les scripts Python à porter en TypeScript et le gitlink de `map-asso`.
- Les liens documentaires locaux sont cohérents ; aucun `.github`, `services`, application, pipeline ou commande fictivement opérationnels n'est introduit.

Vérification proportionnée : relecture des cinq documents, contrôle des liens relatifs, de l'arborescence réservée et du diff. Pas de test applicatif ni d'installation pour ce lot.

## Lots suivants, ordonnés par dépendance

1. **Gouvernance et patrimoine.** Adapter et installer les rôles/skills/workflows du SPDD Compte Asso avec références, origine, révision et licence du vendor. Réintroduire `map-asso` sous `legacy/repos/map-asso` par gitlink figé. Établir la carte de reprise de l'existant avant de coder chaque domaine. Critères : aucune dépendance au workspace de référence, aucun suivi automatique du legacy, sources traçables et aucun import runtime historique. Vérifier les liens et contrats des workflows, sans les déclarer actifs avant leur installation. La partie compétences et contrats des rôles est installée par [C-22397](22397-integration-skills.md), puis réalignée sur LCA par [C-22411](22411-realignement-skills-lca.md), qui intègre le sous-module Addy Osmani. Le sous-module map-asso est réalisé par le lot 22424 ci-dessous ; la carte de reprise demeure à faire.

2. **Fondations exécutables.** C-22398 ajoute les seuls manifests/configurations Yarn/TypeScript nécessaires aux sites documentaires ; cela ne réalise pas le lot complet. Les preuves des sites sont consignées dans leur work item. Épingler Node/Yarn/TypeScript et bibliothèques, créer manifests privés, workspaces, lockfile et scripts réels ; configurer `packages/prisma` avec le premier schéma justifié, génération et migrations. Critères : installation immutable, génération et typecheck reproductibles, dépendances sans cycle. Ne pas inventer un domaine métier pour démontrer Prisma.
3. **Premier démarrage local.** Le [lot 22400](22400-compose-local.md) compose PostgreSQL, Next.js, les deux sites et data-jobs. Les migrations Prisma et la synchronisation WALDEC s’exécutent à la demande. Le projet Compose, les ports et les sorties de build sont propres au worktree. La première tranche web et son accès aux données relèvent du lot suivant.
4. **Tranche web et métier.** Réaliser un premier besoin identifié avec opération `common/server`, fonction serveur Next et route d'API lorsque requise, contrats séparés et contrôles d'accès. Critères : pas de Prisma dans les composants/adaptateurs, même métier partagé, validation des comportements propres au projet. Inclure SPDD et documentation dans ce lot de code.
5. **Référentiels TypeScript.** Définir le premier jeu, son format, sa provenance et sa politique ; porter les comportements utiles du Python, ajouter journal/état courant, verrous, détection de changement, dépendances, publication atomique et CLI data-jobs. Critères : base neuve, contenu identique, modification, A → B → A, échec/reprise et contraintes métier vérifiés sur fixtures synthétiques ; aucune suppression implicite. Ajouter les référentiels géographiques seulement après identification de leurs fichiers et règles.
6. **Deux sites documentaires.** Sources et configurations ajoutées par C-22398 ; voir le work item pour les preuves réellement obtenues et les limites. Construire le site d’exploitation `app/documentation` et le portail développeur `app/developer-portal`, distribuables séparément, chacun avec une recherche locale indexée au build ; relier les contenus au SPDD canonique. Critères : builds séparés, liens internes et entre sites cohérents, contenus utiles aux deux publics et procédures conformes à l’état réalisé. Aucun test démontrant qu’un terme du corps d’une page est retrouvé par le moteur. Voir le [lot des deux sites Docusaurus](deux-sites-docusaurus.md).
7. **CI/CD et livraison.** Adapter la structure LCA : contrôles, images, scans, promotion, jobs explicites schéma/référentiels et configurations de livraison. Critères : absence de doublons branche/MR, contrôles de fusion effectifs, couverture des consommateurs modifiés, annulation des validations obsolètes, opérations persistantes sérialisées. Valider la plateforme et les paramètres d'environnement avant d'écrire des déploiements spécifiques.
8. **Reprise fonctionnelle et données historiques.** Inventorier les autres traitements et parcours, décider conserver/corriger/remplacer/abandonner, puis réaliser par tranches avec preuves et documentation. Définir séparément la migration des données, les volumes et modalités de bascule ; ne pas assimiler legacy figé et production figée.

Chaque lot sera découpé en tâches ciblées avec critères et vérifications au moment de sa préparation. Les étapes indépendantes peuvent être réordonnées une fois leurs dépendances satisfaites ; cela ne déclenche pas automatiquement des agents ou des déploiements. Les paramètres ouverts de l'[ADR](../decisions/0001-architecture-cible.md) ne rouvrent pas les décisions déjà validées.

### Ticket 22424 — sous-module map-asso

Le parent enregistre `https://gitlab.app.synaltic.eu/dataasso/map-asso.git` dans `.gitmodules` et le gitlink `legacy/repos/map-asso` sur `576cae5c901e284c60dd712df1fbce64d9a505cf`. Aucun contenu du dépôt n'est copié dans le parent et aucune branche n'est suivie. La source est consultée en lecture seule ; l'initialisation est explicite et le module reste hors des builds/tests par défaut, sans import runtime historique.

Preuves distinctes : lors du cadrage, l'API GitLab interrogée via `~/.local/bin/glab-ro` en lecture seule a retourné le commit exact. Pendant la réalisation, l'initialisation a été testée depuis le clone local source vérifié par le PILOT, avec une substitution d'URL limitée à cette invocation et le protocole `file` seul autorisé. Aucun transport Git vers GitLab n'a été utilisé. Le checkout a résolu le commit enregistré et reste en HEAD détachée.

Après clone, l'initialisation explicite depuis la source configurée dans `.gitmodules` est :

```sh
git submodule update --init -- legacy/repos/map-asso
```

La commande réellement testée était cette commande ciblée avec la substitution locale éphémère ; la commande simple ci-dessus est la procédure prévue pour un clone standard. Le `git submodule status` observé est `576cae5c901e284c60dd712df1fbce64d9a505cf`, sans marque de non-initialisé, divergent ou conflit. Le clone source historique n'a pas été modifié.

## Premier modèle réalisé par 22403

Le [lot 22403](22403-schema-prisma.md) complète les fondations exécutables avec un schéma associations justifié, migrations et client Prisma. Ses preuves sont consignées dans son work item ; il ne réalise ni les importeurs de référentiels ni les consommateurs applicatifs.

## Premier référentiel TypeScript réalisé par 22407

Le [lot 22407](22407-waldec.md) réalise la nomenclature WALDEC dans database et une CLI data-jobs avec acquisition séparée, snapshot qualifié, trace et publication atomique. Le lot 22400 l’intègre à l’image data-jobs. Les commandes hôte, Docker et la reprise sont dans le [runbook](../applications/waldec.md). Schéma, synchronisation, seeds et reprise historique restent quatre opérations distinctes.

## Socle web Next.js

Le [workspace Next.js](../applications/nextjs.md) fournit l’App Router sur l’hôte et dans l’image standalone du lot 22400. Il est intégré à l’installation Yarn, au lockfile et au contrôle TypeScript du monorepo. Le [premier parcours métier](22423-waldec-next.md) ajoute la connexion explicite à la base et la consultation WALDEC.

Vérifications : installation Yarn immutable, lint du workspace, contrôle TypeScript du monorepo, build Next.js et réponse HTTP 200 sur `/` via le serveur de développement. Les sources SPDD sont validées par `check:docs`.
