Repository Public
1<!--2SP Music iOS3File: README.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7<div align="center">89<img src="docs/brand/logo.svg" alt="SP Music logo" width="560">1011<br><br>1213<img src="docs/brand/icon.png" alt="SP Music icon" width="112" height="112">1415# SP Music — iOS et iPadOS1617**Lecteur natif de la bibliothèque musicale privée hébergée sur MacLustr (music.spboucher.ai) : Swift 6 et SwiftUI, sans aucune vue web — diffusion depuis le cluster et lecture hors ligne de la musique téléchargée.**1819**Author: [Simon-Pierre Boucher](https://www.spboucher.ai)**2021[](https://music.spboucher.ai)2223242526272829303132333435363738394041[](https://git.spboucher.ai/sp-music-ios/commits)42[](https://git.spboucher.ai/sp-music-ios/commits)43[](https://git.spboucher.ai/sp-music-ios/insights)44[](https://git.spboucher.ai/sp-music-ios)45[](https://git.spboucher.ai/sp-music-ios/insights)46[](https://git.spboucher.ai/sp-music-ios)47[](https://git.spboucher.ai/sp-music-ios/branches)48[](https://git.spboucher.ai/sp-music-ios/tags)49[](https://git.spboucher.ai/sp-music-ios)5051525354555657585960616263646566</div>6768---6970## Sommaire7172- [Vue d'ensemble](#-vue-densemble)73- [Captures](#-captures)74- [Fonctionnalités](#-fonctionnalités)75- [Architecture](#-architecture)76- [Pile technique](#-pile-technique)77- [Organisation du dépôt](#-organisation-du-dépôt)78- [Commandes](#-commandes)79- [Configuration](#-configuration)80- [Écrans](#-écrans)81- [API utilisée](#-api-utilisée)82- [Parité avec le site](#-parité-avec-le-site)83- [Sécurité et vie privée](#-sécurité-et-vie-privée)84- [Tests](#-tests)85- [Publication TestFlight](#-publication-testflight)86- [Blocages et limites — à lire](#-blocages-et-limites--à-lire)87- [Documentation](#-documentation)88- [Auteur](#-auteur)89- [Licence](#-licence)9091---9293## 🎯 Vue d'ensemble9495Lecteur natif de la bibliothèque musicale privée hébergée sur MacLustr (`music.spboucher.ai`). Swift 6 et SwiftUI,96sans aucune vue web : diffusion depuis le cluster **et** lecture hors ligne de la musique téléchargée.9798| | |99|---|---|100| Identifiant | `ai.spboucher.spmusic.ios` |101| Version | 1.0.0 (1) — envoyée sur TestFlight le 2026-11-17 (App Store Connect n° 6836172581) |102| Cible | iOS / iPadOS 26.1 et plus, iPhone et iPad |103| Serveur | API « clients natifs » de Music SP (dépôt [sp-music](https://git.spboucher.ai/sp-music), branche `main`) |104105### Famille SP Music106107| Dépôt | Plateforme | Rôle |108|---|---|---|109| [sp-music](https://git.spboucher.ai/sp-music) | Web · PWA | Serveur : site, API `/api/v1`, worker d'import, diffusion audio, paroles |110| [sp-music-macos](https://git.spboucher.ai/sp-music-macos) | macOS | Client natif (AVAudioEngine), paquet séparé |111| **[sp-music-ios](https://git.spboucher.ai/sp-music-ios)** (ce dépôt) | iOS · iPadOS | Client natif : diffusion, téléchargement, lecture hors ligne |112113L'application **n'ajoute rien au backend** : elle réutilise l'API des clients natifs du dépôt `sp-music`.114115## 📸 Captures116117Captures produites par les tests d'interface sur simulateur (`docs/captures/`).118119<div align="center">120<img src="docs/captures/iphone-01-accueil.png" alt="Accueil sur iPhone" width="200">121<img src="docs/captures/iphone-04-album.png" alt="Fiche album sur iPhone" width="200">122<img src="docs/captures/iphone-07-lecteur.png" alt="Lecteur sur iPhone" width="200">123<img src="docs/captures/iphone-10-telechargements.png" alt="Téléchargements sur iPhone" width="200">124</div>125126<details>127<summary><b>Connexion et iPad</b></summary>128129<div align="center">130<img src="docs/captures/iphone-20-connexion.png" alt="Connexion sur iPhone" width="200">131<br><br>132<img src="docs/captures/ipad-06-mini-lecteur.png" alt="Barre de lecture sur iPad" width="640">133<br><br>134<img src="docs/captures/ipad-08-file-attente.png" alt="File d'attente sur iPad" width="640">135</div>136137</details>138139## ✨ Fonctionnalités140141- **Bibliothèque** : albums, artistes, titres, listes de lecture, favoris, récemment écoutés, musique téléchargée ;142 recherche instantanée sur la copie locale (donc aussi en mode avion).143- **Lecture** : `AVQueuePlayer`, fichiers originaux décodés par iOS (FLAC 16/24 bits, ALAC, AAC, MP3, WAV, AIFF),144 piste suivante préparée à l'avance, file d'attente, aléatoire, répétition, paroles synchronisées.145- **Hors ligne** : téléchargement d'un titre, d'un album, d'une liste ou de toute la bibliothèque ; `URLSession`146 d'arrière-plan ; reprise ; chaque fichier est vérifié (taille + SHA-256 de l'original) avant d'être déclaré147 disponible ; un fichier partagé par plusieurs albums ou listes n'est stocké qu'une fois et n'est supprimé que148 lorsque plus rien ne le réclame.149- **Système** : lecture en arrière-plan, écran verrouillé / Centre de contrôle / Dynamic Island par les commandes150 standard (`MPNowPlayingInfoCenter`, `MPRemoteCommandCenter`), AirPods et Bluetooth, sélecteur de sortie AirPlay,151 interruptions (appels), CarPlay (code livré, voir [Blocages](#-blocages-et-limites--à-lire)).152- **Synchronisation** : incrémentale (révisions + suppressions), favoris et écoutes mis en file hors ligne puis153 envoyés au retour du réseau, reprise de la file de lecture entre appareils.154- **Connexion** : clé d'accès du site (Face ID / Touch ID), association depuis un appareil déjà connecté, lien155 d'inscription, code de récupération ; session dans le trousseau ; verrouillage biométrique optionnel.156- **iPad** : `NavigationSplitView` avec barre latérale, barre de lecture pleine largeur, lecteur plein écran à deux157 colonnes, raccourcis clavier (menu « Lecture », ⌘F, ⌘1–⌘5), glisser-déposer de titres vers les listes.158159## 🏗 Architecture160161```mermaid162flowchart TB163 subgraph APP["Application SwiftUI"]164 UI["Features · Components"] --> ENV["AppEnvironment<br/>état partagé"]165 CP["CarPlaySceneDelegate"] --> ENV166 end167 subgraph CORE["SPMusicCore (paquet Swift, iOS + macOS, aucune dépendance)"]168 AUD["Audio<br/>AudioPlayer · PlaybackQueue · SourceResolver<br/>AudioSessionManager · NowPlayingCenter"]169 API["API<br/>APIClient · Endpoints"]170 AUTH["Authentication<br/>AuthService · Passkeys"]171 DB["Persistence<br/>Database · SQLite"]172 SYNC["Synchronization<br/>SyncEngine"]173 DL["Downloads<br/>DownloadManager"]174 OFF["Offline<br/>OfflineFiles"]175 SEC["Security · Settings"]176 end177 ENV --> AUD178 ENV --> SYNC179 ENV --> DL180 ENV --> AUTH181 AUD --> OFF182 AUD --> API183 SYNC --> API184 SYNC --> DB185 DL --> OFF186 DL --> DB187 AUTH --> API188 AUTH --> SEC189 API -->|HTTPS| SRV["music.spboucher.ai<br/>/api/v1"]190 DL -->|"URLSession d'arrière-plan"| SRV191```192193### Téléchargement vérifié194195```mermaid196sequenceDiagram197 autonumber198 participant U as Utilisateur199 participant DM as DownloadManager200 participant S as music.spboucher.ai201 participant F as OfflineFiles202 U->>DM: télécharger un album203 DM->>DM: ignore les fichiers déjà présents (comptage des références)204 DM->>S: GET /api/v1/stream/<id> (session d'arrière-plan, reprise)205 S-->>DM: octets de l'original206 DM->>DM: vérifie la taille puis le SHA-256 annoncé par la synchronisation207 alt intégrité conforme208 DM->>F: fichier déclaré disponible209 else échec210 DM->>DM: fichier refusé, nouvel essai211 end212 F-->>U: lecture sans réseau213```214215## 🧱 Pile technique216217| Couche | Technologie | Version | Rôle |218|---|---|---|---|219| Langage | Swift (`SWIFT_VERSION` 6.0 ; `swift-tools-version` 6.2 pour le paquet) | 6 | concurrence stricte `complete` |220| Interface | SwiftUI | iOS 26.1+ | iPhone et iPad (`TARGETED_DEVICE_FAMILY` 1,2) |221| Audio | AVFoundation (`AVQueuePlayer`), MediaPlayer | système | lecture, « En lecture », commandes distantes |222| Persistance | SQLite | système | copie locale du catalogue, files d'attente hors ligne |223| Réseau | URLSession (dont session d'arrière-plan) | système | API JSON, transferts |224| Authentification | AuthenticationServices · Trousseau | système | clé d'accès, session |225| Voiture | CarPlay | système | scène livrée, droit à obtenir |226| Paquet | `SPMusicCore` — plateformes iOS 26.1 et macOS 15 | — | cœur testable sur le Mac par `swift test` |227| Projet | XcodeGen (`project.yml`) | — | le projet Xcode n'est pas versionné |228| Outils constatés | Xcode 27.2, SDK iOS 27.2, simulateurs iOS 26.5 | — | d'après `docs/AUDIT.md` |229230## 🗂 Organisation du dépôt231232```233App/ point d'entrée, état partagé (AppEnvironment), pochettes, scène CarPlay234Features/ écrans : Accueil, Bibliothèque, Albums, Listes, Recherche, Lecteur, Téléchargements, Réglages, Compte235Components/ mini-lecteur, rangées, pochettes, bouton de téléchargement, commandes système, thème236Core/ paquet Swift SPMusicCore (iOS + macOS) : API, authentification, base SQLite, synchronisation,237 téléchargements, fichiers hors ligne, moteur audio — sans aucune dépendance externe238Resources/ Info.plist (+ Info-Debug.plist), droits, catalogue d'images (icône claire / sombre / teintée)239Design/ sources vectorielles de l'icône (icon.svg, icon-dark.svg, icon-tinted.svg)240Tests/ tests d'intégration sur simulateur ; Core/Tests : tests unitaires ; UITests : tests d'interface241Scripts/ backend de test, suites de tests, essai production, archive et envoi TestFlight242docs/ AUDIT.md (existant + matrice de parité), TESTS.md (ce qui a été réellement exécuté), captures, brand/243```244245| Dossier | Fichiers Swift | Lignes |246|---|---|---|247| `Core/Sources` | 17 | 3 202 |248| `Features/` | 10 | 1 763 |249| `Components/` | 6 | 567 |250| `Core/Tests` | 2 | 516 |251| `App/` | 4 | 509 |252| `Tests/` | 2 | 362 |253| `UITests/` | 1 | 121 |254| **Total** (avec `Core/Package.swift`) | **43** | **7 062** |255256Le projet Xcode est généré : `xcodegen generate` (il n'est pas versionné).257258## 🚀 Commandes259260```bash261Scripts/test.sh core # 21 tests unitaires du cœur, sur le Mac262Scripts/test-server.sh up # backend jetable sur m5ma:8692 (bibliothèque synthétique) + tunnel + identifiants263Scripts/test.sh app # 12 tests d'intégration sur simulateur (HTTP réel, audio réel)264Scripts/test.sh ui [iPad] # tests d'interface, captures dans build/shots/265Scripts/prod-smoke.sh # essai en lecture seule contre la production (compte temporaire, supprimé à la fin)266Scripts/release.sh archive|export|validate|upload # archive Release → IPA de distribution → TestFlight267```268269| Script | Détail |270|---|---|271| `Scripts/test.sh core` | tests unitaires de `SPMusicCore` sur le Mac, sans réseau |272| `Scripts/test.sh app [iPad]` | tests d'intégration sur simulateur contre le backend jetable |273| `Scripts/test.sh ui [iPad]` | tests d'interface (même backend) ; captures dans `build/shots/` |274| `Scripts/test-server.sh up` | clone ou rafraîchit le backend, base neuve, bibliothèque synthétique (ondes sinusoïdales, tous les conteneurs pris en charge), démarrage sur m5ma:8692, tunnel SSH vers `localhost:8692`, identifiants de test écrits hors du dépôt |275| `Scripts/prod-smoke.sh` | crée un compte **auditeur** temporaire, exécute `Tests/AppTests/ProductionSmokeTests.swift`, puis supprime le compte quoi qu'il arrive |276| `Scripts/release.sh archive` | archive Release pour appareils → `build/SPMusic.xcarchive` |277| `Scripts/release.sh export` | IPA signé pour la distribution (profil App Store Connect, certificat géré par Apple) → `dist/` |278| `Scripts/release.sh validate` | validation App Store Connect de l'IPA (n'envoie rien) |279| `Scripts/release.sh upload` | envoi vers App Store Connect / TestFlight |280281## ⚙️ Configuration282283| Réglage (`project.yml`) | Valeur |284|---|---|285| `MARKETING_VERSION` · `CURRENT_PROJECT_VERSION` | `1.0.0` · `1` |286| `SWIFT_VERSION` · `SWIFT_STRICT_CONCURRENCY` | `6.0` · `complete` |287| Cible de déploiement | iOS 26.1 |288| Identifiants | app `ai.spboucher.spmusic.ios`, tests `.tests`, tests d'interface `.uitests` |289| Signature | automatique |290| Droits (appareil) | `Resources/SPMusic.entitlements` — `webcredentials:music.spboucher.ai` |291| Droits (simulateur) | `Resources/SPMusic-CarPlay.entitlements` — pour exécuter les écrans CarPlay |292| Debug | `Resources/Info-Debug.plist` : backend de test joint par `http://localhost:8692` à travers un tunnel SSH |293| Mac Catalyst · « Conçu pour iPad » sur Mac · visionOS | désactivés |294| Mode d'arrière-plan | `audio` |295296- Avant chaque envoi : incrémenter `CURRENT_PROJECT_VERSION` dans `project.yml`.297- La clé de l'API App Store Connect est lue dans `~/.config/spmusic-ios/asc.env` ; rien de secret n'est dans le dépôt.298- `SPMUSIC_BACKEND_REF` : branche du backend clonée par `Scripts/test-server.sh`.299300## 📱 Écrans301302| Écran | Fichier |303|---|---|304| Racine (onglets iPhone, barre latérale iPad) | `Features/Root/RootView.swift` |305| Accueil | `Features/Home/HomeView.swift` |306| Bibliothèque | `Features/Library/LibraryView.swift` |307| Fiche album | `Features/Albums/AlbumDetailView.swift` |308| Listes de lecture | `Features/Playlists/PlaylistViews.swift` |309| Recherche | `Features/Search/SearchView.swift` |310| Lecteur | `Features/NowPlaying/NowPlayingView.swift` |311| Téléchargements | `Features/Downloads/DownloadsView.swift` |312| Réglages | `Features/Settings/SettingsView.swift` |313| Compte et connexion | `Features/Account/AccountViews.swift` |314| CarPlay | `App/CarPlay/CarPlaySceneDelegate.swift` |315316## 🔌 API utilisée317318Client : `Core/Sources/SPMusicCore/API/` (`APIClient.swift`, `Endpoints.swift`). Serveur :319[sp-music](https://git.spboucher.ai/sp-music).320321| Domaine | Appels |322|---|---|323| Synchronisation | catalogue incrémental (`library/sync?since=`), données du compte (`library/sync/me`) |324| Paroles | paroles d'un titre |325| Favoris | activer / désactiver un favori (titre ou album) |326| Listes | créer, renommer, supprimer, ajouter des titres, ordonner |327| Lecture | enregistrer l'état de lecture ; demander un rendu de compatibilité et suivre son état |328| Historique | envoyer et lire les écoutes |329| Compte | clés d'accès (lister, supprimer), sessions (lister, révoquer), déconnexion |330| Connexion | clé d'accès, code de récupération, association d'appareil (démarrer, interroger) |331| Médias | diffusion `GET /api/v1/stream/<id>[?v=compat]` (`Range` → 206), pochettes |332333## 🔁 Parité avec le site334335Tableau établi lors de l'audit du 2026-11-17 ([`docs/AUDIT.md`](docs/AUDIT.md)).336337| Fonction | Web | iOS / iPadOS |338|---|---|---|339| Parcourir albums, artistes, titres | oui | oui |340| Recherche | serveur | locale, hors ligne comprise |341| Listes de lecture (créer, renommer, ordonner, supprimer) | oui | oui (en ligne) |342| Favoris | oui | oui, mis en file hors ligne |343| Diffusion de l'original, repli AAC | oui | oui |344| File d'attente, aléatoire, répétition | oui | oui (mêmes règles) |345| Reprise de la file entre appareils | oui | oui |346| Paroles synchronisées | mot à mot | ligne à ligne |347| Commandes système (écran verrouillé, casque) | Media Session | oui, natives |348| **Téléchargement et lecture hors ligne** | non | **oui** |349| Historique d'écoute | non | oui (envoyé au serveur) |350| Connexion par clé d'accès | oui | oui (native) |351| Association d'appareil par code | page d'approbation | oui |352| Administration (import, édition des tags, comptes) | oui | non — reste sur le site |353| CarPlay | — | code livré, droit Apple à obtenir |354| Égaliseur, fondu, normalisation | non | non |355356## 🔐 Sécurité et vie privée357358- Session dans le trousseau ; verrouillage biométrique optionnel de l'application (Face ID).359- Clé d'accès du site par le droit Associated Domains (`webcredentials:music.spboucher.ai`) ; le serveur publie le360 fichier d'association pour cet identifiant.361- Chaque fichier téléchargé est vérifié (taille + SHA-256 de l'original) avant d'être déclaré disponible ; un362 transfert refusé (401) n'est jamais pris pour de l'audio.363- L'essai en production est en lecture seule, avec un compte auditeur temporaire supprimé à la fin.364- Rien de secret n'est dans le dépôt : clé App Store Connect et identifiants de test sont lus hors du dépôt.365- Les tests n'utilisent qu'une bibliothèque synthétique (ondes sinusoïdales) : aucun enregistrement commercial.366367## ✅ Tests368369Détail : [`docs/TESTS.md`](docs/TESTS.md) — ce qui a été réellement exécuté le 2026-11-17. Aucun résultat n'est370simulé ; ce qui n'a pas pu être exécuté est listé comme tel.371372| Suite | Commande | Résultat rapporté |373|---|---|---|374| Unitaires du cœur | `Scripts/test.sh core` | 21 / 21 |375| Intégration sur simulateur | `Scripts/test.sh app` | 12 / 12 |376| Interface iPhone | `Scripts/test.sh ui` | 2 / 2 |377| Interface iPad | `Scripts/test.sh ui iPad` | 2 / 2 |378| Essai production | `Scripts/prod-smoke.sh` | 2 / 2 |379380Fonctions de test dans le dépôt : `CoreTests.swift` 21, `IntegrationTests.swift` 10, `ProductionSmokeTests.swift` 2,381`SPMusicUITests.swift` 2.382383**Moyens** : simulateurs dédiés « SPMusic iPhone » (iPhone 17 Pro) et « SPMusic iPad » (iPad Pro 11" M5), iOS 26.5 ;384backend jetable (le vrai serveur Music SP, dans son propre clone, sa propre base et son propre port) avec une385bibliothèque synthétique couvrant FLAC 16/44,1, FLAC 24/48, FLAC 24/96, MP3 320, AAC 256, ALAC, WAV, AIFF, plus un386fichier de 40 Mo. **Aucun iPhone ni iPad réel n'était branché au Mac.**387388<details>389<summary><b>Liste du cahier des charges, test par test</b></summary>390391| Test demandé | État | Comment |392|---|---|---|393| Connexion au cluster | **exécuté** | Session réelle, production comprise (TLS, passerelle). |394| Streaming | **exécuté** | 8 formats lus depuis le flux et décodés par iOS ; en production, un FLAC 24/48 de 32 Mo avec saut profond (requête `Range`). |395| Téléchargement d'un titre | **exécuté** | Y compris en production, SHA-256 identique à celui du serveur. |396| Téléchargement d'un album | **exécuté** | 6 titres, chacun vérifié octet pour octet ; aussi par l'interface. |397| Téléchargement d'une playlist | **exécuté** | Ordre de la liste conservé ; fichiers déjà présents non retéléchargés. |398| Lecture en mode avion | **exécuté par équivalent** | Pile sans réseau, sans session, serveur à une adresse morte : lecture, piste suivante, enchaînement automatique, répétition, aléatoire, recherche. |399| Lecture avec écran verrouillé | **non exécuté** | Demande un appareil. Le mode d'arrière-plan `audio` est déclaré. |400| Lecture en arrière-plan | **non exécuté** | Idem. |401| Commandes AirPods | **non exécuté** | Demande un appareil. Vérifié : commandes enregistrées et informations « En lecture » publiées. |402| Changement de sortie audio | **réaction vérifiée** | Notification « sortie disparue » envoyée à la main : la lecture se met en pause. |403| Interruption par appel / reprise | **réaction vérifiée** | Notifications d'interruption envoyées à la main : la lecture reprend. |404| Synchronisation | **exécuté** | Complète puis incrémentale ; production : 875 titres en 0,2 s. |405| Reconnexion réseau | **exécuté (unitaire)** | Favori et écoute faits hors ligne, envoyés une seule fois au retour. |406| Gestion des téléchargements | **exécuté** | Pause puis reprise d'un fichier de 40 Mo, échec d'intégrité refusé puis réessayé, fichier disparu retéléchargé. |407| Gestion du stockage | **exécuté** | Comptage des références (album + liste), suppression, rapport d'espace. |408| Face ID | **non exécuté** | Demande un appareil. |409| Passkeys | **non exécuté de bout en bout** | Vérifié : format WebAuthn des réponses, fichier d'association publié, droit Associated Domains dans le binaire signé. |410| Association d'appareil par code | **exécuté** | Code affiché, approbation, session propre à l'appareil, code inutilisable ensuite. |411| Connexion par code de récupération | **exécuté** | Par l'API et par l'interface. |412| Navigation iPhone | **exécuté** | Parcours complet par l'interface, 16 captures relues. |413| Navigation iPad | **exécuté** | Même parcours, barre latérale, lecteur plein écran. |414| Qualité audio | **exécuté** | Rendu AAC existant et rendu préparé à la demande ; libellés de format vérifiés. |415| CarPlay | **non exécuté** | Droit Apple non accordé. |416417</details>418419**Défauts trouvés par les tests et corrigés**4204211. Le rang dans la file disparaissait des informations « En lecture » à l'arrivée de la pochette.4222. Le lecteur plein écran débordait de l'écran (l'image de fond imposait sa largeur).4233. Sur iPad, la ligne « Téléchargements » de la barre latérale ne se sélectionnait pas.4244. En-tête d'album illisible sur iPad en portrait ; barre de lecture iPad invisible.425426## 📦 Publication TestFlight427428```bash429Scripts/release.sh archive # build/SPMusic.xcarchive430Scripts/release.sh export # IPA de distribution dans dist/431Scripts/release.sh validate # validation App Store Connect432Scripts/release.sh upload # envoi TestFlight433```434435| Étape (1.0.0, build 1) | État |436|---|---|437| Build simulateur | fait |438| Archive Release pour appareil, signée | faite |439| IPA signé pour la distribution (profil App Store, certificat géré par Apple) | fait — 3,1 Mo |440| Validation App Store Connect | « VERIFY SUCCEEDED with no errors » |441| Envoi TestFlight | « UPLOAD SUCCEEDED with no errors », 1.0.0 (1) |442| Installation sur un iPhone réel | à faire par le propriétaire (TestFlight) |443444Il n'y a pas de certificat « Apple Distribution » local : la signature de distribution est faite par le certificat445géré par Apple, via la clé de l'API App Store Connect. L'identifiant d'app (avec la capacité Associated Domains) et446les profils ont été créés automatiquement lors de l'archive.447448## ⚠️ Blocages et limites — à lire449450Voir [`docs/TESTS.md`](docs/TESTS.md) pour le détail. En bref :451452- **Aucun appareil réel n'était branché** : tout a été exécuté sur simulateur (iPhone 17 Pro et iPad Pro 11",453 iOS 26.5). Restent à vérifier sur iPhone : clé d'accès avec Face ID, AirPods, écran verrouillé, appel entrant,454 transferts en arrière-plan app suspendue, mode avion réel.455- **CarPlay** : le code est livré, mais Apple doit accorder le droit `com.apple.developer.carplay-audio` (demande à456 faire sur developer.apple.com/contact/carplay). Le build TestFlight est signé sans ce droit ; la scène CarPlay ne457 s'y connecte donc pas. Non testé.458- **Égaliseur, fondu enchaîné, normalisation** : non livrés (optionnels au cahier des charges). Ils imposent de459 traiter le signal dans l'app.460- **Interface en français uniquement.**461- Les modifications de listes de lecture demandent une connexion (refus explicite hors ligne) ; favoris et écoutes,462 eux, sont mis en file.463- Administration (import, édition des tags, comptes) : reste sur le site.464465## 📚 Documentation466467- [`docs/AUDIT.md`](docs/AUDIT.md) — audit de l'existant, matrice de parité, configuration Apple constatée468- [`docs/TESTS.md`](docs/TESTS.md) — ce qui a été réellement exécuté, défauts corrigés, distribution469470## 👤 Auteur471472<div align="center">473<img src="docs/brand/icon.png" width="64" height="64" alt=""><br>474475**Simon-Pierre Boucher** — conception, développement, exploitation<br>476[www.spboucher.ai](https://www.spboucher.ai) · [git.spboucher.ai](https://git.spboucher.ai) · contact@spboucher.ai477478</div>479480## 📄 Licence481482Le dépôt ne contient pas de fichier de licence. Tous droits réservés © 2026 Simon-Pierre Boucher.483