Skip to main content

​
Section 7 — Administration (Super Admin & Admin)

Ce chapitre décrit l’ensemble des fonctionnalités réservées aux administrateurs de la plateforme Oya Editions. Deux niveaux de droits administratifs coexistent : le Super Admin (rôle système owner ou super) et l’Admin (rôle d’équipe admin ou owner). Leurs périmètres d’action sont distincts et complémentaires.

​
1. Panneau d’Administration

​
1.1 Qui a accès au panneau admin ?

L’accès aux pages d’administration est contrôlé à deux niveaux :
⚠️ Attention : Toute tentative d’accès à une page https://hub.editions.oya.africa/admin/* sans les droits requis entraîne une redirection automatique vers https://hub.editions.oya.africa. Il n’y a aucun message d’erreur affiché ; la redirection est silencieuse.

​
1.2 Accéder au panneau d’administration

Pour les Super Admins :
  1. Connectez-vous à la plateforme avec votre compte Super Admin.
  2. Dans la barre latérale gauche, une section “ADMIN EDITIONS” apparaît en dessous des sections d’équipe.
  3. Cette section contient trois liens de gestion : Gestion des auteurs, Gestion des éditeurs, Gestion des thèmes.
Pour les Admins d’équipe :
  1. Connectez-vous et sélectionnez l’équipe pour laquelle vous avez le rôle admin ou owner.
  2. Accédez directement aux URLs :
  3. Sur les pages Auteurs et Éditeurs, une barre d’onglets “Votre équipe” offre une navigation rapide entre les sections.
[CAPTURE D’ÉCRAN: Barre latérale avec la section “ADMIN EDITIONS” visible pour un Super Admin, montrant les trois entrées de menu]

​
1.3 Vue d’ensemble des fonctionnalités admin

Le panneau d’administration regroupe trois modules principaux :
  • Gestion des auteurs — Référentiel des personnes physiques qui rédigent les publications (livres, articles). Chaque auteur dispose d’un profil complet avec photo, biographie et liens sociaux.
  • Gestion des éditeurs — Référentiel des maisons d’édition ou structures éditoriales. Chaque éditeur dispose d’un logo et d’une description.
  • Gestion des thèmes — Référentiel des catégories thématiques utilisées pour classifier les publications (ex. : littérature, sciences, histoire…).

​
2. Gestion des Auteurs

Les auteurs sont les créateurs de contenu référencés sur la plateforme. Ils peuvent être associés aux publications (livres, articles) pour apparaître sur les pages publiques.

​
2.1 Voir la liste des auteurs

  1. Accédez à https://hub.editions.oya.africa/admin/authors.
  2. La page affiche un tableau avec les colonnes suivantes :
    • Avatar — Photo de profil de l’auteur
    • Nom — Nom complet
    • Email — Adresse email de contact
    • Rôle (Fonction) — Titre ou poste de l’auteur (ex. : Romancier, Journaliste)
    • Pays — Drapeau et code pays
  3. Si aucun auteur n’est enregistré, un message “Aucun auteur trouvé” s’affiche au centre de la page.
[CAPTURE D’ÉCRAN: Liste des auteurs avec le tableau complet et les colonnes Avatar, Nom, Email, Rôle, Pays]

​
2.2 Ajouter un auteur

  1. Depuis la page https://hub.editions.oya.africa/admin/authors, cliquez sur le bouton “Nouvel auteur” en haut à droite.
  2. Une fenêtre modale s’ouvre avec le formulaire de création.
  3. Renseignez les champs suivants :
    • Nom (obligatoire) — Le nom complet de l’auteur
    • Courriel (optionnel) — Adresse email de l’auteur
    • Fonction (optionnel) — Titre ou rôle (ex. : Écrivain, Poète, Journaliste)
    • Pays (optionnel) — Sélectionnez dans la liste déroulante ; le drapeau s’affiche automatiquement
    • À propos (optionnel) — Biographie courte de l’auteur (champ texte multiligne)
  4. Pour ajouter une photo de profil : cliquez sur l’avatar par défaut (icône circulaire en haut du formulaire). Une icône + indique la zone cliquable. Sélectionnez un fichier image depuis votre appareil.
  5. Pour ajouter des liens sociaux :
    • Cliquez sur “Ajouter un lien social”
    • Sélectionnez le réseau dans la liste déroulante : LinkedIn, Facebook ou Instagram
    • Saisissez l’URL complète du profil (ex. : https://linkedin.com/in/nom)
    • Répétez l’opération pour chaque réseau souhaité
    • Pour supprimer un lien, cliquez sur l’icône corbeille à droite de la ligne
  6. Cliquez sur “Créer” pour valider.
  7. Un message de confirmation “Auteur créé avec succès” s’affiche. L’auteur apparaît immédiatement dans la liste.
[CAPTURE D’ÉCRAN: Formulaire de création d’un auteur avec les champs remplis et la section “Liens sociaux”]
⚠️ Attention : Le champ Nom est le seul champ obligatoire. Sans nom, la sauvegarde est bloquée avec un message d’erreur.

​
2.3 Modifier les informations d’un auteur

  1. Dans la liste des auteurs, cliquez sur la ligne de l’auteur à modifier.
  2. La même fenêtre modale s’ouvre en mode édition, pré-remplie avec les données existantes.
  3. Modifiez les champs souhaités (nom, email, fonction, pays, biographie, avatar, liens sociaux).
  4. Pour changer la photo : cliquez sur l’avatar existant et sélectionnez un nouveau fichier.
  5. Cliquez sur “Enregistrer” pour valider les modifications.
  6. Un message “Auteur mis à jour avec succès” confirme la sauvegarde.
[CAPTURE D’ÉCRAN: Formulaire d’édition d’un auteur existant avec données pré-remplies]

​
2.4 Supprimer un auteur

⚠️ Attention : La suppression d’un auteur est irréversible. L’auteur sera définitivement retiré de la plateforme. Assurez-vous au préalable qu’aucune publication active ne dépend de cet auteur.
  1. Dans la liste des auteurs, cliquez sur l’icône corbeille rouge à droite de la ligne de l’auteur (sans cliquer sur la ligne entière pour ne pas ouvrir le mode édition).
  2. Une boîte de dialogue de confirmation s’affiche : “Êtes-vous sûr de vouloir supprimer cet auteur ? Cette action est irréversible.”
  3. Cliquez sur “Supprimer” pour confirmer, ou sur “Annuler” pour abandonner.
  4. Un message “Auteur supprimé avec succès” confirme la suppression.

​
2.5 Lier un auteur à du contenu

Les auteurs créés dans ce référentiel peuvent ensuite être associés aux publications (livres et articles) lors de leur création ou édition. Cette liaison se fait depuis les interfaces de création/édition de contenu, et non depuis la page d’administration des auteurs.
⚠️ Attention : Un auteur supprimé du référentiel peut laisser des références orphelines dans les publications auxquelles il était lié. Vérifiez les publications associées avant toute suppression.

​
3. Gestion des Éditeurs

Les éditeurs représentent les maisons d’édition ou structures éditoriales qui publient du contenu sur la plateforme.

​
3.1 Voir la liste des éditeurs

  1. Accédez à https://hub.editions.oya.africa/admin/editors.
  2. La page affiche un tableau avec les colonnes :
    • Logo — Logotype de l’éditeur
    • Nom — Nom de la maison d’édition
    • À propos — Description courte (tronquée si trop longue)
  3. Si aucun éditeur n’est enregistré, un message “Aucun éditeur trouvé” s’affiche.
[CAPTURE D’ÉCRAN: Liste des éditeurs avec colonnes Logo, Nom, À propos]

​
3.2 Ajouter un éditeur

  1. Depuis la page https://hub.editions.oya.africa/admin/editors, cliquez sur le bouton “Nouvel éditeur” en haut à droite.
  2. Une fenêtre modale s’ouvre avec le formulaire de création.
  3. Renseignez les champs :
    • Nom (obligatoire) — Nom officiel de la maison d’édition
    • À propos (optionnel) — Description de l’éditeur, son histoire, sa ligne éditoriale
  4. Pour ajouter un logo : cliquez sur l’avatar par défaut (initiale de l’éditeur dans un cercle). Sélectionnez un fichier image depuis votre appareil.
  5. Cliquez sur “Créer” pour valider.
  6. Un message “Éditeur créé avec succès” confirme l’ajout.
[CAPTURE D’ÉCRAN: Formulaire de création d’un éditeur avec champs Nom, À propos et logo]
⚠️ Attention : Le champ Nom est obligatoire. La création est bloquée si ce champ est vide.

​
3.3 Modifier les informations d’un éditeur

  1. Dans la liste des éditeurs, cliquez sur la ligne de l’éditeur à modifier.
  2. La fenêtre modale s’ouvre en mode édition avec les données pré-remplies.
  3. Modifiez le nom, la description ou le logo selon vos besoins.
  4. Pour changer le logo, cliquez sur le logo existant et sélectionnez un nouveau fichier.
  5. Cliquez sur “Enregistrer” pour sauvegarder.

​
3.4 Supprimer un éditeur

⚠️ Attention : La suppression d’un éditeur est irréversible et peut affecter les publications qui lui sont associées.
  1. Cliquez sur l’icône corbeille rouge à droite de la ligne de l’éditeur.
  2. Confirmez dans la boîte de dialogue : “Êtes-vous sûr de vouloir supprimer cet éditeur ? Cette action est irréversible.”
  3. Cliquez sur “Supprimer” pour confirmer.

​
3.5 Gérer les droits d’un éditeur

La gestion des droits d’accès d’un éditeur à la plateforme se fait via la gestion des équipes et des membres (https://hub.editions.oya.africa/settings), et non depuis cette page. Depuis cette interface, vous gérez uniquement les métadonnées de l’éditeur (nom, logo, description), pas ses permissions d’accès. Pour attribuer à un membre de l’équipe le rôle Éditeur (création), référez-vous à la section Gestion des équipes (Section 5 de la documentation).

​
4. Gestion des Thèmes

Les thèmes sont les catégories thématiques utilisées pour classer et filtrer les publications sur la plateforme publique (ex. : Roman, Poésie, Sciences, Histoire…).

​
4.1 Accéder à la gestion des thèmes

  1. Depuis la barre latérale (section “ADMIN EDITIONS”), cliquez sur “Gestion des thèmes”.
  2. Ou accédez directement à l’URL https://hub.editions.oya.africa/admin/themes.
  3. La page affiche la liste de tous les thèmes existants avec leur label.
[CAPTURE D’ÉCRAN: Page de gestion des thèmes avec la liste des labels existants et le bouton “Nouveau thème”]

​
4.2 Créer un thème

  1. Depuis la page https://hub.editions.oya.africa/admin/themes, cliquez sur le bouton “Nouveau thème” en haut à droite.
  2. Une fenêtre modale s’ouvre.
  3. Saisissez le Label du thème (obligatoire) — C’est le nom qui sera affiché publiquement (ex. : “Littérature africaine”, “Développement personnel”, “Histoire”).
  4. Cliquez sur “Créer” pour valider.
  5. Un message “Thème créé avec succès” confirme l’ajout. Le thème apparaît dans la liste.
⚠️ Attention : Le label est le seul champ du formulaire de thème. Il est obligatoire. Choisissez des labels clairs, cohérents et sans doublon pour garantir une navigation de qualité aux lecteurs.

​
4.3 Modifier un thème

  1. Dans la liste des thèmes, cliquez sur la ligne du thème à modifier.
  2. La fenêtre modale s’ouvre en mode édition avec le label actuel pré-rempli.
  3. Modifiez le label.
  4. Cliquez sur “Mettre à jour” pour enregistrer.
  5. Un message “Thème mis à jour avec succès” confirme la modification.
[CAPTURE D’ÉCRAN: Fenêtre de modification d’un thème avec le champ Label pré-rempli]

​
4.4 Supprimer un thème

⚠️ Attention : La suppression d’un thème est irréversible. Les publications associées à ce thème perdront cette classification. Vérifiez l’impact avant toute suppression, notamment si ce thème est utilisé dans des filtres ou des pages de navigation publique.
  1. Cliquez sur l’icône corbeille rouge à droite de la ligne du thème.
  2. Une boîte de dialogue de confirmation s’affiche avec le nom du thème à supprimer.
  3. Cliquez sur “Supprimer” pour confirmer.

​
4.5 Appliquer un thème à une publication

Les thèmes créés dans ce référentiel peuvent être attribués aux publications lors de leur création ou édition, depuis les interfaces de gestion du contenu (https://hub.editions.oya.africa/books, https://hub.editions.oya.africa/articles). Cette opération ne se fait pas depuis la page d’administration des thèmes.

​
5. Différence Super Admin vs Admin

​
5.1 Tableau comparatif des permissions

​
5.2 Ce que peut faire un Super Admin que l’Admin ne peut pas

1. Accès global sans appartenance à une équipe Le Super Admin voit et accède à la section “ADMIN EDITIONS” dans la barre latérale indépendamment de toute appartenance à une équipe. Sa visibilité est conditionnée par son rôle système (role.type === "owner" ou role.type === "super"), pas par un rôle d’équipe. Un Admin d’équipe, en revanche, n’a accès aux pages admin que dans le contexte de son équipe active. Si l’équipe n’est pas sélectionnée, ou si son rôle dans l’équipe est inférieur à admin, l’accès est refusé. 2. Visibilité du menu “ADMIN EDITIONS” La section “ADMIN EDITIONS” dans la barre latérale n’est visible que pour les Super Admins. Un Admin d’équipe doit naviguer directement via l’URL ou via les onglets de navigation sur les pages d’équipe. 3. Portée des actions
  • Le Super Admin peut gérer les référentiels globaux de la plateforme (auteurs, éditeurs, thèmes partagés entre toutes les équipes).
  • L’Admin d’équipe administre les ressources dans le cadre de son équipe.

​
5.3 Accès aux fonctionnalités sensibles

Les fonctionnalités les plus sensibles — suppression définitive d’auteurs, d’éditeurs ou de thèmes — sont accessibles aux deux profils (Super Admin et Admin d’équipe). Cependant, ces actions modifient des référentiels partagés qui impactent l’ensemble des publications de la plateforme. Par précaution :
⚠️ Attention : Seul un Super Admin devrait effectuer des suppressions dans les référentiels partagés (auteurs, éditeurs, thèmes), car ces données sont susceptibles d’être utilisées par plusieurs équipes et publications simultanément.

​
6. Bonnes Pratiques d’Administration

​
6.1 Gestion des référentiels (auteurs, éditeurs, thèmes)

  • Unicité : Avant de créer un nouvel auteur ou éditeur, vérifiez qu’il n’existe pas déjà dans la liste pour éviter les doublons. Un doublon peut induire des incohérences dans les pages publiques.
  • Complétude des profils : Renseignez systématiquement l’avatar, la biographie et les liens sociaux pour les auteurs. Des profils complets améliorent la visibilité et la crédibilité des créateurs sur la plateforme publique.
  • Nommage des thèmes : Utilisez des labels courts, clairs et cohérents. Évitez les accents incohérents, les majuscules inutiles ou les abréviations ambiguës. La casse et l’orthographe sont visibles directement par les lecteurs.
  • Logos et images : Privilégiez des images de qualité en format carré (ratio 1:1) pour les avatars d’auteurs et les logos d’éditeurs. Les formats recommandés sont JPEG ou PNG, poids inférieur à 2 Mo.

​
6.2 Précautions avant toute suppression

⚠️ Attention : Les suppressions dans les référentiels sont irréversibles et immédiates. Il n’existe pas de corbeille ou de système d’annulation.
Avant de supprimer un auteur, un éditeur ou un thème :
  1. Vérifiez qu’aucune publication active n’est liée à cette entrée.
  2. Si des publications y font référence, mettez-les à jour pour les associer à d’autres entrées, ou archivez-les d’abord.
  3. Informez les membres de votre équipe de la suppression à venir si la donnée est partagée.

​
6.3 Gestion des accès et des rôles

  • Principe du moindre privilège : N’attribuez le rôle admin dans une équipe qu’aux personnes qui en ont réellement besoin. Préférez le rôle editor ou contributor pour les membres qui créent du contenu sans avoir besoin de gérer les référentiels.
  • Révision régulière : Auditez périodiquement la liste des membres de chaque équipe (https://hub.editions.oya.africa/settings) pour retirer les accès des personnes qui ne font plus partie de l’organisation.
  • Super Admin : Le rôle Super Admin est attribué au niveau système (backend CMS). Ne partagez jamais les identifiants d’un compte Super Admin. En cas de départ d’une personne ayant ce rôle, révoquez immédiatement l’accès depuis le back-office CMS.

​
6.4 Cohérence des données

  • Assurez-vous que les noms d’auteurs utilisés dans les publications correspondent exactement aux entrées du référentiel pour garantir des pages auteur cohérentes sur la partie publique du site.
  • Pour les éditeurs, vérifiez que le nom saisi correspond au nom officiel de la structure pour faciliter la recherche et le filtrage par les lecteurs.
  • Les thèmes sont utilisés pour le filtrage et la découverte de contenu. Une architecture de thèmes bien pensée (ni trop large, ni trop granulaire) améliore significativement l’expérience des lecteurs.

​
6.5 Communication inter-équipes

  • Lorsque vous modifiez un thème partagé (renommage), informez les équipes éditoriales qui l’utilisent, car le changement de label est immédiatement visible sur toutes les publications associées.
  • Lors de l’ajout d’un nouvel auteur ou éditeur, partagez l’information avec les équipes créatrices de contenu afin qu’elles puissent immédiatement l’associer à leurs publications.
Dernière mise à jour : avril 2026