ATELIER PIANO — VERSION 2.0 — EN-TÊTE HARMONISÉ
Application autonome en français. Programme de novembre à juin.

CONFORT DE LECTURE — TABLETTE DE 10 POUCES
- Textes principaux : 22 pixels CSS, ou 26 pixels avec le bouton A+.
- Textes secondaires : au moins 18 pixels à l’écran. Choix A/A+ mémorisé.
- Boutons principaux de 60 à 64 pixels de haut, cases et commandes espacées.
- En-tête centré sur la page, selon la disposition de l’Atelier Glockenspiel.
- Logo à gauche ; Texte A/A+ et état MIDI regroupés à droite sur la première ligne.
- Six rubriques réparties sur toute la largeur de la deuxième ligne,
  avec des boutons de largeur égale sur grand écran et adaptés sur tablette.
- Calendrier présenté uniquement avec les noms des mois, sans année.
- Réglages et choix des leçons regroupés dans des volets dépliables.
- Une mesure complète par ligne avec les clés de sol et de fa.
- Noms des notes et chiffres de doigté agrandis. Les doigtés des accords sont
  regroupés au-dessus de la portée pour éviter leur superposition.
- Touches virtuelles élargies : 76 pixels pour les blanches et 50 pour les noires ;
  en mode A+, elles passent à 88 et 58 pixels. Toutes les touches sont nommées.
- Boutons Graves / Aiguës et recentrage sur Do4 pour parcourir 61, 76 ou 88 touches.
- Schémas et légendes agrandis. Zoom de la partition disponible à partir de 100 %.
- Impression de la partition par blocs, pour conserver toutes les mesures.

REMPLACER LA V1
Remplacez les fichiers dans le même répertoire Web, puis rechargez la page.
Le format et la clé du carnet sont conservés. Les résultats existants sont repris
à navigateur et adresse identiques. Exportez le JSON avant de changer d’adresse,
de navigateur, de domaine, de port ou de protocole.

La diagonale de la tablette ne détermine pas à elle seule la largeur d’affichage.
Le rendu complet, le tactile et la connexion MIDI réelle restent à vérifier
sur votre tablette. L’interface agrandie ne modifie pas la disponibilité de
l’API MIDI dans le navigateur ; le site conserve sa détection de compatibilité.

DÉMARRAGE SUR VOTRE SERVEUR
1. Extrayez l’archive : elle contient le dossier atelier-piano/.
2. Copiez ce dossier dans votre répertoire web, ou copiez son contenu à la racine du site.
3. Ouvrez index.html via votre adresse HTTPS, par exemple dans le sous-dossier /atelier-piano/.
4. Dans « Clavier & aide », cliquez sur « Connecter le MIDI », autorisez l’accès,
   choisissez l’instrument et le nombre de touches, puis calibrez les deux extrémités.
5. Ouvrez « Pratiquer ». Commencez en mode attente, puis passez au mode tempo.

Pas de compilation, de PHP, de base de données, de compte ni de bibliothèque à installer.
Les chemins du site sont relatifs. Tous les scripts, styles, schémas et partitions sont inclus.
L’application n’utilise ni CDN, ni API distante, ni police téléchargée.
Les pages sont accessibles par navigation à fragment (#programme, #pratiquer, etc.).

DÉMARRAGE LOCAL
Python 3 doit être installé. Depuis le dossier contenant index.html :
  python3 -m http.server 8080 --bind 127.0.0.1
Sur Windows, la commande peut être :
  py -m http.server 8080 --bind 127.0.0.1
Ouvrez ensuite http://localhost:8080 dans Chrome ou Edge.
Les scripts demarrer-local.sh et demarrer-local.bat sont également fournis.
Arrêtez le serveur avec Ctrl+C.
L’ouverture directe du fichier permet la consultation, mais localhost est recommandé
pour un accès MIDI et un stockage local fiables. Un serveur HTTP sur une adresse LAN
ne bénéficie pas automatiquement de l’exception sécurisée accordée à localhost.

CONTENU
- 8 étapes mensuelles et 32 exercices originaux ; 13 leçons avec schémas SVG.
- Grande portée : clés de sol et de fa, doigtés et noms de notes facultatifs.
- Clavier 61/76/88 touches, calibration MIDI réelle ou saisie des numéros MIDI.
- Notes MIDI allumées sur le clavier virtuel, sélection du port et du canal.
- Attente : progression lorsque les notes attendues d’un groupe sont enfoncées ensemble.
- Tempo : décompte de 3 ou 4 temps, métronome, attaques, erreurs et notes manquantes.
- Diagnostic de durée sur les touches physiquement relâchées avant la fin d’un essai.
- Mains séparées, deux mains, passages de mesures, répétition, écoute synthétisée.
- Résultats dans ce navigateur, export/import JSON, export CSV pour tableur.
- Impression de la fiche d’exercice par le navigateur, prévue en A4 paysage.

LIMITES À CONNAÎTRE
USB-MIDI ne transporte pas le son acoustique. Aucun audio n’est enregistré.
Le son facultatif du site est un synthétiseur simple, pas un piano échantillonné.
Le MIDI ne permet pas de vérifier la main physique, le doigt, la posture ou la musicalité.
Les « mains » du bilan désignent les portées attendues. Les erreurs hors cible sont globales.
En mode attente, la précision du rythme et les durées des notes ne sont pas évaluées.
Le programme reste une initiation : les tonalités avec altérations, l’import MusicXML/MIDI
et un répertoire externe ne font pas partie de cette version.

DONNÉES
Les résultats ne quittent pas le navigateur. Pas de synchronisation entre appareils.
Exportez régulièrement une sauvegarde JSON. L’import fusionne les identifiants sans doublons.
Au plus 5 000 essais sont conservés : les plus anciens sont retirés au-delà de cette limite.
Changer de navigateur, de domaine ou effacer les données peut faire perdre le suivi local.
Les résultats sont marqués USB-MIDI, virtuel, mixte ou aucune note selon les entrées de l’essai.

VÉRIFICATION DU CODE
Node.js 20 ou supérieur permet de lancer :
  node --test tests/engine.test.cjs
Les 27 tests vérifient les 32 exercices, les deux modes, le rythme, les accords,
les messages MIDI simulés, la sauvegarde, le choix A/A+, les systèmes de deux
portées, la conservation des notes à l’impression et les liens relatifs.
Le matériel USB-MIDI réel et le rendu dans votre navigateur doivent être vérifiés sur votre poste.

GUIDE DÉTAILLÉ
Ouvrez docs/guide.html, ou le lien « Guide d’utilisation » du site.
Les fichiers sources sont lisibles et modifiables dans assets/js/ et assets/css/.