Skip to main content

Section 4 — Publications & Inventaire

Rôles concernés :
  • Membre : consultation des publications de l’équipe
  • Éditeur : consultation + création et modification d’inventaires
  • Admin / Propriétaire : accès complet à toutes les fonctionnalités

1. Gérer ses Publications

1.1 Qu’est-ce qu’une publication ?

Sur Oya Editions, il convient de distinguer deux niveaux : Une publication peut être de deux types :
  • Ouvrage (book) : un livre numérique avec couverture au format portrait.
  • Article (article) : un article avec bannière au format paysage.
En résumé : on travaille sur un ouvrage ou un article, puis on le publie pour le rendre accessible aux lecteurs.

1.2 Accéder à la liste des publications

Rôle requis : Membre (et niveaux supérieurs)
  1. Connectez-vous à votre espace Hub.
  2. Dans la navigation latérale, cliquez sur l’onglet Ressources.
  3. Sélectionnez Publications dans le menu de navigation par onglets.
Vous arrivez sur la page https://hub.editions.oya.africa/pubs. [CAPTURE D’ECRAN: Vue de la liste des publications avec la navigation par onglets “Ressources” active et la liste des publications triées par date de mise à jour décroissante] La liste affiche, pour chaque publication :
  • Une miniature visuelle (couverture de livre ou bannière d’article)
  • Le type de publication (Ouvrage ou Article), indiqué par un badge
  • Les thèmes associés, affichés sous forme de badges secondaires
  • Le titre de la publication (cliquable, ouvre la page de visualisation publique)
  • Le ou les auteurs
  • La date de dernière mise à jour
  • Des boutons d’action : Lire et Éditer
Si aucune publication n’existe encore, un message “Aucune publication” s’affiche au centre de la page.

1.3 Créer une nouvelle publication

La création d’une publication se fait depuis la gestion des ouvrages ou des articles, non depuis la page Publications. La page Publications est une vue en lecture seule listant les publications déjà créées.
Rôle requis : Éditeur, Admin, Propriétaire Pour publier un ouvrage :
  1. Allez dans Hub > Ouvrages (https://hub.editions.oya.africa/books).
  2. Ouvrez l’ouvrage que vous souhaitez publier.
  3. Suivez le processus de publication depuis la page d’édition de l’ouvrage.
Pour publier un article :
  1. Allez dans Hub > Articles (https://hub.editions.oya.africa/articles).
  2. Ouvrez l’article que vous souhaitez publier.
  3. Suivez le processus de publication depuis la page d’édition de l’article.
[CAPTURE D’ECRAN: Page d’édition d’un ouvrage avec le bouton ou section de publication visible]

1.4 Lier un ouvrage ou article à une publication

La liaison est automatique : lorsqu’un ouvrage ou un article est publié, la publication qui en résulte lui est automatiquement associée. Cette relation est visible sur la liste des publications via les boutons Éditer, qui renvoient directement vers l’ouvrage ou l’article source :
  • Pour une publication de type Ouvrage : le bouton “Éditer” redirige vers https://hub.editions.oya.africa/books/{documentId}.
  • Pour une publication de type Article : le bouton “Éditer” redirige vers https://hub.editions.oya.africa/articles/{documentId}.

1.5 Consulter et modifier une publication

Rôle requis : Membre (lecture) / Éditeur, Admin (modification) Depuis la liste des publications, deux actions sont disponibles pour chaque entrée : [CAPTURE D’ECRAN: Ligne de publication avec les boutons “Lire” et “Editer” visibles à droite]

2. Gestion de l’Inventaire

2.1 Qu’est-ce que l’inventaire ?

L’inventaire sur Oya Editions correspond au stock physique des ouvrages imprimés. Il permet de suivre :
  • Le nombre d’exemplaires disponibles par pays de distribution
  • Le nombre d’exemplaires réservés (commandes en cours)
  • Le nombre d’exemplaires vendus
  • Un seuil d’alerte pour être notifié quand le stock est bas
Chaque entrée d’inventaire est liée à une publication existante sur la plateforme. La relation entre une publication et son inventaire est de type 1:1.
Distinction physique / numérique : Un ouvrage numérique (isDigitalAsset: true) a un stock défini à -1, ce qui signifie illimité. La gestion de stock décrite ici concerne principalement les ouvrages physiques.

2.2 Accéder à l’inventaire

Rôle requis : Éditeur, Admin, Propriétaire
  1. Dans la navigation latérale du Hub, cliquez sur l’onglet Business.
  2. Sélectionnez Inventaire (icône entrepôt).
Vous arrivez sur la page https://hub.editions.oya.africa/inventory. [CAPTURE D’ECRAN: Page d’inventaire avec les statistiques en haut (4 cartes : Total ouvrages, Stock total, Stock faible, Vendus) et le tableau de stock en dessous] La page affiche : Statistiques globales (4 cartes) :
  • Total ouvrages : nombre d’ouvrages différents en stock
  • Stock total : somme de tous les exemplaires en stock
  • Stock faible : nombre d’ouvrages dont le stock est en dessous du seuil d’alerte (badge “Alerte” rouge si > 0)
  • Vendus : total des exemplaires vendus
Tableau de stock avec les colonnes :
  • Ouvrage (titre)
  • Stock total
  • Réservé (en orange)
  • Vendu (en vert)
  • Statut global : En stock, Stock faible ou Rupture
  • Dernière modification
  • Actions : modifier, voir les détails, supprimer

2.3 Créer une entrée d’inventaire

Rôle requis : Éditeur, Admin, Propriétaire
  1. Depuis la page https://hub.editions.oya.africa/inventory, cliquez sur le bouton Créer un inventaire (en haut à droite).
  2. Vous êtes redirigé vers https://hub.editions.oya.africa/inventory/new.
[CAPTURE D’ECRAN: Formulaire de création d’inventaire avec les champs : sélection de publication, titre du livre, prix, devise, et section pays/quantités] Remplissez le formulaire : Etape 1 — Sélectionner la publication
  • Cliquez sur le champ Publication et recherchez la publication dans la liste déroulante avec recherche intégrée.
  • Le titre du livre se pré-remplit automatiquement une fois la publication sélectionnée (modifiable).
Etape 2 — Configurer le prix
  • Saisissez le prix de vente de l’exemplaire physique.
  • Choisissez la devise parmi : XOF (Franc CFA), EUR (Euro), USD (Dollar).
Etape 3 — Configurer les pays et les quantités
  • Cliquez sur la liste déroulante “Sélectionnez un pays à ajouter” et recherchez le pays.
  • Cliquez sur Ajouter pour l’inclure dans la liste.
  • Pour chaque pays ajouté, saisissez la quantité disponible dans le champ correspondant.
  • Répétez l’opération pour chaque pays de distribution.
  • Le stock total est affiché automatiquement en bas, en additionnant toutes les quantités.
Au moins un pays doit être configuré. Chaque pays doit avoir une quantité valide (>= 0).
  1. Cliquez sur Créer l’inventaire pour valider.
En cas de succès, vous êtes redirigé vers la liste d’inventaire avec un message de confirmation.

2.4 Consulter le stock par pays

Rôle requis : Éditeur, Admin, Propriétaire Depuis le tableau de la page https://hub.editions.oya.africa/inventory, la colonne Stock total indique le stock global. Pour voir le détail par pays :
  • Si un seul pays est configuré : le stock de ce pays s’affiche directement avec son drapeau et un badge de statut.
  • Si plusieurs pays sont configurés : un bouton affiche les drapeaux des pays concernés. En cliquant dessus, une fenêtre popover s’ouvre et liste pour chaque pays :
    • Le drapeau et le nom du pays
    • Le stock disponible
    • La quantité réservée
    • La quantité vendue
    • Le statut du stock (OK / Faible / Rupture)
    • Un bouton crayon pour modifier le stock du pays directement
[CAPTURE D’ECRAN: Popover de stock par pays ouvert, montrant 2-3 pays avec leurs quantités et statuts respectifs]

2.5 Modifier le stock disponible

Rôle requis : Éditeur, Admin, Propriétaire

Via le bouton “Modifier” du tableau

  1. Depuis https://hub.editions.oya.africa/inventory, repérez l’ouvrage dans le tableau.
  2. Cliquez sur l’icône crayon (modifier) dans la colonne Actions.
  3. Vous êtes redirigé vers la page d’édition de cet inventaire (https://hub.editions.oya.africa/inventory/{documentId}/edit).
  4. Modifiez les quantités par pays selon vos besoins.
  5. Validez les modifications.

Via le bouton “Voir les détails”

  1. Cliquez sur l’icône oeil (voir les détails) dans la colonne Actions.
  2. Vous accédez à la fiche détaillée de l’inventaire (https://hub.editions.oya.africa/inventory/{documentId}).
  3. Vous pouvez y modifier les stocks directement.

2.6 Configurer le seuil d’alerte de stock bas

Le seuil d’alerte (ou seuil de réserve) définit la valeur en dessous de laquelle un ouvrage est considéré en “stock faible”. Lors de la création d’un inventaire :
  • Le seuil est défini dans le champ “Seuil de réserve (alerte stock faible)” du formulaire de création.
  • Valeur par défaut : 10 exemplaires.
Lors de la modification d’un inventaire :
  1. Ouvrez la page d’édition de l’inventaire concerné.
  2. Modifiez la valeur du seuil dans le champ dédié.
  3. Sauvegardez.
Comment le seuil fonctionne :

2.7 Exporter les données d’inventaire

Rôle requis : Éditeur, Admin, Propriétaire Un bouton Exporter est disponible en haut à droite de la page d’inventaire, à côté du bouton “Créer un inventaire”. [CAPTURE D’ECRAN: Barre d’actions en haut de la page inventaire avec les boutons “Créer un inventaire” et “Exporter”]

2.8 Supprimer une entrée d’inventaire

Rôle requis : Admin, Propriétaire
  1. Depuis le tableau d’inventaire, cliquez sur l’icône corbeille dans la colonne Actions de la ligne concernée.
  2. Une boîte de dialogue de confirmation s’affiche : “Êtes-vous sûr de vouloir supprimer [titre] de votre stock ?”
  3. Cliquez sur Supprimer pour confirmer. Cette action est irréversible.
  4. Cliquez sur Annuler pour abandonner.
Attention : la suppression efface toutes les données de stock associées à cet ouvrage. Cette action ne peut pas être annulée.

3. Disponibilité et Prix

3.1 Pays supportés

La plateforme Oya Editions supporte actuellement les pays africains suivants pour la distribution physique :
  • BJ — Bénin
  • CI — Côte d’Ivoire
  • GN — Guinée
D’autres pays peuvent être ajoutés selon la configuration de la liste dans config/countries.ts.

3.2 Configurer la disponibilité géographique

La disponibilité géographique d’un ouvrage physique est définie lors de la création ou modification de son inventaire. Lors de la création :
  1. Dans le formulaire https://hub.editions.oya.africa/inventory/new, section “Pays de disponibilité et quantités”.
  2. Ajoutez les pays un à un via la liste déroulante avec recherche.
  3. Définissez une quantité pour chaque pays ajouté.
Lors de la modification :
  1. Depuis le tableau, cliquez sur le bouton Modifier (crayon) de l’inventaire.
  2. Dans la section pays, cochez/décochez les pays de disponibilité.
  3. Ajustez les quantités pour chaque pays coché.
  4. Sauvegardez.
Un ouvrage sans pays configuré n’est disponible nulle part. Il faut au minimum un pays avec une quantité définie.

3.3 Définir les prix par devise et région

Le prix d’un inventaire est unique et s’applique à l’ensemble des pays configurés. Il se définit en deux champs :
  • Prix : valeur numérique (ex. : 2500)
  • Devise : XOF (Franc CFA), EUR (Euro) ou USD (Dollar américain)
[CAPTURE D’ECRAN: Section “Prix et devise” du formulaire de création d’inventaire, avec les deux champs côte à côte] Pour modifier le prix d’un inventaire existant :
  1. Accédez à la page d’édition de l’inventaire (https://hub.editions.oya.africa/inventory/{documentId}/edit).
  2. Modifiez les champs Prix et Devise.
  3. Sauvegardez.
Note : le prix défini dans l’inventaire correspond au prix de vente de la version physique de l’ouvrage. Il peut être différent du prix de la version numérique, qui est géré séparément.

3.4 Distinction inventaire physique / numérique

Dans le tableau d’inventaire, les ouvrages numériques affichent le libellé “Numérique” à la place du nombre d’exemplaires dans la colonne Stock total.

Résumé des permissions par section


Section suivante : Section 5 — Commandes & Transactions