Skip to content
TradooooPublic

About

Accent đŸŽ™ïž — elle ne te note pas, elle nomme le son qui cloche. Un phonĂšme Ă  la fois. (IceHacks 2026 / CodeStarters)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

52 Commits

Folders and files

Repository files navigation

Accent đŸŽ™ïž

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).


Le pipeline en 5 étapes

É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.

Une session, écran par écran

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 → proxy → API

[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 ; repliSurDemo sur erreur proxy, branchĂ© dans src/App.tsx).
  • URL du proxy par dĂ©faut : VITE_PROXY_URL injectĂ©e au build, sinon https://accent-proxy.duello.workers.dev (worker dĂ©ployĂ©, clĂ© en secret serveur — voir src/store/settings.ts).

Ce que le produit refuse de faire

  1. Jamais de score global. Un son, à un instant donné. Garanti par un garde CI : ci.yml échoue si scoreGlobal|globalScore|noteGlobale|overallScore apparaßt dans src/.
  2. Aucun classement, aucune comparaison entre utilisateurs. La progression ne se mesure que contre soi (src/screens/Profil.tsx).
  3. 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).

Design (verrou V1, 2026-11-15)

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.

Lancer en local

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 »).

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.

Déployer

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).

État d'avancement (honnĂȘte)

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 dans src/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 par tools/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Ă© par tests/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.

Documentation

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

Développer

  • CI : ci.yml sur 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 (label hermes/conflit).
  • Une branche = une tĂąche = un PR ; le merge supprime la branche.
  • Parcours du site dĂ©ployĂ© : node tools/test-site.mjs rejoue 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.

Licence

MIT — voir LICENSE.

About

Accent đŸŽ™ïž — elle ne te note pas, elle nomme le son qui cloche. Un phonĂšme Ă  la fois. (IceHacks 2026 / CodeStarters)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages