Guide d'utilisation — Plateforme Salsabil

Auteur : Dr Hamid MADANI <drmdh@msn.com> Association Caritative Salsabil — dossiers sociaux, dossiers médicaux, aides, donateurs, attestations, pilotage.

Ce guide accompagne la prise en main de la plateforme, espace par espace. Il est la source unique de l'aide en ligne (/aide).

1. Première connexion

Trois façons de se connecter :

1. Mot de passe : saisissez votre email et votre mot de passe sur la page de connexion.
2. Badge QR : sur la page de connexion, scannez votre badge avec votre téléphone — la session

s'ouvre automatiquement dans le rôle correspondant.

1. Badge imprimé : un badge physique (QR signé) peut être présenté à un lecteur.

Chaque compte appartient à un espace métier (rôle) qui détermine les modules accessibles.

2. Les quatre espaces

3. Espace bénéficiaires (dossier social)

Le dossier social suit les veuves, orphelins et familles.

1. Créer un dossier : bouton Nouveau dossier — nom, type (veuve/orphelin/famille), enfants à charge, contact.
2. Prise de photo : à la création, l'app enchaîne sur la caméra — prenez la photo du bénéficiaire

(ajoutée au dossier + au badge), ou cliquez Passer. La photo peut être (re)prise plus tard depuis l'édition.

1. Enquête & validation : le dossier avance de reçu → en étude → validé (ou rejeté).
2. Classement : une fois validé, le dossier reçoit une catégorie de priorité d'aide.
3. Badge bénéficiaire : depuis l'édition (✏️) ou la liste, générez/imprimez le badge photo + QR

(plusieurs formats). À l'accueil, le scan du QR ouvre directement la fiche (voir §8).

4. Espace dossiers médicaux

Le dossier médical suit les patients cancer.

1. Ouvrir un dossier : patient, diagnostic (code CIM-10, ex. C50), médecin traitant, établissement.
2. Examens : chaque examen porte un code CCAM, un bulletin, puis un résultat.
3. Prise en charge : le circuit relie examen, orientation et financement (aide).

5. Espace donateurs & aides

• Donateurs : enregistrez un donateur (particulier/organisation) et ses dons. Chaque don génère

un reçu (PDF) numéroté.

• Aides : une aide est accordée, approuvée puis versée sous contrôle budgétaire (une aide

dépassant le budget de sa ligne est refusée).

• Paiement en ligne (selon configuration) : les dons par carte CIB/Satim, Chargily ou Stripe sont

encaissés via un fournisseur sélectionné par l'administration.

6. Attestations signées

Les attestations (prise en charge, etc.) sont signées numériquement (HMAC) et portent un QR de vérification. Une attestation révoquée devient invalide à la vérification.

7. Tableau de bord & reporting

Le tableau de bord agrège les indicateurs par période (jour / mois / trimestre / année) : dossiers sociaux, dossiers médicaux, aides versées (montant/nombre), dons collectés (montant/donateurs). Le comptable accède au reporting détaillé.

8. Badges (photo, QR, impression)

• Badge agent : ouvre une session par scan (page de connexion ou /espace/badge).
• Badge bénéficiaire : carte photo + QR (le QR encode le n° de dossier ; le scan à l'accueil

/scan ouvre la fiche). La photo provient de l'enrôlement (§3.2).

• Plusieurs formats : carte CR80 (paysage/portrait), compact, tour de cou. Choisissez le format

sur la page badge (sélecteur Format).

• Impression : un badge depuis l'édition du dossier, ou une planche de plusieurs badges

(🖨️ Imprimer les badges sur la liste) — support A4 / A5 / A4 paysage ou imprimante à cartes (CR80, 1 par page). Cochez les badges à imprimer (boutons Tout / Aucun) : seuls les cochés sortent.

• Apparence : la Direction règle l'identité visuelle du badge (organisation, dégradé, couleur de

statut) dans Badge (config) — voir §10.

• Les deux familles de badges ont des secrets séparés : un badge bénéficiaire ne peut jamais

servir à se connecter comme agent.

9. Sécurité & confidentialité

Les données sociales (revenus) et de santé (cancer, imagerie) sont sensibles. Accès limité par rôle (RBAC), connexions tracées, base chiffrable au repos, résidence des données pilotée par configuration. Ne partagez jamais votre badge ni votre mot de passe.

9bis. Licence de l'application

L'application fonctionne sous licence. Le statut est consultable dans 📜 Licence.

• Sans licence valide (mode contrôlé), l'accès aux modules est suspendu : toute page affiche

l'écran d'activation. Le menu reste visible (vitrine des fonctionnalités) mais l'usage est bloqué ; seules l'activation, l'aide et l'à-propos restent ouvertes.

• Activer : page Licence → Activer. Saisissez email + organisation puis

« Télécharger et activer la licence » — l'application télécharge et active elle-même la licence auprès du serveur. Si vous avez déjà un code, utilisez le repli « J'ai déjà un code ».

• Une fois activée, la licence est persistée localement ; l'application se débloque.

9ter. Administration (Direction)

Réservé à la Direction (réglable par configuration).

• Rôles & permissions (🔐 Rôles & permissions) : matrice rôles × domaines et édition des

permissions par rôle (persistée). Garde-fou : la Direction conserve toujours l'accès complet.

• Utilisateurs (👤 Utilisateurs) : créer / modifier les comptes en base (email, rôle, statut,

mot de passe) — en plus des comptes de démonstration.

• Badge (config) (🪪 Badge (config)) : éditeur d'apparence du badge avec aperçu en direct —

organisation, sous-titre, dégradé (sélecteurs de couleur), couleur de statut, format par défaut.

11. How2use — détail par personnel, module et action

Référence opérationnelle : qui fait quoi, où, comment. Chaque rôle ne voit que ses espaces (RBAC).

11.1 Accueil & file d'attente (tous les guichets) — 🏥 Accueil/File

Accessible à Agent social, Médical, Comptable, Direction (perm queue:*).

• Inscrire un nouveau bénéficiaire : bouton « ➕ Inscrire un nouveau bénéficiaire » → remplir le dossier → (imprimer son badge) → revenir mettre en file.
• Mettre en file (accueil) : choisir le bénéficiaire (liste) ou coller le jeton de badge QR, choisir le service (Accueil/Manager/Agent social/Médecin/Comptable/Gestionnaire), la priorité (Normale/Prioritaire pour âgé·handicap·urgence) et le motif → Mettre en file.
• Tenir un guichet : onglet du service → « 📣 Appeler le suivant » (priorité puis FIFO). La visite appelée affiche le dossier (n°, nom, liens 💶 Aides / 📁 Pièces ; pour le comptable, somme à verser).
• Actions au guichet : ✅ Terminer, 🔁 Rappel (ré-annonce), 🚫 Absent (no-show), ➡ Transférer vers un autre service (parcours multi-guichets, ex. Accueil→Comptable, Manager→Médecin).
• (Pont TicketFlow optionnel : le port ticketing partage le même moteur @mostajs/queue.)

11.2 Agent social

• Bénéficiaires (👥 Bénéficiaires) : Créer un dossier (veuve/orphelin/famille) ; Éditer (✏️, valeurs pré-remplies) ; Workflow Avancer → Valider/Rejeter → Classer.
• Pièces (GED) (📁 sur un dossier) : téléverser une pièce typée (Photo d'identité, Extrait de naissance, Fiche familiale, Certificat de résidence, Acte de décès du conjoint, Jugement/divorce, Fiche de paie, Attestations CNAS/CASNOS/CNR) ; la checklist montre présent/manquant ; télécharger.
• Aides (💶 sur un dossier validé) : Accorder une aide (type + montant + ligne de budget). (L'approbation/versement = comptable.)
• Stocks (📦 Stocks) : entrées/sorties d'aides en nature (voir 11.5).
• Accueil/File : service Agent social par défaut.

11.3 Médical

• Dossiers médicaux (🩺 Médical) : Ouvrir un dossier patient (diagnostic CIM-10, autocomplétion) ; Éditer ; Workflow Avancer → Clôturer.
• Examens (CCAM) (🔬 sur un dossier) : Demander un examen (type CCAM autocomplété + catégorie imagerie/spécialisé/biologie/anapath) ; Orienter vers un centre. Résultats : via la GED du dossier.
• Documents (📁) : comptes rendus, ordonnances, résultats, imagerie (checklist médicale).
• Accueil/File : service Médecin.

11.4 Comptable

• Aides (💶 Aides) : Approuver (✅) une aide demandée, puis Verser (💸, contrôle budgétaire) ; Rejeter (✖).
• Budgets (⚙ depuis Aides) : Allouer/mettre à jour une ligne ; 🔎 Détails d'une ligne (aides imputées).
• Dons & reçus (💝 sur un donateur) : Enregistrer un don (hors carte) ; 🧾 Reçu (PDF). (Paiement carte : 💳 Payer depuis la liste donateurs.)
• Attestations (🎖 Attestations) : Émettre (signée HMAC + QR) ; 🔎 Vérifier ; 🚫 Révoquer ; ⬇ PDF.
• Compta (📒 Compta) : journal consolidé, solde (recettes/dépenses), exécution budgétaire (alloué/engagé/réalisé/écart), ventilation analytique (par type, %), écriture manuelle (régularisation), exports Grand-livre / Balance (PDF), 🔗 Rapprochement paiements (don ↔ paiement carte, anomalies).
• Accueil/File : service Comptable (appeler le bénéficiaire, voir la somme à verser, puis verser via Aides).

11.5 Stocks (aides en nature) — 📦 Stocks

Accessible Agent social / Direction.

• Créer un article (nom, unité, catégorie, seuil d'alerte).
• Mouvement : Entrée (don/achat — qté, lot, péremption) ; Sortie (distribution — refuse le stock négatif).
• Alertes automatiques : sous seuil + péremption proche (30 j). Valorisation PMP.

11.6 Direction (accès complet)

Tout ce qui précède plus :

• Validation finale des dossiers ; Archivage (= désactivation réversible, vue Archives + Réactiver, réservé Direction) ; Tableau de bord par période (jour/mois/trim/an) ; tous les guichets dont Manager.
• Rôles & permissions (🔐) : matrice + édition des permissions par rôle (garde-fou anti-blocage).
• Utilisateurs (👤) : CRUD des comptes en base (email, rôle, statut, mot de passe).
• Badge (config) (🪪) : éditeur d'apparence du badge (organisation, dégradé via sélecteurs de couleur, statut, format), aperçu en direct.
• Licence (📜) : statut + activation de l'application (voir §9bis).

11.7 Badges, photo & identification

• Enrôlement / photo : à la création d'un bénéficiaire (ou via ✏️ → Prendre la photo), la caméra

capture la photo + le gabarit facial (aucune image ne quitte le serveur de l'association).

• Badge : depuis l'édition du dossier → aperçu carte photo + QR, 🖨️ Imprimer / formats.

Choisissez le format (CR80 paysage/portrait, compact, tour de cou).

• Impression en lot : liste bénéficiaires → 🖨️ Imprimer les badges → choisir le support

(A4 / A5 / A4 paysage / imprimante à cartes), cocher les badges voulus (Tout / Aucun), imprimer.

• Connexion agent : /login/qr (clic) ou caméra (/login/camera).
• Identification bénéficiaire : scan du badge → fiche dossier (/scan), kiosque réception, ou

reconnaissance faciale au kiosque Accueil → Identifier par visage (/m/queue/identify).

10. Besoin d'aide ?

Contactez l'administration de la plateforme. Auteur & mainteneur : Dr Hamid MADANI <drmdh@msn.com>.