groupe-meditation/docs/UTILISATEURS.md

# Guide utilisateur

Application du Groupe Méditation pour les membres, les serviteurs et l'exécutif du groupe.

Ce guide explique quoi faire dans l'application, sans détails techniques.

## 1. Accéder à l'application

### Se connecter

1. Ouvrir l'application dans le navigateur.
2. Choisir le groupe si plusieurs groupes sont affichés.
3. Entrer son courriel.
4. Entrer son PIN à 4 chiffres.
5. Cocher `Se souvenir de moi` seulement sur un appareil personnel.
6. Appuyer sur `Connexion`.

Si `Se souvenir de moi` n'est pas coché, la session reste limitée à l'onglet ou à la session du navigateur.

### Créer son compte

Un nouveau membre doit avoir un code d'invitation.

1. Sur l'écran de connexion, choisir `J'ai un code d'invitation`.
2. Entrer le code reçu.
3. Entrer les informations demandées.
4. Choisir un PIN à 4 chiffres.
5. Valider l'inscription.

Le code d'invitation ne peut être utilisé qu'une seule fois et expire automatiquement.

### Se déconnecter

Depuis l'accueil, appuyer sur `Déconnexion`.

## 2. Page d'accueil

L'accueil affiche les modules disponibles pour le membre connecté.

Les modules sont regroupés en trois sections :

- `Mes tâches` : saisies et actions liées au poste du membre.
- `Consultation` : modules accessibles à tous les membres.
- `Gestion` : modules réservés à l'exécutif ou aux postes autorisés.

Les accès dépendent des postes actifs du membre. Ils peuvent être ajustés dans `Gestion des postes`.

## 3. Modules de consultation

### Rapports PDF

Permet de consulter ou produire les rapports du groupe :

- finances;
- procès-verbaux;
- résolutions;
- rapports disponibles selon les données enregistrées.

### Événements

Affiche les événements du groupe et du district :

- anniversaires de sobriété;
- événements créés par l'exécutif;
- résolutions adoptées.

Les événements passés et futurs sont affichés. Les filtres peuvent être combinés : anniversaires, événements, résolutions.

Les membres de l'exécutif peuvent créer un événement.

### Littérature

Permet de consulter l'inventaire de littérature :

- titres disponibles;
- prix;
- quantités;
- alertes de stock bas.

### Décisions en cours

Affiche le suivi des décisions et propositions non terminées.

### Votes ouverts

Permet aux membres de voter dans les sondages ouverts.

### Mon profil

Permet de modifier :

- prénom;
- nom;
- téléphone;
- courriel;
- date d'abstinence;
- PIN.

Un courriel déjà utilisé dans le même groupe ne peut pas être repris.

### Propositions

Permet de :

- soumettre une proposition;
- consulter les propositions;
- seconder une proposition;
- suivre le statut des résolutions.

Une proposition suit normalement ce cycle :

1. proposée;
2. secondée;
3. votée;
4. adoptée ou rejetée.

Une proposition adoptée devient une résolution numérotée.

### Postes à pourvoir

Permet de consulter les postes vacants et de proposer sa candidature.

Si un membre est nominé à un poste, il peut accepter ou refuser la nomination.

### État financier

Affiche une vue rapide :

- solde bancaire;
- encaisse;
- montant disponible;
- résultat net;
- revenus;
- sorties;
- réserves;
- dernières collectes;
- dernières dépenses.

## 4. Modules de saisie accessibles à tous

### Collecte 7e Tradition

Permet de saisir une collecte.

Règles importantes :

- la collecte doit être associée à une date de réunion;
- il ne peut pas y avoir deux collectes pour la même date;
- un autre membre doit confirmer le montant;
- le trésorier doit accuser réception si la collecte n'est pas déjà reçue automatiquement.

Le module offre aussi une liste des collectes existantes.

### Dépense

Permet à un membre de soumettre une dépense.

La dépense n'est pas considérée comme payée tant que le trésorier ne l'a pas confirmée.

Le trésorier choisit la méthode :

- `COLLECTE` : payé depuis l'encaisse;
- `CHEQUE` ou `VIREMENT` : engagement à confirmer lorsque le débit apparaît;
- `DU` : montant dû au membre.

## 5. Trésorerie

Module réservé au trésorier ou aux postes autorisés.

### Soldes

Affiche :

- solde en banque;
- encaisse;
- montant disponible;
- réserves;
- engagements non débités;
- argent encore en circulation.

### Réceptions

Permet de traiter :

- collectes à recevoir;
- ventes de littérature remises au trésorier;
- contributions à confirmer comme débitées.

### Registre

Affiche les transactions financières.

On peut filtrer par :

- mois;
- année;
- type de transaction.

Types disponibles :

- collectes;
- ventes de littérature;
- dépenses;
- contributions;
- dépôts bancaires;
- retraits bancaires.

### Réserves

Permet de créer, modifier et supprimer les réserves.

Règle importante : le total des réserves ne peut jamais dépasser le solde en banque.

### Opérations bancaires

Permet d'enregistrer :

- un dépôt : transfert de l'encaisse vers la banque;
- un retrait : transfert de la banque vers l'encaisse;
- un relevé : solde réel du compte bancaire à une date donnée.

Le dépôt ne peut pas dépasser l'encaisse disponible.

## 6. Envoi contributions

Module réservé au trésorier.

Permet d'enregistrer une contribution vers :

- district;
- région;
- BSG;
- intergroupe.

Le module demande :

- destination;
- montant;
- méthode;
- proposeur;
- secondeur.

Lors de l'enregistrement, l'application crée une résolution de type `contribution`.

La contribution ne modifie pas les soldes immédiatement. Elle doit être confirmée comme débitée dans `Trésorerie` pour que le solde bancaire soit mis à jour.

## 7. Procès-verbal, présences et rapport RSG

### Rédiger PV

Permet de préparer un procès-verbal de réunion d'affaires.

Les propositions secondées et les décisions peuvent alimenter le contenu du PV.

### Présences

Permet de noter les membres présents à une réunion d'affaires.

### Rapport RSG

Permet au RSG ou au RSG substitut de saisir un rapport destiné au groupe.

## 8. Littérature et jetons

### Vente littérature

Permet d'enregistrer une vente.

Quand une vente est enregistrée :

- le stock est ajusté;
- le montant devient à remettre au trésorier;
- le trésorier confirme ensuite la réception dans `Trésorerie`.

### Ajuster inventaire

Permet au responsable de la littérature d'ajuster les quantités ou d'ajouter des éléments.

### Remise jeton

Permet d'enregistrer une remise de jeton.

### Commander jetons

Permet de préparer ou suivre les commandes de jetons.

## 9. Gestion des membres

Module réservé à l'exécutif ou aux postes autorisés.

Permet de :

- voir les membres actifs;
- consulter une fiche membre;
- générer un code d'invitation;
- copier ou partager le code;
- désactiver un membre;
- appliquer le droit à l'oubli.

### Désactiver un membre

Le membre ne peut plus se connecter, mais son historique demeure.

### Droit à l'oubli

Les données personnelles du membre sont anonymisées. Cette action est irréversible.

## 10. Gestion des mandats

Regroupe les actions liées aux mandats :

- affecter un poste;
- terminer un mandat;
- planifier les rotations.

### Affecter un poste

Une affectation demande :

- le membre;
- le poste;
- la date de début;
- un proposeur;
- un secondeur.

Une affectation crée automatiquement une résolution adoptée de type `nomination`.

### Terminer un mandat

Permet de fermer un mandat actif.

La fin d'un mandat n'est pas automatique. Elle doit être enregistrée manuellement.

## 11. Gestion des postes

Permet de :

- créer des postes;
- abolir des postes;
- gérer les candidatures;
- contrôler les accès aux modules selon les postes.

Les accès ne sont pas accordés directement aux personnes : ils passent par les postes.

## 12. Paramètres du groupe

Permet de modifier les informations générales :

- nom;
- district;
- région;
- adresse;
- jour de réunion;
- heure;
- format.

## 13. Sondages

### Lancer un sondage

Permet à l'exécutif de créer un sondage.

### Votes ouverts

Permet aux membres de voter.

## 14. Bonnes pratiques

- Utiliser son propre compte, jamais celui d'un autre membre.
- Ne pas partager son PIN.
- Se déconnecter sur un appareil partagé.
- Saisir les collectes et dépenses dès que possible.
- Confirmer les débits seulement lorsque l'argent est réellement sorti du compte.
- Enregistrer les dépôts quand l'encaisse est réellement déposée à la banque.
- Garder les réserves à jour.
- Utiliser les propositions et résolutions pour conserver une trace claire des décisions.

## 15. Problèmes fréquents

### Je ne peux pas me connecter

Vérifier :

- le bon groupe est sélectionné;
- le courriel est exact;
- le PIN contient 4 chiffres;
- le compte n'a pas été désactivé.

### Je ne vois pas un module

Les modules dépendent des postes et des accès configurés.

Demander à l'exécutif de vérifier :

- vos mandats actifs;
- les accès du poste dans `Gestion des postes`.

### Le dépôt est refusé

Le montant du dépôt dépasse probablement l'encaisse disponible.

### Une réserve est refusée

Le total des réserves dépasserait le solde en banque.

### Une contribution ou dépense ne change pas le solde

Elle doit être confirmée comme débitée dans `Trésorerie`.

### Une collecte ne peut pas être saisie

Causes possibles :

- date hors jour de réunion;
- collecte déjà enregistrée pour cette date;
- date future.

## 16. Règles importantes de l'application

- Les données sont séparées par groupe.
- Un membre se connecte avec son courriel et son PIN.
- Les actions financières sensibles sont réservées au trésorier ou à l'exécutif.
- Les résolutions adoptées sont numérotées automatiquement.
- Les mandats ne se terminent pas seuls.
- Les accès aux modules sont contrôlés par les postes.