letsbe
/
MOPC-App
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
MOPC-App/docs/round-redesign-architecture.../mixed-round-design-implemen.../shared/domain-model.md

3.3 KiB
Raw Blame History

Domain Model and Contracts

Canonical Enums

  • StageType = INTAKE | FILTER | EVALUATION | SELECTION | LIVE_FINAL | RESULTS
  • TrackKind = MAIN | AWARD | SHOWCASE
  • RoutingMode = PARALLEL | EXCLUSIVE | POST_MAIN
  • StageStatus = DRAFT | ACTIVE | CLOSED | ARCHIVED
  • ProjectStageStateValue = PENDING | IN_PROGRESS | PASSED | REJECTED | ROUTED | COMPLETED | WITHDRAWN
  • DecisionMode = JURY_VOTE | AWARD_MASTER | ADMIN
  • OverrideReasonCode = DATA_CORRECTION | POLICY_EXCEPTION | JURY_CONFLICT | SPONSOR_DECISION | ADMIN_DISCRETION

Core Entities

Pipeline

  • id
  • programId
  • name
  • slug
  • status
  • settingsJson
  • createdAt, updatedAt

Track

  • id
  • pipelineId
  • kind
  • specialAwardId?
  • name
  • slug
  • sortOrder
  • routingModeDefault?
  • decisionMode?

Stage

  • id
  • trackId
  • stageType
  • name
  • slug
  • sortOrder
  • status
  • configVersion
  • configJson
  • windowOpenAt?, windowCloseAt?

StageTransition

  • id
  • fromStageId
  • toStageId
  • priority
  • isDefault
  • guardJson
  • actionJson

ProjectStageState

  • id
  • projectId
  • trackId
  • stageId
  • state
  • enteredAt, exitedAt
  • decisionRef?
  • outcomeJson

RoutingRule

  • id
  • pipelineId
  • scope (GLOBAL|TRACK|STAGE)
  • predicateJson
  • destinationTrackId
  • destinationStageId?
  • priority
  • isActive

Cohort and Live Runtime

  • Cohort(id, stageId, name, votingMode, isOpen, windowOpenAt?, windowCloseAt?)
  • CohortProject(cohortId, projectId, sortOrder)
  • LiveProgressCursor(id, stageId, sessionId, activeProjectId?, activeOrderIndex?, updatedBy, updatedAt)

Governance Entities

  • OverrideAction(id, entityType, entityId, oldValueJson, newValueJson, reasonCode, reasonText, actedBy, actedAt)
  • DecisionAuditLog(id, entityType, entityId, eventType, payloadJson, actorId?, createdAt)

Stage Config Union Contracts

IntakeConfig

  • file requirements
  • accepted MIME and size constraints
  • deadline and late policy
  • team invite policy

FilterConfig

  • deterministic gates
  • AI rubric
  • confidence thresholds
  • manual queue policy
  • rejection notification policy

EvaluationConfig

  • criteria schema
  • assignment strategy
  • review thresholds
  • COI policy
  • visibility rules

SelectionConfig

  • ranking source
  • finalist target
  • override permissions
  • promotion mode (auto_top_n, hybrid, manual)

LiveFinalConfig

  • session behavior
  • jury voting config
  • audience voting config
  • cohort policy
  • reveal policy
  • schedule hints (advisory)

ResultsConfig

  • ranking weight rules
  • publication policy
  • winner override rules

Constraint Rules

  1. Stage ordering unique per track (trackId + sortOrder).
  2. ProjectStageState unique on (projectId, trackId, stageId).
  3. StageTransition unique on (fromStageId, toStageId).
  4. Transition destination must remain in same pipeline unless explicit routing rule applies.
  5. Override records immutable after insert.
  6. Decision audit log append-only.

Index Priorities

  1. ProjectStageState(projectId, trackId, state)
  2. ProjectStageState(stageId, state)
  3. RoutingRule(pipelineId, isActive, priority)
  4. StageTransition(fromStageId, priority)
  5. LiveProgressCursor(stageId, sessionId)
  6. DecisionAuditLog(entityType, entityId, createdAt)