• Documentation : https://voter.cliss21.org/docs/index.html
• Source : https://voter.cliss21.org/
• Installation : https://forge.cliss21.org/cliss21/gvot

Debian 10 + mariadb ou postgresql pour production

sqlite est utilisé en environnement de développement

apt install python3 virtualenv git make mariadb-client python3-mysqldb
# Si besoin de MysqL sur le même serveur : ajouter mariadb-server
cd /srv
git clone https://forge.cliss21.org/cliss21/gvot

cd /srv/gvot

Attention, la commande make init nous fait passer en mode 'vi config.env' où il faut rentrer les paramètres de MySQL

Il faut au préalable avoir préparé le terrain.

mysql_secure_installation
Mot de passe root ? (vide par défaut)
Set root password ? Y
New Password : xxxx
Re-enter New Password : xxxx
OK.
Remove anonymous user : (Y/n) : Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Création de base et user pour gvot

mysql -u root -p
+ Mot de passe créé.

CREATE DATABASE votes character set utf8 collate utf8_bin;
GRANT ALL PRIVILEGES ON votes.* TO votes@localhost IDENTIFIED by 'Mot2Passe';

FLUSH PRIVILEGES;
QUIT;

Prévoir aussi l'envoi de mail avec le smtp

Editer le fichier de configuration config.env (copie de config.env.example)

ENV=production

DJANGO_SECRET_KEY=MACLEFACHANGER

DJANGO_ALLOWED_HOSTS=votes.cemea.org,localhost, 127.0.0.1 # A vérifier ?

DJANGO_DATABASE_URL=mysql://votes:Mot2Passe@127.0.0.1:3306/votes

DJANGO_EMAIL_URL=smtp+tls://envoismtp@cemea.asso.fr:Mo2pass@mail.cemea.org:587 # remplacer @ par %40
# tester la bonne syntaxe avec : python3 -c 'from urllib.parse import quote as q;print(q("machines@cemea.asso.fr")+":"+q("Motdepasse"))'

DEFAULT_FROM_EMAIL=administrateur@cemea.asso.fr

ADMINS='Admin <administrateur@cemea.asso.fr>'

BASE_DIR=/srv/gvot

Terminer par la restriction des droits

chmod o-rwx /srv/gvot/config.env

Puis le lancement de la préocédure d'initialisation

cd /srv/gvot

make init

Mais plantage sur le module python mysqlclient utilisé par Django qui n'est pas installé et compatible.

Procédure pour installer mysqlclient depuis cette page : https://pypi.org/project/mysqlclient/

apt-get remove python3-mysqldb
apt-get install python3-dev default-libmysqlclient-dev build-essential

Puis se connecter à l'environnement virtuel :

cd srv/gvot/ && source venv/bin/activate

pip3 install mysqlclient

Et relancer la procédure d'install si besoin :

make init

make update

make serve

Pour redémarrer, lancer un make update (ou rebooter le serveur et relancer un make serve).

Le service est alors actif localement sur le port 8000 sur la boucle locale 127.0.0.1

Reste à proposer une interface accessible depuis l'extérieur avec Nginx

apt install nginx

Modifier le default ou le désactiver et recréer une conf gvot.conf dans /etc/nginx/sites-available/gvot.conf (puis faire un lien vers /etc/nginx/sites-enable/gvot.conf)

gvot.conf :

server {
    server_name gvot;
    access_log /var/log/nginx/gvot.access.log;
    error_log /var/log/nginx/gvot.error.log;

    location / {
        proxy_pass http://127.0.0.1:8000;
    }
}

server {
    server_name gvot;
    listen 80;
    return 301 https://$host$request_uri;
}

Et relancer nginx

systemctl restart nginx

cd /srv/gvot

./venv/bin/python manage.py createsuperuser --username francois --email francois.audirac@cemea.asso.fr

Et saisir un mot de passe complexe (./venv/bin/python manage.py createsuperuser : marche aussi).

Et relancer le service make serve

Pour info, si on modifie des paramètres de config.env pour passer en mode développement (et les options de Django qui vont avec), il faut relancer un make update pour téléchargements des librairies python complémentaires.

La page d'accueil est personnalisable et sera visible depuis l'accueil. Pensez à publier les modifications pour qu'elles soient prises en compte.

Créer une page “Scrutins CEMEA” de type “Liste de scrutions”, lui donner un titre “Scrutins CEMEA” et la publier.

Dans cet espace, il faut alors créer une page qui sera le scrutin.

Ajouter une sous-page dans la liste des scrutins “Scrutins CEMEA”.

Lui donner :

• un titre,
• une date de péremption (où les données seront effacées), : à définir bien après le vote.
• une prescription (pour les données personnelles) : par défaut
• Une introduction : texte d'accueil avant le vote
• Une confirmation : Message après avoir voté.
• Une action : Texte du bouton du formulaire de confirmation
• Ne pas remplir “Envoi des résultats : ne fonctionne pas”.

Sauvegarder le brouillon. Le publier lorsque toutes les infos des autres onglets sont remplies.

Ajouter des questions :

• Etiquette : nom
• Filed type : type de questions (boutons radios, choix multiples…)
• choix : indiquer les choix séparés par une virgule : Uniquement applicable aux cases à cocher, boutons radio et les listes déroulantes.
• Valeur par défaut. Liste de valeurs séparées par une virgule pour les cases à cocher.
• Requis : si indispensable.
• Valeurs min et max : nombre de choix possibles pour “selction mutliple bornée”.

Il est possible d'ajouter plusieurs formulaires dans le même scrutin.

L'onglet “Promotions” n'est pas utile pour un scrutin.

Infos non pertinentes : ne servent pas.

• Date/heure de publication :
• Date/heure d'expiration :

Ne pas oublier de publier le scrutin une fois complété.

Il est important ne de pas ouvrir encore le scrutin pour l'instant.

4 modèles sont proposés :

• Rappel des codes : pour indiquer aux personnes comment elles pourront voter. Pas indispensable, mais fournit à chacun l'URL définitive
• Ouverture du scrutin : nécessaire pour pouvoir voter (la même URL)
• Confirmation du vote : mail envoyé à chaque votant après son vote
• Envoi des résultats : Attention : mail manuel indiquant les résultats du vote…

Il est possible en passant par “Pouvoirs” de renvoyer un mail individuel à chacun.

Pour note, l'URL hashée est présente dans le lien de renvoi.

Le lien du vote est : votes.cemea.org/hash/

Le lien du mail est : https://votes.cemea.org/admin/mailing-pouvoir/single/hash/

Les votants sont enregistrés sous forme de pouvoir avec pondération. Pondération de 1 = 1 vote. Par défaut.

La création se fait manuellement ou bien par import CSV :

• Fichier au format csv dans un codage utf-8 ; séparateur : « , » ; délimiteur de texte : « “ » (doubles quotes).
• Colonnes attendues : « nom », « prenom », « collectif » (adressé “en tant que” ), « courriel », « contact » et « ponderation ».
• Au moins un colonne marquée par « * » doit être remplie.
• Les colonnes marquée par « » ne peuvent être vides. * Une pondération absente sera interprétée à la valeur « 1 ». Avant l'ouverture du scrutin, il peut être utile d'envoyer le modèle de mail : “Rappel des codes” où on indique manuellement la date d'ouverture et de fermeture du scrutin. Modifier le modèle de mail, puis dans Pouvoirs / choisir Démarrer un mailing. **Choisir le modèle et les destinataires :

• tous les participants :
• ceux ayant voté
• ceux n'ayant pas voté.

Retourner dans le scrutin, cliquer sur “scrutin ouvert” et “publier la page” = enregistrer les changement dans la page publiée.

Vous pouvez alors modifier le modèle de mail “Ouverture du Scrutin” et changer les heures et dates. Et renvoyer le mailing.

Les votes arrivent au fur et à mesure dans la page du scrutin dans “Résultats” pour le total et dans “Détails” pour Scrutin soumissions
avec le nombre total de soumissions. Il est aussi possible de voir qui a voté dans Emargement.

Vous pouvez cliquer pour suivre le nombre de soumissions et les dates. Les votes sont évidemment anonymes.

Une fois l'échéance atteinte, il faut clore le scrutin manuellement en décochant la case “scrutin ouvert” et en choisissant “Publier”.

La consultation des résultats est disponible dans le scrutin / Résultats. Il faut copier et coller le résultat dans le modèle de mail “Envoi de résultats”.

Il est possible de prendre une capture d'écran des votants et de la joindre au mail.

Uiliser le mailing pour envoyer à tous les résultats.