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
639 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 60.8%
JavaScript 26.8%
CSS 11.8%
HTML 0.3%
Dockerfile 0.3%