MOPC/MOPC-Portal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
331b67dae0080b11bfd96e9730771f5898cc7ddf
MOPC-Portal/docs/round-redesign-architecture-docs/mixed-round-design-implementation-docs/shared/api-contracts.md
Matt 331b67dae0 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>
2026-02-13 13:57:09 +01:00

1.7 KiB
Raw Blame History

API Contracts

Contract Conventions

  • All mutations return typed errorCode and machine-readable details on failure.
  • All state-changing operations emit deterministic audit events.
  • All response shapes include stable identifiers for client cache invalidation.

Router Families

pipeline

  • pipeline.create
  • pipeline.update
  • pipeline.simulate
  • pipeline.publish
  • pipeline.getSummary

stage

  • stage.create
  • stage.updateConfig
  • stage.list
  • stage.transition
  • stage.openWindow
  • stage.closeWindow

routing

  • routing.preview
  • routing.execute
  • routing.listRules
  • routing.upsertRule
  • routing.toggleRule

filtering

  • filtering.previewBatch
  • filtering.runStageFiltering
  • filtering.getManualQueue
  • filtering.resolveManualDecision

assignment

  • assignment.previewStageProjects
  • assignment.assignStageProjects
  • assignment.getCoverageReport
  • assignment.rebalance

cohort

  • cohort.create
  • cohort.assignProjects
  • cohort.openVoting
  • cohort.closeVoting

live

  • live.start
  • live.setActiveProject
  • live.jump
  • live.reorder
  • live.pause
  • live.resume

decision

  • decision.override
  • decision.auditTimeline

award

  • award.createTrack
  • award.configureGovernance
  • award.routeProjects
  • award.finalizeWinners

Error Contract

  • BAD_REQUEST
  • UNAUTHORIZED
  • FORBIDDEN
  • NOT_FOUND
  • CONFLICT
  • PRECONDITION_FAILED
  • INTERNAL_SERVER_ERROR

Event Contract (Representative)

  • stage.transitioned
  • routing.executed
  • filtering.completed
  • assignment.generated
  • live.cursor.updated
  • cohort.window.changed
  • decision.overridden
  • award.winner.finalized
Reference in New Issue View Git Blame Copy Permalink