feat: application Courrier V1a socle et tri du jour (tt-2026-11-059)

This commit is contained in:
gemini-ops committed 2026-11-17 12:14:55 +01:00
1 parent 0199477821
commit b51a8bba69
19 files changed
+1731 -2

No files matched your search

+27 -2
View File
@@ -1,3 +1,28 @@
# courrier
# Courrier - Socle et tri du jour par règles (V1a)
Application Courrier V1a - socle et tri du jour par règles
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.