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_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
@@ -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
@@ -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
|
||||||
|
|||||||
@@ -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 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)
|
||||||
|
|||||||
@@ -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} />
|
||||||
|
|||||||
Reference in new issue
Block a user