41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# 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
|
||
|
||
```bash
|
||
./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
|
||
|
||
```bash
|
||
./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)
|