livrets/README.MD

Livrets

Jeu d'entraînement aux tables de multiplication (Kotlin Multiplatform, Android + iOS).

Règles du jeu

• Au lancement, on configure : le nombre de questions (5–50), le temps par question (3–30 s) et la table maximum (1–12).
• Chaque question est une multiplication tirée au hasard dans les tables 1 à la table maximum : soit a × b = ?, soit a × ? = b. On répond avec le pavé numérique.
• Temps écoulé = réponse comptée comme fausse (une saisie en cours est auto-validée).
• Après chaque réponse, un feedback (vert/rouge) s'affiche 1,5 s puis la question suivante arrive.
• À la fin : score, taux de réussite, temps moyen et résumé de chaque réponse fausse.
• L'Historique conserve les parties passées et le taux de réussite cumulé par table.

Lancer l'application

Android

./gradlew :androidApp:installDebug    # appareil/émulateur connecté
# ou générer l'APK :
./gradlew :androidApp:assembleDebug   # androidApp/build/outputs/apk/debug/

iOS

Ouvrir iosApp/iosApp.xcodeproj dans Xcode et lancer le scheme iosApp sur un simulateur.

Tests

./gradlew :sharedUI:jvmTest           # logique de jeu, générateur, persistance

Structure

• sharedUI/ : logique de jeu (game/), persistance (data/), UI Compose (ui/), thème (theme/)
• androidApp/ : hôte Android
• iosApp/ : hôte iOS (Xcode)