club-q

(Français) Programme Python implémentant une interface graphique pour l'attribution de places de spectacles à des étudiants de l'ESPCI Paris - PSL, dans le cadre de l'activité du club chargé de cette tâche, dit « Club Q ».

Conçu pour un usage dans ce cadre uniquement. Ce programme est basé sur des données privées et organisées de manière spécifique ; l'accès aux données est protégé par mot de passe.

(English) Python program implementing a graphical interface for allocating show tickets to ESPCI Paris - PSL students, as part of the "Club Q" activity. Designed for use in this setting only. This program relies on private data, organized in a specific way and password-protected.

Fonctionnalités

• Affichage détaillé des étudiants, spectacles et vœux
• Attribution automatique par minimisation des mécontentements individuels
• Ajustement manuel des attributions
• Synchronisation avec le site d'inscription
• Génération des fiches récapitulatives PDF des élèves et spectacles
• [v2.1] Publication des fiches élèves individuelles sur le serveur d'inscription
• [v2.1] Envoi des fiches élèves individuelles par mail
• [v2.2] Génération d'un fichier Excel récapitulant les sommes à payer
• [v2.3] Création de nouveaux vœux (pour les élèves déjà existants)
• [v2.4] Génération de fichiers Excel récapitulatifs pour les spectacles

Installation

Exécutable

Pour les utilisateurs sous Windows, l'application est disponible sous forme d'un exécutable : club-q.exe.

Ce fichier est autonome et n'a pas de dépendances : il suffit de le télécharger et de l'exécuter.
Testé sous Windows 10 / 64 bits uniquement ; devrait fonctionner sous toutes les versions récentes.

Code source

À défaut, le dossier source contient l'ensemble des fichiers nécessaires au fonctionnement de l'application.
Le point d'entrée du programme est alors source/club-q.py, qu'il suffit d'exécuter comme tout script Python.

Dépendances

• Python 3.6+
• Packages : SQLAlchemy, PyMySQL, ReportLab, cryptography, Unidecode, Pillow, natsort, openpyxl (voir requirements.txt)

Pour installer tous les packages nécessaires, avec pip (gestionnaire de packages usuel) :

pip install -r source/requirements.txt

Geler le code

Le fichier exécutable fourni a été gelé à l'aide de PyInstaller. La commande suivante permet d'en faire un équivalent pour l'environnement d'exécution courant (à la racine du dossier source) :

pyinstaller ./club-q.spec

L'exécutable ainsi généré est placé par défaut dans le dossier source/dist.

Usage

Utiliser l'assistant intégré au programme pour appréhender son utilisation.

Mot de passe

Le hash du mot de passe du programme et les paramètres sensibles chiffrées peuvent être redéfinis à l'aide du script source/gen_new_pass.py.

Utilisation en ligne de commande

Les options suivantes, principalement utiles pour le développement, sont disponibles :

• --debug : affiche certaines informations détaillées au cours de l'exécution du programme
• --direct : lance directement la fenêtre principale, sans passer par l'écran d'accueil
• --assistant : lance directement l'assistant d'attribution, sans passer par l'écran d'accueil

Contributions

Ce projet n'est pas ouvert aux contributions extérieures. N'hésitez pas à me contacter pour toute remarque.

Licence

Ce programme est partagé sous licence MIT.

© 2020 Loïc Simon – Association GRI – ESPCI Paris - PSL
Basé sur un programme initialement développé par Jessie Mosso 134, Miguel Cano 134 et Guillaume Vidon – logo du club Q par Anaëlle Chrétien 134

Pour toute question, n'hésitez pas à me contacter par mail : loic.simon@espci.org