SPB Git

Repository Public

AUDIT.md 4.1 KB 51 lines markdown

1<!--2SP Music iOS3File: docs/AUDIT.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Audit de l'existant et matrice de parité (2026-11-17)89## Ce qui existait1011| Sujet | Constat |12|---|---|13| Site | `music.spboucher.ai`, app mld `sp-music` sur m5ma:8690 (Next 16, PostgreSQL 17, worker ffmpeg). Dépôt spbgit `sp-music.git`. |14| 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). |15| Stockage | Originaux jamais modifiés (`originals/<aa>/<sha256>.<ext>`), pochettes dédupliquées (96 / 320 / 640 px), rendu AAC 256 kbit/s à la demande. |16| Diffusion | `GET /api/v1/stream/<id>[?v=compat]`, `Range` → 206, `ETag`, servie par Node natif (longueurs exactes). |17| 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. |18| Hors ligne côté web | Aucun (pas de service worker). |19| **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. |20| 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. |2122Incident à 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.2324## Parité fonctionnelle2526| Fonction | Web | macOS (autre projet, en cours) | iOS / iPadOS |27|---|---|---|---|28| Parcourir albums, artistes, titres | oui | — | oui |29| Recherche | serveur | — | locale, hors ligne comprise |30| Listes de lecture (créer, renommer, ordonner, supprimer) | oui | — | oui (en ligne) |31| Favoris | oui | — | oui, mis en file hors ligne |32| Diffusion de l'original, repli AAC | oui | — | oui |33| File d'attente, aléatoire, répétition | oui | — | oui (mêmes règles) |34| Reprise de la file entre appareils | oui | — | oui |35| Paroles synchronisées | mot à mot | — | ligne à ligne |36| Commandes système (écran verrouillé, casque) | Media Session | — | oui, natives |37| **Téléchargement et lecture hors ligne** | non | — | **oui** |38| Historique d'écoute | non | — | oui (envoyé au serveur) |39| Connexion par clé d'accès | oui | — | oui (native) |40| Association d'appareil par code | page d'approbation | — | oui |41| Administration (import, édition des tags, comptes) | oui | — | non — reste sur le site |42| CarPlay | — | — | code livré, droit Apple à obtenir |43| Égaliseur, fondu, normalisation | non | — | non |4445## Configuration Apple constatée4647- Xcode 27.2, SDK iOS 27.2 ; simulateurs iOS 26.5.48- 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/`.49- Créés automatiquement lors de l'archive : identifiant `ai.spboucher.spmusic.ios` avec la capacité Associated Domains, profils de développement et App Store.50- 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).51
Files main
Menu

Theme