Phase 7: close, file, PDFs and prints

Clerical close and file: the VISUAL observed state beside the close confirm, a 409 with a second confirm when the
feed still shows work orders open, filing with a signature and the HMAC seal, the data book built on the server
and stored on the seal in the filing transaction, admin reopen keeping the broken seal with its data book.

Server PDFs with reportlab, pypdf and pypdfium2: the manufacturing data book page for page after the old build
(cover, index, drawings with VOID stamps, traceability and heat map rasters, weld maps and welding records, Q.C.
inspections, Q.C. and test documents, MTRs, record history), the job traveler with work order QR codes, the ITP
PDF filed automatically at sign-off, every print kind with the PRINTED COPY stamp, the controlled-copy stamp
signed with the seal key, PDF metadata, the traceability CSV with the formula guard, and the append-only
print_log with an audit row for every print and export (migration 0008).

Frontend: the close and file panel, the print menu and its entry points, the printed copies list on the History
tab, the ITP PDF buttons. Tests: server (close, file, reopen, seal, the builders, prints, CSV, stamps), frontend,
and the Playwright close and print scenarios. Docs updated; SECURITY closes M2, S6, S7 and S8.

Co-Authored-By: Claude Fable 5.1 <[email protected]>

frontend/src/packet/PacketPage.tsx

@@ -1,4 +1,4 @@
-import { useCallback, useEffect, useRef, useState, type FormEvent, type ReactNode } from "react";
+import { useCallback, useEffect, useRef, useState, type FormEvent } from "react";
 import { Link, useNavigate, useParams, useSearchParams } from "react-router";
 import { assetsApi } from "../api/assets";
 import { ApiError, errorCode } from "../api/client";
@@ -11,7 +11,11 @@ import { useGuard } from "../components/useGuard";
 import { useChanged } from "../lib/changes";
 import { errorText } from "../lib/format";
 import { dueInfo, flagClass, jobName, pillClass, statusLabel, targetHours } from "../lib/packets";
+import { Act } from "./Act";
+import { CloseFile } from "./CloseFile";
 import { DrawingViewer } from "./DrawingViewer";
+import { openPrint } from "./closeUtil";
+import { PrintMenu } from "./PrintMenu";
 import { MoveSheet, SendToDeptSheet } from "./sheets";
 import { DocumentsTab, HistoryTab, MaterialsTab, WorkOrdersTab, type Mutate } from "./tabs";
 import { coSummary, coToReview } from "../lib/changeOrders";
@@ -40,37 +44,6 @@ const TOAST_MS = 5000;
 
 /** The rule's signature meaning for attaching a drawing by hand. */
 const SIGN_ATTACH = "Attach a drawing by hand";
-const SIGN_FILE = "File in the data book";
-
-/** One step button. Hidden when the user can neither do it nor is blocked from it. Blocked shows the reason under it. */
-function Act({
-  p,
-  action,
-  busy,
-  onClick,
-  className = "btn",
-  children,
-}: {
-  p: PacketRead;
-  action: string;
-  busy: boolean;
-  onClick: () => void;
-  className?: string;
-  children: ReactNode;
-}) {
-  const can = p.can.includes(action);
-  const why = p.blocked[action];
-  if (!can && !why) return null;
-  const reason = why?.join(" ") ?? "";
-  return (
-    <div className="act">
-      <button className={className} type="button" disabled={!can || busy} title={!can ? reason : undefined} onClick={onClick}>
-        {children}
-      </button>
-      {!can && reason ? <div className="why small">{reason}</div> : null}
-    </div>
-  );
-}
 
 /** Title, customer, WPS, drawing and rev, edited in place with a field-level base. */
 function HeaderEdit({ p, mutate, busy, onDone }: { p: PacketRead; mutate: Mutate; busy: boolean; onDone: () => void }) {
@@ -139,7 +112,7 @@ export function PacketPage() {
   const [search] = useSearchParams();
   const wantTab = search.get("tab");
   const [tab, setTab] = useState<Tab | null>(isTab(wantTab) ? wantTab : null);
-  const [sheet, setSheet] = useState<"dept" | "move" | null>(null);
+  const [sheet, setSheet] = useState<"dept" | "move" | "print" | null>(null);
   const [editing, setEditing] = useState(false);
   const [toast, setToast] = useState<string | null>(null);
   const others = usePacketPresence(Number.isFinite(id) ? id : null);
@@ -318,8 +291,6 @@ export function PacketPage() {
     await mutate((g) => packetsApi.removePages(p.id, n, g), { ok: "Drawing removed." });
   };
 
-  const fileIt = () => mutate((g) => packetsApi.transition(p.id, { action: "file", expect: { status: p.status, dept: p.dept.code }, ...g }), { sign: SIGN_FILE, ok: "Filed in the data book." });
-
   const drawingPages = p.pages.filter((x) => x.type === "drawing");
   const review = coToReview(p);
   const hasQc = !!p.qc || p.qc_history.length > 0;
@@ -461,6 +432,11 @@ export function PacketPage() {
               Move
             </button>
           ) : null}
+          {!p.removed ? (
+            <button className="btn sm" type="button" onClick={() => setSheet("print")}>
+              Print…
+            </button>
+          ) : null}
         </div>
       </div>
 
@@ -630,35 +606,7 @@ export function PacketPage() {
         </section>
       ) : null}
 
-      {!draft && (can("set_vclosed") || can("file") || p.blocked.file) ? (
-        <section className="panel actbox" aria-label="Close and file">
-          <div>
-            {p.vclosed ? (
-              <>
-                <b>Ready for the data book.</b> Job closed in VISUAL by {p.vclosed.by?.display_name ?? "Clerical"}. Mark it filed when the data book is done.
-              </>
-            ) : (
-              <>
-                <b>Back from the shop, ready to close.</b> Close the job in VISUAL, then click below. The packet moves on to the data book.
-              </>
-            )}
-          </div>
-          <div className="acts">
-            {!p.vclosed ? (
-              <Act p={p} action="set_vclosed" busy={busy} className="btn pri" onClick={() => void mutate((g) => packetsApi.setVclosed(p.id, true, g), { ok: "Marked closed in VISUAL." })}>
-                Job closed in VISUAL
-              </Act>
-            ) : (
-              <Act p={p} action="set_vclosed" busy={busy} className="btn ghost" onClick={() => void mutate((g) => packetsApi.setVclosed(p.id, false, g))}>
-                Not closed in VISUAL, move back
-              </Act>
-            )}
-            <Act p={p} action="file" busy={busy} onClick={() => void fileIt()}>
-              Mark filed
-            </Act>
-          </div>
-        </section>
-      ) : null}
+      <CloseFile p={p} busy={busy} mutate={mutate} askReason={askReason} sub={job} onPrint={() => setSheet("print")} />
 
       <ShopBar p={p} busy={busy} mutate={mutate} askReason={askReason} sub={job} goTab={(t) => setTab(t)} />
       <QcBar p={p} busy={busy} mutate={mutate} sub={job} goQc={() => setTab("qc")} />
@@ -694,7 +642,7 @@ export function PacketPage() {
                 </button>
               </div>
             ) : null}
-            <DrawingViewer pages={drawingPages} />
+            <DrawingViewer pages={drawingPages} {...(p.removed ? {} : { onPrintSheet: (n: number) => openPrint(p.id, "clean", { sheet: n }) })} />
           </div>
         ) : null}
         {shownTab === "heat" ? <HeatMapTab key={p.id} p={p} write={write} reload={reload} sub={job} onError={onTabError} /> : null}
@@ -732,6 +680,7 @@ export function PacketPage() {
           }}
         />
       ) : null}
+      {sheet === "print" ? <PrintMenu p={p} sub={job} onClose={() => setSheet(null)} /> : null}
       {wh.sheet}
       {guardSheet}
       {toast ? (