# Design : cible desktop macOS — Livrets

Date : 2026-08-28
Statut : Validé par le produit

## 1. Objectif

Ajouter une cible desktop macOS (Compose Multiplatform desktop) à l'app Livrets existante (Android + iOS), lançable via `./gradlew :desktopApp:run`. Zéro modification du code métier/UI existant.

## 2. Décisions clés

| Décision | Choix |
|---|---|
| Usage | Run Gradle uniquement (pas de packaging .app/.dmg en v1) |
| Structure | Nouveau module hôte `desktopApp/` (miroir d'`androidApp`), dépend de `:sharedUI` |
| Fenêtre | "Livrets", 480×800 dp, fermeture = exit |
| Stockage | `~/.livrets/history.json` (créé à la première sauvegarde par HistoryRepository) |
| JVM | compat source/target Java 17 + jvmTarget Kotlin 17 (alignement des deux tâches) |

Rejeté : cible desktop dans `sharedUI` (mélange bibliothèque/hôte) ; UI desktop native (UI Compose déjà partagée).

## 3. Architecture

- `settings.gradle.kts` : + `include(":desktopApp")`
- `desktopApp/build.gradle.kts` : plugins kotlin-jvm + compose-compiler + compose-multiplatform (aliases existants) ; `java { source/targetCompatibility 17 }` + `kotlin { jvmTarget 17 }` (sinon conflit compileJava 18 vs compileKotlin 17) ; dépendances `implementation(project(":sharedUI"))` + `implementation(compose.desktop.currentOs)` ; bloc `compose.desktop { application { mainClass = "com.livrets.desktop.MainKt" } }`
- `desktopApp/src/main/kotlin/com/livrets/desktop/Main.kt` : `fun main() = application { Window(onCloseRequest = ::exitApplication, title = "Livrets", state = rememberWindowState(480.dp, 800.dp)) { App(filesDirPath = storageDir()) } }` ; `storageDir() = System.getProperty("user.home") + "/.livrets"`
- `README.MD` : section "macOS desktop" (lancement)

## 4. Faisabilité (validée en sandbox)

`:desktopApp:jar` compile ; `:desktopApp:run` ouvre la fenêtre et le processus JVM reste vivant (testé sur cette machine, JDK 18, JVM x86_64 sous Rosetta — sans conséquence pour desktop).

## 5. Tests & vérifications

- `:desktopApp:jar` → compile
- `:desktopApp:run` → fenêtre visible (vérification manuelle de l'utilisateur)
- Régression : `:sharedUI:jvmTest` (20/20) + `:androidApp:assembleDebug` inchangés

## 6. Hors périmètre

- Packaging .app/.dmg, signature/notarisation
- Redimensionnement adaptatif de l'UI desktop, raccourcis clavier
- Distribution (DMG, Homebrew)