Phase 2: core domain, policy engine, packet API, Clerical screen

Migration 0003: projects, aliases, renumbers, units, packets and every child table, change orders, assets, documents, ITPs, station limits, department weld flag. Policy package: Principal, PacketState, Action rules, custody, preconditions, CO hold, order of checks, can/blocked/holder on reads. docs/POLICY.md with the tightenings table for Seth. Write pipeline: FOR UPDATE, CAS on status and dept, If-Match row versions, server-assigned numbers, field CAS, version bump, packet log, audit, NOTIFY, signatures, IT reasons, filed lock and HMAC seal. API: /api/packets (header, transitions, work orders, pages, docs, move, remove, BOM, shorts, welds, heat tags, heat table, stage, checklist, clock, warehouse stage, Q.C., change orders, log, seal), /api/projects, /api/units, /api/assets, /_blob. Frontend: Clerical home, projects and units, packet page with pdf.js and QR codes, hand draft, heat map, send to warehouse, department or Q.C. Tests: policy matrix, API, concurrency, schema, projects; Playwright Clerical draft scenario. Verified on docker-1 with the CI stack and the Samba DC. Co-Authored-By: Claude Fable 5.1 <[email protected]>
2026-10-16 09:31:45 -06:00
parent 97b0973130
commit 37d9a0cb50
83 changed files with 16490 additions and 55 deletions
@@ -0,0 +1,46 @@
+// Packet endpoints from the phase 2 contract.
+import { api, request } from "./client";
+import { asList, ifMatch, qs } from "./query";
+import type {
+  AttachPagesBody,
+  BomLine,
+  FieldCas,
+  Guarded,
+  LogRow,
+  PacketCard,
+  PacketCreate,
+  PacketHeader,
+  PacketListQuery,
+  PacketRead,
+  TransitionBody,
+  WorkOrder,
+} from "./types";
+
+const base = (id: number) => `/api/packets/${encodeURIComponent(String(id))}`;
+
+export const packetsApi = {
+  list: async (q: PacketListQuery = {}, signal?: AbortSignal): Promise<PacketCard[]> =>
+    asList<PacketCard>(await api.get<unknown>(`/api/packets${qs({ limit: 500, ...q })}`, signal), "packets"),
+  get: (id: number, signal?: AbortSignal) => api.get<PacketRead>(base(id), signal),
+  log: async (id: number, opts: { limit?: number; before?: number } = {}, signal?: AbortSignal): Promise<LogRow[]> =>
+    asList<LogRow>(await api.get<unknown>(`${base(id)}/log${qs({ limit: opts.limit ?? 300, before: opts.before })}`, signal), "log"),
+  create: (body: PacketCreate) => api.post<PacketRead>("/api/packets", body),
+  patch: (id: number, body: FieldCas<PacketHeader>) => api.patch<PacketRead>(base(id), body),
+  transition: (id: number, body: TransitionBody) => api.post<PacketRead>(`${base(id)}/transitions`, body),
+  putWorkOrders: (id: number, version: number, work_orders: WorkOrder[], extra: Guarded = {}) =>
+    request<PacketRead>(`${base(id)}/work-orders`, { method: "PUT", body: { work_orders, ...extra }, headers: ifMatch(version) }),
+  putBom: (id: number, version: number, bom: BomLine[], extra: Guarded = {}) =>
+    request<PacketRead>(`${base(id)}/bom`, { method: "PUT", body: { bom, ...extra }, headers: ifMatch(version) }),
+  attachPages: (id: number, body: AttachPagesBody) => api.post<PacketRead>(`${base(id)}/pages`, body),
+  removePages: (id: number, n: number, body: { reason?: string } & Guarded = {}) =>
+    api.delWithBody<PacketRead>(`${base(id)}/pages/${n}`, body),
+  addDoc: (id: number, body: { asset_id: string; kind: string; title: string } & Guarded) =>
+    api.post<PacketRead>(`${base(id)}/docs`, body),
+  removeDoc: (id: number, docId: number, extra: Guarded = {}) =>
+    api.delWithBody<PacketRead>(`${base(id)}/docs/${docId}`, extra),
+  move: (id: number, body: { unit_id: number; reason?: string } & Guarded) => api.post<PacketRead>(`${base(id)}/move`, body),
+  remove: (id: number, body: { reason: string } & Guarded) => api.delWithBody<PacketRead | null>(base(id), body),
+  setVclosed: (id: number, closed: boolean, extra: Guarded = {}) =>
+    api.post<PacketRead>(`${base(id)}/vclosed`, { closed, ...extra }),
+  databook: (id: number) => api.post<PacketRead>(`${base(id)}/databook`, {}),
+};