diff --git a/Configuration.md b/Configuration.md
new file mode 100644
index 0000000..c545291
--- /dev/null
+++ b/Configuration.md
@@ -0,0 +1,121 @@
+# Configuration
+
+Configuration via `pydantic-settings` depuis les variables d'environnement ou un fichier `.env`. Copiez `.env.example` vers `.env` pour démarrer. Les secrets utilisent `SecretStr` et sont masqués dans les logs.
+
+## Principe
+
+Les paramètres sont chargés automatiquement depuis les variables d'environnement ou un fichier `.env` à la racine du projet. Le fichier `.env` n'est **jamais** versionné (couvert par `.gitignore`).
+
+## Variables Pronote
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `PRONOTE_ICAL_URL` | URL du flux iCal Pronote (contient `icalsecurise`) | obligatoire si source `ical` | SecretStr |
+| `PRONOTE_URL` | URL de la page Pronote pour `pronotepy` | obligatoire si source `pronotepy` | str |
+| `PRONOTE_ACCOUNT_TYPE` | Type de compte Pronote | `parent` | str |
+| `PRONOTE_USERNAME` | Identifiant Pronote | obligatoire si source `pronotepy` | str |
+| `PRONOTE_PASSWORD` | Mot de passe Pronote | obligatoire si source `pronotepy` | SecretStr |
+| `PRONOTE_ENT` | Slug ENT (résolu vers `pronotepy.ent`) | optionnel | str |
+| `PRONOTE_AGENDA_SOURCE` | Source pour l'agenda | `auto` | Literal["auto", "ical", "pronotepy"] |
+| `PRONOTE_HOMEWORK_SOURCE` | Source pour les devoirs | `auto` | Literal["auto", "ical", "pronotepy"] |
+| `PRONOTE_MESSAGES_SOURCE` | Source pour les messages | `pronotepy` | Literal["pronotepy"] |
+
+> **Note** : `PRONOTE_URL` et `PRONOTE_ICAL_URL` sont deux contrats distincts. L'un ne doit **jamais** être déduit de l'autre.
+
+## Variables CalDAV
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `CALDAV_URL` | URL du serveur CalDAV | obligatoire | SecretStr |
+| `CALDAV_USERNAME` | Identifiant CalDAV | obligatoire | str |
+| `CALDAV_PASSWORD` | Mot de passe CalDAV | obligatoire | SecretStr |
+| `CALDAV_CALENDAR_PATH` | Chemin du calendrier sur le serveur | `/pronote-sync/` | str |
+| `CALDAV_ALLOW_INSECURE_HTTP` | Autoriser HTTP non sécurisé (localhost uniquement) | `false` | bool |
+
+## Fenêtre de synchronisation
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `SYNC_PAST_DAYS` | Nombre de jours dans le passé à synchroniser | `7` | int |
+| `SYNC_FUTURE_DAYS` | Nombre de jours dans le futur à synchroniser | `30` | int |
+
+## Agenda théorique
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `THEORETICAL_AGENDA_PATH` | Chemin vers le fichier JSON de l'agenda théorique | `None` | str \| None |
+| `SCHOOL_HOLIDAYS_PATH` | Chemin vers le fichier JSON des vacances scolaires | `None` | str \| None |
+| `THEORETICAL_WEEK_ANCHOR_DATE` | Date de référence pour la parité des semaines | `None` | date \| None |
+| `THEORETICAL_WEEK_ANCHOR_TYPE` | Parité de la semaine de référence | `None` | Literal["even", "odd"] \| None |
+
+## Variables XMPP
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `XMPP_ENABLED` | Activer la notification XMPP | `false` | bool |
+| `XMPP_JID` | Identifiant XMPP (ex: `user@example.com`) | obligatoire si activé | str |
+| `XMPP_PASSWORD` | Mot de passe XMPP | obligatoire si activé | SecretStr |
+| `XMPP_HOST` | Hôte XMPP | `""` | str |
+| `XMPP_PORT` | Port XMPP | `5222` | int |
+| `XMPP_TO` | Destinataire XMPP | obligatoire si activé | str |
+| `XMPP_RESOURCE` | Ressource XMPP | `pronote-sync` | str |
+| `XMPP_USE_TLS` | Utiliser TLS pour la connexion | `true` | bool |
+| `XMPP_TIMEOUT` | Délai d'attente en secondes | `30` | int |
+
+## Variables IA
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `AI_ENABLED` | Activer la synthèse IA | `false` | bool |
+| `AI_PROVIDER` | Fournisseur IA | `openai` | Literal["openai", "litellm", "openai-compatible"] |
+| `AI_BASE_URL` | URL de base de l'API IA | `None` | str \| None |
+| `AI_API_KEY` | Clé API IA | `None` | SecretStr |
+| `AI_MODEL` | Modèle IA | `None` | str \| None |
+| `AI_ALLOW_INSECURE_HTTP` | Autoriser HTTP non sécurisé pour `openai-compatible` | `false` | bool |
+
+> **Note** : Le fournisseur `openai-compatible` réutilise `OpenAISynthesisProvider` avec un `base_url` personnalisé. `AI_BASE_URL` et `AI_MODEL` sont requis pour ce fournisseur. L'URL doit utiliser `https` sauf si `AI_ALLOW_INSECURE_HTTP=true`. Les identifiants dans l'URL sont rejetés. Les paramètres sensibles dans la *query string* sont rejetés. Aucune manipulation automatique de `/v1` n'est effectuée. En cas de configuration invalide, la factory retourne `None` avec un avertissement (mode dégradé).
+
+Exemples de configuration pour `openai-compatible` :
+
+```bash
+# OpenRouter (HTTPS)
+AI_PROVIDER=openai-compatible
+AI_BASE_URL=https://openrouter.ai/api/v1
+AI_MODEL=fournisseur/modele
+AI_API_KEY=your-openrouter-key
+AI_ALLOW_INSECURE_HTTP=false
+
+# Ollama local (HTTP)
+AI_PROVIDER=openai-compatible
+AI_BASE_URL=http://127.0.0.1:11434/v1
+AI_MODEL=modele-local
+AI_API_KEY=local-not-required
+AI_ALLOW_INSECURE_HTTP=true
+```
+
+## Variables Blog
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `BLOG_ENABLED` | Activer la synchronisation du blog | `false` | bool |
+| `BLOG_RSS_URL` | URL du flux RSS du blog | (ex: `https://blogpeda.ac-bordeaux.fr/cjeliote/?feed=rss2`) | str |
+
+## Divers
+
+| Variable | Description | Valeur par défaut | Type |
+|----------|-------------|--------------------|------|
+| `DRY_RUN` | Mode simulation (pas d'écriture) | `false` | bool |
+| `LOG_LEVEL` | Niveau de log | `INFO` | str |
+
+## Fichier .env
+
+Pour créer votre fichier de configuration :
+
+```bash
+cp .env.example .env
+# Éditer .env avec vos paramètres
+```
+
+> **Rappel** : Le fichier `.env` n'est **jamais** versionné. Utilisez `.env.example` comme modèle.
+
+Voir aussi : [Sécurité](Sécurité) pour la gestion des secrets, [Déploiement](Déploiement) pour la configuration en production.
\ No newline at end of file