patrick/Polaris
Watch
1
0
Fork
You've already forked Polaris
 0
Code Issues 35 Pull requests 2 Projects Releases Packages Wiki Activity Actions 3

PH1.7 — API surface: every DTO and endpoint from docs/09-api.md stubbed, openapi.json committed #15

New issue
Open
opened 2026-09-11 09:02:10 +00:00 by bart · 0 comments
bart commented 2026-09-11 09:02:10 +00:00
Collaborator
Copy link

Parent

Row PH1.7 in docs/12-implementation-plan.md (branch, owned paths and doc section are defined there).

What to build

Every endpoint in docs/09-api.md exists with its final signature, DTOs and role requirements, returning 501 until its track fills it in. backend/openapi.json is committed and is the frontend's frozen contract; from here every frontend track generates its client once.

Acceptance criteria

  • Every path/method in docs/09-api.md appears in openapi.json with typed request/response DTOs
  • Each stub enforces its role requirement (403 before 501)
  • npm run api:gen against the committed spec compiles in the frontend
  • CI freshness check passes for the committed openapi.json
  • Contracts are marked sealed in docs/12 after merge

Blocked by

  • #10 — Schema 0003: planning tables and typed mapped classes
  • #11 — API platform: pagination, idempotency, ETag, soft-delete repository, crud_router factory
  • #12 — Engine contracts: PlanningSnapshot, PlanResult, Finding, projector/scorer I/O, task payloads, code lists, fixtures
## Parent Row **PH1.7** in `docs/12-implementation-plan.md` (branch, owned paths and doc section are defined there). ## What to build Every endpoint in docs/09-api.md exists with its final signature, DTOs and role requirements, returning `501` until its track fills it in. `backend/openapi.json` is committed and is the frontend's frozen contract; from here every frontend track generates its client once. ## Acceptance criteria - [ ] Every path/method in docs/09-api.md appears in `openapi.json` with typed request/response DTOs - [ ] Each stub enforces its role requirement (403 before 501) - [ ] `npm run api:gen` against the committed spec compiles in the frontend - [ ] CI freshness check passes for the committed `openapi.json` - [ ] Contracts are marked sealed in docs/12 after merge ## Blocked by - #10 — Schema 0003: planning tables and typed mapped classes - #11 — API platform: pagination, idempotency, ETag, soft-delete repository, crud_router factory - #12 — Engine contracts: PlanningSnapshot, PlanResult, Finding, projector/scorer I/O, task payloads, code lists, fixtures
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feature/worker-retention
feature/openapi-code-catalogue
chore/fix-worker-compose-command
feature/cli-worker-command
feature/infra-observability
feature/ci-pipeline
feature/engine-contracts
feature/worker-skeleton
feature/docs-remove-tooling
feature/docs-rename-polaris
No results found.
Labels
Clear labels   
ready-for-agent
Self-contained ticket an agent can pick up

No labels
ready-for-agent
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#16 T-A — Master data & catalogue: domain services, routers and pages P05–P08, P11
patrick/Polaris
#17 T-B — Ingest & projector: FleetPulse ingest, pure presence projector, P12, heatmap on P06
patrick/Polaris
#20 T-E — Plan orchestration: snapshot builder, result writer, solver_run/plan_version lifecycle, publish/supersede
patrick/Polaris
#21 T-F — Schedule viewer: Gantt and map components, read-only plan board P02, /dev/fixtures route
patrick/Polaris
#22 T-G — Scorer & dashboard v1: reliability scorer, score handler, adjusted-confidence hook, dashboard P01
patrick/Polaris
#30 PH4.2 — Today page P09, mobile-first
patrick/Polaris
#44 PH6.3 — Audit page P13 and settings page P14
patrick/Polaris
Depends on
#10 PH1.2 — Schema 0003: planning tables and typed mapped classes
patrick/Polaris
#11 PH1.3 — API platform: pagination, idempotency, ETag, soft-delete repository, crud_router factory
patrick/Polaris
#12 PH1.4 — Engine contracts: PlanningSnapshot, PlanResult, Finding, projector/scorer I/O, task payloads, code lists, fixtures
patrick/Polaris
Reference
patrick/Polaris#15
No description provided.