Tu lis une phrase. Elle isole le son exact qui cloche â pas un score vague â et te le fait retravailler jusqu'Ă ce qu'il passe.
Toutes les apps de langue te donnent un score. Un score ne te dit pas quoi corriger. Accent refuse le score : elle travaille un seul son Ă la fois, jusqu'Ă ce qu'il passe.
- Le score global dit : « 78 % » â l'Ă©lĂšve ferme l'app.
- Accent dit : « ton /Ξ/ sort comme un /s/. Un seul mot Ă refaire. » â l'Ă©lĂšve rĂ©essaie.
Projet soumis Ă IceHacks 2026 (CodeStarters, Devpost).
| Ătape | EntrĂ©e | Sortie | OĂč ça vit |
|---|---|---|---|
| 1. Ăcoute | micro (MediaRecorder) | PCM mono 16 kHz + contrĂŽle qualitĂ© | src/audio/ |
| 2. Ăvalue | audio + texte attendu | score 0-100 par phonĂšme | src/providers/ |
| 3. Sélectionne | liste de scores | un phonÚme cible (pondéré) | src/engine/selectTarget.ts |
| 4. Explique | phonÚme cible | paire minimale + signature d'erreur | src/data/phonemes.ts (donnée, zéro appel modÚle) |
| 5. Entraßne | phonÚme cible | 3 phrases contenant ce son | src/data/training.json (cache commité, hors ligne) |
Budget : moins de 10 s de la fin de lecture au diagnostic (BUDGET_PIPELINE_MS,
src/constants.ts). Orchestration : executerPipeline() dans src/engine/pipeline.ts.
Accueil âââ¶ Enregistrement âââ¶ Analyse âââ¶ Diagnostic âââ¶ Comparaison
(saisie ou (3 lectures, (5 étapes (UN phonÚme, (avant/aprÚs
10 phrases niveau + aperçu) nommĂ©es) paire min.) sur le mĂȘme son)
prĂȘtes) â
âŒ
Entrainement
(3 phrases, cache)
Machine à états : src/App.tsx (8 vues, aucune route, aucun compte).
[Navigateur] [Edge] [API tierce]
MediaRecorder â PCM 16 kHz
Webapp statique (Vite+React)
â
â POST /api/analyse Proxy (clĂ© cachĂ©e, ââ clĂ© âââ¶ Azure Speech
ââ {texte, langueCible, audioBase64} â quota, cache) Pronunciation
â â {scores[], provider, quota} Assessment
â
ââ BYOK : si le quota est Ă©puisĂ©, la clĂ© personnelle de l'utilisateur
â parle directement au fournisseur (jamais Ă notre proxy).
â
ââ localStorage : profil de sons + sessions (jamais l'audio, RNF-P1)
- Contrat client du proxy :
src/providers/proxy.ts(POST /api/analyse,GET /api/phrases). Le worker edge est commité (worker/) et se déploie sur Cloudflare Workers (worker/README.md). - Choix du fournisseur et repli :
src/providers/index.ts(fournisseurSelonReglages: BYOK Azure â proxy â dĂ©mo locale ;repliSurDemosur erreur proxy, branchĂ© danssrc/App.tsx). - URL du proxy par dĂ©faut :
VITE_PROXY_URLinjectĂ©e au build, sinonhttps://accent-proxy.duello.workers.dev(worker dĂ©ployĂ©, clĂ© en secret serveur â voirsrc/store/settings.ts).
- Jamais de score global. Un son, à un instant donné. Garanti par un garde CI :
ci.ymléchoue siscoreGlobal|globalScore|noteGlobale|overallScoreapparaßt danssrc/. - Aucun classement, aucune comparaison entre utilisateurs. La progression ne se mesure
que contre soi (
src/screens/Profil.tsx). - L'objectif est d'ĂȘtre comprĂ©hensible, pas de paraĂźtre natif.
Et techniquement : aucun compte, aucune base de données, aucun audio conservé (RNF-P1).
Le profil vit dans ton navigateur, exportable et supprimable en un clic
(toutEffacer() / exporterMarkdown(), src/store/profile.ts).
SystÚme visuel unique, posé en tokens CSS (src/index.css) et repris par Tailwind
(tailwind.config.js) :
| RĂšgle | Valeur |
|---|---|
| Fond / carte / bord | #0b0f14 · #141b23 · #22303c |
| Ambre = son Ă travailler | #f2a33c (jamais de note globale) |
| Vert = acquis, action principale | #4ec98a |
| Rouge = erreurs systÚme uniquement (micro bloqué, échec réseau) | #e5484d |
| Typo | sans = Inter/system-ui · mono = JetBrains Mono/ui-monospace (phonÚmes, chiffres) |
| Un seul chiffre par écran | le score du son ciblé /100 ; les autres nombres passent en mots ou en aria-label |
| Mouvement | underwriting du titre, phonĂšme hĂ©ros, count-up â tout coupĂ© par prefers-reduced-motion |
L'écran est vérifié à 1440 px et 375 px (aucun défilement horizontal, cibles ℠48 px,
texte â„ 16 px, contraste AA) ; les captures sont dans docs/captures/
(Accueil et Diagnostic, 1440 px et 375 px), produites par tools/capture-locale.mjs.
npm install
npm run dev # http://localhost:5173
npm test # vitest â 386 tests (moteur, pipeline, Ă©crans, garde-fous)
npm run build # tsc --noEmit + vite build
npm run size # garde RNF-07 : bundle < 300 Ko gzip (actuellement ~83 Ko)En dev (hors build de production), sans proxy configuré, l'app démarre sur le
moteur de démonstration local (src/providers/demo.ts) : elle est entiÚrement
cliquable, et chaque mesure simulĂ©e est signalĂ©e « simulation » Ă l'Ă©cran â jamais
de bluff. Le badge est visible sur l'Accueil
(« Simulation locale · pas de clé de mesure ») et sur le Diagnostic
(« Simulation â mode dĂ©monstration : mesure simulĂ©e, pas une Ă©valuation rĂ©elle »).
Le build de production, lui, pointe par défaut sur le worker edge (voir
« Démo publique »).
https://tradoooo.github.io/accent/ â GitHub Pages, HTTPS, accessible Ă tous, sans compte. Le micro y fonctionne (contexte sĂ©curisĂ©). La mesure publique passe par le proxy edge Cloudflare : la clĂ© Azure Speech reste dans le secret du worker, jamais dans le navigateur, et le quota est bornĂ© par IP et par jour. Si le quota est dĂ©passĂ© ou si le proxy est injoignable, l'app replie sur son moteur local de dĂ©monstration, et l'Ă©cran affiche le badge « simulation » â le chiffre affichĂ© n'est alors pas une Ă©valuation rĂ©elle. Le mode BYOK reste disponible dans RĂ©glages : la clĂ© personnelle part alors directement chez Microsoft, jamais chez notre proxy.
| Cible | Usage | Commande |
|---|---|---|
| GitHub Pages | URL publique stable, 0 $, aucun compte | bash tools/deploy/publish-pages.sh |
| r630 + tunnel | démo avec proxy /api (clé Azure cÎté serveur) |
bash tools/deploy/deploy-r630.sh |
| Cloudflare Pages + Worker | production : edge, cache, quota | worker/README.md |
npm run build # gĂ©nĂšre dist/ (base './' : racine de domaine ou sous-chemin)Le build utilise base: './' : le mĂȘme dist/ se publie Ă la racine d'un domaine
ou sous un sous-chemin (/accent/ sur Pages). Le micro exige HTTPS (ou localhost).
Fait et vérifié (npx tsc --noEmit + npx vitest run : 386/386, bundle 82,8 Ko gzip) :
- Pipeline 5 étapes (
src/engine/) et deux taxonomies fermĂ©es danssrc/data/phonemes.ts: 15 phonĂšmes FRâEN (P01..P15) et 9 ESâFR (E01..E09), chacune avec signature d'erreur, paires minimales, conseil, difficultĂ©. - 72 phrases d'entraĂźnement en cache (45 anglaises + 27 françaises), commitĂ©es :
l'étape 5 ne dépend jamais du réseau (
src/data/training*.json). - FiabilitĂ© de la mesure : 3 lectures â mĂ©diane, Ă©cart > 20 pts â refus
d'afficher, audio < 1,5 s â « trop court », y compris sur le chemin
« réessayer » (
src/engine/measure.ts,src/engine/selectTarget.ts). - L'incertitude est affichée : l'étendue observée (min-max des lectures) et un
avertissement quand elle traverse un seuil de dĂ©cision â le score est une
estimation, on le dit (
src/components/FourchetteScore.tsx). - Sons récurrents (RF-22) : un phonÚme cible sur ℠3 phrases distinctes
remonte en tĂȘte du profil (
sonsRecurrents,src/store/profile.ts). - Audio modĂšle ralenti (RF-23) : deux moteurs au choix â la voix du
navigateur (
speechSynthesis, 0 $, hors ligne, rien ne sort de la machine) ou Eleven Labs en BYOK (voix multilingue bien plus naturelle ; la voix « Laure » est sĂ©lectionnĂ©e automatiquement si elle existe dans le compte). Vitesses 0,5Ă / 0,75Ă / 1Ă, zĂ©ro fichier audio commitĂ© (src/audio/tts.ts). Seul le texte part chez Eleven Labs ; l'audio de l'Ă©lĂšve, jamais. - SchĂ©mas articulatoires des 24 phonĂšmes : une coupe sagittale dessinĂ©e Ă partir
de six paramĂštres (lieu, langue, lĂšvres, voile, voisement, souffle) â un seul
composant pour toute la taxonomie (
src/data/articulation.ts). - Mode perception : discrimination de paires minimales Ă l'oreille AVANT la
production, déterministe et sans note (
src/engine/perception.ts). - Mode oral long (RF-21) : texte collé, découpé en phrases, guidage phrase par
phrase, bilan sans aucune moyenne (
src/engine/segments.ts). - Ăcran « Tes donnĂ©es » : la confidentialitĂ© rendue visible et vĂ©rifiable,
chaque affirmation renvoyant au fichier du dépÎt qui la prouve
(
src/store/privacy.ts). - Chaque étape prouve qu'elle a fonctionné : un journal de preuves local
(
src/store/preuves.ts) affiche, aprĂšs chaque action, ce qui a Ă©tĂ© fait, les donnĂ©es qui le prouvent (durĂ©e, niveau, lectures, mĂ©diane, Ă©cart) et oĂč le vĂ©rifier dans le code. Le journal est visible dans le profil et joint Ă l'export Markdown. - PWA installable et hors ligne : manifeste Ă chemins relatifs, service worker
écrit à la main (jamais d'audio en cache, jamais d'interception de
/api/), icÎnes générées partools/gen-icon.py. - 12 écrans (
src/screens/) et un hub d'accueil : une phrase, un texte long (RF-21), le catalogue des sons, la discrimination auditive, le profil, l'Ă©cran « Tes donnĂ©es », les rĂ©glages BYOK. Aucune fonctionnalitĂ© n'est cachĂ©e au bout d'un parcours â c'est verrouillĂ© partests/integration-app.test.tsx. - Trois fournisseurs : moteur local de dĂ©monstration (signalĂ© « simulation »),
proxy edge (clé cachée, quota, cache), BYOK Azure Speech (
src/providers/). - Proxy déployable : Worker Cloudflare (
worker/) et serveur Node sans dépendance (server/), une seule logique partagée (server/lib.mjs). - Deux hébergements publics vérifiés : GitHub Pages (URL stable) et le serveur
r630 derriĂšre un tunnel (
tools/deploy/). - CI sur runners GitHub hébergés (
ubuntu-latest), budget †5 minutes par job, file de merge Mergify, agent Hermes de résolution de conflits sur InferHub, garde « aucun score global ».
Prévu / non implémenté :
- Clé Azure du proxy : le worker a besoin d'une clé Azure Speech (tier gratuit
F0, 5 h audio/mois) posée comme secret (
wrangler secret put AZURE_SPEECH_KEY). Sans clé, le proxy répond « sans clé » et l'app tourne sur le moteur local en le disant à l'écran. - Validation go/no-go sur corpus audio réel (10 mots à 3 lectures, Annexe A) : à enregistrer par un francophone.
- Vidéo †3 min : script plan par plan dans
docs/VIDEO-SCRIPT.md, tournage Ă faire. - TroisiĂšme paire de langues (ENâES) : dĂ©clarĂ©e
pret: false, l'architecture est prĂȘte (il manque la table de donnĂ©es). - Ătalonnage des seuils 60/80 sur corpus annotĂ© par des enseignants : les seuils actuels sont issus du cahier des charges, pas d'une mesure statistique.
| Fichier | Contenu |
|---|---|
docs/ARCHITECTURE.md |
Pipeline réel, seuils, modÚle de données, fiabilité de la mesure |
docs/WRITE-UP.md |
Write-up Devpost (anglais) â problĂšme, thĂšse, dĂ©cisions, Ă©checs |
docs/WRITE-UP.fr.md |
Le mĂȘme write-up en français |
docs/AI-DISCLOSURE.md |
Déclaration obligatoire des outils IA |
docs/VIDEO-SCRIPT.md |
Script vidéo 3 min, seconde par seconde + plans + matériel |
docs/JUDGES.md |
CritÚres du concours, profils de juges, stratégie de tracks |
docs/SOUMISSION.md |
Checklist de soumission Devpost + conformité + heure limite |
docs/CONFIDENTIALITE.md |
RNF-P1..P5 : les preuves dans le code |
- CI :
ci.ymlsur runners GitHub hébergés (ubuntu-latest), budget 5 minutes par job. - File de merge : Mergify (
.mergify.yml), rebase, historique linéaire. - Gate :
.github/workflows/hermes-lite.yml(fraßcheur de branche exigée au merge) ; les vrais conflits partent à l'agent de résolution (labelhermes/conflit). - Une branche = une tùche = un PR ; le merge supprime la branche.
- Parcours du site déployé :
node tools/test-site.mjsrejoue les 12 Ă©crans dans un Chromium sur Xvfb (aucune fenĂȘtre visible, aucun focus pris) â ~106 vĂ©rifications, rapport et captures. DĂ©tail et piĂšges :tools/TEST-SITE.md.
MIT â voir LICENSE.