API: support page with two Claude API clients, support and analyst (D-133)

Self-contained sub-project API/: a local support page where Marc pastes a
client's mail; a support agent and an analyst agent stay alive for the session
and produce a slide PDF that answers the client's question. Tools, detectors,
knowledge and Typst brand are copied (API/PROVENANCE.md). First real case:
Crissier (LENZSPITZE), workflow validated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-05 12:58:39 +01:00
1 parent 874f6bf7ea
commit 8ba75b92fa
130 files changed
+42094

No files matched your search

+134
View File
@@ -0,0 +1,134 @@
"""La page support : API/.venv/bin/python API/support/serveur.py → http://127.0.0.1:8770
Une séance à la fois, en mémoire ; la page interroge /evenements chaque seconde.
"""
import base64
import json
import platform
import subprocess
import sys
import threading
import webbrowser
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from pathlib import Path
from urllib.parse import parse_qs, urlparse
sys.path.insert(0, str(Path(__file__).resolve().parent))
from seance import Seance, donnees_par_defaut # noqa: E402
PORT = 8770
HOTES = {f"127.0.0.1:{PORT}", f"localhost:{PORT}"} # contre le DNS rebinding : un autre site ne lit ni mails ni PDF
PAGE = Path(__file__).resolve().parent / "page.html"
verrou = threading.Lock()
etat = {"seance": None, "evenements": []}
def journal(e: dict) -> None:
with verrou:
etat["evenements"].append(e)
def en_fond(f, *args):
def lancer():
try:
f(*args)
except Exception as e: # noqa: BLE001 — une erreur de la séance s'affiche dans la page, le serveur continue
journal({"agent": "support", "type": "erreur", "texte": f"{type(e).__name__}: {e}"})
threading.Thread(target=lancer, daemon=True).start()
class Serveur(BaseHTTPRequestHandler):
def log_message(self, *_):
pass
def _envoyer(self, code: int, corps: bytes, type_: str = "application/json", plus: dict | None = None):
self.send_response(code)
self.send_header("Content-Type", type_)
self.send_header("Content-Length", str(len(corps)))
for k, v in (plus or {}).items():
self.send_header(k, v)
self.end_headers()
self.wfile.write(corps)
def _json(self, code: int, obj) -> None:
self._envoyer(code, json.dumps(obj, ensure_ascii=False).encode())
def _refuse(self, post: bool = False) -> bool:
"""Seule la page elle-même parle au serveur : bon Host ; en POST, un JSON déclaré (une page d'un autre site ne
peut l'envoyer sans requête préalable, à laquelle le serveur ne répond pas)."""
if self.headers.get("Host") not in HOTES or (
post and not self.headers.get("Content-Type", "").startswith("application/json")):
self._json(403, {"erreur": "requête refusée"})
return True
return False
def do_GET(self):
if self._refuse():
return
url = urlparse(self.path)
s = etat["seance"]
if url.path == "/":
return self._envoyer(200, PAGE.read_bytes(), "text/html; charset=utf-8")
if url.path == "/evenements":
depuis = int(parse_qs(url.query).get("depuis", ["0"])[0])
with verrou:
evs = etat["evenements"][depuis:]
n = len(etat["evenements"])
v = s.derniere_version() if s else None
return self._json(200, {"evenements": evs, "n": n, "cout": s.cout() if s else None,
"version": v.name if v else None, "dossier": s.dossier.name if s else None,
"id": s.id if s else None,
"occupe": {a: bool(s and s.occupe(a)) for a in ("support", "analyste")}})
if url.path == "/pdf":
v = s.derniere_version() if s else None
if not v:
return self._json(404, {"erreur": "pas encore de PDF"})
nom = f"{s.dossier.name}_{v.name}"
return self._envoyer(200, v.read_bytes(), "application/pdf",
{"Content-Disposition": f'inline; filename="{nom}"'})
self._json(404, {"erreur": url.path})
def do_POST(self):
if self._refuse(post=True):
return
corps = json.loads(self.rfile.read(int(self.headers.get("Content-Length", 0))) or b"{}")
s = etat["seance"]
if self.path == "/analyser":
if s and (s.occupe("support") or s.occupe("analyste")):
return self._json(409, {"erreur": "une séance travaille encore"})
if not corps.get("mail", "").strip():
return self._json(400, {"erreur": "le mail est vide"})
images = [(i["type"], base64.b64decode(i["base64"])) for i in corps.get("images", [])]
with verrou:
etat["evenements"] = []
etat["seance"] = s = Seance(corps["mail"], images, corps.get("contexte", ""), donnees_par_defaut(),
journal)
en_fond(s.demarrer)
return self._json(200, {"dossier": s.dossier.name})
if self.path == "/message":
agent, texte = corps.get("agent"), corps.get("texte", "").strip()
if not s:
return self._json(400, {"erreur": "pas de séance : coller un mail et Analyser"})
if agent not in ("support", "analyste") or not texte:
return self._json(400, {"erreur": "agent ou texte manquant"})
if s.occupe(agent):
return self._json(409, {"erreur": f"{agent} occupé"})
en_fond(s.parler, agent, texte)
return self._json(200, {})
self._json(404, {"erreur": self.path})
def ouvrir(url: str) -> None:
if "microsoft" in platform.uname().release.lower(): # WSL : le navigateur Windows
subprocess.Popen(["explorer.exe", url], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
else:
webbrowser.open(url)
if __name__ == "__main__":
url = f"http://127.0.0.1:{PORT}"
serveur = ThreadingHTTPServer(("127.0.0.1", PORT), Serveur)
print(f"Page support : {url}")
if "--sans-navigateur" not in sys.argv:
ouvrir(url)
serveur.serve_forever()