app/: the Support page reads client mails from LibreDesk (read-only)

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 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-05 16:30:38 +01:00
1 parent 67a1d71c57
commit b475da0acc
6 files changed
+148 -4

No files matched your search

+3
View File
@@ -20,6 +20,9 @@ LANGSMITH_API_KEY=...
LANGSMITH_TRACING=true LANGSMITH_TRACING=true
LANGSMITH_ENDPOINT=https://eu.api.smith.langchain.com LANGSMITH_ENDPOINT=https://eu.api.smith.langchain.com
LANGSMITH_PROJECT=Support 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 ## La web app
+2 -1
View File
@@ -2,7 +2,7 @@
L'outil interne du support et du diagnostic manuel (D-137, D-138) : trois pages dans la barre latérale. 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). - **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/<auto|manual>/<STATION>.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. - **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/<auto|manual>/<STATION>.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/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/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`. - `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. - `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). - `docs/` : la conception des pages Images et Étiquetage (devenue Data, D-139).
+29 -1
View File
@@ -109,7 +109,35 @@ def check_station():
station.ETIQUETTES = avant 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 <d@x.ch>" 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__": if __name__ == "__main__":
nom = sys.argv[1] if len(sys.argv) > 1 else None nom = sys.argv[1] if len(sys.argv) > 1 else None
+79
View File
@@ -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}
+19
View File
@@ -21,6 +21,7 @@ import uvicorn
from fastapi import FastAPI, Query, Request from fastapi import FastAPI, Query, Request
from fastapi.responses import FileResponse, JSONResponse, StreamingResponse from fastapi.responses import FileResponse, JSONResponse, StreamingResponse
import libredesk
import station import station
from fastapi.staticfiles import StaticFiles from fastapi.staticfiles import StaticFiles
@@ -138,6 +139,24 @@ def message(corps: dict):
return {} 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) # --- les pages Images et Data (station.py)
@app.exception_handler(station.Refus) @app.exception_handler(station.Refus)
+16 -2
View File
@@ -1,8 +1,8 @@
import { useEffect, useRef, useState } from "react"; 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 { notifications } from "@mantine/notifications";
import { IconChartLine, IconDownload, IconPhoto, IconSend } from "@tabler/icons-react"; 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 AGENTS = ["support", "analyste"];
export const NOMS = { support: "Support", analyste: "Analyste" }; export const NOMS = { support: "Support", analyste: "Analyste" };
@@ -24,6 +24,17 @@ export function Etat({ occupe }) {
function Saisie({ occupe }) { function Saisie({ occupe }) {
const [mail, setMail] = useState(""), [contexte, setContexte] = useState(""), [images, setImages] = useState([]); 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) { function coller(ev) {
for (const item of ev.clipboardData.items) { for (const item of ev.clipboardData.items) {
@@ -44,6 +55,9 @@ function Saisie({ occupe }) {
<Carte surtitre="Demande" titre="Le mail du client" action={<Button onClick={analyser} disabled={occupe}>Analyser</Button>}> <Carte surtitre="Demande" titre="Le mail du client" action={<Button onClick={analyser} disabled={occupe}>Analyser</Button>}>
<Grid p="lg" gutter="lg"> <Grid p="lg" gutter="lg">
<Grid.Col span={{ base: 12, md: 8 }}> <Grid.Col span={{ base: 12, md: 8 }}>
<Select label="Depuis LibreDesk" placeholder="Choisir une conversation" searchable clearable mb="sm"
data={(fils || []).map(c => ({ value: c.uuid, label: `#${c.reference} · ${c.contact} · ${c.sujet} (${c.statut})` }))}
value={fil} onDropdownOpen={listerFils} onChange={choisirFil} nothingFoundMessage={fils ? "Aucune" : "Chargement…"} />
<Textarea label="Mail du client" description="Le texte ; colle les captures ici, elles s'ajoutent en vignettes" <Textarea label="Mail du client" description="Le texte ; colle les captures ici, elles s'ajoutent en vignettes"
placeholder="Bonjour, …" autosize minRows={6} maxRows={16} value={mail} placeholder="Bonjour, …" autosize minRows={6} maxRows={16} value={mail}
onChange={e => setMail(e.currentTarget.value)} onPaste={coller} /> onChange={e => setMail(e.currentTarget.value)} onPaste={coller} />