# Guide Judbox — Administrateur *Le guide complet, réservé à l'administrateur. Il complète le guide des membres (`/aide`) et celui des modérateurs (`/aide/moderation`), que vous pouvez lire aussi.* --- ## Les rôles en un coup d'œil | Rôle | Comment on l'obtient | Ce qu'il peut faire | |---|---|---| | **Visiteur** | sans compte | lire le catalogue, essayer le jukebox de découverte, écouter une soirée live sur invitation | | **Membre** | inscription gratuite | écouter, compléter les fiches, ajouter des pochettes, proposer des histoires d'album, **1 playlist par mois** | | **Créateur** (= abonné) | abonnement : **{{offre}}** | tout ce que fait un membre, plus : **ajouter des morceaux et des albums sans limite**, playlists sans limite, soirée live | | **Modérateur** | candidature **acceptée par vous** | les outils Créateur (gratuits, en remerciement), plus : l'écran Modération (histoires, Support) et le Karaoké en test. **Aucun accès** aux réglages, à l'argent ni aux rôles | | **Administrateur** | vous | tout | **Fin d'abonnement** : l'engagement ne porte que sur la **1re année** — une résiliation demandée pendant cette année prend effet à la date anniversaire ; à partir de la 2e année, à la **fin du mois en cours**. Le compte redevient Membre à cette date. Un **prélèvement refusé** arrête l'abonnement **immédiatement**. L'offre de lancement n'est accordée **qu'une fois** : un ancien abonné qui revient paie directement le prix normal. **Rien n'est effacé** : ses ajouts restent au catalogue, à son nom. S'il se réabonne, il retrouve tout. **Principe absolu de Judbox** : on n'efface jamais physiquement. On **masque**, on **désactive**, on **garde une trace**. --- ## Vos deux entrées - Le bouton **« Admin »** (cadenas, en haut de l'écran) ouvre l'administration, avec son menu à gauche. - Le bouton **« Modération »** ouvre l'écran de l'équipe. Vous y voyez **en plus** les candidatures de modérateurs. Ces boutons n'apparaissent pas sur la page d'accueil publique : allez d'abord sur n'importe quelle autre page. --- ## Menu « Général » - **Tableau de bord** : les chiffres clés (membres, abonnés, contenus…). - **Ouvrir le Jukebox** : retour à l'écoute. - **Karaoké** *(test)* : caler les paroles ligne par ligne. Visible seulement par l'équipe. ## Menu « Contenu » ### Morceaux L'écran d'ajout et de modification des morceaux. En tant qu'administrateur, vous voyez **tout le catalogue**, pas seulement vos ajouts. ### Albums & pochettes Les pochettes et photos, un écran collaboratif ouvert à tous les membres. ### Playlists Vos playlists, comme n'importe quel membre. ### Fiches à vérifier Judbox repère **automatiquement** les fiches probablement mal saisies : une phrase dans un champ nom, un lien YouTube invalide, une œuvre sans interprétation, une année aberrante… - Cet écran **ne modifie rien** : chaque ligne vous emmène vers l'écran de correction. - **« Ignorer »** : c'est une fausse alerte. Elle disparaît de la liste, et vous pouvez la rétablir. ### Corbeille catalogue Les œuvres **masquées** (souvent des doublons retirés depuis le Catalogue, avec le petit cercle sous la vignette). **Rien n'y est supprimé** : un clic suffit pour les **restaurer**. ### Tous les titres Toutes les interprétations à plat, une ligne par titre, pour vérifier et trier librement. ### Albums La liste de tous les disques. - **Menu de style sur chaque ligne** : choisissez le style, c'est enregistré aussitôt (✓ vert), et le changement est tracé dans l'historique. - **« Sans style seulement »** n'affiche que les albums à classer. Le compteur diminue au fur et à mesure. - Le **style d'un album s'applique à tous ses titres**, sauf un titre qui a déjà son propre style. - **Crayon** : modifier le titre, l'artiste, l'année, le format, le label et la description. - **Corbeille rouge** : supprimer un album **vide** seulement. Un album qui contient des titres est protégé. ### Styles musicaux La liste des styles : Pop, Rock, Folk, Musiques du monde, Variété internationale, Gospel / Chrétien… - **Renommer** un style ne casse rien : les titres suivent. - Pour retirer un style, **désactivez-le** plutôt que de le supprimer. - Chaque album garde **son** style : un même artiste peut avoir des albums de styles différents. ### Époques Des périodes musicales nommées (par exemple « Années Disco »), utilisées pour la frise de **Découvrir**. ### Catégories Un écran repris de l'ancienne application. Il n'a pas d'effet visible sur Judbox aujourd'hui. ### Statistiques et Écoutes - **Statistiques** : l'évolution des inscriptions, des abonnements et des revenus. - **Écoutes** : le classement des morceaux les plus écoutés (Jukebox et Platine), sur 24 heures, 7 jours, 30 jours ou depuis toujours. ## Menu « Membres » ### Utilisateurs La liste de tous les comptes. - **Modifier** : changer le pseudo, l'e-mail ou le **rôle** (membre, abonné, modérateur, administrateur). - **Offrir** (cadeau vert) : offrir 1, 2, 3, 6 ou 12 mois d'abonnement Créateur — testeurs, concours, remerciements… Sans carte bancaire, **jamais de prélèvement**. Le membre est prévenu par une notification. Un cadeau en cours peut être **prolongé** (la durée s'ajoute) ou **arrêté**. À la fin, le compte redevient Membre tout seul, et l'offre de lancement lui reste acquise s'il s'abonne ensuite. « offert jusqu'au … » s'affiche sous son rôle. Inutile pour les modérateurs, qui ont déjà tout. - **Se connecter en tant que** : voir le site exactement comme cette personne le voit. Un bandeau violet le rappelle en haut de l'écran. Cliquez sur **« Retour admin »** pour revenir à votre compte. - **Supprimer** : à éviter. Selon le principe de Judbox, on préfère désactiver ou bannir. ### Abonnements La liste des abonnements Créateur (Stripe) : qui paie, depuis quand, jusqu'à quand. Vous pouvez **annuler** un abonnement. ### Notifications (annonces) Envoyez un message dans la cloche 🔔 de **tout le monde**, ou seulement des **membres**, des **abonnés** ou des **créateurs**. **Pour recruter des modérateurs** : faites une annonce avec le lien `/devenir-moderateur`. ## Menu « Système » - **Parler à l'équipe** : les messages Support, partagés avec les modérateurs. La pastille indique les messages non lus. - **Messages de contact** : ceux du formulaire public « Contact », envoyés par des visiteurs sans compte. **Réservé à vous.** - **Configuration** : le nom du site, les couleurs, les années de la frise, la position du globe… et surtout l'**offre Créateur** : prix normal (€/mois), prix de lancement et nombre de mois à ce prix (1re année seulement), durée d'engagement de la 1re année (ensuite l'abonnement est au mois). Un aperçu montre ce que verra un nouvel abonné. Les nouveaux prix s'appliquent **tout de suite aux nouveaux abonnés** ; les **engagements en cours restent valables jusqu'à leur date anniversaire**, puis l'abonné passe au nouveau prix normal au renouvellement. (Les tout premiers abonnés, pris avant l'engagement, restent au mois par mois à leur prix d'origine.) - **Tarifs** et **Crédits & packs** : deux écrans repris de l'ancienne application, **inutilisés** sur Judbox. « Crédits & packs » mène d'ailleurs à une page vide. --- ## L'écran Modération (votre partie) En plus de ce que voient les modérateurs (histoires d'album et messages Support, décrits dans leur guide), vous seul voyez : ### Candidatures modérateur - **« Accepter — le passer modérateur »** : le compte devient modérateur **immédiatement**, sans qu'il ait à se reconnecter. Son rôle précédent est gardé en mémoire. - **« Refuser »** : une **explication est obligatoire**. Elle est envoyée au candidat. - Le candidat est prévenu dans les deux cas. Rappel : un modérateur **n'expire jamais**, même sans abonnement. Il garde les outils Créateur tant que vous ne changez pas son rôle. --- ## Remplir le catalogue efficacement ### « Compléter le catalogue par thème » C'est la page d'import en masse depuis YouTube (bouton **Morceaux**, puis **« Compléter par thème »**). 1. **En haut** : vérifiez **Album**, **Artiste**, **Année**, **Style** et **Pochette** avant **chaque** album. 2. La **miniature** montre la pochette qui va être enregistrée. Le champ **se vide après chaque import** : c'était la cause des pochettes qui passaient d'un album au suivant, corrigée le 25/09/2026. 3. **Toujours choisir un Style** : sans style, les titres n'apparaissent pas dans l'écoute par style. 4. **Import automatique d'albums** : 15 albums au maximum à la fois. 5. **Quota YouTube** : le nombre de recherches par jour est limité. Si le quota est épuisé, un avertissement l'indique et les albums non traités sont listés. **Relancez le lendemain après 9 h.** 6. **Titres « Déjà au catalogue »** : ils ne sont **jamais recréés**. Cochés (d'office pour un album entier), ils sont seulement **rangés dans l'album** à leur numéro de piste. Avant le 25/09/2026, ils étaient grisés et jamais envoyés : l'album restait incomplet (cas *Kama Sutra*, pistes 1 et 7). 7. **Après chaque album**, comparez le nombre de pistes avec la playlist YouTube. Un trou ou un titre mal placé se corrige avec **« Ranger dans un album »** (ci-dessous). ### Ranger un titre dans un album Sur la **fiche d'un morceau**, chaque interprétation a un bouton **💿 « Ranger dans un album »** (ou **« Changer d'album / de piste »**). 1. Tapez le nom de l'album ou de l'artiste, puis cliquez sur le bon album. 2. Les pistes s'affichent : **libres en vert**, le titre concerné **en orange**. Ajustez le **numéro de piste**. 3. **« Ranger dans « … » »** enregistre. Une confirmation est demandée si la place est déjà prise. 4. **« Retirer de l'album »** sort le titre de l'album, sans l'effacer. **Qui peut le faire :** l'auteur de l'interprétation, **seulement dans ses propres albums, sur une piste libre, et si le titre appartient vraiment à l'album** (interprète = artiste de l'album, titre présent dans la tracklist officielle MusicBrainz, accents et article initial ignorés ; tracklist mise en cache 7 jours dans `storage/cache/`). Album absent de MusicBrainz : accepté, mais l'équipe est notifiée ; les **modérateurs** (toutes les fiches, pour ces deux champs seulement, et ils peuvent prendre une piste occupée après confirmation) ; et vous. Ces limites sont vérifiées par le serveur, pas seulement par l'écran. L'import applique la même règle. Tout est **tracé dans l'Historique** et **annulable**. Les membres signalent les titres mal rangés par le Support. ### Pochettes - Sur la page d'un album, **« Pochettes »** propose les **pochettes officielles** (base MusicBrainz), une par édition. - **« Afficher pour l'album »** remplace la pochette affichée. L'ancienne reste dans la collection. - Chaque album change sa pochette **depuis sa propre page**. ### Doublons - Une chanson en double : masquez-la depuis le Catalogue (petit cercle sous la vignette). Elle va dans la **Corbeille catalogue**, d'où vous pouvez la restaurer. - Un titre en double dans un album : sortez-le de l'album plutôt que de l'effacer (bouton **« Retirer de l'album »** dans la fenêtre « Ranger dans un album »). - **Attention** : quand le compositeur n'est pas rempli, deux chansons **de même titre** peuvent partager la même fiche (ex. « Toi et moi » de Polnareff et de Florent Pagny). Pas encore d'outil pour les séparer : signalez-les-moi. --- ## Les règles de la maison 1. **On n'efface jamais physiquement** : on masque, on désactive, on archive. 2. **Rien d'anonyme** : chaque modification de fiche est tracée (qui, quoi, avant et après). Le bouton **Historique** de chaque fiche permet d'**annuler** une modification. 3. **Exclusion définitive** pour les insultes, les propos haineux ou les contenus illégaux, sans avertissement. **C'est vous qui l'appliquez.** 4. **Ne jamais pénaliser un innocent** : une adresse IP partagée ou une ressemblance entre comptes ne suffit pas. Dans le doute, on vérifie avant de sanctionner. 5. Judbox **n'héberge pas** la musique : les morceaux sont des **liens** vers des vidéos publiques. --- ## Informations techniques (pour mémoire) - **Adresse** : https://judbox.geonatsat.fr, hébergée chez **OVH** (compte najastud). - **Base de données** : partagée avec Terra. Les tables de Judbox commencent par `jb_`. - **Paiements** : Stripe, avec un abonnement **mensuel renouvelé automatiquement**. Engagement la 1re année, puis au mois ; la résiliation prend effet en fin d'engagement (1re année) ou en fin de mois (ensuite), sans remboursement. Impayé = arrêt immédiat. - **Mise à jour du site** : les corrections sont enregistrées sur GitHub, puis installées sur OVH. - En cas de problème : notez **la page**, **ce que vous avez fait** et **le message affiché**, avec une capture d'écran si possible. Ce sont les informations dont on a besoin pour corriger vite.