Solfège Progression
Apprendre la musique — plateforme interactive d’apprentissage du solfège
et de la théorie musicale, avec le Formateur Anoh Cyrille.
Application web en français, pensée d’abord pour les smartphones Android et les
connexions limitées (Afrique francophone), utilisable aussi sur tablette et ordinateur.
Ce que fait la plateforme
Sans compte (dès maintenant, même hors connexion)
| Laboratoire | Contenu |
|---|
| 1. Lecture des notes | Clé de sol et de fa, lignes supplémentaires, octaves, altérations ; réponse par boutons ou clavier de piano ; entraînement et évaluation |
| 2. Rythme, temps et mesures | Figures, silences, figures pointées, triolets, mesures simples et composées, syncopes, tempo ; métronome ; exercice de pulsation |
| 3. Tonalités et gammes | Tons et demi-tons, armures, cycle des quintes, gammes majeures et mineures (naturelle, harmonique, mélodique), degrés, orthographe ; explorateur de gammes |
| 4. Intervalles et théorie | Intervalles, accords, renversements, degrés et fonctions, lecture mélodique, cadences — ouvert selon le niveau |
| Test de positionnement | 15 questions, niveau estimé, domaines à travailler |
Correction immédiate et expliquée, historique et recommandations enregistrés
sur l’appareil, partitions dessinées avec VexFlow et vérifiées.
Avec un compte (Supabase)
- Élève : tableau de bord (dernière leçon, « Reprendre mon apprentissage »,
progression, objectif de la semaine, exercices recommandés, résultats, prochain
live), profil musical, cours et leçons avec reprise, ressources
téléchargeables, exercices corrigés par la base, devoirs, lives et replays,
annonces, import des résultats faits sans compte.
- Formateur : cours / modules / leçons / ressources, publication, exercices
et évaluations (écrits ou générés par les laboratoires), groupes, fiche élève
(niveau, déblocage, commentaires, compétences), devoirs et correction, lives,
annonces, statistiques (élèves en difficulté, devoirs à corriger, exercices).
- Administrateur : comptes et rôles, publication de tous les contenus,
annonces, paramètres, statistiques générales.
Toutes les données affichées proviennent de la base ou de l’appareil : aucun chiffre fictif.
Documentation
| Document | Contenu |
|---|
docs/SUPABASE.md | Créer et configurer le projet Supabase, premier administrateur, comptes de démonstration |
docs/DEPLOIEMENT.md | Mise en ligne sur Vercel, variables, recette |
docs/SECURITE.md | Politiques d’accès par rôle, protections, tests, limites |
docs/ARCHITECTURE.md | Architecture, logique musicale, modèle de données |
site-vitrine/README.md | Site de vente des formations (React + Vite), projet Vercel séparé |
Installation
Prérequis : Node.js ≥ 20.9 (testé avec Node 22) et npm.
npm install # .npmrc active legacy-peer-deps (dépendances facultatives de Vitest)
cp .env.example .env.local # facultatif : variables Supabase
npm run dev # http://localhost:3000
Sans variables Supabase, le site fonctionne en mode « laboratoires sans compte ».
Scripts et tests
| Commande | Rôle |
|---|
npm run dev / npm run build / npm start | développement, compilation, production |
npm run lint · npm run typecheck | ESLint, TypeScript |
npm test | 110 tests unitaires (théorie musicale, moteur d’exercices, validation, statistiques…) |
npm run test:db | 120 vérifications de sécurité sur un PostgreSQL temporaire (binaires PostgreSQL requis) |
npm run export:mpl -- <dossier> | Génère le volet Solfège de Music Progression Lab (laboratoires statiques dans /solfege) |
npm run test:e2e:mpl -- <dossier-du-lab> | Vérifie ce volet dans Music Progression Lab (menu, pages, téléphone) |
npm run test:e2e | lecture des notes dans Chromium : 120 notes relues dans le SVG, reprise, historique, hors connexion |
npm run test:e2e:labs | laboratoires rythme, tonalités, intervalles (tous niveaux, évaluation, accès au module 4) |
npm run test:e2e:espaces | toutes les pages élève / formateur / administrateur avec un faux serveur Supabase |
Ces vérifications sont relancées automatiquement par GitHub Actions à chaque pull request (.github/workflows/ci.yml).
Les tests test:e2e* nécessitent npm run build (sauf test:e2e:espaces, qui
compile lui-même) et Chromium (variable CHROMIUM_PATH si besoin).
Structure
src/app/ pages (laboratoires, espaces, cours, authentification, API de fichiers)
src/components/ interface (notation, laboratoires, académie, formulaires…)
src/lib/music/ théorie musicale pure et testée (hauteurs, portée, gammes, intervalles, accords)
src/lib/rhythm/ durées exactes, mesures, pulsation
src/lib/exercises/ moteur d’exercices générique
src/lib/theory/ générateurs d’exercices (tonalités, intervalles, notes)
supabase/ migrations SQL et tests de sécurité
scripts/ tests de bout en bout, faux serveur Supabase, données de démonstration
Licences
Police musicale Bravura : SIL Open Font License (voir public/fonts/LICENSE-Bravura.txt).
