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,52 @@
+<!--
+  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/.
+-->
+
+<div class="pg">
+  <header class="pg-head">
+    <div>
+      <div class="pg-eyebrow">CASHIER · EXCHANGE</div>
+      <h1 class="pg-title">Currency Exchange Detail</h1>
+      <p class="pg-sub">All recorded cash exchanges (notes/coins swapped at the counter).</p>
+    </div>
+    <a class="pg-btn pg-btn--primary" [routerLink]="['/cashier/cash-exchange']">
+      <mat-icon>add</mat-icon> New Exchange
+    </a>
+  </header>
+
+  <div class="pg-card">
+    <table class="pg-table">
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Date</th>
+          <th class="num">Amount</th>
+          <th>Note</th>
+          <th>By</th>
+          <th>Recorded</th>
+        </tr>
+      </thead>
+      <tbody>
+        @for (e of exchanges; track e.id) {
+          <tr>
+            <td>{{ e.id }}</td>
+            <td>{{ e.exchangeDate || '—' }}</td>
+            <td class="num">₹{{ e.exchangeAmount | number: '1.2-2' }}</td>
+            <td>{{ e.note || '—' }}</td>
+            <td>{{ e.performedByUsername || '—' }}</td>
+            <td>{{ e.createdAt || '—' }}</td>
+          </tr>
+        }
+        @if (!loading && exchanges.length === 0) {
+          <tr>
+            <td colspan="6" class="pg-empty">No cash exchanges recorded yet.</td>
+          </tr>
+        }
+      </tbody>
+    </table>
+  </div>
+</div>
@@ -0,0 +1,45 @@
+/**
+ * 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 { RouterLink } from '@angular/router';
+import { MatIconModule } from '@angular/material/icon';
+import { CashierService } from '../cashier.service';
+
+/** Lists recorded cash exchanges (Currency Exchange Detail). */
+@Component({
+  selector: 'mifosx-currency-exchange-detail',
+  templateUrl: './currency-exchange-detail.component.html',
+  styleUrls: ['../cashier-shared.scss'],
+  standalone: true,
+  imports: [
+    CommonModule,
+    RouterLink,
+    MatIconModule
+  ]
+})
+export class CurrencyExchangeDetailComponent implements OnInit {
+  private service = inject(CashierService);
+
+  exchanges: any[] = [];
+  loading = true;
+
+  ngOnInit(): void {
+    this.service.getCashExchanges().subscribe({
+      next: (list) => {
+        this.exchanges = list || [];
+        this.loading = false;
+      },
+      error: () => {
+        this.exchanges = [];
+        this.loading = false;
+      }
+    });
+  }
+}