> ## 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.

# Introduction & Premiers pas

> Présentation de la plateforme Oya Editions, création de compte, connexion et navigation générale.

# Section 1 — Introduction & Premiers pas

> **Oya Editions** — Documentation de prise en main de la plateforme
> Version : avril 2026

***

## 1. Présentation de la plateforme

### 1.1 Qu'est-ce qu'Oya Editions ?

Oya Editions est une plateforme numérique de publication et de vente de livres et d'articles dédiée aux créateurs africains. Elle a été fondée par **Atinoukê AMADOU** avec pour objectif la vulgarisation des droits africains — textes, jurisprudence, doctrine — et, plus largement, la mise en valeur de la création intellectuelle et littéraire du continent.

La plateforme se compose de deux espaces complémentaires :

* **Le site public** (`editions.oya.africa`) : espace de découverte et d'achat des publications pour le grand public.
* **L'espace privé / hub** ([https://hub.editions.oya.africa](https://hub.editions.oya.africa)) : tableau de bord réservé aux utilisateurs connectés, permettant de gérer son profil, ses achats, son contenu éditorial et son équipe.

### 1.2 À quoi sert la plateforme ?

| Besoin                           | Ce que la plateforme permet                                |
| -------------------------------- | ---------------------------------------------------------- |
| Lire des publications numériques | Accéder à ses achats, les lire en ligne                    |
| Créer et publier du contenu      | Rédiger livres et articles, les soumettre à la publication |
| Gérer une maison d'édition       | Organiser une équipe, suivre les ventes et transactions    |
| Administrer la plateforme        | Gérer les auteurs, éditeurs et thèmes à l'échelle globale  |

### 1.3 Les profils utilisateurs

La plateforme distingue plusieurs types d'utilisateurs, chacun disposant d'un périmètre d'accès spécifique.

***

#### Lecteur (`reader`)

> Accès : espace lecteur uniquement ([https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications), favoris, listes de lecture, profil)

Le Lecteur est un utilisateur qui crée un compte pour accéder aux publications qu'il a achetées. Il n'appartient à aucune équipe et ne peut pas créer de contenu.

**Ce qu'il peut faire :**

* Consulter et lire ses publications achetées
* Gérer ses favoris
* Gérer ses listes de lecture
* Modifier son profil personnel

***

#### Membres d'une équipe éditoriale

Les utilisateurs membres d'une équipe ont accès à l'espace hub complet ([https://hub.editions.oya.africa](https://hub.editions.oya.africa)). À l'intérieur d'une équipe, chaque membre dispose d'un **rôle** qui détermine ses droits.

| Rôle          | Nom affiché        | Description                                  |
| ------------- | ------------------ | -------------------------------------------- |
| `viewer`      | Lecteur            | Peut consulter les ressources de l'équipe    |
| `contributor` | Contributeur       | Peut consulter et modifier les ressources    |
| `editor`      | Éditeur (création) | Peut créer, consulter et modifier du contenu |
| `admin`       | Administrateur     | Droits administratifs complets sur l'équipe  |
| `owner`       | Propriétaire       | Propriétaire de l'équipe, tous les droits    |

**Résumé des accès par rôle au sein d'une équipe :**

| Fonctionnalité           | Viewer | Contributor | Editor | Admin | Owner |
| ------------------------ | :----: | :---------: | :----: | :---: | :---: |
| Consulter les ressources |    ✓   |      ✓      |    ✓   |   ✓   |   ✓   |
| Modifier les ressources  |    —   |      ✓      |    ✓   |   ✓   |   ✓   |
| Créer du contenu         |    —   |      —      |    ✓   |   ✓   |   ✓   |
| Listes de lecture        |    —   |      —      |    ✓   |   ✓   |   ✓   |
| Suivre le business       |    —   |      —      |    ✓   |   ✓   |   ✓   |
| Paramètres de l'équipe   |    —   |      —      |    —   |   ✓   |   ✓   |
| Inviter des membres      |    —   |      —      |    —   |   ✓   |   ✓   |

***

#### Super Administrateur

> Accès : section **Admin Editions** dans la barre latérale, en plus des accès habituels

Le Super Administrateur est un rôle système (non lié à une équipe). Il gère la plateforme dans son ensemble.

**Ce qu'il peut faire en plus :**

* Gérer les auteurs ([https://hub.editions.oya.africa/admin/authors](https://hub.editions.oya.africa/admin/authors))
* Gérer les éditeurs ([https://hub.editions.oya.africa/admin/editors](https://hub.editions.oya.africa/admin/editors))
* Gérer les thèmes de publication ([https://hub.editions.oya.africa/admin/themes](https://hub.editions.oya.africa/admin/themes))

***

## 2. Créer un compte

### 2.1 Inscription standard

La création de compte est accessible depuis la page [https://hub.editions.oya.africa/auth/register](https://hub.editions.oya.africa/auth/register).

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/se-connecter.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=26ee4e7e488a66ddf7cb548882707a85" width="2986" height="1804" data-path="images/se-connecter.png" />
</Frame>

**Étape 1 — Choisir son type de compte**

1. Rendez-vous sur la page d'inscription via le bouton **"Créez votre compte"** depuis la page de connexion, ou accédez directement à l'URL [https://hub.editions.oya.africa/auth/register](https://hub.editions.oya.africa/auth/register).
2. Choisissez votre **type de compte** :
   * **Lecteur** : pour accéder à vos achats sans appartenir à une équipe.
   * **Éditeur** : pour créer et gérer du contenu au sein d'une équipe (une équipe sera nécessaire après la connexion).
3. Cliquez sur **"Continuer"**.

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/inscription-step-1.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=3adc638f5337bc0709b71b89199f8883" width="2986" height="1802" data-path="images/inscription-step-1.png" />
</Frame>

**Étape 2 — Saisir ses informations**

4. Renseignez les champs suivants :
   * **Prénom**
   * **Nom**
   * **Adresse e-mail** (ex. : `nom@exemple.com`)
   * **Mot de passe**
5. Vous pouvez afficher ou masquer votre mot de passe en cliquant sur l'icône en forme d'oeil.
6. Cliquez sur **"Créer le compte"**.

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/inscription-step-2.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=344ac1739569c03274bf7adf7dfa8167" width="3008" height="1810" data-path="images/inscription-step-2.png" />
</Frame>

> Un message de confirmation s'affiche : **"Compte créé. Vérifiez votre boite mail pour activer le compte."**

7. Vous êtes automatiquement redirigé vers la page de connexion.

***

### 2.2 Confirmation de l'adresse e-mail

Après l'inscription, un e-mail de confirmation est envoyé à l'adresse renseignée.

1. Ouvrez votre boîte mail et recherchez un e-mail provenant d'Oya Editions.
2. Cliquez sur le **lien de confirmation** contenu dans l'e-mail.
3. Vous êtes redirigé vers la page [https://hub.editions.oya.africa/auth/confirmed](https://hub.editions.oya.africa/auth/confirmed) qui affiche le message : **"Compte vérifié ! Votre compte a été vérifié. Vous pouvez maintenant vous connecter."**
4. Cliquez sur le bouton **"Se connecter"** pour accéder à votre compte.

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/email-confirmation.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=5c4fd1fe678d4b8295d2a3eb25b9bf71" width="2844" height="1656" data-path="images/email-confirmation.png" />
</Frame>

> **Important :** Si vous tentez de vous connecter avant d'avoir confirmé votre adresse e-mail, le système vous affichera le message : *"Courriel non vérifié. Vérifiez votre boîte mail, puis cliquez sur le lien de confirmation."* Vous serez redirigé vers la page de confirmation.

***

### 2.3 Accepter une invitation d'équipe

Un administrateur d'équipe peut vous inviter à rejoindre son espace éditorial. Vous recevrez alors un lien d'invitation par e-mail.

**Cas 1 — Vous n'avez pas encore de compte**

1. Cliquez sur le lien d'invitation reçu par e-mail. Vous êtes redirigé vers [https://hub.editions.oya.africa/invites?code=XXXX](https://hub.editions.oya.africa/invites?code=XXXX).

2. La plateforme affiche les détails de l'invitation : nom de l'équipe, rôle qui vous est attribué, et e-mail destinataire.

3. Cliquez sur **"Accepter"**.

4. Comme vous n'avez pas de compte, vous êtes redirigé vers la page d'inscription ([https://hub.editions.oya.africa/auth/register](https://hub.editions.oya.africa/auth/register)) avec votre e-mail pré-rempli. Votre choix de type de compte est automatiquement défini sur **"Éditeur"**.

5. Complétez le formulaire d'inscription (prénom, nom, mot de passe) et créez votre compte.

6. Après confirmation de votre e-mail et connexion, l'invitation est automatiquement récupérée et affichée.

7. Confirmez l'acceptation. Vous rejoignez l'équipe avec le rôle défini dans l'invitation.

**Cas 2 — Vous avez déjà un compte**

1. Cliquez sur le lien d'invitation. Vous êtes redirigé vers [https://hub.editions.oya.africa/invites?code=XXXX](https://hub.editions.oya.africa/invites?code=XXXX).
2. La page affiche les détails de l'invitation. Cliquez sur **"Accepter"**.
3. Vous êtes redirigé vers la page de connexion avec votre code d'invitation conservé.
4. Connectez-vous avec vos identifiants habituels.
5. Après connexion, vous êtes automatiquement redirigé vers la page des invitations pour confirmer votre adhésion.
6. Cliquez sur **"Accepter"** pour rejoindre l'équipe.

Si des invitations vous attendent au moment de votre connexion (sans lien direct), la plateforme vous en informera automatiquement via une modale et vous redirigera vers [https://hub.editions.oya.africa/invites](https://hub.editions.oya.africa/invites) pour les traiter.

***

## 3. Se connecter

### 3.1 Connexion standard

La page de connexion est accessible à l'URL [https://hub.editions.oya.africa/auth/login](https://hub.editions.oya.africa/auth/login).

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/se-connecter.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=26ee4e7e488a66ddf7cb548882707a85" width="2986" height="1804" data-path="images/se-connecter.png" />
</Frame>

1. Saisissez votre **adresse e-mail** dans le premier champ.
2. Saisissez votre **mot de passe** dans le second champ. Cliquez sur l'icône en forme d'oeil pour afficher/masquer le mot de passe.
3. Cliquez sur le bouton **"Se connecter"**.

**Redirection après connexion :**

Le système vous redirige automatiquement selon votre profil :

| Situation                    | Redirection                                                                                                      |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Lecteur sans équipe ni achat | Modale de création d'équipe ou espace lecteur                                                                    |
| Lecteur avec des achats      | [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications) |
| Membre d'une seule équipe    | Tableau de bord de l'équipe ([https://hub.editions.oya.africa](https://hub.editions.oya.africa))                 |
| Membre de plusieurs équipes  | Modale de sélection d'équipe                                                                                     |
| Invitation en attente        | Page des invitations ([https://hub.editions.oya.africa/invites](https://hub.editions.oya.africa/invites))        |

> **Note :** Si votre e-mail n'est pas encore confirmé, vous serez redirigé vers la page de confirmation et un message d'erreur vous demandera de vérifier votre boîte mail.

***

### 3.2 Réinitialisation du mot de passe

Si vous avez oublié votre mot de passe, vous pouvez en demander la réinitialisation depuis la page de connexion.

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/reset-password.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=8ec0589cbb8091ec7a0e111f7814e965" width="2998" height="1814" data-path="images/reset-password.png" />
</Frame>

1. Sur la page de connexion, cliquez sur le lien **"Réinitialisez votre mot de passe"**.
2. Vous êtes redirigé vers [https://hub.editions.oya.africa/auth/password-reset](https://hub.editions.oya.africa/auth/password-reset).
3. Saisissez l'**adresse e-mail** associée à votre compte.
4. Soumettez le formulaire.
5. Un e-mail contenant un lien de réinitialisation vous est envoyé.

> Cette page est accessible uniquement si vous n'êtes pas connecté. Si vous êtes déjà connecté, vous serez automatiquement redirigé vers votre espace.

***

### 3.3 Mise à jour du mot de passe

Après avoir cliqué sur le lien de réinitialisation reçu par e-mail, vous êtes redirigé vers la page de mise à jour du mot de passe ([https://hub.editions.oya.africa/auth/password-update](https://hub.editions.oya.africa/auth/password-update)).

1. Le lien reçu par e-mail contient un **code de vérification** passé automatiquement en paramètre URL (`?code=XXXX&email=XXXX`).
2. Saisissez votre **nouveau mot de passe** dans le formulaire.
3. Confirmez en cliquant sur le bouton de validation.
4. Une fois le mot de passe mis à jour, connectez-vous avec vos nouveaux identifiants.

> **Important :** Si vous accédez à cette page sans code de vérification valide dans l'URL, ou si vous êtes déjà connecté, vous serez automatiquement redirigé vers l'espace hub.

***

## 4. Mon profil

> Accessible à tous les utilisateurs connectés — Lecteurs, Membres d'équipe, Administrateurs, Super Administrateurs.

### 4.1 Accéder à son profil

Le profil personnel est accessible depuis l'URL [https://hub.editions.oya.africa/profile](https://hub.editions.oya.africa/profile).

**Depuis la barre latérale :**

1. Dans la barre de navigation à gauche, repérez la section de navigation personnelle (en bas de la barre).
2. Cliquez sur **"Mon profil"**.

<Frame>
  <img src="https://mintcdn.com/cisse/3gpx9vdgeVqvVc6L/images/mon-profil.png?fit=max&auto=format&n=3gpx9vdgeVqvVc6L&q=85&s=4f17a141af7d21f9f1f2ffff9bf59e16" width="2990" height="1724" data-path="images/mon-profil.png" />
</Frame>

### 4.2 Modifier ses informations

La page de profil présente un onglet **"Compte"** contenant les informations personnelles modifiables.

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/profil.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=a598830cede7071e89a6fdbdb1283a89" width="3008" height="1802" data-path="images/profil.png" />
</Frame>

**Champs modifiables :**

* **Prénom**
* **Nom**

**Pour modifier vos informations :**

1. Naviguez vers [https://hub.editions.oya.africa/profile](https://hub.editions.oya.africa/profile).
2. Dans l'onglet **"Compte"**, repérez les champs **Prénom** et **Nom**.
3. Cliquez dans le champ à modifier et saisissez la nouvelle valeur.
4. Cliquez sur le bouton **"Enregistrer"** pour sauvegarder les modifications.
5. Un message de confirmation s'affiche : **"Profil mis à jour avec succès"**.

> La date de création du compte est affichée en haut de la section, à titre d'information.

### 4.3 Informations non modifiables depuis le profil

L'**adresse e-mail** n'est pas modifiable directement depuis la page de profil. Pour toute modification, contactez le support via `info@oya.africa`.

***

## 5. Navigation générale

### 5.1 Structure de l'interface

L'interface de l'espace privé ([https://hub.editions.oya.africa](https://hub.editions.oya.africa)) se compose de :

* Une **barre latérale gauche** (sidebar) — navigation principale, visible sur desktop
* Une **barre supérieure** (topbar) — avec le bouton menu sur mobile et les actions rapides
* Une **zone de contenu principal** — qui affiche la page active

<Frame>
  <img src="https://mintcdn.com/cisse/zztjVAMi_HyJzuw_/images/interface-structure.png?fit=max&auto=format&n=zztjVAMi_HyJzuw_&q=85&s=bdb00ce224536c1c4503df815836f27a" width="3008" height="1812" data-path="images/interface-structure.png" />
</Frame>

Sur mobile, la barre latérale est masquée par défaut. Elle s'ouvre en cliquant sur l'icône de menu (trois barres horizontales) en haut à gauche.

***

### 5.2 La barre latérale — navigation principale

La barre latérale est organisée en **trois sections**, dont la visibilité dépend du profil de l'utilisateur connecté.

#### Section "Team" (visible si vous êtes membre d'au moins une équipe)

En haut de la sidebar, votre rôle au sein de l'équipe active est affiché. Un **sélecteur d'équipe** permet de basculer entre plusieurs équipes si vous en êtes membre.

<Frame>
  <img src="https://mintcdn.com/cisse/3gpx9vdgeVqvVc6L/images/section-team.png?fit=max&auto=format&n=3gpx9vdgeVqvVc6L&q=85&s=ad1e013a656ff8964ebf5311fe7aed8f" width="2938" height="1818" data-path="images/section-team.png" />
</Frame>

Les entrées de cette section varient selon votre rôle :

| Entrée                     | Rôle minimum requis |
| -------------------------- | ------------------- |
| Création de vos ressources | Contributeur        |
| Listes de lecture          | Éditeur             |
| Suivez votre business      | Éditeur             |
| Paramètres de l'équipe     | Administrateur      |

#### Section "Admin Editions" (visible uniquement pour les Super Administrateurs)

Cette section apparaît uniquement pour les comptes Super Administrateur. Elle donne accès à :

* **Gestion des auteurs** ([https://hub.editions.oya.africa/admin/authors](https://hub.editions.oya.africa/admin/authors))
* **Gestion des éditeurs** ([https://hub.editions.oya.africa/admin/editors](https://hub.editions.oya.africa/admin/editors))
* **Gestion des thèmes** ([https://hub.editions.oya.africa/admin/themes](https://hub.editions.oya.africa/admin/themes))

#### Section personnelle (visible pour tous les utilisateurs connectés)

Cette section est toujours présente. Elle donne accès aux fonctionnalités personnelles :

| Entrée            | URL                                                                                                              | Description                    |
| ----------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| Mes favoris       | [https://hub.editions.oya.africa/favorites](https://hub.editions.oya.africa/favorites)                           | Publications sauvegardées      |
| Listes de lecture | [https://hub.editions.oya.africa/reading-lists](https://hub.editions.oya.africa/reading-lists)                   | Listes de lecture personnelles |
| Mes achats        | [https://hub.editions.oya.africa/reader/my-publications](https://hub.editions.oya.africa/reader/my-publications) | Publications achetées          |
| Mon profil        | [https://hub.editions.oya.africa/profile](https://hub.editions.oya.africa/profile)                               | Informations personnelles      |

> **Note :** L'entrée "Mes achats" est masquée dans la section personnelle lorsque l'utilisateur est membre d'une équipe (elle reste accessible directement via l'URL).

***

### 5.3 Le tableau de bord principal

Accessible via [https://hub.editions.oya.africa](https://hub.editions.oya.africa), le tableau de bord présente un accueil personnalisé avec :

* Un message de bienvenue affichant votre prénom et le nom de votre équipe active
* Des **actions rapides** sous forme de cartes cliquables :
  * Créer un livre
  * Créer un article
  * Gérer le stock
  * Gérer vos listes de lecture
  * Gérer les membres

<Frame>
  <img src="https://mintcdn.com/cisse/3gpx9vdgeVqvVc6L/images/5.3-Le-tableau-de-bord-principal.png?fit=max&auto=format&n=3gpx9vdgeVqvVc6L&q=85&s=ef85802d140f1197319c48924014c160" width="2946" height="1816" data-path="images/5.3-Le-tableau-de-bord-principal.png" />
</Frame>

> Le tableau de bord complet avec les actions rapides est accessible uniquement aux membres d'une équipe. Les utilisateurs sans équipe sont redirigés vers leurs favoris.

***

### 5.4 Changer d'équipe

Si vous êtes membre de plusieurs équipes, le **sélecteur d'équipe** (visible en haut de la section Team dans la sidebar) vous permet de basculer d'une équipe à l'autre à tout moment.

<Frame>
  <img src="https://mintcdn.com/cisse/3gpx9vdgeVqvVc6L/images/changer-equipe.png?fit=max&auto=format&n=3gpx9vdgeVqvVc6L&q=85&s=338f134520d98b37acc2c13adefdacee" width="2946" height="1814" data-path="images/changer-equipe.png" />
</Frame>

1. Cliquez sur le sélecteur d'équipe dans la barre latérale.
2. Sélectionnez l'équipe souhaitée dans la liste.
3. Le hub se recharge avec le contexte de la nouvelle équipe active.

***

### 5.5 Se déconnecter

Pour vous déconnecter de la plateforme :

1. Naviguez vers [https://hub.editions.oya.africa/auth/logout](https://hub.editions.oya.africa/auth/logout) ou cliquez sur le bouton de déconnexion disponible dans votre espace.
2. Votre session est fermée et vous êtes redirigé vers la page d'accueil.

***

*Pour toute question ou assistance, contactez l'équipe Oya Editions à l'adresse : [info@oya.africa](mailto:info@oya.africa)*
