Add "Guide-Medecin"

tarzzan 2026-05-20 03:04:13 +00:00
parent 77b3f02edb
commit 20ec395e99

343
Guide-Medecin.-.md Normal file

@ -0,0 +1,343 @@
# 👨‍⚕️ Guide Médecin
> Tutoriel complet pour configurer et utiliser QueueMed au quotidien.
---
## Premiers Pas
### 1. Connexion
Connectez-vous via le bouton **"Se connecter"** sur la page d'accueil. L'authentification utilise Manus OAuth — un seul clic suffit.
```
┌─────────────────────────────────────────────────────────┐
│ │
│ 🏥 QueueMed │
│ │
│ ┌───────────────────────────────┐ │
│ │ │ │
│ │ 👤 Espace Médecin │ │
│ │ │ │
│ │ Connectez-vous pour │ │
│ │ accéder à votre tableau │ │
│ │ de bord. │ │
│ │ │ │
│ │ [ 🔐 Se connecter ] │ │
│ │ │ │
│ └───────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
```
### 2. Onboarding (Première Connexion)
À la première connexion, un **wizard en 3 étapes** vous guide :
```
Étape 1 Étape 2 Étape 3
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
●────────────────────○────────────────────○
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 🏥 Cabinet │ │ ⚙️ Paramètres │ │ ✅ Succès │
│ │ │ │ │ │
│ Nom │ │ Durée moy. │ │ Votre cabinet│
│ Adresse │ │ consultation│ │ est prêt ! │
│ Téléphone │ │ Rotation QR │ │ │
│ Couleur │ │ Taille max │ │ [Dashboard] │
└──────────────┘ └──────────────┘ └──────────────┘
```
| Étape | Champs | Description |
|:------|:-------|:------------|
| 1. Cabinet | Nom, Adresse, Téléphone, Couleur | Informations de base |
| 2. Paramètres | Durée consultation, Rotation QR, Taille max file | Configuration opérationnelle |
| 3. Succès | — | Confirmation + lien vers le dashboard |
---
## Dashboard Principal
### Vue d'Ensemble
```
┌─────────────────────────────────────────────────────────────────────┐
│ 🏥 QueueMed │ Accueil │ Cabinets │ Analytics │ Abonnement │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ Bonjour, Dr. Martin 👋 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 👥 12 │ │ ⏱️ 18min │ │ 📈 +15% │ │ 🏥 3 │ │
│ │ Patients │ │ Attente │ │ vs hier │ │ Cabinets │ │
│ │ aujourd'h│ │ moyenne │ │ │ │ actifs │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 📋 Mes Cabinets [+ Nouveau] │ │
│ ├─────────────────────────────────────────────────────────────┤ │
│ │ │ │
│ │ 🟢 Cabinet Centre-Ville │ 5 en attente │ [Gérer ▶] │ │
│ │ 🟡 Cabinet Quartier Nord │ 2 en attente │ [Gérer ▶] │ │
│ │ ⚪ Cabinet Plage (fermé) │ 0 en attente │ [Gérer ▶] │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────┐ │
│ │ ⚡ Actions rapides │ │
│ │ │ │
│ │ [📱 Onboarding] [❓ Aide] │ │
│ └─────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
### KPIs Affichés
| KPI | Calcul | Période |
|:----|:-------|:--------|
| Patients du jour | Total `patient_joined` events | Aujourd'hui |
| Temps d'attente moyen | Moyenne `waitMinutes` | 7 derniers jours |
| Tendance | Comparaison jour J vs J-1 | Hier |
| Cabinets actifs | Count `isActive = true` | Courant |
---
## Gestion des Cabinets
### Créer un Cabinet
Depuis le dashboard, cliquez **"+ Nouveau cabinet"** :
| Champ | Type | Obligatoire | Description |
|:------|:-----|:-----------:|:------------|
| Nom | Texte | ✅ | Ex: "Cabinet Centre-Ville" |
| Adresse | Texte | ❌ | Adresse postale complète |
| Téléphone | Texte | ❌ | Numéro de contact |
| Couleur | Color picker | ✅ | Couleur d'identification (défaut: teal) |
| Durée consultation | Nombre | ✅ | Minutes par patient (défaut: 15) |
| Rotation QR | Nombre | ✅ | Minutes entre chaque rotation (défaut: 30) |
| Taille max file | Nombre | ✅ | Patients maximum (défaut: 50) |
### QR Code du Cabinet
Chaque cabinet possède un **QR code unique** qui doit être affiché à l'accueil :
```
┌─────────────────────────────────────────────────────────┐
│ │
│ Cabinet Centre-Ville │
│ │
│ ┌─────────────────────────────┐ │
│ │ ┌───────────────────────┐ │ │
│ │ │ ▓▓▓▓▓▓▓ ▓▓▓ ▓▓▓▓▓▓▓ │ │ │
│ │ │ ▓ ▓ ▓ ▓ ▓ ▓ │ │ │
│ │ │ ▓ ▓▓▓ ▓ ▓▓▓ ▓ ▓▓▓ ▓ │ │ [🖨️ Imprimer] │
│ │ │ ▓ ▓▓▓ ▓ ▓ ▓▓▓ ▓ │ │ │
│ │ │ ▓ ▓▓▓ ▓ ▓ ▓ ▓ ▓▓▓ ▓ │ │ [📋 Affiche A4] │
│ │ │ ▓ ▓ ▓▓▓ ▓ ▓ │ │ │
│ │ │ ▓▓▓▓▓▓▓ ▓ ▓ ▓▓▓▓▓▓▓ │ │ [🔄 Forcer │
│ │ │ ▓▓▓▓▓▓▓▓▓▓▓ │ │ rotation] │
│ │ │ ▓▓▓▓▓▓▓ ▓▓▓ ▓▓▓▓▓▓▓ │ │ │
│ │ └───────────────────────┘ │ │
│ │ │ │
│ │ Token: abc...xyz │ │
│ │ Expire dans: 24 min │ │
│ └─────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘
```
### Affiche QR Imprimable (A4)
La page `/qr-poster/:clinicId` génère une affiche A4 prête à imprimer :
```
┌─────────────────────────────────────────┐
│ │
│ 🏥 Cabinet Centre-Ville │
│ │
│ ╔═══════════════════════════════╗ │
│ ║ ║ │
│ ║ [ QR CODE GÉANT ] ║ │
│ ║ ║ │
│ ║ ║ │
│ ╚═══════════════════════════════╝ │
│ │
│ 📱 Scannez ce QR code pour │
│ rejoindre la file d'attente │
│ │
│ ✅ Pas de compte requis │
│ ✅ Suivez votre position en direct │
│ ✅ Recevez une alerte │
│ │
│ ───────────────────────────────── │
│ QueueMed — Votre salle d'attente │
│ virtuelle │
└─────────────────────────────────────────┘
```
---
## Gestion de la File d'Attente
### Interface Principale
```
┌─────────────────────────────────────────────────────────────────────┐
│ 📋 File d'attente — Cabinet Centre-Ville │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ Statut: 🟢 OUVERTE │ En attente: 5 │ Appelé: #12
│ │
│ [🔴 Fermer la file] [🔄 Réinitialiser] [📱 Affiche QR] │
│ │
├─────────────────────────────────────────────────────────────────────┤
│ # │ Patient │ Position │ Attente │ Statut │ Actions │
│────┼──────────────┼──────────┼─────────┼───────────┼────────────────│
│ 12 │ Jean D. │ — │ — │ 🟡 Appelé │ │
│ 13 │ Marie L. │ 1er │ ~15min │ 🟢 Attend │ [📞][❌][🖨️] │
│ 14 │ Pierre M. │ 2ème │ ~30min │ 🟢 Attend │ [📞][❌][🖨️] │
│ 15 │ Sophie R. │ 3ème │ ~45min │ 🟢 Attend │ [📞][❌][🖨️] │
│ 16 │ Lucas B. │ 4ème │ ~60min │ 🟢 Attend │ [📞][❌][🖨️] │
│ 17 │ (sans nom) │ 5ème │ ~75min │ 🟢 Attend │ [📞][❌][🖨️] │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ [ ▶ APPELER LE SUIVANT ] │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
### Actions Disponibles
| Icône | Action | Effet | WebSocket |
|:-----:|:-------|:------|:----------|
| ▶ | Appeler le suivant | Passe le prochain en statut "called" | Notifie patient + écran |
| 📞 | Appeler spécifiquement | Appelle un patient précis (priorité) | Notifie patient + écran |
| ❌ | Marquer absent | Patient ne se présente pas | Met à jour la file |
| 🗑️ | Retirer | Supprime de la file | Met à jour positions |
| 🖨️ | Imprimer ticket | Génère un ticket papier | — |
| 🔴 | Fermer la file | Bloque les nouvelles entrées | Notifie tous |
| 🔄 | Réinitialiser | Remet compteurs à zéro | Vide la file |
### Flux d'Appel
```
Médecin clique "Appeler le suivant"
┌─────────────────────────────────┐
│ 1. Statut → "called" │
│ 2. calledAt = now() │
│ 3. Emit "patient:called" (WS) │
│ 4. Emit "display:update" (WS) │
│ 5. Log analytics event │
└─────────────────────────────────┘
├──────────────────────────────────┐
│ │
▼ ▼
┌─────────────────────┐ ┌─────────────────────┐
│ 📱 Patient reçoit │ │ 📺 Écran affiche │
│ notification push │ │ numéro animé │
│ "C'est votre tour!" │ │ #13 → SALLE 2 │
└─────────────────────┘ └─────────────────────┘
```
---
## Analytics
### Graphiques Disponibles
```
┌─────────────────────────────────────────────────────────────────────┐
│ 📊 Analytics — 7 derniers jours │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ Affluence par heure Répartition par jour │
│ ┌────────────────────────┐ ┌────────────────────────┐ │
│ │ ▓▓ │ │ Lun ████████████ 45 │ │
│ │ ▓▓ ▓▓ │ │ Mar ██████████ 38 │ │
│ │ ▓▓ ▓▓ ▓▓ ▓▓ │ │ Mer ████████████████ 62│ │
│ │ ▓▓ ▓▓ ▓▓ ▓▓ ▓▓ │ │ Jeu ██████████ 40 │ │
│ │ ▓▓ ▓▓ ▓▓ ▓▓ ▓▓ ▓▓ │ │ Ven ████████████████ 58│ │
│ │────────────────────── │ │ Sam ████ 15 │ │
│ │ 8h 9h 10 11 12 14 16 │ │ Dim ██ 5 │ │
│ └────────────────────────┘ └────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 🤖 Recommandations IA │ │
│ │ │ │
│ │ • Pic d'affluence détecté le mercredi entre 9h et 11h. │ │
│ │ Envisagez d'ouvrir plus tôt ou d'ajouter du personnel. │ │
│ │ • Temps d'attente moyen en hausse (+12%). Réduisez la │ │
│ │ durée de consultation ou augmentez la rotation. │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │
│ [📥 Exporter CSV — Cabinet Centre-Ville] │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
### Métriques Calculées
| Métrique | Formule | Usage |
|:---------|:--------|:------|
| Temps d'attente moyen | `AVG(waitMinutes)` par jour | Tendance |
| Taux de présence | `done / (done + absent)` | Fiabilité patients |
| Pic d'affluence | `MAX(count) GROUP BY hourOfDay` | Planification |
| Patients/jour | `COUNT(patient_joined)` par jour | Volume |
| Durée consultation | `AVG(consultationMinutes)` | Calibrage |
---
## Gestion de l'Abonnement
### Plans Disponibles
| Plan | Prix | Cabinets | File | Analytics | Support |
|:-----|:-----|:---------|:-----|:----------|:--------|
| **Essai** | Gratuit (30j) | 1 | Illimitée | Basique | Email |
| **Basic** | 29€/mois | 2 | Illimitée | Complet | Email |
| **Pro** | 59€/mois | Illimité | Illimitée | Complet + IA | Prioritaire |
### Cycle de Vie
```
Inscription → Essai gratuit (30 jours)
├── Souscrit Basic/Pro → ✅ Actif
│ │
│ ├── Renouvellement → ✅ Actif
│ └── Annulation → ⚠️ Actif jusqu'à fin période
└── Pas de souscription → ❌ Bloqué
└── Page /subscription/blocked
"Votre essai a expiré"
```
---
## Conseils d'Utilisation
### Bonnes Pratiques
| Conseil | Détail |
|:--------|:-------|
| **Rotation QR courte** | 15-30 min pour les cabinets à forte affluence |
| **Durée consultation réaliste** | Calibrez sur votre moyenne réelle |
| **Réinitialiser chaque soir** | Évite les résidus du jour précédent |
| **Affiche QR visible** | Placez-la à hauteur des yeux à l'accueil |
| **Écran d'affichage** | Utilisez une tablette dédiée en mode kiosque |
| **Consulter les analytics** | Identifiez vos pics pour mieux planifier |
---
<div align="center">
**[[Home]] | [[Guide-Patient]] | [[Analytics-et-IA]] | [[Administration]]**
</div>