feat: cashier denomination-wise opening & closing balance panels in all deposit/withdrawal forms

OVERVIEW -------- Added real-time cashier cash position display inside the denomination breakdown panel of all 4 transaction entry screens: Savings, Current Account, Recurring Deposit, and Fixed Deposit. Shows opening balance at the top and projected closing balance at the bottom after factoring in the current transaction. BACKEND INTEGRATION ------------------- - New CashierService (src/app/cashier/cashier.service.ts) getCashierPositionForMe(asOfDate?) calls GET /cashreports/cashier-position/me Returns denomination-wise opening cash position for the logged-in cashier user. Non-cashier users receive empty denominations array; UI hides panels silently. OPENING BALANCE CARD (top of denomination panel) ------------------------------------------------- - Loaded on ngOnInit() via loadOpeningPosition() in all 4 component .ts files - Notes and Coins displayed in separate labeled pill sections - Each pill shows: Rs{value} x{count} format - Card is hidden entirely if the logged-in user is not a cashier CLOSING BALANCE CARD (below tally / Apply button) -------------------------------------------------- - Computed getter closingDenoms() merges opening position with entered denominations deposit: closingCount = openCount + enteredCount withdrawal: closingCount = openCount - enteredCount - Notes and Coins in separate labeled pill sections (identical format to opening) - Entered/changed denominations (delta != 0): full opacity + bold font weight - Untouched denominations (delta = 0): 38% opacity, clearly dimmed, no borders - closingTotal = openingTotal +/- denominationTotal shown in card header - Card turns green for positive closing balance, red for negative COMPONENTS UPDATED ------------------ - savings-account-transactions (.ts / .html / .scss) - current-account-transactions (.ts / .html / .scss) - deposit-recurring-deposits-account (.ts / .html / .scss) - fixed-deposits-cash-transaction (.ts / .html / .scss) CASHIER MODULE (new - src/app/cashier/) ----------------------------------------- Full cashier workspace module added to the app: - cashier.service.ts API calls (position, transfers, settlement, etc.) - cashier.module.ts Angular module declaration - cashier-routing.module.ts Lazy-loaded routes - cashier-position/ Cashier cash position dashboard - cash-exchange-entry/ Cash exchange denomination entry - cash-history/ Transaction history per cashier - cash-settlement/ End-of-day cash settlement - cash-transfer/ Vault-to-cashier cash transfer - inter-cashier-transfer/ Transfer between cashier drawers - reconciliation/ Cash reconciliation with GL - closing-cash-report/ Closing balance report - currency-exchange-detail/ Currency exchange breakdown - excess-transaction-report/ Excess/short transaction report Module wired into app.module.ts and shell nav (shell.component.html). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-28 17:39:31 +05:30
parent 555d9fb4b7
commit 7ccaffa7f1
43 changed files with 5302 additions and 8 deletions
@@ -0,0 +1,142 @@
+/**
+ * Copyright since 2025 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+import { Component, OnInit, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormsModule } from '@angular/forms';
+import { MatIconModule } from '@angular/material/icon';
+import { MatSnackBar, MatSnackBarModule } from '@angular/material/snack-bar';
+import { CashierService } from '../cashier.service';
+
+interface Denom {
+  id: number;
+  value: number;
+  kind: 'note' | 'coin';
+  label: string;
+}
+
+/** Cashier cash-exchange entry: customer gives some denominations and takes equal-value change (net 0). */
+@Component({
+  selector: 'mifosx-cash-exchange-entry',
+  templateUrl: './cash-exchange-entry.component.html',
+  styleUrls: ['./cash-exchange-entry.component.scss'],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    MatIconModule,
+    MatSnackBarModule
+  ]
+})
+export class CashExchangeEntryComponent implements OnInit {
+  private service = inject(CashierService);
+  private snackBar = inject(MatSnackBar);
+
+  notes: Denom[] = [];
+  coins: Denom[] = [];
+  receivedCounts: Record<number, number> = {};
+  givenCounts: Record<number, number> = {};
+  exchangeDate = '';
+  note = '';
+  saving = false;
+
+  /** All denominations (notes then coins) — used for totals and the submit payload. */
+  get denoms(): Denom[] {
+    return [
+      ...this.notes,
+      ...this.coins
+    ];
+  }
+
+  ngOnInit(): void {
+    const d = new Date();
+    this.exchangeDate = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+    this.service.getActiveDenominations().subscribe({
+      next: (list) => {
+        const rows: Denom[] = (list || []).map((x) => ({
+          id: x.id,
+          value: x.denomination,
+          kind: x.kind,
+          label: '₹' + x.denomination
+        }));
+        this.notes = rows.filter((r) => r.kind === 'note').sort((a, b) => b.value - a.value);
+        this.coins = rows.filter((r) => r.kind === 'coin').sort((a, b) => b.value - a.value);
+      },
+      error: () => {
+        this.notes = [];
+        this.coins = [];
+      }
+    });
+  }
+
+  countFor(side: 'r' | 'g', d: Denom): number {
+    return (side === 'r' ? this.receivedCounts : this.givenCounts)[d.id] || 0;
+  }
+
+  subtotal(side: 'r' | 'g', d: Denom): number {
+    return this.countFor(side, d) * d.value;
+  }
+
+  onChange(side: 'r' | 'g', d: Denom, raw: any): void {
+    (side === 'r' ? this.receivedCounts : this.givenCounts)[d.id] = Math.max(0, Math.floor(Number(raw) || 0));
+  }
+
+  bump(side: 'r' | 'g', d: Denom, delta: number): void {
+    const map = side === 'r' ? this.receivedCounts : this.givenCounts;
+    map[d.id] = Math.max(0, (map[d.id] || 0) + delta);
+  }
+
+  get receivedTotal(): number {
+    return this.denoms.reduce((s, d) => s + this.subtotal('r', d), 0);
+  }
+
+  get givenTotal(): number {
+    return this.denoms.reduce((s, d) => s + this.subtotal('g', d), 0);
+  }
+
+  get difference(): number {
+    return this.receivedTotal - this.givenTotal;
+  }
+
+  get matches(): boolean {
+    return this.receivedTotal > 0 && this.receivedTotal === this.givenTotal;
+  }
+
+  clear(): void {
+    this.receivedCounts = {};
+    this.givenCounts = {};
+  }
+
+  submit(): void {
+    if (!this.matches || this.saving) {
+      return;
+    }
+    this.saving = true;
+    const build = (side: 'r' | 'g') =>
+      this.denoms
+        .filter((d) => this.countFor(side, d) > 0)
+        .map((d) => ({ denominationId: d.id, denominationValue: d.value, count: this.countFor(side, d) }));
+    const payload = {
+      exchangeDate: this.exchangeDate,
+      note: this.note || null,
+      received: build('r'),
+      given: build('g')
+    };
+    this.service.createCashExchange(payload).subscribe({
+      next: () => {
+        this.snackBar.open('Cash exchange recorded', 'Close', { duration: 3000 });
+        this.clear();
+        this.note = '';
+        this.saving = false;
+      },
+      error: () => {
+        this.saving = false;
+      }
+    });
+  }
+}