feat(api): exam date use + split prisma files (freeCodeCamp#62344)

Co-authored-by: Oliver Eyton-Williams <[email protected]>

Author: ShaunSHamilton

api/__mocks__/exam-environment-exam.ts

@@ -16,8 +16,9 @@ export const oid = () => new ObjectId().toString();
 
 export const examId = oid();
 
-export const config: ExamEnvironmentConfig = {
+export const config = {
   totalTimeInMS: 2 * 60 * 60 * 1000,
+  totalTimeInS: 2 * 60 * 60,
   tags: [],
   name: 'Test Exam',
   note: 'Some exam note...',
@@ -45,8 +46,9 @@ export const config: ExamEnvironmentConfig = {
       numberOfIncorrectAnswers: 1
     }
   ],
-  retakeTimeInMS: 24 * 60 * 60 * 1000
-};
+  retakeTimeInMS: 24 * 60 * 60 * 1000,
+  retakeTimeInS: 24 * 60 * 60
+} satisfies ExamEnvironmentConfig;
 
 export const questionSets: ExamEnvironmentQuestionSet[] = [
   {
@@ -247,7 +249,7 @@ export const generatedExam: ExamEnvironmentGeneratedExam = {
       ]
     }
   ],
-  version: 1
+  version: 2
 };
 
 export const examAttempt: ExamEnvironmentExamAttempt = {
@@ -261,7 +263,8 @@ export const examAttempt: ExamEnvironmentExamAttempt = {
         {
           id: generatedExam.questionSets[0]!.questions[0]!.id,
           answers: [generatedExam.questionSets[0]!.questions[0]!.answers[0]!],
-          submissionTimeInMS: Date.now()
+          submissionTimeInMS: Date.now(),
+          submissionTime: new Date()
         }
       ]
     },
@@ -271,7 +274,8 @@ export const examAttempt: ExamEnvironmentExamAttempt = {
         {
           id: generatedExam.questionSets[1]!.questions[0]!.id,
           answers: [generatedExam.questionSets[1]!.questions[0]!.answers[1]!],
-          submissionTimeInMS: Date.now()
+          submissionTimeInMS: Date.now(),
+          submissionTime: new Date()
         }
       ]
     },
@@ -281,22 +285,25 @@ export const examAttempt: ExamEnvironmentExamAttempt = {
         {
           id: generatedExam.questionSets[2]!.questions[0]!.id,
           answers: [generatedExam.questionSets[2]!.questions[0]!.answers[1]!],
-          submissionTimeInMS: Date.now()
+          submissionTimeInMS: Date.now(),
+          submissionTime: new Date()
         },
         {
           id: generatedExam.questionSets[2]!.questions[1]!.id,
           answers: [generatedExam.questionSets[2]!.questions[1]!.answers[0]!],
-          submissionTimeInMS: Date.now()
+          submissionTimeInMS: Date.now(),
+          submissionTime: new Date()
         }
       ]
     }
   ],
   startTimeInMS: Date.now(),
+  startTime: new Date(),
   userId: defaultUserId,
-  version: 1
+  version: 2
 };
 
-export const examAttemptSansSubmissionTimeInMS: Static<
+export const examAttemptSansSubmissionTime: Static<
   typeof examEnvironmentPostExamAttempt.body
 >['attempt'] = {
   examId,
@@ -335,20 +342,21 @@ export const examAttemptSansSubmissionTimeInMS: Static<
   ]
 };
 
-export const exam: ExamEnvironmentExam = {
+export const exam = {
   id: examId,
   config,
   questionSets,
   prerequisites: ['67112fe1c994faa2c26d0b1d'],
   deprecated: false,
-  version: 1
-};
+  version: 2
+} satisfies ExamEnvironmentExam;
 
 export const examEnvironmentChallenge: ExamEnvironmentChallenge = {
   id: oid(),
   examId,
   // Id of the certified full stack developer exam challenge page
-  challengeId: '645147516c245de4d11eb7ba'
+  challengeId: '645147516c245de4d11eb7ba',
+  version: 1
 };
 
 export async function seedEnvExam() {

api/package.json

@@ -13,7 +13,7 @@
     "@fastify/swagger-ui": "5.2.0",
     "@fastify/type-provider-typebox": "5.1.0",
     "@growthbook/growthbook": "1.3.1",
-    "@prisma/client": "5.5.2",
+    "@prisma/client": "6.16.2",
     "@sentry/node": "9.1.0",
     "@sinclair/typebox": "^0.34.33",
     "@types/pino": "^7.0.5",
@@ -51,7 +51,7 @@
     "dotenv-cli": "7.3.0",
     "jsdom": "^26.1.0",
     "msw": "^2.7.0",
-    "prisma": "5.5.2",
+    "prisma": "6.16.2",
     "supertest": "6.3.3",
     "tsx": "4.19.1",
     "vitest": "^3.2.4"

api/prisma.config.ts

@@ -0,0 +1,5 @@
+import type { PrismaConfig } from 'prisma';
+
+export default {
+  schema: 'prisma'
+} satisfies PrismaConfig;

api/prisma/exam-creator.prisma

@@ -0,0 +1,62 @@
+/// A copy of `ExamEnvironmentExam` used as a staging collection for updates to the curriculum.
+///
+/// This collection schema must be kept in sync with `ExamEnvironmentExam`.
+model ExamCreatorExam {
+  /// Globally unique exam id
+  id            String                       @id @default(auto()) @map("_id") @db.ObjectId
+  /// All questions for a given exam
+  questionSets  ExamEnvironmentQuestionSet[]
+  /// Configuration for exam metadata
+  config        ExamEnvironmentConfig
+  /// ObjectIds for required challenges/blocks to take the exam
+  prerequisites String[]                     @db.ObjectId
+  /// If `deprecated`, the exam should no longer be considered for users
+  deprecated    Boolean
+  /// Version of the record
+  /// The default must be incremented by 1, if anything in the schema changes
+  version       Int                          @default(2)
+
+}
+
+/// Exam Creator application collection to store authZ users.
+///
+/// Currently, this is manually created in order to grant access to the application.
+model ExamCreatorUser {
+  id        String                  @id @default(auto()) @map("_id") @db.ObjectId
+  email     String
+  /// Unique id from GitHub for an account.
+  ///
+  /// Currently, this is unused. Consider removing.
+  github_id Int?
+  name      String
+  picture   String?
+  /// TODO: After migration, remove optionality
+  settings  ExamCreatorUserSettings?
+  version   Int                     @default(1)
+
+
+  ExamCreatorSession ExamCreatorSession[]
+}
+
+type ExamCreatorUserSettings {
+  databaseEnvironment ExamCreatorDatabaseEnvironment
+}
+
+enum ExamCreatorDatabaseEnvironment {
+  Production
+  Staging
+}
+
+/// Exam Creator application collection to store auth sessions.
+model ExamCreatorSession {
+  id         String   @id @default(auto()) @map("_id") @db.ObjectId
+  user_id    String   @db.ObjectId
+  session_id String
+  /// Expiration date for record.
+  expires_at DateTime
+
+  version   Int      @default(1)
+
+
+  ExamCreatorUser ExamCreatorUser @relation(fields: [user_id], references: [id])
+}