2026-05-22-pms-progress-snapshot

activetype/changelogdomain/anabatic

PMS progress snapshot — 2026-05-22

TL;DR

After management’s 2026-05-21 emergency priority call, backend-pms-dev has a full PMS entity model, RunnerHelper CMS projects CRUD (nested create/update/detail + paginated list), and agent guidelines — but OpenAPI contract gaps, master routes, chat/notifications, and end-to-end DB verification remain before MVP.

Change

Documented current delivery state from workspace agent sessions and local git working tree (not yet committed).

Reason

Management directed high priority on PMS; team needs a single dated snapshot for planning and standups.

Impact

In scope now: backend-pms-dev projects module, src/entity/pms/*, script/initial_table.sql, RunnerHelper parity fixes, Karpathy agent rules.
Still out of scope / pending: Claim chat + notification port, masters APIs, OpenAPI phase-2 shapes, frontend, production deploy.

Progress detail (as of 2026-05-22)

Product / design (Project Manager repo)

Artifact	Status
`ERD.md`	Present — Create Project aggregate (masters, `t_project`, nested sale/COGS, docs, PICs, PIDs)
`docs/openapi/openapi.yaml` v0.1.0	Present — projects + masters contract defined

Backend scaffold (`backend-pms-dev`)

Area	Status	Notes
TypeORM entities	Done (local)	14 PMS entities under `src/entity/pms/` with CMS cascades on `Project` children
DB script	Done (local)	`script/initial_table.sql` (~198 lines); does not create `portal_schema.m_entity` / `m_employee` — see [[Projects/anabatic-project-manager/context/schema-ownership
RunnerHelper	Improved	`offsetClause` uses `model.offset()` (Claim parity); audit [[Projects/anabatic-project-manager/reports/runner-helper-audit-core-vs-claim
Agent guidelines	Done (local)	Karpathy `CLAUDE.md`, `AGENTS.md`, `.cursor/rules/karpathy-guidelines.mdc`
Projects module	Done (local, uncommitted)	`GET/POST/PATCH` + nested `saveHelper` / `newSaveHelper` / detail subqueries
List pagination	Done	`page`, `pageSize` (default 20; spec default 25 — minor gap)
OpenAPI alignment	Partial	Routes and nested PATCH semantics match; gaps: category objects, PIC `email`, document slots, multipart, masters routes
Chat / notifications	Not started	Claim modules identified for port — see backlog
Integration test vs DB	Not verified in chat	Nested create/update/detail needs real FK seed data

Workspace sessions (agent transcripts)

Session	Outcome
Projects CRUD + RunnerHelper CMS	Built `projects` module; validated nested cascade design; OpenAPI diff + pagination Q&A
Karpathy guidelines	Added behavioral rules to `backend-pms-dev`
Earlier	RunnerHelper audit vs Claim (2026-05-20 report)