feat(final-docs): notify mentor when a finalist uploads a Grand Final document

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

tests/unit/final-documents.test.ts

@@ -20,6 +20,7 @@ import * as applicantRouter from '@/server/routers/applicant'
 import * as finalistRouter from '@/server/routers/finalist'
 import * as mentorRouter from '@/server/routers/mentor'
 import { createCaller } from '../setup'
+import { BUCKET_NAME, generateObjectKey } from '@/lib/minio'
 
 const programIds: string[] = []
 
@@ -270,3 +271,30 @@ describe('mentor.getProjectFinalDocuments', () => {
     await expect(caller.getProjectFinalDocuments({ projectId: project.id })).rejects.toThrow()
   })
 })
+
+describe('saveFileMetadata → GRAND_FINAL_DOCS_SUBMITTED', () => {
+  const localPrograms: string[] = []
+  const localUsers: string[] = []
+  afterAll(async () => { for (const id of localPrograms) await cleanupTestData(id, localUsers) })
+
+  it('notifies the mentor when a finalist uploads a LIVE_FINAL document', async () => {
+    const program = await createTestProgram(); localPrograms.push(program.id)
+    const comp = await createTestCompetition(program.id, { status: 'ACTIVE' })
+    const round = await createTestRound(comp.id, { roundType: 'LIVE_FINAL', status: 'ROUND_ACTIVE', sortOrder: 6 })
+    const req = await prisma.fileRequirement.create({ data: { id: uid('req'), roundId: round.id, name: 'Executive Summary', acceptedMimeTypes: ['application/pdf'], isRequired: true, sortOrder: 1 } })
+    const project = await createTestProject(program.id)
+    await createTestProjectRoundState(project.id, round.id)
+    const lead = await createTestUser('APPLICANT'); localUsers.push(lead.id)
+    await prisma.teamMember.create({ data: { projectId: project.id, userId: lead.id, role: 'LEAD' } })
+    const mentor = await createTestUser('MENTOR'); localUsers.push(mentor.id)
+    await prisma.mentorAssignment.create({ data: { projectId: project.id, mentorId: mentor.id } })
+
+    const caller = createCaller(applicantRouter.applicantRouter, lead)
+    await caller.saveFileMetadata({
+      projectId: project.id, fileName: 'exec.pdf', mimeType: 'application/pdf', size: 100,
+      fileType: 'EXEC_SUMMARY', bucket: BUCKET_NAME, objectKey: generateObjectKey(project.title, 'exec.pdf'), roundId: round.id, requirementId: req.id,
+    })
+    const notif = await prisma.inAppNotification.findFirst({ where: { userId: mentor.id, type: 'GRAND_FINAL_DOCS_SUBMITTED' } })
+    expect(notif).not.toBeNull()
+  })
+})