Round system redesign: Phases 1-7 complete

Full pipeline/track/stage architecture replacing the legacy round system.

Schema: 11 new models (Pipeline, Track, Stage, StageTransition,
ProjectStageState, RoutingRule, Cohort, CohortProject, LiveProgressCursor,
OverrideAction, AudienceVoter) + 8 new enums.

Backend: 9 new routers (pipeline, stage, routing, stageFiltering,
stageAssignment, cohort, live, decision, award) + 6 new services
(stage-engine, routing-engine, stage-filtering, stage-assignment,
stage-notifications, live-control).

Frontend: Pipeline wizard (17 components), jury stage pages (7),
applicant pipeline pages (3), public stage pages (2), admin pipeline
pages (5), shared stage components (3), SSE route, live hook.

Phase 6 refit: 23 routers/services migrated from roundId to stageId,
all frontend components refitted. Deleted round.ts (985 lines),
roundTemplate.ts, round-helpers.ts, round-settings.ts, round-type-settings.tsx,
10 legacy admin pages, 7 legacy jury pages, 3 legacy dialogs.

Phase 7 validation: 36 tests (10 unit + 8 integration files) all passing,
TypeScript 0 errors, Next.js build succeeds, 13 integrity checks,
legacy symbol sweep clean, auto-seed on first Docker startup.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/components/shared/export-pdf-button.tsx

@@ -19,7 +19,7 @@ import {
 } from '@/lib/pdf-generator'
 
 interface ExportPdfButtonProps {
-  roundId: string
+  stageId: string
   roundName?: string
   programName?: string
   chartRefs?: Record<string, RefObject<HTMLDivElement | null>>
@@ -28,7 +28,7 @@ interface ExportPdfButtonProps {
 }
 
 export function ExportPdfButton({
-  roundId,
+  stageId,
   roundName,
   programName,
   chartRefs,
@@ -38,7 +38,7 @@ export function ExportPdfButton({
   const [generating, setGenerating] = useState(false)
 
   const { refetch } = trpc.export.getReportData.useQuery(
-    { roundId, sections: [] },
+    { stageId, sections: [] },
     { enabled: false }
   )
 

src/components/shared/file-upload.tsx

@@ -46,8 +46,8 @@ interface FileUploadProps {
   allowedTypes?: string[]
   multiple?: boolean
   className?: string
-  roundId?: string
-  availableRounds?: Array<{ id: string; name: string }>
+  stageId?: string
+  availableStages?: Array<{ id: string; name: string }>
 }
 
 // Map MIME types to suggested file types
@@ -85,12 +85,12 @@ export function FileUpload({
   allowedTypes,
   multiple = true,
   className,
-  roundId,
-  availableRounds,
+  stageId,
+  availableStages,
 }: FileUploadProps) {
   const [uploadingFiles, setUploadingFiles] = useState<UploadingFile[]>([])
   const [isDragging, setIsDragging] = useState(false)
-  const [selectedRoundId, setSelectedRoundId] = useState<string | null>(roundId ?? null)
+  const [selectedStageId, setSelectedStageId] = useState<string | null>(stageId ?? null)
   const fileInputRef = useRef<HTMLInputElement>(null)
 
   const getUploadUrl = trpc.file.getUploadUrl.useMutation()
@@ -129,7 +129,7 @@ export function FileUpload({
           fileType,
           mimeType: file.type || 'application/octet-stream',
           size: file.size,
-          roundId: selectedRoundId ?? undefined,
+          stageId: selectedStageId ?? undefined,
         })
 
         // Store the DB file ID
@@ -309,24 +309,24 @@ export function FileUpload({
 
   return (
     <div className={cn('space-y-4', className)}>
-      {/* Round selector */}
-      {availableRounds && availableRounds.length > 0 && (
+      {/* Stage selector */}
+      {availableStages && availableStages.length > 0 && (
         <div className="space-y-2">
           <label className="text-sm font-medium">
-            Upload for Round
+            Upload for Stage
           </label>
           <Select
-            value={selectedRoundId ?? 'null'}
-            onValueChange={(value) => setSelectedRoundId(value === 'null' ? null : value)}
+            value={selectedStageId ?? 'null'}
+            onValueChange={(value) => setSelectedStageId(value === 'null' ? null : value)}
           >
             <SelectTrigger className="w-full">
-              <SelectValue placeholder="Select a round" />
+              <SelectValue placeholder="Select a stage" />
             </SelectTrigger>
             <SelectContent>
-              <SelectItem value="null">General (no specific round)</SelectItem>
-              {availableRounds.map((round) => (
-                <SelectItem key={round.id} value={round.id}>
-                  {round.name}
+              <SelectItem value="null">General (no specific stage)</SelectItem>
+              {availableStages.map((stage) => (
+                <SelectItem key={stage.id} value={stage.id}>
+                  {stage.name}
                 </SelectItem>
               ))}
             </SelectContent>

src/components/shared/file-viewer.tsx

@@ -67,18 +67,18 @@ interface ProjectFile {
   requirement?: FileRequirementInfo | null
 }
 
-interface RoundGroup {
-  roundId: string | null
-  roundName: string
+interface StageGroup {
+  stageId: string | null
+  stageName: string
   sortOrder: number
   files: Array<ProjectFile & { isLate?: boolean }>
 }
 
 interface FileViewerProps {
   files?: ProjectFile[]
-  groupedFiles?: RoundGroup[]
+  groupedFiles?: StageGroup[]
   projectId?: string
-  roundId?: string
+  stageId?: string
   className?: string
 }
 
@@ -118,7 +118,7 @@ function getFileTypeLabel(fileType: string) {
   }
 }
 
-export function FileViewer({ files, groupedFiles, projectId, roundId, className }: FileViewerProps) {
+export function FileViewer({ files, groupedFiles, projectId, stageId, className }: FileViewerProps) {
   // Render grouped view if groupedFiles is provided
   if (groupedFiles) {
     return <GroupedFileViewer groupedFiles={groupedFiles} className={className} />
@@ -148,7 +148,7 @@ export function FileViewer({ files, groupedFiles, projectId, roundId, className
   return (
     <div className={cn('space-y-4', className)}>
       {/* Requirement Fulfillment Checklist */}
-      {roundId && <RequirementChecklist roundId={roundId} files={files} />}
+      {stageId && <RequirementChecklist stageId={stageId} files={files} />}
 
       <Card>
       <CardHeader className="flex flex-row items-center justify-between space-y-0">
@@ -167,7 +167,7 @@ export function FileViewer({ files, groupedFiles, projectId, roundId, className
   )
 }
 
-function GroupedFileViewer({ groupedFiles, className }: { groupedFiles: RoundGroup[], className?: string }) {
+function GroupedFileViewer({ groupedFiles, className }: { groupedFiles: StageGroup[], className?: string }) {
   const hasAnyFiles = groupedFiles.some(group => group.files.length > 0)
 
   if (!hasAnyFiles) {
@@ -204,18 +204,18 @@ function GroupedFileViewer({ groupedFiles, className }: { groupedFiles: RoundGro
           )
 
           return (
-            <div key={group.roundId || 'no-round'} className="space-y-3">
-              {/* Round header */}
+            <div key={group.stageId || 'no-stage'} className="space-y-3">
+              {/* Stage header */}
               <div className="flex items-center justify-between border-b pb-2">
                 <h3 className="font-semibold text-sm text-muted-foreground uppercase tracking-wide">
-                  {group.roundName}
+                  {group.stageName}
                 </h3>
                 <Badge variant="outline" className="text-xs">
                   {group.files.length} {group.files.length === 1 ? 'file' : 'files'}
                 </Badge>
               </div>
 
-              {/* Files in this round */}
+              {/* Files in this stage */}
               <div className="space-y-3">
                 {sortedFiles.map((file) => (
                   <FileItem key={file.id} file={file} />
@@ -739,8 +739,8 @@ function CompactFileItem({ file }: { file: ProjectFile }) {
  * Displays a checklist of file requirements and their fulfillment status.
  * Used by admins/jury to see which required files have been uploaded.
  */
-function RequirementChecklist({ roundId, files }: { roundId: string; files: ProjectFile[] }) {
-  const { data: requirements = [] } = trpc.file.listRequirements.useQuery({ roundId })
+function RequirementChecklist({ stageId, files }: { stageId: string; files: ProjectFile[] }) {
+  const { data: requirements = [] } = trpc.file.listRequirements.useQuery({ stageId })
 
   if (requirements.length === 0) return null
 

src/components/shared/requirement-upload-slot.tsx

@@ -50,7 +50,7 @@ interface RequirementUploadSlotProps {
   requirement: FileRequirement
   existingFile?: UploadedFile | null
   projectId: string
-  roundId: string
+  stageId: string
   onFileChange?: () => void
   disabled?: boolean
 }
@@ -59,7 +59,7 @@ export function RequirementUploadSlot({
   requirement,
   existingFile,
   projectId,
-  roundId,
+  stageId,
   onFileChange,
   disabled = false,
 }: RequirementUploadSlotProps) {
@@ -110,13 +110,13 @@ export function RequirementUploadSlot({
 
       try {
         // Get presigned URL
-        const { url, bucket, objectKey, isLate, roundId: uploadRoundId } =
+        const { url, bucket, objectKey, isLate, stageId: uploadStageId } =
           await getUploadUrl.mutateAsync({
             projectId,
             fileName: file.name,
             mimeType: file.type,
             fileType: 'OTHER',
-            roundId,
+            stageId,
             requirementId: requirement.id,
           })
 
@@ -150,7 +150,7 @@ export function RequirementUploadSlot({
           fileType: 'OTHER',
           bucket,
           objectKey,
-          roundId: uploadRoundId || roundId,
+          stageId: uploadStageId || stageId,
           isLate: isLate || false,
           requirementId: requirement.id,
         })
@@ -164,7 +164,7 @@ export function RequirementUploadSlot({
         setProgress(0)
       }
     },
-    [projectId, roundId, requirement, acceptsMime, getUploadUrl, saveFileMetadata, onFileChange]
+    [projectId, stageId, requirement, acceptsMime, getUploadUrl, saveFileMetadata, onFileChange]
   )
 
   const handleDelete = useCallback(async () => {
@@ -309,20 +309,22 @@ export function RequirementUploadSlot({
 
 interface RequirementUploadListProps {
   projectId: string
-  roundId: string
+  stageId: string
   disabled?: boolean
 }
 
-export function RequirementUploadList({ projectId, roundId, disabled }: RequirementUploadListProps) {
+export function RequirementUploadList({ projectId, stageId, disabled }: RequirementUploadListProps) {
   const utils = trpc.useUtils()
 
-  const { data: requirements = [] } = trpc.file.listRequirements.useQuery({ roundId })
-  const { data: files = [] } = trpc.file.listByProject.useQuery({ projectId, roundId })
+  const { data: requirements = [] } = trpc.file.listRequirements.useQuery({
+    stageId,
+  })
+  const { data: files = [] } = trpc.file.listByProject.useQuery({ projectId, stageId })
 
   if (requirements.length === 0) return null
 
   const handleFileChange = () => {
-    utils.file.listByProject.invalidate({ projectId, roundId })
+    utils.file.listByProject.invalidate({ projectId, stageId })
   }
 
   return (
@@ -351,7 +353,7 @@ export function RequirementUploadList({ projectId, roundId, disabled }: Requirem
                 : null
             }
             projectId={projectId}
-            roundId={roundId}
+            stageId={stageId}
             onFileChange={handleFileChange}
             disabled={disabled}
           />

src/components/shared/stage-breadcrumb.tsx

@@ -0,0 +1,47 @@
+'use client'
+
+import Link from 'next/link'
+import type { Route } from 'next'
+import { ChevronRight } from 'lucide-react'
+import { cn } from '@/lib/utils'
+
+interface StageBreadcrumbProps {
+  pipelineName: string
+  trackName: string
+  stageName: string
+  stageId?: string
+  pipelineId?: string
+  className?: string
+  basePath?: string // e.g. '/jury/stages' or '/admin/reports/stages'
+}
+
+export function StageBreadcrumb({
+  pipelineName,
+  trackName,
+  stageName,
+  stageId,
+  pipelineId,
+  className,
+  basePath = '/jury/stages',
+}: StageBreadcrumbProps) {
+  return (
+    <nav className={cn('flex items-center gap-1 text-sm text-muted-foreground', className)}>
+      <Link href={basePath as Route} className="hover:text-foreground transition-colors truncate max-w-[150px]">
+        {pipelineName}
+      </Link>
+      <ChevronRight className="h-3.5 w-3.5 shrink-0" />
+      <span className="truncate max-w-[120px]">{trackName}</span>
+      <ChevronRight className="h-3.5 w-3.5 shrink-0" />
+      {stageId ? (
+        <Link
+          href={`${basePath}/${stageId}/assignments` as Route}
+          className="hover:text-foreground transition-colors font-medium text-foreground truncate max-w-[150px]"
+        >
+          {stageName}
+        </Link>
+      ) : (
+        <span className="font-medium text-foreground truncate max-w-[150px]">{stageName}</span>
+      )}
+    </nav>
+  )
+}

src/components/shared/stage-timeline.tsx

@@ -0,0 +1,205 @@
+'use client'
+
+import { cn } from '@/lib/utils'
+import {
+  CheckCircle,
+  Circle,
+  Clock,
+  XCircle,
+  FileText,
+  Users,
+  Vote,
+  ArrowRightLeft,
+  Presentation,
+  Award,
+} from 'lucide-react'
+
+interface StageTimelineItem {
+  id: string
+  name: string
+  stageType: string
+  isCurrent: boolean
+  state: string // PENDING, IN_PROGRESS, PASSED, REJECTED, etc.
+  enteredAt?: Date | string | null
+}
+
+interface StageTimelineProps {
+  stages: StageTimelineItem[]
+  orientation?: 'horizontal' | 'vertical'
+  className?: string
+}
+
+const stageTypeIcons: Record<string, typeof Circle> = {
+  INTAKE: FileText,
+  EVALUATION: Users,
+  VOTING: Vote,
+  DELIBERATION: ArrowRightLeft,
+  LIVE_PRESENTATION: Presentation,
+  AWARD: Award,
+}
+
+function getStateColor(state: string, isCurrent: boolean) {
+  if (state === 'REJECTED' || state === 'ELIMINATED')
+    return 'bg-destructive text-destructive-foreground'
+  if (state === 'PASSED' || state === 'COMPLETED')
+    return 'bg-green-600 text-white dark:bg-green-700'
+  if (state === 'IN_PROGRESS' || isCurrent)
+    return 'bg-primary text-primary-foreground'
+  return 'border-2 border-muted bg-background text-muted-foreground'
+}
+
+function getConnectorColor(state: string) {
+  if (state === 'PASSED' || state === 'COMPLETED' || state === 'IN_PROGRESS')
+    return 'bg-primary'
+  if (state === 'REJECTED' || state === 'ELIMINATED')
+    return 'bg-destructive/30'
+  return 'bg-muted'
+}
+
+function formatDate(date: Date | string | null | undefined) {
+  if (!date) return null
+  const d = typeof date === 'string' ? new Date(date) : date
+  return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })
+}
+
+export function StageTimeline({
+  stages,
+  orientation = 'horizontal',
+  className,
+}: StageTimelineProps) {
+  if (stages.length === 0) return null
+
+  if (orientation === 'vertical') {
+    return (
+      <div className={cn('relative', className)}>
+        <div className="space-y-0">
+          {stages.map((stage, index) => {
+            const Icon = stageTypeIcons[stage.stageType] || Circle
+            const isPassed = stage.state === 'PASSED' || stage.state === 'COMPLETED'
+            const isRejected = stage.state === 'REJECTED' || stage.state === 'ELIMINATED'
+            const isPending = !isPassed && !isRejected && !stage.isCurrent
+
+            return (
+              <div key={stage.id} className="relative flex gap-4">
+                {index < stages.length - 1 && (
+                  <div
+                    className={cn(
+                      'absolute left-[15px] top-[32px] h-full w-0.5',
+                      getConnectorColor(stage.state)
+                    )}
+                  />
+                )}
+
+                <div className="relative z-10 flex h-8 w-8 shrink-0 items-center justify-center">
+                  <div
+                    className={cn(
+                      'flex h-8 w-8 items-center justify-center rounded-full',
+                      getStateColor(stage.state, stage.isCurrent)
+                    )}
+                  >
+                    {isRejected ? (
+                      <XCircle className="h-4 w-4" />
+                    ) : isPassed ? (
+                      <CheckCircle className="h-4 w-4" />
+                    ) : stage.isCurrent ? (
+                      <Clock className="h-4 w-4" />
+                    ) : (
+                      <Icon className="h-4 w-4" />
+                    )}
+                  </div>
+                </div>
+
+                <div className="flex-1 pb-8">
+                  <div className="flex items-center gap-2">
+                    <p
+                      className={cn(
+                        'font-medium text-sm',
+                        isRejected && 'text-destructive',
+                        isPending && 'text-muted-foreground'
+                      )}
+                    >
+                      {stage.name}
+                    </p>
+                    {stage.isCurrent && (
+                      <span className="text-xs bg-primary/10 text-primary px-2 py-0.5 rounded-full">
+                        Current
+                      </span>
+                    )}
+                  </div>
+                  <p className="text-xs text-muted-foreground capitalize">
+                    {stage.stageType.toLowerCase().replace(/_/g, ' ')}
+                  </p>
+                  {stage.enteredAt && (
+                    <p className="text-xs text-muted-foreground">
+                      {formatDate(stage.enteredAt)}
+                    </p>
+                  )}
+                </div>
+              </div>
+            )
+          })}
+        </div>
+      </div>
+    )
+  }
+
+  // Horizontal orientation
+  return (
+    <div className={cn('flex items-center gap-0 overflow-x-auto pb-2', className)}>
+      {stages.map((stage, index) => {
+        const Icon = stageTypeIcons[stage.stageType] || Circle
+        const isPassed = stage.state === 'PASSED' || stage.state === 'COMPLETED'
+        const isRejected = stage.state === 'REJECTED' || stage.state === 'ELIMINATED'
+        const isPending = !isPassed && !isRejected && !stage.isCurrent
+
+        return (
+          <div key={stage.id} className="flex items-center">
+            {index > 0 && (
+              <div
+                className={cn(
+                  'h-0.5 w-8 lg:w-12 shrink-0',
+                  getConnectorColor(stages[index - 1].state)
+                )}
+              />
+            )}
+            <div className="flex flex-col items-center gap-1 shrink-0">
+              <div
+                className={cn(
+                  'flex h-8 w-8 items-center justify-center rounded-full transition-colors',
+                  getStateColor(stage.state, stage.isCurrent)
+                )}
+              >
+                {isRejected ? (
+                  <XCircle className="h-4 w-4" />
+                ) : isPassed ? (
+                  <CheckCircle className="h-4 w-4" />
+                ) : stage.isCurrent ? (
+                  <Clock className="h-4 w-4" />
+                ) : (
+                  <Icon className="h-4 w-4" />
+                )}
+              </div>
+              <div className="text-center max-w-[80px]">
+                <p
+                  className={cn(
+                    'text-xs font-medium leading-tight',
+                    isRejected && 'text-destructive',
+                    isPending && 'text-muted-foreground',
+                    stage.isCurrent && 'text-primary'
+                  )}
+                >
+                  {stage.name}
+                </p>
+                {stage.enteredAt && (
+                  <p className="text-[10px] text-muted-foreground">
+                    {formatDate(stage.enteredAt)}
+                  </p>
+                )}
+              </div>
+            </div>
+          </div>
+        )
+      })}
+    </div>
+  )
+}

src/components/shared/stage-window-badge.tsx

@@ -0,0 +1,133 @@
+'use client'
+
+import { cn } from '@/lib/utils'
+import { Clock, CheckCircle, XCircle, Timer } from 'lucide-react'
+import { CountdownTimer } from '@/components/shared/countdown-timer'
+
+interface StageWindowBadgeProps {
+  windowOpenAt?: Date | string | null
+  windowCloseAt?: Date | string | null
+  status?: string
+  className?: string
+}
+
+function toDate(v: Date | string | null | undefined): Date | null {
+  if (!v) return null
+  return typeof v === 'string' ? new Date(v) : v
+}
+
+export function StageWindowBadge({
+  windowOpenAt,
+  windowCloseAt,
+  status,
+  className,
+}: StageWindowBadgeProps) {
+  const now = new Date()
+  const openAt = toDate(windowOpenAt)
+  const closeAt = toDate(windowCloseAt)
+
+  // Determine window state
+  const isBeforeOpen = openAt && now < openAt
+  const isOpenEnded = openAt && !closeAt && now >= openAt
+  const isOpen = openAt && closeAt && now >= openAt && now <= closeAt
+  const isClosed = closeAt && now > closeAt
+
+  if (status === 'COMPLETED' || status === 'CLOSED') {
+    return (
+      <div
+        className={cn(
+          'inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs font-medium',
+          'text-muted-foreground bg-muted',
+          className
+        )}
+      >
+        <CheckCircle className="h-3 w-3 shrink-0" />
+        <span>Completed</span>
+      </div>
+    )
+  }
+
+  if (isClosed) {
+    return (
+      <div
+        className={cn(
+          'inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs font-medium',
+          'text-muted-foreground bg-muted',
+          className
+        )}
+      >
+        <XCircle className="h-3 w-3 shrink-0" />
+        <span>Closed</span>
+      </div>
+    )
+  }
+
+  if (isOpenEnded) {
+    return (
+      <div
+        className={cn(
+          'inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs font-medium',
+          'text-green-700 bg-green-50 border-green-200 dark:text-green-400 dark:bg-green-950/50 dark:border-green-900',
+          className
+        )}
+      >
+        <Clock className="h-3 w-3 shrink-0" />
+        <span>Open</span>
+      </div>
+    )
+  }
+
+  if (isOpen && closeAt) {
+    const remainingMs = closeAt.getTime() - now.getTime()
+    const isUrgent = remainingMs < 24 * 60 * 60 * 1000 // < 24 hours
+
+    if (isUrgent) {
+      return <CountdownTimer deadline={closeAt} label="Closes in" className={className} />
+    }
+
+    return (
+      <div
+        className={cn(
+          'inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs font-medium',
+          'text-green-700 bg-green-50 border-green-200 dark:text-green-400 dark:bg-green-950/50 dark:border-green-900',
+          className
+        )}
+      >
+        <Clock className="h-3 w-3 shrink-0" />
+        <span>Open</span>
+      </div>
+    )
+  }
+
+  if (isBeforeOpen && openAt) {
+    return (
+      <div
+        className={cn(
+          'inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs font-medium',
+          'text-muted-foreground border-dashed',
+          className
+        )}
+      >
+        <Timer className="h-3 w-3 shrink-0" />
+        <span>
+          Opens{' '}
+          {openAt.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })}
+        </span>
+      </div>
+    )
+  }
+
+  // No window configured
+  return (
+    <div
+      className={cn(
+        'inline-flex items-center gap-1.5 rounded-md border px-2.5 py-1 text-xs font-medium',
+        'text-muted-foreground border-dashed',
+        className
+      )}
+    >
+      <Clock className="h-3 w-3 shrink-0" />
+      <span>No window set</span>
+    </div>
+  )
+}