# 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.