Phase 6: Q.C. inspection, project folders, packet documents and the digital ITP

The Q.C. screen (KPIs, boards, project folders), the Q.C. tab on the packet
page (check items from the qc_check_items settings row, visual exam per weld,
NDE, hardness with the NACE label, notes), accept with a route and a
signature gated by qc_missing_empty, reject with a reason or an NCR number
closing the inspection into qc_history, Q.C. folder documents per project and
unit with superseding revisions, packet documents as a closed set with
take-out reasons, the digital ITP per unit from the frozen template (line
initials with CAS, unsign, N/A, customer codes, rejects with NCR, block
signatures, sign-off with the PDF hook, admin reopen, the ITP log), hold-point
warnings by department page group, the scoped policy check for unit and
project writes, migration 0007, tests, Playwright scenarios and docs.

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

server/packetstation/domain/ncr.py

@@ -0,0 +1,34 @@
+"""NCR numbers: the form check and the link to PESCO's NCR system (pesco-ncr).
+
+An NCR number reads NCR-YYYY-NNNN (NCR-2026-0021). Q.C. gives one on a packet reject and on a rejected ITP line.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Any
+
+from ..api.errors import ApiError
+from ..text import LIMITS, clean_text
+
+RX_NCR = re.compile(r"^NCR-\d{4}-\d{4}$")
+NCR_URL = "https://ncr.pescoinc.biz/ncrs/"
+MSG_INVALID = "Enter an NCR number like NCR-2026-0021."
+NCR_MAX = LIMITS["ncr"]
+
+
+def validate_ncr(text: Any) -> str:
+    """The normalised NCR number (trimmed, upper case), or 422 invalid_ncr.
+
+    This is the hook for checking the number against pesco-ncr, which is a later phase. Today it accepts any
+    well-formed number and does not look it up.
+    """
+    value = clean_text(text, NCR_MAX).upper()
+    if not RX_NCR.match(value):
+        raise ApiError(422, "invalid_ncr", MSG_INVALID)
+    return value
+
+
+def ncr_url(number: str) -> str:
+    """The pesco-ncr page of an NCR number."""
+    return NCR_URL + number