Guide d’administration

Cette documentation couvre l’administration de l’application par les administrateurs.

Créer un comte administrateur

Il est conseillé de créer un compte dédié à l’administration, qui doit être utilisé avec la plus grande parcimonie.

Sur le serveur de production :

$ ./venv/bin/python manage.py createsuperuser
Adresse mail: admin@example.org
Password: •••••••••••••
Password (again): •••••••••••••
Superuser created successfully.

Utilisation du compte administrateur

Une fois connecté avec le compte administrateur :

Vous avez accès à ce que tous les dirigeants réunis, de toutes les associations de l’instance, ont accès.
Vous avez accès à un menu spécifique en haut à droite pour le paramétrage de l’instance.
Vous avez accès à une page dédiée aux statistiques globales de l’application, accessible via le menu administrateur spécifique susmentionné.
Vous avez accès à la définition d’une charte d’utilisation.

Gestion des rôles par défaut

class benevalibre.instance.models.DefaultRole(*args, **kwargs)

Les « rôles par défaut » sont crées et affectés par défaut à toute nouvelle association inscrite sur la plateforme.

Les rôles définissent les permissions dont jouit chaque bénévole. Ces permissions sont, par ordre d’importance croissante :

Liste les utilisat⋅eurs⋅rices : donne au ou à la bénévole la possibilité de voir qui sont les autres bénévoles engagés dans l’association.
Délègue ses permissions : donne au ou à la bénévole la possibilité de gérer les rôles des bénévoles et de transférer son rôle aux autres bénévoles. Ce rôle implique de lister les autres bénévoles engagés dans l’association.
Gère le bénévolat : donne au ou à la bénévole la possibilité de modérer, saisir, corriger ou effacer le bénévolat des autres bénévoles. Ce rôle implique de lister les autres bénévoles engagés dans l’association.
Gère les niveaux, projets, catégories : donne respectivement au ou à la bénévole la capacité de gérer respectivement les niveaux, les projets et les catégories.
Gère les rôles : donne au ou à la bénévole la capacité de gérer les rôles. Ce rôle permet un accès total à tous les rôles de l’association.
Gère l’association␣: donne au ou à la bénévole toutes les permissions susmentionnées, ainsi que le droit de modifier la totalité des attributs de l’association.

Le « rôle par défaut dans l’association » est le rôle associé aux bénévole lorsque ceux-ci rejoignent l’association.

Gestion des niveaux par défaut

class benevalibre.instance.models.DefaultLevel(*args, **kwargs)

Les « niveaux par défaut » sont crées et affectés par défaut à toute nouvelle association inscrite sur la plateforme.

Les niveaux de bénévolat permettent pour ceux qui souhaitent de caractériser le niveau d’expertise que l’action mobilise. C’est utile par exemple pour les associations qui souhaitent moduler la valorisation en fonction de niveaux d’expertise différents.

Gestion des catégories par défaut

class benevalibre.instance.models.DefaultCategory(*args, **kwargs)

Les « catégories par défaut » sont crées et affectés par défaut à toute nouvelle association inscrite sur la plateforme.

Afin de rendre possible des statistiques inter-associatives, elles sont chacune attachées à une « catégorie d’instance ».

Ainsi, chaque association peut personnaliser sa liste de catégories.

Gestion des catégories d’instance

class benevalibre.instance.models.InstanceCategory(*args, **kwargs)

Les catégories servent à qualifier les actions de bénévolat. Mais elles sont propres à chaque association, qui peut personnaliser sa liste de catégories.

Afin de rendre possible des statistiques inter-associatives, elles sont donc chacune attachées à une « catégorie d’instance ».

Par conséquent il n’est pas recommandé de modifier ces groupes sans concertation préalable avec les fédérations de mouvements associatifs.

Statistiques globales de l’application

class benevalibre.base.views.AdminOnlyStatsPage(**kwargs)

Cette page permet aux utilisateurs munis de droits d’administrateur d’avoir accès à des statistiques globales de l’application, telles que le nombre d’associations, d’utilisateurs ou d’actes de benevolat au total depuis la création de l’instance.

Y sont visibles également des statistiques concernant le nombre d’actes de bénévolat saisis, la durée et la distance totale que cela représente, année par année. Mais aussi la répartition des catégories de bénévolats, ainsi que celle des groupes de domaines d’activité des associations.

Cette page n’est visible que par les comptes disposant de droits d’administrateur. Tout utilisateur ne disposant pas de ces droits verra une page d’erreur, et les utilisateurs non connectés seront redirigés vers le formulaire de connexion.

Charte d’utilisation

class benevalibre.instance.models.TermsOfUse(*args, **kwargs)

La charte d’utilisation de la plateforme.

Une fois définie elle apparait à tous les utilisateurs via le menu principal de la plateforme. Le format attendu est un pdf.

Pour mettre à jour la charte il suffit de téléverser un nouveau document.

Tableau de bord du compte administrateur

Modération des associations en attente

class benevalibre.base.views.AssociationModerationMixin

Suivant la même logique que la modération des engagements bénévoles et la modération des actions de bénévolat, l’administrateur de Bénévalibre peut modérer les demandes de création d’association via son tableau de bord.

Pour donner suite à la modération, il suffit de suivre le lien qui vous amène à éditer l’association. Vous pouvez alors corriger et/ou valider l’enregistrement de l’association en validant le formulaire, sinon rejeter l’enregistrement en effaçant l’association.