Configuration

Les réglages sont lus depuis les variables d’environnement, ou depuis un fichier .env à la racine (modèle : .env.example).

Modules de réglages

Module	Usage
config.settings.dev	Développement (par défaut pour manage.py), DEBUG=True
config.settings.test	Tests (SQLite en mémoire)
config.settings.prod	Production (par défaut pour WSGI/ASGI), sécurité HTTPS activée

Choisir avec DJANGO_SETTINGS_MODULE.

Variables

Variable	Défaut	Description
SECRET_KEY	clé de dev	Obligatoire en production. Chaîne aléatoire longue
DEBUG	False	Forcé à True en dev, False en prod
ALLOWED_HOSTS	localhost,127.0.0.1	Domaines autorisés, séparés par des virgules
CSRF_TRUSTED_ORIGINS	vide	Origines HTTPS, ex. https://mfoundimall.cm
DATABASE_URL	SQLite local	Ex. postgres://user:pass@db:5432/mfoundi
DB_CONN_MAX_AGE	60	Durée de vie des connexions (secondes)
MEDIA_ROOT	./media	Dossier des fichiers envoyés (logos, photos)
EMAIL_BACKEND	console	django.core.mail.backends.smtp.EmailBackend en prod
EMAIL_HOST, EMAIL_PORT, EMAIL_HOST_USER, EMAIL_HOST_PASSWORD, EMAIL_USE_TLS		Serveur SMTP
DEFAULT_FROM_EMAIL	Mfoundi Mall <no-reply@mfoundimall.cm>	Expéditeur
ADMINS	vide	Nom:email,Nom2:email2. Reçoivent les erreurs et les nouvelles boutiques à valider
SITE_NAME	Mfoundi Mall	Nom affiché
SITE_PHONE, SITE_EMAIL, MALL_ADDRESS		Coordonnées du mall (pied de page)
SECURE_SSL_REDIRECT	True	Redirection HTTP vers HTTPS (prod)
SECURE_HSTS_SECONDS	0	Activer (ex. 31536000) une fois HTTPS stable
LOG_LEVEL	INFO	Niveau de journalisation
LOG_FORMAT	text (dev), json (prod)	Format des logs
APP_VERSION	dev	Version affichée par /healthz
CACHE_URL	mémoire locale	Ex. redis://redis:6379/1 (recommandé en production)
REALTIME_POLL_SECONDS	3	Fréquence de vérification du flux temps réel
REALTIME_STREAM_SECONDS	300	Durée d’une connexion avant reconnexion automatique
API_ANON_RATE, API_AUTH_RATE	120/m, 600/m	Limites de débit de l’API (anonyme, avec jeton)
ANTHROPIC_API_KEY	vide	Clé de l’API Claude. Vide = assistant IA désactivé
AI_ENABLED	True	Coupe l’assistant même si une clé est présente
AI_MODEL	claude-opus-5-5	Modèle Claude utilisé
AI_TIMEOUT_SECONDS, AI_MAX_RETRIES	30, 2	Délai maximal et nouvelles tentatives des appels à Claude
AI_DESCRIPTIONS_PER_HOUR	30	Quota de descriptions générées par commerçant et par heure
LOGIN_MAX_ATTEMPTS	5	Essais (mot de passe ou code) avant blocage, par compte
LOGIN_MAX_ATTEMPTS_PER_IP	100	Essais avant blocage par adresse IP. Élevé car les opérateurs mobiles partagent une même IP entre de nombreux abonnés
TRUSTED_PROXY_COUNT	0 (dev), 1 (prod)	Proxys devant Django qui ajoutent X-Forwarded-For : 1 pour le Nginx du conteneur, 2 avec un proxy HTTPS sur l’hôte
LOGIN_LOCKOUT_SECONDS	900	Durée du blocage après trop d’essais
MFA_REQUIRED_FOR_STAFF	True	Exige une application d’authentification ou une clé d’accès pour ouvrir /admin/
MFA_TRUSTED_DAYS	30	Durée de l’option « Faire confiance à cet appareil »
MFA_ENCRYPTION_KEY	dérivée de SECRET_KEY	Chiffre les secrets des applications d’authentification. À fixer en production pour pouvoir changer SECRET_KEY sans désactiver ces applications
WEBAUTHN_RP_ID	domaine de la requête	Domaine des clés d’accès, ex. mfoundimall.cm. Ne plus le changer une fois des clés enregistrées

Générer une clé secrète :

python -c "import secrets; print(secrets.token_urlsafe(50))"

E-mails envoyés

Événement	Destinataire
Nouvelle boutique créée	ADMINS
Boutique validée ou suspendue	e-mail de la boutique, sinon du propriétaire
Nouvelle commande	e-mail de la boutique (si renseigné)
Mot de passe oublié	e-mail du compte
Code de connexion (double authentification par e-mail)	e-mail du compte
Connexion depuis un nouvel appareil	e-mail du compte (et notification sur le site)

Un échec d’envoi n’empêche jamais une commande d’être enregistrée.