From b475da0acc2e9fec32b5cf361ddb6dbf21b26f7c Mon Sep 17 00:00:00 2001 From: maxime Date: Thu, 5 Nov 2026 16:30:38 +0100 Subject: [PATCH] app/: the Support page reads client mails from LibreDesk (read-only) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Menu « Depuis LibreDesk » : the 50 latest conversations; choosing one fills the mail (thread newest first, no private notes, decoded subjects) and its images over 10 kB. Settings LIBREDESK_* in API/.env; check_libredesk in check.py. Co-Authored-By: Claude Opus 5.5 --- API/README.md | 3 ++ app/README.md | 3 +- app/serveur/check.py | 30 ++++++++++++- app/serveur/libredesk.py | 79 +++++++++++++++++++++++++++++++++++ app/serveur/serveur.py | 19 +++++++++ app/web/src/pages/Support.jsx | 18 +++++++- 6 files changed, 148 insertions(+), 4 deletions(-) create mode 100644 app/serveur/libredesk.py diff --git a/API/README.md b/API/README.md index 44ab808..f07d972 100644 --- a/API/README.md +++ b/API/README.md @@ -20,6 +20,9 @@ LANGSMITH_API_KEY=... LANGSMITH_TRACING=true LANGSMITH_ENDPOINT=https://eu.api.smith.langchain.com LANGSMITH_PROJECT=Support +LIBREDESK_URL=https://... # facultatif : les mails depuis LibreDesk (app/serveur/libredesk.py) +LIBREDESK_API_KEY=... # Admin → Teammates → Agents → Generate API key +LIBREDESK_API_SECRET=... ``` ## La web app diff --git a/app/README.md b/app/README.md index 6cf236c..eb15fb0 100644 --- a/app/README.md +++ b/app/README.md @@ -2,7 +2,7 @@ L'outil interne du support et du diagnostic manuel (D-137, D-138) : trois pages dans la barre latérale. -- **Support** : coller le mail du client et son contexte, Analyser ; les fils du support et de l'analyste (les agents de `API/`, `API/README.md`), le PDF par version. Dès que la séance a sa station, deux boutons ouvrent Images et Data sur elle. +- **Support** : coller le mail du client, ou choisir sa conversation dans le menu « Depuis LibreDesk » (le fil, le plus récent en tête, sans les notes privées, et ses images de plus de 10 ko ; retouchable), et son contexte, Analyser ; les fils du support et de l'analyste (les agents de `API/`, `API/README.md`), le PDF par version. Dès que la séance a sa station, deux boutons ouvrent Images et Data sur elle. - **Images** : les images de la caméra, comme `view/view.py` : glisseur, ◀ ▶ et flèches du clavier ; molette pour zoomer, glisser pour se déplacer, double clic pour l'image entière ; case Noms (cibles en jaune, références en bleu) ; une plage sur la barre sous le glisseur dessine la flèche de déplacement de chaque capteur (corr_x, corr_y, facteur modifiable). - **Data** (D-139) : le visualiseur de courbes, et l'étiquetage de `labeling/labeling.py` : un plot au départ (déplacements, caméra, qualité, métriques système), « Ajouter un plot » pour en voir plusieurs, alignés sur le temps, la croix pour en enlever un ; sous eux le choix des étiquettes, LLM (`labeling/auto/`, l'étiqueteur), Detectors (les événements des détecteurs du journal, `detectors/categories.py`, en lecture seule, D-140) ou Manual (`labeling/manual/`), et leur barre ; y glisser sélectionne une plage, puis famille, texte, Ajouter ; un clic met une étiquette en évidence sur les plots et la barre, cale les images sur son début, et l'ouvre : bornes, famille, texte, Enregistrer, Supprimer ; un clic ailleurs sur la barre la referme. Les zones des étiquettes sur les plots sont à peine visibles (opacité 0,05, 0,07 en sombre). Écrit dans `labeling//.jsonl`. À droite, le visualiseur de la page Images, sur la même station et la même plage (D-140) ; une flèche en haut à gauche de l'image l'agrandit et pousse les plots vers la gauche (les colonnes glissent, les plots se recalent à la fin du glissement), la flèche inverse la ramène. @@ -28,6 +28,7 @@ La page s'ouvre sur `http://127.0.0.1:8770`. Réglages par variables : `AIMSIGHT - `serveur/serveur.py` : FastAPI ; sert la page construite et l'API sous `/api` (séance, flux des agents, PDF, stations, images, courbes, étiquettes) ; ne répond qu'aux pages du poste (Host local, JSON déclaré). - `serveur/station.py` : les données des pages Images et Data ; lecture seule sur `data/`, écrit seulement dans `labeling/{auto,manual}/`. +- `serveur/libredesk.py` : les conversations et les mails de LibreDesk, en lecture seule (API REST v1, `token clé:secret`) ; ses réglages `LIBREDESK_*` dans `API/.env` (`API/README.md`). - `serveur/check.py` : vérifications, sans appel à l'API : `API/.venv/bin/python app/serveur/check.py`. - `web/` : React (Vite) et Mantine ; `src/App.jsx` (en-tête, barre latérale, pages, adresse), `src/pages/` (une page par fichier), `src/commun.jsx` (requêtes, cartes, sélecteur), `src/main.jsx` (thème). Plotly, habillé aux couleurs de Mantine (D-139), ne se charge qu'avec Data. `dist/` et `node_modules/` hors de git. - `docs/` : la conception des pages Images et Étiquetage (devenue Data, D-139). diff --git a/app/serveur/check.py b/app/serveur/check.py index 71b922c..2098a26 100644 --- a/app/serveur/check.py +++ b/app/serveur/check.py @@ -109,7 +109,35 @@ def check_station(): station.ETIQUETTES = avant -CHECKS = [check_serveur, check_station] +def check_libredesk(): + # le fil et ses images depuis de fausses réponses de l'API : ordre, notes privées, logos écartés + import base64 + import libredesk + png = b"\x89PNG" + b"x" * libredesk.TAILLE_MIN + msgs = [{"created_at": "2026-11-04T08:00Z", "type": "incoming", "private": False, "text_content": "Bonjour, trou ?", + "author": {"first_name": "David", "email": "d@x.ch"}, "meta": {"subject": "Crissier"}, + "attachments": [{"name": "c.png", "content_type": "image/png", "size": len(png), "url": "/uploads/a"}, + {"name": "logo.png", "content_type": "image/png", "size": 900, "url": "/uploads/b"}]}, + {"created_at": "2026-11-04T09:00Z", "type": "outgoing", "private": True, "text_content": "note interne"}, + {"created_at": "2026-11-05T08:00Z", "type": "outgoing", "private": False, "text_content": "Hello David", + "author": {"first_name": "Marc"}}] + avant = libredesk._requete + libredesk._requete = lambda c: json.dumps({"data": {"results": msgs}}).encode() if "/messages" in c else png + try: + c = libredesk.conversation("0b1c-2d") + finally: + libredesk._requete = avant + assert c["mail"].index("Hello David") < c["mail"].index("Bonjour, trou ?") and "note interne" not in c["mail"], c["mail"] + assert "De: David " in c["mail"] and "Objet: Crissier" in c["mail"], c["mail"] + assert [i["nom"] for i in c["images"]] == ["c.png"] and base64.b64decode(c["images"][0]["base64"]) == png + try: + libredesk.conversation("../x") + raise AssertionError("uuid ../x accepté") + except ValueError: + pass + + +CHECKS = [check_serveur, check_station, check_libredesk] if __name__ == "__main__": nom = sys.argv[1] if len(sys.argv) > 1 else None diff --git a/app/serveur/libredesk.py b/app/serveur/libredesk.py new file mode 100644 index 0000000..e4dabd9 --- /dev/null +++ b/app/serveur/libredesk.py @@ -0,0 +1,79 @@ +"""Les mails des clients depuis le LibreDesk de l'entreprise, en lecture seule (API REST v1, https://docs.libredesk.io). + +Réglages, dans API/.env (chargé par seance.py) : LIBREDESK_URL (ex. https://support.aimsight.ch), LIBREDESK_API_KEY, +LIBREDESK_API_SECRET (Admin → Teammates → Agents → Generate API key ; permissions conversations:read_all, messages:read). +""" +import base64 +import email.header +import json +import os +import urllib.parse +import urllib.request + +TYPES_IMAGE = {"image/png", "image/jpeg", "image/gif", "image/webp"} # ceux que lit la séance (seance.TYPES_IMAGE) +TAILLE_MIN = 10_000 # ponytail: octets ; écarte les logos des signatures, à revoir si une vraie capture est plus petite + + +class Absent(Exception): + """LibreDesk n'est pas configuré dans API/.env.""" + + +def _requete(chemin: str) -> bytes: + base, cle, secret = (os.environ.get(k, "") for k in ("LIBREDESK_URL", "LIBREDESK_API_KEY", "LIBREDESK_API_SECRET")) + if not (base and cle and secret): + raise Absent("LibreDesk non configuré : LIBREDESK_URL, LIBREDESK_API_KEY, LIBREDESK_API_SECRET dans API/.env") + r = urllib.request.Request(urllib.parse.urljoin(base.rstrip("/") + "/", chemin.lstrip("/"))) + r.add_unredirected_header("Authorization", f"token {cle}:{secret}") # pas vers S3 si /uploads redirige + with urllib.request.urlopen(r, timeout=30) as rep: + return rep.read() + + +def _objet(s: str | None) -> str: + """Un objet de mail encodé (=?Windows-1252?Q?…?=, RFC 2047) en clair ; tel quel s'il ne se décode pas.""" + try: + return str(email.header.make_header(email.header.decode_header(s or ""))) + except (LookupError, ValueError, UnicodeDecodeError): + return s or "" + + +def _json(chemin: str) -> dict: + return json.loads(_requete(chemin))["data"] + + +def conversations() -> list[dict]: + """Les 50 conversations au dernier message le plus récent.""" + d = _json("/api/v1/conversations/all?page_size=50&order_by=conversations.last_message_at&order=desc") + return [{"uuid": c["uuid"], "reference": c["reference_number"], "sujet": _objet(c.get("subject")) or "(sans objet)", + "contact": " ".join(filter(None, [(c.get("contact") or {}).get(k) for k in ("first_name", "last_name")])), + "date": c.get("last_message_at"), "statut": c.get("status")} for c in d["results"]] + + +def mail(messages: list[dict]) -> str: + """Le fil en texte, le plus récent en tête comme un mail collé ; ni notes privées ni activités.""" + blocs = [] + for m in sorted(messages, key=lambda m: m["created_at"], reverse=True): + if m.get("private") or m.get("type") not in ("incoming", "outgoing"): + continue + a, meta = m.get("author") or {}, m.get("meta") or {} + qui = " ".join(filter(None, [a.get("first_name"), a.get("last_name")])) or ", ".join(meta.get("from") or []) + tete = [f"De: {qui}" + (f" <{a['email']}>" if a.get("email") else ""), f"Date: {m['created_at']}"] + if meta.get("subject"): + tete.append(f"Objet: {_objet(meta['subject'])}") + blocs.append("\n".join(tete) + "\n\n" + (m.get("text_content") or m.get("content") or "").strip()) + return "\n\n---\n\n".join(blocs) + + +def conversation(uuid: str) -> dict: + """Le mail et ses images (base64, comme les captures collées dans la page Support).""" + if not uuid.replace("-", "").isalnum(): + raise ValueError("uuid invalide") + msgs = _json(f"/api/v1/conversations/{uuid}/messages?page_size=500&type=incoming&type=outgoing")["results"] + images = [] + for m in msgs: + if m.get("private"): + continue + for p in m.get("attachments") or []: + if p.get("content_type") in TYPES_IMAGE and (p.get("size") or 0) >= TAILLE_MIN and p.get("url"): + images.append({"nom": p.get("name") or "piece", "type": p["content_type"], + "base64": base64.b64encode(_requete(p["url"])).decode()}) + return {"mail": mail(msgs), "images": images} diff --git a/app/serveur/serveur.py b/app/serveur/serveur.py index 9bafe99..6bc463b 100644 --- a/app/serveur/serveur.py +++ b/app/serveur/serveur.py @@ -21,6 +21,7 @@ import uvicorn from fastapi import FastAPI, Query, Request from fastapi.responses import FileResponse, JSONResponse, StreamingResponse +import libredesk import station from fastapi.staticfiles import StaticFiles @@ -138,6 +139,24 @@ def message(corps: dict): return {} +# --- les mails de LibreDesk (libredesk.py), pour remplir la page Support + +@app.get("/api/libredesk") +def libredesk_liste(): + try: + return libredesk.conversations() + except Exception as e: # noqa: BLE001 — non configuré ou injoignable : le dire dans la page + return erreur(502, f"LibreDesk : {e}") + + +@app.get("/api/libredesk/{uuid}") +def libredesk_conversation(uuid: str): + try: + return libredesk.conversation(uuid) + except Exception as e: # noqa: BLE001 + return erreur(502, f"LibreDesk : {e}") + + # --- les pages Images et Data (station.py) @app.exception_handler(station.Refus) diff --git a/app/web/src/pages/Support.jsx b/app/web/src/pages/Support.jsx index d1d903e..b0b63bb 100644 --- a/app/web/src/pages/Support.jsx +++ b/app/web/src/pages/Support.jsx @@ -1,8 +1,8 @@ import { useEffect, useRef, useState } from "react"; -import { ActionIcon, Badge, Button, Grid, Group, Image, Paper, ScrollArea, SimpleGrid, Stack, Text, Textarea, Title, Tooltip } from "@mantine/core"; +import { ActionIcon, Badge, Button, Grid, Group, Image, Paper, ScrollArea, Select, SimpleGrid, Stack, Text, Textarea, Title, Tooltip } from "@mantine/core"; import { notifications } from "@mantine/notifications"; import { IconChartLine, IconDownload, IconPhoto, IconSend } from "@tabler/icons-react"; -import { Carte, poster } from "../commun.jsx"; +import { appel, Carte, poster } from "../commun.jsx"; export const AGENTS = ["support", "analyste"]; export const NOMS = { support: "Support", analyste: "Analyste" }; @@ -24,6 +24,17 @@ export function Etat({ occupe }) { function Saisie({ occupe }) { const [mail, setMail] = useState(""), [contexte, setContexte] = useState(""), [images, setImages] = useState([]); + const [fils, setFils] = useState(null), [fil, setFil] = useState(null); + + // LibreDesk : la liste au premier clic sur le menu ; un fil choisi remplit le mail et ses images, qu'on peut retoucher + const listerFils = async () => fils || setFils(await appel("/api/libredesk") || []); + async function choisirFil(uuid) { + setFil(uuid); + const c = uuid && await appel(`/api/libredesk/${uuid}`); + if (!c) return; + setMail(c.mail); + setImages(c.images.map(im => ({ ...im, url: `data:${im.type};base64,${im.base64}` }))); + } function coller(ev) { for (const item of ev.clipboardData.items) { @@ -44,6 +55,9 @@ function Saisie({ occupe }) { Analyser}> +