feat: synchroniser main dans Electron pour Hyprland #5

Merged
nico merged 7 commits from nico/feat/electron-sync-main into electron 2026-10-14 21:18:43 +00:00 AGit
Owner

La branche Electron ne contenait pas les dernières fonctionnalités de main. Cette PR fusionne main (8b6ca81) dans electron et adapte leur exécution desktop sous Hyprland.

  • Ajout de la radio lo-fi Pasithee, de ses réglages et du lecteur live partagé.
  • Correction des doublons de cartes Daily Mix et intégration du transport Node optionnel des recommandations, toujours désactivé par défaut.
  • Conservation de la détection Hyprland/Wayland, des options X11, du preload et des réglages GPU/WebGL.
  • Chargement des fichiers embarqués sous l’origine HTTPS autorisée https://dev.nic0.org, avec protections web actives, pour permettre le cookie Strict/HttpOnly de la radio. Le transport radio conserve Origin, CSRF et credentials et annule effectivement les flux SSE fermés.
  • Navigation interne conservée dans Electron ; liens externes ouverts dans le navigateur. Ancien mode local disponible via npm run desktop:file.
  • Test PWA corrigé pour vérifier le cache courant plutôt qu’un ancien nom figé. Documentation desktop dans electron/README.md.

Changement au premier lancement : l’origine de stockage change depuis file://, donc une reconnexion avec la clé LMS personnelle est nécessaire. Aucune migration automatique des secrets. La radio exige une session personnelle, pas une session proxy seule.

Validation : CI locale complète verte : 115 fichiers de tests réussis, 1 exclusion préexistante, scénarios critiques répétés, responsive bibliothèque/artiste, smoke Chromium avec radio et décodage MP3, 15 scénarios migration/PWA. Tests runtime Electron Hyprland/Wayland/X11 et contrôle des chemins locaux. Test dans Electron 42.11.6 headless avec profil jetable et API TLS sur loopback : cookie Strict/HttpOnly, Origin, CSRF, SSE et fermeture du flux, MP3, navigation avec conservation du lecteur, suppression du cookie au logout. Réseau externe bloqué pendant ce test.

Le test Electron ignore les certificats uniquement pour sa fixture locale auto-signée ; le lancement produit conserve la vérification TLS normale. Pas de validation d’une session graphique Hyprland réelle ni d’authentification sur les services de production. Aucun déploiement et aucune activation de la migration Node.

La branche Electron ne contenait pas les dernières fonctionnalités de main. Cette PR fusionne main (`8b6ca81`) dans electron et adapte leur exécution desktop sous Hyprland. - Ajout de la radio lo-fi Pasithee, de ses réglages et du lecteur live partagé. - Correction des doublons de cartes Daily Mix et intégration du transport Node optionnel des recommandations, toujours désactivé par défaut. - Conservation de la détection Hyprland/Wayland, des options X11, du preload et des réglages GPU/WebGL. - Chargement des fichiers embarqués sous l’origine HTTPS autorisée `https://dev.nic0.org`, avec protections web actives, pour permettre le cookie Strict/HttpOnly de la radio. Le transport radio conserve Origin, CSRF et credentials et annule effectivement les flux SSE fermés. - Navigation interne conservée dans Electron ; liens externes ouverts dans le navigateur. Ancien mode local disponible via `npm run desktop:file`. - Test PWA corrigé pour vérifier le cache courant plutôt qu’un ancien nom figé. Documentation desktop dans `electron/README.md`. **Changement au premier lancement :** l’origine de stockage change depuis `file://`, donc une reconnexion avec la clé LMS personnelle est nécessaire. Aucune migration automatique des secrets. La radio exige une session personnelle, pas une session proxy seule. **Validation :** CI locale complète verte : 115 fichiers de tests réussis, 1 exclusion préexistante, scénarios critiques répétés, responsive bibliothèque/artiste, smoke Chromium avec radio et décodage MP3, 15 scénarios migration/PWA. Tests runtime Electron Hyprland/Wayland/X11 et contrôle des chemins locaux. Test dans Electron 42.11.6 headless avec profil jetable et API TLS sur loopback : cookie Strict/HttpOnly, Origin, CSRF, SSE et fermeture du flux, MP3, navigation avec conservation du lecteur, suppression du cookie au logout. Réseau externe bloqué pendant ce test. Le test Electron ignore les certificats uniquement pour sa fixture locale auto-signée ; le lancement produit conserve la vérification TLS normale. Pas de validation d’une session graphique Hyprland réelle ni d’authentification sur les services de production. Aucun déploiement et aucune activation de la migration Node.
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
Merge branch 'fix/php-gateway-auth'
Some checks failed
CI / tests (push) Failing after 3m32s
61f5db04b6
feat: lofi radio
Some checks failed
CI / tests (push) Failing after 2m28s
CI / tests (pull_request) Failing after 2m30s
5fd9aa3c29
Merge pull request 'feat: lofi radio' (#4) from feat/lofi-page into main
Some checks failed
CI / tests (push) Failing after 2m15s
8b6ca814a9
Reviewed-on: #4
feat: sync main features into Electron for Hyprland
Some checks failed
CI / tests (push) Failing after 3m31s
CI / tests (pull_request) Failing after 3m39s
ef349bb300
nico merged commit 40f377c96d into electron 2026-10-14 21:18:43 +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!5
No description provided.