fix/php-gateway-auth #2

Merged
nico merged 3 commits from fix/php-gateway-auth into main 2026-10-10 15:11:09 +00:00
Owner
No description provided.
feat: prepare opt-in Node recommendation transport
Some checks failed
CI / tests (push) Failing after 3m51s
CI / tests (pull_request) Failing after 2m24s
8b9e17994e
## Résumé

Le frontend répartit actuellement les recommandations Node et la télémétrie PHP entre plusieurs chemins. Cette PR prépare un parcours Node partagé et testable, préserve les événements non confirmés et évite les retours accidentels vers la passerelle PHP.

**Préparation technique validée localement : `recommendationsNodeMigrationEnabled` reste `false` par défaut. Aucun déploiement ni activation en production.** Le backend réel n'est pas modifié.

## Modifications réalisées

- Client API partagé : URL configurable, timeout de 10 secondes par défaut, erreurs contrôlées, refus des URL PHP héritées et des redirections HTTP.
- Transport historique des recommandations et retours utilisateur conservé pour les sessions qui n'ont jamais activé la migration. Le client partagé n'est utilisé pour les recommandations qu'après activation explicite du flag.
- Parcours Node de télémétrie : `POST /api/events/recommendation`, lots de 100 au maximum, événement original préservé intégralement dans `payload` et identifiant stable dans `eventUid`.
- Acquittement uniquement des IDs explicitement confirmés et présents dans le lot envoyé ; déduplication des IDs de réponse. Les réponses 401/500, timeouts, acquittements partiels et échecs de stockage des acquittements laissent les événements non confirmés en attente.
- Pas de boucle autonome de reprise : une nouvelle tentative dépend d'une action ultérieure, d'un nouvel événement ou du retour en ligne. Un lot réussi ne vide pas automatiquement tout le backlog.
- Propriétaire de routage local enregistré séparément du payload et capturé avant l'envoi asynchrone. Envoi, lecture, déduplication et effacement locaux isolés entre comptes pour les files protégées. Cette association n'est pas une preuve d'identité.
- Événements historiques sans propriétaire conservés sans envoi ni attribution automatique, avec le code `recommendations_event_owner_unverified`.
- Protection persistante après retour arrière du flag : les événements en attente survivent à la limite habituelle de 800 entrées ; les règles d'acquittement et de propriété sont conservées. Les migrations d'alias sont évitées pour les files protégées.
- Aucun appel d'identité/alias, aucune lecture d'alias historiques et aucun secours PHP dans le parcours Node, même si le client est absent, incomplet ou en échec. Les retours « masquer » utilisent la file commune après activation.
- Chargement du client dans les sept pages musicales et lors des transitions internes ; renouvellement du cache PWA. Suppression d'une référence de précache préexistante vers un fichier inexistant, qui bloquait l'installation du service worker.
- Tests unitaires de migration et du feature flag, faux backend local configurable et tests Chromium sur deux origines loopback. Proxy de refus sans relais, blocage DNS, CSP et protections WebRTC/QUIC empêchent l'accès externe de ces tests.
- Ajout de `test:migration:local` à `test:ci` et `test:all`. Les smoke tests existants bloquent aussi les requêtes HTTP/WebSocket lorsque `NICO_TEST_OFFLINE=1`.

## Corrections supplémentaires issues de la revue

- Propriétaire du lot figé avant la microtâche réseau : un changement de compte pendant l'envoi ne réattribue pas les événements.
- Quarantaine des événements sans propriétaire, au lieu d'une adoption implicite par le compte courant.
- Refus des redirections pour empêcher un accès indirect au PHP.
- Isolation de la déduplication et de l'effacement local par compte.
- Échec explicite si la persistance du marqueur de protection, du propriétaire ou des acquittements échoue.
- Compteurs d'acquittement uniques et indication du backlog restant ; attentes CDP bornées dans les nouveaux outils de test.

## Tests effectués

| Commande | Résultat local |
|---|---|
| `git diff --check` | Réussi |
| `npm run test:migration:local` | 15 scénarios Chromium réussis, faux backend uniquement |
| `NICO_TEST_OFFLINE=1 npm run test:ci` | Réussi : contrôle qualité, tests recommandations hors ligne, 110 fichiers unitaires, 70 répétitions critiques, responsive bibliothèque/artistes, smoke Chromium et 15 scénarios de migration |
| `npm run check` | Réussi |
| `php -l api/aergie.php` | Aucune erreur de syntaxe ; fichier PHP inchangé |
| Tests ciblés migration et feature flag | Réussis |

`recommendation-model-config.test.js` reste exclu par le runner existant : ce test historique demande une modification de réglage de l'algorithme, hors périmètre. Aucune exclusion supplémentaire n'est introduite. Il n'existe pas de commande build ou lint ESLint déclarée ; `check` fournit les contrôles syntaxiques et de qualité du dépôt.

Tous les tests de cette validation utilisent des fixtures/faux services locaux. Aucun test réel avec clé API, aucune écriture sur le backend réel et aucun appel aux services musicaux de production pendant cette phase. Les scripts temporaires de tests réels, clés, profils navigateur et journaux ne sont pas inclus dans le commit.

## Sécurité et limites

- **Migration désactivée par défaut.** PR prête pour une revue humaine, pas pour une activation en production.
- Authentification et autorisation du vrai backend non validées. `userKey` est une donnée de routage contrôlée par le client, jamais une preuve d'identité. Aucun contournement ni secret frontend ajouté.
- La provenance des événements historiques sans propriétaire reste inconnue ; ils sont retenus, pas envoyés. Une procédure séparée est nécessaire pour leur disposition.
- `localStorage` peut être indisponible ou saturé. Les échecs sont signalés, mais le frontend ne peut garantir la durabilité d'un stockage navigateur qui refuse les écritures. Une réponse reçue avant un échec de sauvegarde d'acquittement peut conduire à un renvoi du même ID.
- Un premier lot définitivement refusé peut bloquer les événements suivants. La PR ne supprime ni ne contourne automatiquement ces événements.
- La déduplication et la durabilité MySQL réelles ne sont pas validées. Les tests locaux ne prouvent pas les garanties du déploiement, de son proxy ni de sa politique CORS/authentification.
- La télémétrie PHP historique reste présente ; les sessions jamais migrées conservent leurs comportements historiques, y compris leurs limites préexistantes.

## Activation future — conditions obligatoires

- [ ] Valider l'authentification et les autorisations par compte du backend réel.
- [ ] Valider CORS, les credentials et le proxy avec un compte dédié, sans accès aux données d'autres comptes.
- [ ] Définir une disposition vérifiée des événements historiques sans propriétaire.
- [ ] Vérifier unicité des IDs, déduplication et acquittements durables MySQL.
- [ ] Définir la récupération après quota navigateur et refus permanent du premier lot.
- [ ] Valider changement de compte et retour arrière sur le déploiement cible.
- [ ] Obtenir une autorisation distincte avant d'activer la migration en production.
fix: deduplicate Daily Mix album cards
Some checks failed
CI / tests (push) Has been cancelled
CI / tests (pull_request) Has been cancelled
d71e92c495
fix
Some checks failed
CI / tests (push) Successful in 3m22s
CI / tests (pull_request) Failing after 5m17s
640f0e5aa9
nico merged commit e7b974fffd into main 2026-10-10 15:11:09 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nico/music!2
No description provided.