- 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>
234 lines
27 KiB
Markdown
234 lines
27 KiB
Markdown
# 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://<hôte>: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:<x.y.z>`, 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 <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
|
|
|
|
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 <mot de passe System>` : 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 <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ô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 <mot de passe System> <url des embeddings> <modèle> [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-<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` ; 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:<version d'Ollama>-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 <base_url>` (stdlib) : `GET <base_url>/models` doit lister `bge-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. 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:<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`, 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:<tag>`. 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=<adresse interne>` ou `RESEAU_LIBREDESK=<réseau de 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"`.
|