SPB Git

Repository Public

AUDIT.md 4.1 KB

# 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).
Files main
Menu

Theme