Class & Flag Documents wizard

SUPERVISOR Formerly named "Source Documents Wizard" (renamed in v2.31.0.29). Lives at Vessel → Class & Flag Documents.

Two register sections

The wizard has step 1 with two cards:

• Base named A/B/D — the canonical A/B/D source-document register
• Helpful — non-blocking helpful / Run 2 inputs (Vessel CL, Loading Manual)

Click a card to choose; the rest of the wizard adapts. Cards have cursor-pointer + aria-pressed (UI fix v2.31.0.15).

Six-blocker subset

Only 6 docs in the named register are blocking for the CL Build:

1. Particulars
2. Capacity Plan
3. GA Plan
4. Form E / Form SER
5. GMDSS Radio Installation Record
6. ECDIS Certificate

Vessel CL + Loading Manual are non-blocking helpful / Run 2 inputs. They appear in the Helpful register section.

CL Build readiness pill

The wizard step shows a compact pill: CL Build readiness: N/6 blockers · gate = <reason>. When N=6, the operator can proceed to start the CL Build.

Wizard rules (strict)

• One named document slot at a time, Windows-installer style
• No bulk upload, no dropdowns, no AI-guess-the-role
• Files without a recognized A/B/D Group-1-mapped prefix are rejected from the wizard (unrecognized_prefix); use regular Components import (with AI-fuzzy) instead
• Files whose prefix doesn't match the current step's named slot are rejected from that step (slot_prefix_mismatch)
• AI may extract field values; AI may not propose component-draft classifications inside the wizard pipe
• Reprocessing is idempotent on (vessel_id, wizard_slot)

Anti-misuse hardening (v2.12.18)

Every upload runs through:

1. Workers AI (Llama-4-Scout) filename classifier
2. Magic-byte sniff (catches .jpeg→.pdf spoof and CERT→GA rename)

If the filename and content disagree, the upload is rejected.