SP Music pour macOS
Lecteur musical natif — Swift 6, SwiftUI, AppKit, AVAudioEngine — de la bibliothèque privée servie par music.spboucher.ai : lecture en continu depuis le cluster, téléchargement vérifié et lecture hors ligne sans aucune requête.
Author: Simon-Pierre Boucher
Sommaire
- Vue d'ensemble
- Fonctionnalités
- Architecture
- Pile technique
- Organisation du dépôt
- Construire et tester
- Configuration
- Écrans
- Backend et API
- Données locales
- Connexion
- Sécurité et vie privée
- Tests
- Publier
- Pièges connus
- Non vérifié et limites
- Documentation
- Auteur
- Licence
🎯 Vue d'ensemble
SP Music pour macOS est le lecteur natif de la bibliothèque privée servie par music.spboucher.ai sur le cluster MacLustr. Deux modes complémentaires :
- lecture en continu depuis le cluster (fichiers originaux, jamais transcodés pour l'app) ;
- téléchargement et lecture hors ligne : albums, listes ou bibliothèque entière copiés sur le Mac, lisibles sans aucune connexion.
Aucun WebView, aucun HTML : l'interface, le moteur audio, les téléchargements et la bibliothèque locale sont du code
natif. Bundle ai.spboucher.spmusic, macOS 14 ou plus récent, universel (Apple Silicon et Intel), signé Developer ID,
runtime durci.
Famille SP Music
| Dépôt | Plateforme | Rôle |
|---|---|---|
| sp-music | Web · PWA | Serveur : site, API /api/v1, worker d'import, diffusion audio, paroles |
| sp-music-macos (ce dépôt) | macOS | Client natif : copie locale du catalogue, lecture en continu et hors ligne |
| sp-music-ios | iOS · iPadOS | Client natif : même API, paquet séparé |
✨ Fonctionnalités
État détaillé, fonction par fonction (Testé / Vu / Écrit / Absent) : docs/FEATURE_MATRIX.md.
| Domaine | Ce que fait l'app |
|---|---|
| Bibliothèque | accueil (écoutés récemment, ajouts récents, hors ligne, listes), albums en grille avec 4 tris, fiches album et artiste, liste des titres |
| Recherche | locale, FTS5, accents ignorés, préfixes — fonctionne hors ligne |
| Favoris et listes | titres et albums favoris ; listes créées, renommées, complétées, ordonnées, supprimées — modifiables hors ligne, conflits sans écrasement |
| Lecture en continu | par plages d'octets dans un fichier creux, cache vérifié par SHA-256 et réutilisé |
| FLAC | recherche par plage d'octets exacte à l'échantillon (FLACIndex, FLACSliceSource) |
| Enchaînement | deux platines : piste suivante démarrée à l'échantillon exact (sans blanc) ou en fondu à puissance constante |
| Traitements | égaliseur 10 bandes, normalisation BS.1770 à −14 LUFS, « mode direct » qui les désactive d'un bloc, adaptation de la fréquence du périphérique |
| Téléchargements | titre, album, liste, bibliothèque entière ; file persistante, reprise à l'octet, SHA-256, pause / reprise / annulation, limite de téléchargements simultanés |
| Hors ligne | collections « gardées hors ligne », lecture sans aucune requête, détection de la perte et du retour du cluster |
| Paroles | synchronisées ligne à ligne, clic pour se déplacer, cache hors ligne |
| Intégration macOS | touches multimédias, widget « À l'écoute », menu du Dock, mini-lecteur, notifications, ouverture de fichiers audio locaux |
| Administration | import (fichiers, dossiers, ZIP) par morceaux, doublons, remplacement, édition d'album, pochette, suppression, santé du serveur |
| Stockage | dossier de bibliothèque déplaçable (disque externe possible), garde des suppressions |
Choix assumés
- Pas de bac à sable : la bibliothèque vit dans un dossier choisi (
~/Music, disque externe) et doit rester lisible par d'autres lecteurs. Runtime durci sans exception. - Pas de « bit-perfect » annoncé : le chemin passe par le mélangeur 32 bits flottants de Core Audio ; l'app décrit ce qu'elle fait sans prétendre connaître ce que reçoit le périphérique.
- Pas de mise à jour automatique.
🏗 Architecture
flowchart TB
UI["SwiftUI · App · Features · Components"] --> AM["AppModel"]
AM --> PC["PlaybackController"]
PC --> AE["AudioEngine"]
AE --> AV["AVAudioEngine"] --> OUT["Sortie Core Audio"]
PC -->|ResolvedSource| LS["LibrarySession"]
LS -->|"ByteSource : LocalFileSource · ProgressiveHTTPSource · FLACSliceSource"| AE
subgraph CORE["SPMusicCore (paquet SwiftPM, aucune interface)"]
LS --> ST["LibraryStore<br/>SQLite · FTS5"]
LS --> SM["StorageManager + PathGuard"]
LS --> DM["DownloadManager<br/>reprise par plage · SHA-256"]
LS --> SY["SyncEngine"]
LS --> AR["ArtworkStore"]
LS --> API["APIClient + Connectivity"]
end
API -->|HTTPS| SRV["music.spboucher.ai<br/>/api/v1"]
DM -->|"Range + If-Range"| SRV
Règles tenues
- Le moteur audio ne connaît ni les titres ni le réseau : il reçoit des sources d'octets et des jetons.
- Le moteur de téléchargement ne connaît pas le moteur audio ; il réutilise seulement un fichier complet du cache de lecture.
- La bibliothèque locale n'a jamais besoin du serveur : ouvrir une session, lister, chercher et lire un titre téléchargé ne font aucune requête (prouvé par un test qui compte les connexions).
- Rien n'est supprimé hors d'un dossier marqué par l'app, liens symboliques résolus.
Lecture
- Deux platines (lecteur → mélangeur) alimentent un pré-mélangeur, l'égaliseur, puis le mélangeur principal. La piste suivante est préparée sur l'autre platine et démarrée à l'échantillon exact où la courante se termine (pas de blanc), ou plus tôt avec une rampe à puissance constante (fondu).
- Chaque platine décode sur sa propre file : une source qui attend le réseau ne bloque jamais les commandes.
- Les rappels du lecteur AVFoundation ne prennent jamais le verrou du moteur sur un fil audio (cause de deux interblocages trouvés par les tests).
- Lecture en continu :
ProgressiveHTTPSourceécrit dans un fichier creux par requêtes de plage ; le décodeur lit ce qui est arrivé. Un saut demande les octets de la destination. Fichier complet → vérifié par SHA-256 → marqué, réutilisable. - FLAC : Core Audio se déplace dans un FLAC en le relisant depuis le début (mesuré, avec ou sans table de
recherche).
FLACIndextrouve une frontière de trame juste avant la cible (SEEKTABLE, sinon synchro de trame validée par CRC-8 et par la trame suivante) etFLACSliceSourceprésente « en-tête + audio à partir de là » au décodeur. Exact à l'échantillon. - Fidélité : aucun transcodage ; égaliseur, normalisation et fondu désactivables d'un bloc (« mode direct ») ; option pour régler la fréquence du périphérique sur celle du titre.
Synchronisation
sequenceDiagram
autonumber
participant App as SyncEngine
participant API as music.spboucher.ai
App->>API: opérations locales en attente, dans l'ordre
App->>API: GET library/sync?since=<dernière révision>
API-->>App: artistes, albums, titres modifiés + pierres tombales
App->>API: GET library/sync/me
API-->>App: listes, favoris, état de lecture
App->>API: historique d'écoute (POST puis GET)
App->>App: met en file les téléchargements des collections gardées hors ligne
Une passe : (1) envoyer les opérations locales, dans l'ordre ; (2) tirer le catalogue depuis la dernière révision vue (tout, si demandé, si plus de 24 h, ou si les compteurs divergent) ; (3) tirer listes et favoris du compte, sauf si des opérations attendent encore ; (4) historique dans les deux sens ; (5) mettre en file les téléchargements des collections « gardées hors ligne ». Aucun fichier audio n'est transféré par une synchronisation.
Conflit de liste (modifiée ici hors ligne et ailleurs) : aucune version n'est écrasée ; celle du Mac est enregistrée à côté sous « … (copie de ce Mac) » et l'utilisateur est prévenu.
Téléchargements
Octets dans <bibliothèque>/.spmusic/partial/<titre>.<asset>.part ; reprise par Range + If-Range sur
l'identifiant de l'asset ; taille puis SHA-256 vérifiés avant un déplacement atomique vers le nom lisible. L'état est
en base : une fermeture ou un plantage ne perd rien. Un fichier remplacé sur le cluster est retéléchargé ; un titre
supprimé du cluster mais téléchargé ici est conservé et signalé.
🧱 Pile technique
| Couche | Technologie | Version | Rôle |
|---|---|---|---|
| Langage | Swift (swift-tools-version 6.0, mode de langage 6) |
6.0 | concurrence stricte complete, isolation par défaut MainActor dans l'app |
| Interface | SwiftUI + AppKit | macOS 14+ | fenêtres, barre latérale, lecteur, réglages |
| Audio | AVAudioEngine · Core Audio | système | décodage, deux platines, égaliseur, mélangeur |
| Persistance | SQLite (bibliothèque système sqlite3) + FTS5 |
système | bibliothèque locale, recherche |
| Réseau | URLSession (APIClient, HTTPByteStream) |
système | JSON, plages d'octets |
| Authentification | AuthenticationServices · Trousseau | système | clé d'accès, session |
| Système | MediaPlayer, notifications | système | « À l'écoute », touches multimédias |
| Paquet | SwiftPM SPMusicCore (bibliothèque) + spmusic-cli (point d'entrée provisoire) |
— | cœur sans interface, testable seul |
| Projet | XcodeGen (project.yml) |
— | SPMusic.xcodeproj n'est pas versionné |
| Distribution | Developer ID · notarytool · DMG |
— | signature, notarisation, agrafage |
Aucune dépendance tierce : Package.swift ne déclare aucun paquet externe.
🗂 Organisation du dépôt
Package.swift paquet SwiftPM « SPMusicCore » (aucune interface) + tests
project.yml définition XcodeGen de l'app (SPMusic.xcodeproj n'est pas versionné)
Core/ 24 fichiers — le cœur
├── Audio/ AudioEngine, AudioDecoder, AudioQueue, AudioOutputManager, ByteSource, FLACSeeker, LoudnessAnalyzer, PlaybackController
├── Networking/ APIClient, AdminAPI, Connectivity, HTTPByteStream
├── Authentication/ AuthService
├── Downloads/ DownloadManager
├── Offline/ LibrarySession, StorageManager
├── Persistence/ LibraryStore, SQLite
├── Synchronization/ SyncEngine, WireModels
├── Metadata/ ArtworkStore, Models
└── Security/ Keychain, PathGuard
App/ point d'entrée, AppDelegate, AppEnvironment, AppSettings, intégrations macOS (Notifier, NowPlayingBridge, PasskeySignIn)
Features/ Home · Library · Albums · Artists · Playlists · Search · NowPlaying · Downloads · Settings · Administration · Welcome
Components/ AlbumCard · TrackRow · PlayerBar · ArtworkView · SidebarView · Common
Resources/ Info.plist, droits (Release et Debug), catalogue d'assets, icône
Tests/CoreTests/ 42 tests + proxy de pannes (FaultProxy), fixtures, support du backend de test
Tools/spmusic-cli/ point d'entrée en ligne de commande (provisoire)
Scripts/ build, tests, backend de test, release, notarisation, en-têtes d'auteur
docs/ ARCHITECTURE.md · FEATURE_MATRIX.md · TEST_REPORT.md · brand/| Dossier | Fichiers Swift | Lignes |
|---|---|---|
Core/ |
24 | 4 638 |
Features/ |
11 | 1 715 |
Tests/ |
10 | 1 412 |
App/ |
7 | 1 131 |
Components/ |
6 | 686 |
Tools/ |
1 | 4 |
| Total | 61 | 9 622 |
🚀 Construire et tester
Le projet Xcode est généré par XcodeGen depuis project.yml.
Scripts/build.sh # génère le projet et construit l'app Debug
Scripts/backend-dev.sh start # vrai backend de test local (clone de sp-music.git dans ~/dev/sp-music-testbed, PostgreSQL, ffmpeg)
Scripts/t.sh # tous les tests du cœur ; Scripts/t.sh <filtre> [secondes]
Scripts/run-dev.sh --shot /tmp/x.png -- -SPMusicRoute albums # lance le build Debug sur le backend de test, muet, et capture la fenêtre
Scripts/make-icon.sh # régénère l'icône depuis le SVG
Scripts/check-headers.sh # en-têtes d'auteurTous les scripts
| Script | Rôle |
|---|---|
Scripts/build.sh |
génère le projet Xcode et construit l'app Debug (erreurs seulement sur la console) |
Scripts/t.sh [filtre] [secondes] [lignes] |
swift test avec filtre et limite de temps, n'affiche que les verdicts |
Scripts/backend-dev.sh start|stop |
vrai backend SP Music local pour les tests fonctionnels : code du cluster, base PostgreSQL propre, stockage propre, vrai ffmpeg, vrai worker (port 8695 par défaut) |
Scripts/dev-session.sh |
affiche un jeton de session du backend de test, obtenu par les vraies routes d'association d'appareil ; ne touche jamais la production |
Scripts/run-dev.sh [--shot out.png] [--wait s] [--keep] [--fresh] [--no-server] [-- args…] |
lance le build Debug sur le backend de test, avec ses propres dossiers, muet, et capture sa fenêtre |
Scripts/window-shot.swift |
capture de la fenêtre de l'app |
Scripts/make-icon.sh |
rend le SVG de l'icône dans le catalogue d'assets (toutes les tailles macOS) |
Scripts/add-headers.py · Scripts/check-headers.sh |
ajoute / vérifie l'en-tête d'auteur (Author / File / Description) |
Scripts/asc.py |
client minimal de l'API App Store Connect (clé existante) |
Scripts/provision.py |
identifiant d'app, Associated Domains, profil Developer ID — idempotent |
Scripts/release.sh |
archive Release signée → dist/SP Music.app |
Scripts/verify-release.sh [app] |
signature, runtime durci, droits, profil, pas de moteur web, pas de droit de débogage, pas de secret |
Scripts/notarize.sh |
notarisation, agrafage, DMG signé + notarisé |
⚙️ Configuration
Build (project.yml)
| Réglage | Valeur |
|---|---|
MARKETING_VERSION · CURRENT_PROJECT_VERSION |
1.0.0 · 1 |
SWIFT_VERSION · SWIFT_STRICT_CONCURRENCY |
6.0 · complete |
| Cible de déploiement | macOS 14.0 |
| Identifiant Release · Debug | ai.spboucher.spmusic · ai.spboucher.spmusic.debug |
| Signature Release | manuelle, Developer ID Application, profil « SP Music Developer ID », --timestamp |
| Signature Debug | locale, sans profil ni droit restreint (pas d'Associated Domains) ; identifiant distinct pour qu'une copie de développement ne masque jamais l'app installée pour les clés d'accès |
ENABLE_HARDENED_RUNTIME |
YES |
| Langue de développement | fr |
Variables d'environnement des tests et scripts (noms seulement)
| Variable | Rôle |
|---|---|
SPMUSIC_TEST_URL · SPMUSIC_TEST_PORT · SPMUSIC_TEST_DB |
backend de test |
SPMUSIC_TESTBED · SPMUSIC_TEST_SCRIPT |
emplacement du clone de test et de son script |
SPMUSIC_REAL_FLAC |
fichier FLAC réel pour le test de recherche par plage (sinon ignoré) |
SPMUSIC_PROD_URL · SPMUSIC_PROD_TOKEN |
test de fumée en lecture seule contre la production (sinon ignoré) |
NOTARY_PROFILE |
profil trousseau de notarytool (défaut : MacLustr-Notarize) |
Arguments de lancement (développement et tests fonctionnels, build Debug)
| Argument | Effet |
|---|---|
-SPMusicServer <url> |
serveur |
-SPMusicDataDir <dossier> · -SPMusicLibraryRoot <dossier> |
dossiers de données et de bibliothèque |
-SPMusicDevToken <jeton> |
session de développement |
-SPMusicRoute albums|artists|tracks|downloads|admin|album:<id>|nowplaying |
écran d'ouverture |
-SPMusicPlay <titre> · -SPMusicSeek <secondes> · -SPMusicShowNowPlaying |
lecture automatique |
-SPMusicDownloadAlbum <album> |
téléchargement automatique |
🖥 Écrans
| Écran | Dossier | État (v1.0.0) |
|---|---|---|
| Bienvenue / connexion | Features/Welcome |
Vu |
| Accueil | Features/Home |
Vu |
| Albums et fiche album | Features/Albums |
Vu |
| Artistes et fiche artiste | Features/Artists |
Écrit (liste testée côté base) |
| Titres | Features/Library |
Écrit (requêtes testées) |
| Listes de lecture | Features/Playlists |
données Testées, écran Écrit |
| Recherche | Features/Search |
recherche Testée, écran Écrit |
| Lecture en cours | Features/NowPlaying |
Vu |
| Téléchargements | Features/Downloads |
Vu |
| Réglages | Features/Settings |
Écrit |
| Administration | Features/Administration |
API Testée, écran Écrit |
Légende (docs/FEATURE_MATRIX.md) — Testé : couvert par un test automatisé réel ·
Vu : constaté dans l'app lancée · Écrit : implémenté, compilé, jamais exercé.
🔌 Backend et API
Les ajouts côté serveur (synchronisation incrémentale, association d'appareil, historique, fichier
apple-app-site-association) sont dans le dépôt sp-music (migration
003_native_clients.sql, docs/ARCHITECTURE.md § Clients natifs). Le site web n'est pas modifié dans son
comportement.
| Route du serveur | Usage dans l'app |
|---|---|
GET /api/v1/library/sync?since=<rev> |
catalogue incrémental et pierres tombales |
GET /api/v1/library/sync/me |
listes, favoris, état de lecture |
GET · POST /api/v1/library/history |
historique d'écoute dans les deux sens |
PATCH playlists/:id · PUT playlists/:id/order (baseUpdatedAt) |
détection des conflits de liste (409) |
POST /api/v1/auth/device/{start,poll} |
association avec le navigateur |
GET /api/v1/stream/<id> (Range) |
lecture en continu et téléchargement |
GET /api/v1/art/<id> |
pochettes |
/api/v1/admin/* |
import, édition d'album, santé (AdminAPI.swift) |
💾 Données locales
- Musique téléchargée :
~/Music/SP Music/<compte>/<Artiste>/<Album (année)>/01 Titre.flac(dossier modifiable dans Réglages › Stockage, disque externe possible). Ce sont les originaux du cluster, vérifiés par SHA-256, lisibles par n'importe quel lecteur. Un fichier.spmusic/library.jsonmarque le dossier ; l'app ne supprime jamais rien en dehors. - Base locale, pochettes, cache de lecture :
~/Library/Application Support/SP Music/Accounts/<serveur>_<compte>/. - Session : dans le trousseau. Se déconnecter n'efface pas la musique téléchargée.
🔑 Connexion
- Clé d'accès (AuthenticationServices) : même vérification serveur que le navigateur. Demande le droit
com.apple.developer.associated-domains(profil Developer ID) et l'app installée dans/Applications. - Association avec le navigateur : l'app affiche un code, un navigateur déjà connecté l'approuve sur
https://music.spboucher.ai/appareil, l'app reçoit sa propre session (révocable dans « Compte » sur le site).
🔐 Sécurité et vie privée
- Session dans le trousseau (
Core/Security/Keychain.swift) ; droitwebcredentials:music.spboucher.aipour les clés d'accès. PathGuard: aucune suppression hors d'un dossier marqué par l'app (.., liens symboliques, marqueur).- Chaque fichier téléchargé est vérifié (taille puis SHA-256) avant installation ; un fichier corrompu n'est jamais installé.
- Runtime durci sans exception ; App Transport Security limité au réseau local (
NSAllowsLocalNetworking) pour le backend de test. - Une session révoquée laisse la musique locale lisible.
Scripts/verify-release.shvérifie l'absence de moteur web, de droit de débogage et de secret dans le bundle.- Aucun certificat n'est créé par les scripts ; aucun identifiant n'est affiché.
✅ Tests
Rapport complet : docs/TEST_REPORT.md — v1.0.0 (1), 18 novembre 2026 : 42 tests
automatisés, 40 réussis, 2 ignorés (fichier FLAC réel absent ; fumée production sans jeton), en 17 s, 10 exécutions
consécutives sans échec.
| Fichier | Tests | Portée |
|---|---|---|
ClusterTests.swift |
11 | association d'appareil, synchronisation, téléchargements, modifications hors ligne |
StreamingAndOfflineTests.swift |
8 | lecture en continu, hors ligne sans connexion, stockage |
UnitTests.swift |
8 | cœur sans réseau |
AudioTests.swift |
7 | formats, moteur, enchaînement sans blanc, mesure du niveau |
FLACSeekTests.swift |
4 | recherche FLAC par plage |
AdminTests.swift |
3 | import, édition, santé, 403 pour un auditeur |
ProductionSmokeTests.swift |
1 | fumée en lecture seule contre la production |
| Total | 42 |
Les tests d'intégration parlent à un vrai serveur (le code du cluster, sa base, son worker) à travers un proxy TCP
qui produit de vraies pannes (coupure, lenteur, corruption). Ils sont ignorés quand le backend de test ne tourne pas.
Le test de fumée contre la production est en lecture seule et ne tourne que si on lui fournit une session
(SPMUSIC_PROD_URL, SPMUSIC_PROD_TOKEN).
Ce qui est vérifié, par domaine
| Domaine | Vérifié |
|---|---|
| Formats | FLAC 16 et 24 bits, ALAC, WAV, AIFF, MP3, AAC : ouverts, décodés (fréquence du signal mesurée), déplacement exact ; faux fichier refusé |
| Moteur | lecture, pause, déplacement, volume, gain de normalisation et mode direct, enchaînement sans blanc (signal continu ± 20 ms sur 4 s), enchaînement 44,1 → 96 kHz |
| Recherche FLAC par plage | exacte à l'échantillon sur 4 positions + fin de fichier, moins du quart du fichier lu, avec et sans SEEKTABLE |
| Connexion | association d'appareil réelle, jeton inconnu refusé, session révoquée détectée |
| Synchronisation | première synchro complète, suivantes vides, renommage, suppressions, historique dans les deux sens |
| Téléchargements | album complet vérifié SHA-256 ; coupure à 3 Mo → reprise à l'octet exact ; fermeture de l'app → reprise au relancement ; octet corrompu → jamais installé |
| Hors ligne | serveur coupé : parcourir, chercher, lire deux titres enchaînés avec 0 connexion |
| Lecture en continu | son avant l'arrivée du fichier, saut loin devant par requête de plage, copie complète vérifiée ; coupure courte surmontée seule |
| Modifications hors ligne | liste créée, complétée, renommée, favoris → envoyés au retour ; conflit → deux versions conservées + avis |
| Stockage | déplacement de la bibliothèque, dossier occupé refusé, disque débranché sans perte ; garde des chemins |
| Administration | import par morceaux d'un vrai fichier, doublon reconnu, édition d'album, pochette, santé, suppression |
| Mesure du niveau | écart ≤ 0,3 LU avec ffmpeg ebur128 sur bruit rose et sinus |
| Grande bibliothèque | 72 000 titres synchronisés en 1,6 s ; 6 000 albums listés en 21 ms ; recherche en 11 ms |
Bogues trouvés par les tests et corrigés : en-tête User-Agent non ASCII quand le nom du Mac contient un accent ;
deux interblocages du moteur audio ; index de recherche en O(n²) à la première synchronisation ; garde des chemins
contournable par un lien symbolique vers un fichier inexistant ; relecture complète d'un FLAC pour s'y déplacer ;
plantage au premier « À l'écoute » ; fiches album, artiste et liste restées vides.
📦 Publier
python3 Scripts/provision.py # identifiant d'app + Associated Domains + profil Developer ID (clé App Store Connect existante ; idempotent)
Scripts/release.sh # archive Release signée → dist/SP Music.app
Scripts/verify-release.sh # signature, droits, natif seulement, pas de secret
Scripts/notarize.sh # notarisation Apple (profil trousseau « MacLustr-Notarize »), agrafage, DMG signé + notarisé + SHA-256Aucun certificat n'est créé par ces scripts ; aucun identifiant n'est affiché.
État de la v1.0.0 (tag v1.0.0, d'après docs/TEST_REPORT.md) : archive Release universelle (arm64 + x86_64),
signature Developer ID, runtime durci, profil avec Associated Domains ; notarisation Accepted pour l'app et pour
le DMG, tickets agrafés ; spctl : « Notarized Developer ID ».
🩺 Pièges connus
| Piège | Remède dans le code |
|---|---|
| Core Audio relit tout un FLAC pour s'y déplacer, même avec SEEKTABLE | FLACIndex + FLACSliceSource (Core/Audio/FLACSeeker.swift) |
| Rappel du lecteur AVFoundation attendant le verrou du moteur → interblocage | les rappels ne prennent jamais le verrou ; reconnexion d'une platine hors verrou |
| Rappels MediaPlayer appelés hors du fil principal (plantage au premier « À l'écoute ») | corrigé dans App/Integration/NowPlayingBridge.swift |
En-tête User-Agent non ASCII (nom du Mac avec accent ou apostrophe typographique) |
nom ramené en ASCII |
| Index FTS5 en O(n²) à la première grande synchronisation | index par rowid de la piste |
| Lien symbolique vers un fichier qui n'existe pas encore | PathGuard résout l'ancêtre existant |
| Fiche restée vide (tâche attachée à un conteneur vide) | corrigé dans les vues de fiche |
| Clé d'accès indisponible en Debug | normal : le build Debug n'a pas le droit Associated Domains ; utiliser l'association avec le navigateur ou Scripts/dev-session.sh |
⚠️ Non vérifié et limites
Repris de docs/TEST_REPORT.md et de docs/FEATURE_MATRIX.md :
- Connexion par clé d'accès dans l'app : le droit, le profil et le fichier d'association sont en place, l'échange n'a jamais eu lieu.
- Aucune écoute humaine : tout a joué volume à zéro ou en rendu hors ligne.
- Fondu enchaîné, égaliseur, adaptation de la fréquence du périphérique, changement ou débranchement de sortie, veille : écrits, jamais exercés.
- Touches multimédias, widget « À l'écoute », menu du Dock, mini-lecteur, raccourcis configurables, ouverture de fichiers, glisser-déposer, notifications : écrits, jamais exercés.
- Écrans d'administration, de réglages, artistes, titres, favoris, historique, liste de lecture, recherche : compilés ; leurs données et leurs API sont testées, les écrans n'ont pas été parcourus.
- Téléchargement de toute la bibliothèque réelle ; Ogg, Opus, DSD (aucun titre) ; paroles réelles dans la vue.
- Autre Mac, tranche Intel, macOS 14 à 26, VoiceOver, profilage Instruments.
- Absent de cette version : interface en anglais (français seulement), thème d'accent, édition titre par titre et réordonnancement d'un album, gestion des comptes, journal d'audit et correction des paroles (à faire sur le site).
📚 Documentation
docs/ARCHITECTURE.md— couches, règles tenues, lecture, synchronisation, téléchargementsdocs/FEATURE_MATRIX.md— parité avec le site et état par fonctiondocs/TEST_REPORT.md— ce qui a tourné, bogues corrigés, non vérifié
👤 Auteur
Simon-Pierre Boucher — conception, développement, exploitation
www.spboucher.ai · git.spboucher.ai · contact@spboucher.ai
📄 Licence
Le dépôt ne contient pas de fichier de licence. Tous droits réservés © 2026 Simon-Pierre Boucher.