# AMANSA-VOYAGE — Cahier des charges

## Objectif

Digitaliser le processus de traitement des dossiers de demande de visa de l'agence AMANSA-VOYAGE, de la création du dossier jusqu'à sa restitution au client.

## Acteurs

| Rôle | Description |
|---|---|
| `ROLE_ADMIN` | Administrateur, supervise l'ensemble des utilisateurs |
| `ROLE_COMPTABLE` | Comptable, supervise les dispatchers et les agents, encaisse les honoraires |
| `ROLE_DISPATCHER` | Crée et affecte les dossiers, gère les dépôts physiques et les retraits à l'ambassade |
| `ROLE_AGENT` | Traite les dossiers qui lui sont affectés |

### Hiérarchie

```
ROLE_ADMIN
 └── ROLE_COMPTABLE
      └── ROLE_DISPATCHER
           └── ROLE_AGENT
```

Chaque rôle peut, **uniquement sur les rôles qui lui sont inférieurs** :

- créer des comptes ;
- bloquer des comptes ;
- superviser les travaux et suivre l'activité.

Exemples : l'admin supervise tout le monde, le comptable supervise les dispatchers et les agents, le dispatcher supervise les agents.

## Authentification

- Connexion par **email + mot de passe**.
- Durée de session : **1 semaine**.
- **Pas** de fonctionnalité « mot de passe oublié ».
- En cas d'oubli, un utilisateur de rang supérieur (admin, comptable ou dispatcher, selon la hiérarchie) génère un **mot de passe temporaire**, envoyé par email.
- L'utilisateur doit **modifier ce mot de passe à sa première connexion**.

## Dossier

Un dossier correspond à une demande d'un client. Un même client peut revenir plusieurs fois pour des demandes différentes : il a donc plusieurs dossiers.

### Informations du client

| Champ | Obligatoire |
|---|---|
| Prénom | Oui |
| Nom | Oui |
| Téléphone | Oui |
| Numéro de passeport (identifiant du client) | Oui |

### Documents joints

L'utilisateur peut joindre des documents au dossier et définit lui-même le **libellé** de chaque document.

### Informations optionnelles (proposées)

- Email du client
- Date de naissance
- Nationalité
- Date d'expiration du passeport
- Pays de destination / type de visa
- Observations / notes internes

## Processus de traitement

| # | Étape | Acteur |
|---|---|---|
| 1 | **Création du dossier** | Dispatcher ou Agent |
| 2 | **Affectation** du dossier à un agent | Dispatcher |
| 3 | **Soumission en ligne** sur la plateforme de l'ambassade | Agent |
| 4 | **Suivi** du dossier sur la plateforme de l'ambassade | Agent |
| 5 | **Récupération du papier de validation** sur la plateforme de l'ambassade | Agent |
| 6 | **Dépôt physique** à l'ambassade, par lots | Dispatcher |
| 7 | **Avis** de l'ambassade : favorable ou défavorable | Agent |
| 8 | **Retrait des documents** à l'ambassade | Dispatcher |
| 9 | **Récupération du dossier** et mise à jour du statut | Agent |
| 10 | **Paiement des honoraires** | Agent responsable ou Comptable |
| 11 | **Restitution du dossier** au client — fin du traitement | Agent |

### Précisions par étape

**Affectation (2)** — Chaque agent ne voit **que les dossiers qui lui sont affectés**.

**Dépôt physique (6)** — Le dispatcher prépare des **lots** regroupant plusieurs dossiers. Pour chaque lot, il renseigne :

- les dossiers qui le composent ;
- la date de retrait prévue ;
- les reçus ;
- des images (photos, scans) ;
- le montant payé pour les frais de dépôt.

**Avis (7)** — En cas d'avis **défavorable** (rejet), le dossier retourne à l'étape de **soumission en ligne (3)**.

**Retrait (8–9)** — Le dispatcher signale le retrait dans la plateforme. Les agents concernés récupèrent alors leurs dossiers, mettent à jour leur statut et poursuivent le traitement (encaissement des honoraires, restitution).

**Paiement (10)** — L'argent peut être reçu soit par l'agent responsable du dossier, soit par le comptable.

## Règles retenues (implémentation)

- **Ambassades :** il y en a plusieurs, gérées par l'admin. Chaque dossier et chaque lot est rattaché à une ambassade, et un lot ne regroupe que des dossiers d'une même ambassade.
- **Création par un agent :** le dossier reste **non affecté**, et l'agent ne le voit plus tant que le dispatcher ne l'a pas affecté.
- **Client existant :** il est retrouvé automatiquement par son numéro de passeport lors de la création d'un nouveau dossier.
- **Papier de validation (5) :** le dossier ne peut être marqué « prêt pour un lot » qu'avec au moins une pièce de catégorie « Papier de validation ».
- **Avis (7) :** il peut être saisi sur le dossier par l'agent ou le dispatcher, ou par le dispatcher lors du retrait du lot (un avis par dossier).
  - Avis favorable : le dossier passe à « Retiré » et l'agent est notifié pour le récupérer.
  - Avis défavorable : le dossier passe à « Rejeté » et doit être resoumis en ligne. Le compteur de soumissions est incrémenté.
- **Restitution (11) :** elle est **bloquée tant que le solde des honoraires n'est pas réglé**. Le comptable ou l'admin peut forcer la clôture en indiquant un motif.
- **Annulation :** elle est possible par le dispatcher et au-dessus, avec un motif obligatoire.
- **Montants :** en FCFA. Références automatiques : `AV-2026-00001` pour les dossiers, `LOT-2026-001` pour les lots, `REC-2026-00001` pour les reçus.
- **Documents générés :** bordereau de dépôt du lot (PDF), reçu de paiement (PDF), export Excel des dossiers.
- **Fichiers :** les fichiers joints sont stockés hors du dossier public et ne sont téléchargeables qu'après contrôle des droits.