diff --git a/.vscode/tasks.json b/.vscode/tasks.json index afb2005..56e64f7 100644 --- a/.vscode/tasks.json +++ b/.vscode/tasks.json @@ -12,13 +12,13 @@ { "label": "Instance de test : démarrer", "type": "shell", - "command": "bash instance-de-test/demarrer.sh '${input:motDePasse}'", + "command": "bash instance-de-test/1_demarrer.sh '${input:motDePasse}'", "problemMatcher": [] }, { "label": "Instance de test : préparer", "type": "shell", - "command": "python3 instance-de-test/preparer.py '${input:motDePasse}'", + "command": "python3 instance-de-test/2_creer_boite_et_cle.py '${input:motDePasse}'", "problemMatcher": [] }, { @@ -36,19 +36,19 @@ { "label": "Instance de test : brancher sur Ollama", "type": "shell", - "command": "eval \"$(grep '^export ANTHROPIC_API_KEY=' .env)\" && python3 instance-de-test/configurer_ia.py '${input:motDePasse}' http://ollama:11434/v1 bge-m3:567m", + "command": "eval \"$(grep '^export ANTHROPIC_API_KEY=' .env)\" && python3 instance-de-test/3_brancher_ia.py '${input:motDePasse}' http://ollama:11434/v1 bge-m3:567m", "problemMatcher": [] }, { "label": "Instance de test : essai des brouillons", "type": "shell", - "command": "python3 instance-de-test/essayer_brouillons.py '${input:motDePasse}'", + "command": "python3 instance-de-test/4_essayer_brouillons.py '${input:motDePasse}'", "problemMatcher": [] }, { - "label": "Instance de test : empreintes des extraits", + "label": "Instance de test : voir les empreintes", "type": "shell", - "command": "bash instance-de-test/empreintes.sh", + "command": "bash instance-de-test/voir_empreintes.sh", "problemMatcher": [] }, { @@ -72,31 +72,31 @@ { "label": "Ollama : vérifier (poste, port 11435)", "type": "shell", - "command": "python3 ollama/verifier.py http://127.0.0.1:11435/v1", + "command": "python3 ollama/verifier_ollama.py http://127.0.0.1:11435/v1", "problemMatcher": [] }, { - "label": "Import : simulation (instance de test)", + "label": "Snippets : envoyer en simulation (instance de test)", "type": "shell", - "command": "set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer", + "command": "set -a && . instance-de-test/.env && set +a && python3 -m snippets.envoyer", "problemMatcher": [] }, { - "label": "Import : ÉCRIRE (instance de test)", + "label": "Snippets : ENVOYER (instance de test)", "type": "shell", - "command": "set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer --ecrire", + "command": "set -a && . instance-de-test/.env && set +a && python3 -m snippets.envoyer --ecrire", "problemMatcher": [] }, { - "label": "Import : simulation (PRODUCTION)", + "label": "Snippets : envoyer en simulation (PRODUCTION)", "type": "shell", - "command": "set -a && . ./.env && set +a && LIBREDESK_URL='${input:urlProduction}' python3 -m base_connaissances.importer", + "command": "set -a && . ./.env && set +a && LIBREDESK_URL='${input:urlProduction}' python3 -m snippets.envoyer", "problemMatcher": [] }, { - "label": "Import : ÉCRIRE (PRODUCTION)", + "label": "Snippets : ENVOYER (PRODUCTION)", "type": "shell", - "command": "[ \"${input:confirmationProduction}\" = oui ] || { echo annulé; exit 1; } && set -a && . ./.env && set +a && LIBREDESK_URL='${input:urlProduction}' python3 -m base_connaissances.importer --ecrire", + "command": "[ \"${input:confirmationProduction}\" = oui ] || { echo annulé; exit 1; } && set -a && . ./.env && set +a && LIBREDESK_URL='${input:urlProduction}' python3 -m snippets.envoyer --ecrire", "problemMatcher": [] } ], diff --git a/README.md b/README.md index e50dc3e..c7fb698 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ Les demandes des clients AIMsight arrivent par mail dans LibreDesk (`helpdesk.sensima.ch`). Dans une conversation, le bouton **« Generate reply »** rédige un brouillon dans l'éditeur, appuyé sur une base de connaissances (FAQ, manuel de la station, savoir métier : 118 extraits) et sur les échanges précédents du client. **Rien n'est envoyé : un humain relit et clique lui-même sur « Send ».** Ce dépôt porte tout ce qu'il faut pour cela : -- `base_connaissances/` : le corpus relu (un fichier par extrait), les instructions communes (`instructions.md`, à coller dans Admin → IA → Providers → Custom instructions) et l'import vers LibreDesk ; +- `snippets/` : les textes des snippets, relus (`textes/`, un fichier par snippet), les consignes de rédaction (`consignes_redaction.md`, à coller dans Admin → IA → Providers → Custom instructions) et l'import vers LibreDesk ; - `ollama/` : l'image Ollama avec le modèle d'embeddings `bge-m3:567m` embarqué, qui sert la recherche dans la base depuis le serveur de LibreDesk ; - `instance-de-test/` : un LibreDesk v2.9.0 local avec Mailpit (un piège SMTP : rien ne sort), pour tout essayer avant la production ; - `.vscode/tasks.json` : les opérations courantes en un clic (Terminal → Run Task). @@ -26,18 +26,18 @@ Sous WSL (Ubuntu), depuis `~/Support-LibreDesk`. Il faut `python3` (bibliothèqu python3 -m unittest discover -s tests -v ``` -Les secrets restent hors de git : `.env` (la clé Anthropic de l'instance de test, `export ANTHROPIC_API_KEY=…`, et les clés admin temporaires d'un import en production) et `instance-de-test/.env` (écrit par `preparer.py`). +Les secrets restent hors de git : `.env` (la clé Anthropic de l'instance de test, `export ANTHROPIC_API_KEY=…`, et les clés admin temporaires d'un import en production) et `instance-de-test/.env` (écrit par `2_creer_boite_et_cle.py`). ### L'instance de test Tâches « Instance de test : … », ou : ```bash -bash instance-de-test/demarrer.sh 'TestAdmin-2026!' +bash instance-de-test/1_demarrer.sh 'TestAdmin-2026!' ``` ```bash -python3 instance-de-test/preparer.py 'TestAdmin-2026!' +python3 instance-de-test/2_creer_boite_et_cle.py 'TestAdmin-2026!' ``` Puis Ollama sur son réseau (sur ce poste, un Ollama Windows occupe déjà le port 11434 : on publie sur 11435) : @@ -51,21 +51,21 @@ RESEAU_LIBREDESK=ldtest_libredesk OLLAMA_PORT=11435 docker compose -f ollama/com ``` ```bash -eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m +eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 instance-de-test/3_brancher_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m ``` ```bash -set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer --ecrire +set -a && . instance-de-test/.env && set +a && python3 -m snippets.envoyer --ecrire ``` L'essai des brouillons (5 mails, coûte quelques centimes de crédits Anthropic ; rapport dans `cases/`, hors de git) : ```bash -python3 instance-de-test/essayer_brouillons.py 'TestAdmin-2026!' +python3 instance-de-test/4_essayer_brouillons.py 'TestAdmin-2026!' ``` Interface : `http://127.0.0.1:9100` (utilisateur `System`) ; Mailpit : `http://127.0.0.1:9125`. Tout effacer : `docker compose -f instance-de-test/docker-compose.yml -p ldtest down -v`. ### Retoucher la base de connaissances -Modifier le fichier dans `base_connaissances/corpus/`, lancer les tests, puis l'import en simulation et en écriture (tâches « Import : … »). L'import apparie par titre, met à jour ce qui a changé et **ne supprime jamais** : un extrait retiré du corpus est seulement signalé. En production, il faut une clé admin temporaire (`docs/production.md`, point 4). +Modifier le fichier dans `snippets/textes/`, lancer les tests, puis l'import en simulation et en écriture (tâches « Snippets : … »). L'import apparie par titre, met à jour ce qui a changé et **ne supprime jamais** : un extrait retiré du corpus est seulement signalé. En production, il faut une clé admin temporaire (`docs/production.md`, point 4). diff --git a/docs/production.md b/docs/production.md index 37d69ea..348923b 100644 --- a/docs/production.md +++ b/docs/production.md @@ -8,13 +8,13 @@ Rien de ce qui suit n'envoie de message : « Generate reply » pose un brouillon ## Déjà fait (repris de Support-AI) -- [ ] **0. Relecture du savoir métier par Maxime.** Les 9 extraits de `base_connaissances/corpus/` dont la source est « Savoir métier AIMsight » ont été réécrits à la main à partir des notes d'analyse : vérifier qu'ils sont justes et bons à dire à un client. +- [ ] **0. Relecture du savoir métier par Maxime.** Les 9 extraits de `snippets/textes/` dont la source est « Savoir métier AIMsight » ont été réécrits à la main à partir des notes d'analyse : vérifier qu'ils sont justes et bons à dire à un client. - [x] **0 bis. Assistant** (2026-11-11). Admin → IA → Assistants : `support_assistant` désactivé (il répondrait seul aux clients si une règle lui confiait une conversation). Vérification : statut « Disabled ». - [x] **0 ter. Rien d'automatique** (vérifié le 2026-11-11). Admin → Automations : aucune règle ; Admin → IA → Tools : aucun outil ; aucun webhook ; Admin → IA → Suggestions : « Learn from resolved conversations » désactivé. - [x] **1 provisoire. LM Studio sur le PC de Maxime** (2026-11-11). `text-embedding-bge-m3` (bge-m3 Q8_0) sur `http://10.0.2.140:1234/v1` (adresse Wi-Fi attribuée par DHCP). Le PC doit rester allumé, LM Studio lancé avec son serveur actif. **Remplacé par Ollama ci-dessous.** - [x] **2. Embeddings** (2026-11-11). Fournisseur OpenAI, URL `http://10.0.2.140:1234/v1`, modèle `text-embedding-bge-m3`, clé `lm-studio`, *embedding max tokens* 2048. -- [x] **3. Complétion** (2026-11-11). *Max tokens* 4096 ; *Custom instructions* = `base_connaissances/instructions.md` ; Claude Sonnet 5.5, `https://api.anthropic.com/v1`, effort `medium`. -- [x] **4. Import de la base** (2026-11-11). 118 extraits actifs. Agent « Import base » (id 127) : clé révoquée, agent désactivé. Pour un réimport : regénérer une clé, réactiver l'agent, mettre la clé dans `.env` (`export LIBREDESK_ADMIN_KEY=…`, `export LIBREDESK_ADMIN_SECRET=…`), tâche « Import : simulation (PRODUCTION) » puis « Import : ÉCRIRE (PRODUCTION) », puis tout révoquer. +- [x] **3. Complétion** (2026-11-11). *Max tokens* 4096 ; *Custom instructions* = `snippets/consignes_redaction.md` ; Claude Sonnet 5.5, `https://api.anthropic.com/v1`, effort `medium`. +- [x] **4. Import de la base** (2026-11-11). 118 extraits actifs. Agent « Import base » (id 127) : clé révoquée, agent désactivé. Pour un réimport : regénérer une clé, réactiver l'agent, mettre la clé dans `.env` (`export LIBREDESK_ADMIN_KEY=…`, `export LIBREDESK_ADMIN_SECRET=…`), tâche « Snippets : envoyer en simulation (PRODUCTION) » puis « Snippets : ENVOYER (PRODUCTION) », puis tout révoquer. - [x] **5. Premiers brouillons** (2026-11-11, Maxime) : deux brouillons sur de vraies conversations, rien envoyé par l'IA. ## Ollama sur le serveur @@ -38,7 +38,7 @@ But : remplacer LM Studio par Ollama (`bge-m3:567m`) sur le serveur de LibreDesk - [ ] **8. Installer Ollama.** Copier sur le serveur **seulement** les deux fichiers compose et le script de vérification, **jamais le Dockerfile** : sans lui, le serveur ne peut pas construire l'image (une construction tirerait environ 10 Go sur le disque de LibreDesk). ```bash - ssh mkdir -p ollama && scp ollama/compose.yml ollama/compose.reseau.yml ollama/verifier.py :ollama/ + ssh mkdir -p ollama && scp ollama/compose.yml ollama/compose.reseau.yml ollama/verifier_ollama.py :ollama/ ``` Récupérer l'image : `docker login exchange.sensima.ch && docker pull exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:0.40.16-567m && docker logout exchange.sensima.ch` ; ou, si le registre l'a refusée, depuis le poste : `docker save exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:0.40.16-567m | gzip | ssh 'gunzip | docker load'`. Vérifier : `docker image ls exchange.sensima.ch/maxime.pasquier/ollama-bge-m3` montre le tag `0.40.16-567m`. Puis écrire `~/ollama/.env` sur le serveur. Docker Compose le lit à chaque commande lancée depuis `~/ollama` : les réglages ne dépendent d'aucune option à retenir, et un simple `docker compose …` garde toujours Ollama au bon endroit. Selon l'état des lieux : @@ -60,8 +60,8 @@ But : remplacer LM Studio par Ollama (`bge-m3:567m`) sur le serveur de LibreDesk Vérification : `docker ps --filter name=ollama-bge-m3` montre `Up … (healthy)` ; `docker inspect ollama-bge-m3 --format '{{.HostConfig.RestartPolicy.Name}}'` rend `unless-stopped` ; dans le cas Docker, `docker network inspect --format '{{range .Containers}}{{.Name}} {{end}}'` liste `ollama-bge-m3`. - [ ] **9. Vérifier Ollama.** - - Depuis le serveur : `python3 ~/ollama/verifier.py http://127.0.0.1:11434/v1` (ou l'adresse interne) → `OK bge-m3:567m, 1024 dimensions`. - - Depuis le réseau de LibreDesk (cas Docker) : `docker run --rm --network -v ~/ollama:/o:ro python:3.12-alpine python /o/verifier.py http://ollama:11434/v1` → même résultat (il faut que le serveur puisse tirer `python:3.12-alpine` ; sinon le test du point 10 depuis LibreDesk fait foi). + - Depuis le serveur : `python3 ~/ollama/verifier_ollama.py http://127.0.0.1:11434/v1` (ou l'adresse interne) → `OK bge-m3:567m, 1024 dimensions`. + - Depuis le réseau de LibreDesk (cas Docker) : `docker run --rm --network -v ~/ollama:/o:ro python:3.12-alpine python /o/verifier_ollama.py http://ollama:11434/v1` → même résultat (il faut que le serveur puisse tirer `python:3.12-alpine` ; sinon le test du point 10 depuis LibreDesk fait foi). - **De l'extérieur** : depuis un téléphone en 4G (Wi-Fi coupé), ouvrir `http://46.14.212.91:11434` : la page **ne doit pas répondre**. Si elle répond (« Ollama is running »), arrêter Ollama (`cd ~/ollama && docker compose down`) et revoir le point 7 avec la personne qui gère le serveur. - Si `python3` manque ou est trop ancien sur le serveur : `curl -s http://127.0.0.1:11434/v1/models` doit lister `bge-m3:567m`. - **Ne pas redémarrer le service Docker pour essayer** : cela redémarrerait aussi LibreDesk. `systemctl is-enabled docker` (point 7) et la politique `unless-stopped` suffisent ; le prochain redémarrage planifié du serveur le confirmera (vérifier alors `docker ps`). @@ -83,9 +83,9 @@ Admin → IA → Providers, Embeddings : remettre `http://10.0.2.140:1234/v1`, ` ## Au quotidien -- **Si Ollama est arrêté**, « Generate reply » rend quand même un brouillon, mais **sans la base de connaissances**, et rien ne le signale à l'agent (journaux de LibreDesk : `AI provider unavailable`, `search_articles` en erreur). Si les brouillons deviennent vagues : `docker ps --filter name=ollama-bge-m3` et `python3 ~/ollama/verifier.py …` sur le serveur. Pour le relancer (un arrêt manuel n'est pas relancé seul), toujours `cd ~/ollama && docker compose up -d --no-build` plutôt que `docker start` : si LibreDesk a recréé son réseau entre-temps, seul Compose y rattache Ollama. +- **Si Ollama est arrêté**, « Generate reply » rend quand même un brouillon, mais **sans la base de connaissances**, et rien ne le signale à l'agent (journaux de LibreDesk : `AI provider unavailable`, `search_articles` en erreur). Si les brouillons deviennent vagues : `docker ps --filter name=ollama-bge-m3` et `python3 ~/ollama/verifier_ollama.py …` sur le serveur. Pour le relancer (un arrêt manuel n'est pas relancé seul), toujours `cd ~/ollama && docker compose up -d --no-build` plutôt que `docker start` : si LibreDesk a recréé son réseau entre-temps, seul Compose y rattache Ollama. - **Ollama est rattaché au réseau de LibreDesk** (cas Docker) : tant qu'il y est, un `docker compose down` de LibreDesk ne peut pas supprimer ce réseau (avertissement « Resource is still in use », ou erreur avec l'ancien `docker-compose`). Arrêter Ollama d'abord (`cd ~/ollama && docker compose down`), puis le relancer après LibreDesk. -- **Retoucher la base** : modifier le fichier dans `base_connaissances/corpus/`, puis réimporter (point 4). Un extrait renommé ou retiré du corpus est signalé (« dans LibreDesk mais pas dans le corpus ») et **n'est pas supprimé** : le désactiver ou le supprimer à la main dans Admin → IA → Snippets. +- **Retoucher la base** : modifier le fichier dans `snippets/textes/`, puis réimporter (point 4). Un extrait renommé ou retiré du corpus est signalé (« dans LibreDesk mais pas dans le corpus ») et **n'est pas supprimé** : le désactiver ou le supprimer à la main dans Admin → IA → Snippets. - **Changer de version d'Ollama** : modifier `ollama/Dockerfile`, reconstruire, revérifier hors ligne et sur l'instance de test, puis refaire les points 6, 8 et 9. Même modèle, même adresse : pas de recalcul. ## Plus tard @@ -99,5 +99,5 @@ Admin → IA → Providers, Embeddings : remettre `http://10.0.2.140:1234/v1`, ` - Les puces « • » des PDF ne sont pas converties en listes dans quelques extraits (cosmétique). - L'import réactive un extrait désactivé à la main quand son contenu change, écrase un extrait appris de même titre, et n'affiche que des comptes en écriture. La liste des extraits n'est pas paginée. - Lancer l'import depuis un Python Windows pourrait mal lire les accents : toujours passer par WSL. -- `essayer_brouillons.py` est fragile si la réponse est vide ou tardive. +- `4_essayer_brouillons.py` est fragile si la réponse est vide ou tardive. - La clé d'import a le rôle Admin ; un rôle limité à `ai:manage` suffirait. diff --git a/docs/superpowers/plans/2026-11-12-support-libredesk.md b/docs/superpowers/plans/2026-11-12-support-libredesk.md index 181d59d..4665454 100644 --- a/docs/superpowers/plans/2026-11-12-support-libredesk.md +++ b/docs/superpowers/plans/2026-11-12-support-libredesk.md @@ -1,5 +1,7 @@ # Support-LibreDesk : plan de réalisation +> **Noms renommés le 2026-11-12, après ce document** : `base_connaissances/` → `snippets/` (`corpus/` → `textes/`, `instructions.md` → `consignes_redaction.md`, `decoupage.py` → `fichiers.py`, `importer.py` → `envoyer.py`) ; dans `instance-de-test/` : `demarrer.sh` → `1_demarrer.sh`, `preparer.py` → `2_creer_boite_et_cle.py`, `configurer_ia.py` → `3_brancher_ia.py`, `essayer_brouillons.py` → `4_essayer_brouillons.py`, `empreintes.sh` → `voir_empreintes.sh`, `session.py` → `connexion_admin.py` ; `ollama/verifier.py` → `ollama/verifier_ollama.py`. Ce document garde les noms d origine. + > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. **Goal :** un dépôt autonome qui porte le brouillon de réponse de LibreDesk (base de connaissances, import, instructions communes, instance de test, tâches VS Code) et l'image Ollama + bge-m3 qui remplace LM Studio en production, éprouvée sur le poste de Maxime. diff --git a/docs/superpowers/specs/2026-11-12-support-libredesk-design.md b/docs/superpowers/specs/2026-11-12-support-libredesk-design.md index 34aee32..4af87e0 100644 --- a/docs/superpowers/specs/2026-11-12-support-libredesk-design.md +++ b/docs/superpowers/specs/2026-11-12-support-libredesk-design.md @@ -1,5 +1,7 @@ # Design : Support-LibreDesk, le brouillon de réponse dans LibreDesk +> **Noms renommés le 2026-11-12, après ce document** : `base_connaissances/` → `snippets/` (`corpus/` → `textes/`, `instructions.md` → `consignes_redaction.md`, `decoupage.py` → `fichiers.py`, `importer.py` → `envoyer.py`) ; dans `instance-de-test/` : `demarrer.sh` → `1_demarrer.sh`, `preparer.py` → `2_creer_boite_et_cle.py`, `configurer_ia.py` → `3_brancher_ia.py`, `essayer_brouillons.py` → `4_essayer_brouillons.py`, `empreintes.sh` → `voir_empreintes.sh`, `session.py` → `connexion_admin.py` ; `ollama/verifier.py` → `ollama/verifier_ollama.py`. Ce document garde les noms d origine. + Date : 2026-11-12. Issu d'un brainstorming entre Maxime et Claude, après lecture complète de `~/Support-AI` (tout ce qui touche à LibreDesk). ## 1. L'intention diff --git a/docs/verifications.md b/docs/verifications.md index daad4ac..26ad07b 100644 --- a/docs/verifications.md +++ b/docs/verifications.md @@ -29,21 +29,21 @@ Repris de Support-AI (vérifications des 2026-11-09 et 2026-11-11), limité à c Instance de test neuve (LibreDesk v2.9.0, Mailpit), base importée (118 extraits), image `exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:0.40.16-567m` (Ollama 0.40.16, `bge-m3:567m`, **2,43 Go**) sur le réseau Docker de l'instance (`ollama/compose.reseau.yml`). **L'image** -- Hors ligne (réseau Docker `--internal`, aucun DNS) : `verifier.py` → `OK bge-m3:567m, 1024 dimensions`. Aucun appel à `ollama.com` grâce à `OLLAMA_NO_CLOUD=1`. +- Hors ligne (réseau Docker `--internal`, aucun DNS) : `verifier_ollama.py` → `OK bge-m3:567m, 1024 dimensions`. Aucun appel à `ollama.com` grâce à `OLLAMA_NO_CLOUD=1`. - Construite en deux étapes : sans les bibliothèques GPU de l'image officielle (CUDA, ROCm, Vulkan : 4,4 Go), l'image passe de 10,7 Go à 2,43 Go. Calcul sur processeur (`inference compute … library=cpu`). - Redémarrage automatique : après un arrêt du processus dans le conteneur, Docker le relance (`RestartCount` 1) et il sert de nouveau bge-m3. Un `docker kill` ou `docker stop` compte comme un arrêt manuel : `unless-stopped` ne relance pas, c'est voulu. Le redémarrage du service Docker n'a pas été essayé sur le poste (demande `sudo`) : à vérifier sur le serveur. - Sur le poste de Maxime, un Ollama Windows occupe déjà `127.0.0.1:11434` : les essais publient sur 11435 (`OLLAMA_PORT=11435`). **Le recalcul des vecteurs, automatique** (LM Studio n'était pas lancé : l'instance est passée d'une adresse d'Ollama, `http://ollama-bge-m3:11434/v1`, à une autre, `http://ollama:11434/v1` ; c'est le même déclenchement que LM Studio → Ollama, un changement d'URL) - Premier branchement : « embedding provider changed, reindexing knowledge base », puis « reconciled embeddings … reindexed=118 », 118 extraits indexés en une minute environ. -- Changement d'adresse (`configurer_ia.py`, test puis enregistrement) : de nouveau « embedding provider changed » (`old_base_url=http://ollama-bge-m3:11434/v1 new_base_url=http://ollama:11434/v1`), puis « reindexed=118 ». Empreintes (`empreintes.sh`) : 118, aucune vide, **aucune identique** à celles d'avant. +- Changement d'adresse (`3_brancher_ia.py`, test puis enregistrement) : de nouveau « embedding provider changed » (`old_base_url=http://ollama-bge-m3:11434/v1 new_base_url=http://ollama:11434/v1`), puis « reindexed=118 ». Empreintes (`voir_empreintes.sh`) : 118, aucune vide, **aucune identique** à celles d'avant. - Attention en lisant les journaux : « reconciled embeddings … reindexed=N » compte les extraits **tentés**, pas réussis. La preuve, ce sont les empreintes (instance de test) ou l'absence d'« error generating embeddings » après le message (production). **Ollama arrêté pendant le recalcul** - Ollama arrêté, nouvelle adresse enregistrée sans test : 74 « error generating embeddings » ; les empreintes et les vecteurs précédents restent en place (rien n'est effacé, la recherche garde les anciens vecteurs). - Ollama relancé : LibreDesk retente seul (chaque minute) ; les 118 empreintes sont recalculées environ trois minutes après la reprise, sans intervention. -**L'essai des brouillons** (`essayer_brouillons.py`, rapport `cases/essai-brouillons-2026-11-12.md`, hors de git) +**L'essai des brouillons** (`4_essayer_brouillons.py`, rapport `cases/essai-brouillons-2026-11-12.md`, hors de git) - 5 brouillons sur 5 `completed`, en 4 à 11 s ; Mailpit inchangé pendant la génération. - `search_articles` appelé pour chaque brouillon (14 appels) ; scores des extraits retenus de 0,49 à 0,59, comme avec LM Studio le 2026-11-11 (0,55 à 0,59). - Le brouillon 4G s'appuie sur le manuel (adresse locale 192.168.1.2, Link status, APN, SIM 3FF, antenne SMA). À faire juger par Maxime, comme l'essai LM Studio. diff --git a/instance-de-test/demarrer.sh b/instance-de-test/1_demarrer.sh similarity index 89% rename from instance-de-test/demarrer.sh rename to instance-de-test/1_demarrer.sh index 10a3721..c55e045 100644 --- a/instance-de-test/demarrer.sh +++ b/instance-de-test/1_demarrer.sh @@ -1,9 +1,9 @@ #!/usr/bin/env bash # Lance l'instance de test (LibreDesk v2.9.0, Postgres, Redis, Mailpit). Rien ne sort : le SMTP est Mailpit. -# bash instance-de-test/demarrer.sh +# bash instance-de-test/1_demarrer.sh set -euo pipefail cd "$(dirname "$0")" -MDP="${1:?usage : demarrer.sh }" +MDP="${1:?usage : 1_demarrer.sh }" if [ ! -f config.toml ]; then curl -fsS -o config.toml https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml diff --git a/instance-de-test/preparer.py b/instance-de-test/2_creer_boite_et_cle.py similarity index 92% rename from instance-de-test/preparer.py rename to instance-de-test/2_creer_boite_et_cle.py index 402fcf3..9bbffa7 100644 --- a/instance-de-test/preparer.py +++ b/instance-de-test/2_creer_boite_et_cle.py @@ -2,12 +2,12 @@ « Import base » (rôle Admin) avec sa clé. Écrase instance-de-test/.env (LIBREDESK_URL, LIBREDESK_ADMIN_KEY, LIBREDESK_ADMIN_SECRET). S'arrête si l'instance est déjà préparée. -python3 instance-de-test/preparer.py +python3 instance-de-test/2_creer_boite_et_cle.py """ import sys from pathlib import Path -from session import B, connexion, req +from connexion_admin import B, connexion, req SMTP = {"enabled": True, "host": "mailpit", "port": 1025, "username": "", "password": "", "auth_protocol": "none", "tls_type": "none", "max_conns": 1, "max_msg_retries": 0, "idle_timeout": "5s", "pool_wait_timeout": "5s", @@ -19,7 +19,7 @@ IMAP = {"host": "127.0.0.1", "port": 1, "username": "x", "password": "x", "mailb def main(mot_de_passe: str) -> None: connexion(mot_de_passe) if any(b["name"] == "Test" for b in req("GET", "/api/v1/inboxes") or []): - sys.exit("instance déjà préparée : docker compose -p ldtest down -v, puis demarrer.sh") + sys.exit("instance déjà préparée : docker compose -p ldtest down -v, puis 1_demarrer.sh") req("POST", "/api/v1/inboxes", {"name": "Test", "channel": "email", "enabled": True, "csat_enabled": False, "from": "Support ", "config": {"auth_type": "password", "from": "Support ", diff --git a/instance-de-test/configurer_ia.py b/instance-de-test/3_brancher_ia.py similarity index 83% rename from instance-de-test/configurer_ia.py rename to instance-de-test/3_brancher_ia.py index ded46e8..46066f5 100644 --- a/instance-de-test/configurer_ia.py +++ b/instance-de-test/3_brancher_ia.py @@ -2,16 +2,16 @@ Teste chaque configuration avant de l'enregistrer. Rejouable : c'est lui qui fait passer l'instance d'un fournisseur d'embeddings à un autre (LibreDesk recalcule alors seul les vecteurs). Ne crée ni assistant ni règle. -ANTHROPIC_API_KEY=… python3 instance-de-test/configurer_ia.py [clé] +ANTHROPIC_API_KEY=… python3 instance-de-test/3_brancher_ia.py [clé] ex. : … 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m """ import os import sys from pathlib import Path -from session import connexion, req +from connexion_admin import connexion, req -INSTRUCTIONS = Path(__file__).resolve().parents[1] / "base_connaissances" / "instructions.md" +CONSIGNES = Path(__file__).resolve().parents[1] / "snippets" / "consignes_redaction.md" def configurer(type_: str, config: dict) -> None: @@ -25,7 +25,7 @@ def main(mot_de_passe: str, url_embeddings: str, modele: str, cle: str = "ollama connexion(mot_de_passe) configurer("completion", {"provider": "openai", "base_url": "https://api.anthropic.com/v1", "api_key": cle_claude, "model": "claude-sonnet-5-5", "max_tokens": 4096, "reasoning_effort": "medium", - "instructions": INSTRUCTIONS.read_text(encoding="utf-8").strip(), "vision": True}) + "instructions": CONSIGNES.read_text(encoding="utf-8").strip(), "vision": True}) configurer("embedding", {"provider": "openai", "base_url": url_embeddings, "api_key": cle, "model": modele, "dimensions": 0, "embedding_max_tokens": 2048}) diff --git a/instance-de-test/essayer_brouillons.py b/instance-de-test/4_essayer_brouillons.py similarity index 93% rename from instance-de-test/essayer_brouillons.py rename to instance-de-test/4_essayer_brouillons.py index cc70f29..7dc7bde 100644 --- a/instance-de-test/essayer_brouillons.py +++ b/instance-de-test/4_essayer_brouillons.py @@ -1,9 +1,9 @@ -"""L'essai des brouillons sur l'instance de test (après preparer.py et configurer_ia.py) : une conversation par mail de +"""L'essai des brouillons sur l'instance de test (après 2_creer_boite_et_cle.py et 3_brancher_ia.py) : une conversation par mail de instance-de-test/mails/, « Generate reply » sur chacune, un rapport dans cases/ (hors de git) à faire juger. Vérifie que Mailpit ne reçoit rien pendant la génération : un brouillon ne doit jamais partir. -python3 instance-de-test/essayer_brouillons.py [mot de passe System] +python3 instance-de-test/4_essayer_brouillons.py [mot de passe System] """ import datetime import html @@ -14,7 +14,7 @@ import time import urllib.request from pathlib import Path -from session import connexion, req +from connexion_admin import connexion, req MAILPIT = "http://127.0.0.1:9125/api/v1/messages" ICI = Path(__file__).resolve().parent diff --git a/instance-de-test/session.py b/instance-de-test/connexion_admin.py similarity index 100% rename from instance-de-test/session.py rename to instance-de-test/connexion_admin.py diff --git a/instance-de-test/empreintes.sh b/instance-de-test/voir_empreintes.sh similarity index 100% rename from instance-de-test/empreintes.sh rename to instance-de-test/voir_empreintes.sh diff --git a/ollama/Dockerfile b/ollama/Dockerfile index a797ebd..8b0e301 100644 --- a/ollama/Dockerfile +++ b/ollama/Dockerfile @@ -1,5 +1,5 @@ # Ollama avec bge-m3 embarqué : l'image démarre sans rien télécharger, et c'est le même modèle partout. -# Versions figées (2026-11-12) ; les changer = reconstruire et revérifier (ollama/verifier.py). +# Versions figées (2026-11-12) ; les changer = reconstruire et revérifier (ollama/verifier_ollama.py). # 1. Le modèle, téléchargé à la construction par l'image officielle (un serveur lancé le temps du pull) ; # puis les bibliothèques GPU retirées (4,4 Go de CUDA) : bge-m3 tourne sur processeur. diff --git a/ollama/verifier.py b/ollama/verifier_ollama.py similarity index 97% rename from ollama/verifier.py rename to ollama/verifier_ollama.py index 5d5711b..55fb90b 100644 --- a/ollama/verifier.py +++ b/ollama/verifier_ollama.py @@ -1,7 +1,7 @@ """Vérifie qu'une adresse Ollama (format OpenAI) sert bge-m3:567m en dimension 1024, comme LibreDesk l'attend. Bibliothèque standard seulement : tourne sur le poste, sur le serveur, ou dans un conteneur python. -python3 ollama/verifier.py http://127.0.0.1:11434/v1 +python3 ollama/verifier_ollama.py http://127.0.0.1:11434/v1 """ from __future__ import annotations # lisible par le Python du serveur, même ancien (3.8, 3.9) diff --git a/base_connaissances/__init__.py b/snippets/__init__.py similarity index 100% rename from base_connaissances/__init__.py rename to snippets/__init__.py diff --git a/base_connaissances/instructions.md b/snippets/consignes_redaction.md similarity index 100% rename from base_connaissances/instructions.md rename to snippets/consignes_redaction.md diff --git a/base_connaissances/importer.py b/snippets/envoyer.py similarity index 90% rename from base_connaissances/importer.py rename to snippets/envoyer.py index 3a890e6..08ee192 100644 --- a/base_connaissances/importer.py +++ b/snippets/envoyer.py @@ -1,10 +1,10 @@ -"""Pousse le corpus dans la base de connaissances de LibreDesk (les « extraits », privés, lus par l'IA seulement). +"""Envoie les textes de snippets/textes/ dans LibreDesk : ce sont ses snippets (les « extraits », privés, lus par l'IA seulement). Idempotent : apparie par titre, crée l'absent, met à jour ce qui a changé, ne touche pas le reste. Ne supprime jamais : -un extrait de LibreDesk absent du corpus est seulement signalé. Ne parle qu'aux routes des extraits. Simulation par +un extrait de LibreDesk absent de snippets/textes/ est seulement signalé. Ne parle qu'aux routes des extraits. Simulation par défaut : rien n'est écrit sans --ecrire. Il faut une clé d'administrateur (les routes exigent ai:manage). -LIBREDESK_URL=… LIBREDESK_ADMIN_KEY=… LIBREDESK_ADMIN_SECRET=… python -m base_connaissances.importer [--ecrire] +LIBREDESK_URL=… LIBREDESK_ADMIN_KEY=… LIBREDESK_ADMIN_SECRET=… python -m snippets.envoyer [--ecrire] """ import html as html_lib import json @@ -17,9 +17,9 @@ import urllib.request from dataclasses import dataclass, field from pathlib import Path -from base_connaissances.decoupage import Extrait, lire_corpus +from snippets.fichiers import Extrait, lire_textes -CORPUS = Path(__file__).resolve().parent / "corpus" +TEXTES = Path(__file__).resolve().parent / "textes" PUCE = re.compile(r"^\s*- ") @@ -120,11 +120,11 @@ def main(argv: list[str]) -> None: ecrire = "--ecrire" in argv api = Extraits(os.environ["LIBREDESK_URL"], os.environ["LIBREDESK_ADMIN_KEY"], os.environ["LIBREDESK_ADMIN_SECRET"], ecrire=ecrire) - b = synchroniser(api, lire_corpus(CORPUS)) + b = synchroniser(api, lire_textes(TEXTES)) print(f"créés {len(b.crees)}, modifiés {len(b.modifies)}, inchangés {len(b.inchanges)}" + ("" if ecrire else " (simulation : rien n'a été écrit)")) for t in b.inconnus: - print(f"dans LibreDesk mais pas dans le corpus (non supprimé) : {t}") + print(f"dans LibreDesk mais pas dans snippets/textes/ (non supprimé) : {t}") if __name__ == "__main__": diff --git a/base_connaissances/decoupage.py b/snippets/fichiers.py similarity index 95% rename from base_connaissances/decoupage.py rename to snippets/fichiers.py index 7ea0c07..bee5441 100644 --- a/base_connaissances/decoupage.py +++ b/snippets/fichiers.py @@ -1,5 +1,5 @@ """Du texte d'un PDF (sortie de `pdftotext`, sans `-layout`) ou d'un Markdown aux extraits de la base de connaissances -de LibreDesk ; écriture et lecture du corpus (un fichier Markdown par extrait).""" +de LibreDesk ; écriture et lecture de snippets/textes/ (un fichier Markdown par extrait).""" import re import unicodedata from dataclasses import dataclass @@ -95,13 +95,13 @@ def decouper_markdown(texte: str, source: str, max_car: int = 6000) -> list[Extr return [Extrait(t, "\n".join(c).strip(), source) for t, c in sections if "\n".join(c).strip()] -def ecrire_corpus(extraits: list[Extrait], dossier: Path) -> None: +def ecrire_textes(extraits: list[Extrait], dossier: Path) -> None: dossier.mkdir(parents=True, exist_ok=True) for e in extraits: (dossier / e.cle).write_text(f"# {e.titre}\n\n{e.contenu}\n\nSource : {e.source}\n") -def lire_corpus(dossier: Path) -> list[Extrait]: +def lire_textes(dossier: Path) -> list[Extrait]: extraits = [] for f in sorted(dossier.glob("*.md")): tete, reste = f.read_text().rstrip("\n").split("\n\n", 1) diff --git a/base_connaissances/corpus/aimsight-cloud-optional-service-how-can-i-apply-a-target-configuration-from-a-historical-image.md b/snippets/textes/aimsight-cloud-optional-service-how-can-i-apply-a-target-configuration-from-a-historical-image.md similarity index 100% rename from base_connaissances/corpus/aimsight-cloud-optional-service-how-can-i-apply-a-target-configuration-from-a-historical-image.md rename to snippets/textes/aimsight-cloud-optional-service-how-can-i-apply-a-target-configuration-from-a-historical-image.md diff --git a/base_connaissances/corpus/aimsight-cloud-optional-service-which-additional-diagnostic-and-post-processing-tools-are-available.md b/snippets/textes/aimsight-cloud-optional-service-which-additional-diagnostic-and-post-processing-tools-are-available.md similarity index 100% rename from base_connaissances/corpus/aimsight-cloud-optional-service-which-additional-diagnostic-and-post-processing-tools-are-available.md rename to snippets/textes/aimsight-cloud-optional-service-which-additional-diagnostic-and-post-processing-tools-are-available.md diff --git a/base_connaissances/corpus/are-white-enamel-targets-with-a-black-border-suitable-other-home-made-targets.md b/snippets/textes/are-white-enamel-targets-with-a-black-border-suitable-other-home-made-targets.md similarity index 100% rename from base_connaissances/corpus/are-white-enamel-targets-with-a-black-border-suitable-other-home-made-targets.md rename to snippets/textes/are-white-enamel-targets-with-a-black-border-suitable-other-home-made-targets.md diff --git a/base_connaissances/corpus/can-aimsight-activate-a-relay-or-dry-contact-alarm.md b/snippets/textes/can-aimsight-activate-a-relay-or-dry-contact-alarm.md similarity index 100% rename from base_connaissances/corpus/can-aimsight-activate-a-relay-or-dry-contact-alarm.md rename to snippets/textes/can-aimsight-activate-a-relay-or-dry-contact-alarm.md diff --git a/base_connaissances/corpus/can-aimsight-be-installed-in-a-marine-environment.md b/snippets/textes/can-aimsight-be-installed-in-a-marine-environment.md similarity index 100% rename from base_connaissances/corpus/can-aimsight-be-installed-in-a-marine-environment.md rename to snippets/textes/can-aimsight-be-installed-in-a-marine-environment.md diff --git a/base_connaissances/corpus/can-aimsight-measure-without-dedicated-targets.md b/snippets/textes/can-aimsight-measure-without-dedicated-targets.md similarity index 100% rename from base_connaissances/corpus/can-aimsight-measure-without-dedicated-targets.md rename to snippets/textes/can-aimsight-measure-without-dedicated-targets.md diff --git a/base_connaissances/corpus/can-aimsight-perform-event-triggered-or-high-speed-measurements.md b/snippets/textes/can-aimsight-perform-event-triggered-or-high-speed-measurements.md similarity index 100% rename from base_connaissances/corpus/can-aimsight-perform-event-triggered-or-high-speed-measurements.md rename to snippets/textes/can-aimsight-perform-event-triggered-or-high-speed-measurements.md diff --git a/base_connaissances/corpus/can-i-retrieve-measurements-acquired-before-ftp-was-configured.md b/snippets/textes/can-i-retrieve-measurements-acquired-before-ftp-was-configured.md similarity index 100% rename from base_connaissances/corpus/can-i-retrieve-measurements-acquired-before-ftp-was-configured.md rename to snippets/textes/can-i-retrieve-measurements-acquired-before-ftp-was-configured.md diff --git a/base_connaissances/corpus/can-the-camera-automatically-scan-several-monitoring-areas.md b/snippets/textes/can-the-camera-automatically-scan-several-monitoring-areas.md similarity index 100% rename from base_connaissances/corpus/can-the-camera-automatically-scan-several-monitoring-areas.md rename to snippets/textes/can-the-camera-automatically-scan-several-monitoring-areas.md diff --git a/base_connaissances/corpus/can-two-cameras-be-combined-to-obtain-x-y-and-z-displacement.md b/snippets/textes/can-two-cameras-be-combined-to-obtain-x-y-and-z-displacement.md similarity index 100% rename from base_connaissances/corpus/can-two-cameras-be-combined-to-obtain-x-y-and-z-displacement.md rename to snippets/textes/can-two-cameras-be-combined-to-obtain-x-y-and-z-displacement.md diff --git a/base_connaissances/corpus/ce-que-le-client-regarde-dans-les-deplacements.md b/snippets/textes/ce-que-le-client-regarde-dans-les-deplacements.md similarity index 100% rename from base_connaissances/corpus/ce-que-le-client-regarde-dans-les-deplacements.md rename to snippets/textes/ce-que-le-client-regarde-dans-les-deplacements.md diff --git a/base_connaissances/corpus/does-the-camera-operate-without-a-cloud-connection.md b/snippets/textes/does-the-camera-operate-without-a-cloud-connection.md similarity index 100% rename from base_connaissances/corpus/does-the-camera-operate-without-a-cloud-connection.md rename to snippets/textes/does-the-camera-operate-without-a-cloud-connection.md diff --git a/base_connaissances/corpus/does-the-system-detect-excessive-camera-instability.md b/snippets/textes/does-the-system-detect-excessive-camera-instability.md similarity index 100% rename from base_connaissances/corpus/does-the-system-detect-excessive-camera-instability.md rename to snippets/textes/does-the-system-detect-excessive-camera-instability.md diff --git a/base_connaissances/corpus/how-are-targets-with-excessive-recognition-error-handled-in-data-exploration.md b/snippets/textes/how-are-targets-with-excessive-recognition-error-handled-in-data-exploration.md similarity index 100% rename from base_connaissances/corpus/how-are-targets-with-excessive-recognition-error-handled-in-data-exploration.md rename to snippets/textes/how-are-targets-with-excessive-recognition-error-handled-in-data-exploration.md diff --git a/base_connaissances/corpus/how-can-i-access-the-camera-locally.md b/snippets/textes/how-can-i-access-the-camera-locally.md similarity index 100% rename from base_connaissances/corpus/how-can-i-access-the-camera-locally.md rename to snippets/textes/how-can-i-access-the-camera-locally.md diff --git a/base_connaissances/corpus/how-can-i-detect-deformation-of-the-reference-network.md b/snippets/textes/how-can-i-detect-deformation-of-the-reference-network.md similarity index 100% rename from base_connaissances/corpus/how-can-i-detect-deformation-of-the-reference-network.md rename to snippets/textes/how-can-i-detect-deformation-of-the-reference-network.md diff --git a/base_connaissances/corpus/how-can-i-export-the-advanced-diagnostic-metrics.md b/snippets/textes/how-can-i-export-the-advanced-diagnostic-metrics.md similarity index 100% rename from base_connaissances/corpus/how-can-i-export-the-advanced-diagnostic-metrics.md rename to snippets/textes/how-can-i-export-the-advanced-diagnostic-metrics.md diff --git a/base_connaissances/corpus/how-can-i-redefine-the-zero-reference-position-used-for-rx-and-ry.md b/snippets/textes/how-can-i-redefine-the-zero-reference-position-used-for-rx-and-ry.md similarity index 100% rename from base_connaissances/corpus/how-can-i-redefine-the-zero-reference-position-used-for-rx-and-ry.md rename to snippets/textes/how-can-i-redefine-the-zero-reference-position-used-for-rx-and-ry.md diff --git a/base_connaissances/corpus/how-do-atmospheric-turbulence-and-heat-shimmer-affect-measurements.md b/snippets/textes/how-do-atmospheric-turbulence-and-heat-shimmer-affect-measurements.md similarity index 100% rename from base_connaissances/corpus/how-do-atmospheric-turbulence-and-heat-shimmer-affect-measurements.md rename to snippets/textes/how-do-atmospheric-turbulence-and-heat-shimmer-affect-measurements.md diff --git a/base_connaissances/corpus/how-many-points-can-one-aimsight-station-monitor.md b/snippets/textes/how-many-points-can-one-aimsight-station-monitor.md similarity index 100% rename from base_connaissances/corpus/how-many-points-can-one-aimsight-station-monitor.md rename to snippets/textes/how-many-points-can-one-aimsight-station-monitor.md diff --git a/base_connaissances/corpus/how-should-reference-targets-be-selected.md b/snippets/textes/how-should-reference-targets-be-selected.md similarity index 100% rename from base_connaissances/corpus/how-should-reference-targets-be-selected.md rename to snippets/textes/how-should-reference-targets-be-selected.md diff --git a/base_connaissances/corpus/is-a-thermal-camera-option-available.md b/snippets/textes/is-a-thermal-camera-option-available.md similarity index 100% rename from base_connaissances/corpus/is-a-thermal-camera-option-available.md rename to snippets/textes/is-a-thermal-camera-option-available.md diff --git a/base_connaissances/corpus/is-dedicated-monitoring-software-available.md b/snippets/textes/is-dedicated-monitoring-software-available.md similarity index 100% rename from base_connaissances/corpus/is-dedicated-monitoring-software-available.md rename to snippets/textes/is-dedicated-monitoring-software-available.md diff --git a/base_connaissances/corpus/is-periodic-metrological-maintenance-required.md b/snippets/textes/is-periodic-metrological-maintenance-required.md similarity index 100% rename from base_connaissances/corpus/is-periodic-metrological-maintenance-required.md rename to snippets/textes/is-periodic-metrological-maintenance-required.md diff --git a/base_connaissances/corpus/is-the-software-web-based-or-desktop-based.md b/snippets/textes/is-the-software-web-based-or-desktop-based.md similarity index 100% rename from base_connaissances/corpus/is-the-software-web-based-or-desktop-based.md rename to snippets/textes/is-the-software-web-based-or-desktop-based.md diff --git a/base_connaissances/corpus/la-batterie-et-l-alimentation-de-la-station.md b/snippets/textes/la-batterie-et-l-alimentation-de-la-station.md similarity index 100% rename from base_connaissances/corpus/la-batterie-et-l-alimentation-de-la-station.md rename to snippets/textes/la-batterie-et-l-alimentation-de-la-station.md diff --git a/base_connaissances/corpus/la-chaine-de-mesure-d-ou-vient-une-anomalie.md b/snippets/textes/la-chaine-de-mesure-d-ou-vient-une-anomalie.md similarity index 100% rename from base_connaissances/corpus/la-chaine-de-mesure-d-ou-vient-une-anomalie.md rename to snippets/textes/la-chaine-de-mesure-d-ou-vient-une-anomalie.md diff --git a/base_connaissances/corpus/le-cycle-thermique-les-vagues-de-la-journee.md b/snippets/textes/le-cycle-thermique-les-vagues-de-la-journee.md similarity index 100% rename from base_connaissances/corpus/le-cycle-thermique-les-vagues-de-la-journee.md rename to snippets/textes/le-cycle-thermique-les-vagues-de-la-journee.md diff --git a/base_connaissances/corpus/les-familles-d-anomalies-et-ce-qu-elles-veulent-dire-pour-le-client.md b/snippets/textes/les-familles-d-anomalies-et-ce-qu-elles-veulent-dire-pour-le-client.md similarity index 100% rename from base_connaissances/corpus/les-familles-d-anomalies-et-ce-qu-elles-veulent-dire-pour-le-client.md rename to snippets/textes/les-familles-d-anomalies-et-ce-qu-elles-veulent-dire-pour-le-client.md diff --git a/base_connaissances/corpus/les-metriques-systeme-de-la-station.md b/snippets/textes/les-metriques-systeme-de-la-station.md similarity index 100% rename from base_connaissances/corpus/les-metriques-systeme-de-la-station.md rename to snippets/textes/les-metriques-systeme-de-la-station.md diff --git a/base_connaissances/corpus/les-trous-pourquoi-des-mesures-manquent.md b/snippets/textes/les-trous-pourquoi-des-mesures-manquent.md similarity index 100% rename from base_connaissances/corpus/les-trous-pourquoi-des-mesures-manquent.md rename to snippets/textes/les-trous-pourquoi-des-mesures-manquent.md diff --git a/base_connaissances/corpus/my-aimsight-camera-does-not-start-what-should-i-check.md b/snippets/textes/my-aimsight-camera-does-not-start-what-should-i-check.md similarity index 100% rename from base_connaissances/corpus/my-aimsight-camera-does-not-start-what-should-i-check.md rename to snippets/textes/my-aimsight-camera-does-not-start-what-should-i-check.md diff --git a/base_connaissances/corpus/my-exported-csv-file-does-not-contain-a-timestamp-what-should-i-do.md b/snippets/textes/my-exported-csv-file-does-not-contain-a-timestamp-what-should-i-do.md similarity index 100% rename from base_connaissances/corpus/my-exported-csv-file-does-not-contain-a-timestamp-what-should-i-do.md rename to snippets/textes/my-exported-csv-file-does-not-contain-a-timestamp-what-should-i-do.md diff --git a/base_connaissances/corpus/my-measurements-suddenly-become-noisy-or-invalid-what-should-i-check.md b/snippets/textes/my-measurements-suddenly-become-noisy-or-invalid-what-should-i-check.md similarity index 100% rename from base_connaissances/corpus/my-measurements-suddenly-become-noisy-or-invalid-what-should-i-check.md rename to snippets/textes/my-measurements-suddenly-become-noisy-or-invalid-what-should-i-check.md diff --git a/base_connaissances/corpus/one-target-is-no-longer-being-measured-what-should-i-check.md b/snippets/textes/one-target-is-no-longer-being-measured-what-should-i-check.md similarity index 100% rename from base_connaissances/corpus/one-target-is-no-longer-being-measured-what-should-i-check.md rename to snippets/textes/one-target-is-no-longer-being-measured-what-should-i-check.md diff --git a/base_connaissances/corpus/pieges-de-lecture-des-donnees-de-la-station.md b/snippets/textes/pieges-de-lecture-des-donnees-de-la-station.md similarity index 100% rename from base_connaissances/corpus/pieges-de-lecture-des-donnees-de-la-station.md rename to snippets/textes/pieges-de-lecture-des-donnees-de-la-station.md diff --git a/base_connaissances/corpus/station-guide-access-modes.md b/snippets/textes/station-guide-access-modes.md similarity index 100% rename from base_connaissances/corpus/station-guide-access-modes.md rename to snippets/textes/station-guide-access-modes.md diff --git a/base_connaissances/corpus/station-guide-acquisition-length.md b/snippets/textes/station-guide-acquisition-length.md similarity index 100% rename from base_connaissances/corpus/station-guide-acquisition-length.md rename to snippets/textes/station-guide-acquisition-length.md diff --git a/base_connaissances/corpus/station-guide-acquisition-schedules.md b/snippets/textes/station-guide-acquisition-schedules.md similarity index 100% rename from base_connaissances/corpus/station-guide-acquisition-schedules.md rename to snippets/textes/station-guide-acquisition-schedules.md diff --git a/base_connaissances/corpus/station-guide-acquisition-type.md b/snippets/textes/station-guide-acquisition-type.md similarity index 100% rename from base_connaissances/corpus/station-guide-acquisition-type.md rename to snippets/textes/station-guide-acquisition-type.md diff --git a/base_connaissances/corpus/station-guide-available-signals-and-diagnostic-metrics.md b/snippets/textes/station-guide-available-signals-and-diagnostic-metrics.md similarity index 100% rename from base_connaissances/corpus/station-guide-available-signals-and-diagnostic-metrics.md rename to snippets/textes/station-guide-available-signals-and-diagnostic-metrics.md diff --git a/base_connaissances/corpus/station-guide-camera-management-panel.md b/snippets/textes/station-guide-camera-management-panel.md similarity index 100% rename from base_connaissances/corpus/station-guide-camera-management-panel.md rename to snippets/textes/station-guide-camera-management-panel.md diff --git a/base_connaissances/corpus/station-guide-camera-movement.md b/snippets/textes/station-guide-camera-movement.md similarity index 100% rename from base_connaissances/corpus/station-guide-camera-movement.md rename to snippets/textes/station-guide-camera-movement.md diff --git a/base_connaissances/corpus/station-guide-camera-operation.md b/snippets/textes/station-guide-camera-operation.md similarity index 100% rename from base_connaissances/corpus/station-guide-camera-operation.md rename to snippets/textes/station-guide-camera-operation.md diff --git a/base_connaissances/corpus/station-guide-camera-parameters.md b/snippets/textes/station-guide-camera-parameters.md similarity index 100% rename from base_connaissances/corpus/station-guide-camera-parameters.md rename to snippets/textes/station-guide-camera-parameters.md diff --git a/base_connaissances/corpus/station-guide-cellular-apn-configuration.md b/snippets/textes/station-guide-cellular-apn-configuration.md similarity index 100% rename from base_connaissances/corpus/station-guide-cellular-apn-configuration.md rename to snippets/textes/station-guide-cellular-apn-configuration.md diff --git a/base_connaissances/corpus/station-guide-charging.md b/snippets/textes/station-guide-charging.md similarity index 100% rename from base_connaissances/corpus/station-guide-charging.md rename to snippets/textes/station-guide-charging.md diff --git a/base_connaissances/corpus/station-guide-choosing-between-single-and-differential-acquisition.md b/snippets/textes/station-guide-choosing-between-single-and-differential-acquisition.md similarity index 100% rename from base_connaissances/corpus/station-guide-choosing-between-single-and-differential-acquisition.md rename to snippets/textes/station-guide-choosing-between-single-and-differential-acquisition.md diff --git a/base_connaissances/corpus/station-guide-contrast-enhanced-overlay-adjustment.md b/snippets/textes/station-guide-contrast-enhanced-overlay-adjustment.md similarity index 100% rename from base_connaissances/corpus/station-guide-contrast-enhanced-overlay-adjustment.md rename to snippets/textes/station-guide-contrast-enhanced-overlay-adjustment.md diff --git a/base_connaissances/corpus/station-guide-creating-a-schedule.md b/snippets/textes/station-guide-creating-a-schedule.md similarity index 100% rename from base_connaissances/corpus/station-guide-creating-a-schedule.md rename to snippets/textes/station-guide-creating-a-schedule.md diff --git a/base_connaissances/corpus/station-guide-data-exploration-page.md b/snippets/textes/station-guide-data-exploration-page.md similarity index 100% rename from base_connaissances/corpus/station-guide-data-exploration-page.md rename to snippets/textes/station-guide-data-exploration-page.md diff --git a/base_connaissances/corpus/station-guide-demo-kit-contents.md b/snippets/textes/station-guide-demo-kit-contents.md similarity index 100% rename from base_connaissances/corpus/station-guide-demo-kit-contents.md rename to snippets/textes/station-guide-demo-kit-contents.md diff --git a/base_connaissances/corpus/station-guide-disk.md b/snippets/textes/station-guide-disk.md similarity index 100% rename from base_connaissances/corpus/station-guide-disk.md rename to snippets/textes/station-guide-disk.md diff --git a/base_connaissances/corpus/station-guide-dominance.md b/snippets/textes/station-guide-dominance.md similarity index 100% rename from base_connaissances/corpus/station-guide-dominance.md rename to snippets/textes/station-guide-dominance.md diff --git a/base_connaissances/corpus/station-guide-error-value.md b/snippets/textes/station-guide-error-value.md similarity index 100% rename from base_connaissances/corpus/station-guide-error-value.md rename to snippets/textes/station-guide-error-value.md diff --git a/base_connaissances/corpus/station-guide-exporting-graphs.md b/snippets/textes/station-guide-exporting-graphs.md similarity index 100% rename from base_connaissances/corpus/station-guide-exporting-graphs.md rename to snippets/textes/station-guide-exporting-graphs.md diff --git a/base_connaissances/corpus/station-guide-exposure-and-image-preparation.md b/snippets/textes/station-guide-exposure-and-image-preparation.md similarity index 100% rename from base_connaissances/corpus/station-guide-exposure-and-image-preparation.md rename to snippets/textes/station-guide-exposure-and-image-preparation.md diff --git a/base_connaissances/corpus/station-guide-flux.md b/snippets/textes/station-guide-flux.md similarity index 100% rename from base_connaissances/corpus/station-guide-flux.md rename to snippets/textes/station-guide-flux.md diff --git a/base_connaissances/corpus/station-guide-fps-duration.md b/snippets/textes/station-guide-fps-duration.md similarity index 100% rename from base_connaissances/corpus/station-guide-fps-duration.md rename to snippets/textes/station-guide-fps-duration.md diff --git a/base_connaissances/corpus/station-guide-ftp.md b/snippets/textes/station-guide-ftp.md similarity index 100% rename from base_connaissances/corpus/station-guide-ftp.md rename to snippets/textes/station-guide-ftp.md diff --git a/base_connaissances/corpus/station-guide-fwhm-px.md b/snippets/textes/station-guide-fwhm-px.md similarity index 100% rename from base_connaissances/corpus/station-guide-fwhm-px.md rename to snippets/textes/station-guide-fwhm-px.md diff --git a/base_connaissances/corpus/station-guide-image-display-and-reflector-identification.md b/snippets/textes/station-guide-image-display-and-reflector-identification.md similarity index 100% rename from base_connaissances/corpus/station-guide-image-display-and-reflector-identification.md rename to snippets/textes/station-guide-image-display-and-reflector-identification.md diff --git a/base_connaissances/corpus/station-guide-image-mode-and-target-preset.md b/snippets/textes/station-guide-image-mode-and-target-preset.md similarity index 100% rename from base_connaissances/corpus/station-guide-image-mode-and-target-preset.md rename to snippets/textes/station-guide-image-mode-and-target-preset.md diff --git a/base_connaissances/corpus/station-guide-interaction-during-target-creation.md b/snippets/textes/station-guide-interaction-during-target-creation.md similarity index 100% rename from base_connaissances/corpus/station-guide-interaction-during-target-creation.md rename to snippets/textes/station-guide-interaction-during-target-creation.md diff --git a/base_connaissances/corpus/station-guide-interval-count.md b/snippets/textes/station-guide-interval-count.md similarity index 100% rename from base_connaissances/corpus/station-guide-interval-count.md rename to snippets/textes/station-guide-interval-count.md diff --git a/base_connaissances/corpus/station-guide-live-plot.md b/snippets/textes/station-guide-live-plot.md similarity index 100% rename from base_connaissances/corpus/station-guide-live-plot.md rename to snippets/textes/station-guide-live-plot.md diff --git a/base_connaissances/corpus/station-guide-live-view-page.md b/snippets/textes/station-guide-live-view-page.md similarity index 100% rename from base_connaissances/corpus/station-guide-live-view-page.md rename to snippets/textes/station-guide-live-view-page.md diff --git a/base_connaissances/corpus/station-guide-marker-configuration-process.md b/snippets/textes/station-guide-marker-configuration-process.md similarity index 100% rename from base_connaissances/corpus/station-guide-marker-configuration-process.md rename to snippets/textes/station-guide-marker-configuration-process.md diff --git a/base_connaissances/corpus/station-guide-measurement-range-and-optical-options.md b/snippets/textes/station-guide-measurement-range-and-optical-options.md similarity index 100% rename from base_connaissances/corpus/station-guide-measurement-range-and-optical-options.md rename to snippets/textes/station-guide-measurement-range-and-optical-options.md diff --git a/base_connaissances/corpus/station-guide-monitoring-station.md b/snippets/textes/station-guide-monitoring-station.md similarity index 100% rename from base_connaissances/corpus/station-guide-monitoring-station.md rename to snippets/textes/station-guide-monitoring-station.md diff --git a/base_connaissances/corpus/station-guide-monitoring.md b/snippets/textes/station-guide-monitoring.md similarity index 100% rename from base_connaissances/corpus/station-guide-monitoring.md rename to snippets/textes/station-guide-monitoring.md diff --git a/base_connaissances/corpus/station-guide-navigation-bar.md b/snippets/textes/station-guide-navigation-bar.md similarity index 100% rename from base_connaissances/corpus/station-guide-navigation-bar.md rename to snippets/textes/station-guide-navigation-bar.md diff --git a/base_connaissances/corpus/station-guide-navigation-within-the-plots.md b/snippets/textes/station-guide-navigation-within-the-plots.md similarity index 100% rename from base_connaissances/corpus/station-guide-navigation-within-the-plots.md rename to snippets/textes/station-guide-navigation-within-the-plots.md diff --git a/base_connaissances/corpus/station-guide-network-settings.md b/snippets/textes/station-guide-network-settings.md similarity index 100% rename from base_connaissances/corpus/station-guide-network-settings.md rename to snippets/textes/station-guide-network-settings.md diff --git a/base_connaissances/corpus/station-guide-output-options.md b/snippets/textes/station-guide-output-options.md similarity index 100% rename from base_connaissances/corpus/station-guide-output-options.md rename to snippets/textes/station-guide-output-options.md diff --git a/base_connaissances/corpus/station-guide-panning-and-resetting.md b/snippets/textes/station-guide-panning-and-resetting.md similarity index 100% rename from base_connaissances/corpus/station-guide-panning-and-resetting.md rename to snippets/textes/station-guide-panning-and-resetting.md diff --git a/base_connaissances/corpus/station-guide-pattern-creation-page.md b/snippets/textes/station-guide-pattern-creation-page.md similarity index 100% rename from base_connaissances/corpus/station-guide-pattern-creation-page.md rename to snippets/textes/station-guide-pattern-creation-page.md diff --git a/base_connaissances/corpus/station-guide-peak-intensity.md b/snippets/textes/station-guide-peak-intensity.md similarity index 100% rename from base_connaissances/corpus/station-guide-peak-intensity.md rename to snippets/textes/station-guide-peak-intensity.md diff --git a/base_connaissances/corpus/station-guide-periodic-interval.md b/snippets/textes/station-guide-periodic-interval.md similarity index 100% rename from base_connaissances/corpus/station-guide-periodic-interval.md rename to snippets/textes/station-guide-periodic-interval.md diff --git a/base_connaissances/corpus/station-guide-quick-start-cellular-monitoring-installation.md b/snippets/textes/station-guide-quick-start-cellular-monitoring-installation.md similarity index 100% rename from base_connaissances/corpus/station-guide-quick-start-cellular-monitoring-installation.md rename to snippets/textes/station-guide-quick-start-cellular-monitoring-installation.md diff --git a/base_connaissances/corpus/station-guide-raw-horizontal-vertical-px.md b/snippets/textes/station-guide-raw-horizontal-vertical-px.md similarity index 100% rename from base_connaissances/corpus/station-guide-raw-horizontal-vertical-px.md rename to snippets/textes/station-guide-raw-horizontal-vertical-px.md diff --git a/base_connaissances/corpus/station-guide-reflective-targets-in-bright-sunlight.md b/snippets/textes/station-guide-reflective-targets-in-bright-sunlight.md similarity index 100% rename from base_connaissances/corpus/station-guide-reflective-targets-in-bright-sunlight.md rename to snippets/textes/station-guide-reflective-targets-in-bright-sunlight.md diff --git a/base_connaissances/corpus/station-guide-relative-horizontal-vertical-mm.md b/snippets/textes/station-guide-relative-horizontal-vertical-mm.md similarity index 100% rename from base_connaissances/corpus/station-guide-relative-horizontal-vertical-mm.md rename to snippets/textes/station-guide-relative-horizontal-vertical-mm.md diff --git a/base_connaissances/corpus/station-guide-rest-api-documentation.md b/snippets/textes/station-guide-rest-api-documentation.md similarity index 100% rename from base_connaissances/corpus/station-guide-rest-api-documentation.md rename to snippets/textes/station-guide-rest-api-documentation.md diff --git a/base_connaissances/corpus/station-guide-saving-and-verifying-a-schedule.md b/snippets/textes/station-guide-saving-and-verifying-a-schedule.md similarity index 100% rename from base_connaissances/corpus/station-guide-saving-and-verifying-a-schedule.md rename to snippets/textes/station-guide-saving-and-verifying-a-schedule.md diff --git a/base_connaissances/corpus/station-guide-sharpness.md b/snippets/textes/station-guide-sharpness.md similarity index 100% rename from base_connaissances/corpus/station-guide-sharpness.md rename to snippets/textes/station-guide-sharpness.md diff --git a/base_connaissances/corpus/station-guide-snr.md b/snippets/textes/station-guide-snr.md similarity index 100% rename from base_connaissances/corpus/station-guide-snr.md rename to snippets/textes/station-guide-snr.md diff --git a/base_connaissances/corpus/station-guide-status-leds.md b/snippets/textes/station-guide-status-leds.md similarity index 100% rename from base_connaissances/corpus/station-guide-status-leds.md rename to snippets/textes/station-guide-status-leds.md diff --git a/base_connaissances/corpus/station-guide-system-settings-page.md b/snippets/textes/station-guide-system-settings-page.md similarity index 100% rename from base_connaissances/corpus/station-guide-system-settings-page.md rename to snippets/textes/station-guide-system-settings-page.md diff --git a/base_connaissances/corpus/station-guide-target-image-quality-and-pattern-matching-metrics.md b/snippets/textes/station-guide-target-image-quality-and-pattern-matching-metrics.md similarity index 100% rename from base_connaissances/corpus/station-guide-target-image-quality-and-pattern-matching-metrics.md rename to snippets/textes/station-guide-target-image-quality-and-pattern-matching-metrics.md diff --git a/base_connaissances/corpus/station-guide-trace-selection-and-visibility.md b/snippets/textes/station-guide-trace-selection-and-visibility.md similarity index 100% rename from base_connaissances/corpus/station-guide-trace-selection-and-visibility.md rename to snippets/textes/station-guide-trace-selection-and-visibility.md diff --git a/base_connaissances/corpus/station-guide-troubleshooting.md b/snippets/textes/station-guide-troubleshooting.md similarity index 100% rename from base_connaissances/corpus/station-guide-troubleshooting.md rename to snippets/textes/station-guide-troubleshooting.md diff --git a/base_connaissances/corpus/station-guide-typical-installation-procedure.md b/snippets/textes/station-guide-typical-installation-procedure.md similarity index 100% rename from base_connaissances/corpus/station-guide-typical-installation-procedure.md rename to snippets/textes/station-guide-typical-installation-procedure.md diff --git a/base_connaissances/corpus/station-guide-working-with-conventional-image-features.md b/snippets/textes/station-guide-working-with-conventional-image-features.md similarity index 100% rename from base_connaissances/corpus/station-guide-working-with-conventional-image-features.md rename to snippets/textes/station-guide-working-with-conventional-image-features.md diff --git a/base_connaissances/corpus/station-guide-zooming-and-scaling.md b/snippets/textes/station-guide-zooming-and-scaling.md similarity index 100% rename from base_connaissances/corpus/station-guide-zooming-and-scaling.md rename to snippets/textes/station-guide-zooming-and-scaling.md diff --git a/base_connaissances/corpus/tensions-de-la-batterie-selon-son-etat.md b/snippets/textes/tensions-de-la-batterie-selon-son-etat.md similarity index 100% rename from base_connaissances/corpus/tensions-de-la-batterie-selon-son-etat.md rename to snippets/textes/tensions-de-la-batterie-selon-son-etat.md diff --git a/base_connaissances/corpus/the-camera-is-online-but-i-am-not-receiving-data-what-should-i-check.md b/snippets/textes/the-camera-is-online-but-i-am-not-receiving-data-what-should-i-check.md similarity index 100% rename from base_connaissances/corpus/the-camera-is-online-but-i-am-not-receiving-data-what-should-i-check.md rename to snippets/textes/the-camera-is-online-but-i-am-not-receiving-data-what-should-i-check.md diff --git a/base_connaissances/corpus/the-camera-is-running-but-is-not-connected-over-4g-what-should-i-check.md b/snippets/textes/the-camera-is-running-but-is-not-connected-over-4g-what-should-i-check.md similarity index 100% rename from base_connaissances/corpus/the-camera-is-running-but-is-not-connected-over-4g-what-should-i-check.md rename to snippets/textes/the-camera-is-running-but-is-not-connected-over-4g-what-should-i-check.md diff --git a/base_connaissances/corpus/what-do-the-columns-in-the-csv-export-represent.md b/snippets/textes/what-do-the-columns-in-the-csv-export-represent.md similarity index 100% rename from base_connaissances/corpus/what-do-the-columns-in-the-csv-export-represent.md rename to snippets/textes/what-do-the-columns-in-the-csv-export-represent.md diff --git a/base_connaissances/corpus/what-do-x-y-rx-and-ry-represent-in-exported-data.md b/snippets/textes/what-do-x-y-rx-and-ry-represent-in-exported-data.md similarity index 100% rename from base_connaissances/corpus/what-do-x-y-rx-and-ry-represent-in-exported-data.md rename to snippets/textes/what-do-x-y-rx-and-ry-represent-in-exported-data.md diff --git a/base_connaissances/corpus/what-does-camera-movement-represent-in-data-exploration.md b/snippets/textes/what-does-camera-movement-represent-in-data-exploration.md similarity index 100% rename from base_connaissances/corpus/what-does-camera-movement-represent-in-data-exploration.md rename to snippets/textes/what-does-camera-movement-represent-in-data-exploration.md diff --git a/base_connaissances/corpus/what-does-the-error-value-represent.md b/snippets/textes/what-does-the-error-value-represent.md similarity index 100% rename from base_connaissances/corpus/what-does-the-error-value-represent.md rename to snippets/textes/what-does-the-error-value-represent.md diff --git a/base_connaissances/corpus/what-happens-if-a-target-changes-shape-or-becomes-partially-obstructed.md b/snippets/textes/what-happens-if-a-target-changes-shape-or-becomes-partially-obstructed.md similarity index 100% rename from base_connaissances/corpus/what-happens-if-a-target-changes-shape-or-becomes-partially-obstructed.md rename to snippets/textes/what-happens-if-a-target-changes-shape-or-becomes-partially-obstructed.md diff --git a/base_connaissances/corpus/what-happens-if-the-camera-moves-or-changes-orientation-after-commissioning.md b/snippets/textes/what-happens-if-the-camera-moves-or-changes-orientation-after-commissioning.md similarity index 100% rename from base_connaissances/corpus/what-happens-if-the-camera-moves-or-changes-orientation-after-commissioning.md rename to snippets/textes/what-happens-if-the-camera-moves-or-changes-orientation-after-commissioning.md diff --git a/base_connaissances/corpus/what-happens-to-alarms-if-the-internet-or-4g-connection-is-lost.md b/snippets/textes/what-happens-to-alarms-if-the-internet-or-4g-connection-is-lost.md similarity index 100% rename from base_connaissances/corpus/what-happens-to-alarms-if-the-internet-or-4g-connection-is-lost.md rename to snippets/textes/what-happens-to-alarms-if-the-internet-or-4g-connection-is-lost.md diff --git a/base_connaissances/corpus/what-is-the-delivery-time-for-multiple-stations.md b/snippets/textes/what-is-the-delivery-time-for-multiple-stations.md similarity index 100% rename from base_connaissances/corpus/what-is-the-delivery-time-for-multiple-stations.md rename to snippets/textes/what-is-the-delivery-time-for-multiple-stations.md diff --git a/base_connaissances/corpus/what-is-the-error-column-in-exported-data.md b/snippets/textes/what-is-the-error-column-in-exported-data.md similarity index 100% rename from base_connaissances/corpus/what-is-the-error-column-in-exported-data.md rename to snippets/textes/what-is-the-error-column-in-exported-data.md diff --git a/base_connaissances/corpus/what-is-the-error-threshold.md b/snippets/textes/what-is-the-error-threshold.md similarity index 100% rename from base_connaissances/corpus/what-is-the-error-threshold.md rename to snippets/textes/what-is-the-error-threshold.md diff --git a/base_connaissances/corpus/what-is-the-expected-battery-autonomy-if-external-power-fails.md b/snippets/textes/what-is-the-expected-battery-autonomy-if-external-power-fails.md similarity index 100% rename from base_connaissances/corpus/what-is-the-expected-battery-autonomy-if-external-power-fails.md rename to snippets/textes/what-is-the-expected-battery-autonomy-if-external-power-fails.md diff --git a/base_connaissances/corpus/what-is-the-maximum-operating-distance.md b/snippets/textes/what-is-the-maximum-operating-distance.md similarity index 100% rename from base_connaissances/corpus/what-is-the-maximum-operating-distance.md rename to snippets/textes/what-is-the-maximum-operating-distance.md diff --git a/base_connaissances/corpus/what-should-i-check-before-leaving-the-installation-site.md b/snippets/textes/what-should-i-check-before-leaving-the-installation-site.md similarity index 100% rename from base_connaissances/corpus/what-should-i-check-before-leaving-the-installation-site.md rename to snippets/textes/what-should-i-check-before-leaving-the-installation-site.md diff --git a/base_connaissances/corpus/what-should-i-do-if-all-targets-may-potentially-move-or-settle.md b/snippets/textes/what-should-i-do-if-all-targets-may-potentially-move-or-settle.md similarity index 100% rename from base_connaissances/corpus/what-should-i-do-if-all-targets-may-potentially-move-or-settle.md rename to snippets/textes/what-should-i-do-if-all-targets-may-potentially-move-or-settle.md diff --git a/base_connaissances/corpus/where-should-reference-targets-be-placed.md b/snippets/textes/where-should-reference-targets-be-placed.md similarity index 100% rename from base_connaissances/corpus/where-should-reference-targets-be-placed.md rename to snippets/textes/where-should-reference-targets-be-placed.md diff --git a/base_connaissances/corpus/which-data-transfer-methods-are-available.md b/snippets/textes/which-data-transfer-methods-are-available.md similarity index 100% rename from base_connaissances/corpus/which-data-transfer-methods-are-available.md rename to snippets/textes/which-data-transfer-methods-are-available.md diff --git a/base_connaissances/corpus/which-diagnostic-signals-are-available-in-data-exploration.md b/snippets/textes/which-diagnostic-signals-are-available-in-data-exploration.md similarity index 100% rename from base_connaissances/corpus/which-diagnostic-signals-are-available-in-data-exploration.md rename to snippets/textes/which-diagnostic-signals-are-available-in-data-exploration.md diff --git a/base_connaissances/corpus/which-file-formats-can-aimsight-export.md b/snippets/textes/which-file-formats-can-aimsight-export.md similarity index 100% rename from base_connaissances/corpus/which-file-formats-can-aimsight-export.md rename to snippets/textes/which-file-formats-can-aimsight-export.md diff --git a/base_connaissances/corpus/which-licensing-models-are-available.md b/snippets/textes/which-licensing-models-are-available.md similarity index 100% rename from base_connaissances/corpus/which-licensing-models-are-available.md rename to snippets/textes/which-licensing-models-are-available.md diff --git a/base_connaissances/corpus/which-timezone-is-used-for-timestamps.md b/snippets/textes/which-timezone-is-used-for-timestamps.md similarity index 100% rename from base_connaissances/corpus/which-timezone-is-used-for-timestamps.md rename to snippets/textes/which-timezone-is-used-for-timestamps.md diff --git a/tests/test_importer.py b/tests/test_envoyer.py similarity index 97% rename from tests/test_importer.py rename to tests/test_envoyer.py index a3fbb14..98015f7 100644 --- a/tests/test_importer.py +++ b/tests/test_envoyer.py @@ -1,8 +1,8 @@ import socket import unittest -from base_connaissances.decoupage import Extrait -from base_connaissances.importer import Extraits, html, synchroniser +from snippets.fichiers import Extrait +from snippets.envoyer import Extraits, html, synchroniser from faux_libredesk import FauxLibreDesk LISTE = ("GET", "/api/v1/ai/snippets") diff --git a/tests/test_decoupage.py b/tests/test_fichiers.py similarity index 92% rename from tests/test_decoupage.py rename to tests/test_fichiers.py index f4c3970..4891c68 100644 --- a/tests/test_decoupage.py +++ b/tests/test_fichiers.py @@ -2,7 +2,7 @@ import tempfile import unittest from pathlib import Path -from base_connaissances.decoupage import Extrait, decouper_markdown, decouper_pdf, ecrire_corpus, lire_corpus +from snippets.fichiers import Extrait, decouper_markdown, decouper_pdf, ecrire_textes, lire_textes TOC = ("Contents\nInstall . . . . . . 1\n Does it start? . . . . . 1\n How long does the\n battery last? . . . . 2\n" "Data . . . . 3 Which formats? . . . . 3\n") @@ -50,12 +50,12 @@ class TestDecouperMarkdown(unittest.TestCase): class TestCorpus(unittest.TestCase): - def test_aller_retour_du_corpus(self): + def test_aller_retour_des_textes(self): with tempfile.TemporaryDirectory() as t: d = Path(t) x = [Extrait("Which formats?", "CSV.", "AIMsight FAQ, rév. 1.5")] - ecrire_corpus(x, d) - self.assertEqual(lire_corpus(d), x) + ecrire_textes(x, d) + self.assertEqual(lire_textes(d), x) self.assertEqual((d / "which-formats.md").read_text().splitlines()[-1], "Source : AIMsight FAQ, rév. 1.5") diff --git a/tests/test_garde_fou_base.py b/tests/test_garde_fou_snippets.py similarity index 65% rename from tests/test_garde_fou_base.py rename to tests/test_garde_fou_snippets.py index f2e9eae..38d7ca5 100644 --- a/tests/test_garde_fou_base.py +++ b/tests/test_garde_fou_snippets.py @@ -1,9 +1,9 @@ -"""Le paquet base_connaissances ne parle à LibreDesk que par les routes des extraits (design §2, plan Global Constraints).""" +"""Le paquet snippets ne parle à LibreDesk que par les routes des extraits (design §2, plan Global Constraints).""" import re import unittest from pathlib import Path -PAQUET = Path(__file__).resolve().parents[1] / "base_connaissances" +PAQUET = Path(__file__).resolve().parents[1] / "snippets" AUTORISEES = {"/api/v1/ai/snippets", "/api/v1/ai/snippets/{id}"} # la route PUT s'écrit f"/api/v1/ai/snippets/{id}" @@ -15,8 +15,8 @@ class TestGardeFouBase(unittest.TestCase): for interdit in ("/messages", "/conversations", "DELETE", "automations", "assistants"): self.assertNotIn(interdit, texte, f"{interdit} dans {f.name}") - def test_le_paquet_a_bien_un_client(self): # sans importer.py, le test ci-dessus passerait à vide - self.assertTrue((PAQUET / "importer.py").exists()) + def test_le_paquet_a_bien_un_client(self): # sans envoyer.py, le test ci-dessus passerait à vide + self.assertTrue((PAQUET / "envoyer.py").exists()) if __name__ == "__main__": diff --git a/tests/test_ollama.py b/tests/test_ollama.py index e67c3a7..8228fb8 100644 --- a/tests/test_ollama.py +++ b/tests/test_ollama.py @@ -12,7 +12,7 @@ OLLAMA = Path(__file__).resolve().parents[1] / "ollama" COMPOSE = OLLAMA / "compose.yml" DOCKERFILE = OLLAMA / "Dockerfile" sys.path.insert(0, str(OLLAMA)) -from verifier import verifier # noqa: E402 +from verifier_ollama import verifier # noqa: E402 class FauxOllama: @@ -83,7 +83,7 @@ class TestVerifier(unittest.TestCase): class TestCompatibilite(unittest.TestCase): def test_verifier_lisible_par_un_vieux_python(self): # le Python du serveur est inconnu (3.8, 3.9…) - texte = (OLLAMA / "verifier.py").read_text() + texte = (OLLAMA / "verifier_ollama.py").read_text() arbre = ast.parse(texte) futur = any(isinstance(n, ast.ImportFrom) and n.module == "__future__" and any(a.name == "annotations" for a in n.names) for n in arbre.body) diff --git a/tests/test_taches.py b/tests/test_taches.py index 5d0dbe1..6fd9a33 100644 --- a/tests/test_taches.py +++ b/tests/test_taches.py @@ -46,7 +46,7 @@ class TestTaches(unittest.TestCase): def test_import_instance_de_test_lit_son_env(self): for libelle, c in commandes().items(): - if "base_connaissances.importer" in c and "instance de test" in libelle.lower(): + if "snippets.envoyer" in c and "instance de test" in libelle.lower(): self.assertIn("instance-de-test/.env", c, libelle) def test_effacer_l_instance_demande_confirmation(self): diff --git a/tests/test_corpus.py b/tests/test_textes.py similarity index 75% rename from tests/test_corpus.py rename to tests/test_textes.py index fcd9c77..17d70ff 100644 --- a/tests/test_corpus.py +++ b/tests/test_textes.py @@ -1,11 +1,11 @@ -"""Le corpus versionné de la base de connaissances : présent, propre, sans rien d'interne.""" +"""Les textes des snippets (snippets/textes/) : présent, propre, sans rien d'interne.""" import re import unittest from pathlib import Path -from base_connaissances.decoupage import lire_corpus +from snippets.fichiers import lire_textes -CORPUS = Path(__file__).resolve().parents[1] / "base_connaissances" / "corpus" +TEXTES = Path(__file__).resolve().parents[1] / "snippets" / "textes" STATIONS = ["BREITHORN", "CLARIDEN", "FLORIDA", "JUNGFRAU", "LENZSPITZE", "MICHIGAN", "NADELHORN", "NEBRASKA", "NIEDERHORN", "NORDEND", "SNCF01", "SUSTENHORN", "WILDSTRUBEL", "VERMONT", "WEISSHORN", "MISSISSIPPI"] INTERDITS = ["python3", "agent-tools", ".py", "Marc", "Barcelone", "Vaud", "GN-1", "GN-5", "seuil provisoire", @@ -13,20 +13,20 @@ INTERDITS = ["python3", "agent-tools", ".py", "Marc", "Barcelone", "Vaud", "GN-1 class TestCorpus(unittest.TestCase): - def test_corpus_present(self): - self.assertGreaterEqual(len(lire_corpus(CORPUS)), 60) + def test_textes_presents(self): + self.assertGreaterEqual(len(lire_textes(TEXTES)), 60) def test_titres_uniques_et_contenus_non_vides(self): - x = lire_corpus(CORPUS) + x = lire_textes(TEXTES) self.assertEqual(len({e.titre for e in x}), len(x)) self.assertTrue(all(e.contenu.strip() and e.source.strip() for e in x)) def test_taille_raisonnable(self): - trop_longs = [e.cle for e in lire_corpus(CORPUS) if len(e.contenu) > 8000] + trop_longs = [e.cle for e in lire_textes(TEXTES) if len(e.contenu) > 8000] self.assertEqual(trop_longs, []) def test_rien_d_interne(self): - for e in lire_corpus(CORPUS): + for e in lire_textes(TEXTES): texte = e.titre + "\n" + e.contenu for s in STATIONS: self.assertIsNone(re.search(rf"\b{s}\b", texte, re.I), f"{s} dans {e.cle}") @@ -34,27 +34,27 @@ class TestCorpus(unittest.TestCase): self.assertNotIn(i.lower(), texte.lower(), f"{i} dans {e.cle}") def test_sources_sans_chemin_interne(self): # la source part dans LibreDesk avec l'extrait - chemins = [e.cle for e in lire_corpus(CORPUS) if "/" in e.source or ".md" in e.source] + chemins = [e.cle for e in lire_textes(TEXTES) if "/" in e.source or ".md" in e.source] self.assertEqual(chemins, []) def test_mesure_au_dessus_du_seuil_pas_dite_retiree(self): # elle est jugée non valable mais livrée - for e in lire_corpus(CORPUS): + for e in lire_textes(TEXTES): if e.source.startswith("Savoir métier"): for faux in ("retirée", "retirées", "supprimée"): self.assertNotIn(faux, e.contenu, f"{faux} dans {e.cle}") def test_pas_de_chiffres_d_une_seule_station_presentes_comme_tels(self): - for e in lire_corpus(CORPUS): + for e in lire_textes(TEXTES): for interne in ("Ces chiffres viennent", "station solaire de 21 Ah", "n'a pas été observé"): self.assertNotIn(interne, e.contenu, f"{interne} dans {e.cle}") def test_instructions_ne_contredisent_pas_la_faq(self): - texte = (CORPUS.parent / "instructions.md").read_text() + texte = (TEXTES.parent / "consignes_redaction.md").read_text() for faux in ("Heures en UTC, dites comme telles", "jamais que la station les rejette", "adresse IP)"): self.assertNotIn(faux, texte) def test_instructions_presentes(self): - texte = (CORPUS.parent / "instructions.md").read_text() + texte = (TEXTES.parent / "consignes_redaction.md").read_text() self.assertIn("langue du client", texte) self.assertLessEqual(len(texte), 4000)