feat(ctsclearing): signature-verification gate and full NPCI field capture for inward cheques

Adds a manual signature-verification step to the inward CTS decision flow: a new VERIFY_SIGNATURE command records the clerk's confirmation, and InwardClearingItem.pass() now refuses to pass a cheque until signatureOk is true — enforced server-side, not just a disabled UI button. Fixes a real bug where ChequeLeaf.leafSerialNo collides across different cheque books/series (by design — serials are only unique per stock lot), which could resolve an inward item to the wrong account. NpciInwardPushService now disambiguates using the drawer account number NPCI already sends alongside the cheque number. Also closes a completeness gap found by auditing the outward-CBS -> NPCI -> inward-CBS pipeline: five fields NPCI sends on every instrument (drawer account number, deposit account number, instrument type/description, drawee bank name, per-check IQA breakdown) were read and discarded instead of persisted — now saved via new columns and exposed on the read API. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-22 12:30:07 +05:30
parent b433edfdfe
commit ab5666c0f4
14 changed files with 319 additions and 24 deletions
@@ -297,6 +297,14 @@ public class CommandWrapperBuilder {
        return this;
    }

+    public CommandWrapperBuilder verifyInwardClearingItemSignature(final Long itemId) {
+        this.actionName = "VERIFY_SIGNATURE";
+        this.entityName = "INWARDCLEARINGITEM";
+        this.entityId = itemId;
+        this.href = "/ctsclearing/inward-items/" + itemId;
+        return this;
+    }
+
    public CommandWrapperBuilder createPositivePayRegistration() {
        this.actionName = "CREATE";
        this.entityName = "POSITIVEPAYREGISTRATION";