Phase 4: Warehouse screen, pull table, shorts, MTRs and the upload pipeline

The Warehouse home with the numbers, the Open shorts table, the find bar and the five-column task board
(waiting, being pulled, on hold, pulled, released in the last 3 days) with buttons, hold reasons and drag.
Every role sees the warehouse stage on a packet as the WH pill and the line under it. The pull table on the
Materials tab: Pulled with auto-start, issued, location, heat with Enter to the next line, shorts with
receipts, N/A, MTR per line with a viewer. Send back to Clerical with a reason. Release to supervisor stays
blocked until every line is pulled or short and every pulled line has a heat.

Server: the heats_recorded precondition on WH_RELEASE, receive by custody, server-validated hold and short
reasons, the old packet history texts, GET /api/warehouse/board, cards with the warehouse stage and pull
counts. Uploads typed by content per kind (drawing, mtr, document, bom with XLSX and CSV), limits per kind,
optional ClamAV behind the clamav compose profile, a storage quota alert on the new notification_events
table (migration 0005) shown on the Admin Storage tab.

Tests: every warehouse action as every role, the release gate, the short-receive exception, the heat
pattern, upload sniffing and limits, the ClamAV path with a fake scanner, the quota alert; frontend board
and pull table tests; Playwright scenarios for the board and the pull flow. Verified on docker-1 in the CI
stack: 3557 server tests, 106 frontend tests, 17 Playwright scenarios. Docs updated; D5 closed.

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

server/packetstation/policy/actions.py

@@ -162,7 +162,9 @@ RULES: dict[Action, Rule] = {
     A.SEND_DRAFT_TO_QC: Rule(Who.CL, _s("draft"), "qc", preconditions=_DRAFT_OUT),
     A.WH_SEND_BACK: Rule(Who.WH, _s("warehouse"), "draft", preconditions=_REASON, reason_required=True),
     A.RETURN_TO_CLERICAL: Rule(Who.DEPT_LEAD, _s("ready"), "draft", preconditions=_REASON, reason_required=True),
-    A.WH_RELEASE: Rule(Who.WH, _s("warehouse"), "ready", co_hold=True, preconditions=("bom_all_pulled_or_short",)),
+    A.WH_RELEASE: Rule(
+        Who.WH, _s("warehouse"), "ready", co_hold=True, preconditions=("bom_all_pulled_or_short", "heats_recorded")
+    ),
     A.SEND_BACK_TO_WAREHOUSE: Rule(
         Who.DEPT_LEAD, _s("ready"), "warehouse", preconditions=_REASON, reason_required=True
     ),

server/packetstation/policy/preconditions.py

@@ -19,6 +19,9 @@ MESSAGES: dict[str, str] = {
     "heat_map_answered": "Say whether this packet needs a heat map.",
     "drawing_attached": "Attach the drawing first.",
     "bom_all_pulled_or_short": "Pull every material line or mark it short first.",
+    "heats_recorded": (
+        "Scan or type the heat number of every pulled line first. Use N/A for a part with no traceability."
+    ),
     "short_open": "No part is short on this packet.",
     "welder_set": "Pick a station and a welder.",
     "checklist_complete": "Finish the checklist first.",
@@ -64,6 +67,11 @@ def bom_all_pulled_or_short(state: PacketState, extra: Mapping[str, Any]) -> str
     return _fail("bom_all_pulled_or_short", state.bom_ready >= state.bom_total)
 
 
+def heats_recorded(state: PacketState, extra: Mapping[str, Any]) -> str | None:
+    """Every pulled line that issued pieces has a heat, unless it is N/A or a sub-assembly."""
+    return _fail("heats_recorded", state.bom_missing_heat <= 0)
+
+
 def short_open(state: PacketState, extra: Mapping[str, Any]) -> str | None:
     """The old whCanReceive: the warehouse may only receive into a packet with an open short."""
     return _fail("short_open", state.open_shorts > 0)
@@ -131,6 +139,7 @@ PRECONDITIONS: dict[str, Precondition] = {
     "heat_map_answered": heat_map_answered,
     "drawing_attached": drawing_attached,
     "bom_all_pulled_or_short": bom_all_pulled_or_short,
+    "heats_recorded": heats_recorded,
     "short_open": short_open,
     "welder_set": welder_set,
     "checklist_complete": checklist_complete,

server/packetstation/policy/principal.py

@@ -49,6 +49,7 @@ class PacketState:
     heat_map: bool | None = None
     bom_total: int = 0  # lines not marked n/a
     bom_ready: int = 0  # lines pulled, or with an open short
+    bom_missing_heat: int = 0  # pulled lines with pieces issued and no heat (not n/a, not a sub-assembly)
     welds: int = 0
     checklist_complete: bool = False  # every key of the department checklist is done (empty list is complete)
     filler_set: bool = False