Démarrage du monorepo
Le monorepo fournit les deux sites documentaires, la consultation Next.js de la nomenclature WALDEC, les compétences IA et le premier schéma Prisma RNA/SIRENE/WALDEC. Le lot 22407 fournit la CLI de synchronisation de la nomenclature.
Préparer les outils et les dépendances
Toutes les commandes ci-dessous partent de la racine du monorepo. Docker avec le plugin Compose et un daemon accessible est nécessaire pour PostgreSQL ou les sites en conteneur. Utiliser le NVM existant, sans changer son alias par défaut : .nvmrc fixe Node 24.22.2 et le manifest fixe Yarn 4.18.1 via Corepack.
Si Node ou les dépendances ne sont pas encore installés :
nvm install
nvm use
: "${NPM_PROXY_AUTH:?Configurer cette variable dans la session sans afficher sa valeur}"
PRISMA_SKIP_POSTINSTALL_GENERATE=true corepack yarn install --immutable
Si l’installation est déjà faite, nvm use suffit pour sélectionner le runtime du dépôt. L’installation utilise le miroir Synaltic ; l’authentification Basic base64 est fournie par votre mécanisme de secrets dans la session, jamais copiée du .npmrc d’un autre projet ni affichée dans une configuration complète. Yarn 4 est configuré séparément de npm. L’installation n’applique pas de migration, ne génère pas implicitement le client et ne charge aucune donnée métier.
Application web Next.js
Avant de lancer Next, créer et renseigner le .env.docker de ce worktree. Pour consulter WALDEC, démarrer PostgreSQL, appliquer les migrations puis synchroniser la nomenclature. Configurer le worktree · Préparer la base · Synchroniser WALDEC
corepack yarn build:nextjs:deps
corepack yarn dev:nextjs
La page initiale est disponible sur localhost:3000. Le lien « Nomenclature WALDEC » ouvre une consultation en lecture seule. Le lanceur hôte lit le .env.docker du worktree. Les commandes et diagnostics figurent dans le guide Next.js.
PostgreSQL et migrations
1. Configurer le worktree
Créer le fichier local seulement s’il n’existe pas :
test -f .env.docker || cp .env.docker.example .env.docker
Éditer ensuite .env.docker, qui est ignoré par Git. Renseigner votre propre POSTGRES_PASSWORD sans l’afficher ni le placer dans une URL à copier. POSTGRES_DB et POSTGRES_USER valent dataasso par défaut. Les quatre ports publiés par Compose doivent être libres et distincts, y compris entre worktrees. Pour un second worktree, par exemple, choisir POSTGRES_PORT=15432, NEXTJS_PORT=13000, DOCUMENTATION_PORT=13001 et DEVELOPER_PORTAL_PORT=13002.
Le nom du projet Compose dépend du chemin réel du worktree et isole son réseau et son volume. Les scripts lisent explicitement le fichier, sans source shell ; ses valeurs priment sur celles du shell. Les identifiants et mots de passe doivent rester cohérents avec un volume déjà initialisé : modifier le fichier ne reconfigure pas le cluster existant. Ne pas réinitialiser ce volume pour masquer un problème de connexion.
2. Démarrer PostgreSQL
corepack yarn docker:config
corepack yarn docker:db
corepack yarn docker:status
docker:config valide silencieusement la configuration Compose. docker:db démarre PostgreSQL 18.0 seul et attend son healthcheck. docker:status affiche l’état des services du projet. La sonde PostgreSQL vérifie la disponibilité du serveur. Celle de Next vérifie aussi le schéma nécessaire et la publication WALDEC. Depuis l’hôte, la connexion utilise localhost et POSTGRES_PORT. Next et les jobs en conteneur utilisent postgres:5432. Les lanceurs tirent leur configuration du worktree.
Pour suivre le diagnostic de PostgreSQL :
corepack yarn docker:logs postgres
Ctrl+C termine le suivi des logs sans arrêter le conteneur PostgreSQL.
3. Valider la définition, appliquer puis contrôler les migrations
Sur la base locale dédiée préparée ci-dessus, neuve ou dont l’évolution est voulue :
corepack yarn prisma:validate
corepack yarn prisma:migrate:deploy
corepack yarn prisma:migrate:status
prisma:validate vérifie la définition Prisma hors ligne ; ce n’est pas un test de connexion ni une vérification de la base. prisma:migrate:deploy applique explicitement les migrations versionnées : sur une base vide, la première est 20261103000000_initial_associations. Ce déploiement du schéma est séparé du démarrage Docker ; docker:db ne l’exécute pas automatiquement. Le schéma neuf ne charge ni associations, ni nomenclatures, ni seeds. Cette procédure ne réalise pas la migration de données d’une base historique.
Après application réussie, prisma:migrate:status doit indiquer un historique à jour, sans migration en attente ni échec. Ce statut compare les migrations versionnées à l’historique enregistré en base ; il ne contrôle pas complètement une dérive SQL manuelle ou toutes les contraintes effectivement présentes.
| Résultat observé | Interprétation et suite |
|---|---|
| Erreur de connexion | Vérifier le daemon, l’état PostgreSQL, le port et les identifiants du fichier local en cohérence avec le volume existant. Le statut de migration ne peut pas être conclu si la base n’est pas joignable. |
Migration en attente (pending) | Une migration versionnée reste à appliquer ; utiliser le déploiement explicite ci-dessus pour l’évolution voulue, puis consulter à nouveau le statut. |
Migration échouée (failed) ou résultat incertain | Lire les diagnostics et l’état enregistré avant de décider une correction ou une relance. Aucun reset automatique ; ne pas supprimer un volume ou réécrire une migration déjà appliquée pour obtenir un statut à jour. |
| Historique à jour | Les migrations attendues sont enregistrées comme appliquées ; cela ne prouve ni la présence de données métier ni un audit complet de l’intégrité SQL de cette base. |
Pour le détail et les règles d’évolution du schéma, consulter la procédure canonique Prisma, distribuée comme source de lecture avec cette page.
4. Vérifications facultatives, distinctes de la base du développeur
Après installation, ces commandes sont disponibles pour vérifier le package et ses règles :
corepack yarn build:prisma
corepack yarn test:prisma:config
corepack yarn test:prisma:integration
build:prisma génère explicitement puis compile le client ; test:prisma:config vérifie notre ciblage et notre configuration. La suite d’intégration démarre son propre PostgreSQL jetable, applique le schéma sur ses fixtures synthétiques, contrôle nos contraintes et migrations puis nettoie ses ressources. Elle ne lit pas le vrai .env.docker et ne vérifie pas directement la base du développeur. Ces commandes sont une procédure facultative : leur exécution n’est pas annoncée par la présente page et elles ne s’exécutent pas automatiquement au démarrage.
5. Arrêter en conservant les données
corepack yarn docker:stop
docker:stop arrête les services en conservant conteneurs et données. Pour supprimer les conteneurs et le réseau tout en conservant le volume PostgreSQL, utiliser explicitement corepack yarn docker:down. Ces deux commandes concernent tous les services du même projet Compose, y compris les sites s’ils tournent. Un démarrage ultérieur avec corepack yarn docker:db réutilise les données du volume ; ni stop ni down ne remettent la base à zéro.
Sites documentaires
Pour le développement du portail après les prérequis communs :
corepack yarn dev:developer-portal
Pour construire puis empaqueter la sortie développeurs :
corepack yarn build:developer-portal
docker build -t dataasso-developer-portal:22398 app/developer-portal
docker run --rm -d --name dataasso-22398-developer-portal -p 127.0.0.1:3002:80 dataasso-developer-portal:22398
Les ports et noms doivent être libres. L’image copie un build réussi et ne compile pas à nouveau. Les URL publiques sont fixées au build, pas à l’exécution Docker. Voir les sources canoniques de cette page pour les options, la prévisualisation et l’arrêt.
Avec le fichier .env.docker préparé sans écrasement à l’étape 1, corepack yarn docker:docs construit et démarre les deux sites ; corepack yarn docker:docs developer-portal sélectionne ce seul portail. Les URL sont dérivées des ports du fichier avant chaque compilation. Les profils local (PostgreSQL) et docs (sites) sont disponibles ; les sites peuvent fonctionner sans la base.
Après migration et synchronisation, corepack yarn docker:app construit et démarre Next.js avec PostgreSQL, puis attend que la consultation WALDEC soit disponible. corepack yarn docker:all démarre aussi les deux sites. Depuis http://localhost:<NEXTJS_PORT>/, suivre « Nomenclature WALDEC ». Les builds Next.js et data-jobs utilisent l’accès au miroir comme secret BuildKit, et Next.js récupère ses polices auprès de Google Fonts.
Consulter les sources SPDD de cette page.
Alimenter explicitement la nomenclature WALDEC
Après migration de la base cible autorisée et préparation du fichier local, compiler avec corepack yarn build:data-jobs, puis :
corepack yarn waldec:sync --file packages/database/referentiels/waldec-cd58f33f.csv --sha256 cd58f33f78dfa4a000a856c8b01412e9d41c7bbfc676b0ffbc2151223d8448bd
Le snapshot est attribué à Orléans Métropole sous LO 2.0 et versionné par son empreinte. La CLI lit explicitement .env.docker, affiche la cible sans credentials, ne migre pas le schéma et fonctionne hors ligne. waldec:acquire est une opération distincte sans base ; consulter le runbook avant collecte d'une autre version ou reprise d'échec. Résultats applied/unchanged/failed ; exit 2 bloque la suite. Aucun reset, aucune suppression des codes retirés.
Pour suivre le même ordre dans Docker sur une base autorisée :
corepack yarn docker:jobs migrate:deploy
corepack yarn docker:jobs migrate:status
corepack yarn docker:jobs sync --file packages/database/referentiels/waldec-cd58f33f.csv --sha256 cd58f33f78dfa4a000a856c8b01412e9d41c7bbfc676b0ffbc2151223d8448bd
L’image contient le snapshot et le conteneur utilise postgres:5432. En cas d’échec des migrations, consulter le diagnostic avant de passer à la synchronisation. Les démarrages ordinaires laissent ces opérations à l’opérateur.