# Guide utilisateur — LabConnect

Ce guide s'adresse aux personnes qui utilisent la plateforme au quotidien (partenaires, agents de collecte,
administrateur) — pas aux développeurs. Pour l'installation technique, voir `README.md`.

Une aide est aussi disponible **directement dans l'application**, en cliquant sur **❓ Aide** dans le
menu, adaptée à votre rôle.

---

## Se connecter

1. Ouvrez `https://capara.tn` (ou l'adresse fournie par votre administrateur).
2. Entrez l'email et le mot de passe qui vous ont été communiqués.
3. Vous arrivez directement sur votre tableau de bord.

Mot de passe oublié ou perdu ? Contactez votre administrateur — lui seul peut le réinitialiser
(Admin > Comptes ou Partenaires > Modifier).

---

## Je suis un partenaire (laboratoire / clinique)

### Faire une demande

Depuis votre tableau de bord, cliquez sur l'un des 4 boutons :

| Bouton | À utiliser pour |
|---|---|
| **Demande de prélèvement** | Planifier une collecte d'échantillons |
| **Demande de consommable** | Commander tubes, étiquettes, sachets, etc. |
| **Réclamation** | Signaler un retard, une perte, une casse, une erreur |
| **Demande de résultats** | Suivre un dossier patient |

Remplissez le formulaire (quantité, créneau souhaité, urgence) et validez. Un agent de collecte est
automatiquement prévenu par email.

### Suivre mes demandes

Le menu du haut (Prélèvement / Consommables / Réclamations / Résultats) liste toutes vos demandes
passées avec leur statut actuel. Les couleurs des badges sont expliquées en haut de chaque liste.

### Pourquoi la quantité affichée peut être différente de ma demande ?

Le agent de collecte indique sur place ce qu'il a **réellement** trouvé. Si le chiffre est différent de ce que
vous avez annoncé, l'administrateur en est automatiquement informé et s'en occupe — vous n'avez rien
à faire de particulier.

---

## Je suis agent de collecte

### Recevoir une demande

Vous recevez un **email** à chaque nouvelle demande, avec un bouton **« Confirmer la collecte »**.
Vous pouvez cliquer dessus directement depuis votre téléphone, sans vous connecter à l'application.
La demande vous est alors automatiquement assignée.

Vous pouvez aussi consulter toutes vos demandes assignées dans **Mes demandes**.

### Confirmer une collecte

Indiquez **la quantité que vous avez réellement collectée** — même si elle est différente de ce qui
était annoncé par le partenaire :

- Vous avez trouvé **autant ou plus** que prévu → rien de spécial, continuez normalement.
- Vous avez trouvé **moins** que prévu → la demande passe en attente de validation par
  l'administrateur. C'est normal, indiquez toujours la vérité.

Vous pouvez ajouter une photo pour appuyer votre déclaration.

### Site fermé, rien à collecter ?

Utilisez le bouton **« Signaler »** avec le motif approprié (pas prêt, fermé, refusé...).

### Fin de tournée : livrer au laboratoire

Ne livrez pas demande par demande. Allez dans **Livrer au laboratoire**, cochez tout ce que vous
avez collecté dans la journée, et indiquez **le total physiquement remis** au labo.

⚠️ Si ce total ne correspond pas exactement à la somme de vos collectes individuelles, le système
bloque automatiquement toutes les demandes du lot pour investigation. Indiquez toujours le chiffre
réel, jamais un chiffre arrangé.

---

## Je suis administrateur

### Gérer les comptes

- **Admin > Partenaires** : créer un partenaire, modifier ses coordonnées, changer son email de
  connexion ou son mot de passe, l'activer/désactiver.
- **Admin > Comptes** : même chose pour les agents de collecte et les autres administrateurs.

### Suivre toutes les demandes

**Admin > Demandes** liste toutes les demandes de tous les partenaires, avec des filtres par type
et statut.

### Traiter les validations (le plus important)

**Admin > Validations** (badge rouge = action en attente) regroupe :

1. **Écarts au ramassage** — un agent de collecte a collecté moins que prévu. Vous pouvez **Approuver** (le
   chiffre du agent de collecte devient définitif) ou **Escalader en litige** (investigation manuelle requise,
   ex. appeler le partenaire ou le agent de collecte).
2. **Lots de livraison avec écart critique** — le total déclaré par un agent de collecte en fin de tournée ne
   correspond pas à la somme de ses collectes. Cliquez sur **Investiguer**, recomptez si besoin avec
   le laboratoire, ajustez les quantités finales, puis clôturez.

C'est ce mécanisme qui garantit qu'aucun prélèvement ne peut se perdre sans que quelqu'un s'en aperçoive.

---

## Questions fréquentes

**Un agent de collecte a démissionné, comment couper son accès immédiatement ?**
Admin > Comptes > Modifier sa fiche > bouton « Désactiver ce compte ». L'accès est bloqué instantanément.

**Un partenaire a changé de contact, comment mettre à jour son login ?**
Admin > Partenaires > Modifier > changez l'email dans « Compte de connexion » et éventuellement le mot
de passe.

**Le agent de collecte n'a pas reçu l'email de notification, que vérifier ?**
Que son adresse email (login) est correcte dans sa fiche, et que le compte est actif.

**Peut-on activer les notifications WhatsApp en plus de l'email ?**
Oui, c'est prévu et déjà en place techniquement, mais désactivé pendant cette phase de validation.
Voir `README.md` pour les détails d'activation le moment venu.