4.2 KiB
Documentation LeCoffre.io (index)
Projet ia_dev : kogus (identifiant outillage ; le site produit « LeCoffre » reste product_code / sites.code lecoffreio côté applicatif).
Wiki : https://git.4nkweb.com/4nk/lecoffre_ng/wiki
Correspondance fichier → page wiki : nom du fichier sans .md, _ → -, title-case par segment (ex. README.md → Readme, Operations.md → Operations).
Chemins secrets (monorepo et legacy)
Cette section évite de dupliquer les tableaux détaillés dans chaque page de ce dossier. Elle vise le clone LeCoffre (deploy.repository_root dans projects/kogus/conf.json). Elle ne décrit pas l’arborescence interne des jetons ia_dev sous projects/<id>/.secrets/... (ex. fichier ia_token par projet), qui reste propre au dépôt ia_dev.
| Rôle | Chemin canonique (scripts deploy/scripts_v2, deploy-site.sh) |
|---|---|
Secrets par ligne produit (SITE_CODE / 2ᵉ argument de deploy-site.sh) |
.secrets/<site>/<env>/ avec <site> ∈ { lecoffreio, enso, genealogie } |
Kogus (orchestrateur SSH, connectDB partagé, précontrôle deploy-site.sh) |
.secrets/kogus/<env>/ (.env.<env>, .env.<env>.connectDB) |
Documentation canonique (dépôt LeCoffre, branche suivie) : docs/features/multi-site-architecture.md, docs/features/secrets-multisite-kogus-and-sites.md, docs/features/secrets-devai-kogus-sites-and-imports.md, docs/features/multisite-data-policy-lecoffre-vs-ia-dev.md, manifeste deploy/secrets-layout-manifest.json. Exemple d’URL Gitea (adapter la branche) : https://git.4nkweb.com/4nk/kogus/src/branch/test/docs/features/multi-site-architecture.md.
Legacy : arbre plat .secrets/<env>/ uniquement en phase de migration ; pont symlinks documenté avec LECOFFRE_LEGACY_FLAT_SECRETS_SYMLINKS=1 côté orchestration ia_dev — état cible = répertoires réels par <site>.
Les pages MIGRATION, DATABASE_COMPLETE, Frontend, IMPORT_V1_DEPENDENCIES peuvent encore mentionner .secrets/<env>/ pour l’historique V1→V2 : pour un déploiement multisite aligné, lire .secrets/lecoffreio/<env>/ (ligne notaire) ou le <site> réel à la place du plat.
Pages disponibles (docs/ racine)
| Fichier | Page wiki | Description |
|---|---|---|
| README.md | Readme | Index et correspondance (ce fichier). |
| API.md | Api | APIs externes (IdNot, Annuaire, Ancrage, agent IA notaire), contrats et évolution. |
| Operations.md | Operations | Retours prod, parcours, vérifications, scripts d’analyse, modalités d’analyse. |
| Frontend.md | Frontend | Toasters, messages 403, sources de textes front, paramétrage, parcours UI. |
| Code-Standards.md | Code-Standards | Lint, refactors, rôles et droits, conventions. |
| Deployment.md | Deployment | Env, seeds, site-texts, vérifications boot, déploiement. |
| Architecture.md | Architecture | Vue d’ensemble technique et intégrations. |
| compliance-annuaire-idnot-specs.md | Compliance-Annuaire-Idnot-Specs | Conformité API Annuaire V2 et ID.NOT (lookup, PP). |
Contenu des anciens dossiers docs/features/ et docs/fixKnowledge/ : ventilé dans les pages ci-dessus (pas de page dédiée FEATURES ni FIXKNOWLEDGE).
Mise à jour du wiki
Depuis la racine du dépôt qui contient docs/ : exécuter le script de migration (si disponible depuis ia_dev) pour pousser docs/*.md vers le wiki. Correspondance détaillée : projects/ia_dev/docs/GIT_ISSUES_SCRIPTS_AGENTS.md (section Migration docs/ → wiki). Ne pas committer docs/ (hors versionnement).
Dépôt applicatif lecoffre_ng_test (référence versionnée)
Le monorepo applicatif (deploy.repository_root dans projects/kogus/conf.json) versionne docs/ à sa racine : index docs/README.md, fiches docs/features/. Ce répertoire projects/kogus/docs/ sous ia_dev reste un miroir / notes d’intégration agents ; en cas d’écart, le dépôt Git du code fait foi. Alignement VERSION / front-common/src/front/version.json / CHANGELOG.md : voir la même section Numéro de version publié dans le docs/README.md du monorepo.