junzhengca / ifcat-ia

Immediate-Feedback Collaborative Assessment Tool. A quiz application for any classroom. This fork has full integration with Identity Atheneum to support enterprise logins.

IMPORTANT NOTICE

This repository is deprecated, new repository resides in cms-urg organization. You can find it here: https://github.com/cms-urg/IFCAT-IA

IFCAT-IA

Immediate-Feedback Collaborative Assessment Tool is a collaborative quiz application for the classroom, based on immediate feedback assessment technique.

Quick Start

First make sure you read the configuration part, and have a config.json ready.

Then simply run npm install && npm start to start the server.

Configuration

Application configuration is stored within config.json, and is in the following format:

• name: String - Application name, usually just use ifcat.
• baseDir: String - Application base directory, for example, if you want to host IFCAT under domain.local/ifcat, then base directory would be /ifcat.
• database: Object
  • url: String - Mongoose connection URL.
• session: Object
  • secret: String - Session secret, used to encrypt sessions.
• ia: Object
  • applicationId: String - Your application ID.
  • secretKey: String - Your application secret key.
  • root: String - Server root.
  • publicRoot: String - Optional. You can optionally set this, and set root as a LAN url, this will make
• log: Object
  • path: String - Path to store logs.

Want to Contribute?

Please head over to CONTRIBUTING for details.

Built by students at the University of Toronto Scarborough with ❤️

ifcat-ia's Issues

Race condition in QuizSocketController.attemptAnswer

There is a race condition in attempt answer.

The detailed description of this race condition:

Student emit ANSWER_ATTEMPT        -       0
Server 1 Response.findOne          -       1
Server 1 got no response           -       2
Student emit ANSWER_ATTEMPT        -       3
Server 2 Response.findOne          -       4
Server 1 write new response        -       5
Server 2 got no response           -       6
Server 2 write new response        -       7

As illustrated above, the student just attempted the question twice and received double the score.

Groups should be able to switch drivers

Students groups should be able to switch drivers by emitting a RESET_DRIVER event.

Once the event is emitted to the server, it should immediately clear the driver and ask the group to elect a new one.

TypeErrorControllers.Admin:QuizSocketController in Socket.<anonymous> error Cannot set property 'driver' of null

Exception detail:

TypeError: Cannot set property 'driver' of null
  File "/home/zhengj69/IFCAT/Controllers/Admin/QuizSocketController.js", line 113, col 26, in Socket.<anonymous>
    group.driver = connection.getUser().getId();
  ?, in null.<anonymous>
  File "internal/process/next_tick.js", line 229, col 7, in process._tickDomainCallback [as _tickCallback]

Sentry: https://sentry.io/jun-zheng/server/issues/867891252/?query=is%3Aunresolved

Requests to Identity Atheneum should have a caching algorithm

Currently, we are requesting the service way too much. Have a TTL value, and only update authentication detail after the time has passed.

Server should only allow one WebSocket connection per user

Currently it is accepting multiple connections from the same user, which can drain server resources.

Modify ConnectionPool singleton so it automatically disconnects old connections when new one arrives.

Student should be able to see their total score on the quiz status page

Quiz status page can be found under views, it is a React component.

Use this simple algorithm to determine the total possible score for a quiz.

for question in questions:
    total += question.score + question.bonus