Grand Oral Studio

Prépare un grand oral, avec ou sans sujets imposés. Avant le jour J, on choisit l'apparence des diapos et on écrit leur contenu type, sans IA. Le jour J, on saisit la problématique tirée au sort : l'app reconnaît le sujet et rédige le diaporama complet avec notes d'orateur. Export .pptx, import dans Canva ou consignes prêtes à coller dans l'IA de Canva. Entre les deux, on s'entraîne : diaporamas d'entraînement, répétition chronométrée, questions probables du jury.

L'app est générique : apparence, trame et sujets sont des données propres à chaque projet. L'IA n'intervient qu'au jour J.

En ligne : https://grand-oral-studio.vercel.app. Pour participer : CONTRIBUTING.md.

Parcours

1. Apparence : couleurs, polices, logo PNG/JPEG, aperçu fidèle au .pptx. À la main, depuis vos consignes (texte collé) ou depuis un .pptx/.potx/.thmx d'exemple (4 Mo au plus).
2. Trame : format, langue, durée de l'oral, temps de préparation (chrono du jour J, 90 min par défaut), puis une ligne par groupe de diapos (titre, nombre de diapos, contenu type, durée facultative). À la main ou depuis vos consignes en Markdown (tableau Diapo | Titre | Contenu | Durée, plages « 2-3 »), lues sans IA. Sujets (facultatif, onglet de la Trame) : nom, description, mots-clés, notes (chiffres, exemples, sources) et problématiques possibles. Saisie ou import en masse (Nom | description | mot1, mot2 | notes). Fiche de révision imprimable par sujet.
3. Jour J : problématique → sujet reconnu (aucun sujet : étape sautée ; un seul : présélectionné ; option « Sans sujet ») → diaporama complet rédigé à partir de la trame et des notes du sujet, dans le temps imparti (AI_GENERATION_DEADLINE_MS). En cas d'échec : « Réessayer », « Générer avec » ou « Générer sans IA maintenant », sans bascule automatique. Le chrono de préparation démarre au collage de la problématique et survit au rechargement. Mode entraînement (?mode=entrainement) : tirage d'une problématique, diaporama marqué « entraînement » ; liste « Avant l'examen ». Le projet n'est « prêt » qu'avec deux diaporamas et deux répétitions.
4. Diaporamas : relecture, édition des diapos (régénérer une diapo par l'IA, insérer, déplacer, supprimer), duplication, suppression annulable quelques secondes, .pptx, import dans Canva. Répétition plein écran chronométrée, questions probables du jury, notes d'orateur imprimables. Les squelettes produits par la v1.0 y restent consultables.

Partage : le propriétaire invite des collègues (comptes existants) en éditeur ou en lecteur ; un lecteur relit, exporte, répète et imprime, sans rien modifier (Jour J compris). Bibliothèque d'équipe : une apparence ou une trame publiée s'applique à n'importe quel projet de l'instance. Transfert : export et import d'un projet en JSON (sans identifiant ni secret), projet d'exemple, export des données du compte depuis le Profil.

Notes de version : page /notes-de-version (publique), générée avec CHANGELOG.md depuis src/domain/releases.ts.

Démarrer en local

Prérequis : Node 20+, PostgreSQL 15+.

npm install
npm run setup                 # .env complété (secrets générés), bases dev/test créées, migrations appliquées
npm run dev

npm run setup ne remplace jamais une valeur déjà présente dans .env : on peut le relancer sans risque. Les variables facultatives (Google, e-mails Resend, domaines autorisés, clés d'équipe Mistral/Gemini, Ollama, échéance de génération) sont documentées dans .env.example.

Sans aucune clé, la rédaction Sans IA produit des diaporamas à compléter : le parcours complet fonctionne. AI_PROVIDER=mock (dev/tests) fait de la carte Démo (contenus factices, sans clé) le choix par défaut, servi par un mock déterministe. Voir « Rédaction ».

Rédaction

Chaque utilisateur choisit dans la Rédaction IA (/configuration-ia) qui rédige le jour J :

Rédaction	Coût	Qualité	Prérequis
Sans IA	aucun, instantané, sans réseau	diaporama à compléter, construit avec la trame et les notes du sujet	aucun
Mistral	offre gratuite possible ; hébergé dans l'UE	contenu rédigé	sa clé, ou la clé de l'équipe (MISTRAL_API_KEY)
Gemini	offre gratuite possible	contenu rédigé	sa clé, ou la clé de l'équipe (GEMINI_API_KEY)
Ollama	calcul local	dépend du modèle ; lent	Ollama sur le serveur

Chaque carte détaille l'hébergement, l'usage des données pour l'entraînement et la conservation. Une clé de l'équipe n'est proposée que si la variable correspondante est renseignée sur le serveur ; elle est facturée au compte de l'équipe et soumise aux quotas AI_QUOTA_PER_HOUR et AI_GLOBAL_HOURLY_LIMIT.

Claude et OpenAI ne sont plus proposés depuis la 1.2 : aucune nouvelle connexion ni sélection n'est acceptée. Une connexion existante reste listée dans « Mes connexions », avec « Supprimer » seulement ; un utilisateur qui avait explicitement choisi Claude ou OpenAI le garde (avec sa clé, ou ANTHROPIC_API_KEY / OPENAI_API_KEY) jusqu'à ce qu'il choisisse un autre rédacteur.

Sans préférence enregistrée : la démo si AI_PROVIDER=mock, sinon la clé de l'équipe Mistral, sinon celle de Gemini, sinon Sans IA, y compris en production (jamais une clé personnelle implicitement). Supprimer une connexion alors qu'elle rédige ramène la rédaction au choix par défaut ; un autre rédacteur choisi est conservé. Si le rédacteur choisi n'est plus disponible (clé refusée, crédit épuisé, limite du fournisseur, Ollama arrêté…), la génération échoue avec un message qui renvoie vers la Rédaction IA et propose le repli en un clic : aucune bascule silencieuse. Exception le jour J : la reconnaissance du sujet se replie toujours sur la version sans IA si l'IA échoue, et l'indique.

This is the beginning of the README. Read the rest at the original. Read the full README ↗