micro-api/architecture.md

Architecture — MicroAPI

Stack

Couche	Technologie	Justification
Framework	FastAPI	Performant, async, documentation auto (Swagger)
Serveur	Uvicorn	ASGI, production-ready
Runtime	Python 3.11+	Écosystème riche, gratuit
Base de données	SQLite (phase 1)	Zéro ops, migration vers PostgreSQL si besoin
Conteneurisation	Docker	Isolation, déploiement reproductible
Reverse proxy	Caddy (existant)	Routing, HTTPS
Paiements	Lemon Squeezy	MoR, 0€/mois, gère TVA
Emails	Resend (gratuit 3K/mois)	Transactionnel
Monitoring	Uptime Kuma (existant)	Health checks

Structure des dossiers

micro-api/
├── main.py              # Application FastAPI
├── requirements.txt     # Dépendances Python
├── Dockerfile           # Image Docker
├── docker-compose.yml   # Stack de déploiement
├── README.md            # Documentation utilisateur
├── ARCHITECTURE.md      # Ce document
├── tests/               # Tests unitaires & intégration
│   └── test_health.py
├── app/                 # Code applicatif (à venir)
│   ├── routers/         # Endpoints API
│   ├── services/        # Logique métier (transcription, etc.)
│   ├── models/          # Modèles de données
│   └── utils/           # Utilitaires
└── data/                # Données persistantes (volumes)

Principes

1. Stateless — Chaque requête est indépendante, pas de session serveur
2. Async-first — Tous les endpoints sont async par défaut
3. API-first — Documentation Swagger automatique sur /docs
4. 12-factor — Configuration par variables d'environnement
5. Zéro coût opérationnel — Whisper local, pas d'API externe payante

Roadmap technique

1. ✅ Scaffold (health check, structure)
2. ⬜ Endpoint /api/transcribe (Whisper local, upload fichier)
3. ⬜ Endpoint /api/summarize (Résumé de texte)
4. ⬜ Endpoint /api/convert (Markdown→PDF, JSON→CSV)
5. ⬜ Authentification API keys
6. ⬜ Rate limiting + quotas
7. ⬜ Intégration Lemon Squeezy (paiements)
8. ⬜ Dashboard utilisateur