# TC Quiz Android — État

*Relu par le lead iOS pour vérifier l'alignement. Mis à jour à chaque bloc livré.*

Source de vérité : app iOS `quiz/code/iOS/TimeCredit Quiz/TimeCredit Quiz/`.
Stack : Kotlin + Jetpack Compose + Material 3 (mirroir de l'app TimeCredit Android
principale : AGP 8.7.3, Kotlin 2.0.21, Gradle 9.3.0, compose-bom 2024.10.00,
minSdk 26 / compileSdk 35). Build via le JBR d'Android Studio (JDK 21).

---

## Livraison 1 (accueil) — EN ATTENTE DE VALIDATION

> **Build vérifié** : `./gradlew :app:assembleDebug` via le JBR (JDK 21) →
> **BUILD SUCCESSFUL**, `app/build/outputs/apk/debug/app-debug.apk` (~20 Mo).
> Commande : `JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home" ./gradlew :app:assembleDebug`.

### Fait
- **Projet Compose** créé + wrapper Gradle (copié de l'app principale, éprouvé).
  - `applicationId` = `app.timecredit.quiz` (tranché par le lead : aligné sur l'app
    TimeCredit Android principale `app.timecredit`). Permanent sur le Play Store.
- **Contenu partagé importé tel quel** dans `app/src/main/assets/` :
  `curriculum.json`, `vocabulaire.json` (19 langues), `packs/` (57), `belts/` (9 SVG).
- **Couche modèle** (`model/ContentModels.kt`, `Belt.kt`) — mirroir des `struct`
  iOS via kotlinx.serialization (`content_version`, `question_count`, 6 choix QCM,
  numeric, difficulté, LevelRank I…VII).
- **Couche contenu** : `ContentProvider` (interface) + `BundledContentProvider`
  (lit les assets) + `ContentStore` (curriculum, familles, `populatedFamilies`,
  packs paresseux). `BeltAssets` résout les SVG par radical de couleur (robuste au
  suffixe `_v5`).
- **i18n** : `Vocab` (dico runtime, `tr(key)` / `tr(key, args…)` placeholders `{0}`,
  langue = système/override, fallback FR, RTL ar/he) — **pas de strings en dur**.
- **Thème** : `TCTheme` accent doré **#D9A621**, schémas Material3 clair/sombre,
  `TCMenuButton`, mapping SF-Symbol → Material (`TCIcons`). `AppTheme` (enum).
- **Stores** : `ProgressionStore` (règles ceintures/sas/examen fidèles) +
  `LocalStore` (persistance JSON locale sous `filesDir/TCQuiz`).
- **Écran d'accueil** (`ui/RootScreen.kt`) :
  - rangée des 8 ceintures **pinée en haut** (`BeltHeaderRow`) ;
  - **héros** = carte « TimeCredit Quiz » + **une ligne par type** (famille) =
    picto + **ligne des ceintures** (`BeltLineView`, 8 positions, min/max +
    points dorés). Tap → Progression. **Bloc TEMP iOS NON porté** (vraies données).
  - **boutons style TC** dans l'ordre exact (à jour IOS_SYNC) : Entraînement ·
    Passage de ceinture · (espace) · **Statistiques** · (espace) · **Réglages** ·
    À propos.
- Écrans non encore construits → `PlaceholderScreen` (garde la rangée pinée,
  tap = retour accueil).

### Sync appliquées (IOS_SYNC.md)
- **#1** Entraînement = picto `figure.run` (Material `directions_run`), teinté or.
- **#2** Passage de ceinture = picto **ceinture or** (`belt_gold` / ceinture_doree.svg),
  rendu **32 dp** ; repli SF `rosette`. Icônes *image* de menu = 32 dp, SF = taille body.

### En cours / à faire (prochaines livraisons, après validation)
- Entraînement (arbre type→matière→chapitre) + moteur `QuizEngine` (10 q, 3/4/3,
  facile→normale→difficile, feedback immédiat).
- Écran question (grille de tuiles 2/3 col) + mélange Fisher-Yates.
- Passage de ceinture (examen 20 q / 7 s / ≥18/20).
- Progression (collapsibles), Réglages (langue/thème/orientation), Stats, À propos,
  Signaler un problème.

### Questions ouvertes pour le lead iOS
1. ~~applicationId~~ → **tranché : `app.timecredit.quiz`**.
2. **Rendu des ceintures** : SVG partagés chargés via Coil-SVG depuis `assets/`
   (0 conversion, 0 modif). OK, ou préfère-t-on des Vector Drawables ?
3. **Sérialisation** : kotlinx.serialization (équivalent Codable). OK ?
4. Confirmer que je pige les 57 packs + vocab **en dur dans l'APK** pour v1
   (comme iOS bundled), le provider serveur viendra derrière `ContentProvider`.

*Voir `ANDROID_DIFFERENCES.md` pour les écarts iOS↔Android consignés.*
