Judging Portal Data Model (In Progress)

This page lists the Firestore structure used by the judging portal.

Event Root

• events/{EVENT_ID}

The app reads event settings from this document.

Subcollections

events/{EVENT_ID}/judges

• Purpose: judge and admin identity + assignment data
• Common fields:
  • name
  • code
  • isAdmin
  • assignedTeamIds
  • capacity

events/{EVENT_ID}/teams

• Purpose: team profile + submission content
• Common fields:
  • name
  • members
  • techStack
  • github
  • devpost
  • description
  • imageUrls
  • teamCode

events/{EVENT_ID}/reviews

• Purpose: scoring and written feedback
• Common fields:
  • teamId
  • judgeId
  • judgeName
  • scores
  • feedback
  • total
  • weightedTotal
  • round (prelim or finals)
  • createdAt

events/{EVENT_ID}/rubric/default

• Purpose: scoring rubric config
• Common fields:
  • name
  • scaleMax
  • criteria[]

events/{EVENT_ID}/links

• Purpose: extra team links managed by admins
• Common fields:
  • teamId
  • title
  • url
  • createdAt
  • createdBy

Event Settings Fields

Common fields used throughout the app:

• phase
• requiredJudgeCount
• maxImages
• lockSubmissions
• showResults
• showResultsFinals
• showTeamFeedback
• allowJudgeSeeOthers
• anonymizeTeams
• finalsTopN
• finalsTeamIds
• finalsJudgeIds