# TimeCredit Quiz — iOS v1 · Note de reprise

*Rédigé pour la reprise du lendemain. L'app a été construite dans la nuit à partir de
`docs/TC_Quiz_App_iOS_Specs.md`. Ce document liste **ce qui est fait**, **les décisions que
j'ai prises** (points ouverts du §14 tranchés par défaut), et **mes questions**.*

---

## 1. Ce qui tourne (v1 jouable, 100 % hors-ligne)

Toute la boucle de jeu fonctionne **sans serveur**, avec du **contenu réel embarqué** :

- **Accueil « héros »** : domaines dépliables → matières, chacune avec sa **ceinture** et une
  **piste « course »** jalonnée I→VII (§7.1). Boutons Statistiques / Réglages / À propos.
- **Entraînement** (§7.2) : séries de 10 (3 faciles / 4 moyennes / 3 difficiles), pictos de
  difficulté, **pas de chrono**, feedback immédiat + explication, score /10.
- **Passage de ceinture** (§7.3) : déverrouillé par **3 entraînements ≥ 9/10** (1 seul après un
  échec), **20 questions uniques**, **7 s/question** (chrono visible), **aucun retour pendant**,
  **correction complète à la fin**, réussite **≥ 18/20** → montée de niveau + **nouvelle couleur**,
  ceinture **rouge** au niveau VII validé.
- **Ceintures** blanche→rouge exactement selon §6.2 (couleur = niveau **en cours**).
- **Mélange des réponses** Fisher-Yates à chaque affichage, bonne réponse repérée par **drapeau**
  jamais par position (§8.1).
- **Statistiques / historique** local (date, mode, matière, niveau, score) + taux de réussite (§7.4).
- **Signaler un problème** sur chaque question → **mis en file localement** (rien perdu hors-ligne),
  prêt à POSTer vers `/quiz/app/signaler.php` quand l'endpoint existera (§9).
- **Réglages** : thème, langues (affichées), switches **anonymes OFF par défaut** (partage stats §10,
  sauvegarde §4.5), version de contenu, **réinitialiser la progression** (parent).
- **À propos** : versions app/contenu, légende des ceintures, **note RGPD/COPPA** (§13).
- **Multilingue** : interface **FR + EN** (String Catalog `Localizable.xcstrings`), contenu suivant
  la langue du paquet (§5). Prêt pour d'autres langues (rien de figé côté taxonomie, §2.2).
- **Accessibilité** : VoiceOver (légendes média, libellés ceintures), cibles ≥ 44 pt, info jamais
  portée par la seule couleur (§8.6).

### Architecture (prête pour le serveur)
- `ContentProvider` (protocole) → `BundledContentProvider` (v1, lit le contenu embarqué).
  Le futur provider **serveur** (téléchargement progressif par tranche + SQLCipher au repos, §4)
  se branche **derrière la même interface**, sans toucher au reste.
- **Taxonomie 100 % pilotée par les données** (`Content/curriculum.json`) : aucun domaine / famille /
  matière n'est codé en dur (§2.2). Ajouter/retirer se fait côté contenu.
- Progression / historique / signalements / agrégats : **stockage local JSON** (Application Support).
- Le plombage **stats anonymes** (§10) et **signalements** (§9) accumule en local et expose un
  `flush()` no-op prêt à câbler quand les endpoints existeront.

### Contenu embarqué (démo, à remplacer par le serveur)
`Content/` = **322 vraies questions** (extraites de `questions_import.json`) réparties en une
taxonomie **illustrative** mais crédible, toutes **Niveau I** :
- **Nature** → Animaux · **Culture artistique** → BD & manga, Cinéma, Danse, Design ·
  **Culture religieuse** → Christianisme · **Mythes & légendes** → Mythologie grecque.
- Chaque paquet a ≥ 28 questions avec un spread 3/4/3 suffisant (entraînement **et** examen jouables).
- Régénérable via `scratchpad/gen_content.py` (le script est dans mon dossier de travail ; je peux
  le committer dans le repo si tu veux le garder).

---

## 2. Décisions que j'ai prises (points §14, tranchés par défaut)

À **confirmer/infirmer** demain — faciles à changer :

1. **Format de paquet = JSON** (pas SQLite/SQLCipher) pour la v1 embarquée. Simple, lisible,
   suffisant hors-ligne. SQLCipher viendra avec le provider serveur (l'interface est déjà là).
2. **6 propositions par QCM** (spec §2.4 + données réelles). ⚠️ Le fichier `quiz-pack.schema.json`
   dit **5** (a–e) : **incohérence à trancher**. J'ai suivi la spec + le contenu réel (6).
3. **1 seul profil enfant** en v1 (§14.2 multi-profils : reporté).
4. **Pas de test de positionnement** ni de **redescente de ceinture** (idées du `_A faire.rtf`) :
   hors du périmètre **décidé** de la spec. À rediscuter (voir §3 ci-dessous).
5. **Interface FR + EN** seulement pour l'instant ; langue interface/contenu **liée par défaut**
   (dissociable plus tard, §5 / §14.4).
6. **Pas de jeton d'appareil / réseau** en v1 (rien à authentifier tant que l'API n'existe pas).
7. iOS **26.5** min (repris du projet Xcode tel quel), iPhone + iPad.

---

## 3. Mes questions pour toi

1. **QCM 5 ou 6 propositions ?** La spec dit 6, le schéma d'authoring dit 5. J'ai codé pour **6**
   mais le moteur mélange n'importe quel nombre — dis-moi la règle définitive.
2. **Test de niveau de départ** (RTF) : on l'ajoute en v1.x ? (10 q niveau I → si 10/10, niveau II…
   pour éviter de faire ramer un enfant fort sur les bases.)
3. **Redescente de ceinture** (RTF) : mécanique voulue ? seuil ? Je n'ai rien codé.
4. **Contenu réel** : je n'ai que du **Niveau I** (6e). Dès qu'il y a un pack Niveau II pour une
   matière, la montée en couleur devient pleinement démontrable in-app. Le mapping propre
   `chapitre_id → taxonomie v2` n'était pas dispo hors-ligne : la démo utilise une taxonomie
   illustrative. On câble le **vrai export serveur** quand tu veux (je fige le schéma avec toi).
5. **Contrat d'API** (§15) : je peux écrire les stubs Swift (routes, modèles) dès que tu figes
   les endpoints tranche / clé / signalement / stats / sauvegarde.
6. **Design** : j'ai repris l'or TC + neutres système. Si tu as la **charte/assets TC** (§12), je
   les intègre (logo, pictos dédiés par code de domaine/matière — aujourd'hui SF Symbols + fallback).

---

## 4. Comment ouvrir
Projet : `code/iOS/TimeCredit Quiz/TimeCredit Quiz.xcodeproj` — scheme **TimeCredit Quiz**.
Le projet utilise des **groupes synchronisés au système de fichiers** : tout fichier déposé dans
`TimeCredit Quiz/` est automatiquement inclus (aucune manip pbxproj).

*Astuce test : Réglages → « Réinitialiser la progression » remet toutes les ceintures à blanc.*
