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:
1 parent
67a1d71c57
commit
b475da0acc
6 files changed
+148
-4
No files matched your search
@@ -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
|
||||
|
||||
+2
-1
@@ -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/<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/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).
|
||||
|
||||
+29
-1
@@ -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 <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__":
|
||||
nom = sys.argv[1] if len(sys.argv) > 1 else None
|
||||
|
||||
@@ -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}
|
||||
@@ -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)
|
||||
|
||||
@@ -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 }) {
|
||||
<Carte surtitre="Demande" titre="Le mail du client" action={<Button onClick={analyser} disabled={occupe}>Analyser</Button>}>
|
||||
<Grid p="lg" gutter="lg">
|
||||
<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"
|
||||
placeholder="Bonjour, …" autosize minRows={6} maxRows={16} value={mail}
|
||||
onChange={e => setMail(e.currentTarget.value)} onPaste={coller} />
|
||||
|
||||
Reference in new issue
Block a user