- base_connaissances/ → snippets/ (corpus/ → textes/, instructions.md → consignes_redaction.md, decoupage.py → fichiers.py, importer.py → envoyer.py) ; python3 -m snippets.envoyer. - instance-de-test/ : 1_demarrer.sh, 2_creer_boite_et_cle.py, 3_brancher_ia.py, 4_essayer_brouillons.py, voir_empreintes.sh, connexion_admin.py. - ollama/verifier.py → ollama/verifier_ollama.py ; tests, tâches VS Code et docs alignés. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
27 KiB
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) ; dansinstance-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/snippetset/api/v1/ai/snippets/{id}; jamais/messages,/conversations,DELETE,automations,assistants(testtest_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-m3de la bibliothèque Ollama, étiquette figéebge-m3:567m(dimension 1024). Configuration LibreDesk : fournisseuropenai,base_urlhttp://<hôte>:11434/v1, modèlebge-m3:567m, cléollama,dimensions0,embedding_max_tokens2048. - Image de base Ollama à une version figée (
ollama/ollama:<x.y.z>, la dernière stable au moment de la construction, notée dans le Dockerfile), jamaislatest. Modèle gardé chargé :OLLAMA_KEEP_ALIVE=-1. - Port d'Ollama publié sur
127.0.0.1par défaut ; une autre adresse seulement par la variableOLLAMA_BIND. Jamais0.0.0.0par défaut. - Complétion de l'instance de test (comme la production) : fournisseur
openai,base_urlhttps://api.anthropic.com/v1, modèleclaude-sonnet-5-5,max_tokens4096,reasoning_effortmedium, instructions =base_connaissances/instructions.md. - Secrets dans
.env(racine) etinstance-de-test/.env, hors de git. Ne jamais afficher une clé. - Commandes
python3,git,dockerlancé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 <noreply@anthropic.com>. - 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
- 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 ».
- Serveur sans accès à Internet : l'image doit servir bge-m3 sans rien télécharger. → Task 3,
verifier.pysur un réseau Docker--internal. - 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. - Le port d'Ollama ouvert sur toutes les interfaces par un oubli de variable : le compose publie sur
127.0.0.1par défaut. → Task 3,test_port_lie_a_localhost_par_defaut. preparer.pyrelancé 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 copierbase_connaissances/generer.py.
Interfaces:
-
Produces:
python3 -m base_connaissances.importer [--ecrire](litLIBREDESK_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"àSTATIONSdanstests/test_corpus.py. -
Step 3 : Retirer des docstrings et commentaires toute mention de
support_diagnostic, de « spec §… » de Support-AI ou degenerer.py(grep -rn "support_diagnostic\|generer\|spec §" base_connaissances testsne 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 partest_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(renddata,sys.exitavec 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(cookieSecuredésactivé,csrf_tokenfixé àt0k3n, en-têteX-CSRFTOKEN).demarrer.sh <mot de passe System>: siconfig.tomlmanque, le télécharge depuishttps://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.tomlet y met uneencryption_keyaléatoire (commande de~/Support-AI/docs/verifications.md, « L'instance de test ») ; puisLIBREDESK_SYSTEM_USER_PASSWORD=… docker compose -p ldtest up -d; attend queGET /api/v1/settings/generalréponde (60 s max).preparer.py <mot de passe System>: crée la boîte e-mail « Test » (SMTP = Mailpit, configuration de~/Support-AI/instance-de-test/preparer.py), l'agent « Import base » (rôleAdmin, e-mailimport@example.com) et sa clé ; écraseinstance-de-test/.envavecLIBREDESK_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 <mot de passe System> <url des embeddings> <modèle> [clé](clé par défautollama) :ANTHROPIC_API_KEYlu dans l'environnement ; pourcompletionpuisembedding,POST /api/v1/ai/config/{type}/testpuisPUT /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 parsession.py, rapport danscases/essai-brouillons-<date>.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; adapteressayer_brouillons.pyaux 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 surhttp://127.0.0.1:9100. -
Step 3 : Préparer. Run :
python3 -I instance-de-test/preparer.py 'TestAdmin-2026!'. Expected :instance-de-test/.envcontient 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
socatde~/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:<version d'Ollama>-567m, construite pardocker compose -f ollama/compose.yml build. Le Dockerfile téléchargebge-m3:567mpendant la construction (serveur lancé en arrière-plan le temps d'unollama pull) ;ENV OLLAMA_HOST=0.0.0.0:11434 OLLAMA_KEEP_ALIVE=-1;HEALTHCHECKparollama list. compose.yml: serviceollama,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'aliasollama. LocalementRESEAU_LIBREDESK=ldtest_libredesk; sur le serveur, le réseau de LibreDesk s'il est dans Docker.ollama/verifier.py <base_url>(stdlib) :GET <base_url>/modelsdoit listerbge-m3:567m;POST <base_url>/embeddings {"model":"bge-m3:567m","input":"Quelle est l'autonomie de la batterie ?"}doit rendre un vecteur de 1024 nombres. AfficheOK bge-m3:567m, 1024 dimensionset sort en 0 ; sinon un message qui dit ce qui manque, sort en 1. Fonction testable :verifier(base_url: str) -> str(lèveRuntimeErroravec le message).
- Image
-
Step 1 : Écrire les tests dans
tests/test_ollama.py(faux serveurhttp.serverlocal, commefaux_libredesk.py) :
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:<x.y.z>, 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 <image> && 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, puisdocker kill ollama-bge-m3 && sleep 15 && docker ps --filter name=ollama-bge-m3. Expected :OK …, puis le conteneur est de nouveauUp(après undocker kill,unless-stoppedrelance). Puissudo 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 faitdocker login exchange.sensima.ch. Run :docker push exchange.sensima.ch/maxime.pasquier/ollama-bge-m3:<tag>. Expected : l'image apparaît dans Packages du compte. En cas de refus (taille,413) : noter l'erreur dansdocs/verifications.md; le replidocker save | ssh … docker loadsera décrit dansdocs/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"puisbash instance-de-test/empreintes.sh > /tmp/apres.txt. Expected : « embedding provider changed, reindexing knowledge base » puis « reconciled embeddings … reindexed 118 » ; 118 lignes dansapres.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 surhttp://ollama:11434/v1sans 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 brouillonscompleted, « 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.jsonavecjson) :
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, puisImport : simulation (instance de test). Expected : mêmes sorties qu'en ligne de commande ;Import : ÉCRIRE (PRODUCTION)avecnon→ « 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(groupedocker),uname -m(doit êtrex86_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 pulldepuis le registre, ou replidocker save … | ssh … docker load), copierollama/compose.yml(etcompose.reseau.ymlsi LibreDesk est dans Docker), lancer avecOLLAMA_BIND=<adresse interne>ouRESEAU_LIBREDESK=<réseau de LibreDesk>. - 3.3
verifier.pydepuis l'hôte ou le réseau de LibreDesk ; depuis un téléphone en 4G,http://46.14.212.91:11434ne 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 concernentgenerer.pyou le programme Python).
- 3.1 état des lieux, sans rien changer :
-
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-replysans 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 WSLmirrored). -
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é » dansproduction.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".