Documentation de l’application : Gestion des membres et des assignations

Présentation de l’application

Cette application a été développée pour aider la communauté du Beth Habad de Bry-sur-Marne, gérée par le Rav Israël Asseraf. L’application est pensée pour être intuitive et accessible, même pour des utilisateurs non techniques. Elle offre des fonctionnalités avancées comme l’exportation et l’importation des données ou la personnalisation des assignations.

Objectif de l’application

1. Gestion des membres de la communauté

L’application permet d’enregistrer et de gérer les informations sur chaque membre de la communauté. Pour chaque membre, on peut indiquer son prénom, son nom et son nom hébraïque.
On peut aussi indiquer sa date de naissance, selon le calendrier grégorien et le calendrier hébraïque. La Parasha associée à sa naissance peut être précisée.
Son rôle spécifique (Cohen, Levy, Rav, ou aucun rôle) est également enregistré. Le statut (Actif ou Inactif) et le type (Régulier ou Invité) sont définis.
On peut noter si le membre a besoin de réciter le Kaddish ou s’il est capable de lire la Haftara. Des commentaires peuvent être ajoutés pour des informations supplémentaires, comme des absences prévues.
Les responsables peuvent filtrer les membres, par exemple pour afficher uniquement les membres actifs ou réguliers. Ils peuvent trier la liste selon différents critères, comme le nom ou la date de naissance.
Les données des membres peuvent être exportées ou importées via des fichiers Excel pour une gestion plus facile.

2. Gestion des montées et autres rôles liturgiques

L’application planifie les assignations pour les services religieux, notamment pour le Shabbat. La lecture de la Torah est divisée en sept montées (Aliyot).
Elle gère aussi d’autres rôles, comme la lecture de la Haftara, le Hagbaa et l’Ouv Aaron. Elle affiche un calendrier juif avec les dates grégoriennes et hébraïques.
Les Parashot et les événements religieux (fêtes, jeûnes, etc.) sont également indiqués. Pour chaque date avec une lecture de la Torah, elle attribue automatiquement les rôles aux membres.
Les assignations suivent des règles précises, tout en veillant à une répartition équitable. Les responsables peuvent ajuster manuellement les assignations via une fenêtre dédiée.
Un historique des assignations est conservé pour éviter que les mêmes membres soient trop souvent sollicités.

Guide d’utilisation de l’application

Ce guide explique comment utiliser l’application pour gérer les membres et organiser les assignations. L’interface est divisée en plusieurs onglets, chacun ayant une fonction spécifique.
Nathaniel Itshak Musicant, responsable en 2025, peut s’appuyer sur ce guide pour administrer l’application.

1. Navigation dans les onglets

En haut de l’application, une barre de navigation propose plusieurs onglets.

Onglet	Description
📅 Calendrier	Affiche un calendrier juif avec les dates, les Parashot, et les assignations. Cliquez sur une date pour voir ou modifier les assignations.
👥 Gestion des membres	Permet d’ajouter, modifier, ou supprimer des membres. Vous pouvez aussi filtrer ou trier la liste des membres.
📜 Historique des Assignations	Affiche l’historique des assignations passées. Vérifiez qui a été assigné à quel rôle et quand.
Documentation	Contient ce guide d’utilisation et les règles d’assignation.
Exporter PDF	Permet d’exporter le calendrier ou les assignations en PDF.

2. Utiliser l’onglet Calendrier

L’onglet "Calendrier" est le cœur de l’application pour organiser les assignations. Utilisez les flèches pour changer de mois.
Cliquez sur "Aujourd’hui" pour revenir à la date actuelle. Chaque jour avec une lecture de la Torah affiche les assignations (Aliyot, Haftara, etc.).
Les noms des membres assignés sont indiqués, avec des icônes pour les anniversaires ou le Kaddish. Cliquez sur une date pour ouvrir une fenêtre où vous pouvez voir et modifier les assignations.
Par exemple, vous pouvez changer le membre assigné à la 1ère montée ou ajouter des remplaçants. Si une date a une icône de roue crantée (⚙️), cliquez dessus pour recalculer automatiquement les assignations.

3. Gérer les membres dans l’onglet Gestion des membres

L’onglet "Gestion des membres" permet de gérer la liste des membres. Cliquez sur le bouton "Nouveau Membre" pour ouvrir un formulaire.
Remplissez les informations (prénom, nom, date de naissance, etc.) et enregistrez. Dans la liste des membres, cliquez sur le bouton "Modifier" (icône de crayon) pour mettre à jour les informations.
Cliquez sur le bouton "Supprimer" (icône de poubelle) pour retirer un membre. Une confirmation vous sera demandée avant la suppression.
Utilisez les filtres en haut pour n’afficher que les membres actifs ou réguliers. Cliquez sur les en-têtes de colonnes pour trier la liste (par nom, date de naissance, etc.).
Vous pouvez exporter ou importer des membres via des fichiers Excel (voir section "Exportation et Importation").

4. Consulter l’historique des assignations

L’onglet "Historique des Assignations" permet de voir les assignations passées. La liste montre chaque assignation avec la date, le rôle, le membre, et la raison.
Utilisez les filtres pour n’afficher que les membres actifs, réguliers, ou un rôle spécifique. Par exemple, vous pouvez filtrer pour voir uniquement les assignations des Cohen.
Cliquez sur "Exporter XLSX" pour sauvegarder l’historique dans un fichier Excel.

5. Exporter le calendrier en PDF

L’onglet "Exporter PDF" permet de générer un fichier PDF du calendrier avec les assignations. Cliquez sur le bouton pour télécharger le fichier.
Vous pouvez ensuite l’imprimer ou le partager avec la communauté.

6. Exportation et Importation des données

Exportation

Vous pouvez exporter les données sous forme de fichiers pour les sauvegarder ou les partager. Dans l’onglet "Gestion des membres", le bouton "Exporter XLSX" génère un fichier Excel.
Ce fichier contient la liste complète des membres avec leurs informations (prénom, nom, rôle, etc.). Dans l’onglet "Historique des Assignations", le bouton "Exporter XLSX" génère un fichier Excel.
Ce fichier contient l’historique des assignations (date, rôle, membre, raison, etc.). Dans l’onglet "Exporter PDF", le bouton génère un PDF du calendrier avec les assignations.
Les fichiers exportés peuvent être utilisés pour des archives ou partagés avec d’autres membres.

Importation

Vous pouvez importer des membres à partir d’un fichier Excel pour ajouter ou mettre à jour des données. Dans l’onglet "Gestion des membres", le bouton "Importer XLSX" ouvre une fenêtre de sélection de fichier.
Sélectionnez un fichier Excel contenant une liste de membres. Le fichier doit avoir des colonnes avec les en-têtes suivants : ID, Prénom, Nom, Nom Hébraïque, etc.
L’application vérifie les données avant l’importation. Si des erreurs sont détectées (par exemple, un prénom manquant), un message d’erreur s’affiche.
Les membres existants (même ID) sont mis à jour, et les nouveaux membres sont ajoutés. Après l’importation, un message confirme le succès ou indique les erreurs rencontrées.

Règles d’assignation des rôles

Les assignations des rôles suivent des règles strictes issues des traditions juives. Elles intègrent des principes d’équité pour répartir les responsabilités entre les membres.
Voici les étapes détaillées et les règles appliquées pour chaque date, généralement un Shabbat. Pour en savoir plus sur les traditions juives liées à la lecture de la Torah, consultez ces ressources :
- Chabad.org - La lecture de la Torah
- MyJewishLearning - Qu’est-ce qu’une Aliyah ?

Principes fondamentaux

Les assignations reposent sur trois principes clés. Voici leur description détaillée :

1. Rotation basée sur l’historique. Les membres récemment assignés à un rôle sont temporairement exclus.
   Cela garantit une distribution équitable. L’application suit l’historique des assignations pour chaque membre et chaque rôle afin de déterminer qui doit être priorisé ou exclu temporairement.
2. Filtrage des membres actifs. Seuls les membres ayant un statut "Actif" et un type "Régulier" sont éligibles par défaut.
   Les membres "Inactifs" ou "Invités" sont exclus, sauf dans des cas spécifiques où leur participation est explicitement requise.
3. Assignation prioritaire. Une hiérarchie stricte est appliquée pour attribuer les rôles selon les traditions et les besoins.
   Voici les priorités définies :
   1. Cohen pour la 1ère montée.
   2. Levi pour la 2ème montée.
   3. Kaddish pour la 7ème montée.
   4. Anniversaires pour les 3ème à 6ème montées.
   5. Membres réguliers pour les montées restantes et autres rôles.

Processus détaillé d’assignation

Le processus est exécuté pour chaque date avec une lecture de la Torah, généralement un Shabbat. Voici les étapes et leurs règles spécifiques.

1. Récupération des données. Liste des membres éligibles, filtrée pour exclure les "Invités" sauf si nécessaire.
   Dernières dates d’assignation pour chaque membre et rôle. Informations sur la Parasha et la présence d’une Haftara.
2. Assignation des rôles prioritaires : Cohen et Levi. 1ère montée (Cohen).
   Réservée exclusivement à un membre avec un rôle de Cohen. Choisi parmi les Cohen actifs en rotation, basé sur la date de leur dernière assignation.
   Le moins récemment assigné est prioritaire. Si aucun Cohen n’est disponible, la montée reste vide à ce stade.
   2ème montée (Levi). Réservée exclusivement à un membre avec un rôle de Levi.
   Choisi parmi les Levi actifs non assignés, excluant le Cohen déjà pris. La rotation est basée sur leur dernière assignation.
   Si aucun Levi n’est disponible, la montée reste vide à ce stade.
3. Assignation du Kaddish : 7ème montée. Priorité absolue à un membre ayant kaddish = true.
   Doit être un membre régulier actif, rôle différent de Rav. Ne doit pas être déjà assigné à une autre montée ce jour-là.
   Parmi les membres éligibles avec kaddish = true, sélection du plus ancien non assigné. La rotation est basée sur leur dernière assignation.
   Si aucun membre avec kaddish = true n’est disponible ou éligible, la 7ème montée reste vide. Elle sera complétée à l’étape des réguliers.
4. Assignation basée sur les anniversaires : 3ème à 6ème montée. Priorité aux membres dont la date de naissance hébraïque correspond à la semaine en cours.
   Membres réguliers actifs, hors Cohen, Levi, Rav. Non assignés précédemment.
   Sélectionnés par ordre de dernière assignation. Le moins récemment assigné est prioritaire.
   Remplit les montées 3 à 6. Si moins d’anniversaires que de montées disponibles, les restantes sont laissées vides à ce stade.
   Si aucun Cohen ou Levi n’est disponible, un anniversaire peut occuper la 1ère ou 2ème montée.
5. Assignation des montées restantes : 3ème à 6ème, et 7ème si nécessaire. Complète les montées 3 à 6, et la 7ème si pas de Kaddish, avec des membres réguliers.
   Membres réguliers actifs, hors Rav. Non assignés.
   Basée sur la dernière assignation. Le moins récemment assigné est prioritaire.
   Remplit les montées 3 à 6 si vides après les anniversaires. Si la 7ème montée est vide, elle est remplie ici avec un régulier.
6. Assignation des remplaçants.

   Remplaçants pour les Aliyot

   Minimum de 4 remplaçants. Plus si plus de Cohen/Levi sont disponibles que nécessaires.
   Par exemple, si 3 Cohen actifs, 1 principal et 2 remplaçants. Inclut d’abord les Cohen et Levi restants non assignés.
   Complété par des réguliers, en évitant les doublons avec les principaux.

   Remplaçants pour Hagbaa

   2 remplaçants distincts des principaux.

   Remplaçants pour Ouv Aaron

   1 remplaçant distinct du principal.

7. Assignation des autres rôles.

   Rôle Haftara

   Priorité aux membres ayant maftir = oui. Triés par rotation, dernière assignation Haftara.
   Si aucun membre avec maftir = oui, priorité au Rav. Trié par rotation.
   Si aucun membre ne correspond, le rôle reste non assigné.

   Rôle Hagbaa

   2 membres réguliers actifs, non assignés. Rotation selon leur dernière assignation à ce rôle.
   2 remplaçants distincts, également en rotation.

   Rôle Ouv Aaron

   1 membre régulier actif, hors Rav. Rotation selon leur dernière assignation à ce rôle.
   1 remplaçant distinct, en rotation.

Résumé des priorités par montée

Voici un tableau récapitulatif des priorités pour chaque montée. La règle de rotation consiste à choisir parmi les membres réguliers actifs.
Hors Cohen/Levy/Kaddish=true, en priorité les anniversaires. Puis ceux jamais montés.
Puis par ordre décroissant du minimum entre le nombre de jours depuis le dernier passage et celui jusqu’au prochain passage.

Montée	Priorité
1ère	Cohen (si présent), sinon règle de rotation.
2ème	Levy (si présent), sinon règle de rotation.
7ème	Membre avec kaddish = true (prioritaire) si existant, sinon règle de rotation.
3ème à 6ème	Anniversaires (priorité), sinon règle de rotation.

Contraintes additionnelles

Rotation : Chaque rôle utilise un historique spécifique pour équilibrer les assignations. Minimum de remplaçants : 4 pour Aliyot, ajusté selon le nombre de Cohen/Levi disponibles.

Note de l’auteur

Cette application a été développée par Yoni Fitoussi en 2025. Pour toute question ou suggestion, vous pouvez me contacter à l’adresse suivante : yonif@hotmail.com.