Claude b8b08843d4 fix: audit du 21/11/2026 (file d'analyse, délais, miroir, authentification, vue Aujourd'hui)
Réponse illisible du modèle jamais enregistrée comme fiche ; mail en échec mis de côté au lieu de bloquer la file ;
lot borné à 55 s (limite Cloudflare) et enchaîné par l'interface ; délais d'appel adaptés (75/90 s) ;
erreur JSON-RPC du miroir distincte d'une liste vide ; cache du miroir borné ; clés Cloudflare Access en cache ;
vue Aujourd'hui sans les demandes déjà traitées. 192 tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XGaEeTZLvHXfYPUNWkgYoi
2026-11-21 08:54:25 +01:00

Courrier - Socle et tri du jour par règles (V1a)

Application interne de gestion du courrier électronique de Nabil, alimentée par la copie locale et immuable du miroir O365 (o365-mirror-mcp).

Architecture & Périmètre

  • Hébergement : VPS, conteneur Docker courrier plafonné à 256 Mo de RAM.
  • Image de base : python:3.12-slim (identique au miroir).
  • Réseau : Interne au VPS, port exposé uniquement sur 127.0.0.1:3120.
  • Source de données : o365-mirror-mcp (lecture seule stricte via Tailscale 100.86.197.88:3125), authentification par jeton Bearer dédié.
  • Base de données : SQLite locale persistante dans /app/data/courrier.db (mode WAL).
  • Sécurité : Authentification des requêtes entrantes via l'en-tête Cloudflare Access Cf-Access-Jwt-Assertion.

Règles de gouvernance

  1. Lecture seule vers le miroir : Aucune écriture vers O365 ni vers le miroir.
  2. Priorité absolue au manuel : Un classement manuel posé par Nabil n'est JAMAIS écrasé par une règle automatique.
  3. Apprentissage supervisé : Une correction manuelle génère une règle proposée (statut = 'proposee'), qui ne s'applique qu'après confirmation explicite.
  4. Cadence : Respect strict de la limite de 60 requêtes/minute vers le miroir avec cache local.
  5. Fuseau horaire : Horodatage systématique en heure de Tunis (Africa/Tunis, offset strict +01:00).

Endpoints de l'API

  • GET /health : Contrôle de santé public (sans authentification).
  • GET /api/v1/mails?date=AAAA-MM-JJ : Liste et classe les emails du jour.
  • GET /api/v1/classements : Liste des classements en base.
  • POST /api/v1/classements/{message_id} : Classement manuel (génère une proposition de règle).
  • PATCH /api/v1/classements/{message_id}/traite : Bascule de l'indicateur « traité ».
  • GET/POST/PUT/DELETE /api/v1/categories : CRUD des catégories.
  • GET/POST/PUT/DELETE /api/v1/regles : CRUD des règles de tri.
  • POST /api/v1/regles/{id}/confirmer : Confirmation d'une règle proposée et application aux mails automatiques.

À suivre (marqueur manuel, sans limite de date)

Un mail marqué à la main reste dans l’onglet « À suivre » quelle que soit sa date, groupé par catégorie (couleur propre à chaque catégorie, mails les plus récents en premier). Le marqueur est enregistré dans la base locale de Courrier : O365 et le miroir ne sont jamais modifiés. Chaque entrée garde une copie de l’expéditeur, de l’objet, de la date et de la catégorie, pour rester affichable si le miroir déplace ou purge le mail. Un mail retiré passe en « terminé » (rien n’est supprimé) et peut être remis.

  • GET /api/v1/a-suivre?statut=actif|termine|tous : liste et compteurs.
  • POST /api/v1/a-suivre/marquer : pose le marqueur (un mail déjà actif garde sa date de marquage).
  • POST /api/v1/a-suivre/retirer : retire un ou plusieurs mails (corps : {"ids": [...]}), utilisé aussi pour « Tout retirer » d’une catégorie.
  • POST /api/v1/a-suivre/remettre : remet des mails au suivi (annulation ou retour depuis les terminés).
  • Couleurs : chaque catégorie porte sa couleur (categories.couleur, 0 à 12), attribuée à la création et conservée au renommage.
  • POST /api/v1/a-suivre/supprimer : efface définitivement de l’historique des mails déjà terminés (les mails actifs sont ignorés ; O365 n’est jamais modifié).
S
Description
Application Courrier V1a - socle et tri du jour par règles
Readme
1.1 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 63.2%
JavaScript 26.5%
CSS 9.7%
HTML 0.4%
Dockerfile 0.2%