Variables d'environnement

Où se trouvent les paramètres

Créez chaque fichier à partir du .env.example placé à côté, qui documente chaque variable : cp .env.example .env. Les exemples fonctionnent tels quels pour une exécution locale.

Où se trouvent les paramètres

Un seul fichier, frontend/.env, lu au moment du build du site. Toutes ses valeurs sont publiques : il ne contient donc jamais de secret. Créez-le à partir de .env.example, qui documente chaque variable : cp .env.example .env.

Où se trouvent les paramètres

Un seul fichier, admin-dashboard/.env, lu au moment du build du tableau de bord. Toutes ses valeurs sont publiques : il ne contient donc jamais de secret. Omettez-le pour fonctionner sur le mock ; créez-le à partir de .env.example quand vous connectez une API : cp .env.example .env.

Où se trouvent les paramètres

Un seul fichier, back-end/.env, lu par l'API avec yarn dev et dans Docker. Il contient des secrets : ne le versionnez jamais. Créez-le à partir de .env.example, qui documente chaque variable et fonctionne tel quel pour une exécution locale : cp .env.example .env.

Paramètres essentiels de l'API

L'API les vérifie avant de démarrer. Si l'une d'elles manque ou est inutilisable, elle s'arrête avec une courte liste de ce qu'il faut corriger.

Générez votre propre JWT_SECRET avec :

node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"

Utiliser MySQL au lieu de SQLite

Créez une base de données vide, puis définissez le pilote et la connexion dans back-end/.env :

DB_TYPE=mysql
DB_HOST=your-mysql-host
DB_PORT=3306
DB_USERNAME=your-mysql-username
DB_PASSWORD=your-mysql-password
DB_DATABASE=your-database-name

Exécutez ensuite yarn seed pour les données de démonstration, ou yarn db:sync sur un site en production, qui crée les tables sans écrire aucune ligne. L'API en cours d'exécution ne met elle-même le schéma à jour que lorsque NODE_ENV=development.

Site étudiant et tableau de bord admin

Toutes les valeurs ici sont des NEXT_PUBLIC_*, compilées dans le JavaScript chargé par le navigateur. Ne mettez jamais de secret dans ces fichiers, et reconstruisez après avoir modifié une valeur.

Options de Docker Compose

Rien n'est à définir pour une exécution locale. Pour modifier quelque chose, placez-le dans un fichier .env à côté de docker-compose.yml et relancez docker compose up --build : les frontends intègrent ces valeurs à la compilation.

Le conteneur de l'API lit aussi back-end/.env s'il existe : les clés d'e-mail, de paiement, de médias et d'IA se définissent donc à un seul endroit, pour yarn dev comme pour Docker.

Stockage des médias

Les visuels de cours, avatars, images du blog, vidéos de leçons et documents sont envoyés vers un bucket Cloudflare R2, ou tout bucket compatible S3. Définissez les cinq variables dans back-end/.env et donnez aux deux frontends l'hôte public du bucket via NEXT_PUBLIC_MEDIA_HOSTNAME.

R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_ENDPOINT=
R2_BUCKET_NAME=
R2_PUBLIC_URL=

Sans bucket, le script de seed enregistre des chemins vers des fichiers d'exemple fournis par les deux frontends eux-mêmes : chaque image et chaque vidéo de leçon fonctionne donc en local. Seul l'envoi de nouveaux médias cesse de fonctionner.

E-mail

Les confirmations d'e-mail, les réinitialisations de mot de passe, les reçus et les confirmations d'inscription sont envoyés via Resend. Sans RESEND_API_KEY, l'application fonctionne quand même et écrit chaque message dans son journal.

RESEND_API_KEY=
MAIL_FROM=Learnio <noreply@example.com>
MAIL_MAX_PER_ADDRESS_PER_DAY=5
MAIL_MAX_PER_SENDER_PER_DAY=20

• Utilisez une clé limitée à l'envoi (sending access), pas une clé à accès complet.
• MAIL_FROM doit appartenir à un domaine que vous avez vérifié dans Resend, sinon chaque envoi est rejeté.
• Les deux limites plafonnent le nombre de messages qu'une adresse peut recevoir et qu'un expéditeur peut déclencher par jour.
• Le nom du produit dans chaque message et son adresse de réponse ne sont pas des variables : ce sont les paramètres site_name et support_email de l'onglet App Settings de Settings, dans le tableau de bord admin, lus pour chaque message envoyé.

Paiements

Par défaut, le paiement passe par un simulateur intégré : aucun prestataire n'est contacté et rien n'est débité. Un numéro de carte se terminant par 0 est refusé, pour que vous puissiez tester le cas d'échec.

Renseignez les clés d'un prestataire et ce moyen de paiement passe sur le vrai prestataire. Configurez Stripe et PayPal avant d'accepter de vraies commandes : le paiement propose toujours la carte et PayPal, et une commande payée via le simulateur est validée sans que personne ne soit débité.

Les cours gratuits (prix 0) n'ont besoin d'aucun processeur : leur paiement se termine sur l'API sans lui, quelles que soient les clés définies.

• Abonnez Stripe à checkout.session.completed, payment_intent.payment_failed et charge.refunded.
• Abonnez PayPal à PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.REFUNDED et PAYMENT.CAPTURE.REVERSED.
• PAYPAL_ENV vaut sandbox par défaut, ce qui n'encaisse aucun argent réel. Les identifiants de production appartiennent à une autre application PayPal : passer en production implique donc de nouvelles clés en plus de PAYPAL_ENV=live.

Assistant IA

Cours en direct

Données d'exemple dans les frontends

Les deux frontends continuent de fonctionner quand l'API est injoignable : ils servent des données d'exemple intégrées et affichent une mention « Sample data » en bas de la page. Dans un build de production, elle n'apparaît que si aucune API n'est configurée, sauf si l'app a été compilée avec NEXT_PUBLIC_SAMPLE_DATA_NOTICE=always, comme le fait le docker-compose.yml à la racine.

• Les données d'exemple du tableau de bord admin couvrent la connexion, les étudiants, le personnel, les rôles, les catégories, les paramètres, les notifications, la recherche et l'historique des conversations de l'assistant. Ses autres écrans (les chiffres de la vue d'ensemble, les cours, les formateurs, les inscriptions, les commandes, les avis, le blog, le planning, les quiz et les messages) ont besoin de l'API.
• Le formulaire de connexion du tableau de bord admin accepte n'importe quel e-mail et mot de passe sur les données d'exemple, et conserve vos modifications dans le navigateur. Pour repartir de zéro, exécutez localStorage.removeItem("mock_db_v1"); location.reload(); dans la console du navigateur.
• L'assistant IA n'est pas disponible sur les données d'exemple, car il a besoin des clés de l'API.
• Une fois votre API en ligne, yarn remove:mock dans l'une ou l'autre application supprime la couche de données d'exemple.

Fonctionnement de la couche de données d'exemple

Mode démo