# 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. **Architecture :** on reprend de `~/Support-AI` le paquet `base_connaissances/` et ses tests (Python, bibliothèque standard seulement), on reconstruit une instance de test allégée (LibreDesk v2.9.0 + Mailpit, scripts de préparation partageant une session commune), on ajoute un dossier `ollama/` (Dockerfile qui embarque le modèle, compose, script de vérification) et des tâches VS Code. LibreDesk recalcule lui-même les vecteurs quand la configuration des embeddings change : aucun code de recalcul. **Tech Stack :** Python 3.12 (stdlib, `unittest`), Docker / Docker Compose, Ollama, LibreDesk v2.9.0, VS Code (tâches, sous WSL). **Spec :** `docs/superpowers/specs/2026-11-12-support-libredesk-design.md` ## Global Constraints - **Rien ne part chez un client.** Aucun code n'écrit dans une conversation de la production. Seule la préparation de l'instance de test crée des conversations ; son SMTP est Mailpit. - **On ne recode pas LibreDesk** : ni son code, ni son conteneur, ni son reverse proxy. Configuration et API seulement. **Jamais d'écriture SQL** dans une base de LibreDesk (lecture SQL autorisée sur l'instance de test seulement). - `base_connaissances/` ne parle à LibreDesk que par `/api/v1/ai/snippets` et `/api/v1/ai/snippets/{id}` ; jamais `/messages`, `/conversations`, `DELETE`, `automations`, `assistants` (test `test_garde_fou_base`). - L'import simule par défaut ; il n'écrit qu'avec `--ecrire`. Il ne supprime jamais un extrait. - Le corpus ne contient ni noms de stations (`BREITHORN, CLARIDEN, FLORIDA, JUNGFRAU, LENZSPITZE, MICHIGAN, NADELHORN, NEBRASKA, NIEDERHORN, NORDEND, SNCF01, SUSTENHORN, WILDSTRUBEL, VERMONT, WEISSHORN, MISSISSIPPI`), ni commandes d'outils, ni seuils provisoires, ni prénom interne (`Marc`). - Modèle d'embeddings : `bge-m3` de la bibliothèque Ollama, étiquette figée **`bge-m3:567m`** (dimension 1024). Configuration LibreDesk : fournisseur `openai`, `base_url` `http://:11434/v1`, modèle `bge-m3:567m`, clé `ollama`, `dimensions` 0, `embedding_max_tokens` 2048. - Image de base Ollama à une **version figée** (`ollama/ollama:`, la dernière stable au moment de la construction, notée dans le Dockerfile), jamais `latest`. Modèle gardé chargé : `OLLAMA_KEEP_ALIVE=-1`. - Port d'Ollama publié sur `127.0.0.1` par défaut ; une autre adresse seulement par la variable `OLLAMA_BIND`. Jamais `0.0.0.0` par défaut. - Complétion de l'instance de test (comme la production) : fournisseur `openai`, `base_url` `https://api.anthropic.com/v1`, modèle `claude-sonnet-5-5`, `max_tokens` 4096, `reasoning_effort` `medium`, instructions = `base_connaissances/instructions.md`. - Secrets dans `.env` (racine) et `instance-de-test/.env`, hors de git. Ne jamais afficher une clé. - Commandes `python3`, `git`, `docker` lancées sous WSL (Ubuntu), depuis `~/Support-LibreDesk`. Tests : `python3 -m unittest discover -s tests -v`. - Code, documents et messages de commit en français. Commits terminés par `Co-Authored-By: Claude Opus 5.5 `. - Support-AI n'est ni modifié ni supprimé : on y lit seulement. - Toute modification de la production (serveur, LibreDesk) : présentée à Maxime, faite par lui ou avec son accord explicite, un geste à la fois. Aucune tâche de ce plan ne touche la production ; le registre Gitea n'est poussé qu'avec l'accord de Maxime (Task 3, dernière étape). ## Review Focus 1. **Ollama arrêté pendant le recalcul** (conteneur tombé juste après le changement de configuration) : LibreDesk doit retenter chaque minute et finir par recalculer les 118 extraits une fois Ollama revenu. → Task 4, étape « panne pendant le recalcul ». 2. **Serveur sans accès à Internet** : l'image doit servir bge-m3 sans rien télécharger. → Task 3, `verifier.py` sur un réseau Docker `--internal`. 3. **Une tâche VS Code d'import lancée contre la production par erreur** : aucune tâche n'écrit en production sans adresse tapée et confirmation. → Task 5, `test_ecriture_production_demande_confirmation`. 4. **Le port d'Ollama ouvert sur toutes les interfaces** par un oubli de variable : le compose publie sur `127.0.0.1` par défaut. → Task 3, `test_port_lie_a_localhost_par_defaut`. 5. **`preparer.py` relancé sur une instance déjà préparée** : il doit s'arrêter avec un message clair, sans créer de doublon (boîte, agent). → Task 2, étape de vérification « deuxième passage ». --- ## Structure | Fichier | Rôle | |---|---| | `.gitignore` | `.env`, `instance-de-test/.env`, `instance-de-test/config.toml`, `instance-de-test/uploads/`, `__pycache__/`, `cases/` | | `base_connaissances/__init__.py`, `decoupage.py`, `importer.py`, `instructions.md`, `corpus/*.md` | repris tels quels de Support-AI (sauf docstrings qui citent Support-AI) | | `tests/faux_libredesk.py`, `test_decoupage.py`, `test_corpus.py`, `test_importer.py`, `test_garde_fou_base.py` | repris ; `test_corpus.py` complété (2 stations) | | `instance-de-test/docker-compose.yml`, `mails/` | repris | | `instance-de-test/session.py` | connexion admin (cookie + CSRF) et `req()`, partagés par les scripts | | `instance-de-test/demarrer.sh` | crée `config.toml` si absent, lance l'instance | | `instance-de-test/preparer.py` | boîte Mailpit + agent « Import base » et sa clé → `instance-de-test/.env` | | `instance-de-test/configurer_ia.py` | complétion + embeddings (test puis enregistrement), rejouable | | `instance-de-test/essayer_brouillons.py` | repris, branché sur `session.py` | | `instance-de-test/empreintes.sh` | lecture SQL des empreintes des extraits (instance de test seulement) | | `ollama/Dockerfile`, `ollama/compose.yml`, `ollama/compose.reseau.yml` | l'image et son lancement | | `ollama/verifier.py` | vérifie qu'une URL sert `bge-m3:567m` en dimension 1024 | | `tests/test_ollama.py` | `verifier.py` contre un faux serveur ; contrôles du compose | | `.vscode/tasks.json`, `tests/test_taches.py` | les tâches et leurs garde-fous | | `README.md`, `docs/production.md`, `docs/verifications.md` | mode d'emploi, gestes de production, constats | --- ### Task 1 : la base de connaissances reprise **Files:** - Create: `.gitignore`, `base_connaissances/{__init__.py,decoupage.py,importer.py,instructions.md}`, `base_connaissances/corpus/` (118 fichiers), `tests/{faux_libredesk.py,test_decoupage.py,test_corpus.py,test_importer.py,test_garde_fou_base.py}` - Source : `~/Support-AI/` mêmes chemins. **Ne pas** copier `base_connaissances/generer.py`. **Interfaces:** - Produces: `python3 -m base_connaissances.importer [--ecrire]` (lit `LIBREDESK_URL`, `LIBREDESK_ADMIN_KEY`, `LIBREDESK_ADMIN_SECRET`) ; `base_connaissances.decoupage.lire_corpus(dossier: Path) -> list[Extrait]`. - [ ] **Step 1 : Copier les fichiers** listés ci-dessus et écrire `.gitignore` (contenu de la Structure). - [ ] **Step 2 : Ajouter `"WEISSHORN", "MISSISSIPPI"` à `STATIONS` dans `tests/test_corpus.py`.** - [ ] **Step 3 : Retirer des docstrings et commentaires toute mention de `support_diagnostic`, de « spec §… » de Support-AI ou de `generer.py`** (`grep -rn "support_diagnostic\|generer\|spec §" base_connaissances tests` ne rend rien ; remplacer « spec §x » par une référence au design de ce dépôt ou la supprimer). - [ ] **Step 4 : Lancer les tests.** Run : `python3 -m unittest discover -s tests -v`. Expected : tous OK (les 4 fichiers), 118 extraits lus par `test_corpus_present`. - [ ] **Step 5 : Simulation d'import à vide.** Run : `LIBREDESK_URL=http://127.0.0.1:1 LIBREDESK_ADMIN_KEY=x LIBREDESK_ADMIN_SECRET=x python3 -m base_connaissances.importer`. Expected : échec réseau clair (aucune instance), pas d'écriture. - [ ] **Step 6 : Commit** — `git add .gitignore base_connaissances tests docs/superpowers && git commit -m "Base de connaissances reprise de Support-AI : corpus, import, instructions, tests"` (le design et ce plan entrent dans ce premier commit). --- ### Task 2 : l'instance de test allégée **Files:** - Create: `instance-de-test/docker-compose.yml` (repris tel quel), `instance-de-test/mails/` (repris), `instance-de-test/session.py`, `instance-de-test/demarrer.sh`, `instance-de-test/preparer.py`, `instance-de-test/configurer_ia.py`, `instance-de-test/essayer_brouillons.py`, `instance-de-test/empreintes.sh` **Interfaces:** - Consumes: Task 1 (`base_connaissances/instructions.md`, l'importeur). - Produces: - `session.py` : `B = "http://127.0.0.1:9100"` ; `connexion(mot_de_passe: str) -> None` ; `req(methode: str, chemin: str, corps: dict | None = None, timeout: int = 60) -> object` (rend `data`, `sys.exit` avec code et 300 premiers caractères en cas d'erreur HTTP, **n'affiche jamais le corps envoyé**). Reprend la connexion de `~/Support-AI/instance-de-test/preparer_ia.py` (cookie `Secure` désactivé, `csrf_token` fixé à `t0k3n`, en-tête `X-CSRFTOKEN`). - `demarrer.sh ` : si `config.toml` manque, le télécharge depuis `https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml` et y met une `encryption_key` aléatoire (commande de `~/Support-AI/docs/verifications.md`, « L'instance de test ») ; puis `LIBREDESK_SYSTEM_USER_PASSWORD=… docker compose -p ldtest up -d` ; attend que `GET /api/v1/settings/general` réponde (60 s max). - `preparer.py ` : crée la boîte e-mail « Test » (SMTP = Mailpit, configuration de `~/Support-AI/instance-de-test/preparer.py`), l'agent « Import base » (rôle `Admin`, e-mail `import@example.com`) et sa clé ; **écrase** `instance-de-test/.env` avec `LIBREDESK_URL=http://127.0.0.1:9100`, `LIBREDESK_ADMIN_KEY=…`, `LIBREDESK_ADMIN_SECRET=…`. Si une boîte « Test » existe déjà : `sys.exit("instance déjà préparée : docker compose -p ldtest down -v, puis demarrer.sh")` avant toute écriture. Ne crée ni étiquette, ni rôle « Agent IA », ni conversation. - `configurer_ia.py [clé]` (clé par défaut `ollama`) : `ANTHROPIC_API_KEY` lu dans l'environnement ; pour `completion` puis `embedding`, `POST /api/v1/ai/config/{type}/test` puis `PUT /api/v1/ai/config/{type}` (valeurs des Global Constraints) ; affiche `"{type} : test réussi, configuration enregistrée"`. Rejouable : c'est lui qui fait passer l'instance de LM Studio à Ollama. - `essayer_brouillons.py [mot de passe System]` : repris de Support-AI, connexion par `session.py`, rapport dans `cases/essai-brouillons-.md`. - `empreintes.sh` : `docker exec ldtest_db psql -U libredesk -d libredesk -At -c "SELECT id, embedded_fingerprint FROM ai_knowledge_base WHERE enabled ORDER BY id"` — lecture seule. - [ ] **Step 1 : Écrire `session.py`, `demarrer.sh`, `preparer.py`, `configurer_ia.py`, `empreintes.sh` ; adapter `essayer_brouillons.py`** aux interfaces ci-dessus. - [ ] **Step 2 : Monter une instance neuve.** Run : `docker compose -p ldtest down -v; bash instance-de-test/demarrer.sh 'TestAdmin-2026!'`. Expected : l'interface répond sur `http://127.0.0.1:9100`. - [ ] **Step 3 : Préparer.** Run : `python3 -I instance-de-test/preparer.py 'TestAdmin-2026!'`. Expected : `instance-de-test/.env` contient les trois variables. - [ ] **Step 4 : Deuxième passage (Review Focus 5).** Run : la même commande. Expected : sortie « instance déjà préparée … », code ≠ 0, toujours une seule boîte « Test » (`GET /api/v1/inboxes`). - [ ] **Step 5 : Configurer l'IA sur LM Studio, l'état de la production** (relais `socat` de `~/Support-AI/docs/verifications.md`, LM Studio lancé par Maxime). Run : `eval "$(grep '^export ANTHROPIC_API_KEY=' .env)" && python3 -I instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://$GW:11234/v1 text-embedding-bge-m3 lm-studio`. Expected : deux « test réussi ». Si LM Studio n'est pas disponible : sauter cette étape et le noter ; la Task 4 passe alors d'une première URL d'Ollama à une seconde (l'alias réseau), ce qui prouve le même déclenchement. - [ ] **Step 6 : Importer.** Run : `set -a && . instance-de-test/.env && set +a && python3 -m base_connaissances.importer --ecrire`. Expected : `créés 118`. Rejoué : `inchangés 118`. - [ ] **Step 7 : Commit** — `git add instance-de-test && git commit -m "Instance de test allégée : démarrage, préparation, configuration de l'IA, essai des brouillons"`. --- ### Task 3 : l'image Ollama **Files:** - Create: `ollama/Dockerfile`, `ollama/compose.yml`, `ollama/compose.reseau.yml`, `ollama/verifier.py`, `tests/test_ollama.py` **Interfaces:** - Produces: - Image `exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:-567m`, construite par `docker compose -f ollama/compose.yml build`. Le Dockerfile télécharge `bge-m3:567m` pendant la construction (serveur lancé en arrière-plan le temps d'un `ollama pull`) ; `ENV OLLAMA_HOST=0.0.0.0:11434 OLLAMA_KEEP_ALIVE=-1` ; `HEALTHCHECK` par `ollama list`. - `compose.yml` : service `ollama`, `container_name: ollama-bge-m3`, `restart: unless-stopped`, port `"${OLLAMA_BIND:-127.0.0.1}:11434:11434"`. - `compose.reseau.yml` (surcharge) : rattache le service au réseau externe `${RESEAU_LIBREDESK}` avec l'alias `ollama`. Localement `RESEAU_LIBREDESK=ldtest_libredesk` ; sur le serveur, le réseau de LibreDesk s'il est dans Docker. - `ollama/verifier.py ` (stdlib) : `GET /models` doit lister `bge-m3:567m` ; `POST /embeddings {"model":"bge-m3:567m","input":"Quelle est l'autonomie de la batterie ?"}` doit rendre un vecteur de 1024 nombres. Affiche `OK bge-m3:567m, 1024 dimensions` et sort en 0 ; sinon un message qui dit ce qui manque, sort en 1. Fonction testable : `verifier(base_url: str) -> str` (lève `RuntimeError` avec le message). - [ ] **Step 1 : Écrire les tests** dans `tests/test_ollama.py` (faux serveur `http.server` local, comme `faux_libredesk.py`) : ```python def test_modele_et_dimension_ok(self): # /models liste bge-m3:567m, /embeddings rend 1024 floats self.assertIn("1024", verifier(self.url)) def test_modele_absent(self): # /models sans bge-m3:567m with self.assertRaisesRegex(RuntimeError, "bge-m3:567m"): verifier(self.url) def test_mauvaise_dimension(self): # vecteur de 768 with self.assertRaisesRegex(RuntimeError, "768"): verifier(self.url) def test_port_lie_a_localhost_par_defaut(self): # Review Focus 4 self.assertIn('"${OLLAMA_BIND:-127.0.0.1}:11434:11434"', COMPOSE.read_text()) def test_version_figee(self): # FROM ollama/ollama:, jamais latest self.assertRegex(DOCKERFILE.read_text(), r"FROM ollama/ollama:\d+\.\d+\.\d+") self.assertIn("bge-m3:567m", DOCKERFILE.read_text()) ``` - [ ] **Step 2 : Lancer, vérifier l'échec.** Run : `python3 -m unittest tests.test_ollama -v`. Expected : FAIL (module ou fichiers absents). - [ ] **Step 3 : Écrire `verifier.py`, le Dockerfile et les deux compose.** - [ ] **Step 4 : Tests verts.** Run : `python3 -m unittest tests.test_ollama -v`. Expected : PASS. - [ ] **Step 5 : Construire.** Run : `docker compose -f ollama/compose.yml build`. Expected : image construite ; noter sa taille. - [ ] **Step 6 : Sans Internet (Review Focus 2).** Run : `docker network create --internal ollama-hors-ligne && docker run -d --name ollama-test --network ollama-hors-ligne && sleep 10 && docker run --rm --network ollama-hors-ligne -v "$PWD/ollama:/o:ro" python:3.12-alpine python /o/verifier.py http://ollama-test:11434/v1; docker rm -f ollama-test; docker network rm ollama-hors-ligne`. Expected : `OK bge-m3:567m, 1024 dimensions`. - [ ] **Step 7 : Lancement et redémarrage.** Run : `docker compose -f ollama/compose.yml up -d && sleep 10 && python3 ollama/verifier.py http://127.0.0.1:11434/v1`, puis `docker kill ollama-bge-m3 && sleep 15 && docker ps --filter name=ollama-bge-m3`. Expected : `OK …`, puis le conteneur est de nouveau `Up` (après un `docker kill`, `unless-stopped` relance). Puis `sudo service docker restart` (ou redémarrage de Docker Desktop) : conteneur relancé. - [ ] **Step 8 : Commit** — `git add ollama tests/test_ollama.py && git commit -m "Ollama : image avec bge-m3 embarqué, lancement, vérification"`. - [ ] **Step 9 (avec l'accord explicite de Maxime seulement) : pousser l'image au registre Gitea.** Maxime crée un jeton Gitea (portée `write:package`) et fait `docker login exchange.sensima.ch`. Run : `docker push exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:`. Expected : l'image apparaît dans Packages du compte. En cas de refus (taille, `413`) : noter l'erreur dans `docs/verifications.md` ; le repli `docker save | ssh … docker load` sera décrit dans `docs/production.md` (Task 6). --- ### Task 4 : la simulation du passage à Ollama **Files:** - Modify: `docs/verifications.md` (créé ici : constats datés) **Interfaces:** - Consumes: Task 2 (instance préparée, importée, embeddings sur LM Studio), Task 3 (image, `compose.reseau.yml`, `verifier.py`). - [ ] **Step 1 : Relever les empreintes « avant ».** Run : `bash instance-de-test/empreintes.sh > /tmp/avant.txt && wc -l /tmp/avant.txt`. Expected : 118 lignes, aucune empreinte vide. - [ ] **Step 2 : Lancer Ollama sur le réseau de l'instance.** Run : `RESEAU_LIBREDESK=ldtest_libredesk docker compose -f ollama/compose.yml -f ollama/compose.reseau.yml up -d && docker run --rm --network ldtest_libredesk -v "$PWD/ollama:/o:ro" python:3.12-alpine python /o/verifier.py http://ollama:11434/v1`. Expected : `OK bge-m3:567m, 1024 dimensions`. - [ ] **Step 3 : Basculer l'instance sur Ollama.** Run : `python3 -I instance-de-test/configurer_ia.py 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m`. Expected : deux « test réussi ». - [ ] **Step 4 : Le recalcul.** Run : `docker logs ldtest_app 2>&1 | grep -E "embedding provider changed|reconciled embeddings"` puis `bash instance-de-test/empreintes.sh > /tmp/apres.txt`. Expected : « embedding provider changed, reindexing knowledge base » puis « reconciled embeddings … reindexed 118 » ; 118 lignes dans `apres.txt`, aucune empreinte vide, **aucune identique** à `avant.txt` (`comm -12 <(sort /tmp/avant.txt) <(sort /tmp/apres.txt)` vide). - [ ] **Step 5 : Panne pendant le recalcul (Review Focus 1).** Repasser sur LM Studio (ou sur une URL d'Ollama différente, p. ex. `http://ollama-bge-m3:11434/v1`), puis : `docker stop ollama-bge-m3`, rebasculer sur `http://ollama:11434/v1` **sans** test (enregistrement direct : `configurer_ia.py` échouerait au test ; faire l'enregistrement par l'interface Admin → IA → Providers), attendre 2 min, `docker start ollama-bge-m3`, attendre 2 min. Expected : erreurs d'embedding dans les journaux pendant la panne, puis « reconciled embeddings … reindexed 118 » après le redémarrage ; empreintes toutes non vides. - [ ] **Step 6 : L'essai des brouillons.** Run : `python3 -I instance-de-test/essayer_brouillons.py`. Expected : 5 brouillons `completed`, « Mailpit inchangé pendant la génération ». Comparer au rapport LM Studio (`~/Support-AI/cases/essai-brouillons-2026-11-11.md`) : appuyés sur la base de la même façon ; le faire juger par Maxime. - [ ] **Step 7 : Consigner** dans `docs/verifications.md` : date, version d'Ollama, taille de l'image, extraits des journaux, résultat des empreintes, de la panne et de l'essai. - [ ] **Step 8 : Commit** — `git add docs/verifications.md && git commit -m "Simulation : passage de LM Studio à Ollama, recalcul automatique vérifié"`. --- ### Task 5 : les tâches VS Code **Files:** - Create: `.vscode/tasks.json`, `tests/test_taches.py` **Interfaces:** - Consumes: commandes des Tasks 1 à 4. - Produces: tâches (JSON strict, sans commentaire), chacune `"type": "shell"`, lancée depuis la racine du dépôt sous WSL : | Libellé | Commande | |---|---| | `Tests` | `python3 -m unittest discover -s tests -v` | | `Instance de test : démarrer` | `bash instance-de-test/demarrer.sh '${input:motDePasse}'` | | `Instance de test : préparer` | `python3 -I instance-de-test/preparer.py '${input:motDePasse}'` | | `Instance de test : effacer` | `docker compose -p ldtest down -v` (avec `${input:confirmation}`) | | `Instance de test : brancher sur Ollama` | `configurer_ia.py … http://ollama:11434/v1 bge-m3:567m` (clé Anthropic lue dans `.env`) | | `Instance de test : essai des brouillons` | `python3 -I instance-de-test/essayer_brouillons.py '${input:motDePasse}'` | | `Ollama : construire` | `docker compose -f ollama/compose.yml build` | | `Ollama : lancer (instance de test)` | `RESEAU_LIBREDESK=ldtest_libredesk docker compose -f ollama/compose.yml -f ollama/compose.reseau.yml up -d` | | `Ollama : vérifier` | `python3 ollama/verifier.py http://127.0.0.1:11434/v1` | | `Import : simulation (instance de test)` | charge `instance-de-test/.env`, `python3 -m base_connaissances.importer` | | `Import : ÉCRIRE (instance de test)` | idem `--ecrire` | | `Import : simulation (PRODUCTION)` | charge `.env` (clés admin), `LIBREDESK_URL='${input:urlProduction}'`, sans `--ecrire` | | `Import : ÉCRIRE (PRODUCTION)` | idem, `--ecrire`, seulement si `${input:confirmationProduction}` vaut `oui` | Entrées : `motDePasse` (`promptString`, `password: true`, défaut `TestAdmin-2026!`) ; `urlProduction` (`promptString`, **sans défaut**) ; `confirmation` et `confirmationProduction` (`pickString`, options `non`, `oui`, défaut `non`). La commande teste la confirmation (`[ "${input:…}" = oui ] || { echo "annulé"; exit 1; }`). - [ ] **Step 1 : Écrire `tests/test_taches.py`** (lit `.vscode/tasks.json` avec `json`) : ```python def test_json_valide_et_libelles_uniques(self): ... def test_ecriture_production_demande_confirmation(self): # Review Focus 3 # toute tâche dont la commande contient --ecrire ET urlProduction teste ${input:confirmationProduction} = oui def test_url_production_sans_defaut(self): # l'entrée urlProduction n'a pas de clé "default" def test_taches_instance_de_test_ne_visent_pas_la_production(self): # aucune tâche « (instance de test) » ne référence urlProduction def test_scripts_references_existent(self): # chaque chemin instance-de-test/*.py|.sh, ollama/*.py, ollama/*.yml cité existe ``` - [ ] **Step 2 : Lancer, vérifier l'échec.** Run : `python3 -m unittest tests.test_taches -v`. Expected : FAIL (fichier absent). - [ ] **Step 3 : Écrire `.vscode/tasks.json`.** - [ ] **Step 4 : Tests verts.** Run : `python3 -m unittest discover -s tests -v`. Expected : tous PASS. - [ ] **Step 5 : Essai dans VS Code** (WSL) : lancer `Tests`, puis `Import : simulation (instance de test)`. Expected : mêmes sorties qu'en ligne de commande ; `Import : ÉCRIRE (PRODUCTION)` avec `non` → « annulé ». - [ ] **Step 6 : Commit** — `git add .vscode tests/test_taches.py && git commit -m "Tâches VS Code : tests, instance de test, Ollama, import (production avec confirmation)"`. --- ### Task 6 : la documentation et les gestes de production **Files:** - Create: `README.md` (remplace le fichier vide), `docs/production.md` - Modify: `docs/verifications.md` - [ ] **Step 1 : `README.md`** : à quoi sert le dépôt (le brouillon dans LibreDesk, Ollama) ; que Support-AI est archivé et n'est plus suivi ; « rien ne part chez un client » ; installation (`python3`, Docker, aucun paquet Python) ; les tâches VS Code ; les commandes équivalentes ; retoucher la base (corpus → import simulation → `--ecrire`) ; liens vers le design, `docs/production.md`, `docs/verifications.md`. - [ ] **Step 2 : `docs/production.md`**, repris de `~/Support-AI/docs/production-libredesk-natif.md` : les gestes déjà faits restent cochés avec leur date (0 bis, 0 ter, 1 provisoire, 2, 3, 4, 5) ; le point 0 (relecture des 9 extraits « Savoir métier AIMsight ») reste ouvert ; le point « Plus tard : le programme Python sur Gitea » est retiré (abandonné le 2026-11-12). Puis la partie **Ollama**, étapes 3.1 à 3.7 du design (§6), chacune avec sa commande et sa vérification : - 3.1 état des lieux, sans rien changer : `docker version`, `id` (groupe `docker`), `uname -m` (doit être `x86_64`), `docker ps --format '{{.Names}} {{.Image}} {{.Networks}}'`, `ip -brief addr`, `free -h`, `df -h /var/lib/docker`, `ss -ltnp`, la configuration de Caddy en lecture. **Point d'arrêt** et ses cas (design §5). - 3.2 récupérer l'image (`docker pull` depuis le registre, ou repli `docker save … | ssh … docker load`), copier `ollama/compose.yml` (et `compose.reseau.yml` si LibreDesk est dans Docker), lancer avec `OLLAMA_BIND=` ou `RESEAU_LIBREDESK=`. - 3.3 `verifier.py` depuis l'hôte ou le réseau de LibreDesk ; depuis un téléphone en 4G, `http://46.14.212.91:11434` ne répond pas. - 3.4 Admin → IA → Providers, Embeddings : valeurs des Global Constraints ; bouton de test, puis enregistrement. - 3.5 journaux de LibreDesk : « reconciled embeddings … reindexed 118 ». - 3.6 « Generate reply » sur une vraie conversation, ne rien envoyer. - 3.7 LM Studio n'est plus nécessaire. - Retour en arrière ; « Au quotidien » (Ollama arrêté = brouillons sans base, sans alerte : `docker ps`, `verifier.py`) ; faiblesses connues reprises (sans celles qui concernent `generer.py` ou le programme Python). - [ ] **Step 3 : `docs/verifications.md`** : y ajouter, au-dessus de la simulation (Task 4), les constats LibreDesk encore utiles repris de Support-AI (authentification, routes des extraits et de la configuration IA, `generate-reply` sans notes privées, assistants exclus, recalcul automatique avec les références au code v2.9.0, l'essai LM Studio du 2026-11-11 et le réseau WSL `mirrored`). - [ ] **Step 4 : Relecture croisée.** Run : `grep -rn "support_diagnostic\|Agent IA\|tri:diagnostic\|generer.py" README.md docs/production.md docs/verifications.md`. Expected : aucune occurrence, sauf la mention « abandonné » dans `production.md`. - [ ] **Step 5 : Tests.** Run : `python3 -m unittest discover -s tests -v`. Expected : tous PASS. - [ ] **Step 6 : Commit** — `git add README.md docs && git commit -m "Documentation : README, gestes de production avec Ollama, constats"`.