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,119 @@
+/**
+ * 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 { MatFormFieldModule } from '@angular/material/form-field';
+import { MatSelectModule } from '@angular/material/select';
+import { MatInputModule } from '@angular/material/input';
+import { of } from 'rxjs';
+import { catchError } from 'rxjs/operators';
+import { CashierService } from '../cashier.service';
+
+interface DenomRow {
+  denominationId: number;
+  denominationValue: number;
+  kind: string;
+  count: number;
+  amount: number;
+}
+interface CashierPos {
+  cashierId: number;
+  cashierName?: string;
+  asOfDate: string;
+  totalAmount: number;
+  denominations: DenomRow[];
+}
+
+/** Denomination-wise net cash position per cashier as of a given date. */
+@Component({
+  selector: 'mifosx-cashier-position',
+  templateUrl: './cashier-position.component.html',
+  styleUrls: [
+    '../cashier-shared.scss',
+    './cashier-position.component.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    MatIconModule,
+    MatFormFieldModule,
+    MatSelectModule,
+    MatInputModule
+  ]
+})
+export class CashierPositionComponent implements OnInit {
+  private service = inject(CashierService);
+
+  tellers: { id: number; name: string }[] = [];
+  cashiers: { id: number; label: string }[] = [];
+  selectedTellerId: number | null = null;
+  selectedCashierId: number | null = null;
+  asOfDate = '';
+  loading = false;
+
+  results: CashierPos[] = [];
+  errorMsg = '';
+
+  ngOnInit(): void {
+    const d = new Date();
+    this.asOfDate = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+    this.service
+      .getTellers()
+      .pipe(catchError(() => of([] as any[])))
+      .subscribe((list) => {
+        this.tellers = (list || []).map((t: any) => ({ id: t.id, name: t.name }));
+      });
+  }
+
+  onTellerSelect(tellerId: number): void {
+    this.selectedTellerId = tellerId;
+    this.selectedCashierId = null;
+    this.cashiers = [];
+    if (!tellerId) return;
+    this.service
+      .getCashiersForTeller(tellerId)
+      .pipe(catchError(() => of({ cashiers: [] })))
+      .subscribe((r: any) => {
+        this.cashiers = (r?.cashiers || []).map((c: any) => ({ id: c.id, label: c.staffName }));
+      });
+  }
+
+  load(): void {
+    this.loading = true;
+    this.results = [];
+    this.errorMsg = '';
+    this.service
+      .cashierPositionReport(this.selectedCashierId || undefined, this.asOfDate)
+      .pipe(catchError(() => of(null)))
+      .subscribe((data: any) => {
+        this.loading = false;
+        if (!data) {
+          this.errorMsg = 'Failed to load position data.';
+          return;
+        }
+        this.results = Array.isArray(data) ? data : [data];
+      });
+  }
+
+  labelForCashier(id: number): string {
+    const c = this.cashiers.find((x) => x.id === id);
+    return c ? c.label : `Cashier #${id}`;
+  }
+
+  notes(pos: CashierPos): DenomRow[] {
+    return pos.denominations.filter((d) => d.kind !== 'coin');
+  }
+
+  coins(pos: CashierPos): DenomRow[] {
+    return pos.denominations.filter((d) => d.kind === 'coin');
+  }
+}