feat: application Courrier V1a socle et tri du jour (tt-2026-11-059)
This commit is contained in:
1 parent
0199477821
commit
b51a8bba69
19 files changed
+1731
-2
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user