diff --git a/instance-de-test/configurer_ia.py b/instance-de-test/configurer_ia.py new file mode 100644 index 0000000..ded46e8 --- /dev/null +++ b/instance-de-test/configurer_ia.py @@ -0,0 +1,36 @@ +"""Configure l'IA de l'instance de test : complétion par Claude (comme la production), embeddings à l'adresse donnée. +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é] +ex. : … 'TestAdmin-2026!' http://ollama:11434/v1 bge-m3:567m +""" +import os +import sys +from pathlib import Path + +from session import connexion, req + +INSTRUCTIONS = Path(__file__).resolve().parents[1] / "base_connaissances" / "instructions.md" + + +def configurer(type_: str, config: dict) -> None: + req("POST", f"/api/v1/ai/config/{type_}/test", config, timeout=120) + req("PUT", f"/api/v1/ai/config/{type_}", config) + print(f"{type_} : test réussi, configuration enregistrée") + + +def main(mot_de_passe: str, url_embeddings: str, modele: str, cle: str = "ollama") -> None: + cle_claude = os.environ.get("ANTHROPIC_API_KEY") or sys.exit("ANTHROPIC_API_KEY manque dans l'environnement") + 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}) + configurer("embedding", {"provider": "openai", "base_url": url_embeddings, "api_key": cle, "model": modele, + "dimensions": 0, "embedding_max_tokens": 2048}) + + +if __name__ == "__main__": + if len(sys.argv) < 4: + sys.exit(__doc__) + main(*sys.argv[1:5]) diff --git a/instance-de-test/demarrer.sh b/instance-de-test/demarrer.sh new file mode 100644 index 0000000..10a3721 --- /dev/null +++ b/instance-de-test/demarrer.sh @@ -0,0 +1,26 @@ +#!/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 +set -euo pipefail +cd "$(dirname "$0")" +MDP="${1:?usage : demarrer.sh }" + +if [ ! -f config.toml ]; then + curl -fsS -o config.toml https://raw.githubusercontent.com/abhinavxd/libredesk/v2.9.0/config.sample.toml + CLE=$(python3 -c 'import secrets; print(secrets.token_hex(16))') + sed -i "s/^encryption_key = .*/encryption_key = \"$CLE\"/" config.toml + echo "config.toml créé" +fi + +LIBREDESK_SYSTEM_USER_PASSWORD="$MDP" docker compose -p ldtest up -d + +for _ in $(seq 60); do + # une réponse HTTP, quelle qu'elle soit (401 sans connexion), suffit : le serveur écoute + if [ "$(curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:9100/api/v1/settings/general)" != "000" ]; then + echo "instance prête : http://127.0.0.1:9100 (Mailpit : http://127.0.0.1:9125)" + exit 0 + fi + sleep 1 +done +echo "LibreDesk ne répond pas après 60 s : docker logs ldtest_app" >&2 +exit 1 diff --git a/instance-de-test/docker-compose.yml b/instance-de-test/docker-compose.yml new file mode 100644 index 0000000..2cf8778 --- /dev/null +++ b/instance-de-test/docker-compose.yml @@ -0,0 +1,66 @@ +services: + # Libredesk app + app: # LibreDesk à la version de la production (v2.9.0) + image: libredesk/libredesk:v2.9.0 + container_name: ldtest_app + restart: unless-stopped + ports: + - "127.0.0.1:9100:9000" + environment: + # If the password is set during first docker-compose up, the system user password will be set to this value. + # You can always set system user password later by running `docker exec -it libredesk_app ./libredesk --set-system-user-password`. + LIBREDESK_SYSTEM_USER_PASSWORD: ${LIBREDESK_SYSTEM_USER_PASSWORD:-} + networks: + - libredesk + depends_on: + - db + - redis + volumes: + - ./uploads:/libredesk/uploads:rw + - ./config.toml:/libredesk/config.toml + command: [sh, -c, "./libredesk --install --idempotent-install --yes --config /libredesk/config.toml && ./libredesk --upgrade --yes --config /libredesk/config.toml && ./libredesk --config /libredesk/config.toml"] + + # PostgreSQL database + db: + image: postgres:17-alpine + container_name: ldtest_db + restart: unless-stopped + networks: + - libredesk + environment: + # Set these environment variables to configure the database, defaults to libredesk. + POSTGRES_USER: ${POSTGRES_USER:-libredesk} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-libredesk} + POSTGRES_DB: ${POSTGRES_DB:-libredesk} + healthcheck: + test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-libredesk} -d ${POSTGRES_DB:-libredesk}"] + interval: 10s + timeout: 5s + retries: 6 + volumes: + - postgres-data:/var/lib/postgresql/data + + # Redis + redis: + image: redis:7-alpine + container_name: ldtest_redis + restart: unless-stopped + networks: + - libredesk + volumes: + - redis-data:/data + + mailpit: # SMTP piège : tout « envoi » y reste, rien ne sort + image: axllent/mailpit:v1.27 + container_name: ldtest_mailpit + ports: + - "127.0.0.1:9125:8025" + networks: + - libredesk + +networks: + libredesk: + +volumes: + postgres-data: + redis-data: diff --git a/instance-de-test/empreintes.sh b/instance-de-test/empreintes.sh new file mode 100755 index 0000000..6a44bea --- /dev/null +++ b/instance-de-test/empreintes.sh @@ -0,0 +1,6 @@ +#!/usr/bin/env bash +# Les empreintes d'indexation des extraits actifs (id|empreinte), lues dans la base de l'instance de TEST. +# Lecture seule ; jamais sur la production. Une empreinte vide : extrait pas encore indexé. +set -euo pipefail +docker exec ldtest_db psql -U libredesk -d libredesk -At \ + -c "SELECT id, embedded_fingerprint FROM ai_knowledge_base WHERE enabled ORDER BY id" diff --git a/instance-de-test/essayer_brouillons.py b/instance-de-test/essayer_brouillons.py new file mode 100644 index 0000000..cc70f29 --- /dev/null +++ b/instance-de-test/essayer_brouillons.py @@ -0,0 +1,90 @@ +"""L'essai des brouillons sur l'instance de test (après preparer.py et configurer_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] +""" +import datetime +import html +import json +import re +import sys +import time +import urllib.request +from pathlib import Path + +from session import connexion, req + +MAILPIT = "http://127.0.0.1:9125/api/v1/messages" +ICI = Path(__file__).resolve().parent +MAILS = ICI / "mails" +ESSAIS = ["4g", "cible-perdue", "fuseau", "hors-base", "suite"] # « suite » : après l'échange « histoire » + + +def total_mailpit() -> int: + with urllib.request.urlopen(MAILPIT, timeout=10) as r: + return json.loads(r.read())["total"] + + +def en_html(texte: str) -> str: + return "".join(f"

{html.escape(p).replace(chr(10), '
')}

" for p in texte.strip().split("\n\n")) + + +def en_texte(contenu: str) -> str: + t = re.sub(r"
  • ", "- ", re.sub(r"

    ||
  • |", "\n", contenu)) + return re.sub(r"\n{3,}", "\n\n", html.unescape(re.sub(r"<[^>]+>", "", t))).strip() + + +def mail(nom: str) -> tuple[str, str]: + objet, corps = (MAILS / f"{nom}.txt").read_text(encoding="utf-8").split("\n", 1) + return objet.strip(), corps.strip() + + +def conversation(boite: int, nom: str, contact: str) -> str: + objet, corps = mail(nom) + conv = req("POST", "/api/v1/conversations", {"inbox_id": boite, "contact_email": contact, "first_name": "Client", + "last_name": nom, "initiator": "contact", "subject": objet, + "content": en_html(corps)}) + return conv["uuid"] + + +def main(mot_de_passe: str = "TestAdmin-2026!") -> None: + connexion(mot_de_passe) + boite = next(b["id"] for b in req("GET", "/api/v1/inboxes") if b["name"] == "Test") + avant = total_mailpit() + # L'échange précédent du contact « suite » : sa question et la réponse de l'agent (elle part dans Mailpit). + histoire = conversation(boite, "histoire", "client-suite@example.com") + req("POST", f"/api/v1/conversations/{histoire}/messages", + {"message": en_html((MAILS / "histoire-reponse.txt").read_text(encoding="utf-8")), "private": False, + "sender_type": "agent", "to": ["client-suite@example.com"]}) + uuids = {n: conversation(boite, n, "client-suite@example.com" if n == "suite" else f"client-{n}@example.com") + for n in ESSAIS} + for _ in range(30): # attendre que la réponse de l'agent soit arrivée dans Mailpit + if total_mailpit() > avant: + break + time.sleep(1) + reference = total_mailpit() + + lignes = [f"# Essai des brouillons, {datetime.date.today()}", ""] + for n in ESSAIS: + objet, corps = mail(n) + debut = time.monotonic() + rep = req("POST", "/api/v1/ai/generate-reply", {"conversation_uuid": uuids[n], "instruction": ""}, timeout=300) + duree = time.monotonic() - debut + brouillon = en_texte(rep.get("content") or "") if rep.get("status") == "completed" else json.dumps(rep) + print(f"{n} : {rep.get('status')} en {duree:.0f} s") + lignes += [f"## {n} : {objet}", "", f"Durée : {duree:.0f} s ; statut : {rep.get('status')}", "", + "**Le mail**", "", corps, "", "**Le brouillon**", "", brouillon, ""] + + time.sleep(5) + if total_mailpit() != reference: + sys.exit(f"un message est sorti pendant la génération : Mailpit {reference} → {total_mailpit()}") + sortie = ICI.parent / "cases" / f"essai-brouillons-{datetime.date.today()}.md" + sortie.parent.mkdir(exist_ok=True) + sortie.write_text("\n".join(lignes), encoding="utf-8") + print(f"Mailpit inchangé pendant la génération ({reference}) ; rapport : {sortie}") + + +if __name__ == "__main__": + main(*sys.argv[1:2]) diff --git a/instance-de-test/mails/4g.txt b/instance-de-test/mails/4g.txt new file mode 100644 index 0000000..f07352c --- /dev/null +++ b/instance-de-test/mails/4g.txt @@ -0,0 +1,10 @@ +Station sans connexion 4G + +Bonjour, + +Nous avons installé la station hier sur le chantier. Elle est allumée (la LED clignote) mais elle n'apparaît pas en ligne sur la plateforme et nous ne recevons aucune donnée. La carte SIM a été insérée par notre technicien. + +Que devons-nous vérifier ? + +Merci d'avance, +Julie Exemple diff --git a/instance-de-test/mails/cible-perdue.txt b/instance-de-test/mails/cible-perdue.txt new file mode 100644 index 0000000..43dc82f --- /dev/null +++ b/instance-de-test/mails/cible-perdue.txt @@ -0,0 +1,8 @@ +Une cible n'est plus mesurée + +Salut, + +Depuis mardi, la cible P4 n'a plus aucune mesure sur la page des déplacements. Les autres cibles sont normales. On n'a rien touché sur place. Tu sais ce qui peut causer ça ? + +Merci, +Thomas diff --git a/instance-de-test/mails/fuseau.txt b/instance-de-test/mails/fuseau.txt new file mode 100644 index 0000000..e201fc6 --- /dev/null +++ b/instance-de-test/mails/fuseau.txt @@ -0,0 +1,8 @@ +Zeitzone im CSV-Export + +Guten Tag, + +wir haben die Messdaten als CSV exportiert und wollen sie mit unseren eigenen Messungen vergleichen. In welcher Zeitzone sind die Zeitstempel im Export angegeben? Müssen wir die Sommerzeit berücksichtigen? + +Freundliche Grüsse +Anna Beispiel diff --git a/instance-de-test/mails/histoire-reponse.txt b/instance-de-test/mails/histoire-reponse.txt new file mode 100644 index 0000000..d97fa6a --- /dev/null +++ b/instance-de-test/mails/histoire-reponse.txt @@ -0,0 +1,5 @@ +Bonjour, + +Avec la veille activée entre les mesures (une mesure toutes les 15 minutes), la station tient environ 5 jours sur sa batterie. Deux jours sans courant ne posent donc pas de problème, à condition que la batterie soit pleine au départ. + +Salutations, diff --git a/instance-de-test/mails/histoire.txt b/instance-de-test/mails/histoire.txt new file mode 100644 index 0000000..96619a3 --- /dev/null +++ b/instance-de-test/mails/histoire.txt @@ -0,0 +1,8 @@ +Autonomie de la batterie + +Bonjour, + +Le chantier sera sans courant pendant deux jours la semaine prochaine. Combien de temps la station tient-elle sur sa batterie ? + +Cordialement, +Pierre Exemple diff --git a/instance-de-test/mails/hors-base.txt b/instance-de-test/mails/hors-base.txt new file mode 100644 index 0000000..549568f --- /dev/null +++ b/instance-de-test/mails/hors-base.txt @@ -0,0 +1,8 @@ +Facture du deuxième trimestre + +Bonjour, + +Notre service comptable n'a pas reçu la facture du deuxième trimestre pour la location de la station. Pouvez-vous nous la renvoyer, et nous dire si le montant a changé par rapport au premier trimestre ? + +Cordialement, +Marie Exemple diff --git a/instance-de-test/mails/suite.txt b/instance-de-test/mails/suite.txt new file mode 100644 index 0000000..e2063ac --- /dev/null +++ b/instance-de-test/mails/suite.txt @@ -0,0 +1,8 @@ +Coupure de courant terminée + +Bonjour, + +Comme annoncé, le chantier a été sans courant mercredi et jeudi. Le courant est revenu vendredi matin, mais la station n'a plus envoyé de mesures depuis jeudi soir. Est-ce normal ? Faut-il intervenir sur place ? + +Cordialement, +Pierre Exemple diff --git a/instance-de-test/preparer.py b/instance-de-test/preparer.py new file mode 100644 index 0000000..402fcf3 --- /dev/null +++ b/instance-de-test/preparer.py @@ -0,0 +1,37 @@ +"""Prépare une instance de test neuve : la boîte e-mail « Test » (SMTP = Mailpit, rien ne sort) et l'agent +« 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 +""" +import sys +from pathlib import Path + +from session 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", + "hello_hostname": ""} +IMAP = {"host": "127.0.0.1", "port": 1, "username": "x", "password": "x", "mailbox": "INBOX", "read_interval": "1h", + "scan_inbox_since": "1h", "tls_type": "none"} + + +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") + req("POST", "/api/v1/inboxes", {"name": "Test", "channel": "email", "enabled": True, "csat_enabled": False, + "from": "Support ", + "config": {"auth_type": "password", "from": "Support ", + "smtp": [SMTP], "imap": [IMAP]}}) + agent = req("POST", "/api/v1/agents", {"first_name": "Import", "last_name": "base", "email": "import@example.com", + "roles": ["Admin"], "send_welcome_email": False, "enabled": True}) + cle = req("POST", f"/api/v1/agents/{agent['id']}/api-key") + env = Path(__file__).with_name(".env") + env.write_text(f"LIBREDESK_URL={B}\nLIBREDESK_ADMIN_KEY={cle['api_key']}\n" + f"LIBREDESK_ADMIN_SECRET={cle['api_secret']}\n") + print(f"prête : boîte « Test » (SMTP = Mailpit), clé d'import dans {env}") + + +if __name__ == "__main__": + main(*sys.argv[1:2]) diff --git a/instance-de-test/session.py b/instance-de-test/session.py new file mode 100644 index 0000000..2a187db --- /dev/null +++ b/instance-de-test/session.py @@ -0,0 +1,33 @@ +"""La session de l'administrateur `System` sur l'instance de test (127.0.0.1:9100), partagée par les scripts de ce +dossier. Instance de test seulement : jamais la production.""" +import http.cookiejar +import json +import sys +import urllib.error +import urllib.request + +B = "http://127.0.0.1:9100" +_jar = http.cookiejar.CookieJar() +_op = urllib.request.build_opener(urllib.request.HTTPCookieProcessor(_jar)) + + +def req(methode: str, chemin: str, corps: dict | None = None, timeout: int = 60) -> object: + """Une requête de l'administrateur ; rend `data`. S'arrête sur une erreur HTTP, sans jamais afficher le corps + envoyé (il peut porter une clé).""" + r = urllib.request.Request(B + chemin, method=methode, + data=json.dumps(corps).encode() if corps is not None else None, + headers={"Content-Type": "application/json", "X-CSRFTOKEN": "t0k3n"}) + try: + with _op.open(r, timeout=timeout) as x: + return json.loads(x.read() or b"{}").get("data") + except urllib.error.HTTPError as e: + with e: + sys.exit(f"{methode} {chemin} : {e.code} {e.read().decode(errors='replace')[:300]}") + + +def connexion(mot_de_passe: str) -> None: + req("POST", "/api/v1/auth/login", {"email": "System", "password": mot_de_passe}) + for c in _jar: + c.secure = False # cookies Secure : http local + _jar.set_cookie(http.cookiejar.Cookie(0, "csrf_token", "t0k3n", None, False, "127.0.0.1", False, False, "/", True, + False, None, False, None, None, {})) # le serveur compare cookie et en-tête