Added Exam mode #1236

iZUMi-kyouka · 2025-03-04T15:17:21Z

Description

Added exam mode functionality in the backend by adding enable_exam_mode and is_official_course in the courses table.
Added get_exam_mode_course() function in lib/cadet/accounts/course_registrations.ex
Modified lib/cadet_web/controllers/user_controller.ex logic in serving the last_viewed_course to always serve the official institution course under exam_mode if any of the user's official course is currently under exam mode. Performed the same modification for get_latest_viewed() function in the same file.
Added the required migrations file to alter the database
Added the 2 additional fields in the model and wherever necessary

01/04/25

Added resume_code to courses table
Added isPaused to users table
Added some tests for enable_exam_mode, is_official_course, and resume_code for the changesets

09/04/25

Added user_browser_focus_log table in the DB
Added the required endpoint to log when a user's browser loses focus and regains focus when under exam mode

Note: this may require change to the DB diagram in README.md

Type of Change

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
This change requires a documentation update
Code quality improvements

Checklist

I have tested this code
I have updated the documentation

…ar course under exam mode

…any of a user's courses

…for addition of enable_exam_mode and is_official_course to courses table

…ents circumventing force redirection to official course under exam mode

RichDom2185

We don't need isOfficialCourse anymore, right?

…m_mode

…ted unused IO.puts

… bypassing overlay by refreshing

RichDom2185

Please fix the failing tests, thanks!

coveralls · 2025-03-31T09:15:05Z

coverage: 92.453% (-1.2%) from 93.607%
when pulling 1c3d787 on iZUMi-kyouka:exam_mode
into 5c7b5cf on source-academy:master.

lib/cadet_web/controllers/user_controller.ex

lib/cadet/courses/course.ex

…cted object. fixed migrations

lib/cadet_web/controllers/courses_controller.ex

GabrielCWT · 2025-04-02T07:24:22Z

lib/cadet/accounts/user.ex

@@ -21,6 +21,7 @@ defmodule Cadet.Accounts.User do
    field(:provider, :string)
    field(:super_admin, :boolean)
    field(:email, :string)
+    field(:is_paused, :boolean)


Is there a reason why this is linked to the user and not their course_registration? Isn't exam mode related to their course.

Initially I thought linking this to the user would allow for the enforcing of the pause beyond the course so that if a user is paused due to opening other app / using dev tool (which is our plan), the user will have to settle the problem with the course admin / coordinator. But, now that you pointed out, maybe this should not affect the user through all their courses. Should I move this course_registration?

@RichDom2185 thoughts?

lib/cadet_web/controllers/user_controller.ex

GabrielCWT · 2025-04-03T05:18:47Z

One more thing which just came to mind. Correct me if I am wrong, your current implementation places all users with a course which has exam mode enabled have their SA placed on some sort of "lock down". Wouldn't this limit the use for admins/staff during the time in which the course is on lock down?

iZUMi-kyouka · 2025-04-03T10:05:09Z

One more thing which just came to mind. Correct me if I am wrong, your current implementation places all users with a course which has exam mode enabled have their SA placed on some sort of "lock down". Wouldn't this limit the use for admins/staff during the time in which the course is on lock down?

@GabrielCWT
Yes this is correct as of now. I will work on excluding them, so that staffs and admins work as usual, thanks!

…o separate private functions for readability.

…_controller; fixed a typing error in send_resp

…ned; improved readibility for pause_user

…es returned; improved readibility for pause_user" This reverts commit 31bbf5a.

…changeset, and applied it in the focus logging controlelr

…ation on creation of new course; rejects all course config update with empty resume code regardless of exam mode state

…de resume_code a required field

…ficial_course, and resume_code

iZUMi-kyouka added 7 commits February 14, 2025 13:53

added enable_exam_mode field to all tests, models, and controllers

fc72d29

force student whose courses has exam mode to only access the particul…

2fc38ca

…ar course under exam mode

fixed failure to switch course even when no exam mode is enabled for …

9953b9c

…any of a user's courses

fixed unintended changes to previous migration; added migration file …

f450e85

…for addition of enable_exam_mode and is_official_course to courses table

added is_official_course field to models; added logic to prevent stud…

0bb9857

…ents circumventing force redirection to official course under exam mode

removed unnecessary changes in course_registrations.ex

d7ad8b3

removed unnecessary changes from user_controller.ex

f216d1b

iZUMi-kyouka requested a review from RichDom2185 March 4, 2025 15:17

sync fork

48fff28

iZUMi-kyouka self-assigned this Mar 4, 2025

iZUMi-kyouka marked this pull request as ready for review March 4, 2025 15:29

Merge branch 'master' into exam_mode

b5f2722

RichDom2185 reviewed Mar 6, 2025

View reviewed changes

iZUMi-kyouka and others added 14 commits March 12, 2025 03:14

added resume code functionality

bc4c48c

Merge remote-tracking branch 'refs/remotes/origin/exam_mode' into exa…

46c2ff0

…m_mode

added resume code checking endpoint and its handler

fe80662

minor change to resume_code handler

f3c9ea9

restore accidental deletion of function

665ad2a

renamed resume_code to check_resume_code

abb1014

added validation for enabling exam mode and setting resume code; dele…

82afebf

…ted unused IO.puts

added is_paused column and setting functionality to mitigate students…

1db4420

… bypassing overlay by refreshing

added migrations for is_paused_column

d88eeba

Merge branch 'master' into exam_mode

d9a97e3

Remove unused tree

40ea386

Fix format

7ae6f14

Merge branch 'master' into exam_mode

e62fcef

Redate migrations to maintain total ordering

e0330f2

RichDom2185 reviewed Mar 31, 2025

View reviewed changes

GabrielCWT requested changes Mar 31, 2025

View reviewed changes

lib/cadet_web/controllers/user_controller.ex Outdated Show resolved Hide resolved

lib/cadet_web/controllers/user_controller.ex Outdated Show resolved Hide resolved

lib/cadet/courses/course.ex Show resolved Hide resolved

iZUMi-kyouka added 5 commits April 1, 2025 22:30

fixed failing tests due to missing fields in factory method, and expe…

d971fcd

…cted object. fixed migrations

Merge branch 'exam_mode_user_paused_flag' into exam_mode

40ce982

makes latest course retrieval logic more concise

0302764

ran mix format on courses and user controller

7fcbc89

added new endpoint to report lost/regain of user focus

cad39c8

GabrielCWT reviewed Apr 2, 2025

View reviewed changes

lib/cadet_web/controllers/user_controller.ex Outdated Show resolved Hide resolved

removed filters for supplying exam_mode_course to renderer function

46af8d7

iZUMi-kyouka added 16 commits April 3, 2025 19:00

renamed check_resume_code to try_unpause_user; split up the logic int…

6531376

…o separate private functions for readability.

removed unnecessary admin config renderer in user_view and admin_user…

3dcc288

…_controller; fixed a typing error in send_resp

excludes staff and admins from exam_mode restriction on courses retur…

31bbf5a

…ned; improved readibility for pause_user

excludes staff and admins from exam_mode restriction on courses retur…

48c1b10

…ned; improved readibility for pause_user

Revert "excludes staff and admins from exam_mode restriction on cours…

e0758fb

…es returned; improved readibility for pause_user" This reverts commit 31bbf5a.

Merge branch 'exam_mode' into exam_mode_user_focus_logging

9154177

created new user_browser_focus_log; and created its type definition, …

7bd79fd

…changeset, and applied it in the focus logging controlelr

removed redundant logic from focus logging controller

ed16cb4

sets a default resume_code in migration; add random resume code gener…

22a5704

…ation on creation of new course; rejects all course config update with empty resume code regardless of exam mode state

fixed resume code validation to consider whitespace; formatting

6cba5f5

added default resume_code value to schema definition in course.ex; ma…

f6ab358

…de resume_code a required field

improved swagger help text for resume_code field; fix formatting

b99a82d

fixed bug in resume_code validation; added tests for exam_mode, is_of…

604b61b

…ficial_course, and resume_code

formatting

ca082c9

formatting

398bee0

add moduledoc for focus log

1c3d787

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added Exam mode #1236

Added Exam mode #1236

iZUMi-kyouka commented Mar 4, 2025 •

edited

Loading

RichDom2185 left a comment

RichDom2185 left a comment

coveralls commented Mar 31, 2025 •

edited

Loading

GabrielCWT Apr 2, 2025

iZUMi-kyouka Apr 2, 2025

GabrielCWT Apr 2, 2025

GabrielCWT commented Apr 3, 2025

iZUMi-kyouka commented Apr 3, 2025 •

edited

Loading

Added Exam mode #1236

Are you sure you want to change the base?

Added Exam mode #1236

Conversation

iZUMi-kyouka commented Mar 4, 2025 • edited Loading

Description

Type of Change

Checklist

RichDom2185 left a comment

Choose a reason for hiding this comment

RichDom2185 left a comment

Choose a reason for hiding this comment

coveralls commented Mar 31, 2025 • edited Loading

GabrielCWT Apr 2, 2025

Choose a reason for hiding this comment

iZUMi-kyouka Apr 2, 2025

Choose a reason for hiding this comment

GabrielCWT Apr 2, 2025

Choose a reason for hiding this comment

GabrielCWT commented Apr 3, 2025

iZUMi-kyouka commented Apr 3, 2025 • edited Loading

iZUMi-kyouka commented Mar 4, 2025 •

edited

Loading

coveralls commented Mar 31, 2025 •

edited

Loading

iZUMi-kyouka commented Apr 3, 2025 •

edited

Loading