Préparer la migration frontend vers Node — désactivée par défaut #1

Merged
nico merged 1 commit from nico/fix/php-gateway-auth into main 2026-10-10 16:35:40 +00:00 AGit
Owner

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.
## 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.
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 flaky Chromium CI tests
All checks were successful
CI / tests (pull_request) Successful in 2m3s
88a9c54179
nico force-pushed nico/fix/php-gateway-auth from 88a9c54179
All checks were successful
CI / tests (pull_request) Successful in 2m3s
to 80b33056b5
Some checks failed
CI / tests (pull_request) Failing after 2m28s
2026-10-10 16:32:59 +00:00
Compare
nico merged commit fee94acf15 into main 2026-10-10 16:35:40 +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!1
No description provided.