> ## Documentation Index
> Fetch the complete documentation index at: https://docs-editions.oya.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Espace Lecteur

> Bibliothèque personnelle, favoris, listes de lecture, achats et historique des commandes.

# Section 2 — Espace Lecteur

> **Accessible à :** tous les utilisateurs connectés (aucun rôle particulier requis).

L'espace lecteur regroupe l'ensemble des fonctionnalités pensées pour la consommation et l'organisation des publications sur Oya Editions. Il comprend la bibliothèque personnelle, la gestion des favoris, les listes de lecture thématiques, ainsi que l'accès aux publications achetées et à l'historique des commandes.

***

## 2.1 Mes Achats (Bibliothèque)

Vos achats ([https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications)) constituent votre bibliothèque centralisée au sein du tableau de bord (Hub).

### 2.1.1 Accéder à ses achats

1. Connectez-vous à votre compte Oya Editions.
2. Dans le menu latéral gauche du Hub, cliquez sur **"Mon profil"** puis accédez à **"Mes achats"** ou naviguez directement vers [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications).

### 2.1.2 Consulter ses publications acquises

La page "Mes achats" regroupe l'ensemble des publications que vous avez achetées sur la plateforme. Elle vous permet d'avoir une vue d'ensemble de votre catalogue personnel et d'y accéder pour la lecture.

1. Depuis le Hub, accédez à [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications).
2. La page affiche vos publications sous forme de liste ou grille.

### 2.1.3 Rechercher dans ses achats

Vous pouvez utiliser les filtres disponibles sur la page **Mes publications** ([https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications)) pour retrouver rapidement une publication achetée (voir section 2.4).

***

## 2.2 Mes Favoris

La page des favoris ([https://hub.editions.oya.africa/favorites](https://hub.editions.oya.africa/favorites)) vous permet de mettre en signet les publications qui vous intéressent pour les retrouver rapidement.

> **Accessible à :** tous les utilisateurs connectés disposant d'un profil actif.

### 2.2.1 Ajouter une publication aux favoris

L'ajout aux favoris se fait directement depuis le catalogue des publications, sans quitter la page.

1. Naviguez vers le catalogue des publications ([https://hub.editions.oya.africa/publications](https://hub.editions.oya.africa/publications)).
2. Sur chaque carte de publication, repérez l'icône de signet en haut à droite de la couverture.
   * Icône `BookmarkPlus` (signet vide) : la publication n'est pas encore dans vos favoris.
   * Icône `BookmarkCheck` (signet coché, en vert) : la publication est déjà dans vos favoris.
3. Cliquez sur l'icône de signet pour ajouter la publication à vos favoris.
4. L'icône passe instantanément au vert (`BookmarkCheck`) pour confirmer l'ajout.

> **Remarque :** Le bouton favori est désactivé si vous n'êtes pas connecté ou si votre profil n'est pas encore configuré. Assurez-vous d'être connecté avant d'utiliser cette fonctionnalité.

### 2.2.2 Gérer ses favoris

1. Dans le menu latéral du Hub, section **Utilisateur**, cliquez sur **"Mes favoris"** ([https://hub.editions.oya.africa/favorites](https://hub.editions.oya.africa/favorites)).
2. La page affiche toutes vos publications mises en favoris sous forme de grille.
3. Chaque publication est représentée par sa couverture, son titre et ses auteurs.
4. Cliquez sur une publication pour accéder à sa page de détail.

Si vous n'avez aucun favori enregistré, un message s'affiche :

> *"Aucune publication favorite. Ajouter une publication à vos favoris pour la retrouver ici."*

Un bouton **"Consulter les publications"** vous redirige directement vers le catalogue.

### 2.2.3 Retirer un favori

1. Depuis le catalogue ([https://hub.editions.oya.africa/publications](https://hub.editions.oya.africa/publications)) ou depuis la grille des favoris, repérez la publication à retirer.
2. Cliquez sur l'icône `BookmarkCheck` (signet vert) présente sur la carte de la publication.
3. L'icône repasse à `BookmarkPlus` (signet vide) pour confirmer la suppression.
4. La publication disparaît de votre liste de favoris lors de la prochaine consultation de la page [https://hub.editions.oya.africa/favorites](https://hub.editions.oya.africa/favorites).

***

## 2.3 Listes de Lecture

Les listes de lecture ([https://hub.editions.oya.africa/reading-lists](https://hub.editions.oya.africa/reading-lists)) vous permettent d'organiser vos publications en collections thématiques personnalisées, que vous pouvez garder privées ou partager publiquement.

> **Accessible à :** tous les utilisateurs connectés disposant d'un profil actif.

### 2.3.1 Créer une liste de lecture

1. Dans le menu latéral du Hub, cliquez sur **"Listes de lecture"** ([https://hub.editions.oya.africa/reading-lists](https://hub.editions.oya.africa/reading-lists)).

2. En haut à droite de la page, cliquez sur le bouton **"Nouvelle liste"** (icône `+`).

3. Une fenêtre modale s'ouvre avec le formulaire de création.

4. Renseignez les informations suivantes :
   * **Titre** *(obligatoire)* : le nom de votre liste (ex. : "Politique béninoise en 2025").
   * **Description** *(optionnelle)* : une courte présentation de la liste.
   * **Auteur** *(obligatoire)* : sélectionnez un auteur dans la liste déroulante.
   * **Publications** *(optionnelles)* : sélectionnez une ou plusieurs publications à associer à la liste (sélection multiple).
   * **Thèmes** *(optionnels)* : associez des thèmes à votre liste (sélection multiple).
   * **Visibilité** : activez ou désactivez le toggle **Public / Privé** selon vos préférences.
     * **Public** : la liste est visible publiquement sur le site.
     * **Privé** : la liste n'est visible que par vous.

5. Cliquez sur **"Créer"** pour valider.

6. Un message de confirmation **"Liste de lecture créée."** s'affiche et la liste apparaît immédiatement dans le tableau.

> **Remarque :** Les champs **Titre** et **Auteur** sont obligatoires. Le bouton de création reste désactivé tant qu'ils ne sont pas renseignés.

### 2.3.2 Ajouter des publications à une liste

Les publications peuvent être ajoutées à une liste lors de sa **création** ou lors de sa **modification** :

**Lors de la création :**

1. Dans le champ **Publications** du formulaire de création, cliquez sur le champ de sélection.
2. Parcourez la liste des publications disponibles ou recherchez par titre.
3. Sélectionnez une ou plusieurs publications. Chaque sélection s'affiche sous forme de badge.
4. Validez en cliquant sur **"Créer"**.

**Lors de la modification :**

1. Depuis le tableau des listes, cliquez sur le bouton **"Modifier"** (icône crayon) en face de la liste concernée.
2. Dans la modale d'édition, ajoutez ou retirez des publications via le champ **Publications**.
3. Cliquez sur **"Modifier"** pour enregistrer les changements.

### 2.3.3 Gérer et organiser ses listes

Le tableau des listes de lecture affiche, pour chaque liste :

| Colonne              | Description                                                                     |
| -------------------- | ------------------------------------------------------------------------------- |
| **Titre**            | Le nom de la liste, avec son statut Public/Privé                                |
| **Description**      | Un résumé de la liste *(visible sur grands écrans)*                             |
| **Date de création** | La date à laquelle la liste a été créée *(visible sur écrans moyens et larges)* |
| **Actions**          | Boutons Modifier et Supprimer                                                   |

**Modifier une liste :**

1. Cliquez sur le bouton **"Modifier"** (icône crayon) sur la ligne de la liste.
2. La modale s'ouvre avec les informations pré-remplies : titre, description, publications associées, thèmes et visibilité.
3. Effectuez vos modifications.
4. Cliquez sur **"Modifier"** pour enregistrer. Un message **"Liste mise à jour."** confirme l'opération.

**Changer la visibilité directement depuis le tableau :**

1. Sur la ligne d'une liste, repérez le toggle **Public / Privé**.
2. Cliquez sur le toggle pour basculer entre les deux états.
3. Un message de confirmation s'affiche : **"Liste rendue publique."** ou **"Liste rendue privée."**

### 2.3.4 Supprimer une liste

1. Dans le tableau, cliquez sur l'icône **corbeille** (bouton rouge) à droite de la liste à supprimer.
2. Une fenêtre de confirmation s'ouvre avec le message :
   > *"Êtes-vous sûr de vouloir supprimer la liste "\[Nom de la liste]" ? Cette action est irréversible."*
3. Cliquez sur **"Supprimer"** pour confirmer la suppression définitive.
4. Cliquez sur **"Annuler"** pour abandonner l'opération.
5. Un message **"Liste supprimée."** confirme la suppression et la liste disparaît du tableau.

> **Attention :** La suppression d'une liste est irréversible. Les publications associées ne sont pas supprimées, seule la liste est retirée.

***

## 2.4 Mes Publications (Espace Lecteur)

La page **Mes publications** ([https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications)) est l'espace dédié à la consultation et à la lecture des publications que vous avez achetées sur Oya Editions.

> **Accessible à :** tous les utilisateurs connectés. Redirection automatique vers la page de connexion si l'utilisateur n'est pas authentifié.

### 2.4.1 Consulter ses publications achetées

1. Depuis le menu latéral du Hub (section Utilisateur), cliquez sur **"Mes publications"** ([https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications)).
2. La page affiche un message de bienvenue personnalisé avec votre prénom.
3. Toutes vos publications achetées sont présentées sous forme de grille (3 colonnes sur desktop).

Pour chaque publication, la carte affiche :

* La couverture de la publication (pour les ouvrages).
* Le type : badge **"Article"** ou **"Ouvrage"**.
* Le statut de paiement : badge vert **"Payé"**.
* Le titre de la publication.
* La date d'achat.
* Le prix payé (en XOF ou autre devise).
* Un bouton **"Lire maintenant"** pour accéder directement à la lecture.

### 2.4.2 Rechercher et filtrer ses publications

Si vous avez plusieurs publications achetées, des outils de recherche et de filtrage sont disponibles :

**Recherche par titre :**

1. Saisissez un terme dans la barre de recherche (icône loupe) en haut de la page.
2. La liste se filtre en temps réel pour n'afficher que les publications dont le titre correspond à votre recherche.

**Filtrer par type :**

1. Cliquez sur l'un des boutons de filtre :
   * **Tous (n)** : affiche toutes vos publications (n = nombre total).
   * **Ouvrages (n)** : affiche uniquement les livres.
   * **Articles (n)** : affiche uniquement les articles.

2. Le filtre actif est mis en surbrillance.

3. Pour réinitialiser tous les filtres, cliquez sur **"Réinitialiser les filtres"** lorsqu'aucun résultat ne correspond à votre recherche.

### 2.4.3 Lire une publication

1. Depuis la page [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications), repérez la publication souhaitée.
2. Cliquez sur le bouton **"Lire maintenant"** (icône oeil) sur la carte de la publication.
3. Vous êtes redirigé vers le lecteur intégré à l'adresse [https://hub.editions.oya.africa/pubs/\[slug\]/read](https://hub.editions.oya.africa/pubs/\[slug]/read).
4. La lecture s'ouvre directement sans étape supplémentaire.

> **Remarque :** Le bouton "Lire maintenant" n'est disponible que si la publication possède un slug valide. Pour les publications dont les données sont partiellement disponibles, seul le titre et le prix s'affichent.

### 2.4.4 Historique des commandes

L'historique de vos commandes est accessible depuis la page **Mes commandes** ([https://hub.editions.oya.africa/reader/orders](https://hub.editions.oya.africa/reader/orders)).

1. Naviguez vers [https://hub.editions.oya.africa/reader/orders](https://hub.editions.oya.africa/reader/orders) (accessible également depuis le Hub via **"Historique des achats"** à [https://hub.editions.oya.africa/orders](https://hub.editions.oya.africa/orders)).
2. La page affiche l'ensemble de vos commandes passées dans un tableau récapitulatif.

Le tableau des commandes comporte les colonnes suivantes :

| Colonne         | Description                                                                  |
| --------------- | ---------------------------------------------------------------------------- |
| **N° Commande** | Identifiant unique de la commande (format `CMD-xxx`)                         |
| **Client**      | Votre nom et adresse e-mail                                                  |
| **Ouvrage**     | Titre et auteur de la publication commandée                                  |
| **Quantité**    | Nombre d'exemplaires commandés                                               |
| **Montant**     | Montant total réglé (et prix unitaire si quantité > 1)                       |
| **Livraison**   | Statut de livraison (En attente / En préparation / Expédié / Livré / Annulé) |
| **Date**        | Date de la commande                                                          |
| **Actions**     | Bouton pour afficher le détail complet de la commande                        |

**Statuts de paiement possibles :**

* `En attente` — Paiement non encore confirmé.
* `Payé` — Paiement validé.
* `Échoué` — La transaction a échoué.
* `Remboursé` — La commande a été remboursée.

**Statuts de livraison possibles :**

* `En attente` — Commande reçue, traitement non démarré.
* `En préparation` — La commande est en cours de préparation.
* `Expédié` — La commande a été expédiée.
* `Livré` — La commande a été livrée.
* `Annulé` — La commande a été annulée.

3. Cliquez sur le bouton d'action (icône oeil) sur une ligne pour afficher le **détail complet** de la commande dans une modale.

Si vous n'avez encore passé aucune commande, un message s'affiche :

> *"Vous n'avez pas encore passé de commande."*

Un bouton **"Découvrir nos publications"** vous redirige vers le catalogue.

***

## 2.5 Onboarding — Premier accès au compte lecteur

L'onboarding ([https://hub.editions.oya.africa/reader/onboarding](https://hub.editions.oya.africa/reader/onboarding)) est une étape unique réservée aux nouveaux utilisateurs créés par un administrateur de la plateforme. Elle permet d'activer votre compte en définissant votre mot de passe.

> **Accessible à :** uniquement via un lien d'activation reçu par e-mail. Cette étape n'est pas accessible directement depuis la navigation.

### 2.5.1 Expérience de première connexion

Lorsqu'un administrateur crée votre compte lecteur sur Oya Editions, vous recevez un **e-mail d'invitation** contenant un lien d'activation unique.

1. Ouvrez l'e-mail reçu depuis Oya Editions.
2. Cliquez sur le **lien d'activation**. Vous êtes redirigé vers la page [https://hub.editions.oya.africa/reader/onboarding?code=XXXX](https://hub.editions.oya.africa/reader/onboarding?code=XXXX).
3. La plateforme valide automatiquement votre lien d'activation.

**Si le lien est valide :**

* Un écran de bienvenue s'affiche avec le message :
  > *"Bienvenue chez Oya Editions. Bonjour \[Prénom], créez votre mot de passe pour accéder à vos publications."*

**Si le lien est invalide ou expiré :**

* Un message d'erreur s'affiche :
  > *"Ce lien d'activation n'est plus valide ou a expiré."*
* Un bouton **"Retour à l'accueil"** vous ramène à la page principale. Contactez l'administrateur pour recevoir un nouveau lien.

### 2.5.2 Configuration initiale — Création du mot de passe

1. Sur la page d'onboarding, renseignez votre **mot de passe** dans le champ prévu.
   * Le mot de passe doit contenir **au moins 6 caractères**.
   * Cliquez sur l'icône oeil pour afficher ou masquer votre saisie.
2. **Confirmez** votre mot de passe dans le champ "Confirmer le mot de passe".
3. Cliquez sur **"Créer mon mot de passe"**.

**Validations :**

* Si les deux mots de passe ne correspondent pas, un message d'erreur s'affiche : *"Les mots de passe ne correspondent pas."*
* Si le mot de passe est trop court, le message suivant s'affiche : *"Le mot de passe doit contenir au moins 6 caractères."*

4. En cas de succès :
   * Votre session est automatiquement ouverte.
   * Vous êtes immédiatement redirigé vers la page **Mes publications** ([https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications)).
   * Vous avez désormais accès à l'ensemble de l'espace lecteur.

> **Conseil :** Conservez votre mot de passe dans un gestionnaire de mots de passe sécurisé. En cas de perte, utilisez la fonctionnalité **"Mot de passe oublié"** disponible sur la page de connexion ([https://hub.editions.oya.africa/auth/login](https://hub.editions.oya.africa/auth/login)).

***

## Récapitulatif des URLs de l'espace lecteur

| Fonctionnalité              | URL                                                                                                              |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Mes Achats                  | [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications) |
| Mes Favoris                 | [https://hub.editions.oya.africa/favorites](https://hub.editions.oya.africa/favorites)                           |
| Listes de lecture           | [https://hub.editions.oya.africa/reading-lists](https://hub.editions.oya.africa/reading-lists)                   |
| Mes achats (Publications)   | [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications) |
| Historique des commandes    | [https://hub.editions.oya.africa/reader/orders](https://hub.editions.oya.africa/reader/orders)                   |
| Historique des achats (Hub) | [https://hub.editions.oya.africa/orders](https://hub.editions.oya.africa/orders)                                 |
| Lecteur de publication      | [https://hub.editions.oya.africa/pubs/\[slug\]/read](https://hub.editions.oya.africa/pubs/\[slug]/read)          |
| Onboarding lecteur          | [https://hub.editions.oya.africa/reader/onboarding](https://hub.editions.oya.africa/reader/onboarding)           |