# Recette Imoplex — à tester par l'agence, de A à Z

Guide de validation à dérouler **sur le site en ligne, avec de vraies données**, avant
d'ouvrir l'application aux utilisateurs. Cochez chaque ligne : l'**action** à faire, puis le
**résultat attendu**.

Cette recette concerne **tous les rôles de l'agence** : gérant, agent, comptable, gardien.
Le compte super-administrateur (réglages techniques, sauvegardes, mises à jour) est géré par
le prestataire et n'a pas à être testé ici.

> Conseil : créez un jeu d'essai réaliste (1 propriétaire, 1 bien, 1 locataire, 1 bail),
> déroulez tout le cycle avec, puis supprimez-le à la fin via la corbeille.

---

## A. Chaque rôle accède au bon périmètre

- [ ] **Gérant** : se connecte et voit l'ensemble des menus de gestion (biens, baux,
      encaissements, trésorerie, reversements, personnel, rapports…).
- [ ] **Agent** : se connecte et voit les biens, les prospects et les visites — mais **pas**
      la trésorerie ni les reversements.
- [ ] **Comptable** : se connecte et accède à la trésorerie et aux rapports.
- [ ] **Gardien** : se connecte et accède au suivi de maintenance / ses tâches.
- [ ] **Accès refusé** : un agent qui tente d'ouvrir une page de trésorerie est bloqué.
- [ ] **Déconnexion** : après déconnexion, impossible de revenir sur une page sans se reconnecter.
- [ ] **Mauvais mot de passe** : la connexion est refusée avec un message clair.
- [ ] **Double authentification** : l'activer sur un compte, se déconnecter, se reconnecter →
      un code à 6 chiffres est demandé et fonctionne.

## B. Propriétaires & mandats *(gérant)*

- [ ] **Créer un propriétaire** (nom, téléphone, e-mail) → il apparaît dans la liste.
- [ ] **Créer un mandat de gestion** reliant le propriétaire à un bien, avec sa commission (ex. 10 %).
- [ ] **Créer un mandat de vente** → visible et distinct du mandat de gestion.

## C. Biens *(gérant ; l'agent peut créer et modifier)*

- [ ] **Créer un bien** en location → il apparaît, marqué « disponible ».
- [ ] Créer un bien de chaque autre type : meublé, à vendre, terrain.
- [ ] **Ouvrir la fiche** d'un bien → les informations sont correctes.
- [ ] **Ajouter des photos**, un **état des lieux** et une **charge** → tout s'affiche.
- [ ] **Modifier** un bien → les changements sont enregistrés.
- [ ] **Supprimer** un bien → il quitte la liste et se retrouve dans la **Corbeille**.

## D. Locataires & baux *(gérant)*

- [ ] **Créer un locataire** (nom, téléphone, e-mail).
- [ ] **Créer un bail** sur un bien disponible, avec un ou plusieurs locataires (colocation).
- [ ] Le bien passe automatiquement en **loué / occupé**.
- [ ] **Clés & badges** : remettre puis restituer une clé sur le bail.
- [ ] **Caution** : enregistrer la caution → un reçu de caution est créé.
- [ ] **Réviser le loyer** (nouveau montant, date d'effet) → l'ancien montant reste dans l'historique.

## E. Encaissements & quittances *(gérant, comptable)*

- [ ] **Encaisser un loyer** sur un bail (montant, espèces) :
      - une **quittance / un reçu numéroté** est créé,
      - le **solde de la caisse augmente** du montant,
      - si le locataire a une adresse e-mail, il **reçoit sa quittance par e-mail**.
- [ ] **Vérifier une quittance** : ouvrir le lien de la quittance → la page de vérification
      affiche bien le document.
- [ ] **Numéros qui se suivent** : générer plusieurs reçus → les numéros se suivent, sans trou
      ni doublon.
- [ ] **Déclaration de paiement** : un paiement déclaré peut être **validé** par l'agence.
- [ ] **Encaisser une caution** séparément → reçu de caution.

## F. Trésorerie *(gérant, comptable)*

- [ ] **Consulter les caisses** → les soldes correspondent aux encaissements.
- [ ] **Enregistrer une dépense** → le solde diminue.
- [ ] **Transférer** de l'argent d'une caisse à une autre → le total général ne change pas.
- [ ] **Taxes et charges** : enregistrer, puis marquer payé.
- [ ] **Créances** de l'agence : correctement affichées.

## G. Reversements aux propriétaires *(gérant, comptable)*

- [ ] **Générer un reversement** pour un mandat de gestion sur une période →
      le net = loyers encaissés − commission − dépenses déduites.
- [ ] **Verser** le reversement → une **sortie de caisse** est enregistrée, le reversement est marqué « reversé ».
- [ ] **Avance de frais** : en enregistrer une, l'accorder, vérifier qu'elle se déduit d'un reversement.

## H. Meublé & réservations *(gérant)*

- [ ] **Créer une réservation** (dates, tarif, acompte, caution).
- [ ] **Ajouter des frais** (ménage, blanchisserie…) → le total = séjour + frais.
- [ ] Faire évoluer la réservation : réservé → en cours → terminé.

## I. Ventes *(gérant)*

- [ ] **Ouvrir un dossier de vente** sur un bien sous mandat de vente.
- [ ] **Encaisser** un montant sur ce dossier → un reçu de vente est créé.

## J. Prospects, visites, parrainages *(agent, gérant)*

- [ ] **Créer un prospect**, **planifier une visite**, puis la marquer effectuée.
- [ ] **Parrainage** : enregistrer un parrainage, le passer en « filleul signé », puis
      **verser la récompense** → sortie de caisse.

## K. Personnel & RH *(gérant ; gardien pour la maintenance)*

- [ ] **Registre du personnel** : créer un gardien / employé et l'**affecter** à un bien.
- [ ] **Congés** (demande → accordé/refusé), **incidents**, **présence** (pointage),
      **rémunération** (→ dépense de caisse).
- [ ] **Objectifs** des agents : en fixer un, vérifier le suivi.
- [ ] **Commissions internes** : en enregistrer une, la régler → dépense de caisse.
- [ ] **Maintenance** *(gardien)* : ouvrir un ticket, le suivre jusqu'à résolution.

## L. Communication & e-mails *(gérant)*

- [ ] **Adresse d'expédition** : renseigner l'e-mail et le nom de l'agence, puis
      **envoyer un e-mail de test** → il est bien reçu.
- [ ] **Modèles** de messages et de documents : en créer, modifier, activer/désactiver.
- [ ] **Rappels de loyer** : vérifier qu'un locataire reçoit un rappel par e-mail avant l'échéance.

## M. Listes & suivi *(gérant)*

- [ ] **Importer une liste** (locataires ou propriétaires) depuis un fichier fourni →
      les fiches sont créées, les éventuelles erreurs sont signalées.
- [ ] **Relevés** (banque / mobile money) : en déposer un → enregistré, un doublon est refusé.

## N. Rapports & tableau de bord *(gérant, comptable)*

- [ ] **Tableau de bord** : les indicateurs (encaissements, impayés, taux d'occupation…)
      reflètent bien les données saisies.
- [ ] **Rapports** : les générer et, si besoin, les exporter.

## O. Corbeille *(gérant)*

- [ ] **Restaurer** un élément supprimé (bien, locataire…) → il réapparaît à l'identique.
- [ ] **Purger** un élément → il est supprimé définitivement.

## P. Sur téléphone

- [ ] Ouvrir l'application **sur un mobile** : le menu est accessible, les pages sont lisibles,
      les grands tableaux défilent horizontalement, les formulaires sont utilisables.
- [ ] Les **icônes** s'affichent et les **couleurs** sont bien celles de l'agence.

---

### La recette est réussie si…

- chaque rôle accède uniquement à ce qui le concerne ;
- le cycle **bien → bail → encaissement → quittance → reversement** fonctionne de bout en bout ;
- les **soldes de caisse** sont exacts ;
- les **numéros** de quittances se suivent sans trou ;
- les **e-mails** (quittances, rappels, test) sont bien reçus ;
- la **corbeille** restaure correctement.

Notez toute anomalie (page, bouton, message, écran) afin qu'elle soit corrigée avant l'ouverture.
