Files
courrier/README.md
T

2.0 KiB

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.