quizzard

quizzard

Contenu

0. Introduction
1. Installation

Introduction

quizzard est une application de quiz basée sur le Web conçue pour être utilisée à des fins éducatives.

Installation

Ces instructions vous guideront dans la configuration d'une instance de quizzard .

Avant de continuer, assurez-vous que les dépendances nodejs , npm et mongodb sont installées.

0. Clonez le référentiel.

 $ git clone https://github.com/quizzard-edu/ quizzard

1. Installez les dépendances du module Node.

quizzard $ npm install">

 $ cd quizzard
$ npm install

2. Configurer les paramètres du serveur et la certification SSL
   • Remarque : Pour exécuter cette application localement, vous n'avez pas besoin de modifier les paramètres de configuration.
   1. Allez sur serveur/config.js
   2. Modifiez les ports https et http.
   3. Pour hostName entrez l'adresse Web publique de ce site Web, ex (www. quizzard .com)
   4. Vous pouvez modifier le délai d'expiration de la session, par défaut il est fixé à 2 heures.
   5. Remplacez les certificats SSL auto-signés par défaut par vos certificats.

Pour générer votre propre certificat auto-signé, exécutez le script suivant sur votre shell (terminal) :

• Remarque : assurez-vous que openssl est installé sur votre shell.

   $ sh scripts/certificateGenerator
  

3. Pour sécuriser l'authentification MongoDB et les règles de pare-feu avancées, suivez les étapes fournies sous doc/MongoDb-Security.

   • Remarque : Vous pouvez ignorer cette étape si vous l'exécutez dans un environnement local (localhost).

4. Vous pouvez maintenant lancer le serveur en exécutant

 $ npm start

Si vous n'avez modifié aucun paramètre, vous devriez maintenant pouvoir accéder quizzard en visitant https://localhost:8080 dans votre navigateur.

5. Le port sur lequel s'exécute le serveur et les paramètres de connexion mongodb peuvent être modifiés via les variables d'environnement suivantes :

• DB_HOST - adresse du serveur de base de données mongodb (par défaut : localhost)
• DB_PORT - port de connexion mongodb (par défaut : 27017)
• DB_NAME - nom de la base de données de l'application dans mongodb (par défaut : quizzard )

6. Créez un compte administrateur pour l'application en exécutant node setup.js . Il vous demandera un nom d'utilisateur et un mot de passe.

7. Après avoir créé un compte administrateur, chargez l'application quizzard et connectez-vous avec le compte que vous avez créé. Vous disposez maintenant d’une instance fonctionnelle de quizzard que vous pouvez utiliser.

Contact

Si vous avez une question, trouvez un bug, avez besoin d'une fonctionnalité ou souhaitez contribuer, veuillez envoyer un e-mail à : quizzard [email protected]

Crédits

Le développement de quizzard a commencé et a été soutenu par l'Université de Toronto Mississauga. Vous trouverez ci-dessous une liste des contributeurs à ce jour.

• Alexei Frolov : depuis septembre 2016
• Larry Yueli Zhang : depuis septembre 2016
• Ramy Esteero : depuis septembre 2017
• Mohammed Khan : depuis septembre 2017
• Darshan Mehta : depuis septembre 2017
• Mohamed Mohamed : depuis septembre 2017
• Ahmed Qarmout : depuis septembre 2017

Superviseur : Larry Yueli Zhang