# Audit de l'existant et matrice de parité (2026-11-17)
# Ce qui existait
| Sujet |
Constat |
| Site |
music.spboucher.ai, app mld sp-music sur m5ma:8690 (Next 16, PostgreSQL 17, worker ffmpeg). Dépôt spbgit sp-music.git. |
| Bibliothèque |
875 titres, 59 albums, 32 artistes, 24 Go — tout en FLAC (844 en 16/44,1 ; 17 en 24/44,1 ; 14 en 24/48). |
| Stockage |
Originaux jamais modifiés (originals/<aa>/<sha256>.<ext>), pochettes dédupliquées (96 / 320 / 640 px), rendu AAC 256 kbit/s à la demande. |
| Diffusion |
GET /api/v1/stream/<id>[?v=compat], Range → 206, ETag, servie par Node natif (longueurs exactes). |
| Authentification |
Clés d'accès WebAuthn (RP music.spboucher.ai), session par cookie spmusic_session (30 jours), jeton CSRF sur les écritures, codes de récupération. |
| Hors ligne côté web |
Aucun (pas de service worker). |
| Application macOS |
Elle n'existait pas au début du travail. Une autre session la construisait en parallèle (~/Desktop/Cluster/apple/SPMusic) ; son cœur Swift n'était qu'un squelette lié à Core Audio macOS, donc rien de réutilisable : ce projet a son propre paquet SPMusicCore, écrit pour iOS et macOS afin que les deux puissent converger. |
| API pour clients natifs |
Ajoutée le même soir par la session macOS (branche native-api, en production) : library/sync?since= (révisions + pierres tombales, SHA-256 et taille de chaque fichier), library/sync/me, library/history, auth/device/*, /.well-known/apple-app-site-association. L'app iOS réutilise ces services ; elle n'ajoute rien au backend. |
Incident à signaler : avant de découvrir cette branche, j'avais commencé des ajouts équivalents dans le clone de production (non commités). Un déploiement de l'autre session les a embarqués à 22 h 40 (une table plays vide créée en production). Je les ai retirés (fichiers restaurés, table vide supprimée, ligne de migration effacée) et la session macOS a ensuite déployé sa propre version. État final de la production : uniquement son code.
# Parité fonctionnelle
| Fonction |
Web |
macOS (autre projet, en cours) |
iOS / iPadOS |
| Parcourir albums, artistes, titres |
oui |
— |
oui |
| Recherche |
serveur |
— |
locale, hors ligne comprise |
| Listes de lecture (créer, renommer, ordonner, supprimer) |
oui |
— |
oui (en ligne) |
| Favoris |
oui |
— |
oui, mis en file hors ligne |
| Diffusion de l'original, repli AAC |
oui |
— |
oui |
| File d'attente, aléatoire, répétition |
oui |
— |
oui (mêmes règles) |
| Reprise de la file entre appareils |
oui |
— |
oui |
| Paroles synchronisées |
mot à mot |
— |
ligne à ligne |
| Commandes système (écran verrouillé, casque) |
Media Session |
— |
oui, natives |
| Téléchargement et lecture hors ligne |
non |
— |
oui |
| Historique d'écoute |
non |
— |
oui (envoyé au serveur) |
| Connexion par clé d'accès |
oui |
— |
oui (native) |
| Association d'appareil par code |
page d'approbation |
— |
oui |
| Administration (import, édition des tags, comptes) |
oui |
— |
non — reste sur le site |
| CarPlay |
— |
— |
code livré, droit Apple à obtenir |
| Égaliseur, fondu, normalisation |
non |
— |
non |
# Configuration Apple constatée
- Xcode 27.2, SDK iOS 27.2 ; simulateurs iOS 26.5.
- Identités locales : « Apple Development » (×2) et « Developer ID Application » (macOS, sans rapport avec iOS). Pas de certificat « Apple Distribution » local : la signature de distribution est faite par le certificat géré par Apple, via la clé de l'API App Store Connect déjà présente dans
~/.appstoreconnect/private_keys/.
- Créés automatiquement lors de l'archive : identifiant
ai.spboucher.spmusic.ios avec la capacité Associated Domains, profils de développement et App Store.
- Fiche App Store Connect « SP Music » (n° 6836172581) créée par la session Safari du propriétaire, à sa demande (l'API publique ne le permet pas).