71 lines
3.3 KiB
Markdown
71 lines
3.3 KiB
Markdown
<!-- file: docs/decisions/DOCUMENT_ARCHIVE_SELECTION_POLICY.md -->
|
||
<!-- version: 2 -->
|
||
|
||
# Politique de sélection des archives documentaires
|
||
|
||
## 1. Objet
|
||
|
||
Cette politique définit les fichiers historiques qui peuvent être copiés depuis l’archive complète de `khadhroony-bot2` vers `olddocs/archivekbot2/`.
|
||
|
||
La sélection repose sur la fonction documentaire du fichier, et non sur son extension ni uniquement sur son emplacement.
|
||
|
||
## 2. Principe général
|
||
|
||
`olddocs/archivekbot2/` est une archive documentaire historique et non une copie partielle du workspace exécutable.
|
||
|
||
L’archive complète de bot2 reste la référence pour le code source, les fixtures, les configurations d’exécution et les artefacts nécessaires à la compilation ou aux tests.
|
||
|
||
## 3. Fichiers à conserver
|
||
|
||
Les catégories suivantes peuvent être conservées lorsqu’elles présentent une valeur historique, normative, architecturale ou décisionnelle :
|
||
|
||
- documents Markdown racine, sous `docs/`, sous `prompts/` et dans les anciennes crates ;
|
||
- changelogs, roadmaps, règles, audits, plans, rapports, guides et décisions ;
|
||
- matrices JSON décrivant une couverture, un contrat, une validation ou un inventaire ;
|
||
- IDL archivées servant de références pour la conception manuelle des futurs décodeurs, exécuteurs, matérialisateurs, matrices et tests ;
|
||
- schémas publics décrivant formellement un contrat de configuration ;
|
||
- exemples de configuration destinés aux utilisateurs ou aux opérateurs ;
|
||
- autres fichiers non exécutables dont la valeur documentaire est explicitement démontrée.
|
||
|
||
## 4. Fichiers à exclure
|
||
|
||
Les catégories suivantes ne doivent pas être copiées dans l’archive documentaire :
|
||
|
||
- code source et fichiers internes placés sous `src/`, même lorsqu’ils utilisent une extension documentaire, sauf décision explicite motivée ;
|
||
- fixtures de tests, snapshots et réponses RPC enregistrées ;
|
||
- manifests et configurations nécessaires au build ou au lancement de l’ancienne application ;
|
||
- fichiers Tauri, npm, TypeScript et capabilities servant à l’exécution ;
|
||
- bases de données, clés, preuves, données privées et fichiers temporaires ;
|
||
- artefacts générés ou reconstructibles sans valeur documentaire autonome.
|
||
|
||
## 5. Cas explicitement conservés
|
||
|
||
Les fichiers suivants sont conservés car leur fonction est documentaire :
|
||
|
||
```text
|
||
config/example.config.json
|
||
config/schema.config.json
|
||
docs/*_MATRIX.json
|
||
idls/*.json
|
||
```
|
||
|
||
`example.config.json` illustre la configuration utilisateur historique complète. `schema.config.json` formalise le contrat de cette configuration. Les matrices documentent les périmètres techniques et les validations. Les IDL sont des références archivées et ne sont pas chargées dynamiquement par le code de production.
|
||
|
||
## 6. Cas explicitement exclus
|
||
|
||
Les fichiers suivants sont exclus car ils relèvent de l’exécution ou des tests :
|
||
|
||
```text
|
||
kb_app_demo/capabilities/default.json
|
||
kb_app_demo/package.json
|
||
kb_app_demo/tauri.conf.json
|
||
kb_app_demo/tsconfig.json
|
||
kb_rpc/tests/fixtures/*.json
|
||
ks_store_core/src/**
|
||
ks_store_pg/src/**
|
||
```
|
||
|
||
## 7. Évolution de l’archive
|
||
|
||
Tout ajout futur à `olddocs/archivekbot2/` doit être évalué avec cette politique. En cas d’ambiguïté, le fichier n’est pas copié tant que sa valeur documentaire autonome n’est pas démontrée.
|