SPB Git

Repository Public

TESTING.md 22.2 KB

# Tests

La section « Version 2.0 » en fin de document couvre les sources supplémentaires, les films, les séries, l'ONF, la bibliothèque et la nouvelle interface. Ce qui précède décrit la validation de la version 1 (toujours valable).

Tout ce qui suit a été exécuté le 2026-11-16, sur de vraies données IPTV-org et de vrais flux publics. Aucune chaîne fictive n'est utilisée pour démontrer une fonctionnalité ; le seul jeu de données généré (12 000 lignes) sert à mesurer la vitesse de recherche dans les tests unitaires et est signalé comme tel dans le fichier de test.

# Lancer les tests

bash
pnpm test                                             # Vitest : 35 tests unitaires et d'intégration (≈ 3 s)
node_modules/.bin/playwright install chromium firefox webkit      # une fois
SPTV_URL=https://tv.spboucher.ai SPTV_PASSWORD='…' node_modules/.bin/playwright test      # 40 tests de bout en bout

Les tests de bout en bout visent une instance réelle (production ou build local pnpm build && pnpm start + pnpm worker).

# Résultats

# Exigence Comment Résultat
1 Import réel d'une playlist IPTV-org worker en production, tâche n° 1 : index.m3u (11 502 entrées), ca.m3u (264), us.m3u (1 497), fr.m3u (208) + API de métadonnées 10 368 chaînes, 11 484 flux, 1 969 doublons écartés, 3 entrées bloquées (liste IPTV-org), 15 protocoles non http(s) ignorés, 0 erreur d'analyse, 1,1 s
2 Métadonnées extraites contrôle en base : 10 368/10 368 chaînes reliées à l'API IPTV-org, pays connu pour toutes, 141 sans logo, 180 pays ; tests unitaires de l'analyseur (tvg-id, feed, qualité, étiquettes, logo, groupes, #EXTVLCOPT, virgules entre guillemets) conforme
3 Persistance des favoris E2E : ajout par l'interface, rechargement, nouvelle session dans un autre contexte de navigateur ; unitaire : ordre conservé après reconstruction du catalogue, favori conservé quand ses flux disparaissent réussi (4 profils)
4 Recherche et filtres E2E : « frnace 24 » → France 24, filtre pays ; unitaire : accents, casse, fautes, transpositions, pays/catégorie/langue/statut, pagination réussi
5 Lecture de flux publics E2E en production, horloge vidéo qui avance réellement : Firefox (hls.js), WebKit iPhone et iPad (HLS natif) : 10 TV, 13 Siam Thai, 3CatInfo, Africa 24 ; mesure manuelle Firefox : 3ABN Canada, Amazing Discoveries TV, Apna Punjab TV, Az Star TV lus ; zapping sans rechargement vérifié
6 Flux indisponibles E2E : ouverture d'une chaîne « indisponible au dernier test » → panneau d'erreur avec la cause, Réessayer, Tester maintenant ; unitaire : 403, 404, HTML, variante morte, délai dépassé réussi ; un flux qui cesse d'émettre 25 s devient une erreur (plus de chargement infini)
7 Authentification E2E : pages et API refusées sans session (307 / 401), mauvais mot de passe, cookie __Host-sptv HttpOnly + Secure + SameSite=Lax, déconnexion ; sur le nœud : 5 échecs → HTTP 429 « Réessayez dans 15 min » même avec le bon mot de passe, origine étrangère → 403 ; unitaire : scrypt, sessions, verrouillage par adresse et global réussi
8 Compatibilité mobile E2E profil iPhone 15 (WebKit) et iPad Pro 11 : toutes les pages, aucun débordement horizontal, lecture, favoris, guide, admin réussi
9 Performance sur un grand catalogue production, 10 368 chaînes : recherche serveur 1 à 36 ms, aller-retour API 22 à 62 ms, accueil 31 ms, guide 45 ms ; démarrage du lecteur 0,3 à 1,2 s (4 chaînes canadiennes) ; listes paginées (72 par page, défilement infini), logos en chargement différé conforme
10 Déploiement HTTPS https://tv.spboucher.ai : 200, certificat Let's Encrypt, HTTP → HTTPS (308), HSTS ; mld status --live : local 200 / public 200 ; redémarrage PM2 puis santé 200 réussi

Autres vérifications :

  • Guide TV réel : première collecte en production, 171 chaînes demandées (Canada + France), 134 avec données, 7 859 programmes en 3 min 39 s. Les 37 autres n'ont rien renvoyé ce jour-là : le site suivant sera essayé à la prochaine collecte, et elles affichent « Programme indisponible ».
  • SSRF : l'ajout de http://192.168.2.1/…, http://127.0.0.1:8670/…, http://localhost/…, file:///etc/passwd, http://169.254.169.254/… est refusé (400) ; un nom public qui résout vers 127.0.0.1 est refusé à la connexion.
  • Sauvegarde / restauration : scripts/backup.sh sur le nœud → archive de 3,0 Mo, décompressée et relue (integrity_check = ok, 10 368 chaînes, 11 484 flux).
  • Navigation clavier / télécommande (Chromium, Firefox, WebKit iPad) : flèches entre champ de recherche, filtres et cartes, focus visible, Entrée ouvre le lecteur, Échap le réduit.

Bilan de la suite de bout en bout en production : 38 réussis, 2 exclus (sur 40). Exclus volontairement : lecture vidéo dans le Chromium de Playwright (ce build n'a pas de décodeur H.264/AAC) ; navigation clavier sur le profil iPhone (écran tactile).

# Disponibilité mesurée (au moment de la rédaction)

Le premier passage de vérification était en cours (≈ 1 flux toutes les 2 s, par politesse envers les serveurs). Sur les premiers flux testés depuis le nœud : environ 68 % disponibles, dont plus de 90 % avec en-têtes CORS (lisibles par hls.js hors Safari). Causes d'indisponibilité les plus fréquentes : délai d'attente dépassé, HTTP 404, HTTP 403, DNS introuvable, certificat TLS invalide. Les chiffres à jour sont dans Admin → Aperçu.

# Plateformes réellement testées

Plateforme Testé Comment
Firefox 159 (macOS) oui Playwright, lecture réelle par hls.js
WebKit (moteur de Safari) — profils iPhone 15 et iPad Pro 11, macOS 27 oui Playwright WebKit, lecture réelle par HLS natif
Chromium 159 (macOS) oui, sauf vidéo interface, recherche, favoris, admin, clavier ; pas de décodeur H.264 dans ce build
Safari sur un vrai iPhone / iPad, AirPlay réel non le bouton AirPlay n'apparaît que si l'appareil annonce une cible ; à valider sur l'appareil
Google Chrome, Microsoft Edge (builds officiels) non même moteur que Chromium + codecs : hls.js y est pris en charge, mais non vérifié ici (non installés sur le poste de test)
Android (Chrome), Android TV non
Navigateurs de Smart TV (Tizen, webOS, Vidaa…) non la navigation directionnelle et les touches Retour (BrowserBack, GoBack) sont gérées, mais aucun téléviseur n'a été testé. Les téléviseurs anciens (moteurs antérieurs à ~2020) ne feront probablement pas tourner l'application
PWA installée non vérifié sur appareil manifeste, icônes et service worker servis ; l'installation elle-même n'a pas été faite
Clés d'accès (passkeys) oui, authentificateur virtuel production, Chromium + authentificateur WebAuthn virtuel : enregistrement, déconnexion, connexion par clé, suppression. Touch ID / Face ID réels : à enrôler par le propriétaire (Admin → Sécurité)

# Limites connues

  • Flux HTTP (≈ 21 % du catalogue) : bloqués par les navigateurs sur une page HTTPS ; signalés comme tels, URL copiable pour un lecteur externe.
  • Flux exigeant un Referer/User-Agent (≈ 7 %), géobloqués, DASH (≈ 1 %) ou protégés : non lus, cause affichée.
  • Le statut « disponible » vient d'un test serveur depuis le Québec ; un flux peut répondre au serveur et refuser le navigateur (ou l'inverse).
  • Guide : 60 chaînes par vue (filtre pour atteindre les autres) ; données limitées aux chaînes que les sites de programmes couvrent.
  • Les tests de bout en bout dépendent de flux publics tiers : un flux peut s'interrompre pendant un test.

# Version 2.0 — validation du 2026-11-16

# Lancer

bash
pnpm test                                             # 53 tests unitaires et d'intégration
SPTV_URL=https://tv.spboucher.ai SPTV_PASSWORD='…' node_modules/.bin/playwright test   # app.spec.ts (v1) + vod.spec.ts (v2)

# Résultats par exigence (phase 10 du cahier des charges)

# Exigence Comment Résultat
1 Nouvelles playlists vérifiées chaque dépôt proposé téléchargé et mesuré (entrées, doublons avec IPTV-org, marques payantes, hôtes) + recherche élargie (≈ 45 sources, 90 playlists) 7 sources actives, 4 désactivées par défaut, une vingtaine refusées — SOURCES.md
2 Importation des chaînes synchronisation en production 11 650 chaînes, 13 975 flux (v1 : 10 368 / 11 484) ; 110 flux de la sélection vérifiée, 1 222 de Free-TV, 638 de Nexonic, 714 des grilles Pluto / Samsung
3 Déduplication même synchronisation 6 600 doublons d'URL écartés, 220 variantes sans identifiant regroupées par nom, 234 chaînes payantes présumées et 139 liens de pages écartés ; ICI Télé = 1 chaîne, 14 flux
4 Lecture de plusieurs chaînes production, horloge vidéo qui avance Firefox (hls.js) : ICI Télé, ICI RDI, Savoir média, Canal de l'Assemblée nationale, CPAC, France 24 ; WebKit iPhone (natif) : les mêmes + Global News et Radio-Canada INFO
5 Import d'un film légalement accessible tâche vod en production 6 271 films avec source vidéo : 1 682 Internet Archive, 1 207 Wikimedia Commons, 3 379 ONF (2 187 longs métrages, 2 468 documentaires, 1 340 films d'animation, 3 409 en français) ; écartés : 180 sans vidéo lisible, 150 dont l'élément Internet Archive ne correspondait pas au film, 9 pour adultes, 98 films ONF non offerts gratuitement en entier ; 5 642 avec synopsis, 5 547 avec affiche
6 Lecture du film E2E Firefox : lecture, saut à 5:00, fermeture, « Reprendre à 5:0x », reprise à la bonne position réussi en production — Firefox, WebKit iPhone, WebKit iPad
7 Série à plusieurs épisodes Flash Gordon Conquers the Universe (11 chapitres), Pioneer One (6 épisodes), Undersea Kingdom ; Caminandes (3 épisodes, bibliothèque) importées
8 Navigation saisons / épisodes E2E : liste d'épisodes, « marquer comme vu » déplace « Regarder » sur l'épisode suivant, lecture d'un épisode puis « Épisode suivant » réussi — Firefox, WebKit iPhone, WebKit iPad (production)
9 Bibliothèque NAS NAS injoignables (voir Blocages). Validée en production sur un dossier local réel : 3 films + 1 série Blender (Creative Commons) reconnus avec affiche et synopsis ; MP4 lu tel quel ; MKV H.264 converti par copie de flux (< 1 s) avec sous-titres français (60 répliques) ; MKV HEVC 10 bits / AC-3 réencodé par VideoToolbox (14 min 48 de film en 15 s) ; lus sur Firefox, WebKit iPhone et iPad
10 Favoris et reprise E2E : « Ma liste » (ajout, relecture par l'API, retrait), position enregistrée à la fermeture, « Continuer à regarder », marquage vu / non vu réussi
11 Mobile et ordinateur profils iPhone 15 et iPad Pro 11 (WebKit), Firefox et Chromium 1440 px ; aucun débordement horizontal réussi
12 Authentification et sécurité 9 routes (catalogue, lecture, fichier, HLS, sous-titres, miniature, admin) → 401 sans session ; fichier servi en 206 avec session, refusé sans ; chemins .. refusés ; checkDir refuse /etc, le dossier des secrets, les chemins relatifs ou cachés réussi
13 Déploiement mld inchangé ; migrations 2 et 3 appliquées sur la base de production ; clé d'accès, sessions et réglages existants conservés réussi
14 Fonctionnement réel après déploiement suites E2E rejouées contre https://tv.spboucher.ai 70 réussis, 2 exclus sur 72 (18 scénarios × 4 profils : Chromium, Firefox, WebKit iPhone, WebKit iPad). Exclus : lecture vidéo dans le Chromium de Playwright (pas de décodeur H.264) et navigation clavier sur iPhone

Autres vérifications faites :

  • Guide TV : 759 chaînes avec programmes réels après ajout des guides Pluto / Samsung (v1 : 134). Un rafraîchissement a échoué le 16 nov. à 13 h 51 (coupure réseau passagère vers GitHub) : les téléchargements sont désormais retentés et le guide redemandé dans l'heure.
  • Disponibilité : premier passage complet terminé — 9 851 flux disponibles, 4 059 indisponibles au dernier test ; 521 chaînes canadiennes, 465 chaînes francophones.
  • Sauvegardes : exécution nocturne constatée (03 h 50, 6,7 Mo).
  • Piste audio et vitesse (local, Firefox) : fichier à deux pistes → bascule sur la seconde (nouvelle déclinaison HLS, AC-3 → AAC) avec reprise à la même position ; vitesse 1,5×.
  • ONF : « 24 heures ou plus » (1973, 1 h 53) lu dans le lecteur officiel intégré, lien « Voir sur onf.ca » présent (local, Firefox) ; en production, « … et la musique » lu dans le lecteur officiel sur Firefox, WebKit iPhone et WebKit iPad. Import ONF : 3 625 films listés, 3 477 examinés en 80 minutes, 3 379 retenus, 98 écartés (pas de film entier gratuit dans le lecteur), 148 en erreur réseau qui seront réexaminés au prochain import.
  • Garde titre + année : « His Girl Friday » (1940) n'est plus relié à « The Saint's Girl Friday » (1953) — test unitaire.
  • Non-régression v1 : app.spec.ts 28 réussis / 2 exclus en production après la refonte.

# Playlists M3U personnelles (ajout du 2026-11-17)

  • E2E en production (4 profils) : création, lecture de l'adresse sans session (200, audio/x-mpegurl, autant d'URL que de chaînes annoncées), guide XMLTV, API de gestion refusée sans session (401), jeton erroné → 404, « nouvelle adresse » → l'ancienne répond 404.
  • Validation « comme une télé » depuis le réseau de la maison : playlist réelle « Québec et Canada français » (favoris + Canada en français, flux disponibles seulement) téléchargée sans session, puis chaque flux ouvert avec ffprobe (le moteur de VLC et Kodi) : 10 sur 10 lisibles (Canal de l'Assemblée nationale, CPAC, ICI Télé, ICI RDI, Savoir média, TVA, Stingray Classica…) ; guide : 152 programmes pour 4 de ces chaînes.
  • Non vérifié : l'import dans une vraie application de téléviseur (TiviMate, IPTV Smarters, Smart IPTV, Apple TV…) et leur lecture du guide ; le comportement des options http-referrer / http-user-agent dépend de chaque application.

# Blocages et fonctionnalités non vérifiées

Sujet État
NAS Ugreen injoignables le 2026-11-16 : aucun montage sur les nœuds, port SMB fermé aux adresses connues, adresses MAC absentes du réseau. La lecture depuis un vrai partage SMB n'a donc pas été testée. Procédure de raccordement : DEPLOYMENT.md
TMDB aucune clé disponible : le code d'enrichissement (TMDB_API_KEY) n'a jamais été exécuté
Affiches haute résolution celles de Wikimedia Commons et de l'ONF ; beaucoup de films anciens n'ont qu'une vignette Internet Archive ou une image fixe
Synopsis Wikipédia a limité le débit pendant l'import : une partie des films n'a pas encore de synopsis ; une seconde passe est faite à chaque import
Sous-titres des films distants fichiers .srt d'Internet Archive convertis en WebVTT : couvert par test unitaire et par la bibliothèque, pas rejoué en E2E sur un film distant
ONF reprise de lecture, sous-titres et vitesse sont ceux du lecteur de l'ONF (SP TV n'y a pas accès) ; la vérification de gratuité a écarté 98 films sur 3 477 ; elle repose sur ce que le lecteur annonce (source et durée), pas sur une information tarifaire officielle
Films en WebM (Wikimedia Commons) non lus sur les Safari anciens ; l'application le dit
Avance rapide pendant une conversion impossible au-delà de la partie déjà convertie tant que la conversion n'est pas terminée
Chrome / Edge officiels, vrai iPhone, AirPlay, Android TV, Smart TV, PWA installée toujours non testés (voir tableau de la version 1)
Pluto TV hors Safari en-tête CORS figé par Pluto : lisible avec le lecteur natif de Safari, pas avec hls.js
TV5MONDE Info même contrainte (CORS réservé à tv5monde.com)
Guides québécois supplémentaires (iptv-epg.org, xmltvfr.fr) identifiés, non intégrés (table de correspondance d'identifiants à écrire)
Recommandations les rangées sont thématiques et tournent chaque jour ; « Populaires dans votre bibliothèque » n'apparaît qu'avec de vraies lectures. Pas de moteur de recommandation personnalisé

# Version 3.0 — validation du 2026-11-17

bash
pnpm test                                             # 63 tests unitaires et d'intégration
SPTV_URL=https://tv.spboucher.ai SPTV_PASSWORD='…' node_modules/.bin/playwright test   # app.spec.ts, vod.spec.ts, engine.spec.ts

Suite de bout en bout en production : 90 réussis, 2 exclus sur 92 (23 scénarios × Chromium, Firefox, WebKit iPhone, WebKit iPad ; mêmes exclusions qu'avant).

# Exigence du cahier des charges Comment Résultat
1 Audit de l'application existante architecture conservée ; migrations 4 et 5 appliquées sur la base de production ; clé d'accès, playlist M3U, réglages conservés fait
2 Vérifier les sources actuelles synchronisation en production : 11 sources actives sans erreur, 11 650 chaînes, 0 flux non vérifié fait
3 Nouvelles sources autorisées ARTE et NASA intégrés ; étude des services gratuits (tableau dans SOURCES.md) ; dearbulut et iptv-restream toujours refusés (motifs mesurés) fait
4 Import des catalogues tâche sources en production (7 min 16) : ARTE 393 programmes listés → 310 programmes + 33 séries (373 épisodes) retenus, 41 refusés (37 extraits ou dossiers sans vidéo, 2 sans flux, 1 hors droits, 1 indisponible) ; NASA 516 trouvées → 500 importées, 9 écartées, 4 erreurs fait
5 Lecture réelle ARTE : « “Mission : Impossible” en 8 minutes — Blow up » lu dans le lecteur officiel (Firefox, WebKit iPhone, WebKit iPad) ; un film et une série ARTE lus en local ; NASA : vidéo lue depuis images-assets.nasa.gov (Firefox, WebKit) ; MPEG-DASH : 2TV, AsianBox, Antena 3 lus en production (Firefox, dash.js) réussi
6 Fournisseurs configurés aucun fournisseur réel n'est configuré (pas d'abonnement fourni). L'adaptateur est exercé contre un faux portail local qui implémente l'API documentée : test de connexion, refus d'un mauvais mot de passe sans l'afficher, import des chaînes, films et séries, résolution des adresses, désactivation, suppression (tests unitaires) adaptateur vérifié, pas un fournisseur
6b Jellyfin aucun Jellyfin sur le cluster ; connecteur testé contre un vrai serveur Jellyfin 12.4 lancé temporairement sur le poste de développement : connexion (bon et mauvais mot de passe), import de 3 films avec affiches, lecture directe (MP4) et lecture transcodée par Jellyfin (MKV H.264, MKV HEVC 10 bits) dans Firefox réussi en local ; les séries n'ont pas été importées dans ce test (Jellyfin ne les avait pas indexées)
7 Films et séries E2E v2 rejoués (lecture, reprise, épisodes) + série ARTE avec épisodes réussi
8 Guide TV E2E v1 ; 759 chaînes avec programmes réussi
9 Favoris et historique E2E v1 / v2 réussi
10 Sécurité routes du moteur et de redirection fermées sans session ni ticket (401) ; adresses internes, absence de déclaration d'autorisation et type inconnu refusés (400) ; mot de passe d'essai absent de la réponse ; identifiants chiffrés illisibles dans la base et absents de la liste des sources (tests unitaires) ; source intégrée non supprimable réussi
11 Déploiement mld inchangé, dashjs ajouté, redémarrage des deux services, santé 200 fait
12 Rapport avant / après RAPPORT-AVANT-APRES.md fait

Écrans : Admin → Sources (ajout, test, priorité, suppression d'une source de type « flux » par l'API puis vérification à l'écran), Sports, Paramètres, liens vers les services officiels — E2E sur les 4 profils. Un débordement horizontal de 18 px sur iPhone dans la section des services officiels a été trouvé par ce test et corrigé.

# Non vérifié en v3.0

  • Un vrai fournisseur à API compatible Xtream (chaînes, films, guide, lecture) et la lecture de ses flux dans hls.js (beaucoup de portails n'envoient pas d'en-têtes CORS : lecture possible dans Safari et dans les applications de télé).
  • Jellyfin : lecture depuis un vrai téléphone ou une télé ; ses sous-titres ; l'interface web de Jellyfin sous /jellyfin/ au-delà du contrôle d'accès (307 sans session, 200 avec).
  • ARTE : le retrait automatique à l'échéance des droits (codé et testé sur la requête, aucun titre n'a encore expiré) ; la reprise de lecture (gérée par le lecteur d'ARTE).
  • NASA : durée des vidéos (l'API ne la fournit pas : elles sont classées comme courts métrages) ; sous-titres en lecture.
  • Import d'un fichier M3U par l'écran (le connecteur est couvert par les tests unitaires, pas par un test navigateur).
  • MPEG-DASH hors Firefox (dash.js fonctionne aussi dans Chrome et Safari, non testé ici) ; les flux DASH protégés par DRM échouent avec un message explicite.
  • Tout ce qui était déjà non vérifié : vrais appareils, AirPlay, Chrome et Edge officiels, Smart TV, NAS.

# Ajouts du 2026-11-17 (Jellyfin sur le cluster, TMDB)

Élément Test réel Résultat
Jellyfin 12.4 installé sur m4mn (/jellyfin, port 8096) source « Jellyfin (m4mn) » : tâche sources n° 24 3 films, 1 série, 3 épisodes importés
Lecture Jellyfin en production (Firefox, https://tv.spboucher.ai) Big Buck Bunny (lecture directe), Cosmos Laundromat et Sintel (HLS transcodé par Jellyfin) : l'horloge avance 3/3 lus, redirection 302 /api/provider/media/… avec ticket signé
Accès à /jellyfin/ sans session SP TV, puis avec 307 vers /connexion, puis 200
TMDB (clé du propriétaire) passe complète sur 6 275 titres en production (7 min) 3 713 reconnus, 2 936 affiches et 80 synopsis ajoutés ; les titres non reconnus restent inchangés
Suite de bout en bout en production après ces changements 92 cas (Chromium, Firefox, WebKit iPhone et iPad) 90 réussis, 2 exclus prévus

Limite : les trois films de démonstration existent deux fois (bibliothèque intégrée et Jellyfin).

Files main
Menu

Theme