SPB Git

Repository Public

README.md 27.3 KB 483 lines markdown

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[![music.spboucher.ai](https://img.shields.io/website?url=https%3A%2F%2Fmusic.spboucher.ai%2Fapi%2Fhealth&label=backend%20music.spboucher.ai&style=for-the-badge&up_message=en%20ligne&down_message=hors%20ligne)](https://music.spboucher.ai)22![version](https://img.shields.io/badge/version-1.0.0%20%281%29-blue?style=for-the-badge)23![plateforme](https://img.shields.io/badge/plateforme-iOS%20%C2%B7%20iPadOS%2026.1%2B-000000?style=for-the-badge&logo=apple&logoColor=white)24![TestFlight](https://img.shields.io/badge/TestFlight-envoy%C3%A9e%202026--11--17-0D96F6?style=for-the-badge&logo=testflight&logoColor=white)25![licence](https://img.shields.io/badge/licence-tous%20droits%20r%C3%A9serv%C3%A9s-lightgrey?style=for-the-badge)26![author](https://img.shields.io/badge/author-Simon--Pierre%20Boucher-0A66C2?style=for-the-badge)2728![Swift](https://img.shields.io/badge/Swift-6.0%20%C2%B7%20outils%206.2-F05138?style=flat-square&logo=swift&logoColor=white)29![concurrence](https://img.shields.io/badge/concurrence%20stricte-complete-F05138?style=flat-square)30![SwiftUI](https://img.shields.io/badge/SwiftUI-iPhone%20%2B%20iPad-0D96F6?style=flat-square&logo=swift&logoColor=white)31![AVQueuePlayer](https://img.shields.io/badge/audio-AVQueuePlayer-111111?style=flat-square&logo=apple&logoColor=white)32![SQLite](https://img.shields.io/badge/SQLite-base%20locale-003B57?style=flat-square&logo=sqlite&logoColor=white)33![URLSession](https://img.shields.io/badge/URLSession-arri%C3%A8re--plan-informational?style=flat-square)34![SwiftPM](https://img.shields.io/badge/SwiftPM-SPMusicCore-F05138?style=flat-square)35![XcodeGen](https://img.shields.io/badge/XcodeGen-project.yml-1575F9?style=flat-square&logo=xcode&logoColor=white)36![passkeys](https://img.shields.io/badge/passkeys-AuthenticationServices-3423A6?style=flat-square)37![CarPlay](https://img.shields.io/badge/CarPlay-code%20livr%C3%A9%20%C2%B7%20droit%20%C3%A0%20obtenir-lightgrey?style=flat-square)38![dépendances](https://img.shields.io/badge/d%C3%A9pendances%20tierces-0-brightgreen?style=flat-square)39![WebView](https://img.shields.io/badge/vue%20web-aucune-brightgreen?style=flat-square)4041[![commits](https://git.spboucher.ai/badge/sp-music-ios/commits.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios/commits)42[![last commit](https://git.spboucher.ai/badge/sp-music-ios/last-commit.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios/commits)43[![activity](https://git.spboucher.ai/badge/sp-music-ios/activity.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios/insights)44[![language](https://git.spboucher.ai/badge/sp-music-ios/language.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios)45[![languages](https://git.spboucher.ai/badge/sp-music-ios/languages.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios/insights)46[![size](https://git.spboucher.ai/badge/sp-music-ios/size.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios)47[![branches](https://git.spboucher.ai/badge/sp-music-ios/branches.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios/branches)48[![tags](https://git.spboucher.ai/badge/sp-music-ios/tags.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios/tags)49[![clones](https://git.spboucher.ai/badge/sp-music-ios/clones.svg?style=flat-square)](https://git.spboucher.ai/sp-music-ios)5051![fichiers Swift](https://img.shields.io/badge/fichiers%20Swift-43-informational?style=flat-square)52![lignes Swift](https://img.shields.io/badge/lignes%20Swift-7%20062-informational?style=flat-square)53![cœur](https://img.shields.io/badge/c%C5%93ur%20SPMusicCore-17%20fichiers%20%C2%B7%203%20202%20lignes-informational?style=flat-square)54![écrans](https://img.shields.io/badge/dossiers%20d'%C3%A9crans-10-blue?style=flat-square)55![tests unitaires](https://img.shields.io/badge/tests%20unitaires-21-brightgreen?style=flat-square)56![tests d'intégration](https://img.shields.io/badge/tests%20d'int%C3%A9gration-12-brightgreen?style=flat-square)57![tests d'interface](https://img.shields.io/badge/tests%20d'interface-2%20%C3%97%20iPhone%20%2B%20iPad-brightgreen?style=flat-square)58![captures](https://img.shields.io/badge/captures-7-blue?style=flat-square)5960![bundle](https://img.shields.io/badge/bundle-ai.spboucher.spmusic.ios-8A2BE2?style=flat-square)61![App Store Connect](https://img.shields.io/badge/App%20Store%20Connect-6836172581-0D96F6?style=flat-square&logo=appstore&logoColor=white)62![signature](https://img.shields.io/badge/signature-automatique%20%C2%B7%20certificat%20g%C3%A9r%C3%A9%20par%20Apple-1F8B4C?style=flat-square&logo=apple&logoColor=white)63![cible](https://img.shields.io/badge/cible%20de%20d%C3%A9ploiement-iOS%2026.1-informational?style=flat-square)64![appareils](https://img.shields.io/badge/appareils-iPhone%20%C2%B7%20iPad-informational?style=flat-square)6566</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
Files main
Menu

Theme