# VODUM - Feuille de route Ce fichier suit le travail restant et les lots deja livres. Les cases cochees signalent une implementation terminee et verifiee localement, pas une validation en production. Un objectif global reste ouvert si des sous-parties ou des mesures restent a faire. Le detail historique est conserve dans `changelog.md`. Derniere mise a jour: 2026-11-19 ## P0 - Performances et reactivite VODUM (priorite avant les evolutions P1/P2/P3) Perimetre : application VODUM, independamment de la machine et de l'hebergement. Ordre ci-dessous par impact attendu sur la reactivite globale, a confirmer par mesure ; les gains sur installation representative restent a chiffrer. Conserver les optimisations deja presentes (WAL, index, caches, agregats, lectures HTTP paralleles des demandes). Prerequis obligatoires pour chaque optimisation : aucun changement visuel, aucune perte de donnees, aucune suppression de fonctionnalite ni regression des comportements existants. Conserver les acces, historiques, configurations, filtres, tris, pagination et protections actuels. Valider chaque lot avant extension ; une amelioration de performance ne justifie aucune perte fonctionnelle. - [ ] Prealable de validation : mesurer les temps de routes p50/p95/p99, l'attente avant traitement web, l'attente du verrou DB, les durees SQL, les appels fournisseurs/cache et l'attente des jobs. Reutiliser `VODUM_ROUTE_TIMING` ; distinguer le temps Flask de la file Waitress. Comparer avant/apres avec une base representative, plusieurs utilisateurs et des fournisseurs lents, sans journaliser de secrets. Ces mesures peuvent ajuster l'ordre ci-dessous. - [x] Premier lot : le [rapport des temps Flask](docs/mesure-temps-flask.md) calcule les percentiles par route, méthode, statut et mode HTMX. Les nouvelles traces utilisent le nom interne de la route. - [x] Deuxième lot : le même rapport mesure l'attente du verrou DBManager et les appels SQL instrumentés, y compris les lectures sur snapshot. - [x] Troisième lot : temps d'attente dans la file du pool de threads Waitress mesuré séparément et intégré au rapport, sur activation explicite. - [x] Quatrième lot : délai entre l'éligibilité et la première prise en charge des jobs de rafraîchissement monitoring et d'accès Plex. - [x] Cinquième lot : la mesure SQL couvre les curseurs de transaction DBManager, la lecture des résultats et les opérations de début et fin de transaction. - [x] Sixième lot : le rapport distingue le HTTP via les sessions fournisseur sécurisées et les consultations du cache d’agrégats dans le contexte Flask. Restent la mesure sur une base représentative et la couverture du SQL hors DBManager, des appels et caches hors de ce périmètre et des autres files et reprises de jobs. - [ ] 1. Reduire la contention SQLite : remplacer progressivement la connexion partagee et son verrou global par des connexions de lecture independantes et une gestion explicite des ecritures. Auditer les usages directs de `db.conn`, les transactions et le dechiffrement sous verrou ; conserver l'atomicite, les contraintes et WAL. Ne pas simplement retirer le verrou actuel. - [x] Premier lot livre : lectures lourdes Utilisateurs et tableau Bibliotheques du monitoring isolees sur des snapshots SQLite en lecture seule. Les ecritures, migrations, imports et controles d'acces gardent leur connexion actuelle. - [x] Deuxieme lot livre : historique, agregats de la vue d'ensemble et classements par bibliotheque isoles egalement. La reparation des references artwork reste sur le parcours d'ecriture existant, apres fermeture du snapshot de lecture. Reste a mesurer sur une base representative et etendre aux autres parcours apres audit de leurs eventuelles ecritures. - [x] Troisieme lot livre : blocs Servers et Usage risk du dashboard isoles sur des snapshots de lecture ; requete des pics alignee sur l'index de dates. - [x] Quatrieme lot livre : contexte et neuf lectures de statistiques de l'onglet Servers du monitoring isoles egalement. Comparaison des six valeurs de plage, absence d'ecriture et test de lecture pendant verrou d'ecriture occupe. Benchmark concurrent synthetique dans `tools/benchmark_monitoring_server_reads.py`. - [x] Cinquieme lot livre : lectures en cours du dashboard isolees dans un snapshot, y compris compteurs et repli borne lorsque la file de taches est occupee. Resultats compares et lecture pendant transaction d'ecriture testes ; benchmark synthetique dans `tools/benchmark_dashboard_live_reads.py`. Mesure sur base representative toujours restante. - [x] Sixieme lot livre : sessions, compteurs et serveurs du monitoring en direct charges dans un snapshot commun. Enrichissement/reparation artwork conserve apres fermeture du lecteur sur le parcours d'ecriture. Repli sur les compteurs recents et onglets sans lecture preserves ; benchmark avec `tools/benchmark_dashboard_live_reads.py --monitoring`. - [x] Septieme lot livre : evenements recents Overview/Activity et utilisateurs du filtre Bibliotheques sur connexions de lecture independantes. Tri, limites, details de series, deduplication et libelles conserves ; aucun snapshot pour les onglets sans evenements. Comparaison sous transaction concurrente testee. Benchmark : `tools/benchmark_dashboard_live_reads.py --activity` et `--library-users`. Validation representative toujours restante. - [x] Huitieme lot livre : rapport d'usage du portail (compteurs, chronologie, utilisateurs, evenements et demandes medias) dans un snapshot commun. Periodes, pagination et comptes compares au parcours precedent pendant transaction concurrente, cas vide et integrite verifies. Benchmark : `tools/benchmark_dashboard_live_reads.py --portal-usage`. Mesure sur base representative et autres parcours encore a traiter. - [x] Neuvieme lot livre : neuf lectures de l'onglet Politiques (catalogue, compteurs, repartitions, utilisateurs, actions recentes/regroupees, suivi, chronologie et pagination) isolees par operation. Requetes et regles conservees ; comparaison avec/sans donnees et pendant transaction concurrente testee. Benchmark synthetique : `tools/benchmark_dashboard_live_reads.py --policies`. Mesure representative toujours restante. - [x] Dixieme lot livre : consultation Sonarr/Radarr dans un snapshot commun pour disponibilite, latence, derniers compteurs et series quotidiennes. Collecte et purge inchangees ; sans serveur ARR, aucune connexion supplementaire. Six plages, valeurs absentes et transaction concurrente testees ; benchmark `tools/benchmark_dashboard_live_reads.py --arr`. Mesure representative restante. - [x] Onzieme lot livre : liste Serveurs, compteur et page Bibliotheques sur snapshots de lecture independants. Tris, pagination, types normalises et compteurs distincts preserves ; comparaison pendant transaction concurrente, cas vides et absence d'ecriture testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --server-pages`. Validation representative encore a traiter. - [x] Douzieme lot livre : cinq lectures de la fiche serveur (detail, bibliotheques, utilisateurs et compteurs) sur snapshots independants. Perimetre par serveur, comptes multiples rattaches a un utilisateur, pagination et serveur absent testes pendant transaction concurrente. Benchmark : `tools/benchmark_dashboard_live_reads.py --server-detail`. Validation representative restante. Controle general de fabrique SQLite en echec hors lot : connexions directes dans `app/diagnose_stream_policies.py` et `app/core/backup.py`, a qualifier avant de modifier ces parcours. - [x] Treizieme lot livre : chargements des pages Campagnes et Modeles de communication isoles chacun dans un snapshot de lecture. Traductions, pieces jointes, tri, pagination et editeurs conserves ; enregistrements et envois inchanges. Comparaison pendant transaction concurrente et cas vides testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --communication-pages`. Validation representative toujours restante. - [x] Quatorzieme lot livre : detail de l'historique et configuration Communications sur snapshots de lecture independants. Message archive ou reconstruit, substitutions historiques, masquage des secrets et compteurs de file preserves ; comparaison pendant transaction concurrente et cas absents/vides testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --communication-details`. Validation representative toujours restante. - [x] Quinzieme lot livre : tableau d'acces de la fiche utilisateur sur snapshot commun aux serveurs et bibliotheques. Selection du compte le plus renseigne, droits des comptes lies et options de chargement preserves ; aucun snapshot lorsque les deux listes sont inutiles. Lectures utilisees par l'enregistrement conservees sur leur parcours actuel. Comparaison concurrente et benchmark : `tools/benchmark_dashboard_live_reads.py --user-access`. Validation representative toujours restante. - [x] Seizieme lot livre : historique des notifications de la fiche utilisateur (compteurs et pages email/Discord) dans un snapshot commun. Pagination independante, libelles et ordre conserves ; aucun snapshot si desactive. Comparaison pendant transaction concurrente et utilisateurs absents testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --user-notifications`. Validation representative toujours restante. - [x] Dix-septieme lot livre : affichage du parrainage et noms des comptes fusionnes sur snapshots independants. Compteurs, liste des filleuls, parrain de repli, tri et deduplication des noms conserves ; actions de parrainage inchangees. Comparaison pendant transaction concurrente et utilisateurs absents testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --user-referrals`. Validation representative toujours restante. - [x] Dix-huitieme lot livre : politiques actives affichees sur la fiche utilisateur dans un snapshot commun aux identites et regles. Portee, fournisseur, ordre et libelles conserves ; application des restrictions inchangee. Comparaison pendant transaction concurrente, utilisateur absent et absence d'ecriture testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --user-policies`. Validation representative toujours restante. - [x] Dix-neuvieme lot livre : utilisateur et candidats de fusion charges dans un snapshot commun, ferme avant calcul des scores. Classement et limites conserves ; action de fusion inchangee. Comparaison pendant transaction concurrente et utilisateur absent testes. Benchmark de la phase de lecture : `tools/benchmark_dashboard_live_reads.py --merge-candidates`. Validation representative toujours restante. - [x] Vingtieme lot livre : prochaines taches et resume des abonnements du dashboard sur snapshots independants. Tri, compteurs, repartition et graphique conserves ; tables optionnelles absentes et transaction concurrente testees, sans ecriture. Benchmark : `tools/benchmark_dashboard_live_reads.py --dashboard-summaries`. Validation representative toujours restante. - [x] Vingt-et-unieme lot livre : suivi personnel du portail dans un snapshot commun aux periodes, historique et repartitions. Isolation par utilisateur, deduplication, durees et masquage IP conserves ; autorisations de route inchangees. Comparaison pendant transaction concurrente et utilisateur absent testes. Benchmark : `tools/benchmark_dashboard_live_reads.py --personal-monitoring`. Benchmark local remis à jour pour mesurer la phase SQL commune au portail. Avec un verrou synthétique tenu 250 ms, résultats identiques et médianes de 262 ms sur connexion partagée et de 8 ms sur snapshot. Validation representative toujours restante. - [x] Vingt-deuxieme lot livre : chargement initial de Collections dans un snapshot commun (bibliotheques, ARR, configurations et reglages). Les routes ARR passent d'une requete par bibliotheque a une requete groupee, avec les memes types compatibles, priorites et ordres. Rendu HTML complet compare. Benchmark synthetique : `tools/benchmark_collections_page_reads.py`, 103 bibliotheques, verrou d'ecriture tenu 250 ms : mediane de 253 a 3,65 ms. Mesure representative et API de suivi Collections encore a traiter ; cette API conserve la recuperation des executions bloquees sur son parcours actuel. - [ ] 2. Liberer les threads web : executer les operations longues dans des jobs bornes, avec reponse rapide, suivi de progression et reprise idempotente. Prioriser demandes medias et recuperations lentes ; verifier qu'une operation fournisseur bloquee ne retarde pas la navigation des autres utilisateurs. Evaluer le dimensionnement Waitress apres reduction des blocages. - [x] Premier lot : la soumission des demandes médias est persistée et traitée par un worker dédié. Le portail affiche ses états et résultats, même après rechargement. Les vérifications peuvent reprendre après incident, et un POST ARR à l’issue incertaine n’est pas rejoué automatiquement. Restent la recherche initiale et les autres opérations longues, ainsi que la mesure Waitress sous charge représentative. - [ ] 3. Eviter les recalculs de tout l'historique dans le monitoring : materialiser les statistiques par utilisateur/bibliotheque et la derniere activite ; garder les filtres, tris et la pagination coherents. Retirer les identites repetees par lecture dans `GROUP_CONCAT`, charger les identites depuis leurs tables. Verifier les plans SQL et la deduplication ; ajouter uniquement les index utiles. - [x] Premier lot livre : compteur Utilisateurs sans filtre par verification indexee de l'existence d'un historique ; suppression de la concatenation des identites inutilisee lorsque la liste n'est pas filtree. Recherche filtree conservee a l'identique, avec comparaisons aux anciennes requetes pour tris/pagination. - [x] Deuxième lot : la dernière lecture est trouvée par recherche indexée pour chaque compte média, puis comparée entre les comptes liés. Sans filtre, les identités sont agrégées depuis ces comptes. La recherche filtrée et la déduplication des lectures gardent leur logique. Sur 100 333 sessions synthétiques, la médiane SQL passe de 674 à 266 ms et huit combinaisons de recherche, tri et pagination restent identiques. - [x] Troisième lot : le tri Bibliothèques par dernière lecture sélectionne la page via l’index avant de calculer les totaux dédupliqués. - [x] Quatrième lot : pour les tris Utilisateur, Dernière lecture, IP et Lecteur sans recherche, sélectionner la page avant d'agréger l'historique. Seuls les comptes des utilisateurs affichés sont parcourus via l'index existant. Comptes liés, déduplication, tris, pagination et lecture concurrente vérifiés. Sur 100 082 lectures et 1 005 comptes synthétiques, page de 30 lignes : médiane SQL de 269 à 27 ms (dernière lecture) et de 257 à 24 ms (nom). Benchmark : `tools/benchmark_monitoring_users_page.py` ; détails et limites dans `docs/performance-monitoring-users-2026-11-19.md`. Restent à matérialiser les totaux de lecture, optimiser les recherches filtrées et les tris Lectures/Durée, et mesurer les gains sur l'installation réelle. - [ ] 4. Rendre la consultation des logs proportionnelle a la page affichee : separer entretien/rotation et consultation, eviter le nettoyage force et la relecture de toutes les archives a chaque ouverture. Mettre les compteurs en cache, borner les lectures et etudier une file de journalisation dediee ; conserver recherche, traces multilignes, anonymisation et retention. - [x] Premier lot livre : l'entretien ne relit plus les fichiers deja controles et inchanges tant qu'aucune ligne ne peut expirer. Invalidation sur changement de fichier/politique ; reutilisation bornee du decodage des dates repetees. - [x] Deuxieme lot livre : cache borne des evenements analyses, invalide sur changement/rotation/purge ; consultation repetee sans relecture ni analyse des fichiers inchanges. Recherche, compteurs, pagination et export conserves. - [x] Troisieme lot : les pages sans recherche réutilisent l’index par niveau et copient uniquement les événements de la page. Les compteurs réutilisent les effectifs de l’index. La recherche conserve son périmètre et ses résultats. - [x] Quatrième lot : après un ajout au fichier actif, la consultation réutilise les archives analysées qui tiennent dans le cache. Rotation et purge invalident les archives concernées et les traces restent groupées. Reste a borner les lectures lors d'un changement ou pour les gros historiques, et a optimiser la recherche au-dela du cache. - [ ] 5. Reduire les parcours des demandes medias : qualifier les recherches ciblees par identifiant fournisseur Plex/Jellyfin/ARR et un index local actualise. Eviter les scans complets et appels de details repetes ; conserver les controles d'acces, la verification avant ajout, les reservations contre les doublons et l'absence de failover apres POST incertain. La parallelisation deja presente ne suffit pas a supprimer ces parcours. - [x] Premier lot : pendant la verification des doublons, la configuration de chaque serveur media est lue une fois, quel que soit le nombre de bibliotheques a verifier. - [x] Deuxième lot : contrôle des doublons ARR par `tmdbId` ou `tvdbId` sur toutes les instances compatibles. Une instance qui rejette le paramètre peut encore être interrogée avec la liste complète. - [x] Troisième lot : reconnaissance des GUID Plex historiques dès la page de bibliothèque, et des noms de fournisseurs Jellyfin quelle que soit leur casse. Les parcours paginés restent nécessaires pour confirmer l’absence d’un média. - [x] Quatrième lot : les inventaires existants fournissent un candidat par bibliothèque. Plex ou Jellyfin confirme le candidat par son identifiant natif avant de court-circuiter la pagination. L’absence de candidat ou une réponse non concluante déclenche le parcours habituel. Restent l’index couvrant les autres bibliothèques et l’optimisation du contrôle d’absence. - [ ] 6. Prioriser les appels Plex et les images interactives : revoir la limite partagee d'une requete/seconde, avec concurrence bornee et adaptation aux erreurs fournisseur. Servir immediatement un artwork ancien disponible, actualiser en arriere-plan, dedupliquer les recuperations simultanees et imposer un budget total aux essais de chemins/adresses. Reutiliser les connexions HTTP dans un meme travail sans partager une session mutable entre threads ; conserver les restrictions d'origine et la verification TLS. - [x] Premier lot : le proxy des images du monitoring partage un budget de 10 secondes entre ses essais, attente d’un créneau Plex comprise. Les requêtes HTTP déjà engagées restent soumises aux délais réseau du client. - [x] Deuxième lot : les affiches expirées sont servies immédiatement, avec deux rafraîchissements de fond au maximum par processus. Les demandes simultanées d’une même affiche partagent la récupération fournisseur. Restent la mesure sous charge et la qualification des autres appels Plex. - [ ] 7. Regrouper les ecritures des collectes et synchronisations en petits lots : reduire les commits par session/evenement/droit et les reecritures de metadonnees inchangees. Garder les transactions courtes, sans appel reseau, et verifier coherence, reprise et comportement lors d'une erreur partielle. - [x] Premier lot : état des sessions actives et événements de transition validés ensemble par session. Une écriture de remise à zéro redondante est retirée. - [x] Deuxième lot : compteur d’absence, événement d’arrêt, historique et suppression de la session en direct sont validés ensemble. Délai de grâce et déduplication Tautulli conservés. - [x] Troisième lot : les droits de bibliothèque Plex et Jellyfin sont mis à jour par différence, en une transaction par compte et serveur. - [x] Quatrième lot : synchroniser les bibliothèques Plex et Jellyfin ne réécrit ni leur nom ni leur type ni leur nombre de médias lorsque les valeurs sont identiques. - [x] Cinquième lot : le retrait des bibliothèques Plex utilise la même transaction que Jellyfin. Une configuration bloquant la suppression conserve les droits de la bibliothèque et ne bloque pas le traitement des suivantes. Restent les autres écritures de synchronisation et les mesures sous charge représentative. - [ ] 8. Separer les taches urgentes des travaux lourds : files/workers bornes pour monitoring et actions interactives, distincts des imports, campagnes, synchronisations et prechargements. Decouper les travaux longs, prevoir des budgets reels/cooperatifs et preserver les leases et protections contre les executions concurrentes incompatibles ; ne pas creer de threads abandonnes. - [x] Premier lot : le worker distingue un rafraîchissement en échec d’un résultat vide valide. Les échecs déclenchent la reprise existante et comptent dans la limite de 20 jobs par passage. - [x] Deuxième lot : la collecte et l’application des limites de lecture disposent d’une file série dédiée, indépendante des imports, campagnes, synchronisations et collections. La restauration attend les travaux de fond déjà lancés et suspend les nouveaux départs jusqu’au redémarrage. Restent la mesure sous charge et le découpage des autres tâches longues. - [ ] 9. Reduire les rafraichissements inutiles : cadence adaptative selon l'activite, suspension des onglets masques dans toutes les vues, absence de chevauchement et retour des seuls changements utiles. Conserver la protection du dashboard deja presente ; evaluer snapshots partages, reponses conditionnelles ou SSE selon le cout mesure et la compatibilite du serveur web/reverse proxy. - [x] Premier lot livre : polling des vues Monitoring overview/now_playing suspendu en onglet masque, reprise immediate au retour, sans empilement de requetes lentes. Les cadences visibles et soumissions de filtres sont conservees. - [x] Deuxieme lot livre : polling de Tasks suspendu en onglet masque, reprise au retour, une seule requete en vol avec attente bornee a 10 secondes. Tableau conserve quand son contenu genere est identique ; statuts et actions actualises lors d'un changement. Tests sur reponse lente, erreur et reprise. - [x] Troisieme lot livre : suivi des sauvegardes et imports Tautulli suspendu en onglet masque, reprise au retour et requetes sans chevauchement, bornees a 10 secondes cote navigateur. Une erreur de lecture du statut de sauvegarde ne vaut plus confirmation de fin ; rafraichissement final conserve. - [x] Quatrième lot : Collections interroge l’état toutes les 2 secondes en activité et toutes les 10 secondes au repos. Les actions explicites et le retour au premier plan gardent un rafraîchissement immédiat. - [x] Cinquième lot : historique des cadeaux d’abonnement actualisé toutes les 30 secondes au premier plan, puis immédiatement après un cadeau ou au retour sur l’onglet. Une seule lecture en vol, limitée à 10 secondes côté navigateur. Le tableau reste en place si les données sont identiques. Reste a etendre aux autres vues et evaluer cadence adaptative et snapshots. - [ ] 10. Rendre les calculs de fond incrementaux : recalculer uniquement les jours modifies des agregats quotidiens ; charger une seule fois les abonnements pendant l'analyse des usages. Dissocier la consultation des rapports de l'enregistrement des recommandations et etendre les caches avec invalidation. - [x] Premier lot livre : abonnements charges une seule fois par rapport Usage risk, uniquement si une recommandation est necessaire. Configuration relue au rapport suivant ; resultats compares et benchmark synthetique disponible dans `tools/benchmark_usage_risk.py`. - [x] Deuxieme lot livre : statistiques quotidiennes recalculees uniquement pour les jours absents ou modifies. Suivi SQLite des insertions/corrections/purges d'historique et des changements d'identite ; recalcul conservateur de toute la fenetre apres changement d'identite. Benchmark local et cout d'ecriture documentes dans `docs/performance-daily-refresh-2026-10-08.md`. Restent l’invalidation des caches et la validation sous charge représentative. - [x] Troisieme lot livre : compteurs de blocages Usage risk limites aux actions kill avec index partiel de dates ; aucune lecture globale de ces compteurs quand aucun evenement ne correspond aux filtres. Rapports compares a la requete precedente ; benchmark dans `tools/benchmark_usage_risk_kill_windows.py`. - [x] Quatrième lot : les écrans Usage Risk et Utilisateur consultent les résultats sans écrire les recommandations. Une tâche indépendante les actualise selon la période configurée, même sans notifications d’envoi. - [ ] 11. Reduire les petits couts repetes : mutualiser les lectures de settings dans une requete, mettre en cache le statut de mise a jour avec invalidation, et comparer un niveau gzip moins couteux. Preserver la revocation immediate des sessions et les controles de droits ; ne pas cacher les autorisations sans politique d'invalidation explicite. - [x] Premier lot livre : compression HTML/JSON au niveau gzip 6 par defaut, configurable de 1 a 9 via VODUM_HTTP_GZIP_LEVEL. Contenu et exclusions preserves ; benchmark synthetique reproductible (y compris quatre workers) dans `tools/benchmark_http_compression.py`. Mesure en production restante. - [x] Deuxieme lot livre : langue, nom de marque, fuseau horaire et contexte global des templates partagent une lecture des settings par requete GET/HEAD. Aucun cache entre requetes ; lectures fraiches pour les requetes mutantes. Controles d'autorisation et revocation inchanges. Gain sous charge a mesurer. - [x] Troisieme lot livre : statut du badge de mise a jour reutilise tant que le fichier ne change pas. Invalidation par metadonnees, remplacement/suppression detectes ; erreurs relues a la requete suivante. Mesure sous charge restante. - [ ] 12. Borner la maintenance : purges par lots, sauvegardes/checkpoints et entretien des caches sans longues pauses du traitement interactif. Verifier la restauration, la coherence des sauvegardes et les effets sur les lecteurs. - [x] Premier lot livre : six tables historiques de cleanup_data_retention purgees par lots de 500 lignes avec commit et pause entre lots. Borne initiale des identifiants, dates reverifiees avant suppression ; retention inchangee. - [x] Deuxieme lot livre : cinq tables de retention du portail traitees avec le meme mecanisme ; comptes et regles d'expiration conserves. Reprise apres interruption testee. Checkpoints/sauvegardes et mesure sous charge restants. - [x] Troisieme lot livre : sauvegarde SQLite en ligne par connexion dediee, snapshot temporaire puis compression ; checkpoint TRUNCATE force retire. Restauration du contenu WAL validee, donnees non commitees exclues et nettoyage apres erreur teste. Mesure concurrente representative restante. - [x] Quatrieme lot livre : budget cooperatif du snapshot SQLite (300 s par defaut, VODUM_BACKUP_SNAPSHOT_TIMEOUT_SECONDS). Abandon propre sans archive publiee en cas de depassement ; coherence testee pendant des commits concurrents. Compression et parcours des pieces jointes hors de ce budget. - [x] Cinquieme lot livre : nettoyage artwork avec pause toutes les 100 entrees, grace de 60 s pour fichiers temporaires/orphelins et exclusion du snapshot portal-backdrop.json. Retention et suppression des anciens binomes testees. - [x] Sixième lot : la purge des instantanés monitoring traite au plus 500 lignes expirées par collecte, via l’index de date. Le seuil reste fixé à 30 jours et le reliquat est traité lors des collectes suivantes. - [x] Septième lot : la purge des jobs de rafraîchissement limite chaque transaction à 500 lignes par statut. L’index partiel est installé au démarrage et les seuils de 2 et 7 jours sont conservés. Chaque lot doit demontrer un gain de latence sous charge et conserver les regressions fonctionnelles et de securite. Aucun changement d'hebergement ni migration de moteur de base n'est requis par cette liste. ## Validation apres deploiement Les validations ci-dessous restent ouvertes : ni la presence du code ni les tests locaux ne permettent de les cocher sans observation sur l'installation cible. - [ ] Derniers correctifs P1 : verifier l'audience des campagnes et le report d'expiration lorsque Jellyfin est hors ligne, puis la reprise lorsqu'il revient. - [ ] Indicateur de mise a jour : verifier la connexion GitHub depuis le conteneur, la detection via check_update et le badge apres rechargement de page. Definir si le signal doit suivre main/INFO ou une image effectivement publiee ; voir `docs/audit-update-badge-2026-10-20.md`. Traduction des infobulles et indication de fraicheur du dernier controle a etudier. - [ ] Communications : verifier les traductions de l'historique, des anciens envois (`expiration_date_change`) et des notifications en attente. - [ ] Monitoring > Servers : verifier les spectateurs dedupliques sur les donnees reelles et la distinction avec les utilisateurs actifs du dashboard. - [ ] Routage admin : valider sur une copie representative les associations et priorites par bibliotheque, types compatibles, option par defaut et suppression de bibliotheques/instances ; verifier la migration des deux nouvelles tables. - [ ] Sonarr/Radarr : valider ajout/edition/suppression et connexion API avec plusieurs instances, sous-chemin reverse proxy, mauvaise cle et serveur hors ligne ; verifier le refus avant insertion, les cartes et liens du dashboard, les champs URL/token et les courbes ARR apres plusieurs collectes. - [ ] Jellyfin : verifier la desactivation/reactivation manuelle par compte et serveur, la conservation des droits et la protection des administrateurs. Verifier aussi le libelle du scan global depuis le menu d'une bibliotheque. - [ ] Dashboard et connexion : deployer le filtre GUID Plex pour The Office et le correctif du clignotement ; lancer `refresh_dashboard_quote_cache` et controler une serie et un film sur le dashboard, le fond desktop et l'affiche mobile du login. Verifier la reprise apres indisponibilite d'un serveur. - [ ] Portail : verifier une connexion Plex/Jellyfin, une modification de profil, une invitation d'ami et un message au support dans les logs admin et le monitoring. - [ ] Invitations d'amis : valider SMTP reel, activation Plex, connexion Jellyfin avec le mot de passe genere et comptes mixtes ; confirmer les acces, forfait, limites, echeance et parrainage copies. Verifier les modeles personnalises avec `{jellyfin_username}` / `{jellyfin_password}` et la reprise apres echec d'envoi. - [ ] Expiration : valider les modes existants, les effets apres synchronisation et renouvellement sur plusieurs serveurs et dans une installation mixte. Distinguer compte sans acces, compte encore reference et compte supprime. - [ ] Dashboard : confirmer que la carte Serveurs apparait au premier rendu, avant le calcul des pics 7 jours. Liste et statuts rendus directement depuis les donnees deja chargees ; pics en cache reutilises, liste conservee en cas de timeout du complement. Duree du calcul historique encore a mesurer. ## Principes de suivi - Cocher les lignes et sous-lots termines au fur et a mesure, sans les retirer. Tracer aussi leurs effets et limites dans `changelog.md`. - Conserver ouverts les objectifs partiels et les validations apres deploiement ; une verification locale ne vaut pas une validation en production. - Valider les changements de schema et les traitements automatiques sur une copie representative de la vraie base avant publication. - Ajouter des tests de regression aux fonctions sensibles ou exposees sur Internet. - Ne jamais journaliser de secret ou token ; conserver les secrets necessaires uniquement dans le stockage chiffre prevu a cet effet. - Les evolutions ci-dessous sont a etudier puis a mettre en place si leur faisabilite et leur utilite sont confirmees. Elles ne changent pas les comportements existants par defaut. - Reference technique : [audit Plex/Jellyfin du 6 septembre 2026](docs/audit-couverture-plex-jellyfin-2026-09-06.md). Etat des briques deja presentes : [controle du premier lot](docs/todo-existant-2026-10-06.md). ## P1 - Cycle de vie des utilisateurs et fins d'abonnement - [x] Campagnes : choisir tous les utilisateurs ou tous les utilisateurs actifs (Active, Reminder, Expiring soon), ces derniers par defaut pour les nouvelles campagnes ; conserver l'audience des anciennes et cumuler les filtres. - [x] Corriger le traitement des serveurs indisponibles dans delete_expired_users : controle API prealable, report explicite sans echec pour ce seul motif, conservation locale et nouvelle verification a la prochaine execution planifiee. Erreurs de droits, certificat et protections toujours signalees. - [x] README : presenter l'installation depuis le store Unraid Community Applications. - [ ] Ajouter la suppression manuelle du compte natif Jellyfin par compte/serveur en conservant la fiche VODUM. Reutiliser l'adaptateur de suppression existant ; preciser les cibles et les effets sur les donnees natives avant execution. - [ ] Ajouter la desactivation native automatique Jellyfin (`IsDisabled`) en fin d'abonnement et sa politique de renouvellement/reprise : suivre l'origine du blocage, ne reactiver que les comptes desactives par cette politique, conserver les blocages manuels et les droits anterieurs, ne pas recreer un compte supprime. Reutiliser l'action manuelle et les modes d'expiration existants ; voir [suppression apres expiration](docs/suppression-expiration-2026-09-23.md). - [ ] Etudier les operations Plex au-dela du retrait de partage serveur deja disponible dans la suppression apres expiration. Tenir compte des recherches deja infructueuses : distinguer retrait du partage serveur, relation d'amitie, invitation, Plex Home et traces historiques PMS. Qualifier les pistes `removeFriend`/`removeHomeUser` uniquement selon le perimetre choisi ; elles ne garantissent pas qu'un utilisateur cesse d'etre connu de Plex et peuvent depasser un seul serveur. Ne promettre aucune purge totale non demontree, ni modifier directement la base PMS pour masquer une identite. - [ ] Etudier un masquage/exclusion d'import VODUM si les validations montrent des reimports indesirables ; ne pas le presenter comme une suppression Plex. ## P2 - Administration native a etudier ### Utilisateurs, appareils et invitations - [ ] Ajouter l’edition des politiques natives Jellyfin au-dela de `IsDisabled` : visibilite, droits administrateur, acces distant, lecture/transcodage/debit, telechargement, suppression de contenus, controle parental, horaires, appareils et TV. Preserver les champs non geres et proteger le dernier administrateur. - [ ] Ajouter l'inventaire des appareils et les actions de deconnexion/revocation lorsque le fournisseur les permet. Verifier le refus d'un ancien jeton apres revocation ; ne pas assimiler arret de lecture et deconnexion. - [ ] Etudier une vue des invitations Plex : attente, anciennete, acceptation, annulation et erreurs. Masquer cette vue et ses entrees de navigation si aucun serveur Plex n'est configure ; ne pas l'afficher pour une installation uniquement Jellyfin. Filtrer les donnees selon les serveurs autorises. - [ ] Etudier Plex Home, profils geres, PIN et restrictions de partage actuelles. Afficher les limites liees au compte, a la version et a Plex Pass ; ne pas promettre de gerer le mot de passe/MFA des comptes personnels invites. ### Serveurs et bibliotheques - [ ] Ajouter progressivement les reglages natifs PMS/Jellyfin, avec lecture initiale, edition bornee, controle des droits et verification apres ecriture. - [ ] Etudier un diagnostic de securite des serveurs : acces sans authentification, TLS, acces distant et permissions sensibles. Distinguer ces reglages de la securite de la connexion HTTP entre VODUM et les serveurs. - [ ] Etudier les logs natifs, taches de maintenance, etat/version et commandes de redemarrage/arret lorsque disponibles ; distinguer les taches natives des taches VODUM et les contraintes propres a l'hebergement. - [ ] Etudier la gestion native des bibliotheques : creation, parametres et emplacements. Distinguer suppression d'une bibliotheque et suppression des fichiers medias. Plugins/depots Jellyfin : faisabilite a qualifier ensuite. - [ ] Etudier un scan Jellyfin cible par bibliotheque seulement si une API equivalente est validee ; `/Items/{id}/Refresh` traite les metadonnees et ne constitue pas la preuve d'un scan cible. ## P3 - Capacites, securite d'administration et fiabilite - [ ] Generaliser un registre de capacites par fournisseur, version et identite : supporte, interdit, indisponible ou non teste. L'utiliser pour les nouvelles actions et leur affichage, des les premiers lots. - [ ] Etudier plusieurs administrateurs nominatifs, roles et droits par serveur, appliques cote serveur aux lectures comme aux mutations. - [ ] Unifier l'audit des operations natives avec auteur, cible, motif, avant/apres expurge, resultat et identifiant d'operation ; reutiliser les historiques et protections existants. - [ ] Etendre les jobs existants aux nouvelles actions : etat souhaite/envoye/ confirme, relecture native, reprises idempotentes et echecs partiels visibles. Tester aussi le provisionnement Jellyfin interrompu entre creation, mot de passe et restriction des droits ; prevoir une compensation sure. - [ ] Etudier la detection des changements faits dans Plex/Jellyfin et la reconciliation avec VODUM, sans ecraser un changement administratif externe ni relancer involontairement un ancien acces. - [ ] Etudier les modeles de politiques natives et une reponse a incident multi-serveurs, avec actions distinctes de suspension, coupure et revocation. - [ ] Etudier l'inventaire et la rotation des cles/tokens selon les API : tester la nouvelle cle avant revocation de l'ancienne, masquer les secrets et respecter la portee reelle des droits accordes par le fournisseur. ## Sauvegardes - protection locale et restauration portable Le ZIP local contient volontairement la base et sa cle pour permettre une restauration sur une nouvelle instance. Le chiffrement obligatoire du ZIP n'est pas retenu comme correction prioritaire. La protection repose sur les droits du serveur et l'acces aux sauvegardes ; le ZIP reste un fichier sensible. - [ ] Verifier les permissions du repertoire/fichiers, l'absence d'exposition publique et les acces au volume de sauvegarde, en conservant les protections admin et anti-cache des routes deja auditees. Le stockage local seul ne protege pas contre le vol du ZIP ou la compromission du serveur. - [ ] En option seulement, etudier la protection des exports/copies hors serveur (stockage chiffre ou chiffrement avec secret de recuperation separe), avec procedure de restauration testee. Conserver la restauration locale simple. ## Portail utilisateur - [x] Demandes medias du portail : recherche films/series via ARR, resolution automatique parmi les bibliotheques accessibles, verification Plex/Jellyfin et tous les ARR lies, ajout dans l'ARR prioritaire correspondant aux criteres. Deduplication par ID, CSRF, limites de requetes et reservation contre les soumissions simultanees. Profil qualite et destination par defaut choisis dans la fiche ARR. - [x] Persister et suivre les demandes medias traitees en arriere-plan : jobs, etats et resultats apres rechargement via `portal_media_request_jobs`. La vue actuelle est limitee a dix jobs et aux resultats des dernieres 24 heures ; cela ne constitue pas encore un historique utilisateur complet. - [ ] Completer les demandes medias avec un historique durable consultable et des quotas fonctionnels ; failover avec reconciliation apres une reponse ARR incertaine. Le traitement existant ne rejoue pas automatiquement un POST incertain. - [ ] Ajouter un historique contractuel des abonnements avec un modele de donnees dedie ; l'historique des cadeaux disponible dans Subscriptions ne le remplace pas. ## Securite - controles restant a terminer Les audits deja termines sont dans `docs/security-*-audit.md`, `docs/container-runtime-audit.md` et `changelog.md`. Ne pas les recreer ici. ### Uploads et imports volumineux - [ ] Determiner les besoins reels par type d'upload: import Tautulli, restauration VODUM et autres fichiers; ne pas reduire aveuglement la limite globale de 4096 Mo. - [ ] Evaluer des limites distinctes par fonction et verifier pour les imports multi-Go: espace disque, fichiers temporaires, nettoyage apres echec, timeout, validation DB, memoire, streaming et concurrence. ### SQL, fichiers et commandes - [ ] Auditer les SQL dynamiques (`f-string`, `.format`, concatenation) et confirmer que les valeurs externes sont parametrees et les identifiants dynamiques issus de listes internes strictes. - [ ] Auditer les chemins variables, lectures/ecritures/suppressions, symlinks et fichiers temporaires hors du perimetre backup deja traite. - [ ] Auditer `subprocess`, `shell=True` et `os.system`; aucune valeur utilisateur ou provider ne doit devenir une commande ou de la syntaxe shell. ### API, erreurs et resistance aux abus - [ ] Auditer les API JSON contre IDOR et exposition excessive en testant la substitution des IDs utilisateur, compte media, serveur, policy, communication, backup, task et monitoring. - [ ] Auditer les erreurs 4xx/5xx et les logs restants contre les traces, chemins, SQL, internals DB, secrets et reponses provider sensibles. - [ ] Auditer les operations couteuses: connexions, checks Plex/Jellyfin, monitoring, artwork, backup/restore, imports, synchronisations, tasks, recherches et grosses reponses; verifier timeout, pagination, concurrence et limites raisonnables. ### Cloture avant publication - [ ] Completer les regressions des constats encore ouverts sans casser l'acces LAN, Plex/Jellyfin, les imports Tautulli, SQLite, le scheduler ou les reverse proxies. - [ ] Produire le rapport final classe `CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`, avec chemin reel, protections existantes, exploitabilite, impact, correction, risque de regression, tests et statut. ## Modernisation Docker et dependances (audit du 2026-10-09) Traiter progressivement, avec analyse et validation de chaque lot avant le suivant. Les versions ci-dessous sont des candidates relevees lors de l'audit ; reverifier les versions disponibles au moment de chaque intervention. - [ ] Valider les mises a jour de `requirements.txt` dans une image de test : installation, `pip check`, demarrage Waitress, routes, scheduler, connexions Plex/Jellyfin, WebSocket Plex et chiffrement/dechiffrement des secrets. - [ ] Evaluer Python `3.14.8-slim-trixie` ; comparer avec une mise a jour conservatrice vers `3.12.15-slim-trixie`. Choisir explicitement la variante Debian et definir la politique de versions/digests et de reconstruction. Tester SQLite Python et CLI, initialisation, migrations V1/V2, bootstrap, sauvegarde/restauration et taches sur des donnees temporaires representatives. - [ ] Verrouiller les dependances Python indirectes pour des constructions reproductibles ; examiner les imports directs de Werkzeug, MarkupSafe et urllib3 et leur declaration explicite. Verifier les vulnerabilites connues. - [ ] Confirmer l'absence d'usage de `pytz` avant une eventuelle suppression ; conserver `python-dateutil` dans la resolution de croniter. Verifier `zoneinfo` et la disponibilite des donnees de fuseaux horaires dans l'image choisie. - [ ] Ajouter une etape de construction Node/pnpm avec verrou fige pour preparer les assets, puis copier seulement les resultats dans l'image Python finale. Automatiser la synchronisation des fichiers `static/vendor` avec les versions declarees ; identifier et documenter l'origine/version de QRCode. - [ ] Evaluer Tailwind CSS et CLI `4.3.3`, reconstruire le CSS et verifier le rendu. Chart.js `4.5.1` et Flatpickr `4.6.13` etaient deja a jour lors de l'audit. - [ ] Etudier separement HTMX `1.9.12` -> `2.0.11` : changements de comportement, formulaires, CSRF, navigation, modales et rafraichissements/polling ; valider les parcours dans le navigateur avant adoption. - [ ] Harmoniser les volumes et variables des scripts `create-container.sh` et `get-container.sh` avec Compose : `/appdata/logs`, `/appdata/backups`, `VODUM_LOG_DIR` et `VODUM_BACKUP_DIR`. Conserver les donnees et la cle `vodum.encryption_key` lors du remplacement du conteneur. - [ ] Aligner le healthcheck et les ports publies sur `VODUM_PORT` ; evaluer un healthcheck dans l'image pour les lancements hors Compose et le delai de demarrage pendant les migrations longues. - [ ] Examiner le workflow actif `.github/workflows/docker-image.yml` : actions checkout v7, setup-buildx v4, login v4, metadata v6 et build-push v7 candidates, compatibilite des runners, renouvellement de l'image de base, tags de version et validation avant publication. Clarifier le role de `docker-publish.yml` a la racine, qui n'est pas execute comme workflow GitHub Actions. - [ ] Evaluer un utilisateur non-root et les permissions des volumes, en conservant SQLite CLI et Bash tant que l'entrypoint les utilise. - [x] Exclure explicitement `appdata/` et `backups/` du contexte via `.dockerignore`. Verifie : contexte refuse par defaut, sources autorisees explicitement et exclusions finales `**/appdata/` et `**/backups/`. - [ ] Fiabiliser les metadonnees `INFO` : versions Python/SQLite de l'image construite, au lieu de celles de la machine hote dans `create-container.sh`. ## Interface et documentation — travaux livres - [x] Dashboard : liste et statuts des serveurs fournis au premier rendu, complement des pics charge separement via dashboard_servers_partial. Verification sur l'installation cible toujours ouverte plus haut. - [x] Portail utilisateur sur mobile : navigation, pages et demandes medias adaptees. - [x] Administration sur mobile : navigation et tableaux sous forme de fiches, notamment bibliotheques, utilisateurs du monitoring et Mes collections. Les matrices complexes conservent le defilement horizontal. - [x] Logs : afficher directement les messages et tracebacks sans phrases generiques ni clic sur Technical details. - [x] Collections Jellyfin : ne pas proposer le tri personnalise non supporte, distinguer les limites attendues des erreurs et avertissements effectifs. - [x] Documentation vodum-docs : theme VODUM et documentation des nouvelles fonctions. ## Notes de prudence - `GET /api/monitoring/poster/` est l'unique exception GET mutante autorisee: proxy authentifie d'artwork avec cache local, documente dans `tools/audit_get_routes.py`. - Ne pas supprimer le cache artwork existant ni remplacer globalement `sync` par `revoke`; Plex conserve volontairement un garde-fou contre un sync vide. - Valider les optimisations SQL avec la vraie base et `EXPLAIN QUERY PLAN`; trop d'index peut ralentir les ecritures et le bootstrap. - Garder les modifications de texte ciblees afin de ne pas recreer de mojibake.