feat(shares): route dividend cash claims through cashier token disbursement

Cash claims now require a token at claim submission; a cashier redeems
it at Transaction Entry to record physical hand-over, mirroring the
existing clerk-withdrawal-request flow -- no double-disbursement, and
the manager never hands over cash directly at approval time.

Also: dividend-claim tokens fall back through the same TOK. NO. lookup
used for withdrawal requests, silenced against the global error
interceptor since the caller already handles every outcome; the account
summary card now shows "Dividend Claim" instead of a misleading "A/c
Savings" label when resolving one; and cash amounts are floored to
whole rupees client-side to match cash's whole-rupee denominations.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

src/app/clerk/dividend-dashboard/dividend-dashboard.component.ts

@@ -68,6 +68,7 @@ export class DividendDashboardComponent implements OnInit {
   claimSavingsAmount: Record<number, number | null> = {};
   claimSavingsAccountOverride: Record<number, number | null> = {};
   claimCashAmount: Record<number, number | null> = {};
+  claimTokNo: Record<number, string> = {};
   claimSubmitting = false;
   claimError: string | null = null;
 
@@ -99,6 +100,7 @@ export class DividendDashboardComponent implements OnInit {
     this.claimSavingsAmount[lock.lockId] = Number(lock.amount);
     this.claimSavingsAccountOverride[lock.lockId] = null;
     this.claimCashAmount[lock.lockId] = null;
+    this.claimTokNo[lock.lockId] = '';
     this.claimRequestService
       .getOverdueLoans(lock.clientId)
       .pipe(catchError(() => of([])))
@@ -117,14 +119,17 @@ export class DividendDashboardComponent implements OnInit {
     return (
       Number(this.claimLoanAmount[lock.lockId] || 0) +
       Number(this.claimSavingsAmount[lock.lockId] || 0) +
-      Number(this.claimCashAmount[lock.lockId] || 0)
+      Math.floor(Number(this.claimCashAmount[lock.lockId] || 0))
     );
   }
 
   submitClaim(lock: any): void {
     const loanAmount = Number(this.claimLoanAmount[lock.lockId] || 0);
     const savingsAmount = Number(this.claimSavingsAmount[lock.lockId] || 0);
-    const cashAmount = Number(this.claimCashAmount[lock.lockId] || 0);
+    // Cash can only be handed over in whole-rupee notes/coins (no denomination below ₹1), while a
+    // dividend share often works out to paise — floor to the nearest rupee so the denomination
+    // total the cashier counts can always match exactly; any leftover paise stays unclaimed.
+    const cashAmount = Math.floor(Number(this.claimCashAmount[lock.lockId] || 0));
     const total = loanAmount + savingsAmount + cashAmount;
     if (total <= 0) {
       this.claimError = 'Enter at least one amount (loan, savings, or cash), greater than zero.';
@@ -142,6 +147,11 @@ export class DividendDashboardComponent implements OnInit {
       this.claimError = 'This share account has no linked savings account — enter a Savings Account ID to credit.';
       return;
     }
+    const tokNo = this.claimTokNo[lock.lockId]?.trim();
+    if (cashAmount > 0 && !tokNo) {
+      this.claimError = 'Enter a Token No. for the cash portion — the cashier will use it to hand over the cash.';
+      return;
+    }
     this.claimSubmitting = true;
     this.claimError = null;
     this.claimRequestService
@@ -151,7 +161,8 @@ export class DividendDashboardComponent implements OnInit {
         savingsAccountId:
           savingsAmount > 0 && !lock.savingsAccountId ? this.claimSavingsAccountOverride[lock.lockId] : undefined,
         savingsApplyAmount: savingsAmount > 0 ? savingsAmount : undefined,
-        cashApplyAmount: cashAmount > 0 ? cashAmount : undefined
+        cashApplyAmount: cashAmount > 0 ? cashAmount : undefined,
+        tokNo: cashAmount > 0 ? tokNo : undefined
       })
       .subscribe({
         next: () => {