Questions - Réponses en live

Afficher un questionnaire en live pendant vos cours, vos étudiant peuvent y répondre facilement sur leur ordinateur ou leur téléphone.

Création du questionnaire

Aller sur https://qcm.bramas.fr et cliquer sur Créer.

Dans l'éditeur de questionnaire, écriver des questions au format Markdown. Les différentes questions doivent être séparées par une ligne contenant ---.

Les réponses possibles suivent un format spécifique qui resemble au Markdown.

• Pour des réponses type QCM, où une seule réponse est possible, terminer la question par une ligne choice: suivie par les réponses sur des lignes différentes commençant toutes par *. La bonne réponse doit commencer par X au lieu de * exemple de question complète:

  ## Quelle est la capitale de l'équateur ?
  
  choice:
  * Paris
  * Lima
  * Quito
  * Bogota

• Pour des réponses type QCM, où plusieurs réponses sont possibles, faire comme précédemment, mais utiliser le mot choices au lieu de choice.

  #### Quels sont les étapes pour obtenir un exécutable à partir d'un fichier source en C ?
  
  choices:
  * Montage
  X Edition de liens
  * Tissage
  X Compilation
  X Préprocesseur
  X Assemblage
  * Metaprocesseur

  Une question n'a pas forcément de bonne réponse mais peut juste être utilisée pour receuillir l'avis du public, exemple :

  ## Quel langage de programmation avez-vous déjà utilisé ?
  
  choices:
  * Java
  * Go
  * C/C++
  * Julia
  * Golo
  * Autre

• Pour des réponses libres il faut utiliser le mot input :

  ## Quel langage de programmation avez-vous déjà utilisé ?
  
  input:

  ## Quelle est la capitale de l'équateur ?
  
  input:
    correction: Quito

Utilisation du questionnaire

Donnez le lien aux participants afin qu'ils puissent se connecter, ou dites leur d'aller sur https://qcm.bramas.fr et d'entrer l'identifiant (5 charactères alphanumériques) du questionnaire pour se connecter.

lorsque tout le monde est prêt, cliquez sur "Démarrer" et déplacez vous dans le questionnaire.

Le déroulement du questionnaire peut être automatique (un timer défini la durée d'affichage des questions). Pour cela cochez "Avec timer" et indiquez la durée en secondes de chaque question. Vous pouvez aussi faire en sorte que l'ordre des questions soit rendomiser en cochant "randomiser" (l'ordre des réponses dans le QCM est toujours randomisé).

Si "Forcer l'authentification" est cochée les étudiants devront être authentifié avec leur compte unistra pour pouvoir se connecter au questionnaire. Les étudiants déjà connecté le resteront donc pensez à le faire avant de leur donner le lien.

Une fois la dernière question terminé (le slide "terminé" s'affiche), vous pouver vous déplacer dans les question, les étudiants ne peuvent plus éditer leurs réponses. Vous pouvez regarder les réponses des étudiants en cliquant sur "Réponses".

Le boutton "Rapport" génère des tableaux en bas de page contenant les réponses de tous les étudiants authentifiés avec une indication si les réponses sont correctes ou erronées. Le dernier tableau contient un récapitulatif par étudiant du nombre de bonnes et de mauvaises réponses (qui peut donc être utilisé pour faire une notation). Uniquement les questions qui possèdent "une bonne réponse" sont prises en compte pour ce dernier tableau.

Lancer le serveur avec Docker

Vous pouvez lancer le serveur ainsi:

docker run -p 80:3000 -v /path/to/db:/usr/src/app/storage --env JWT_SECRET=SECRET_KEY --env CLIENT_URL=https://front-end-url --env API_URL=https://back-end-url registry.app.unistra.fr/bramas/live-qcm

Développement

Installer les packages pour le serveur et le client.

  yarn install

Compiler le client

  yarn build

Lancer le serveur

  yarn start

Pour lancer le client en mode développement avec recompilation automatique après modification d'un fichier

  yarn client-watch

Pour lancer le serveur en mode développement avec recompilation automatique après modification d'un fichier

yarn server-watch

Auteur

Quentin Bramas bramas@unistra.fr