Go to file
Emmy D'Anello 3cd40ee192
Add margins
Signed-off-by: Emmy D'Anello <emmy.danello@animath.fr>
2023-04-04 10:25:50 +02:00
api Use Django 4.1 (soon 4.2) to use the new async framework 2023-04-04 10:25:46 +02:00
docs Add documentation for organizers 2023-01-10 15:13:18 +01:00
draw Add margins 2023-04-04 10:25:50 +02:00
locale/fr/LC_MESSAGES Add Abort button 2023-04-04 10:25:49 +02:00
logs Don't trigger signals on raw imports 2023-04-04 10:25:47 +02:00
participation First interface to start draws 2023-04-04 10:25:48 +02:00
registration Don't trigger signals on raw imports 2023-04-04 10:25:47 +02:00
tfjm Fix tests 2023-04-04 10:25:48 +02:00
.bashrc Smaller bashrc 2020-09-19 21:31:11 +02:00
.dockerignore Reset project 2020-12-27 11:14:35 +01:00
.gitignore Commit bootstrap-select 2023-02-20 21:47:08 +01:00
.gitlab-ci.yml Drop Python 3.8 support, add Python 3.10 and 3.11 support 2022-11-08 15:55:09 +01:00
Dockerfile Drop Python 3.8 support, add Python 3.10 and 3.11 support 2022-11-08 15:55:09 +01:00
LICENSE Clone Corres2math platform 2020-12-27 11:49:54 +01:00
README.md Clone Corres2math platform 2020-12-27 11:49:54 +01:00
entrypoint.sh Run ASGI server instead of WSGI 2023-04-04 10:25:46 +02:00
manage.py Clone Corres2math platform 2020-12-27 11:49:54 +01:00
nginx_tfjm.conf Prepare documentation on /doc 2021-01-20 15:00:26 +01:00
requirements.txt First play with websockets 2023-04-04 10:25:47 +02:00
tfjm.cron Matrix cron is buggy 2021-03-28 20:08:00 +02:00
tox.ini Fix tox 2023-04-04 10:25:47 +02:00

README.md

Plateforme du TFJM²

pipeline status coverage report

La plateforme du TFJM² est née pour la dixième édition en 2019 de l'action. D'abord codée en PHP, elle a subi une refonte totale en Python, à l'aide du framework Web Django.

Cette plateforme permet aux participants et encadrants de s'inscrire et de déposer leurs autorisations nécessaires. Ils pourront ensuite déposer leurs solutions et notes de synthèse pour le premier tour en temps voulu. La plateforme offre également un accès pour les organisateurs et les jurys leur permettant de communiquer avec les équipes et de récupérer les documents nécessaires.

Un wiki plus détaillé arrivera ultérieurement. L'interface organisateur et jury est vouée à être plus poussée.

L'instance de production est disponible à l'adresse inscription.tfjm.org.

Installation

Le plus simple pour installer la plateforme est d'utiliser l'image Docker incluse, qui fait tourner un serveur Nginx exposé sur le port 80 avec le serveur Django. Ci-dessous une configuration Docker-Compose, à adapter selon vos besoins :

  plateforme-tfjm:
    build: https://gitlab.com/animath/si/plateforme-tfjm.git
    links:
      - postgres
    ports:
      - "80:80"
    env_file:
      - ./inscription-tfjm.env
    volumes:
    # - ./inscription-tfjm:/code
      - ./inscription-tfjm/media:/code/media

Le volume /code n'est à ajouter uniquement en développement, et jamais en production.

Il faut remplir les variables d'environnement suivantes :

TFJM_STAGE=                     # dev ou prod
DJANGO_DB_TYPE=                 # MySQL, PostgreSQL ou SQLite (par défaut)
DJANGO_DB_HOST=                 # Hôte de la base de données
DJANGO_DB_NAME=                 # Nom de la base de données
DJANGO_DB_USER=                 # Utilisateur de la base de données
DJANGO_DB_PASSWORD=             # Mot de passe pour accéder à la base de données
SMTP_HOST=                      # Hôte SMTP pour l'envoi de mails
SMTP_PORT=465                   # Port du serveur SMTP
SMTP_HOST_USER=                 # Utilisateur du compte SMTP
SMTP_HOST_PASSWORD=             # Mot de passe du compte SMTP
FROM_EMAIL=contact@tfjm.org     # Nom de l'expéditeur des mails
SERVER_EMAIL=contact@tfjm.org   # Adresse e-mail expéditrice
SYMPA_URL=lists.example.com     # Serveur Sympa à utiliser
SYMPA_EMAIL=                    # Adresse e-mail du compte administrateur de Sympa
SYMPA_PASSWORD=                 # Mot de passe du compte administrateur de Sympa
SYNAPSE_PASSWORD=               # Mot de passe du robot Matrix 

Si le type de base de données sélectionné est SQLite, la variable DJANGO_DB_HOST sera utilisée en guise de chemin vers le fichier de base de données (par défaut, db.sqlite3).

En développement, il est recommandé d'utiliser SQLite pour des raisons de simplicité. Les paramètres de mail ne seront pas utilisés, et les mails qui doivent être envoyés seront envoyés dans la console. Les intégrations mail et Matrix seront également désactivées.

En production, il est recommandé de ne pas utiliser SQLite pour des raisons de performances.

La dernière différence entre le développment et la production est qu'en développement, chaque modification d'un fichier est détectée et le serveur se relance automatiquement dès lors.