Features implemented: - F1: Email digest notifications with cron endpoint and per-user frequency - F2: Jury availability windows and workload preferences in smart assignment - F3: Round templates with save-from-round and CRUD management - F4: Side-by-side project comparison view for jury members - F5: Real-time voting dashboard with Server-Sent Events (SSE) - F6: Live voting UX: QR codes, audience voting, tie-breaking, score animations - F7: File versioning, inline preview, bulk download with presigned URLs - F8: Mentor dashboard: milestones, private notes, activity tracking - F9: Communication hub with broadcasts, templates, and recipient targeting - F10: Advanced analytics: cross-round comparison, juror consistency, diversity metrics, PDF export - F11: Applicant draft saving with magic link resume and cron cleanup - F12: Webhook integration layer with HMAC signing, retry, and delivery logs - F13: Peer review discussions with anonymized scores and threaded comments - F14: Audit log enhancements: before/after diffs, session grouping, anomaly detection, retention - F15: i18n foundation with next-intl (EN/FR), cookie-based locale, language switcher Schema: 12 new models, field additions to User, Project, ProjectFile, LiveVotingSession, LiveVote, MentorAssignment, AuditLog, Program New routers: roundTemplate, message, webhook (registered in _app.ts) New services: email-digest, webhook-dispatcher New cron endpoints: /api/cron/digest, /api/cron/draft-cleanup, /api/cron/audit-cleanup New API routes: /api/live-voting/stream (SSE), /api/files/bulk-download All features are admin-configurable via SystemSettings or per-model settingsJson fields. Docker build verified successfully. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
114 lines
2.8 KiB
TypeScript
114 lines
2.8 KiB
TypeScript
'use client'
|
|
|
|
import { useEffect, useRef, useCallback, useState } from 'react'
|
|
|
|
export interface VoteUpdate {
|
|
projectId: string
|
|
totalVotes: number
|
|
averageScore: number | null
|
|
latestVote: { score: number; isAudienceVote: boolean; votedAt: string } | null
|
|
timestamp: string
|
|
}
|
|
|
|
export interface SessionStatusUpdate {
|
|
status: string
|
|
timestamp: string
|
|
}
|
|
|
|
export interface ProjectChangeUpdate {
|
|
projectId: string | null
|
|
projectIndex: number
|
|
timestamp: string
|
|
}
|
|
|
|
interface SSECallbacks {
|
|
onVoteUpdate?: (data: VoteUpdate) => void
|
|
onSessionStatus?: (data: SessionStatusUpdate) => void
|
|
onProjectChange?: (data: ProjectChangeUpdate) => void
|
|
onConnected?: () => void
|
|
onError?: (error: Event) => void
|
|
}
|
|
|
|
export function useLiveVotingSSE(
|
|
sessionId: string | null,
|
|
callbacks: SSECallbacks
|
|
) {
|
|
const [isConnected, setIsConnected] = useState(false)
|
|
const eventSourceRef = useRef<EventSource | null>(null)
|
|
const callbacksRef = useRef(callbacks)
|
|
callbacksRef.current = callbacks
|
|
|
|
const connect = useCallback(() => {
|
|
if (!sessionId) return
|
|
|
|
// Close any existing connection
|
|
if (eventSourceRef.current) {
|
|
eventSourceRef.current.close()
|
|
}
|
|
|
|
const baseUrl = typeof window !== 'undefined' ? window.location.origin : ''
|
|
const url = `${baseUrl}/api/live-voting/stream?sessionId=${sessionId}`
|
|
const es = new EventSource(url)
|
|
eventSourceRef.current = es
|
|
|
|
es.addEventListener('connected', () => {
|
|
setIsConnected(true)
|
|
callbacksRef.current.onConnected?.()
|
|
})
|
|
|
|
es.addEventListener('vote_update', (event) => {
|
|
try {
|
|
const data = JSON.parse(event.data) as VoteUpdate
|
|
callbacksRef.current.onVoteUpdate?.(data)
|
|
} catch {
|
|
// Ignore parse errors
|
|
}
|
|
})
|
|
|
|
es.addEventListener('session_status', (event) => {
|
|
try {
|
|
const data = JSON.parse(event.data) as SessionStatusUpdate
|
|
callbacksRef.current.onSessionStatus?.(data)
|
|
} catch {
|
|
// Ignore parse errors
|
|
}
|
|
})
|
|
|
|
es.addEventListener('project_change', (event) => {
|
|
try {
|
|
const data = JSON.parse(event.data) as ProjectChangeUpdate
|
|
callbacksRef.current.onProjectChange?.(data)
|
|
} catch {
|
|
// Ignore parse errors
|
|
}
|
|
})
|
|
|
|
es.onerror = (event) => {
|
|
setIsConnected(false)
|
|
callbacksRef.current.onError?.(event)
|
|
|
|
// Auto-reconnect after 3 seconds
|
|
setTimeout(() => {
|
|
if (eventSourceRef.current === es) {
|
|
connect()
|
|
}
|
|
}, 3000)
|
|
}
|
|
}, [sessionId])
|
|
|
|
const disconnect = useCallback(() => {
|
|
if (eventSourceRef.current) {
|
|
eventSourceRef.current.close()
|
|
eventSourceRef.current = null
|
|
setIsConnected(false)
|
|
}
|
|
}, [])
|
|
|
|
useEffect(() => {
|
|
connect()
|
|
return () => disconnect()
|
|
}, [connect, disconnect])
|
|
|
|
return { isConnected, reconnect: connect, disconnect }
|
|
}
|