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,41 @@
+// The Clerical home boards, from one list answer.
+import type { ColumnDef } from "../../components/Board";
+import type { PacketCard } from "../../api/types";
+import { IN_SHOP_OR_QC } from "../../lib/packets";
+
+export const byTime = (a: string | null, b: string | null) => (a ?? "").localeCompare(b ?? "");
+
+/** The boards of the Clerical home, from one list answer. */
+export function clericalBoards(all: PacketCard[]): { columns: ColumnDef[]; flagged: number; warehouse: number; shop: number; toClose: number } {
+  const drafts = all.filter((p) => p.status === "draft").sort((a, b) => byTime(a.updated_at, b.updated_at));
+  const back = all.filter((p) => p.status === "complete" && p.routed_to === "databook");
+  const flagged = drafts.filter((p) => p.flag);
+  const going = drafts.filter((p) => !p.flag);
+  const toClose = back.filter((p) => !p.vclosed).sort((a, b) => byTime(a.status_at, b.status_at));
+  const toBook = back.filter((p) => p.vclosed).sort((a, b) => byTime(a.vclosed?.at ?? null, b.vclosed?.at ?? null));
+  const filed = all
+    .filter((p) => p.status === "filed")
+    .sort((a, b) => byTime(b.status_at, a.status_at))
+    .slice(0, 25);
+  const columns: ColumnDef[] = [
+    { key: "cos", title: "Changes to approve", cards: [], empty: "Arrives in phase 3 with the VISUAL feed." },
+    { key: "flagged", title: "Flagged", cards: flagged, empty: "Nothing flagged." },
+    { key: "going", title: "Going to the warehouse", cards: going, empty: "Drafts with nothing flagged wait here." },
+    {
+      key: "close",
+      title: "Ready to close",
+      cards: toClose,
+      empty: "Finished packets come back here. Close the job in VISUAL, then mark it closed on the packet.",
+    },
+    { key: "book", title: "Ready for data book", cards: toBook, empty: "Jobs closed in VISUAL wait here for the data book." },
+    { key: "filed", title: "Filed", cards: filed, empty: "Nothing filed yet." },
+  ];
+  return {
+    columns,
+    flagged: flagged.length,
+    warehouse: all.filter((p) => p.status === "warehouse").length,
+    shop: all.filter((p) => IN_SHOP_OR_QC.includes(p.status)).length,
+    toClose: toClose.length,
+  };
+}
+