Added ended_at time to exam_enrollments and student button for studen…

…ts to end exam

services/course-material/src/pages/[organizationSlug]/exams/[id].tsx

@@ -14,12 +14,14 @@ import PageContext, { CoursePageDispatch, getDefaultPageState } from "../../../c
 import useTime from "../../../hooks/useTime"
 import pageStateReducer from "../../../reducers/pageStateReducer"
 
-import { Block, enrollInExam, fetchExam } from "@/services/backend"
+import { Block, endExamTime, enrollInExam, fetchExam } from "@/services/backend"
+import Button from "@/shared-module/common/components/Button"
 import BreakFromCentered from "@/shared-module/common/components/Centering/BreakFromCentered"
 import ErrorBanner from "@/shared-module/common/components/ErrorBanner"
 import Spinner from "@/shared-module/common/components/Spinner"
 import HideTextInSystemTests from "@/shared-module/common/components/system-tests/HideTextInSystemTests"
 import { withSignedIn } from "@/shared-module/common/contexts/LoginStateContext"
+import useToastMutation from "@/shared-module/common/hooks/useToastMutation"
 import { baseTheme, headingFont } from "@/shared-module/common/styles"
 import { respondToOrLarger } from "@/shared-module/common/styles/respond"
 import dontRenderUntilQueryParametersReady, {
@@ -88,6 +90,20 @@ const Exam: React.FC<React.PropsWithChildren<ExamProps>> = ({ query }) => {
     await handleRefresh()
   }, [handleRefresh])
 
+  const handleEndExam = () => {
+    endExamMutation.mutate({ id: examId })
+  }
+
+  const endExamMutation = useToastMutation(
+    ({ id }: { id: string }) => endExamTime(id),
+    { notify: true, method: "POST" },
+    {
+      onSuccess: () => {
+        handleRefresh()
+      },
+    },
+  )
+
   if (exam.isPending) {
     return <Spinner variant="medium" />
   }
@@ -316,6 +332,18 @@ const Exam: React.FC<React.PropsWithChildren<ExamProps>> = ({ query }) => {
           </div>
         )}
         <Page onRefresh={handleRefresh} organizationSlug={query.organizationSlug} />
+        <Button
+          variant={"primary"}
+          size={"small"}
+          onClick={() => {
+            const confirmation = confirm(t("message-do-you-want-to-end-the-exam"))
+            if (confirmation) {
+              handleEndExam()
+            }
+          }}
+        >
+          {t("button-end-exam")}
+        </Button>
       </PageContext.Provider>
     </CoursePageDispatch.Provider>
   )

services/course-material/src/services/backend.ts

@@ -653,3 +653,8 @@ export const fetchExerciseSubmissions = async (
   )
   return validateResponse(response, isExerciseSlideSubmissionAndUserExerciseStateList)
 }
+
+export const endExamTime = async (examId: string): Promise<void> => {
+  const response = await courseMaterialClient.post(`/exams/${examId}/end-exam-time`)
+  return response.data
+}

services/headless-lms/migrations/20240626125425_add_ended_at_to_exam_enrollments.down.sql

@@ -0,0 +1 @@
+ALTER TABLE exam_enrollments DROP COLUMN ended_at;

services/headless-lms/migrations/20240626125425_add_ended_at_to_exam_enrollments.up.sql

@@ -0,0 +1,3 @@
+ALTER TABLE exam_enrollments
+ADD COLUMN ended_at TIMESTAMP WITH TIME ZONE;
+COMMENT ON COLUMN exam_enrollments.ended_at IS 'Timestamp when the exam has ended. If null, the exam time has not ended.';