refactor: update result schemas and tests for improved state management and feedback modes

backend/src/validators/resultSchemas.test.ts

@@ -11,12 +11,12 @@ describe('submitResultSchema', () => {
       graded_count: 10,
       elapsed_ms: 120000,
       state: {
+        currentIdx: 0,
         answers: { q1: 'a' },
-        gradedAnswers: { q1: { correct: true, points: 1 } },
-        answeredCount: 10,
-        score: 80,
-        correctCount: 8,
-        gradedCount: 10,
+        flags: { q1: false },
+        notes: '',
+        startedAt: Date.now(),
+        feedbackMode: 'end',
       },
       exam: {
         title: 'My Exam',
@@ -34,12 +34,12 @@ describe('submitResultSchema', () => {
       graded_count: 10,
       elapsed_ms: 120000,
       state: {
+        currentIdx: 0,
         answers: {},
-        gradedAnswers: {},
-        answeredCount: 0,
-        score: 0,
-        correctCount: 0,
-        gradedCount: 0,
+        flags: {},
+        notes: '',
+        startedAt: Date.now(),
+        feedbackMode: 'end',
       },
       exam: { title: 'My Exam', questions: [] },
     })
@@ -56,12 +56,12 @@ describe('submitResultSchema', () => {
       graded_count: 10,
       elapsed_ms: 120000,
       state: {
+        currentIdx: 0,
         answers: {},
-        gradedAnswers: {},
-        answeredCount: 0,
-        score: 0,
-        correctCount: 0,
-        gradedCount: 0,
+        flags: {},
+        notes: '',
+        startedAt: Date.now(),
+        feedbackMode: 'end',
       },
       exam: { title: 'My Exam', questions: [] },
     })
@@ -77,12 +77,35 @@ describe('submitResultSchema', () => {
       graded_count: 10,
       elapsed_ms: 120000,
       state: {
+        currentIdx: 0,
         answers: {},
-        gradedAnswers: {},
-        answeredCount: 0,
-        score: 0,
-        correctCount: 0,
-        gradedCount: 0,
+        flags: {},
+        notes: '',
+        startedAt: Date.now(),
+        feedbackMode: 'end',
+      },
+      exam: { title: 'My Exam', questions: [] },
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts immediate feedback mode', () => {
+    const result = submitResultSchema.safeParse({
+      title: 'My Exam',
+      score_points: 8,
+      total_points: 10,
+      correct_count: 8,
+      graded_count: 10,
+      elapsed_ms: 120000,
+      state: {
+        currentIdx: 2,
+        answers: { q1: 'a', q2: 'b' },
+        flags: { q1: true },
+        notes: 'some notes',
+        revealed: { q1: true },
+        startedAt: Date.now(),
+        completedAt: Date.now(),
+        feedbackMode: 'immediate',
       },
       exam: { title: 'My Exam', questions: [] },
     })

backend/src/validators/resultSchemas.ts

@@ -1,7 +1,5 @@
 import { z } from 'zod'
 
-const answerValueSchema = z.union([z.string(), z.array(z.string()), z.record(z.string(), z.string())])
-
 export const submitResultSchema = z.object({
   exam_id: z.number().nullable().optional(),
   title: z.string().min(1),
@@ -11,28 +9,8 @@ export const submitResultSchema = z.object({
   graded_count: z.number(),
   passing_score: z.number().optional(),
   elapsed_ms: z.number(),
-  state: z.object({
-    answers: z.record(z.string(), answerValueSchema),
-    gradedAnswers: z.record(z.string(), z.object({
-      correct: z.boolean(),
-      points: z.number(),
-      explanation: z.string().optional(),
-    })),
-    answeredCount: z.number(),
-    score: z.number(),
-    correctCount: z.number(),
-    gradedCount: z.number(),
-    timeExpired: z.boolean().optional(),
-  }),
-  exam: z.object({
-    id: z.string().optional(),
-    title: z.string(),
-    subtitle: z.string().optional(),
-    questions: z.array(z.any()),
-    timeLimitMinutes: z.number().nullable().optional(),
-    passingScore: z.number().optional(),
-    feedbackMode: z.enum(['end', 'immediate']).optional(),
-  }).passthrough(),
+  state: z.record(z.unknown()),
+  exam: z.record(z.unknown()),
 })
 
 export const resultIdParamSchema = z.object({