📁 GrooveGrave

**Revue experte du point de vue d'une pianiste exigeante** (joueuse réelle), sur la branche `pivot-piano-recette` (working copy hôte, audit code + théorie). Objectif : garder une TRACE priorisée des pistes d'amélioration UX du pivot guitare → piano. **Méthode** — 4 axes : (1) cohérence produit & style gothique/corbeau, (2) justesse de la THÉORIE MUSICALE (vérifiée à la main sur les data-structures), (3) pertinence/complétude des modules, (4) UX/ergonomie sur les 13 écrans. **Verdict en une ligne** : le MOTEUR musical est solide (gammes, accords, détection de tonalité tous justes), mais le PIVOT piano est inachevé (reliquats guitare visibles dès le 1er lancement) et il manque les fondamentaux d'un outil pianiste (choix d'inversion, main G/D, spelling enharmonique tonal, patterns piano exposés). **Décompte** : 🔴 bloquants ~8 · 🟠 majeurs ~10 · 🟡 mineurs ~8.

Cahier de recettes — volet **justesse théorique** (binôme : Bill audit données/code, Alice revue pianiste côté app). Vérification de l'exactitude musicale des données : accords/voicings/inversions, gammes/modes/intervalles, enharmonie, analyse harmonique. Fichiers audités : `ChordDatabase`, `PianoVoicingProvider`, `ScaleDatabase`, `HarmonyAnalysis`, `PianoPatterns`.

Run de recette fonctionnelle GrooveGrave du 2026-07-01, statuant les 12 cas d'usage du catalogue (UC-01…UC-12). Méthode : XCUITest headless (clone iPhone 17 Pro) + build/test garde-fou. Voir l'onglet ✅ Statuts des cas et la vue Régression du projet.

**Référentiel VIVANT** des parcours fonctionnels de GrooveGrave (app **PIANO**, univers corbeau/undead). Base de **chaque recette fonctionnelle**, rejouable en régression via **XCUITest headless**. À maintenir à jour à chaque évolution du produit. Chaque cas = action utilisateur → **résultat attendu (100% piano, aucun reliquat guitare)**. Légende statut : ✅ OK · ⚠️ à corriger (UX/legacy) · ⛔ bloquant (audio guitare) · ⏳ à tester.

Revue UX de l'app iOS **GrooveGrave** dans le cadre de son pivot **guitare → piano**, univers **corbeau / undead** conservé. Référentiel appliqué : *app 100% piano cohérente* (le cahier des charges livré `groovegravev2.md` décrit encore une app guitare — donc obsolète comme référence produit). Portée : revue statique des ~30 vues + localisation (5 langues), build simulateur iPhone 17 Pro (iOS 26), captures **headless via XCUITest** (aucune interférence souris), + corrections appliquées sur le clavier et l'accueil.