Matt
331b67dae0
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>
98 lines
1.7 KiB
Markdown
98 lines
1.7 KiB
Markdown
# 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`
|