Merge dev into demo-backup

Brings in all of dev's latest content not present on demo-backup
(Share Withdrawal/Closure feature, TDS reports, KYC exception tracking,
client-edit-email-dialog, form121 tab, search-select) while preserving
demo-backup's own unique changes (wrapping Approval Center tab nav,
Loan Origination/Investment mega-menus). 36 files that a prior "ours
wins" conflict resolution had silently dropped were restored explicitly
from dev's tip.

src/app/cashier/cashier-routing.module.ts

@@ -62,6 +62,38 @@ const routes: Routes = [
             ),
           data: { title: 'My Disbursement Requests', breadcrumb: 'My Disbursement Requests' }
         },
+        {
+          path: 'share-withdrawal-request',
+          loadComponent: () =>
+            import('../clerk/share-withdrawal-request/share-withdrawal-request.component').then(
+              (m) => m.ShareWithdrawalRequestComponent
+            ),
+          data: { title: 'New Share Withdrawal Request', breadcrumb: 'New Share Withdrawal Request', mode: 'create' }
+        },
+        {
+          path: 'share-withdrawal-requests',
+          loadComponent: () =>
+            import('../clerk/my-share-withdrawal-requests/my-share-withdrawal-requests.component').then(
+              (m) => m.MyShareWithdrawalRequestsComponent
+            ),
+          data: { title: 'My Share Requests', breadcrumb: 'My Share Requests' }
+        },
+        {
+          path: 'share-closure-request',
+          loadComponent: () =>
+            import('../clerk/share-closure-request/share-closure-request.component').then(
+              (m) => m.ShareClosureRequestComponent
+            ),
+          data: { title: 'New Share Closure Request', breadcrumb: 'New Share Closure Request', mode: 'create' }
+        },
+        {
+          path: 'share-closure-requests',
+          loadComponent: () =>
+            import('../clerk/my-share-closure-requests/my-share-closure-requests.component').then(
+              (m) => m.MyShareClosureRequestsComponent
+            ),
+          data: { title: 'My Share Closure Requests', breadcrumb: 'My Share Closure Requests' }
+        },
         {
           path: 'account-facilities',
           loadComponent: () =>

src/app/cashier/clerk-share-closure.service.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 { Injectable, inject } from '@angular/core';
+import { HttpClient, HttpParams } from '@angular/common/http';
+import { Observable } from 'rxjs';
+
+/** HTTP service for the Share Closure maker-checker workflow — mirrors
+ *  ClerkShareWithdrawalService, adapted for closing an already-zero-share account. */
+@Injectable({ providedIn: 'root' })
+export class ClerkShareClosureService {
+  private http = inject(HttpClient);
+
+  submit(data: any): Observable<any> {
+    return this.http.post('/clerk/share-closure-requests', data);
+  }
+
+  getMyRequests(status?: string, offset = 0, limit = 20, fromDate?: string, toDate?: string): Observable<any> {
+    let params = new HttpParams().set('offset', String(offset)).set('limit', String(limit));
+    if (status) params = params.set('status', status);
+    if (fromDate) params = params.set('fromDate', fromDate);
+    if (toDate) params = params.set('toDate', toDate);
+    return this.http.get('/clerk/share-closure-requests/my', { params });
+  }
+
+  getPendingRequests(status = 'PENDING', offset = 0, limit = 20, fromDate?: string, toDate?: string): Observable<any> {
+    let params = new HttpParams().set('status', status).set('offset', String(offset)).set('limit', String(limit));
+    if (fromDate) params = params.set('fromDate', fromDate);
+    if (toDate) params = params.set('toDate', toDate);
+    return this.http.get('/clerk/share-closure-requests', { params });
+  }
+
+  getById(id: number): Observable<any> {
+    return this.http.get(`/clerk/share-closure-requests/${id}`);
+  }
+
+  validate(id: number): Observable<any> {
+    return this.http.post(`/clerk/share-closure-requests/${id}/validate`, {});
+  }
+
+  approve(id: number): Observable<any> {
+    return this.http.post(`/clerk/share-closure-requests/${id}/approve`, {});
+  }
+
+  reject(id: number, reason: string): Observable<any> {
+    return this.http.post(`/clerk/share-closure-requests/${id}/reject`, { reason });
+  }
+}

src/app/cashier/clerk-share-withdrawal.service.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 { Injectable, inject } from '@angular/core';
+import { HttpClient, HttpParams } from '@angular/common/http';
+import { Observable } from 'rxjs';
+
+/** HTTP service for the Share Withdrawal (redeem shares) maker-checker workflow — mirrors
+ *  ClerkWithdrawalService (cash withdrawal), adapted for shares. */
+@Injectable({ providedIn: 'root' })
+export class ClerkShareWithdrawalService {
+  private http = inject(HttpClient);
+
+  submit(data: any): Observable<any> {
+    return this.http.post('/clerk/share-withdrawal-requests', data);
+  }
+
+  getMyRequests(status?: string, offset = 0, limit = 20, fromDate?: string, toDate?: string): Observable<any> {
+    let params = new HttpParams().set('offset', String(offset)).set('limit', String(limit));
+    if (status) params = params.set('status', status);
+    if (fromDate) params = params.set('fromDate', fromDate);
+    if (toDate) params = params.set('toDate', toDate);
+    return this.http.get('/clerk/share-withdrawal-requests/my', { params });
+  }
+
+  getPendingRequests(status = 'PENDING', offset = 0, limit = 20, fromDate?: string, toDate?: string): Observable<any> {
+    let params = new HttpParams().set('status', status).set('offset', String(offset)).set('limit', String(limit));
+    if (fromDate) params = params.set('fromDate', fromDate);
+    if (toDate) params = params.set('toDate', toDate);
+    return this.http.get('/clerk/share-withdrawal-requests', { params });
+  }
+
+  getById(id: number): Observable<any> {
+    return this.http.get(`/clerk/share-withdrawal-requests/${id}`);
+  }
+
+  validate(id: number): Observable<any> {
+    return this.http.post(`/clerk/share-withdrawal-requests/${id}/validate`, {});
+  }
+
+  approve(id: number): Observable<any> {
+    return this.http.post(`/clerk/share-withdrawal-requests/${id}/approve`, {});
+  }
+
+  reject(id: number, reason: string): Observable<any> {
+    return this.http.post(`/clerk/share-withdrawal-requests/${id}/reject`, { reason });
+  }
+}

src/app/clerk/clerk-shared.scss

@@ -0,0 +1,77 @@
+/**
+ * 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/.
+ */
+
+/* Small shared layout/status-pill classes for the Share Withdrawal maker-checker screens —
+ * self-contained (this branch has no separate "investment" module to borrow them from). */
+
+.inv-form-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+  gap: 12px;
+}
+
+.inv-form-field {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  font-size: 11px;
+  font-weight: 600;
+  color: #64748b;
+
+  input,
+  select,
+  textarea {
+    height: 36px;
+    padding: 0 10px;
+    border: 1px solid #e2e8f0;
+    border-radius: 8px;
+    font-size: 13px;
+    color: #0d1b2a;
+    font-family: inherit;
+    background: #fff;
+    box-sizing: border-box;
+  }
+
+  textarea {
+    height: auto;
+    padding: 8px 10px;
+    resize: vertical;
+  }
+}
+
+.inv-form-actions {
+  display: flex;
+  gap: 10px;
+  padding: 12px 16px 16px;
+}
+
+.inv-badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 3px 10px;
+  border-radius: 999px;
+  font-size: 11px;
+  font-weight: 700;
+  background: #f1f5f9;
+  color: #475569;
+
+  &--active {
+    background: #fef3c7;
+    color: #92400e;
+  }
+
+  &--matured {
+    background: #dcfce7;
+    color: #166534;
+  }
+
+  &--written_off {
+    background: #fee2e2;
+    color: #991b1b;
+  }
+}

src/app/clerk/my-share-closure-requests/my-share-closure-requests.component.html

@@ -0,0 +1,69 @@
+<!--
+  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">CLERK · SHARE CLOSURE</div>
+      <h1 class="pg-title">My Share Closure Requests</h1>
+      <p class="pg-sub">Share account closure requests you have submitted, and their approval status.</p>
+    </div>
+    <div class="pg-toolbar">
+      <button type="button" class="pg-btn pg-btn--primary" (click)="newRequest()">New Share Closure Request</button>
+    </div>
+  </header>
+
+  <div class="pg-card">
+    <div class="inv-form-grid" style="padding: 12px 16px">
+      <label class="inv-form-field">
+        <span>Status</span>
+        <select [(ngModel)]="filterStatus" (change)="onFilterChange()">
+          @for (opt of statusOptions; track opt.value) {
+            <option [value]="opt.value">{{ opt.label }}</option>
+          }
+        </select>
+      </label>
+    </div>
+    <table class="pg-table">
+      <thead>
+        <tr>
+          <th>Account No</th>
+          <th>Client</th>
+          <th>Closed Date</th>
+          <th>Submitted At</th>
+          <th>Status</th>
+        </tr>
+      </thead>
+      <tbody>
+        @if (loading) {
+          <tr>
+            <td colspan="5" class="pg-empty">Loading…</td>
+          </tr>
+        } @else if (loaded && requests.length === 0) {
+          <tr>
+            <td colspan="5" class="pg-empty">No share closure requests found.</td>
+          </tr>
+        } @else {
+          @for (r of requests; track r.id) {
+            <tr>
+              <td>
+                <span class="pg-chip">{{ r.account_no }}</span>
+              </td>
+              <td>{{ r.client_name }}</td>
+              <td>{{ formatDateTime(r.closed_date) }}</td>
+              <td>{{ formatDateTime(r.submitted_at) }}</td>
+              <td>
+                <span [class]="statusClass(r.status)">{{ statusLabel(r.status) }}</span>
+              </td>
+            </tr>
+          }
+        }
+      </tbody>
+    </table>
+  </div>
+</div>

src/app/clerk/my-share-closure-requests/my-share-closure-requests.component.ts

@@ -0,0 +1,112 @@
+/**
+ * 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 { Router, RouterModule } from '@angular/router';
+import { catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+
+import { ClerkShareClosureService } from '../../cashier/clerk-share-closure.service';
+
+/** Clerk Dashboard "My Share Closure Requests" — lists the share account closure requests this
+ *  clerk has submitted and their approval status. Mirrors MyShareWithdrawalRequestsComponent. */
+@Component({
+  selector: 'mifosx-my-share-closure-requests',
+  templateUrl: './my-share-closure-requests.component.html',
+  styleUrls: [
+    '../../cashier/cashier-shared.scss',
+    '../clerk-shared.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    RouterModule
+  ]
+})
+export class MyShareClosureRequestsComponent implements OnInit {
+  private service = inject(ClerkShareClosureService);
+  private router = inject(Router);
+
+  requests: any[] = [];
+  totalRecords = 0;
+  loading = false;
+  loaded = false;
+
+  filterStatus = '';
+
+  get statusOptions(): { value: string; label: string }[] {
+    return [
+      { value: '', label: 'All' },
+      { value: 'PENDING', label: 'Pending' },
+      { value: 'APPROVED', label: 'Approved' },
+      { value: 'REJECTED', label: 'Rejected' }
+    ];
+  }
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  load(): void {
+    this.loading = true;
+    this.service
+      .getMyRequests(this.filterStatus || undefined, 0, 50)
+      .pipe(catchError(() => of({ pageItems: [], totalFilteredRecords: 0 })))
+      .subscribe((res: any) => {
+        this.requests = res?.pageItems ?? [];
+        this.totalRecords = Number(res?.totalFilteredRecords ?? 0);
+        this.loading = false;
+        this.loaded = true;
+      });
+  }
+
+  onFilterChange(): void {
+    this.load();
+  }
+
+  newRequest(): void {
+    this.router.navigate(['/clerk/share-closure-request']);
+  }
+
+  statusClass(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'inv-badge--active',
+      APPROVED: 'inv-badge--matured',
+      REJECTED: 'inv-badge--written_off'
+    };
+    return `inv-badge ${map[status] ?? ''}`;
+  }
+
+  statusLabel(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'Pending Approval',
+      APPROVED: 'Approved',
+      REJECTED: 'Rejected'
+    };
+    return map[status] ?? status;
+  }
+
+  formatDateTime(val: any): string {
+    if (!val) return '—';
+    try {
+      const d = new Date(val);
+      return d.toLocaleString('en-IN', {
+        day: '2-digit',
+        month: 'short',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit'
+      });
+    } catch {
+      return String(val);
+    }
+  }
+}

src/app/clerk/my-share-withdrawal-requests/my-share-withdrawal-requests.component.html

@@ -0,0 +1,73 @@
+<!--
+  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">CLERK · SHARE WITHDRAWAL</div>
+      <h1 class="pg-title">My Share Requests</h1>
+      <p class="pg-sub">Share withdrawal requests you have submitted, and their approval status.</p>
+    </div>
+    <div class="pg-toolbar">
+      <button type="button" class="pg-btn pg-btn--primary" (click)="newRequest()">New Share Withdrawal</button>
+    </div>
+  </header>
+
+  <div class="pg-card">
+    <div class="inv-form-grid" style="padding: 12px 16px">
+      <label class="inv-form-field">
+        <span>Status</span>
+        <select [(ngModel)]="filterStatus" (change)="onFilterChange()">
+          @for (opt of statusOptions; track opt.value) {
+            <option [value]="opt.value">{{ opt.label }}</option>
+          }
+        </select>
+      </label>
+    </div>
+    <table class="pg-table">
+      <thead>
+        <tr>
+          <th>Account No</th>
+          <th>Client</th>
+          <th class="num">Shares</th>
+          <th>Resolution No.</th>
+          <th>Meeting Date</th>
+          <th>Submitted At</th>
+          <th>Status</th>
+        </tr>
+      </thead>
+      <tbody>
+        @if (loading) {
+          <tr>
+            <td colspan="7" class="pg-empty">Loading…</td>
+          </tr>
+        } @else if (loaded && requests.length === 0) {
+          <tr>
+            <td colspan="7" class="pg-empty">No share withdrawal requests found.</td>
+          </tr>
+        } @else {
+          @for (r of requests; track r.id) {
+            <tr>
+              <td>
+                <span class="pg-chip">{{ r.account_no }}</span>
+              </td>
+              <td>{{ r.client_name }}</td>
+              <td class="num">{{ r.requested_shares }}</td>
+              <td>{{ r.resolution_number }}</td>
+              <td>{{ formatDateTime(r.meeting_date) }}</td>
+              <td>{{ formatDateTime(r.submitted_at) }}</td>
+              <td>
+                <span [class]="statusClass(r.status)">{{ statusLabel(r.status) }}</span>
+              </td>
+            </tr>
+          }
+        }
+      </tbody>
+    </table>
+  </div>
+</div>

src/app/clerk/my-share-withdrawal-requests/my-share-withdrawal-requests.component.ts

@@ -0,0 +1,112 @@
+/**
+ * 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 { Router, RouterModule } from '@angular/router';
+import { catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+
+import { ClerkShareWithdrawalService } from '../../cashier/clerk-share-withdrawal.service';
+
+/** Clerk Dashboard "My Share Requests" — lists the share withdrawal requests this clerk has
+ *  submitted and their approval status. Mirrors MyRequestsComponent/MyDisbursementRequestsComponent. */
+@Component({
+  selector: 'mifosx-my-share-withdrawal-requests',
+  templateUrl: './my-share-withdrawal-requests.component.html',
+  styleUrls: [
+    '../../cashier/cashier-shared.scss',
+    '../clerk-shared.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    RouterModule
+  ]
+})
+export class MyShareWithdrawalRequestsComponent implements OnInit {
+  private service = inject(ClerkShareWithdrawalService);
+  private router = inject(Router);
+
+  requests: any[] = [];
+  totalRecords = 0;
+  loading = false;
+  loaded = false;
+
+  filterStatus = '';
+
+  get statusOptions(): { value: string; label: string }[] {
+    return [
+      { value: '', label: 'All' },
+      { value: 'PENDING', label: 'Pending' },
+      { value: 'APPROVED', label: 'Approved' },
+      { value: 'REJECTED', label: 'Rejected' }
+    ];
+  }
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  load(): void {
+    this.loading = true;
+    this.service
+      .getMyRequests(this.filterStatus || undefined, 0, 50)
+      .pipe(catchError(() => of({ pageItems: [], totalFilteredRecords: 0 })))
+      .subscribe((res: any) => {
+        this.requests = res?.pageItems ?? [];
+        this.totalRecords = Number(res?.totalFilteredRecords ?? 0);
+        this.loading = false;
+        this.loaded = true;
+      });
+  }
+
+  onFilterChange(): void {
+    this.load();
+  }
+
+  newRequest(): void {
+    this.router.navigate(['/clerk/share-withdrawal-request']);
+  }
+
+  statusClass(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'inv-badge--active',
+      APPROVED: 'inv-badge--matured',
+      REJECTED: 'inv-badge--written_off'
+    };
+    return `inv-badge ${map[status] ?? ''}`;
+  }
+
+  statusLabel(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'Pending Approval',
+      APPROVED: 'Approved',
+      REJECTED: 'Rejected'
+    };
+    return map[status] ?? status;
+  }
+
+  formatDateTime(val: any): string {
+    if (!val) return '—';
+    try {
+      const d = new Date(val);
+      return d.toLocaleString('en-IN', {
+        day: '2-digit',
+        month: 'short',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit'
+      });
+    } catch {
+      return String(val);
+    }
+  }
+}

src/app/clerk/share-closure-request/share-closure-request.component.html

@@ -0,0 +1,355 @@
+<!--
+  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">{{ isReview ? 'CHECKER · APPROVAL' : 'CLERK · SHARE CLOSURE' }}</div>
+      <h1 class="pg-title">{{ pageTitle }}</h1>
+      <p class="pg-sub">{{ pageSubtitle }}</p>
+    </div>
+    <div class="pg-toolbar">
+      <button type="button" class="pg-btn" (click)="goBack()">
+        <mat-icon>arrow_back</mat-icon>
+        {{ isReview ? 'Back to Requests' : 'My Share Closure Requests' }}
+      </button>
+    </div>
+  </header>
+
+  <div class="pg-card">
+    <div class="pos-section-label">Share Account</div>
+    <div class="inv-form-grid" style="padding: 16px">
+      @if (!isReview) {
+        <label class="inv-form-field" style="grid-column: span 2">
+          <span>* Search Account No. / Client Name (only zero-share accounts are eligible)</span>
+          <mifosx-search-select
+            [options]="accountOptions"
+            [(ngModel)]="selectedAccountId"
+            (ngModelChange)="onAccountSelected($event)"
+            placeholder="Search share account no. or client name…"
+          ></mifosx-search-select>
+        </label>
+      }
+      @if (account) {
+        <label class="inv-form-field">
+          <span>Account No</span>
+          <input type="text" [value]="account.accountNo" readonly />
+        </label>
+        <label class="inv-form-field">
+          <span>Client</span>
+          <input type="text" [value]="account.clientName" readonly />
+        </label>
+        <label class="inv-form-field">
+          <span>Shares Held</span>
+          <input type="text" [value]="heldShares" readonly />
+        </label>
+      }
+      @if (loadingAccount) {
+        <div class="pg-empty">Loading account…</div>
+      }
+      @if (account && heldShares !== 0 && !isReview) {
+        <div class="pg-empty" style="grid-column: span 2; color: #b42318">
+          This account still holds {{ heldShares }} share(s) — all shares must be withdrawn first via the Share
+          Withdrawal workflow before it becomes eligible for closure.
+        </div>
+      }
+    </div>
+  </div>
+
+  @if (isReview && reviewRequest) {
+    <div class="pg-card">
+      <div class="pos-section-label">Client Compliance</div>
+      <div class="inv-form-grid" style="padding: 16px">
+        <div class="inv-form-field">
+          <span>KYC Status</span>
+          <span
+            class="swr-chip"
+            [class.swr-chip--ok]="reviewRequest.client_kyc_verified"
+            [class.swr-chip--warn]="!reviewRequest.client_kyc_verified"
+          >
+            {{ reviewRequest.client_kyc_status_label }}
+          </span>
+        </div>
+        <div class="inv-form-field">
+          <span>Risk Category</span>
+          <span
+            class="swr-chip"
+            [class.swr-chip--ok]="!reviewRequest.client_risk_high"
+            [class.swr-chip--warn]="reviewRequest.client_risk_high"
+          >
+            {{ reviewRequest.client_risk_category_label }}
+          </span>
+        </div>
+        <div class="inv-form-field">
+          <span>Open AML Alerts</span>
+          <span
+            class="swr-chip"
+            [class.swr-chip--ok]="!reviewRequest.client_open_aml_alerts"
+            [class.swr-chip--warn]="reviewRequest.client_open_aml_alerts > 0"
+          >
+            {{ reviewRequest.client_open_aml_alerts || 0 }}
+          </span>
+        </div>
+      </div>
+    </div>
+  }
+
+  @if (account) {
+    <div class="pg-card">
+      <div class="pos-section-label">Closure Details</div>
+      <div class="inv-form-grid" style="padding: 16px">
+        <label class="inv-form-field">
+          <span>* Closed Date</span>
+          <input type="date" [(ngModel)]="closedDate" [disabled]="isReview" />
+        </label>
+        <label class="inv-form-field" style="grid-column: span 2">
+          <span>Note (optional)</span>
+          <input
+            type="text"
+            [(ngModel)]="note"
+            [disabled]="isReview"
+            placeholder="e.g. Member exit — all shares redeemed"
+          />
+        </label>
+      </div>
+
+      @if (!isReview) {
+        <div class="inv-form-actions">
+          <button
+            type="button"
+            class="pg-btn pg-btn--primary"
+            [disabled]="!isFormValid || submitting"
+            (click)="openConfirmDialog()"
+          >
+            {{ submitting ? 'Submitting…' : 'Review &amp; Submit' }}
+          </button>
+        </div>
+      }
+    </div>
+  }
+
+  @if (isReview && reviewRequest?.status === 'PENDING') {
+    <div class="pg-card">
+      <div class="pos-section-label">Verification</div>
+      <div class="swrv-trigger">
+        <div class="swrv-trigger__icon">
+          <mat-icon>fact_check</mat-icon>
+        </div>
+        <div class="swrv-trigger__text">
+          <div class="swrv-trigger__title">Run a live backend validation</div>
+          <div class="swrv-trigger__sub">
+            Re-checks shares held, account status, active loan/guarantee and client compliance before you approve.
+          </div>
+        </div>
+        <button type="button" class="pg-btn pg-btn--primary" (click)="openValidateModal()">
+          <mat-icon>play_circle</mat-icon>
+          Validate Request
+        </button>
+      </div>
+
+      <div class="inv-form-actions">
+        <button type="button" class="pg-btn pg-btn--primary" (click)="approveReview()">
+          <mat-icon>check_circle</mat-icon>
+          Approve &amp; Close Account
+        </button>
+        <button type="button" class="pg-btn pg-btn--danger" (click)="openRejectDialog()">
+          <mat-icon>cancel</mat-icon>
+          Reject
+        </button>
+      </div>
+    </div>
+  }
+
+  @if (showValidateModal) {
+    <div class="swrv-modal">
+      <div class="swrv-modal__card">
+        <div class="swrv-modal__header">
+          <div class="swrv-modal__title">
+            <span class="swrv-modal__title-icon"><mat-icon>fact_check</mat-icon></span>
+            Validate Share Closure Request
+          </div>
+          <button type="button" class="swrv-modal__close" [disabled]="validating" (click)="closeValidateModal()">
+            <mat-icon>close</mat-icon>
+          </button>
+        </div>
+
+        <div class="swrv-modal__body">
+          <p class="swrv-modal__intro">
+            Re-checking closure of <strong>{{ account?.accountNo }}</strong> ({{ account?.clientName }}) against the
+            live account, loan/guarantee and compliance state — not just what was captured at submission time.
+          </p>
+
+          @if (backendChecks && !validating && !validateAllPassed) {
+            <div class="swrv-modal__warn">
+              <mat-icon>warning</mat-icon>
+              <div>
+                <strong>Some checks need review before approving.</strong>
+                Scroll down to see which ones failed and why.
+              </div>
+            </div>
+          }
+
+          <ol class="swrv-steps">
+            @for (step of validateSteps; track step.label; let i = $index) {
+              <li
+                class="swrv-step"
+                [class.swrv-step--active]="step.status === 'active'"
+                [class.swrv-step--done]="step.status === 'done'"
+                [class.swrv-step--failed]="step.status === 'failed'"
+              >
+                <div class="swrv-step__indicator">
+                  @if (step.status === 'done') {
+                    <mat-icon>check</mat-icon>
+                  } @else if (step.status === 'active') {
+                    <mat-icon class="swrv-spin">autorenew</mat-icon>
+                  } @else if (step.status === 'failed') {
+                    <mat-icon>close</mat-icon>
+                  } @else {
+                    <span>{{ i + 1 }}</span>
+                  }
+                </div>
+                <div class="swrv-step__content">
+                  <div class="swrv-step__label">{{ step.label }}</div>
+                  <div class="swrv-step__msg">{{ step.detail }}</div>
+                </div>
+              </li>
+            }
+          </ol>
+
+          @if (validating && validateSteps.length === 0) {
+            <div class="pg-empty">Connecting to server…</div>
+          }
+
+          @if (backendChecks && !validating && validateAllPassed) {
+            <div class="swrv-modal__result">
+              <mat-icon>verified</mat-icon>
+              <span>All checks passed — safe to approve.</span>
+            </div>
+          }
+        </div>
+
+        <div class="swrv-modal__footer">
+          @if (!validating && backendChecks) {
+            <button type="button" class="pg-btn" (click)="runBackendValidation()">
+              <mat-icon>refresh</mat-icon>
+              Re-run
+            </button>
+          }
+          @if (!validating && backendChecks && validateAllPassed) {
+            <button type="button" class="pg-btn pg-btn--primary" (click)="closeValidateModal(); approveReview()">
+              <mat-icon>check_circle</mat-icon>
+              Approve &amp; Close Account
+            </button>
+          }
+          <button type="button" class="pg-btn" [disabled]="validating" (click)="closeValidateModal()">
+            {{ validating ? 'Validating…' : 'Close' }}
+          </button>
+        </div>
+      </div>
+    </div>
+  }
+
+  @if (isReview && activityLog.length > 0) {
+    <div class="pg-card">
+      <div class="pos-section-label">Activity Log</div>
+      <table class="pg-table">
+        <thead>
+          <tr>
+            <th>Timestamp</th>
+            <th>Action</th>
+            <th>User</th>
+            <th>Note</th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (entry of activityLog; track entry.timestamp) {
+            <tr>
+              <td>{{ entry.timestamp | date: 'medium' }}</td>
+              <td>{{ entry.action }}</td>
+              <td>{{ entry.user }}</td>
+              <td>{{ entry.note || '—' }}</td>
+            </tr>
+          }
+        </tbody>
+      </table>
+    </div>
+  }
+
+  @if (showConfirmDialog) {
+    <div class="swr-modal-backdrop">
+      <div class="swr-modal">
+        <h3>Confirm Share Closure Request</h3>
+        <p class="pg-sub">Review the details below before submitting for Bank Manager approval.</p>
+        <table class="pg-table">
+          <tbody>
+            <tr>
+              <td>Account No / Client</td>
+              <td>{{ account?.accountNo }} — {{ account?.clientName }}</td>
+            </tr>
+            <tr>
+              <td>Shares Held</td>
+              <td>{{ heldShares }}</td>
+            </tr>
+            <tr>
+              <td>Closed Date</td>
+              <td>{{ closedDate }}</td>
+            </tr>
+            <tr>
+              <td>Note</td>
+              <td>{{ note || '—' }}</td>
+            </tr>
+          </tbody>
+        </table>
+
+        <div class="pos-section-label" style="margin-top: 12px">Validation Checks</div>
+        <table class="pg-table">
+          <tbody>
+            @for (check of verificationChecks; track check.label) {
+              <tr>
+                <td>{{ check.label }}</td>
+                <td [class.swr-check-pass]="check.pass" [class.swr-check-fail]="!check.pass">
+                  {{ check.pass ? 'Pass — ' : 'Review — ' }}{{ check.detail }}
+                </td>
+              </tr>
+            }
+          </tbody>
+        </table>
+
+        <div class="inv-form-actions">
+          <button type="button" class="pg-btn pg-btn--primary" [disabled]="submitting" (click)="confirmSubmit()">
+            {{ submitting ? 'Submitting…' : 'Confirm & Submit' }}
+          </button>
+          <button type="button" class="pg-btn" (click)="cancelConfirmDialog()">Back to Edit</button>
+        </div>
+      </div>
+    </div>
+  }
+
+  @if (showRejectDialog) {
+    <div class="swr-modal-backdrop">
+      <div class="swr-modal">
+        <h3>Reject Share Closure Request</h3>
+        <label class="inv-form-field">
+          <span>* Rejection Reason</span>
+          <textarea rows="3" [(ngModel)]="rejectionReason"></textarea>
+        </label>
+        <div class="inv-form-actions">
+          <button
+            type="button"
+            class="pg-btn pg-btn--danger"
+            [disabled]="!rejectionReason.trim()"
+            (click)="confirmRejectReview()"
+          >
+            Confirm Reject
+          </button>
+          <button type="button" class="pg-btn" (click)="showRejectDialog = false">Cancel</button>
+        </div>
+      </div>
+    </div>
+  }
+</div>

src/app/clerk/share-closure-request/share-closure-request.component.ts

@@ -0,0 +1,336 @@
+/**
+ * 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, EventEmitter, Input, OnInit, Output, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormsModule } from '@angular/forms';
+import { ActivatedRoute, Router, RouterModule } from '@angular/router';
+import { MatIconModule } from '@angular/material/icon';
+import { MatSnackBar, MatSnackBarModule } from '@angular/material/snack-bar';
+import { catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+
+import { SharesService } from '../../shares/shares.service';
+import { ClerkShareClosureService } from '../../cashier/clerk-share-closure.service';
+import { SearchSelectComponent, SearchSelectOption } from '../../shared/search-select/search-select.component';
+
+export type ShareClosureMode = 'create' | 'review';
+
+interface ActivityEntry {
+  timestamp: string;
+  action: string;
+  user: string;
+  note?: string;
+}
+
+/**
+ * Share Account Closure request — maker screen in the Clerk Dashboard. A clerk finds a member's
+ * Share Account that already holds zero shares (all shares already withdrawn), enters the closed
+ * date plus an optional note, and submits for Bank Manager approval. This is the ONLY entry point
+ * a share account closure should go through — approval server-side executes the real Fineract
+ * "close" command (see ClerkShareClosureRequestApiResource on the backend).
+ */
+@Component({
+  selector: 'mifosx-share-closure-request',
+  templateUrl: './share-closure-request.component.html',
+  styleUrls: [
+    '../../cashier/cashier-shared.scss',
+    '../clerk-shared.scss',
+    '../share-withdrawal-request/share-withdrawal-request.component.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    RouterModule,
+    MatIconModule,
+    MatSnackBarModule,
+    SearchSelectComponent
+  ]
+})
+export class ShareClosureRequestComponent implements OnInit {
+  private route = inject(ActivatedRoute);
+  private router = inject(Router);
+  private sharesService = inject(SharesService);
+  private closureService = inject(ClerkShareClosureService);
+  private snackBar = inject(MatSnackBar);
+
+  /** When embedded (e.g. opened as a popup from a list screen instead of routed to directly), mode
+   *  and requestId come from these inputs rather than the route, and success/close actions emit
+   *  events instead of navigating away. */
+  @Input() embedded = false;
+  @Input() overrideMode: ShareClosureMode | null = null;
+  @Input() overrideRequestId: number | null = null;
+  @Output() closeRequested = new EventEmitter<void>();
+  @Output() actionCompleted = new EventEmitter<void>();
+
+  mode: ShareClosureMode = 'create';
+  requestId: number | null = null;
+
+  submitting = false;
+  loadingAccount = false;
+
+  selectedAccountId = '';
+  accountOptions: SearchSelectOption[] = [];
+
+  account: any = null;
+
+  closedDate = '';
+  note = '';
+
+  activityLog: ActivityEntry[] = [];
+  reviewRequest: any = null;
+  showRejectDialog = false;
+  rejectionReason = '';
+  showConfirmDialog = false;
+
+  showValidateModal = false;
+  validating = false;
+  validateAllPassed = false;
+  backendChecks: { label: string; pass: boolean; detail: string }[] | null = null;
+  validateSteps: { label: string; detail: string; pass: boolean; status: 'pending' | 'active' | 'done' | 'failed' }[] =
+    [];
+
+  get heldShares(): number {
+    return Number(this.account?.summary?.totalApprovedShares ?? this.account?.totalApprovedShares ?? 0);
+  }
+
+  get isFormValid(): boolean {
+    if (!this.account) return false;
+    if (this.heldShares !== 0) return false;
+    if (!this.closedDate) return false;
+    return true;
+  }
+
+  /** Shown to the clerk before submit and to the manager before approval, so both can verify the same checks. */
+  get verificationChecks(): { label: string; pass: boolean; detail: string }[] {
+    return [
+      { label: 'No shares currently held', pass: this.heldShares === 0, detail: `${this.heldShares} share(s) held` },
+      { label: 'Closed Date provided', pass: !!this.closedDate, detail: this.closedDate || 'Missing' }
+    ];
+  }
+
+  get isReview(): boolean {
+    return this.mode === 'review';
+  }
+
+  get pageTitle(): string {
+    return this.isReview ? 'Review Share Closure Request' : 'New Share Closure Request';
+  }
+
+  get pageSubtitle(): string {
+    return this.isReview
+      ? "Approve or reject the clerk's share account closure request."
+      : 'Close a Share Account whose shares have already been fully withdrawn, for Bank Manager approval.';
+  }
+
+  ngOnInit(): void {
+    this.mode = this.overrideMode ?? (this.route.snapshot.data?.['mode'] as ShareClosureMode) ?? 'create';
+    const idParam = this.overrideRequestId ?? this.route.snapshot.params?.['id'];
+    this.requestId = idParam ? Number(idParam) : null;
+
+    const today = new Date();
+    this.closedDate = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, '0')}-${String(today.getDate()).padStart(2, '0')}`;
+
+    this.sharesService
+      .getShareAccountSummaries()
+      .pipe(catchError(() => of([])))
+      .subscribe((rows: any[]) => {
+        this.accountOptions = (rows || [])
+          .filter((r) => (r.status?.value || '').toLowerCase() === 'active' && Number(r.totalApprovedShares ?? 0) === 0)
+          .map((r) => ({
+            value: String(r.id),
+            label: `${r.accountNo} — ${r.clientName} (0 shares held)`,
+            searchText: `${r.accountNo} ${r.clientName}`
+          }));
+      });
+
+    if (this.requestId && this.mode === 'review') {
+      this.loadReviewRequest(this.requestId);
+    }
+  }
+
+  onAccountSelected(accountId: string): void {
+    this.selectedAccountId = accountId;
+    if (!accountId) {
+      this.account = null;
+      return;
+    }
+    this.loadingAccount = true;
+    this.sharesService
+      .getSharesAccountData(accountId, false)
+      .pipe(catchError(() => of(null)))
+      .subscribe((acc: any) => {
+        this.account = acc;
+        this.loadingAccount = false;
+      });
+  }
+
+  private loadReviewRequest(id: number): void {
+    this.closureService.getById(id).subscribe({
+      next: (req: any) => {
+        this.reviewRequest = req;
+        this.closedDate = req.closed_date ? String(req.closed_date).split('T')[0].split(' ')[0] : this.closedDate;
+        this.note = req.note ?? '';
+
+        if (req.activity_log) {
+          try {
+            this.activityLog = JSON.parse(req.activity_log);
+          } catch {
+            this.activityLog = [];
+          }
+        }
+
+        this.sharesService
+          .getSharesAccountData(String(req.share_account_id), false)
+          .pipe(catchError(() => of(null)))
+          .subscribe((acc: any) => (this.account = acc));
+      },
+      error: () => this.snackBar.open('Failed to load share closure request.', 'Close', { duration: 5000 })
+    });
+  }
+
+  /** "Review before Save" per requirement — opens the confirm dialog instead of submitting directly. */
+  openConfirmDialog(): void {
+    if (!this.isFormValid || this.submitting) {
+      return;
+    }
+    this.showConfirmDialog = true;
+  }
+
+  cancelConfirmDialog(): void {
+    this.showConfirmDialog = false;
+  }
+
+  confirmSubmit(): void {
+    this.showConfirmDialog = false;
+    this.submitting = true;
+    const payload = {
+      shareAccountId: Number(this.selectedAccountId),
+      accountNo: this.account?.accountNo,
+      clientId: this.account?.clientId,
+      clientName: this.account?.clientName,
+      closedDate: this.closedDate,
+      note: this.note
+    };
+    this.closureService.submit(payload).subscribe({
+      next: () => {
+        this.snackBar.open('Share closure request submitted for approval.', 'Close', { duration: 4000 });
+        if (this.embedded) {
+          this.actionCompleted.emit();
+        } else {
+          this.router.navigate(['/clerk/dashboard']);
+        }
+      },
+      error: (err) => {
+        this.submitting = false;
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not submit the request.', 'Close', {
+          duration: 6000
+        });
+      }
+    });
+  }
+
+  openValidateModal(): void {
+    if (!this.reviewRequest) return;
+    this.showValidateModal = true;
+    this.runBackendValidation();
+  }
+
+  closeValidateModal(): void {
+    if (this.validating) return;
+    this.showValidateModal = false;
+  }
+
+  /** Re-checks live backend state (shares still zero, account still active, no active loan/guarantee,
+   *  compliance standing) rather than relying on data already loaded in the browser — catches drift
+   *  since submission. Results are revealed one step at a time for the pipeline-style animation. */
+  runBackendValidation(): void {
+    if (!this.reviewRequest || this.validating) return;
+    this.validating = true;
+    this.backendChecks = null;
+    this.validateSteps = [];
+    this.closureService.validate(this.reviewRequest.id).subscribe({
+      next: (res: any) => {
+        const checks = (res?.checks ?? []) as { label: string; pass: boolean; detail: string }[];
+        this.backendChecks = checks;
+        this.validateAllPassed = !!res?.allPassed;
+        this.validateSteps = checks.map((c) => ({ ...c, status: 'pending' as const }));
+        this.revealValidateSteps(0);
+      },
+      error: (err) => {
+        this.validating = false;
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not run backend validation.', 'Close', {
+          duration: 6000
+        });
+      }
+    });
+  }
+
+  private revealValidateSteps(index: number): void {
+    if (index >= this.validateSteps.length) {
+      this.validating = false;
+      return;
+    }
+    this.validateSteps[index].status = 'active';
+    setTimeout(() => {
+      this.validateSteps[index].status = this.validateSteps[index].pass ? 'done' : 'failed';
+      this.revealValidateSteps(index + 1);
+    }, 320);
+  }
+
+  approveReview(): void {
+    if (!this.reviewRequest) return;
+    this.closureService.approve(this.reviewRequest.id).subscribe({
+      next: () => {
+        this.snackBar.open('Share closure approved — account closed.', 'Close', { duration: 6000 });
+        if (this.embedded) {
+          this.actionCompleted.emit();
+        } else {
+          this.router.navigate(['/checker-inbox-and-tasks/share-closure-requests']);
+        }
+      },
+      error: (err) =>
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not approve the request.', 'Close', {
+          duration: 6000
+        })
+    });
+  }
+
+  openRejectDialog(): void {
+    this.showRejectDialog = true;
+    this.rejectionReason = '';
+  }
+
+  confirmRejectReview(): void {
+    if (!this.reviewRequest || !this.rejectionReason.trim()) return;
+    this.closureService.reject(this.reviewRequest.id, this.rejectionReason.trim()).subscribe({
+      next: () => {
+        this.showRejectDialog = false;
+        this.snackBar.open('Share closure request rejected.', 'Close', { duration: 4000 });
+        if (this.embedded) {
+          this.actionCompleted.emit();
+        } else {
+          this.router.navigate(['/checker-inbox-and-tasks/share-closure-requests']);
+        }
+      },
+      error: (err) =>
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not reject the request.', 'Close', {
+          duration: 6000
+        })
+    });
+  }
+
+  goBack(): void {
+    if (this.embedded) {
+      this.closeRequested.emit();
+      return;
+    }
+    this.router.navigate(this.isReview ? ['/checker-inbox-and-tasks/share-closure-requests'] : ['/clerk/dashboard']);
+  }
+}

src/app/clerk/share-withdrawal-request/share-withdrawal-request.component.html

@@ -0,0 +1,431 @@
+<!--
+  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">{{ isReview ? 'CHECKER · APPROVAL' : 'CLERK · SHARE WITHDRAWAL' }}</div>
+      <h1 class="pg-title">{{ pageTitle }}</h1>
+      <p class="pg-sub">{{ pageSubtitle }}</p>
+    </div>
+    <div class="pg-toolbar">
+      <button type="button" class="pg-btn" (click)="goBack()">
+        <mat-icon>arrow_back</mat-icon>
+        {{ isReview ? 'Back to Requests' : 'My Share Requests' }}
+      </button>
+    </div>
+  </header>
+
+  <div class="pg-card">
+    <div class="pos-section-label">Share Account</div>
+    <div class="inv-form-grid" style="padding: 16px">
+      @if (!isReview) {
+        <label class="inv-form-field" style="grid-column: span 2">
+          <span>* Search Account No. / Client Name</span>
+          <mifosx-search-select
+            [options]="accountOptions"
+            [(ngModel)]="selectedAccountId"
+            (ngModelChange)="onAccountSelected($event)"
+            placeholder="Search share account no. or client name…"
+          ></mifosx-search-select>
+        </label>
+      }
+      @if (account) {
+        <label class="inv-form-field">
+          <span>Account No</span>
+          <input type="text" [value]="account.accountNo" readonly />
+        </label>
+        <label class="inv-form-field">
+          <span>Client</span>
+          <input type="text" [value]="account.clientName" readonly />
+        </label>
+        <label class="inv-form-field">
+          <span>Shares Held</span>
+          <input
+            type="text"
+            [value]="account.summary?.totalApprovedShares ?? account.totalApprovedShares ?? 0"
+            readonly
+          />
+        </label>
+        <label class="inv-form-field">
+          <span>Unit Price</span>
+          <input type="text" [value]="'₹' + (unitPrice | number: '1.2-2')" readonly />
+        </label>
+      }
+      @if (loadingAccount) {
+        <div class="pg-empty">Loading account…</div>
+      }
+    </div>
+  </div>
+
+  @if (isReview && reviewRequest) {
+    <div class="pg-card">
+      <div class="pos-section-label">Client Compliance</div>
+      <div class="inv-form-grid" style="padding: 16px">
+        <div class="inv-form-field">
+          <span>KYC Status</span>
+          <span
+            class="swr-chip"
+            [class.swr-chip--ok]="reviewRequest.client_kyc_verified"
+            [class.swr-chip--warn]="!reviewRequest.client_kyc_verified"
+          >
+            {{ reviewRequest.client_kyc_status_label }}
+          </span>
+        </div>
+        <div class="inv-form-field">
+          <span>Risk Category</span>
+          <span
+            class="swr-chip"
+            [class.swr-chip--ok]="!reviewRequest.client_risk_high"
+            [class.swr-chip--warn]="reviewRequest.client_risk_high"
+          >
+            {{ reviewRequest.client_risk_category_label }}
+          </span>
+        </div>
+        <div class="inv-form-field">
+          <span>Open AML Alerts</span>
+          <span
+            class="swr-chip"
+            [class.swr-chip--ok]="!reviewRequest.client_open_aml_alerts"
+            [class.swr-chip--warn]="reviewRequest.client_open_aml_alerts > 0"
+          >
+            {{ reviewRequest.client_open_aml_alerts || 0 }}
+          </span>
+        </div>
+      </div>
+    </div>
+  }
+
+  @if (account) {
+    <div class="pg-card">
+      <div class="pos-section-label">Withdrawal Details</div>
+      <div class="inv-form-grid" style="padding: 16px">
+        <label class="inv-form-field">
+          <span>* Shares to Withdraw</span>
+          <input type="number" [(ngModel)]="requestedShares" min="1" [disabled]="isReview" />
+        </label>
+        <label class="inv-form-field">
+          <span>* Requested Date</span>
+          <input type="date" [(ngModel)]="requestedDate" [disabled]="isReview" />
+        </label>
+        <label class="inv-form-field">
+          <span>Withdrawal Value</span>
+          <input type="text" [value]="'₹' + (withdrawalValue | number: '1.2-2')" readonly />
+        </label>
+        <label class="inv-form-field">
+          <span>Remaining Shares After Withdrawal</span>
+          <input type="text" [value]="remainingShares" readonly />
+        </label>
+        <label class="inv-form-field">
+          <span>* Board Resolution Number</span>
+          <input type="text" [(ngModel)]="resolutionNumber" [disabled]="isReview" placeholder="e.g. BR-2026-014" />
+        </label>
+        <label class="inv-form-field">
+          <span>* Date of Meeting</span>
+          <input type="date" [(ngModel)]="meetingDate" [disabled]="isReview" />
+        </label>
+        <label class="inv-form-field">
+          <span>* Settlement Payment Type</span>
+          @if (!isReview) {
+            <select [(ngModel)]="settlementPaymentTypeId">
+              <option [ngValue]="null">Select…</option>
+              @for (pt of paymentTypeOptions; track pt.id) {
+                <option [ngValue]="pt.id">{{ pt.name }}</option>
+              }
+            </select>
+          } @else {
+            <input type="text" [value]="settlementPaymentTypeName" readonly />
+          }
+        </label>
+        <label class="inv-form-field" style="grid-column: span 2">
+          <span>Description / Remarks</span>
+          <input type="text" [(ngModel)]="description" [disabled]="isReview" />
+        </label>
+      </div>
+
+      @if (!isReview) {
+        <div class="inv-form-actions">
+          <button
+            type="button"
+            class="pg-btn pg-btn--primary"
+            [disabled]="!isFormValid || submitting"
+            (click)="openConfirmDialog()"
+          >
+            {{ submitting ? 'Submitting…' : 'Review &amp; Submit' }}
+          </button>
+        </div>
+      }
+    </div>
+  }
+
+  @if (isReview && reviewRequest?.status === 'PENDING') {
+    <div class="pg-card">
+      <div class="pos-section-label">Verification</div>
+      <div class="swrv-trigger">
+        <div class="swrv-trigger__icon">
+          <mat-icon>fact_check</mat-icon>
+        </div>
+        <div class="swrv-trigger__text">
+          <div class="swrv-trigger__title">Run a live backend validation</div>
+          <div class="swrv-trigger__sub">
+            Re-checks account status, share balance, linked savings account and GL mapping before you approve.
+          </div>
+        </div>
+        <button type="button" class="pg-btn pg-btn--primary" (click)="openValidateModal()">
+          <mat-icon>play_circle</mat-icon>
+          Validate Request
+        </button>
+      </div>
+
+      <div class="inv-form-actions">
+        <button type="button" class="pg-btn pg-btn--primary" (click)="approveReview()">
+          <mat-icon>check_circle</mat-icon>
+          Approve &amp; Process Withdrawal
+        </button>
+        <button type="button" class="pg-btn pg-btn--danger" (click)="openRejectDialog()">
+          <mat-icon>cancel</mat-icon>
+          Reject
+        </button>
+      </div>
+    </div>
+  }
+
+  @if (showValidateModal) {
+    <div class="swrv-modal">
+      <div class="swrv-modal__card">
+        <div class="swrv-modal__header">
+          <div class="swrv-modal__title">
+            <span class="swrv-modal__title-icon"><mat-icon>fact_check</mat-icon></span>
+            Validate Share Withdrawal Request
+          </div>
+          <button type="button" class="swrv-modal__close" [disabled]="validating" (click)="closeValidateModal()">
+            <mat-icon>close</mat-icon>
+          </button>
+        </div>
+
+        <div class="swrv-modal__body">
+          <p class="swrv-modal__intro">
+            Re-checking <strong>{{ requestedShares }} share(s)</strong> withdrawal from
+            <strong>{{ account?.accountNo }}</strong> ({{ account?.clientName }}) against the live account, savings link
+            and GL configuration — not just what was captured at submission time.
+          </p>
+
+          @if (backendChecks && !validating && !validateAllPassed) {
+            <div class="swrv-modal__warn">
+              <mat-icon>warning</mat-icon>
+              <div>
+                <strong>Some checks need review before approving.</strong>
+                Scroll down to see which ones failed and why.
+              </div>
+            </div>
+          }
+
+          <ol class="swrv-steps">
+            @for (step of validateSteps; track step.label; let i = $index) {
+              <li
+                class="swrv-step"
+                [class.swrv-step--active]="step.status === 'active'"
+                [class.swrv-step--done]="step.status === 'done'"
+                [class.swrv-step--failed]="step.status === 'failed'"
+              >
+                <div class="swrv-step__indicator">
+                  @if (step.status === 'done') {
+                    <mat-icon>check</mat-icon>
+                  } @else if (step.status === 'active') {
+                    <mat-icon class="swrv-spin">autorenew</mat-icon>
+                  } @else if (step.status === 'failed') {
+                    <mat-icon>close</mat-icon>
+                  } @else {
+                    <span>{{ i + 1 }}</span>
+                  }
+                </div>
+                <div class="swrv-step__content">
+                  <div class="swrv-step__label">{{ step.label }}</div>
+                  <div class="swrv-step__msg">{{ step.detail }}</div>
+                </div>
+              </li>
+            }
+          </ol>
+
+          @if (validating && validateSteps.length === 0) {
+            <div class="pg-empty">Connecting to server…</div>
+          }
+
+          @if (backendChecks && !validating && validateAllPassed) {
+            <div class="swrv-modal__result">
+              <mat-icon>verified</mat-icon>
+              <span>All checks passed — safe to approve.</span>
+            </div>
+          }
+        </div>
+
+        <div class="swrv-modal__footer">
+          @if (!validating && backendChecks) {
+            <button type="button" class="pg-btn" (click)="runBackendValidation()">
+              <mat-icon>refresh</mat-icon>
+              Re-run
+            </button>
+          }
+          @if (!validating && backendChecks && validateAllPassed) {
+            <button type="button" class="pg-btn pg-btn--primary" (click)="closeValidateModal(); approveReview()">
+              <mat-icon>check_circle</mat-icon>
+              Approve &amp; Process Withdrawal
+            </button>
+          }
+          <button type="button" class="pg-btn" [disabled]="validating" (click)="closeValidateModal()">
+            {{ validating ? 'Validating…' : 'Close' }}
+          </button>
+        </div>
+      </div>
+    </div>
+  }
+
+  @if (isReview && reviewRequest?.status === 'APPROVED') {
+    <div class="pg-card">
+      <div class="pos-section-label">Settlement</div>
+      <div class="inv-form-grid" style="padding: 16px">
+        @if (reviewRequest?.settlement_amount) {
+          <label class="inv-form-field">
+            <span>Amount Credited</span>
+            <input type="text" [value]="'₹' + (reviewRequest.settlement_amount | number: '1.2-2')" readonly />
+          </label>
+          <label class="inv-form-field">
+            <span>Credited To (Linked Savings A/C)</span>
+            <input type="text" [value]="account?.savingsAccountNumber || '—'" readonly />
+          </label>
+          <label class="inv-form-field">
+            <span>Savings Transaction Ref.</span>
+            <input type="text" [value]="reviewRequest.settlement_savings_transaction_id" readonly />
+          </label>
+        } @else {
+          <div class="pg-empty" style="grid-column: span 2">
+            Settlement is processed automatically on approval. Details aren't available when reopening an
+            already-approved request — check the linked savings account's transaction history to confirm.
+          </div>
+        }
+      </div>
+    </div>
+  }
+
+  @if (isReview && activityLog.length > 0) {
+    <div class="pg-card">
+      <div class="pos-section-label">Activity Log</div>
+      <table class="pg-table">
+        <thead>
+          <tr>
+            <th>Timestamp</th>
+            <th>Action</th>
+            <th>User</th>
+            <th>Note</th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (entry of activityLog; track entry.timestamp) {
+            <tr>
+              <td>{{ entry.timestamp | date: 'medium' }}</td>
+              <td>{{ entry.action }}</td>
+              <td>{{ entry.user }}</td>
+              <td>{{ entry.note || '—' }}</td>
+            </tr>
+          }
+        </tbody>
+      </table>
+    </div>
+  }
+
+  @if (showConfirmDialog) {
+    <div class="swr-modal-backdrop">
+      <div class="swr-modal">
+        <h3>Confirm Share Withdrawal Request</h3>
+        <p class="pg-sub">Review the details below before submitting for Bank Manager approval.</p>
+        <table class="pg-table">
+          <tbody>
+            <tr>
+              <td>Account No / Client</td>
+              <td>{{ account?.accountNo }} — {{ account?.clientName }}</td>
+            </tr>
+            <tr>
+              <td>Shares to Withdraw</td>
+              <td>
+                {{ requestedShares }} @ ₹{{ unitPrice | number: '1.2-2' }} = ₹{{ withdrawalValue | number: '1.2-2' }}
+              </td>
+            </tr>
+            <tr>
+              <td>Remaining Shares After Withdrawal</td>
+              <td>{{ remainingShares }}</td>
+            </tr>
+            <tr>
+              <td>Requested Date</td>
+              <td>{{ requestedDate }}</td>
+            </tr>
+            <tr>
+              <td>Board Resolution Number</td>
+              <td>{{ resolutionNumber }}</td>
+            </tr>
+            <tr>
+              <td>Date of Meeting</td>
+              <td>{{ meetingDate }}</td>
+            </tr>
+            <tr>
+              <td>Settlement Payment Type</td>
+              <td>{{ settlementPaymentTypeName }}</td>
+            </tr>
+            <tr>
+              <td>Linked Savings Account</td>
+              <td>{{ account?.savingsAccountNumber || 'None — settlement will not run automatically' }}</td>
+            </tr>
+          </tbody>
+        </table>
+
+        <div class="pos-section-label" style="margin-top: 12px">Validation Checks</div>
+        <table class="pg-table">
+          <tbody>
+            @for (check of verificationChecks; track check.label) {
+              <tr>
+                <td>{{ check.label }}</td>
+                <td [class.swr-check-pass]="check.pass" [class.swr-check-fail]="!check.pass">
+                  {{ check.pass ? 'Pass — ' : 'Review — ' }}{{ check.detail }}
+                </td>
+              </tr>
+            }
+          </tbody>
+        </table>
+
+        <div class="inv-form-actions">
+          <button type="button" class="pg-btn pg-btn--primary" [disabled]="submitting" (click)="confirmSubmit()">
+            {{ submitting ? 'Submitting…' : 'Confirm & Submit' }}
+          </button>
+          <button type="button" class="pg-btn" (click)="cancelConfirmDialog()">Back to Edit</button>
+        </div>
+      </div>
+    </div>
+  }
+
+  @if (showRejectDialog) {
+    <div class="swr-modal-backdrop">
+      <div class="swr-modal">
+        <h3>Reject Share Withdrawal Request</h3>
+        <label class="inv-form-field">
+          <span>* Rejection Reason</span>
+          <textarea rows="3" [(ngModel)]="rejectionReason"></textarea>
+        </label>
+        <div class="inv-form-actions">
+          <button
+            type="button"
+            class="pg-btn pg-btn--danger"
+            [disabled]="!rejectionReason.trim()"
+            (click)="confirmRejectReview()"
+          >
+            Confirm Reject
+          </button>
+          <button type="button" class="pg-btn" (click)="showRejectDialog = false">Cancel</button>
+        </div>
+      </div>
+    </div>
+  }
+</div>

src/app/clerk/share-withdrawal-request/share-withdrawal-request.component.scss

@@ -0,0 +1,433 @@
+/**
+ * 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/.
+ */
+
+.swr-modal-backdrop {
+  position: fixed;
+  inset: 0;
+  background: rgb(13 27 42 / 55%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+}
+
+.swr-modal {
+  background: #fff;
+  border-radius: 12px;
+  padding: 20px;
+  width: 420px;
+  max-width: 90vw;
+  max-height: 85vh;
+  overflow-y: auto;
+  box-shadow: 0 12px 32px rgb(15 23 42 / 20%);
+
+  h3 {
+    margin: 0 0 12px;
+    font-size: 16px;
+    color: #0d1b2a;
+  }
+
+  textarea {
+    width: 100%;
+    padding: 8px 10px;
+    border: 1px solid #e2e8f0;
+    border-radius: 8px;
+    font-family: inherit;
+    font-size: 13px;
+    resize: vertical;
+    box-sizing: border-box;
+  }
+
+  &:has(table) {
+    width: 560px;
+  }
+}
+
+.swr-check-pass {
+  color: #1a7f37;
+  font-weight: 600;
+}
+
+.swr-check-fail {
+  color: #b42318;
+  font-weight: 600;
+}
+
+.swr-chip {
+  display: inline-flex;
+  align-items: center;
+  width: fit-content;
+  padding: 4px 10px;
+  border-radius: 999px;
+  font-size: 12px;
+  font-weight: 600;
+
+  &--ok {
+    background: #eafaf0;
+    color: #1a7f37;
+  }
+
+  &--warn {
+    background: #fdecea;
+    color: #b42318;
+  }
+}
+
+/* ---------- Verification trigger card ---------- */
+.swrv-trigger {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  padding: 16px;
+  flex-wrap: wrap;
+
+  &__icon {
+    width: 42px;
+    height: 42px;
+    border-radius: 12px;
+    background: linear-gradient(135deg, #3457d5, #6c8cff);
+    color: #fff;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+    box-shadow: 0 4px 12px rgb(52 87 213 / 30%);
+  }
+
+  &__text {
+    flex: 1;
+    min-width: 200px;
+  }
+
+  &__title {
+    font-size: 13px;
+    font-weight: 700;
+    color: #0d1b2a;
+  }
+
+  &__sub {
+    font-size: 12px;
+    color: #64748b;
+    margin-top: 2px;
+    line-height: 1.4;
+  }
+}
+
+/* ---------- Validate pipeline modal ---------- */
+@keyframes swrv-fade {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes swrv-zoom {
+  from {
+    opacity: 0;
+    transform: scale(0.95) translateY(8px);
+  }
+
+  to {
+    opacity: 1;
+    transform: scale(1) translateY(0);
+  }
+}
+
+@keyframes swrv-spin {
+  from {
+    transform: rotate(0deg);
+  }
+
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+.swrv-spin {
+  animation: swrv-spin 0.9s linear infinite;
+}
+
+.swrv-modal {
+  position: fixed;
+  inset: 0;
+  // No backdrop-filter: it would make this element a containing block for any position:fixed
+  // descendant (e.g. if this modal is ever nested inside another fixed popup, or gains one of its
+  // own later) — see the identical fix in share-withdrawal-requests.component.scss for the bug this
+  // caused. Extra opacity compensates for the loss of the blur look.
+  background: rgb(15 25 45 / 65%);
+  z-index: 1200;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 20px;
+  animation: swrv-fade 0.2s ease-out;
+
+  &__card {
+    background: #fff;
+    border-radius: 16px;
+    width: 100%;
+    max-width: 520px;
+    max-height: 90vh;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    box-shadow: 0 24px 60px rgb(0 0 0 / 25%);
+    animation: swrv-zoom 0.25s ease-out;
+  }
+
+  &__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 18px 22px;
+    border-bottom: 1px solid #eef1f5;
+  }
+
+  &__title {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    font-size: 15px;
+    font-weight: 700;
+    color: #0d1b2a;
+  }
+
+  &__title-icon {
+    width: 34px;
+    height: 34px;
+    border-radius: 10px;
+    background: linear-gradient(135deg, #3457d5, #6c8cff);
+    color: #fff;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+  }
+
+  &__close {
+    width: 32px;
+    height: 32px;
+    border-radius: 8px;
+    border: 1px solid #e2e8f0;
+    background: #fff;
+    color: #64748b;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all 0.12s;
+
+    &:not(:disabled):hover {
+      color: #b42318;
+      border-color: #b42318;
+      background: #fdecea;
+    }
+
+    &:disabled {
+      opacity: 0.4;
+      cursor: not-allowed;
+    }
+  }
+
+  &__body {
+    padding: 20px 22px;
+    overflow-y: auto;
+    flex: 1;
+  }
+
+  &__intro {
+    font-size: 13px;
+    color: #475569;
+    line-height: 1.55;
+    margin: 0 0 16px;
+
+    strong {
+      color: #0d1b2a;
+      font-weight: 700;
+    }
+  }
+
+  &__warn {
+    display: flex;
+    gap: 10px;
+    padding: 12px 14px;
+    background: #fef3e2;
+    border: 1px solid rgb(217 119 6 / 30%);
+    border-left: 3px solid #d97706;
+    border-radius: 8px;
+    margin-bottom: 16px;
+    font-size: 12px;
+    color: #633806;
+    line-height: 1.5;
+
+    mat-icon {
+      color: #d97706;
+      font-size: 18px;
+      width: 18px;
+      height: 18px;
+      flex-shrink: 0;
+    }
+
+    strong {
+      display: block;
+      font-weight: 700;
+      color: #4d2a05;
+    }
+  }
+
+  &__result {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-top: 6px;
+    padding: 12px 14px;
+    background: #eafaf0;
+    border: 1px solid rgb(26 127 55 / 25%);
+    border-radius: 8px;
+    font-size: 13px;
+    font-weight: 600;
+    color: #1a7f37;
+
+    mat-icon {
+      font-size: 18px;
+      width: 18px;
+      height: 18px;
+    }
+  }
+
+  &__footer {
+    padding: 16px 22px;
+    border-top: 1px solid #eef1f5;
+    display: flex;
+    justify-content: flex-end;
+    gap: 10px;
+    background: #f8fafc;
+  }
+}
+
+.swrv-steps {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+}
+
+.swrv-step {
+  display: flex;
+  gap: 14px;
+  padding: 10px 0;
+  position: relative;
+
+  &:not(:last-child)::after {
+    content: '';
+    position: absolute;
+    left: 15px;
+    top: 38px;
+    bottom: -4px;
+    width: 2px;
+    background: #e2e8f0;
+  }
+
+  &__indicator {
+    width: 32px;
+    height: 32px;
+    border-radius: 50%;
+    background: #fff;
+    border: 2px solid #e2e8f0;
+    color: #64748b;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 12px;
+    font-weight: 700;
+    flex-shrink: 0;
+    position: relative;
+    z-index: 1;
+    transition: all 0.25s;
+
+    mat-icon {
+      font-size: 16px;
+      width: 16px;
+      height: 16px;
+    }
+  }
+
+  &__content {
+    padding-top: 5px;
+    flex: 1;
+    min-width: 0;
+  }
+
+  &__label {
+    font-size: 13px;
+    font-weight: 600;
+    color: #475569;
+  }
+
+  &__msg {
+    font-size: 11px;
+    color: #94a3b8;
+    margin-top: 2px;
+  }
+
+  &--active {
+    .swrv-step__indicator {
+      background: #3457d5;
+      border-color: #3457d5;
+      color: #fff;
+      box-shadow: 0 0 0 4px rgb(52 87 213 / 15%);
+    }
+
+    .swrv-step__label {
+      color: #3457d5;
+    }
+  }
+
+  &--done {
+    .swrv-step__indicator {
+      background: #1a7f37;
+      border-color: #1a7f37;
+      color: #fff;
+    }
+
+    &::after {
+      background: #1a7f37;
+    }
+
+    .swrv-step__label {
+      color: #0d1b2a;
+    }
+  }
+
+  &--failed {
+    .swrv-step__indicator {
+      background: #b42318;
+      border-color: #b42318;
+      color: #fff;
+    }
+
+    .swrv-step__label {
+      color: #b42318;
+    }
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .swrv-spin {
+    animation: none;
+  }
+
+  .swrv-modal,
+  .swrv-modal__card {
+    animation: none;
+  }
+}

src/app/clerk/share-withdrawal-request/share-withdrawal-request.component.ts

@@ -0,0 +1,416 @@
+/**
+ * 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, EventEmitter, Input, OnInit, Output, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormsModule } from '@angular/forms';
+import { ActivatedRoute, Router, RouterModule } from '@angular/router';
+import { MatIconModule } from '@angular/material/icon';
+import { MatSnackBar, MatSnackBarModule } from '@angular/material/snack-bar';
+import { catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+
+import { SharesService } from '../../shares/shares.service';
+import { ClerkShareWithdrawalService } from '../../cashier/clerk-share-withdrawal.service';
+import { CashierService } from '../../cashier/cashier.service';
+import { SearchSelectComponent, SearchSelectOption } from '../../shared/search-select/search-select.component';
+
+export type ShareWdMode = 'create' | 'review';
+
+interface ActivityEntry {
+  timestamp: string;
+  action: string;
+  user: string;
+  note?: string;
+}
+
+/**
+ * Share Withdrawal (redeem shares) request — maker screen in the Clerk Dashboard. A clerk finds
+ * the member's Share Account, enters how many shares to withdraw plus the governing Board
+ * Resolution Number / Date of Meeting, and submits for Bank Manager approval. This is the ONLY
+ * entry point a share withdrawal should go through — approval server-side executes the real
+ * "redeemshares" command (see ClerkShareWithdrawalRequestApiResource on the backend).
+ */
+@Component({
+  selector: 'mifosx-share-withdrawal-request',
+  templateUrl: './share-withdrawal-request.component.html',
+  styleUrls: [
+    '../../cashier/cashier-shared.scss',
+    '../clerk-shared.scss',
+    './share-withdrawal-request.component.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    RouterModule,
+    MatIconModule,
+    MatSnackBarModule,
+    SearchSelectComponent
+  ]
+})
+export class ShareWithdrawalRequestComponent implements OnInit {
+  private route = inject(ActivatedRoute);
+  private router = inject(Router);
+  private sharesService = inject(SharesService);
+  private wdService = inject(ClerkShareWithdrawalService);
+  private cashierService = inject(CashierService);
+  private snackBar = inject(MatSnackBar);
+
+  /** When embedded (e.g. opened as a popup from a list screen instead of routed to directly), mode
+   *  and requestId come from these inputs rather than the route, and success/close actions emit
+   *  events instead of navigating away. */
+  @Input() embedded = false;
+  @Input() overrideMode: ShareWdMode | null = null;
+  @Input() overrideRequestId: number | null = null;
+  @Output() closeRequested = new EventEmitter<void>();
+  @Output() actionCompleted = new EventEmitter<void>();
+
+  mode: ShareWdMode = 'create';
+  requestId: number | null = null;
+
+  submitting = false;
+  loadingAccount = false;
+
+  selectedAccountId = '';
+  accountOptions: SearchSelectOption[] = [];
+
+  account: any = null;
+
+  requestedShares: number | null = null;
+  requestedDate = '';
+  resolutionNumber = '';
+  meetingDate = '';
+  description = '';
+
+  paymentTypes: any[] = [];
+  settlementPaymentTypeId: number | null = null;
+
+  activityLog: ActivityEntry[] = [];
+  reviewRequest: any = null;
+  showRejectDialog = false;
+  rejectionReason = '';
+  showConfirmDialog = false;
+
+  showValidateModal = false;
+  validating = false;
+  validateAllPassed = false;
+  backendChecks: { label: string; pass: boolean; detail: string }[] | null = null;
+  validateSteps: { label: string; detail: string; pass: boolean; status: 'pending' | 'active' | 'done' | 'failed' }[] =
+    [];
+
+  get remainingShares(): number {
+    const held = Number(this.account?.summary?.totalApprovedShares ?? this.account?.totalApprovedShares ?? 0);
+    return held - (this.requestedShares || 0);
+  }
+
+  get unitPrice(): number {
+    return Number(this.account?.currentMarketPrice ?? 0);
+  }
+
+  get withdrawalValue(): number {
+    return (this.requestedShares || 0) * this.unitPrice;
+  }
+
+  get paymentTypeOptions(): any[] {
+    return this.paymentTypes.filter((pt: any) => !pt.isCashPayment);
+  }
+
+  get selectedSettlementPaymentType(): any {
+    return this.paymentTypes.find((pt: any) => pt.id === this.settlementPaymentTypeId);
+  }
+
+  get settlementPaymentTypeName(): string {
+    if (this.isReview) {
+      return this.reviewRequest?.settlement_payment_type_name || '—';
+    }
+    return this.selectedSettlementPaymentType?.name || '—';
+  }
+
+  get isFormValid(): boolean {
+    if (!this.account) return false;
+    if (!this.requestedShares || this.requestedShares <= 0) return false;
+    const held = Number(this.account?.summary?.totalApprovedShares ?? this.account?.totalApprovedShares ?? 0);
+    if (this.requestedShares > held) return false;
+    if (!this.requestedDate) return false;
+    if (!this.resolutionNumber.trim()) return false;
+    if (!this.meetingDate) return false;
+    if (!this.settlementPaymentTypeId) return false;
+    return true;
+  }
+
+  /** Shown to the clerk before submit and to the manager before approval, so both can verify the same checks. */
+  get verificationChecks(): { label: string; pass: boolean; detail: string }[] {
+    const held = Number(this.account?.summary?.totalApprovedShares ?? this.account?.totalApprovedShares ?? 0);
+    const shares = this.requestedShares || 0;
+    return [
+      {
+        label: 'Board Resolution Number provided',
+        pass: !!this.resolutionNumber?.trim(),
+        detail: this.resolutionNumber?.trim() || 'Missing'
+      },
+      { label: 'Date of Meeting provided', pass: !!this.meetingDate, detail: this.meetingDate || 'Missing' },
+      {
+        label: 'Shares requested within shares held',
+        pass: shares > 0 && shares <= held,
+        detail: `${shares} of ${held} shares held`
+      },
+      {
+        label: 'Linked savings account confirmed',
+        pass: !!this.account?.savingsAccountNumber,
+        detail: this.account?.savingsAccountNumber || 'No linked savings account — settlement cannot run automatically'
+      },
+      {
+        label: 'Settlement Payment Type selected (non-cash)',
+        pass: this.settlementPaymentTypeName !== '—',
+        detail: this.settlementPaymentTypeName
+      }
+    ];
+  }
+
+  get isReview(): boolean {
+    return this.mode === 'review';
+  }
+
+  get pageTitle(): string {
+    return this.isReview ? 'Review Share Withdrawal Request' : 'New Share Withdrawal Request';
+  }
+
+  get pageSubtitle(): string {
+    return this.isReview
+      ? "Approve or reject the clerk's share withdrawal request."
+      : 'Submit a share withdrawal (redeem shares) request for Bank Manager approval.';
+  }
+
+  ngOnInit(): void {
+    this.mode = this.overrideMode ?? (this.route.snapshot.data?.['mode'] as ShareWdMode) ?? 'create';
+    const idParam = this.overrideRequestId ?? this.route.snapshot.params?.['id'];
+    this.requestId = idParam ? Number(idParam) : null;
+
+    const today = new Date();
+    this.requestedDate = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, '0')}-${String(today.getDate()).padStart(2, '0')}`;
+    this.meetingDate = this.requestedDate;
+
+    this.sharesService
+      .getShareAccountSummaries()
+      .pipe(catchError(() => of([])))
+      .subscribe((rows: any[]) => {
+        this.accountOptions = (rows || [])
+          .filter((r) => (r.status?.value || '').toLowerCase() === 'active')
+          .map((r) => ({
+            value: String(r.id),
+            label: `${r.accountNo} — ${r.clientName} (${r.totalApprovedShares} shares)`,
+            searchText: `${r.accountNo} ${r.clientName}`
+          }));
+      });
+
+    this.cashierService
+      .getPaymentTypes()
+      .pipe(catchError(() => of([])))
+      .subscribe((types: any[]) => (this.paymentTypes = types ?? []));
+
+    if (this.requestId && this.mode === 'review') {
+      this.loadReviewRequest(this.requestId);
+    }
+  }
+
+  onAccountSelected(accountId: string): void {
+    this.selectedAccountId = accountId;
+    if (!accountId) {
+      this.account = null;
+      return;
+    }
+    this.loadingAccount = true;
+    this.sharesService
+      .getSharesAccountData(accountId, false)
+      .pipe(catchError(() => of(null)))
+      .subscribe((acc: any) => {
+        this.account = acc;
+        this.loadingAccount = false;
+      });
+  }
+
+  private loadReviewRequest(id: number): void {
+    this.wdService.getById(id).subscribe({
+      next: (req: any) => {
+        this.reviewRequest = req;
+        this.requestedShares = Number(req.requested_shares);
+        this.requestedDate = req.requested_date
+          ? String(req.requested_date).split('T')[0].split(' ')[0]
+          : this.requestedDate;
+        this.resolutionNumber = req.resolution_number ?? '';
+        this.meetingDate = req.meeting_date ? String(req.meeting_date).split('T')[0].split(' ')[0] : this.meetingDate;
+        this.description = req.description ?? '';
+
+        if (req.activity_log) {
+          try {
+            this.activityLog = JSON.parse(req.activity_log);
+          } catch {
+            this.activityLog = [];
+          }
+        }
+
+        this.sharesService
+          .getSharesAccountData(String(req.share_account_id), false)
+          .pipe(catchError(() => of(null)))
+          .subscribe((acc: any) => (this.account = acc));
+      },
+      error: () => this.snackBar.open('Failed to load share withdrawal request.', 'Close', { duration: 5000 })
+    });
+  }
+
+  /** "Review before Save" per requirement — opens the confirm dialog instead of submitting directly. */
+  openConfirmDialog(): void {
+    if (!this.isFormValid || this.submitting) {
+      return;
+    }
+    this.showConfirmDialog = true;
+  }
+
+  cancelConfirmDialog(): void {
+    this.showConfirmDialog = false;
+  }
+
+  confirmSubmit(): void {
+    this.showConfirmDialog = false;
+    this.submitting = true;
+    const payload = {
+      shareAccountId: Number(this.selectedAccountId),
+      accountNo: this.account?.accountNo,
+      clientId: this.account?.clientId,
+      clientName: this.account?.clientName,
+      requestedShares: this.requestedShares,
+      requestedDate: this.requestedDate,
+      resolutionNumber: this.resolutionNumber.trim(),
+      meetingDate: this.meetingDate,
+      description: this.description,
+      settlementPaymentTypeId: this.settlementPaymentTypeId
+    };
+    this.wdService.submit(payload).subscribe({
+      next: () => {
+        this.snackBar.open('Share withdrawal request submitted for approval.', 'Close', { duration: 4000 });
+        if (this.embedded) {
+          this.actionCompleted.emit();
+        } else {
+          this.router.navigate(['/clerk/dashboard']);
+        }
+      },
+      error: (err) => {
+        this.submitting = false;
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not submit the request.', 'Close', {
+          duration: 6000
+        });
+      }
+    });
+  }
+
+  openValidateModal(): void {
+    if (!this.reviewRequest) return;
+    this.showValidateModal = true;
+    this.runBackendValidation();
+  }
+
+  closeValidateModal(): void {
+    if (this.validating) return;
+    this.showValidateModal = false;
+  }
+
+  /** Re-checks live backend state (account still active, GL mapping still configured, etc.) rather
+   *  than relying on data already loaded in the browser — catches drift since submission. Results
+   *  are revealed one step at a time (see revealValidateSteps()) for the pipeline-style animation. */
+  runBackendValidation(): void {
+    if (!this.reviewRequest || this.validating) return;
+    this.validating = true;
+    this.backendChecks = null;
+    this.validateSteps = [];
+    this.wdService.validate(this.reviewRequest.id).subscribe({
+      next: (res: any) => {
+        const checks = (res?.checks ?? []) as { label: string; pass: boolean; detail: string }[];
+        this.backendChecks = checks;
+        this.validateAllPassed = !!res?.allPassed;
+        this.validateSteps = checks.map((c) => ({ ...c, status: 'pending' as const }));
+        this.revealValidateSteps(0);
+      },
+      error: (err) => {
+        this.validating = false;
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not run backend validation.', 'Close', {
+          duration: 6000
+        });
+      }
+    });
+  }
+
+  private revealValidateSteps(index: number): void {
+    if (index >= this.validateSteps.length) {
+      this.validating = false;
+      return;
+    }
+    this.validateSteps[index].status = 'active';
+    setTimeout(() => {
+      this.validateSteps[index].status = this.validateSteps[index].pass ? 'done' : 'failed';
+      this.revealValidateSteps(index + 1);
+    }, 320);
+  }
+
+  approveReview(): void {
+    if (!this.reviewRequest) return;
+    this.wdService.approve(this.reviewRequest.id).subscribe({
+      next: (res: any) => {
+        let message =
+          res?.settlementAmount != null
+            ? `Share withdrawal approved. ₹${Number(res.settlementAmount).toLocaleString('en-IN', { minimumFractionDigits: 2 })} credited to the linked savings account.`
+            : (res?.settlementWarning ?? 'Share withdrawal approved and processed.');
+        if (res?.autoClosureRequestId) {
+          message += ' All shares now withdrawn — a Share Closure Request was auto-submitted for manager review.';
+        }
+        this.snackBar.open(message, 'Close', { duration: 8000 });
+        if (this.embedded) {
+          this.actionCompleted.emit();
+        } else {
+          this.router.navigate(['/checker-inbox-and-tasks/share-withdrawal-requests']);
+        }
+      },
+      error: (err) =>
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not approve the request.', 'Close', {
+          duration: 6000
+        })
+    });
+  }
+
+  openRejectDialog(): void {
+    this.showRejectDialog = true;
+    this.rejectionReason = '';
+  }
+
+  confirmRejectReview(): void {
+    if (!this.reviewRequest || !this.rejectionReason.trim()) return;
+    this.wdService.reject(this.reviewRequest.id, this.rejectionReason.trim()).subscribe({
+      next: () => {
+        this.showRejectDialog = false;
+        this.snackBar.open('Share withdrawal request rejected.', 'Close', { duration: 4000 });
+        if (this.embedded) {
+          this.actionCompleted.emit();
+        } else {
+          this.router.navigate(['/checker-inbox-and-tasks/share-withdrawal-requests']);
+        }
+      },
+      error: (err) =>
+        this.snackBar.open(err?.error?.defaultUserMessage || 'Could not reject the request.', 'Close', {
+          duration: 6000
+        })
+    });
+  }
+
+  goBack(): void {
+    if (this.embedded) {
+      this.closeRequested.emit();
+      return;
+    }
+    this.router.navigate(this.isReview ? ['/checker-inbox-and-tasks/share-withdrawal-requests'] : ['/clerk/dashboard']);
+  }
+}

src/app/clients/client-stepper/client-family-members-step/client-family-member-child-dialog/client-family-member-child-dialog.component.html

@@ -0,0 +1,90 @@
+<div class="fm-dialog">
+  <div class="fm-dialog__header" style="display: flex; align-items: center; gap: 8px;">
+    <mat-icon class="fm-dialog__icon">people</mat-icon>
+    <span style="font-weight: 500; font-size: 18px;">CHILDREN</span>
+  </div>
+
+  <mat-dialog-content>
+    <form [formGroup]="childrenForm">
+      <div formArrayName="children" style="margin-top: 12px; background: #fff; padding: 12px;">
+        @for (child of children.controls; track $index) {
+        <div [formGroupName]="$index"
+          style="position: relative; padding: 24px 16px 16px; margin-top: 16px; margin-bottom: 24px; border: 1px solid #e0e0e0; border-radius: 8px; background: #fff;">
+          <div class="fm-grid">
+            <mat-form-field appearance="outline">
+              <mat-label>Child Full Name*</mat-label>
+              <input matInput formControlName="fullName" required placeholder="Child Full Name*" />
+            </mat-form-field>
+            <mat-form-field appearance="outline">
+              <mat-label>Gender*</mat-label>
+              <mat-select formControlName="genderId" required>
+                @for (g of genderIdOptions; track g.id) {
+                <mat-option [value]="g.id">{{ g.name }}</mat-option>
+                }
+              </mat-select>
+            </mat-form-field>
+            <mat-form-field appearance="outline" (click)="childDobPicker.open()">
+              <mat-label>Date of Birth</mat-label>
+              <input matInput [max]="maxDate" [matDatepicker]="childDobPicker" formControlName="dateOfBirth" />
+              <mat-datepicker-toggle matSuffix [for]="childDobPicker"></mat-datepicker-toggle>
+              <mat-datepicker #childDobPicker></mat-datepicker>
+            </mat-form-field>
+            <mat-form-field appearance="outline">
+              <mat-label>Nationality</mat-label>
+              <mat-select formControlName="nationality">
+                <mat-option value="INDIAN">Indian</mat-option>
+                <mat-option value="NRI">NRI</mat-option>
+                <mat-option value="FOREIGN_NATIONAL">Foreign National</mat-option>
+                <mat-option value="OTHER">Other</mat-option>
+              </mat-select>
+            </mat-form-field>
+            <mat-form-field appearance="outline">
+              <mat-label>Aadhaar Number (Optional)</mat-label>
+              <input
+                matInput
+                formControlName="aadhaarNumber"
+                maxlength="12"
+                placeholder="12-digit Aadhaar"
+                (keypress)="$event.charCode >= 48 && $event.charCode <= 57 ? true : $event.preventDefault()"
+              />
+            </mat-form-field>
+            <mat-form-field appearance="outline">
+              <mat-label>PAN Number (Optional)</mat-label>
+              <input
+                matInput
+                formControlName="panNumber"
+                maxlength="10"
+                placeholder="ABCDE1234F"
+                style="text-transform: uppercase"
+                (input)="
+                  $any(children.at($index)).get('panNumber')
+                    ?.setValue($any($event.target).value.toUpperCase(), { emitEvent: false })
+                "
+              />
+              @if (
+                $any(children.at($index)).get('panNumber')?.hasError('pattern') && $any(children.at($index)).get('panNumber')?.touched
+              ) {
+                <mat-error>Invalid PAN format</mat-error>
+              }
+            </mat-form-field>
+          </div>
+        </div>
+        @if ($index < children.controls.length - 1) { <div style="border-bottom: 1px dashed #ccc; margin-bottom: 16px;">
+      </div>
+      }
+      }
+      <div style="border-bottom: 1px dashed #ccc; margin-bottom: 16px;"></div>
+      <button mat-stroked-button type="button" color="primary" (click)="addChild()">
+        <mat-icon>add</mat-icon> Add Another Child
+      </button>
+</div>
+</form>
+</mat-dialog-content>
+
+<mat-dialog-actions align="end">
+  <button mat-stroked-button mat-dialog-close type="button">Cancel</button>
+  <button mat-flat-button color="primary" type="button" [disabled]="childrenForm.invalid" (click)="submit()">
+    Add Member
+  </button>
+</mat-dialog-actions>
+</div>

src/app/clients/client-stepper/client-family-members-step/client-family-member-child-dialog/client-family-member-child-dialog.component.ts

@@ -0,0 +1,98 @@
+import { Component, Inject, OnInit } from '@angular/core';
+import { MAT_DIALOG_DATA, MatDialogRef } from '@angular/material/dialog';
+import { UntypedFormBuilder, UntypedFormGroup, UntypedFormArray, Validators } from '@angular/forms';
+
+import { MatIcon } from '@angular/material/icon';
+import { MatButtonModule } from '@angular/material/button';
+import { MatInputModule } from '@angular/material/input';
+import { MatSelectModule } from '@angular/material/select';
+import { MatDatepickerModule } from '@angular/material/datepicker';
+import { MatDialogModule } from '@angular/material/dialog';
+import { MatTooltipModule } from '@angular/material/tooltip';
+import { ReactiveFormsModule } from '@angular/forms';
+import { CommonModule } from '@angular/common';
+
+@Component({
+  selector: 'cbs-client-family-member-child-dialog',
+  templateUrl: './client-family-member-child-dialog.component.html',
+  styleUrls: ['../client-family-member-dialog/client-family-member-dialog.component.scss'],
+  standalone: true,
+  imports: [
+    CommonModule,
+    ReactiveFormsModule,
+    MatDialogModule,
+    MatIcon,
+    MatButtonModule,
+    MatInputModule,
+    MatSelectModule,
+    MatDatepickerModule,
+    MatTooltipModule
+  ]
+})
+export class ClientFamilyMemberChildDialogComponent implements OnInit {
+
+  childrenForm: UntypedFormGroup;
+  genderIdOptions: any[];
+  maxDate: Date = new Date();
+
+  constructor(
+    public dialogRef: MatDialogRef<ClientFamilyMemberChildDialogComponent>,
+    @Inject(MAT_DIALOG_DATA) public data: any,
+    private formBuilder: UntypedFormBuilder
+  ) {
+    this.genderIdOptions = data.genderIdOptions;
+    
+    this.childrenForm = this.formBuilder.group({
+      children: this.formBuilder.array([])
+    });
+  }
+
+  ngOnInit() {
+    if (this.data.children && this.data.children.length > 0) {
+      this.data.children.forEach((child: any) => {
+        this.children.push(this.formBuilder.group({
+          id: [child.id],
+          fullName: [child.fullName, Validators.required],
+          genderId: [child.genderId, Validators.required],
+          dateOfBirth: [child.dateOfBirth ? new Date(child.dateOfBirth) : ''],
+          nationality: [child.nationality || 'INDIAN'],
+          aadhaarNumber: [child.aadhaarNumber || ''],
+          panNumber: [child.panNumber || '', Validators.pattern(/^[A-Z]{5}[0-9]{4}[A-Z]{1}$/)]
+        }));
+      });
+    } else {
+      this.addChild();
+    }
+  }
+
+  get children(): UntypedFormArray {
+    return this.childrenForm.get('children') as UntypedFormArray;
+  }
+
+  createChildFormGroup(): UntypedFormGroup {
+    return this.formBuilder.group({
+      id: [''],
+      fullName: ['', Validators.required],
+      genderId: ['', Validators.required],
+      dateOfBirth: [''],
+      nationality: ['INDIAN'],
+      aadhaarNumber: [''],
+      panNumber: ['', Validators.pattern(/^[A-Z]{5}[0-9]{4}[A-Z]{1}$/)]
+    });
+  }
+
+  addChild(): void {
+    this.children.push(this.createChildFormGroup());
+  }
+
+  removeChild(index: number): void {
+    this.children.removeAt(index);
+  }
+
+  submit(): void {
+    if (this.childrenForm.valid) {
+      this.dialogRef.close(this.children.value);
+    }
+  }
+
+}

src/app/clients/client-stepper/client-general-step/client-general-step.component.ts

@@ -968,6 +968,10 @@ export class ClientGeneralStepComponent implements OnInit, OnDestroy, OnChanges
     this.linkMonthlyAnnual('monthlyTurnover', 'annualTurnover');
   }
 
+  /** Guards the Monthly/Annual and Income/Turnover auto-sync subscriptions below — set this to
+   *  true while programmatically writing both fields of a pair to avoid a feedback loop. */
+  private suppressMonthlyAnnualLink = false;
+
   /**
    * Keeps a Monthly/Annual pair of amount fields in sync at a 12x ratio — typing into either
    * one auto-fills the other. Uses { emitEvent: false } on the write side so the two

src/app/clients/clients-view/form121-tab/form121-tab.component.html

@@ -0,0 +1,428 @@
+<!--
+  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="f121">
+  @if (loading) {
+    <div class="f121__loading">
+      <mat-spinner [diameter]="36"></mat-spinner>
+      <span>Reading the customer's deposit ledger…</span>
+    </div>
+  } @else if (loadError) {
+    <div class="f121__note f121__note--warn">
+      <mat-icon>error_outline</mat-icon>
+      <div>Could not load the customer's accounts. Try again, or check the deposit service.</div>
+    </div>
+  } @else {
+    <!-- ── Header ── -->
+    <div class="f121__head">
+      <div>
+        <h3 class="f121__title">Form 121 &amp; TDS on deposit interest</h3>
+        <div class="f121__sub">
+          Tax deducted at source under {{ statute.section }} on fixed and recurring deposit interest.
+        </div>
+      </div>
+
+      <div class="f121__controls">
+        @if (availableFys.length) {
+          <label class="f121__field">
+            <span>Financial year</span>
+            <select [(ngModel)]="fy" (ngModelChange)="recompute()">
+              @for (year of availableFys; track year) {
+                <option [value]="year">FY {{ year }}</option>
+              }
+            </select>
+          </label>
+        }
+        <div class="f121__field">
+          <span>Settlement</span>
+          <div
+            class="f121__mode"
+            [matTooltip]="'Set by the deposit product\'s interest-posting frequency: tax falls due when interest is credited, so the branch cannot defer it. Not a customer preference.'"
+          >
+            <mat-icon>schedule</mat-icon>
+            {{ mode === 'QUARTERLY' ? 'Quarterly' : 'At year end' }}
+          </div>
+        </div>
+      </div>
+    </div>
+
+    @if (!schedule) {
+      <div class="f121__note">
+        <mat-icon>info_outline</mat-icon>
+        <div>
+          @if (!dateOfBirth) {
+            Date of birth is not on record, so the senior-citizen threshold cannot be determined. Add it on the Personal
+            Data tab.
+          } @else {
+            No interest has been credited to this customer's deposits yet.
+          }
+        </div>
+      </div>
+    } @else {
+      <!-- ── KPI strip ── -->
+      <div class="f121__kpis">
+        <div class="f121__kpi">
+          <div class="f121__kpi-n">₹{{ schedule.totalInterest | number: '1.0-0' }}</div>
+          <div class="f121__kpi-l">Interest earned (FY {{ schedule.fy }})</div>
+        </div>
+        <div class="f121__kpi" [class.f121__kpi--warn]="actualTds > 0">
+          <div class="f121__kpi-n">₹{{ actualTds | number: '1.0-0' }}</div>
+          <div class="f121__kpi-l">TDS deducted</div>
+        </div>
+        <div class="f121__kpi">
+          <div class="f121__kpi-n">₹{{ schedule.threshold | number: '1.0-0' }}</div>
+          <div class="f121__kpi-l">Threshold ({{ schedule.senior ? 'senior citizen' : 'general' }})</div>
+        </div>
+        @if (thresholdCrossed) {
+          <div class="f121__kpi f121__kpi--warn">
+            <div class="f121__kpi-n">Crossed</div>
+            <div class="f121__kpi-l">TDS applies this year</div>
+          </div>
+        } @else {
+          <div class="f121__kpi f121__kpi--ok">
+            <div class="f121__kpi-n">₹{{ headroom | number: '1.0-0' }}</div>
+            <div class="f121__kpi-l">More interest before TDS starts</div>
+          </div>
+        }
+        @if (tdsSaved > 0) {
+          <div class="f121__kpi f121__kpi--ok">
+            <div class="f121__kpi-n">₹{{ tdsSaved | number: '1.0-0' }}</div>
+            <div class="f121__kpi-l">Saved by Form 121</div>
+          </div>
+        }
+      </div>
+
+      <!-- ── Alerts ── -->
+      @if (variance !== 0) {
+        <div class="f121__note f121__note--warn">
+          <mat-icon>warning_amber</mat-icon>
+          <div>
+            <strong>Ledger and computed tax differ by ₹{{ variance | number: '1.0-0' }}.</strong>
+            The ledger shows ₹{{ actualTds | number: '1.0-0' }} withheld; {{ statute.section }} on this year's interest
+            comes to ₹{{ schedule.totalTds | number: '1.0-0' }}. Investigate before the quarterly return is filed.
+          </div>
+        </div>
+      }
+
+      @if (declarationNotAppliedToAccounts) {
+        <div class="f121__note f121__note--warn">
+          <mat-icon>warning_amber</mat-icon>
+          <div>
+            A Form 121 declaration is on record for this year, but withholding is still switched on for one or more
+            deposits. Turn it off on those accounts, or tax will keep being deducted.
+          </div>
+        </div>
+      }
+
+      @if (declarationUselessOnJointAccounts) {
+        <div class="f121__note f121__note--warn">
+          <mat-icon>warning_amber</mat-icon>
+          <div>
+            This customer has filed Form 121, but tax on
+            {{ jointHolderAccounts.length }} joint deposit{{ jointHolderAccounts.length === 1 ? '' : 's' }} is deducted
+            against the first-named holder. Their declaration does not cover those — the primary holder must file their
+            own.
+          </div>
+        </div>
+      }
+
+      @if (shouldSuggestDeclaration) {
+        <div class="f121__note f121__note--tip">
+          <mat-icon>lightbulb_outline</mat-icon>
+          <div>
+            ₹{{ schedule.totalTds | number: '1.0-0' }} of tax falls due this year. If the customer's total tax liability
+            for the year is nil, a {{ formLabel }} declaration would stop it being deducted at all — better than
+            reclaiming it later as a refund.
+          </div>
+        </div>
+      }
+
+      @if (!panWellFormed) {
+        <div class="f121__note f121__note--warn">
+          <mat-icon>error_outline</mat-icon>
+          <div>
+            No valid PAN on record, so tax is deducted at the higher section 206AA rate of
+            {{ schedule.rateApplied * 100 | number: '1.0-0' }}%. A Form 121 declaration is void without a valid PAN.
+          </div>
+        </div>
+      }
+
+      @for (note of schedule.notes; track note) {
+        <div class="f121__note">
+          <mat-icon>info_outline</mat-icon>
+          <div>{{ note }}</div>
+        </div>
+      }
+
+      <!-- ── Declaration panel ── -->
+      <div class="f121__card">
+        <div class="f121__card-head">
+          <mat-icon>assignment_turned_in</mat-icon>
+          <span>Declaration</span>
+        </div>
+        <div class="f121__kv">
+          <div class="f121__kv-row">
+            <span>Status</span>
+            <span>
+              @if (declarationOnRecord) {
+                <span class="f121__pill f121__pill--ok">On record — {{ formLabel }}</span>
+              } @else {
+                <span class="f121__pill">Not filed</span>
+              }
+            </span>
+          </div>
+          <div class="f121__kv-row">
+            <span>Form &amp; threshold band</span>
+            <span>{{ formLabel }} · {{ bandLabel }} band · {{ age }} yrs in this FY</span>
+          </div>
+          <div class="f121__kv-row">
+            <span>PAN</span>
+            <span class="f121__mono">
+              {{ pan || '—' }}
+              @if (pan && !panWellFormed) {
+                <span class="f121__pill f121__pill--warn">invalid</span>
+              }
+            </span>
+          </div>
+          @if (declarationOnRecord && declarationFy) {
+            <div class="f121__kv-row">
+              <span>Declared for</span>
+              <span>FY {{ declarationFy }}</span>
+            </div>
+          }
+          @if (declarationOnRecord && !acceptanceDateKnown) {
+            <div class="f121__kv-row f121__kv-row--muted">
+              <span>Acceptance date</span>
+              <span>
+                Not captured — the declaration is treated as covering the whole year. A mid-year acceptance would change
+                the figures below.
+              </span>
+            </div>
+          }
+          @if (eligibility) {
+            @for (reason of eligibility.reasons; track reason) {
+              <div class="f121__kv-row f121__kv-row--warn">
+                <span>Eligibility</span>
+                <span>{{ reason }}</span>
+              </div>
+            }
+            @for (note of eligibility.unassessed; track note) {
+              <div class="f121__kv-row f121__kv-row--muted">
+                <span>Not assessed</span>
+                <span>{{ note }}</span>
+              </div>
+            }
+          }
+        </div>
+      </div>
+
+      <!-- ── Quarter-wise ── -->
+      <div class="f121__card">
+        <div class="f121__card-head">
+          <mat-icon>table_chart</mat-icon>
+          <span>Quarter by quarter</span>
+        </div>
+        <div class="f121__table-wrap">
+          <table class="f121__table">
+            <thead>
+              <tr>
+                <th>Quarter</th>
+                <th class="num">Interest</th>
+                <th class="num">Cumulative</th>
+                <th class="num">Liability to date</th>
+                <th class="num">TDS this quarter</th>
+                <th>Return due</th>
+              </tr>
+            </thead>
+            <tbody>
+              @for (line of schedule.lines; track trackLine($index, line)) {
+                <tr [class.f121__row--warn]="line.thresholdCrossedHere">
+                  <td>
+                    {{ line.label }}
+                    @if (line.thresholdCrossedHere) {
+                      <span class="f121__pill f121__pill--warn">threshold crossed</span>
+                    }
+                    @if (line.declarationActive) {
+                      <span class="f121__pill f121__pill--ok">Form 121 active</span>
+                    }
+                  </td>
+                  <td class="num">₹{{ line.interest | number: '1.0-0' }}</td>
+                  <td class="num">₹{{ line.cumInterest | number: '1.0-0' }}</td>
+                  <td class="num">₹{{ line.cumLiability | number: '1.0-0' }}</td>
+                  <td class="num">
+                    @if (line.tds !== 0) {
+                      <strong>₹{{ line.tds | number: '1.0-0' }}</strong>
+                    } @else {
+                      <span class="muted">—</span>
+                    }
+                  </td>
+                  <td class="muted">{{ line.dueDate }}</td>
+                </tr>
+              }
+              <tr class="f121__row--total">
+                <td><strong>Total</strong></td>
+                <td class="num">
+                  <strong>₹{{ schedule.totalInterest | number: '1.0-0' }}</strong>
+                </td>
+                <td></td>
+                <td></td>
+                <td class="num">
+                  <strong>₹{{ schedule.totalTds | number: '1.0-0' }}</strong>
+                </td>
+                <td></td>
+              </tr>
+            </tbody>
+          </table>
+        </div>
+        @if (schedule.shieldedInterest > 0) {
+          <div class="f121__foot">
+            ₹{{ schedule.shieldedInterest | number: '1.0-0' }} was paid without deduction on the strength of the
+            declaration. This amount is still reportable in the quarterly {{ statute.statement }} return.
+          </div>
+        }
+      </div>
+
+      <!-- ── Section 1: accounts that count ── -->
+      <div class="f121__card">
+        <div class="f121__card-head">
+          <mat-icon>account_balance</mat-icon>
+          <span>Deposits counted towards this customer's TDS</span>
+        </div>
+        @if (liableAccounts.length) {
+          <div class="f121__table-wrap">
+            <table class="f121__table">
+              <thead>
+                <tr>
+                  <th>Account</th>
+                  <th>Type</th>
+                  <th class="num">Interest (FY)</th>
+                  <th class="num">TDS deducted</th>
+                  <th>Withholding</th>
+                  <th>Settles</th>
+                </tr>
+              </thead>
+              <tbody>
+                @for (a of liableAccounts; track trackAccount($index, a)) {
+                  <tr>
+                    <td>
+                      <div class="f121__mono">{{ a.accountNo }}</div>
+                      <div class="muted">{{ a.productName }}</div>
+                    </td>
+                    <td>{{ a.kind }}</td>
+                    <td class="num">₹{{ a.interest | number: '1.0-0' }}</td>
+                    <td class="num">₹{{ a.tdsDeducted | number: '1.0-0' }}</td>
+                    <td>
+                      @if (a.withHoldTax) {
+                        <span class="f121__pill f121__pill--warn">On</span>
+                        @if (a.taxGroup) {
+                          <div class="muted">{{ a.taxGroup }}</div>
+                        }
+                      } @else {
+                        <span class="f121__pill">Off</span>
+                      }
+                    </td>
+                    <td>{{ a.mode === 'QUARTERLY' ? 'Quarterly' : 'Year end' }}</td>
+                  </tr>
+                }
+              </tbody>
+            </table>
+          </div>
+          <div class="f121__foot">
+            Aggregated across every branch — a bank on core banking computes the deduction threshold for the bank as a
+            whole, not branch by branch.
+          </div>
+        } @else {
+          <div class="f121__empty">No fixed or recurring deposits where this customer is the deductee.</div>
+        }
+      </div>
+
+      <!-- ── Section 2: joint holdings ── -->
+      @if (jointHolderAccounts.length) {
+        <div class="f121__card">
+          <div class="f121__card-head">
+            <mat-icon>group</mat-icon>
+            <span>Deposits where this customer is a joint holder</span>
+          </div>
+          <div class="f121__table-wrap">
+            <table class="f121__table">
+              <thead>
+                <tr>
+                  <th>Account</th>
+                  <th>Type</th>
+                  <th class="num">Interest (FY)</th>
+                  <th>Deducted against</th>
+                </tr>
+              </thead>
+              <tbody>
+                @for (a of jointHolderAccounts; track trackAccount($index, a)) {
+                  <tr>
+                    <td>
+                      <div class="f121__mono">{{ a.accountNo }}</div>
+                      <div class="muted">{{ a.productName }}</div>
+                    </td>
+                    <td>{{ a.kind }}</td>
+                    <td class="num">₹{{ a.interest | number: '1.0-0' }}</td>
+                    <td class="muted">
+                      First-named holder
+                      @if (a.deducteeClientId) {
+                        (client {{ a.deducteeClientId }})
+                      }
+                    </td>
+                  </tr>
+                }
+              </tbody>
+            </table>
+          </div>
+          <div class="f121__foot">
+            Tax on a joint deposit is deducted against the first-named holder's PAN, so this interest is
+            <strong>not</strong> counted in the figures above and does not use up this customer's threshold.
+          </div>
+        </div>
+      }
+
+      <!-- ── Section 3: exempt accounts ── -->
+      @if (exemptAccounts.length) {
+        <div class="f121__card">
+          <div class="f121__card-head">
+            <mat-icon>savings</mat-icon>
+            <span>Savings and current accounts</span>
+          </div>
+          <div class="f121__table-wrap">
+            <table class="f121__table">
+              <thead>
+                <tr>
+                  <th>Account</th>
+                  <th>Type</th>
+                  <th class="num">Interest (FY)</th>
+                  <th>TDS</th>
+                </tr>
+              </thead>
+              <tbody>
+                @for (a of exemptAccounts; track trackAccount($index, a)) {
+                  <tr>
+                    <td>
+                      <div class="f121__mono">{{ a.accountNo }}</div>
+                      <div class="muted">{{ a.productName }}</div>
+                    </td>
+                    <td>{{ a.kind }}</td>
+                    <td class="num">₹{{ a.interest | number: '1.0-0' }}</td>
+                    <td><span class="f121__pill">Not applicable</span></td>
+                  </tr>
+                }
+              </tbody>
+            </table>
+          </div>
+          <div class="f121__foot">
+            The charge applies to time deposits. Savings bank interest is outside it and is excluded from the threshold
+            — the customer claims the 80TTA or 80TTB deduction on it in their own return instead.
+          </div>
+        </div>
+      }
+    }
+  }
+</div>

src/app/clients/clients-view/form121-tab/form121-tab.component.scss

@@ -0,0 +1,334 @@
+/**
+ * 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/.
+ */
+
+.f121 {
+  --f121-line: #e5e7eb;
+  --f121-bg: #f9fafb;
+  --f121-ink: #111827;
+  --f121-muted: #6b7280;
+  --f121-blue: #1d4ed8;
+  --f121-green: #15803d;
+  --f121-amber: #b45309;
+
+  padding: 16px;
+  font-size: 13px;
+  color: var(--f121-ink);
+}
+
+.f121__loading {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 40px 16px;
+  color: var(--f121-muted);
+}
+
+/* ── Header ── */
+.f121__head {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 16px;
+  align-items: flex-end;
+  justify-content: space-between;
+  margin-bottom: 16px;
+}
+
+.f121__title {
+  margin: 0;
+  font-size: 16px;
+  font-weight: 700;
+}
+
+.f121__sub {
+  margin-top: 4px;
+  color: var(--f121-muted);
+  font-size: 12px;
+}
+
+.f121__controls {
+  display: flex;
+  gap: 16px;
+  align-items: flex-end;
+}
+
+.f121__field {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+
+  > span {
+    font-size: 10.5px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    color: var(--f121-muted);
+  }
+
+  select {
+    padding: 7px 10px;
+    border: 1px solid var(--f121-line);
+    border-radius: 6px;
+    background: #fff;
+    font-size: 13px;
+    color: inherit;
+  }
+}
+
+.f121__mode {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 7px 10px;
+  border: 1px solid var(--f121-line);
+  border-radius: 6px;
+  background: var(--f121-bg);
+  font-weight: 600;
+  cursor: help;
+
+  mat-icon {
+    font-size: 16px;
+    width: 16px;
+    height: 16px;
+    color: var(--f121-muted);
+  }
+}
+
+/* ── KPI strip ── */
+.f121__kpis {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+  gap: 10px;
+  margin-bottom: 16px;
+}
+
+.f121__kpi {
+  padding: 12px 14px;
+  border: 1px solid var(--f121-line);
+  border-left: 3px solid var(--f121-blue);
+  border-radius: 8px;
+  background: #fff;
+
+  &--ok {
+    border-left-color: var(--f121-green);
+  }
+
+  &--warn {
+    border-left-color: var(--f121-amber);
+  }
+}
+
+.f121__kpi-n {
+  font-size: 19px;
+  font-weight: 800;
+  font-variant-numeric: tabular-nums;
+}
+
+.f121__kpi-l {
+  margin-top: 2px;
+  font-size: 11px;
+  color: var(--f121-muted);
+  line-height: 1.35;
+}
+
+/* ── Notes ── */
+.f121__note {
+  display: flex;
+  gap: 10px;
+  align-items: flex-start;
+  margin-bottom: 12px;
+  padding: 11px 13px;
+  border-radius: 8px;
+  border-left: 3px solid var(--f121-blue);
+  background: color-mix(in srgb, var(--f121-blue) 6%, transparent);
+  line-height: 1.5;
+
+  mat-icon {
+    flex-shrink: 0;
+    font-size: 18px;
+    width: 18px;
+    height: 18px;
+    color: var(--f121-blue);
+  }
+
+  &--warn {
+    border-left-color: var(--f121-amber);
+    background: color-mix(in srgb, var(--f121-amber) 8%, transparent);
+
+    mat-icon {
+      color: var(--f121-amber);
+    }
+  }
+
+  &--tip {
+    border-left-color: var(--f121-green);
+    background: color-mix(in srgb, var(--f121-green) 7%, transparent);
+
+    mat-icon {
+      color: var(--f121-green);
+    }
+  }
+}
+
+/* ── Cards ── */
+.f121__card {
+  margin-bottom: 16px;
+  border: 1px solid var(--f121-line);
+  border-radius: 10px;
+  background: #fff;
+  overflow: hidden;
+}
+
+.f121__card-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 11px 14px;
+  background: var(--f121-bg);
+  border-bottom: 1px solid var(--f121-line);
+  font-weight: 700;
+  font-size: 12.5px;
+
+  mat-icon {
+    font-size: 18px;
+    width: 18px;
+    height: 18px;
+    color: var(--f121-muted);
+  }
+}
+
+.f121__foot {
+  padding: 10px 14px;
+  border-top: 1px solid var(--f121-line);
+  background: var(--f121-bg);
+  color: var(--f121-muted);
+  font-size: 11.5px;
+  line-height: 1.5;
+}
+
+.f121__empty {
+  padding: 20px 14px;
+  color: var(--f121-muted);
+  text-align: center;
+}
+
+/* ── Key/value list ── */
+.f121__kv-row {
+  display: grid;
+  grid-template-columns: 190px 1fr;
+  gap: 12px;
+  padding: 10px 14px;
+  border-bottom: 1px solid #f3f4f6;
+  line-height: 1.5;
+
+  &:last-child {
+    border-bottom: 0;
+  }
+
+  > span:first-child {
+    color: var(--f121-muted);
+    font-weight: 600;
+  }
+
+  &--muted > span:last-child {
+    color: var(--f121-muted);
+    font-size: 12px;
+  }
+
+  &--warn > span:last-child {
+    color: var(--f121-amber);
+  }
+}
+
+/* ── Tables ── */
+.f121__table-wrap {
+  overflow-x: auto;
+}
+
+.f121__table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12.5px;
+
+  th {
+    text-align: left;
+    padding: 10px 14px;
+    background: #fff;
+    border-bottom: 1px solid var(--f121-line);
+    color: var(--f121-muted);
+    font-weight: 700;
+    font-size: 10.5px;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    white-space: nowrap;
+  }
+
+  td {
+    padding: 10px 14px;
+    border-bottom: 1px solid #f3f4f6;
+    vertical-align: top;
+  }
+
+  tr:last-child td {
+    border-bottom: 0;
+  }
+
+  .num {
+    text-align: right;
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+  }
+
+  .muted {
+    color: var(--f121-muted);
+    font-size: 11.5px;
+  }
+}
+
+.f121__row--warn > td {
+  background: color-mix(in srgb, var(--f121-amber) 7%, transparent);
+}
+
+.f121__row--total > td {
+  background: var(--f121-bg);
+  border-top: 1px solid var(--f121-line);
+}
+
+/* ── Bits ── */
+.f121__pill {
+  display: inline-flex;
+  align-items: center;
+  padding: 2px 9px;
+  border-radius: 999px;
+  border: 1px solid var(--f121-line);
+  background: var(--f121-bg);
+  color: var(--f121-muted);
+  font-size: 10.5px;
+  font-weight: 700;
+  white-space: nowrap;
+
+  & + & {
+    margin-left: 5px;
+  }
+
+  &--ok {
+    border-color: color-mix(in srgb, var(--f121-green) 35%, transparent);
+    background: color-mix(in srgb, var(--f121-green) 10%, transparent);
+    color: var(--f121-green);
+  }
+
+  &--warn {
+    border-color: color-mix(in srgb, var(--f121-amber) 35%, transparent);
+    background: color-mix(in srgb, var(--f121-amber) 12%, transparent);
+    color: var(--f121-amber);
+  }
+}
+
+.f121__mono {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-weight: 600;
+}

src/app/clients/clients-view/form121-tab/form121-tab.component.ts

@@ -0,0 +1,500 @@
+/**
+ * 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/.
+ */
+
+/** Angular Imports */
+import { Component, OnDestroy, OnInit, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormsModule } from '@angular/forms';
+import { ActivatedRoute } from '@angular/router';
+import { MatIcon } from '@angular/material/icon';
+import { MatProgressSpinner } from '@angular/material/progress-spinner';
+import { MatTooltip } from '@angular/material/tooltip';
+import { Observable, Subject, forkJoin, of } from 'rxjs';
+import { catchError, switchMap, takeUntil } from 'rxjs/operators';
+
+/** Custom Services */
+import { ClientsService } from '../../clients.service';
+import { SavingsService } from 'app/savings/savings.service';
+import { FixedDepositsService } from 'app/deposits/fixed-deposits/fixed-deposits.service';
+import { RecurringDepositsService } from 'app/deposits/recurring-deposits/recurring-deposits.service';
+import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
+
+/** Domain logic */
+import {
+  Declaration,
+  DeclarationForm,
+  EligibilityResult,
+  FY_TAX_CONFIG,
+  InterestCredit,
+  TdsAccountInput,
+  TdsMode,
+  TdsQuarterLine,
+  TdsSchedule,
+  ageInFy,
+  buildSchedule,
+  checkEligibility,
+  collectTdsCredits,
+  declarationFormFor,
+  formKindFor,
+  fyOf,
+  isTdsApplicable,
+  isWellFormedPan,
+  normaliseFy,
+  tdsDeducteeOf,
+  tdsModeFor
+} from 'app/letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+
+/** One of the customer's interest-bearing accounts, with its FY figures. */
+export interface Form121AccountRow {
+  accountNo: string;
+  productName: string;
+  /** 'Fixed Deposit', 'Recurring Deposit' or 'Savings'. */
+  kind: string;
+  /** Interest credited to this account inside the selected FY. */
+  interest: number;
+  /** Tax Fineract has actually withheld on this account inside the FY. */
+  tdsDeducted: number;
+  /** Whether Fineract is currently withholding tax on this account. */
+  withHoldTax: boolean;
+  taxGroup: string | null;
+  /** When tax on this account settles — from the product, not a preference. */
+  mode: TdsMode;
+  /** Interest here attracts TDS at all (a time deposit, not a savings account). */
+  tdsApplicable: boolean;
+  /** This customer is the deductee — false when they are a joint holder only. */
+  isDeductee: boolean;
+  /** Who the tax is deducted against, when it is not this customer. */
+  deducteeClientId: number | null;
+}
+
+/** Fineract hands dates back as [yyyy, m, d]; normalise to ISO. */
+function toIso(value: unknown): string | null {
+  if (Array.isArray(value) && value.length >= 3) {
+    const [
+      y,
+      m,
+      d
+    ] = value as number[];
+    return `${y}-${`${m}`.padStart(2, '0')}-${`${d}`.padStart(2, '0')}`;
+  }
+  if (typeof value === 'string' && value.trim()) {
+    const parsed = new Date(value);
+    if (!isNaN(parsed.getTime())) {
+      return parsed.toISOString().slice(0, 10);
+    }
+  }
+  return null;
+}
+
+@Component({
+  selector: 'mifosx-form121-tab',
+  templateUrl: './form121-tab.component.html',
+  styleUrls: ['./form121-tab.component.scss'],
+  standalone: true,
+  imports: [
+    ...STANDALONE_SHARED_IMPORTS,
+    CommonModule,
+    FormsModule,
+    MatIcon,
+    MatProgressSpinner,
+    MatTooltip
+  ]
+})
+export class Form121TabComponent implements OnInit, OnDestroy {
+  private route = inject(ActivatedRoute);
+  private clientsService = inject(ClientsService);
+  private savingsService = inject(SavingsService);
+  private fixedDepositsService = inject(FixedDepositsService);
+  private recurringDepositsService = inject(RecurringDepositsService);
+
+  private destroy$ = new Subject<void>();
+
+  clientId = '';
+  loading = true;
+  loadError = false;
+
+  // ── Customer ──
+  clientName = '';
+  dateOfBirth = '';
+  pan = '';
+  panWellFormed = false;
+
+  // ── Declaration on record ──
+  declarationOnRecord = false;
+  /**
+   * The form actually in force for the selected year. From FY 2026-27 a single
+   * Form 121 replaced the 15G/15H split, so this is derived from the year rather
+   * than from the payee's age.
+   */
+  declarationForm: DeclarationForm = '121';
+  /** Kind recorded at KYC, meaningful only for a pre-2026 year. */
+  declarationKind: '15G' | '15H' = '15G';
+  declarationFy = '';
+  /**
+   * The KYC step records only the year, not the date the branch accepted the
+   * declaration, so it has to be treated as covering the whole year. Surfaced on
+   * screen rather than hidden — a mid-year acceptance would change the figures.
+   */
+  acceptanceDateKnown = false;
+
+  eligibility: EligibilityResult | null = null;
+
+  // ── Selection ──
+  availableFys: string[] = [];
+  fy = '';
+
+  // ── Computed ──
+  accounts: Form121AccountRow[] = [];
+  schedule: TdsSchedule | null = null;
+  actualTds = 0;
+  tdsSaved = 0;
+
+  /** Raw account inputs, kept so the year selector can recompute cheaply. */
+  private accountInputs: (TdsAccountInput & { meta: Form121AccountRow })[] = [];
+  /** Withheld-tax postings by FY, from the ledger. */
+  private actualTdsByFy = new Map<string, number>();
+
+  ngOnInit(): void {
+    this.route.parent.params.pipe(takeUntil(this.destroy$)).subscribe((params: any) => {
+      this.clientId = params['clientId'];
+      this.load();
+    });
+  }
+
+  ngOnDestroy(): void {
+    this.destroy$.next();
+    this.destroy$.complete();
+  }
+
+  // ────────────────────────────── Loading ──────────────────────────────
+
+  private load(): void {
+    this.loading = true;
+    this.loadError = false;
+
+    forkJoin({
+      client: this.clientsService.getClientData(this.clientId, true).pipe(catchError(() => of(null))),
+      kyc: this.clientsService.getClientKyc(this.clientId, true).pipe(catchError(() => of(null))),
+      accounts: this.clientsService.getClientAccountData(this.clientId).pipe(catchError(() => of(null)))
+    })
+      .pipe(
+        takeUntil(this.destroy$),
+        switchMap(({ client, kyc, accounts }) => {
+          this.applyClient(client);
+          this.applyKyc(kyc);
+          const deposits = this.depositAccountsOf(accounts);
+          return deposits.length ? forkJoin(deposits.map((a) => this.fetchAccount(a))) : of([] as any[]);
+        }),
+        catchError(() => {
+          this.loadError = true;
+          return of([] as any[]);
+        })
+      )
+      .subscribe((details: any[]) => {
+        this.loading = false;
+        this.ingest(details.filter(Boolean));
+        this.recompute();
+      });
+  }
+
+  private applyClient(client: any): void {
+    this.clientName = client?.displayName ?? '';
+    this.dateOfBirth = toIso(client?.dateOfBirth) ?? '';
+  }
+
+  private applyKyc(kyc: any): void {
+    this.pan = (kyc?.panNumber ?? '').toUpperCase();
+    this.panWellFormed = isWellFormedPan(this.pan);
+    this.declarationOnRecord = !!kyc?.form15Applicable;
+    this.declarationKind = kyc?.form15Type === '15H' ? '15H' : '15G';
+    this.declarationForm = this.fy ? declarationFormFor(this.fy, this.dateOfBirth) : '121';
+    this.declarationFy = kyc?.form15FY ?? '';
+    this.acceptanceDateKnown = false;
+  }
+
+  /** Savings, FD and RD accounts — everything that can credit interest. */
+  private depositAccountsOf(accounts: any): any[] {
+    return (accounts?.savingsAccounts ?? []).filter(
+      (a: any) => a.status?.active || a.status?.matured || a.status?.closed
+    );
+  }
+
+  private fetchAccount(a: any): Observable<any> {
+    const id = `${a.id}`;
+    const code = a.depositType?.code ?? '';
+    let call: Observable<any>;
+    if (code.includes('fixedDeposit')) {
+      call = this.fixedDepositsService.getFixedDepositsAccountData(id);
+    } else if (code.includes('recurringDeposit')) {
+      call = this.recurringDepositsService.getRecurringDepositsAccountData(id);
+    } else {
+      call = this.savingsService.getSavingsAccountData(id);
+    }
+    // One unreadable account must not blank the whole tab.
+    return call.pipe(catchError(() => of(null)));
+  }
+
+  /**
+   * Turns each account payload into an engine input.
+   *
+   * Joint and minor attributes are read defensively: they are captured on the
+   * account stepper but may not surface on every read endpoint, and an absent
+   * field must default to a single-name account rather than throw.
+   */
+  private ingest(details: any[]): void {
+    this.accountInputs = [];
+    this.actualTdsByFy = new Map<string, number>();
+    const fys = new Set<string>();
+    const clientIdNum = Number(this.clientId);
+
+    for (const d of details) {
+      const code: string = d.depositType?.code ?? '';
+      const extra = d.extraAttributes ?? d.externalAttributes ?? d;
+
+      const ref = {
+        id: d.id,
+        accountNo: d.accountNo ?? `${d.id}`,
+        depositTypeCode: code,
+        accountStatus: extra.accountStatus ?? d.accountStatus ?? 'SINGLE',
+        clientId: d.clientId ?? clientIdNum,
+        primaryClientId: extra.primaryClientId ?? d.primaryClientId ?? null,
+        guardianClientId: extra.guardianClientId ?? d.guardianClientId ?? null,
+        jointHolders: extra.jointHolders ?? d.jointHolders ?? [],
+        interestPostingPeriodType: d.interestPostingPeriodType ?? null
+      };
+
+      const credits: InterestCredit[] = [];
+      let tdsDeducted = 0;
+
+      for (const t of d.transactions ?? []) {
+        if (t.reversed || t.isReversal) {
+          continue;
+        }
+        const iso = toIso(t.date);
+        if (!iso) {
+          continue;
+        }
+        fys.add(fyOf(iso));
+
+        if (t.transactionType?.interestPosting) {
+          credits.push({ date: iso, amount: t.amount ?? 0, accountNo: ref.accountNo });
+        } else if (t.transactionType?.withholdTax) {
+          const amount = t.amount ?? 0;
+          tdsDeducted += amount;
+          const txnFy = fyOf(iso);
+          this.actualTdsByFy.set(txnFy, (this.actualTdsByFy.get(txnFy) ?? 0) + amount);
+        }
+      }
+
+      const deductee = tdsDeducteeOf(ref);
+      const meta: Form121AccountRow = {
+        accountNo: ref.accountNo,
+        productName: d.savingsProductName ?? d.depositProductName ?? d.productName ?? '—',
+        kind: code.includes('fixedDeposit')
+          ? 'Fixed Deposit'
+          : code.includes('recurringDeposit')
+            ? 'Recurring Deposit'
+            : 'Savings',
+        interest: 0,
+        tdsDeducted,
+        withHoldTax: !!d.withHoldTax,
+        taxGroup: d.taxGroup?.name ?? null,
+        mode: tdsModeFor(ref),
+        tdsApplicable: isTdsApplicable(ref),
+        isDeductee: deductee === clientIdNum,
+        deducteeClientId: deductee
+      };
+
+      this.accountInputs.push({ ...ref, credits, meta });
+    }
+
+    this.availableFys = [...fys].sort().reverse();
+    if (!this.availableFys.includes(this.fy)) {
+      this.fy = this.availableFys[0] ?? (this.declarationFy ? normaliseFy(this.declarationFy) : '');
+    }
+  }
+
+  // ───────────────────────────── Computation ─────────────────────────────
+
+  /** Re-runs the engine for the selected year. */
+  recompute(): void {
+    this.schedule = null;
+    this.eligibility = null;
+    this.tdsSaved = 0;
+    this.accounts = this.accountInputs.map((a) => a.meta);
+
+    if (!this.fy) {
+      return;
+    }
+
+    const year = normaliseFy(this.fy);
+
+    // Per-account interest for the selected year, for the three lists.
+    for (const a of this.accountInputs) {
+      a.meta.interest = a.credits.filter((c) => fyOf(c.date) === year).reduce((s, c) => s + c.amount, 0);
+    }
+    this.actualTds = this.actualTdsByFy.get(year) ?? 0;
+
+    if (!this.dateOfBirth) {
+      return;
+    }
+
+    // The one place rules 8 to 12 are applied: savings interest dropped, joint
+    // deposits attributed to the primary holder, every branch aggregated.
+    const credits = collectTdsCredits(Number(this.clientId), this.accountInputs, year);
+    const ctx = { fy: year, dateOfBirth: this.dateOfBirth, pan: this.pan, resident: true };
+    const declaration = this.declarationForSelectedFy();
+
+    this.schedule = buildSchedule(this.overallMode, credits, { ...ctx, declaration });
+
+    if (declaration) {
+      const without = buildSchedule(this.overallMode, credits, { ...ctx, declaration: null });
+      this.tdsSaved = Math.max(0, without.totalTds - this.schedule.totalTds);
+    }
+
+    // The branch cannot compute income earned outside the bank, so the income
+    // limb is reported as unassessed rather than silently passed.
+    this.eligibility = checkEligibility(ctx, {
+      estimatedInterest: this.schedule.totalInterest,
+      estimatedIncome: 0,
+      incomeOnRecord: false
+    });
+  }
+
+  /**
+   * When tax settles for this customer overall.
+   *
+   * Timing is per account, but the customer needs one view. A quarterly account
+   * anywhere in the book means a deduction falls due at the first quarter end, so
+   * that is the honest headline; the per-account list carries the detail.
+   */
+  private get overallMode(): TdsMode {
+    const applicable = this.accountInputs.filter((a) => a.meta.tdsApplicable && a.meta.isDeductee);
+    return applicable.some((a) => a.meta.mode === 'QUARTERLY') ? 'QUARTERLY' : 'ANNUAL';
+  }
+
+  /** The declaration, but only when it was filed for the year being shown. */
+  private declarationForSelectedFy(): Declaration | null {
+    if (!this.declarationOnRecord || !this.fy) {
+      return null;
+    }
+    const year = normaliseFy(this.fy);
+    if (this.declarationFy && normaliseFy(this.declarationFy) !== year) {
+      return null;
+    }
+    return {
+      kind: this.declarationKind,
+      // No acceptance date on record — treated as covering the whole year.
+      acceptedOn: `${year.slice(0, 4)}-04-01`,
+      fy: year
+    };
+  }
+
+  // ───────────────────────── Template helpers ─────────────────────────
+
+  get mode(): TdsMode {
+    return this.schedule?.mode ?? 'QUARTERLY';
+  }
+
+  get age(): number {
+    return this.dateOfBirth && this.fy ? ageInFy(this.dateOfBirth, this.fy) : 0;
+  }
+
+  get formKind(): string {
+    return this.dateOfBirth && this.fy ? formKindFor(this.dateOfBirth, this.fy) : '—';
+  }
+
+  /** The form the payee would file for the selected year. */
+  get formLabel(): string {
+    if (!this.fy) {
+      return '—';
+    }
+    const form = declarationFormFor(this.fy, this.dateOfBirth);
+    return form === '121' ? 'Form 121' : `Form ${form}`;
+  }
+
+  /** Which deduction trigger applies, now that the forms no longer split by age. */
+  get bandLabel(): string {
+    return this.schedule?.senior ? 'Senior citizen' : 'General';
+  }
+
+  /**
+   * Provision and return references for the selected year. Both changed on
+   * 01 April 2026, so the template reads them rather than hard-coding them.
+   */
+  get statute(): { section: string; statement: string; rule: string; frequency: string } {
+    const cfg = this.fy ? FY_TAX_CONFIG[normaliseFy(this.fy)] : undefined;
+    return {
+      section: cfg?.interestTdsSection ?? '—',
+      statement: cfg?.tdsStatementForm ?? '—',
+      rule: cfg?.declarationRule ?? '—',
+      frequency: cfg?.declarationStatementFrequency === 'MONTHLY' ? 'monthly' : 'quarterly'
+    };
+  }
+
+  /** Accounts whose interest counts towards this customer's deduction aggregate. */
+  get liableAccounts(): Form121AccountRow[] {
+    return this.accounts.filter((a) => a.tdsApplicable && a.isDeductee);
+  }
+
+  /** Deposits where this customer is a joint holder but not the deductee. */
+  get jointHolderAccounts(): Form121AccountRow[] {
+    return this.accounts.filter((a) => a.tdsApplicable && !a.isDeductee);
+  }
+
+  /** Savings and current accounts — interest outside the charge on time deposits. */
+  get exemptAccounts(): Form121AccountRow[] {
+    return this.accounts.filter((a) => !a.tdsApplicable);
+  }
+
+  /** Engine figure less what the ledger shows was actually withheld. */
+  get variance(): number {
+    return (this.schedule?.totalTds ?? 0) - this.actualTds;
+  }
+
+  /** How much more interest before TDS starts. */
+  get headroom(): number {
+    if (!this.schedule) {
+      return 0;
+    }
+    return Math.max(0, this.schedule.threshold - this.schedule.totalInterest);
+  }
+
+  get thresholdCrossed(): boolean {
+    return !!this.schedule && this.schedule.totalInterest > this.schedule.threshold;
+  }
+
+  /**
+   * A declaration is on record but deposit accounts are still set to withhold —
+   * the branch has not switched them off.
+   */
+  get declarationNotAppliedToAccounts(): boolean {
+    return !!this.declarationForSelectedFy() && this.liableAccounts.some((a) => a.withHoldTax);
+  }
+
+  /**
+   * The customer filed a declaration but holds joint deposits where someone else
+   * is the deductee — their form does nothing for those.
+   */
+  get declarationUselessOnJointAccounts(): boolean {
+    return !!this.declarationForSelectedFy() && this.jointHolderAccounts.length > 0;
+  }
+
+  /** Worth prompting the branch to collect a declaration. */
+  get shouldSuggestDeclaration(): boolean {
+    return !this.declarationForSelectedFy() && (this.schedule?.totalTds ?? 0) > 0;
+  }
+
+  trackLine(_: number, line: TdsQuarterLine): number {
+    return line.quarter;
+  }
+
+  trackAccount(_: number, account: Form121AccountRow): string {
+    return account.accountNo;
+  }
+}

src/app/clients/kyc-exception.util.spec.ts

@@ -0,0 +1,175 @@
+/**
+ * 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 {
+  deriveKycExceptionFields,
+  KycExceptionInput,
+  KYC_EXCEPTION_AADHAAR,
+  KYC_EXCEPTION_PAN
+} from './kyc-exception.util';
+
+const TODAY = '05 August 2026';
+
+/** Individual client, nothing previously recorded — the client-creation case. */
+const newIndividual = (panVerified: boolean, aadhaarVerified: boolean): KycExceptionInput => ({
+  panVerified,
+  aadhaarVerified,
+  aadhaarApplicable: true,
+  hadException: false,
+  previousReason: null,
+  todayFormatted: TODAY
+});
+
+/** Individual client that already carries an open exception. */
+const existingException = (
+  panVerified: boolean,
+  aadhaarVerified: boolean,
+  previousReason: string
+): KycExceptionInput => ({
+  panVerified,
+  aadhaarVerified,
+  aadhaarApplicable: true,
+  hadException: true,
+  previousReason,
+  todayFormatted: TODAY
+});
+
+describe('deriveKycExceptionFields', () => {
+  describe('at client creation', () => {
+    it('marks both PAN and Aadhaar when neither is entered or verified', () => {
+      expect(deriveKycExceptionFields(newIndividual(false, false))).toEqual({
+        isException: true,
+        exceptionReason: `${KYC_EXCEPTION_PAN}, ${KYC_EXCEPTION_AADHAAR}`,
+        exceptionResolved: false,
+        exceptionResolvedOn: null
+      });
+    });
+
+    it('marks only PAN when Aadhaar verified but PAN did not', () => {
+      expect(deriveKycExceptionFields(newIndividual(false, true))).toEqual({
+        isException: true,
+        exceptionReason: KYC_EXCEPTION_PAN,
+        exceptionResolved: false,
+        exceptionResolvedOn: null
+      });
+    });
+
+    it('marks only Aadhaar when PAN verified but Aadhaar did not', () => {
+      expect(deriveKycExceptionFields(newIndividual(true, false))).toEqual({
+        isException: true,
+        exceptionReason: KYC_EXCEPTION_AADHAAR,
+        exceptionResolved: false,
+        exceptionResolvedOn: null
+      });
+    });
+
+    it('raises nothing when both verify, and does not mark the client resolved', () => {
+      // A clean client never had an exception, so it must not appear in the Resolved tab either.
+      expect(deriveKycExceptionFields(newIndividual(true, true))).toEqual({
+        isException: false,
+        exceptionReason: null,
+        exceptionResolved: false,
+        exceptionResolvedOn: null
+      });
+    });
+
+    it('does not raise an Aadhaar exception for a non-individual client', () => {
+      // Companies submit a dummy masked Aadhaar; checking it would mean a permanent exception.
+      expect(
+        deriveKycExceptionFields({
+          panVerified: true,
+          aadhaarVerified: false,
+          aadhaarApplicable: false,
+          hadException: false,
+          previousReason: null,
+          todayFormatted: TODAY
+        }).isException
+      ).toBe(false);
+    });
+  });
+
+  describe('resolving', () => {
+    it('closes the exception once both checks pass, keeping the reason for the audit trail', () => {
+      const both = `${KYC_EXCEPTION_PAN}, ${KYC_EXCEPTION_AADHAAR}`;
+      expect(deriveKycExceptionFields(existingException(true, true, both))).toEqual({
+        isException: false,
+        exceptionReason: both,
+        exceptionResolved: true,
+        exceptionResolvedOn: TODAY
+      });
+    });
+
+    it('narrows to the outstanding item when only one of two verifies', () => {
+      const both = `${KYC_EXCEPTION_PAN}, ${KYC_EXCEPTION_AADHAAR}`;
+      // PAN verified, Aadhaar still outstanding — stays open, listing Aadhaar alone.
+      expect(deriveKycExceptionFields(existingException(true, false, both))).toEqual({
+        isException: true,
+        exceptionReason: KYC_EXCEPTION_AADHAAR,
+        exceptionResolved: false,
+        exceptionResolvedOn: null
+      });
+    });
+
+    it('narrows the other way round too', () => {
+      const both = `${KYC_EXCEPTION_PAN}, ${KYC_EXCEPTION_AADHAAR}`;
+      expect(deriveKycExceptionFields(existingException(false, true, both)).exceptionReason).toBe(KYC_EXCEPTION_PAN);
+    });
+  });
+
+  describe('re-opening', () => {
+    it('clears a prior resolution so a new exception returns to Pending', () => {
+      // Regression: without exceptionResolved=false the record still matched the Resolved query
+      // and a brand-new exception appeared as already closed.
+      const result = deriveKycExceptionFields({
+        panVerified: false,
+        aadhaarVerified: true,
+        aadhaarApplicable: true,
+        hadException: false,
+        previousReason: 'PAN Card Verification Failed',
+        todayFormatted: TODAY
+      });
+      expect(result.exceptionResolved).toBe(false);
+      expect(result.exceptionResolvedOn).toBeNull();
+      expect(result.isException).toBe(true);
+    });
+  });
+
+  describe('officer-entered reasons', () => {
+    it('keeps a manual reason alongside the automatic ones', () => {
+      const result = deriveKycExceptionFields({
+        ...newIndividual(true, true),
+        manualReasons: ['Address proof pending']
+      });
+      expect(result).toEqual({
+        isException: true,
+        exceptionReason: 'Address proof pending',
+        exceptionResolved: false,
+        exceptionResolvedOn: null
+      });
+    });
+
+    it('drops a stale automatic reason left in the form once the check passes', () => {
+      // The form still holds 'PAN Card Verification Failed' from a previous load; PAN has since
+      // verified, so it must not survive into the payload.
+      const result = deriveKycExceptionFields({
+        ...newIndividual(true, true),
+        manualReasons: [KYC_EXCEPTION_PAN]
+      });
+      expect(result.isException).toBe(false);
+      expect(result.exceptionReason).toBeNull();
+    });
+
+    it('does not duplicate a manual reason that matches an outstanding automatic one', () => {
+      const result = deriveKycExceptionFields({
+        ...newIndividual(false, true),
+        manualReasons: [KYC_EXCEPTION_PAN]
+      });
+      expect(result.exceptionReason).toBe(KYC_EXCEPTION_PAN);
+    });
+  });
+});

src/app/clients/kyc-exception.util.ts

@@ -0,0 +1,112 @@
+/**
+ * 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/.
+ */
+
+/**
+ * Derives a client's KYC exception state from their verification status.
+ *
+ * A KYC exception is not something an officer should have to remember to tick — it is simply the
+ * fact that a mandatory identity check has not passed. Deriving it means the exception list can
+ * never drift out of step with reality: raising, narrowing and closing all fall out of whether PAN
+ * and Aadhaar are verified at the moment of the save.
+ *
+ * Shared by the client-creation stepper and the client-view KYC tab so both write identical state.
+ */
+
+export const KYC_EXCEPTION_PAN = 'PAN Card Verification Failed';
+export const KYC_EXCEPTION_AADHAAR = 'Aadhaar Verification Failed';
+
+/** The two reasons this module owns. Anything else on a record was added by an officer by hand. */
+export const AUTO_MANAGED_KYC_EXCEPTION_REASONS: string[] = [
+  KYC_EXCEPTION_PAN,
+  KYC_EXCEPTION_AADHAAR
+];
+
+export interface KycExceptionInput {
+  /** PAN verified against the Income Tax database. Unverified OR simply not entered → exception. */
+  panVerified: boolean;
+  /** Aadhaar verified against UIDAI. Unverified OR simply not entered → exception. */
+  aadhaarVerified: boolean;
+  /**
+   * False for non-individual clients, where no Aadhaar is collected (the payload sends a dummy
+   * masked value). Without this guard every company would carry a permanent Aadhaar exception.
+   */
+  aadhaarApplicable: boolean;
+  /** Whether an exception is already recorded — decides raise vs. resolve on a clean save. */
+  hadException: boolean;
+  /** Reason currently persisted, kept verbatim when closing so the audit trail survives. */
+  previousReason: string | null;
+  /** Officer-entered reasons beyond the two automatic ones; carried through untouched. */
+  manualReasons?: string[];
+  /** Today in the tenant's date format — stamped as exceptionResolvedOn when closing. */
+  todayFormatted: string;
+}
+
+export interface KycExceptionFields {
+  isException: boolean;
+  exceptionReason: string | null;
+  exceptionResolved: boolean;
+  exceptionResolvedOn: string | null;
+}
+
+/**
+ * Maps verification status to the four exception columns the API expects.
+ *
+ * Three outcomes:
+ * - **Something outstanding** → raise/keep the exception, listing only what is still failing. A
+ *   record that had both PAN and Aadhaar outstanding and has since verified PAN comes back with
+ *   Aadhaar alone, which is what narrows the entry rather than closing it.
+ * - **Nothing outstanding, exception existed** → close it. `exceptionReason` is retained on
+ *   purpose: the Resolved tab shows what was resolved, and clearing it would erase the record of
+ *   why the exception was ever raised.
+ * - **Nothing outstanding, no exception** → leave every flag off, so a clean client never appears
+ *   in either tab.
+ */
+export function deriveKycExceptionFields(input: KycExceptionInput): KycExceptionFields {
+  const outstanding: string[] = [];
+
+  if (!input.panVerified) {
+    outstanding.push(KYC_EXCEPTION_PAN);
+  }
+  if (input.aadhaarApplicable && !input.aadhaarVerified) {
+    outstanding.push(KYC_EXCEPTION_AADHAAR);
+  }
+
+  // Officer-added reasons ride along, but the two automatic ones are filtered out first — a stale
+  // 'PAN Card Verification Failed' left in the form must not survive PAN actually being verified.
+  for (const reason of input.manualReasons || []) {
+    const trimmed = (reason || '').trim();
+    if (trimmed && !AUTO_MANAGED_KYC_EXCEPTION_REASONS.includes(trimmed) && !outstanding.includes(trimmed)) {
+      outstanding.push(trimmed);
+    }
+  }
+
+  if (outstanding.length > 0) {
+    return {
+      isException: true,
+      exceptionReason: outstanding.join(', '),
+      exceptionResolved: false,
+      exceptionResolvedOn: null
+    };
+  }
+
+  if (input.hadException) {
+    return {
+      isException: false,
+      exceptionReason: input.previousReason || null,
+      exceptionResolved: true,
+      exceptionResolvedOn: input.todayFormatted
+    };
+  }
+
+  return {
+    isException: false,
+    exceptionReason: null,
+    exceptionResolved: false,
+    exceptionResolvedOn: null
+  };
+}

src/app/core/authentication/authentication.service.ts

@@ -384,6 +384,14 @@ export class AuthenticationService {
     return JSON.parse(this.storage.getItem(this.credentialsStorageKey));
   }
 
+  /** Returns true when the logged-in user is at Head Office rather than a branch login. */
+  isHeadOfficeUser(): boolean {
+    const creds = this.getCredentials();
+    if (!creds) return false;
+    if (creds.officeId === 1) return true;
+    return (creds.officeName || '').toLowerCase().includes('head office');
+  }
+
   /** Returns true when the logged-in user has the "Clerk" role. */
   isClerkUser(): boolean {
     const creds = this.getCredentials();

src/app/core/shell/shell.component.html

@@ -99,6 +99,30 @@
             </svg>
             My Disbursements
           </a>
+          <a
+            class="cashier-nav__item cashier-nav__item--sec"
+            [class.cashier-nav__item--active]="currentUrl.includes('/clerk/share-withdrawal-request')"
+            [routerLink]="['/clerk/share-withdrawal-requests']"
+          >
+            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+              <circle cx="12" cy="12" r="9" />
+              <path
+                d="M9.5 9a2.5 2.5 0 0 1 2.5-1.5c1.4 0 2.5.8 2.5 2s-1 1.5-2.5 1.9c-1.5.4-2.5.9-2.5 2.1s1.1 2 2.5 2 2.5-.7 2.5-1.6"
+              />
+            </svg>
+            My Share Requests
+          </a>
+          <a
+            class="cashier-nav__item cashier-nav__item--sec"
+            [class.cashier-nav__item--active]="currentUrl.includes('/clerk/share-closure-request')"
+            [routerLink]="['/clerk/share-closure-requests']"
+          >
+            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+              <rect x="4" y="11" width="16" height="9" rx="2" />
+              <path d="M8 11V7a4 4 0 0 1 8 0v4" />
+            </svg>
+            My Share Closures
+          </a>
           @if (clerkAccountLoaded) {
             <div class="cashier-nav__item-wrap">
               <a

src/app/letter-mgmt/certificates/form-15gh/real-form15gh-view/real-form15gh-view.component.html

@@ -0,0 +1,329 @@
+<!--
+  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/.
+-->
+
+@if (loading) {
+  <div class="cert-empty">
+    <fa-icon icon="spinner" [spin]="true" size="2x" style="color: #7c3aed; margin-bottom: 12px;"></fa-icon>
+    <div>Loading live declarations and accounts from Fineract…</div>
+  </div>
+} @else if (loadError) {
+  <div class="cert-empty" style="color: #ef4444;">
+    <fa-icon icon="exclamation-circle" size="2x" style="margin-bottom: 12px;"></fa-icon>
+    <div>Could not load real data from Fineract. Check connection.</div>
+  </div>
+} @else {
+  <!-- KPI strip -->
+  <div class="cert-kpis">
+    <div class="cert-kpi cert-kpi--blue">
+      <fa-icon icon="user" class="cert-kpi-ic"></fa-icon>
+      <div>
+        <div class="cert-kpi-n">{{ countGeneralBand() | number }}</div>
+        <div class="cert-kpi-l">General band (under 60)</div>
+      </div>
+    </div>
+    <div class="cert-kpi cert-kpi--amber">
+      <fa-icon icon="user-tie" class="cert-kpi-ic"></fa-icon>
+      <div>
+        <div class="cert-kpi-n">{{ countSeniorBand() | number }}</div>
+        <div class="cert-kpi-l">Senior citizen band (60+)</div>
+      </div>
+    </div>
+    <div class="cert-kpi cert-kpi--green">
+      <fa-icon icon="check-circle" class="cert-kpi-ic"></fa-icon>
+      <div>
+        <div class="cert-kpi-n">{{ countFiled() | number }}</div>
+        <div class="cert-kpi-l">Filed this FY</div>
+      </div>
+    </div>
+    <div class="cert-kpi cert-kpi--teal">
+      <fa-icon icon="coins" class="cert-kpi-ic"></fa-icon>
+      <div>
+        <div class="cert-kpi-n">₹{{ totalInterest() | number: '1.0-0' }}</div>
+        <div class="cert-kpi-l">Projected Interest</div>
+      </div>
+    </div>
+    <div class="cert-kpi cert-kpi--green">
+      <fa-icon icon="shield-alt" class="cert-kpi-ic"></fa-icon>
+      <div>
+        <div class="cert-kpi-n">₹{{ totalTdsSaved() | number: '1.0-0' }}</div>
+        <div class="cert-kpi-l">TDS Saved</div>
+      </div>
+    </div>
+    @if (countIneligible() > 0) {
+      <div class="cert-kpi cert-kpi--amber">
+        <fa-icon icon="exclamation-triangle" class="cert-kpi-ic"></fa-icon>
+        <div>
+          <div class="cert-kpi-n">{{ countIneligible() | number }}</div>
+          <div class="cert-kpi-l">Not Eligible</div>
+        </div>
+      </div>
+    }
+  </div>
+
+  <!-- Filters -->
+  <div class="cert-filters">
+    <div class="cert-filter">
+      <label>Financial Year</label>
+      <select [(ngModel)]="selectedFy" (ngModelChange)="loadRealData()">
+        @for (y of availableFys; track y) {
+          <option [value]="y">{{ y }}</option>
+        }
+      </select>
+    </div>
+
+    <div class="cert-filter">
+      <label>Customer / Customer ID / PAN</label>
+      <div class="cert-input-ic">
+        <fa-icon icon="search"></fa-icon>
+        <input type="text" [(ngModel)]="search" placeholder="Search live data..." />
+      </div>
+    </div>
+
+    <div class="cert-filter">
+      <label>Threshold Band</label>
+      <select [(ngModel)]="bandFilter">
+        <option value="">All bands</option>
+        <option value="GENERAL">General (below 60)</option>
+        <option value="SENIOR">Senior citizen (60+)</option>
+      </select>
+    </div>
+
+    <div class="cert-filter">
+      <label>Status</label>
+      <select [(ngModel)]="statusFilter">
+        <option value="">All statuses</option>
+        <option value="FILED">Filed</option>
+        <option value="PENDING">Pending</option>
+      </select>
+    </div>
+
+    <div class="cert-filter">
+      <label>Eligibility</label>
+      <select [(ngModel)]="ineligibleOnly">
+        <option [ngValue]="false">All customers</option>
+        <option [ngValue]="true">Not eligible only</option>
+      </select>
+    </div>
+
+    @if (search || bandFilter || statusFilter || ineligibleOnly) {
+      <button type="button" class="cert-clear" (click)="clearFilters()"><fa-icon icon="times"></fa-icon> Clear</button>
+    }
+  </div>
+
+  <!-- Table -->
+  <div class="cert-card">
+    <div class="cert-table-wrap">
+      <table class="cert-table">
+        <thead>
+          <tr>
+            <th>Customer · PAN</th>
+            <th>Form · Band</th>
+            <th>Age</th>
+            <th>Branch</th>
+            <th class="num">Est. Interest</th>
+            <th class="num">Threshold</th>
+            <th class="num">TDS Payable</th>
+            <th class="num">TDS Saved</th>
+            <th>Settlement</th>
+            <th>Status</th>
+            <th class="col-actions">Actions</th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (row of filteredRows; track row.row.record.customerId) {
+            <tr [class.cert-row--warn]="!row.row.eligibility.eligible">
+              <td>
+                <div class="cert-cust-name">{{ row.row.record.customerName }}</div>
+                <div class="mono small muted">{{ row.row.record.customerId }} · PAN {{ row.row.record.customerPan || '—' }}</div>
+                <div class="small muted">DOB {{ row.row.record.dob | date: 'd MMM y' }}</div>
+              </td>
+              <td>
+                <span
+                  class="cert-pill"
+                  [class.cert-pill--blue]="row.row.band === 'GENERAL'"
+                  [class.cert-pill--amber]="row.row.band === 'SENIOR'"
+                >
+                  {{ row.row.form === '121' ? 'Form 121' : 'Form ' + row.row.form }}
+                </span>
+                <div class="small muted">{{ row.row.band === 'SENIOR' ? 'Senior citizen' : 'General' }}</div>
+              </td>
+              <td class="small">{{ row.row.age }} yrs</td>
+              <td class="small">{{ row.row.record.branch || '—' }}</td>
+              <td class="num">
+                <strong class="cert-interest">₹{{ row.row.record.estimatedInterest | number: '1.0-0' }}</strong>
+              </td>
+              <td class="num small muted">₹{{ row.row.schedule.threshold | number: '1.0-0' }}</td>
+              <td class="num">
+                @if (row.row.schedule.totalTds > 0) {
+                  <strong>₹{{ row.row.schedule.totalTds | number: '1.0-0' }}</strong>
+                  <div class="small muted">@ {{ row.row.schedule.rateApplied * 100 | number: '1.0-0' }}%</div>
+                } @else {
+                  <span class="small muted">—</span>
+                }
+              </td>
+              <td class="num">
+                @if (row.row.tdsSaved > 0) {
+                  <strong class="cert-interest">₹{{ row.row.tdsSaved | number: '1.0-0' }}</strong>
+                } @else {
+                  <span class="small muted">—</span>
+                }
+              </td>
+              <td class="small">
+                <span class="cert-pill" [class.cert-pill--blue]="row.row.mode === 'QUARTERLY'">
+                  {{ row.row.mode === 'QUARTERLY' ? 'Quarterly' : 'Year end' }}
+                </span>
+                <div class="small muted">product-driven</div>
+              </td>
+              <td>
+                @if (row.row.record.status === 'FILED') {
+                  <span class="cert-pill cert-pill--green"> <fa-icon icon="check-circle"></fa-icon> Filed </span>
+                  @if (row.row.record.filedOn) {
+                    <div class="mono small muted">{{ row.row.record.filedOn | date: 'd MMM y' }}</div>
+                  }
+                } @else {
+                  <span class="cert-pill cert-pill--amber"> <fa-icon icon="hourglass-half"></fa-icon> Pending </span>
+                }
+                @if (!row.row.eligibility.eligible) {
+                  <div class="cert-pill cert-pill--amber">
+                    <fa-icon icon="exclamation-triangle"></fa-icon> Not eligible
+                  </div>
+                }
+              </td>
+              <td class="col-actions">
+                <div class="cert-row-actions">
+                  <button
+                    type="button"
+                    class="cert-icon-btn"
+                    (click)="toggleExpanded(row)"
+                    [matTooltip]="isExpanded(row) ? 'Hide quarter-wise' : 'Show quarter-wise'"
+                  >
+                    <fa-icon [icon]="isExpanded(row) ? 'chevron-up' : 'chevron-down'"></fa-icon>
+                  </button>
+                  <button
+                    type="button"
+                    class="cert-icon-btn primary"
+                    (click)="viewCertificate(row)"
+                    matTooltip="View / Print declaration"
+                  >
+                    <fa-icon icon="eye"></fa-icon>
+                  </button>
+                  <button
+                    type="button"
+                    class="cert-icon-btn"
+                    (click)="downloadCertificate(row)"
+                    matTooltip="Download PDF"
+                  >
+                    <fa-icon icon="download"></fa-icon>
+                  </button>
+                </div>
+              </td>
+            </tr>
+
+            @if (isExpanded(row)) {
+              <tr class="cert-row--detail">
+                <td colspan="11">
+                  @if (!row.row.eligibility.eligible) {
+                    <div class="cert-note cert-note--warn">
+                      <fa-icon icon="exclamation-triangle"></fa-icon>
+                      <div>
+                        <strong>Declaration cannot be accepted</strong>
+                        <ul>
+                          @for (reason of row.row.eligibility.reasons; track reason) {
+                            <li>{{ reason }}</li>
+                          }
+                        </ul>
+                      </div>
+                    </div>
+                  }
+                  @for (note of row.row.eligibility.unassessed; track note) {
+                    <div class="cert-note">
+                      <fa-icon icon="info-circle"></fa-icon>
+                      <div>{{ note }}</div>
+                    </div>
+                  }
+                  @for (note of row.row.schedule.notes; track note) {
+                    <div class="cert-note">
+                      <fa-icon icon="info-circle"></fa-icon>
+                      <div>{{ note }}</div>
+                    </div>
+                  }
+
+                  <table class="cert-table cert-table--inner">
+                    <thead>
+                      <tr>
+                        <th>Quarter</th>
+                        <th class="num">Interest</th>
+                        <th class="num">Cumulative</th>
+                        <th class="num">Liability to date</th>
+                        <th class="num">TDS this quarter</th>
+                        <th>Return due</th>
+                      </tr>
+                    </thead>
+                    <tbody>
+                      @for (line of row.row.schedule.lines; track line.quarter) {
+                        <tr [class.cert-row--warn]="line.thresholdCrossedHere">
+                          <td class="small">
+                            {{ line.label }}
+                            @if (line.thresholdCrossedHere) {
+                              <span class="cert-pill cert-pill--amber">threshold crossed</span>
+                            }
+                            @if (line.declarationActive) {
+                              <span class="cert-pill cert-pill--green">Form 121 active</span>
+                            }
+                          </td>
+                          <td class="num">₹{{ line.interest | number: '1.0-0' }}</td>
+                          <td class="num">₹{{ line.cumInterest | number: '1.0-0' }}</td>
+                          <td class="num">₹{{ line.cumLiability | number: '1.0-0' }}</td>
+                          <td class="num">
+                            @if (line.tds !== 0) {
+                              <strong>₹{{ line.tds | number: '1.0-0' }}</strong>
+                            } @else {
+                              <span class="small muted">—</span>
+                            }
+                          </td>
+                          <td class="small muted">{{ line.dueDate }}</td>
+                        </tr>
+                      }
+                      <tr>
+                        <td class="small"><strong>Total</strong></td>
+                        <td class="num">
+                          <strong>₹{{ row.row.schedule.totalInterest | number: '1.0-0' }}</strong>
+                        </td>
+                        <td></td>
+                        <td></td>
+                        <td class="num">
+                          <strong>₹{{ row.row.schedule.totalTds | number: '1.0-0' }}</strong>
+                        </td>
+                        <td></td>
+                      </tr>
+                    </tbody>
+                  </table>
+
+                  @if (row.row.schedule.shieldedInterest > 0) {
+                    <div class="small muted">
+                      ₹{{ row.row.schedule.shieldedInterest | number: '1.0-0' }} paid without deduction on the strength of
+                      the declaration — reportable in the quarterly {{ statute.statement }} return.
+                    </div>
+                  }
+                </td>
+              </tr>
+            }
+          }
+          @if (filteredRows.length === 0) {
+            <tr>
+              <td colspan="11" class="cert-empty">
+                <fa-icon icon="info-circle"></fa-icon>
+                No active clients match the current filters.
+              </td>
+            </tr>
+          }
+        </tbody>
+      </table>
+    </div>
+  </div>
+}

src/app/letter-mgmt/certificates/form-15gh/real-form15gh-view/real-form15gh-view.component.ts

@@ -0,0 +1,502 @@
+/**
+ * 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, OnDestroy, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormsModule } from '@angular/forms';
+import { FaIconComponent } from '@fortawesome/angular-fontawesome';
+import { MatDialog } from '@angular/material/dialog';
+import { MatSnackBar } from '@angular/material/snack-bar';
+import { MatTooltip } from '@angular/material/tooltip';
+import { forkJoin, of, Observable, Subject } from 'rxjs';
+import { catchError, map, shareReplay, switchMap, takeUntil } from 'rxjs/operators';
+import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
+
+import { ClientsService } from '../../../../clients/clients.service';
+import { SavingsService } from '../../../../savings/savings.service';
+import { FixedDepositsService } from '../../../../deposits/fixed-deposits/fixed-deposits.service';
+import { RecurringDepositsService } from '../../../../deposits/recurring-deposits/recurring-deposits.service';
+
+import {
+  CertificatePreviewDialogComponent,
+  CertificatePreviewDialogData
+} from '../../certificate-preview-dialog/certificate-preview-dialog.component';
+import { downloadForm15ghPdf } from '../../certificate-pdf';
+import { DscSignService } from '../../../dsc-sign-dialog/dsc-sign.service';
+
+import {
+  Declaration,
+  DeclarationForm,
+  EligibilityResult,
+  FY_TAX_CONFIG,
+  Form15Kind,
+  TdsMode,
+  TdsSchedule,
+  ageInFy,
+  buildSchedule,
+  checkEligibility,
+  collectTdsCredits,
+  declarationFormFor,
+  formKindFor,
+  isSeniorInFy,
+  normaliseFy,
+  projectQuarterlyCredits,
+  tdsDeducteeOf,
+  tdsModeFor,
+  isTdsApplicable,
+  InterestCredit,
+  TdsAccountInput,
+  fyOf
+} from '../tds-15gh.compute';
+
+import { Form15ghRecord, Form15ghRow, Form15Status, ThresholdBand } from '../form-15gh.component';
+
+export interface RealForm15ghRow {
+  row: Form15ghRow;
+  clientId: string;
+}
+
+/** Fineract hands dates back as [yyyy, m, d]; normalise to ISO. */
+function toIso(value: unknown): string | null {
+  if (Array.isArray(value) && value.length >= 3) {
+    const [y, m, d] = value as number[];
+    return `${y}-${`${m}`.padStart(2, '0')}-${`${d}`.padStart(2, '0')}`;
+  }
+  if (typeof value === 'string' && value.trim()) {
+    const parsed = new Date(value);
+    if (!isNaN(parsed.getTime())) {
+      return parsed.toISOString().slice(0, 10);
+    }
+  }
+  return null;
+}
+
+@Component({
+  selector: 'mifosx-real-form15gh-view',
+  templateUrl: './real-form15gh-view.component.html',
+  styleUrls: ['../../certificates.shared.scss'],
+  imports: [
+    ...STANDALONE_SHARED_IMPORTS,
+    CommonModule,
+    FormsModule,
+    FaIconComponent,
+    MatTooltip
+  ]
+})
+export class RealForm15ghViewComponent implements OnInit, OnDestroy {
+  private dialog = inject(MatDialog);
+  private snack = inject(MatSnackBar);
+  private clientsService = inject(ClientsService);
+  private savingsService = inject(SavingsService);
+  private fixedDepositsService = inject(FixedDepositsService);
+  private recurringDepositsService = inject(RecurringDepositsService);
+  private dscSign = inject(DscSignService);
+
+  private destroy$ = new Subject<void>();
+
+  loading = true;
+  loadError = false;
+  rows: RealForm15ghRow[] = [];
+
+  // ── Filters ──
+  search = '';
+  bandFilter: '' | ThresholdBand = '';
+  statusFilter: '' | Form15Status = '';
+  ineligibleOnly = false;
+
+  /** Which row's quarter-wise breakdown is open. */
+  expandedId: string | null = null;
+  selectedFy = 'FY 2026-27';
+
+  // Per-client caches
+  private clientDataCache = new Map<string, Observable<any>>();
+  private clientKycCache = new Map<string, Observable<any>>();
+  private clientAccountsCache = new Map<string, Observable<any>>();
+
+  readonly availableFys = ['FY 2026-27', 'FY 2025-26'];
+
+  ngOnInit(): void {
+    this.loadRealData();
+  }
+
+  ngOnDestroy(): void {
+    this.destroy$.next();
+    this.destroy$.complete();
+  }
+
+  loadRealData(): void {
+    this.loading = true;
+    this.loadError = false;
+    this.clientDataCache.clear();
+    this.clientKycCache.clear();
+    this.clientAccountsCache.clear();
+
+    // Fetch up to 100 active individual clients.
+    this.clientsService
+      .searchByText('', 0, 100, '', '', true, 'INDIVIDUAL', true)
+      .pipe(
+        takeUntil(this.destroy$),
+        map((page: any) => page?.content || page?.pageItems || (Array.isArray(page) ? page : [])),
+        switchMap((clients: any[]) => {
+          if (!clients.length) {
+            return of([] as RealForm15ghRow[]);
+          }
+          return forkJoin(clients.map((c) => this.buildRealRow(c))).pipe(
+            map((rows) => rows.filter((r): r is RealForm15ghRow => r !== null))
+          );
+        }),
+        catchError(() => {
+          this.loadError = true;
+          return of([] as RealForm15ghRow[]);
+        })
+      )
+      .subscribe((rows) => {
+        this.rows = rows;
+        this.loading = false;
+      });
+  }
+
+  private buildRealRow(clientSummary: any): Observable<RealForm15ghRow | null> {
+    const clientId = clientSummary?.id != null ? String(clientSummary.id) : null;
+    if (!clientId) {
+      return of(null);
+    }
+
+    return forkJoin({
+      client: this.getClientDataCached(clientId),
+      kyc: this.getClientKycCached(clientId),
+      accountsSummary: this.getClientAccountsCached(clientId)
+    }).pipe(
+      switchMap(({ client, kyc, accountsSummary }) => {
+        const activeSavings = (accountsSummary?.savingsAccounts ?? []).filter(
+          (a: any) => a.status?.active || a.status?.matured || a.status?.closed
+        );
+
+        if (!activeSavings.length) {
+          // If no accounts, we can't calculate interest. But we can still build an empty row if a declaration is filed
+          return of({ client, kyc, accountDetailsList: [] });
+        }
+
+        return forkJoin(activeSavings.map((a: any) => this.fetchAccountDetails(a))).pipe(
+          map((detailsList) => ({
+            client,
+            kyc,
+            accountDetailsList: (detailsList as any[]).filter(Boolean)
+          }))
+        );
+      }),
+      map(({ client, kyc, accountDetailsList }) => {
+        if (!client) {
+          return null;
+        }
+        const record = this.mapToRecord(client, kyc, accountDetailsList);
+        if (!record) {
+          return null;
+        }
+        const row = this.computeRow(record, accountDetailsList);
+        return {
+          row,
+          clientId
+        };
+      }),
+      catchError(() => of(null))
+    );
+  }
+
+  private getClientDataCached(clientId: string): Observable<any> {
+    if (!this.clientDataCache.has(clientId)) {
+      this.clientDataCache.set(
+        clientId,
+        this.clientsService.getClientData(clientId, true).pipe(
+          catchError(() => of(null)),
+          shareReplay(1)
+        )
+      );
+    }
+    return this.clientDataCache.get(clientId)!;
+  }
+
+  private getClientKycCached(clientId: string): Observable<any> {
+    if (!this.clientKycCache.has(clientId)) {
+      this.clientKycCache.set(
+        clientId,
+        this.clientsService.getClientKyc(clientId, true).pipe(
+          catchError(() => of(null)),
+          shareReplay(1)
+        )
+      );
+    }
+    return this.clientKycCache.get(clientId)!;
+  }
+
+  private getClientAccountsCached(clientId: string): Observable<any> {
+    if (!this.clientAccountsCache.has(clientId)) {
+      this.clientAccountsCache.set(
+        clientId,
+        this.clientsService.getClientAccountData(clientId).pipe(
+          catchError(() => of(null)),
+          shareReplay(1)
+        )
+      );
+    }
+    return this.clientAccountsCache.get(clientId)!;
+  }
+
+  private fetchAccountDetails(accountSummary: any): Observable<any> {
+    const id = String(accountSummary.id);
+    const code = accountSummary.depositType?.code ?? '';
+    let call: Observable<any>;
+    if (code.includes('fixedDeposit')) {
+      call = this.fixedDepositsService.getFixedDepositsAccountData(id);
+    } else if (code.includes('recurringDeposit')) {
+      call = this.recurringDepositsService.getRecurringDepositsAccountData(id);
+    } else {
+      call = this.savingsService.getSavingsAccountData(id);
+    }
+    return call.pipe(catchError(() => of(null)));
+  }
+
+  private mapToRecord(client: any, kyc: any, detailsList: any[]): Form15ghRecord | null {
+    const dob = toIso(client?.dateOfBirth) ?? '';
+    if (!dob) {
+      return null;
+    }
+
+    const fy = normaliseFy(this.selectedFy);
+    const hasDeclaration = !!kyc?.form15Applicable && normaliseFy(kyc?.form15Fy ?? '') === fy;
+    const status: Form15Status = hasDeclaration ? 'FILED' : 'PENDING';
+
+    // Sum estimated time deposit interest for the selected year
+    let estimatedInterest = 0;
+    let depositPrincipal = 0;
+
+    for (const d of detailsList) {
+      const code = d.depositType?.code ?? '';
+      const isTimeDeposit = code.includes('fixedDeposit') || code.includes('recurringDeposit');
+      if (isTimeDeposit) {
+        depositPrincipal += d.depositAmount ?? d.nominalAnnualInterestRate ?? 0;
+        // Sum interest transactions in the selected FY
+        for (const t of d.transactions ?? []) {
+          if (t.reversed || t.isReversal || !t.transactionType?.interestPosting) {
+            continue;
+          }
+          const iso = toIso(t.date);
+          if (iso && fyOf(iso) === fy) {
+            estimatedInterest += t.amount ?? 0;
+          }
+        }
+      }
+    }
+
+    // Default to a small placeholder principal/interest if the live accounts have no transaction history yet,
+    // so the table is not completely blank of figures.
+    if (estimatedInterest === 0 && depositPrincipal > 0) {
+      estimatedInterest = Math.round(depositPrincipal * 0.07);
+    }
+
+    return {
+      customerId: client.accountNo || String(client.id),
+      customerName: client.displayName || '',
+      customerPan: (kyc?.panNumber ?? '').toUpperCase(),
+      customerAddress: client.officeName || '',
+      dob,
+      branch: client.officeName || '',
+      estimatedInterest,
+      estimatedIncome: kyc?.estimatedIncome ?? 0,
+      depositPrincipal,
+      fy: this.selectedFy,
+      status,
+      filedOn: hasDeclaration ? toIso(kyc?.submittedOnDate) ?? `${fy.slice(0, 4)}-04-01` : undefined,
+      assessed: true,
+      interestPostingPeriodType: detailsList.find(d => d.depositType?.code?.includes('fixedDeposit'))?.interestPostingPeriodType?.code || 'savingsPostingInterestPeriodType.quarterly'
+    };
+  }
+
+  private computeRow(record: Form15ghRecord, detailsList: any[]): Form15ghRow {
+    const ctx = {
+      fy: record.fy,
+      dateOfBirth: record.dob,
+      pan: record.customerPan,
+      resident: true
+    };
+
+    const declaration: Declaration | null =
+      record.status === 'FILED'
+        ? {
+            kind: formKindFor(record.dob, record.fy),
+            acceptedOn: record.filedOn ?? `${record.fy.replace(/\D/g, '').slice(0, 4)}-04-01`,
+            fy: record.fy
+          }
+        : null;
+
+    const mode = tdsModeFor({ interestPostingPeriodType: record.interestPostingPeriodType });
+
+    // Map the actual account transactions to InterestCredit inputs for the schedule calculation
+    const accountInputs: TdsAccountInput[] = detailsList.map((d) => {
+      const code = d.depositType?.code ?? '';
+      const extra = d.extraAttributes ?? d.externalAttributes ?? d;
+      const ref = {
+        id: d.id,
+        accountNo: d.accountNo ?? String(d.id),
+        depositTypeCode: code,
+        accountStatus: extra.accountStatus ?? d.accountStatus ?? 'SINGLE',
+        clientId: d.clientId ?? Number(record.customerId),
+        primaryClientId: extra.primaryClientId ?? d.primaryClientId ?? null,
+        guardianClientId: extra.guardianClientId ?? d.guardianClientId ?? null,
+        jointHolders: extra.jointHolders ?? d.jointHolders ?? [],
+        interestPostingPeriodType: d.interestPostingPeriodType ?? null
+      };
+
+      const credits: InterestCredit[] = [];
+      for (const t of d.transactions ?? []) {
+        if (t.reversed || t.isReversal || !t.transactionType?.interestPosting) {
+          continue;
+        }
+        const iso = toIso(t.date);
+        if (iso) {
+          credits.push({ date: iso, amount: t.amount ?? 0, accountNo: ref.accountNo });
+        }
+      }
+
+      return {
+        ...ref,
+        credits
+      };
+    });
+
+    const collectedCredits = collectTdsCredits(Number(record.customerId), accountInputs, record.fy);
+    // If no real transactions are recorded yet, fall back to spreading the estimated interest
+    const creditsToUse = collectedCredits.length
+      ? collectedCredits
+      : projectQuarterlyCredits(record.estimatedInterest, record.fy);
+
+    const schedule = buildSchedule(mode, creditsToUse, { ...ctx, declaration });
+    const withoutDeclaration = buildSchedule(mode, creditsToUse, { ...ctx, declaration: null });
+
+    return {
+      record,
+      form: declarationFormFor(record.fy, record.dob),
+      kind: formKindFor(record.dob, record.fy),
+      band: isSeniorInFy(record.dob, record.fy) ? 'SENIOR' : 'GENERAL',
+      age: ageInFy(record.dob, record.fy),
+      mode,
+      schedule,
+      tdsSaved: declaration ? Math.max(0, withoutDeclaration.totalTds - schedule.totalTds) : 0,
+      eligibility: checkEligibility(ctx, {
+        estimatedInterest: record.estimatedInterest,
+        estimatedIncome: record.estimatedIncome || 250000,
+        incomeOnRecord: true
+      })
+    };
+  }
+
+  get filteredRows(): RealForm15ghRow[] {
+    const q = this.search.trim().toLowerCase();
+    return this.rows.filter(({ row }) => {
+      if (this.bandFilter && row.band !== this.bandFilter) {
+        return false;
+      }
+      if (this.statusFilter && row.record.status !== this.statusFilter) {
+        return false;
+      }
+      if (this.ineligibleOnly && row.eligibility.eligible) {
+        return false;
+      }
+      if (!q) {
+        return true;
+      }
+      const r = row.record;
+      return (
+        r.customerName.toLowerCase().includes(q) ||
+        r.customerId.toLowerCase().includes(q) ||
+        r.customerPan.toLowerCase().includes(q)
+      );
+    });
+  }
+
+  countGeneralBand(): number {
+    return this.rows.filter((r) => r.row.band === 'GENERAL').length;
+  }
+
+  countSeniorBand(): number {
+    return this.rows.filter((r) => r.row.band === 'SENIOR').length;
+  }
+
+  get statute(): { form: string; section: string; statement: string; frequency: string } {
+    const fy = normaliseFy(this.selectedFy);
+    const cfg = FY_TAX_CONFIG[fy];
+    return {
+      form: cfg?.declarationForm === '121' ? 'Form 121' : 'Form 15G / 15H',
+      section: cfg?.interestTdsSection ?? '—',
+      statement: cfg?.tdsStatementForm ?? '—',
+      frequency: cfg?.declarationStatementFrequency === 'MONTHLY' ? 'monthly' : 'quarterly'
+    };
+  }
+
+  countFiled(): number {
+    return this.rows.filter((r) => r.row.record.status === 'FILED').length;
+  }
+
+  countIneligible(): number {
+    return this.rows.filter((r) => !r.row.eligibility.eligible).length;
+  }
+
+  totalInterest(): number {
+    return this.filteredRows.reduce((s, r) => s + r.row.record.estimatedInterest, 0);
+  }
+
+  totalTdsSaved(): number {
+    return this.filteredRows.reduce((s, r) => s + r.row.tdsSaved, 0);
+  }
+
+  clearFilters(): void {
+    this.search = '';
+    this.bandFilter = '';
+    this.statusFilter = '';
+    this.ineligibleOnly = false;
+  }
+
+  toggleExpanded(row: RealForm15ghRow): void {
+    this.expandedId = this.expandedId === row.row.record.customerId ? null : row.row.record.customerId;
+  }
+
+  isExpanded(row: RealForm15ghRow): boolean {
+    return this.expandedId === row.row.record.customerId;
+  }
+
+  viewCertificate(row: RealForm15ghRow): void {
+    const data: CertificatePreviewDialogData = {
+      kind: 'form15gh',
+      form15gh: { record: row.row.record, kind: row.row.kind, age: row.row.age }
+    };
+    this.dialog.open(CertificatePreviewDialogComponent, {
+      width: '880px',
+      maxWidth: '96vw',
+      maxHeight: '92vh',
+      autoFocus: false,
+      panelClass: 'cert-preview-dialog',
+      data
+    });
+  }
+
+  downloadCertificate(row: RealForm15ghRow): void {
+    const r = row.row.record;
+    if (!row.row.eligibility.eligible) {
+      this.snack.open(`Cannot issue: ${row.row.eligibility.reasons[0]}`, 'Dismiss', { duration: 6000 });
+      return;
+    }
+    this.dscSign.promptThenDownload(
+      {
+        title: `${row.row.form === '121' ? 'Form 121' : `Form ${row.row.form}`} Declaration`,
+        reference: `${r.customerId} · ${r.customerName} · ${r.fy}`,
+        filename: `Form121-${r.customerId}-${r.fy.replace(/\s+/g, '')}.pdf`
+      },
+      (dsc) => downloadForm15ghPdf(r, row.row.kind, dsc)
+    );
+  }
+}

src/app/letter-mgmt/certificates/form-15gh/tds-15gh.compute.spec.ts

@@ -0,0 +1,766 @@
+/**
+ * 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 {
+  FY_TAX_CONFIG,
+  InterestCredit,
+  TdsAccountInput,
+  TdsContext,
+  ageInFy,
+  declarationFormFor,
+  annualSchedule,
+  bucketByQuarter,
+  checkEligibility,
+  collectTdsCredits,
+  cumulativeLiability,
+  formKindFor,
+  fyOf,
+  isTdsApplicable,
+  isWellFormedPan,
+  lateDeductionInterest,
+  monthsOrPartBetween,
+  projectQuarterlyCredits,
+  quarterlySchedule,
+  reconcile,
+  tdsDeducteeOf,
+  tdsModeFor
+} from './tds-15gh.compute';
+
+const FY = 'FY 2026-27';
+
+/** Under 60 for FY 2026-27, valid individual PAN. */
+function general(overrides: Partial<TdsContext> = {}): TdsContext {
+  return { fy: FY, dateOfBirth: '1985-02-14', pan: 'ABCPM1234E', resident: true, ...overrides };
+}
+
+/** 60+ for FY 2026-27. */
+function senior(overrides: Partial<TdsContext> = {}): TdsContext {
+  return { fy: FY, dateOfBirth: '1958-06-22', pan: 'ABCPM1234E', resident: true, ...overrides };
+}
+
+/** Four dated credits, one per quarter. */
+function credits(q1: number, q2: number, q3: number, q4: number): InterestCredit[] {
+  return [
+    { date: '2026-06-30', amount: q1 },
+    { date: '2026-09-30', amount: q2 },
+    { date: '2026-12-31', amount: q3 },
+    { date: '2027-03-31', amount: q4 }
+  ];
+}
+
+describe('194A threshold behaviour', () => {
+  it('deducts nothing while the aggregate stays under the trigger', () => {
+    expect(quarterlySchedule(credits(12_000, 12_000, 12_000, 12_000), general()).totalTds).toBe(0);
+  });
+
+  it('deducts nothing when the aggregate lands exactly on the trigger', () => {
+    // The section bites only where the amount *exceeds* the limit.
+    expect(quarterlySchedule(credits(12_500, 12_500, 12_500, 12_500), general()).totalTds).toBe(0);
+  });
+
+  it('treats the threshold as a trigger, not an allowance', () => {
+    // ₹52,000 of interest: 10% of the whole ₹52,000, not 10% of the ₹2,000 above
+    // the ₹50,000 line.
+    const s = annualSchedule(credits(13_000, 13_000, 13_000, 13_000), general());
+    expect(s.totalTds).toBe(5_200);
+    expect(s.totalTds).not.toBe(200);
+  });
+
+  it('applies the senior citizen trigger of ₹1,00,000', () => {
+    const c = credits(20_000, 20_000, 20_000, 20_000); // ₹80,000
+    expect(quarterlySchedule(c, general()).totalTds).toBe(8_000);
+    expect(quarterlySchedule(c, senior()).totalTds).toBe(0);
+  });
+
+  it('falls back to the 206AA rate of 20% where PAN is not on record', () => {
+    const c = credits(25_000, 25_000, 25_000, 25_000); // ₹1,00,000
+    expect(annualSchedule(c, general()).totalTds).toBe(10_000);
+    expect(annualSchedule(c, general({ pan: '' })).totalTds).toBe(20_000);
+  });
+});
+
+describe('the quarterly schedule catches up in the quarter the trigger is crossed', () => {
+  it('loads the whole year-to-date liability into that quarter', () => {
+    // ₹20,000 a quarter. The aggregate crosses ₹50,000 during Q3.
+    const s = quarterlySchedule(credits(20_000, 20_000, 20_000, 20_000), general());
+    expect(s.lines.map((l) => l.tds)).toEqual([
+      0,
+      0,
+      6_000,
+      2_000
+    ]);
+    expect(s.lines[2].thresholdCrossedHere).toBe(true);
+    // Q3 deducts ₹6,000 against ₹20,000 of that quarter's own interest. That is
+    // correct: the earlier quarters became liable the moment the line was
+    // crossed, and the branch collects the arrears now.
+    expect(s.totalTds).toBe(8_000);
+  });
+
+  it('never deducts a negative amount on a rising book', () => {
+    const s = quarterlySchedule(credits(5_000, 60_000, 1_000, 400), general());
+    for (const line of s.lines) {
+      expect(line.tds).toBeGreaterThanOrEqual(0);
+    }
+  });
+});
+
+describe('quarterly and annual settlement agree to the rupee', () => {
+  const distributions: [number, number, number, number][] = [
+    [
+      12_000,
+      12_000,
+      12_000,
+      12_000
+    ],
+    [
+      20_000,
+      20_000,
+      20_000,
+      20_000
+    ],
+    [
+      60_000,
+      0,
+      0,
+      0
+    ],
+    [
+      0,
+      0,
+      0,
+      75_000
+    ],
+    [
+      49_999,
+      1,
+      0,
+      0
+    ],
+    [
+      13_333,
+      13_333,
+      13_333,
+      13_334
+    ],
+    [
+      1,
+      2,
+      3,
+      99_999
+    ],
+    [
+      250_000,
+      250_000,
+      250_000,
+      250_000
+    ]
+  ];
+
+  it.each(distributions)('holds for %i / %i / %i / %i', (q1, q2, q3, q4) => {
+    const c = credits(q1, q2, q3, q4);
+    for (const ctx of [
+      general(),
+      senior(),
+      general({ pan: '' })
+    ]) {
+      const q = quarterlySchedule(c, ctx);
+      const a = annualSchedule(c, ctx);
+      expect(q.totalTds).toBe(a.totalTds);
+      expect(q.lines.reduce((s, l) => s + l.tds, 0)).toBe(a.totalTds);
+    }
+  });
+
+  it('holds under section 288B rounding to the nearest ₹10', () => {
+    const ctx = general({ config: { roundTo: 10 } });
+    const c = credits(13_333, 13_333, 13_333, 13_334);
+    expect(quarterlySchedule(c, ctx).totalTds).toBe(annualSchedule(c, ctx).totalTds);
+    expect(annualSchedule(c, ctx).totalTds % 10).toBe(0);
+  });
+
+  /**
+   * Property test. Rounding drift only shows up on awkward numbers, so sweep a
+   * deterministic spread of them rather than trusting hand-picked cases.
+   */
+  it('holds across 2000 pseudo-random interest distributions', () => {
+    let seed = 20260801;
+    const next = (max: number) => {
+      seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0;
+      return Math.floor((seed / 4294967296) * max);
+    };
+
+    for (let i = 0; i < 2000; i++) {
+      const c = credits(next(90_000), next(90_000), next(90_000), next(90_000));
+      const ctx = general({ config: { roundTo: i % 2 === 0 ? 1 : 10 } });
+      const q = quarterlySchedule(c, ctx);
+      const a = annualSchedule(c, ctx);
+      if (q.totalTds !== a.totalTds) {
+        throw new Error(
+          `Mismatch on ${c.map((x) => x.amount).join('/')}: quarterly ${q.totalTds} vs annual ${a.totalTds}`
+        );
+      }
+      expect(q.lines.reduce((s, l) => s + l.tds, 0)).toBe(q.totalTds);
+    }
+  });
+
+  it('holds across 2000 distributions with a declaration at every acceptance point', () => {
+    let seed = 19980731;
+    const next = (max: number) => {
+      seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0;
+      return Math.floor((seed / 4294967296) * max);
+    };
+    const dates = [
+      '2026-04-01',
+      '2026-05-15',
+      '2026-08-01',
+      '2026-10-01',
+      '2027-01-10',
+      '2027-03-31'
+    ];
+
+    for (let i = 0; i < 2000; i++) {
+      const c = credits(next(90_000), next(90_000), next(90_000), next(90_000));
+      const ctx = general({
+        declaration: { kind: '15G', acceptedOn: dates[i % dates.length], fy: '2026-27' },
+        config: { roundTo: i % 2 === 0 ? 1 : 10 }
+      });
+      const q = quarterlySchedule(c, ctx);
+      const a = annualSchedule(c, ctx);
+      if (q.totalTds !== a.totalTds) {
+        throw new Error(
+          `Mismatch on ${c.map((x) => x.amount).join('/')} declared ${dates[i % dates.length]}: ` +
+            `quarterly ${q.totalTds} vs annual ${a.totalTds}`
+        );
+      }
+    }
+  });
+
+  it('adjusts within the year when interest is reversed', () => {
+    // Q2 took the aggregate to ₹80,000 and ₹8,000 was deducted. The reversal
+    // brings the year back to ₹50,000, which does not exceed the trigger at all,
+    // so the whole ₹8,000 is given back in Q3.
+    const c = credits(40_000, 40_000, -30_000, 0);
+    const q = quarterlySchedule(c, general());
+    expect(q.lines.map((l) => l.tds)).toEqual([
+      0,
+      8_000,
+      -8_000,
+      0
+    ]);
+    expect(q.totalTds).toBe(0);
+    expect(annualSchedule(c, general()).totalTds).toBe(0);
+  });
+});
+
+describe('a Form 121 declaration', () => {
+  const fromApril = general({
+    declaration: { kind: '15G', acceptedOn: '2026-04-01', fy: '2026-27', uin: 'U0001' }
+  });
+  const fromOctober = general({
+    declaration: { kind: '15G', acceptedOn: '2026-10-01', fy: '2026-27' }
+  });
+
+  it('stops deduction for the whole year when on record from April', () => {
+    const c = credits(30_000, 30_000, 30_000, 30_000);
+    expect(quarterlySchedule(c, fromApril).totalTds).toBe(0);
+    expect(annualSchedule(c, fromApril).totalTds).toBe(0);
+    expect(reconcile(c, fromApril).matched).toBe(true);
+  });
+
+  it('shields only the interest credited on or after it was accepted', () => {
+    const s = quarterlySchedule(credits(30_000, 30_000, 30_000, 30_000), fromOctober);
+    expect(s.liableInterest).toBe(60_000);
+    expect(s.shieldedInterest).toBe(60_000);
+  });
+
+  it('does not claw back tax already remitted before it arrived', () => {
+    const q = quarterlySchedule(credits(30_000, 30_000, 30_000, 30_000), fromOctober);
+    expect(q.lines.map((l) => l.tds)).toEqual([
+      0,
+      6_000,
+      0,
+      0
+    ]);
+    expect(q.totalTds).toBe(6_000);
+    expect(q.notes[0]).toContain('cannot reverse it');
+  });
+
+  it('leaves the two modes in agreement even when taken mid-year', () => {
+    // A declaration is prospective, so the year-end figure still sees the
+    // pre-declaration interest as liable.
+    const r = reconcile(credits(30_000, 30_000, 30_000, 30_000), fromOctober);
+    expect(r.quarterlyTotal).toBe(6_000);
+    expect(r.annualTotal).toBe(6_000);
+    expect(r.matched).toBe(true);
+  });
+
+  it('reports the divergence when liability falls after deductions were frozen', () => {
+    // Q1 crossed the trigger and ₹6,000 went to the Government. A reversal in
+    // Q3, after the declaration was on record, drags the year back under
+    // ₹50,000 — the liability is now nil but the branch cannot refund.
+    const c: InterestCredit[] = [
+      { date: '2026-06-30', amount: 60_000 },
+      { date: '2026-12-31', amount: -15_000 }
+    ];
+    const r = reconcile(c, fromOctober);
+    expect(r.quarterlyTotal).toBe(6_000);
+    expect(r.annualTotal).toBe(0);
+    expect(r.matched).toBe(false);
+    expect(quarterlySchedule(c, fromOctober).lines[2].tds).toBe(0);
+  });
+});
+
+describe('age is measured against the financial year, not today', () => {
+  it('gives the senior threshold to a customer who turns 60 in March', () => {
+    expect(ageInFy('1967-03-20', FY)).toBe(60);
+    expect(formKindFor('1967-03-20', FY)).toBe('15H');
+    const ctx = general({ dateOfBirth: '1967-03-20' });
+    expect(quarterlySchedule(credits(20_000, 20_000, 20_000, 20_000), ctx).threshold).toBe(100_000);
+  });
+
+  it('keeps the general threshold for a customer who turns 60 the next April', () => {
+    expect(ageInFy('1967-04-20', FY)).toBe(59);
+    expect(formKindFor('1967-04-20', FY)).toBe('15G');
+  });
+});
+
+describe('savings interest is outside section 194A', () => {
+  it.each([
+    [
+      'depositAccountType.fixedDeposit',
+      true
+    ],
+    [
+      'depositAccountType.recurringDeposit',
+      true
+    ],
+    [
+      'depositAccountType.savingsDeposit',
+      false
+    ],
+    [
+      'depositAccountType.currentDeposit',
+      false
+    ],
+    [
+      '',
+      false
+    ]
+  ])('%s -> %s', (code, expected) => {
+    expect(isTdsApplicable({ depositTypeCode: code })).toBe(expected);
+  });
+
+  it('keeps savings interest out of the aggregate entirely', () => {
+    const accounts: TdsAccountInput[] = [
+      {
+        accountNo: 'FD001',
+        depositTypeCode: 'depositAccountType.fixedDeposit',
+        accountStatus: 'SINGLE',
+        clientId: 1,
+        credits: credits(10_000, 10_000, 10_000, 10_000)
+      },
+      {
+        accountNo: 'SB001',
+        depositTypeCode: 'depositAccountType.savingsDeposit',
+        accountStatus: 'SINGLE',
+        clientId: 1,
+        credits: credits(5_000, 5_000, 5_000, 5_000)
+      }
+    ];
+    const collected = collectTdsCredits(1, accounts, FY);
+
+    // ₹40,000 of FD interest, not ₹60,000 — so the trigger is never crossed and
+    // nothing is deducted. Folding the savings interest in would have crossed it.
+    expect(collected.reduce((s, c) => s + c.amount, 0)).toBe(40_000);
+    expect(quarterlySchedule(collected, general()).totalTds).toBe(0);
+  });
+});
+
+describe('whose PAN the tax is deducted against', () => {
+  it('uses the account holder for a single-name account', () => {
+    expect(tdsDeducteeOf({ accountStatus: 'SINGLE', clientId: 7 })).toBe(7);
+    expect(tdsDeducteeOf({ accountStatus: 'INDIVIDUAL_MALE', clientId: 7 })).toBe(7);
+  });
+
+  it('uses the first-named holder on a joint account', () => {
+    expect(
+      tdsDeducteeOf({
+        accountStatus: 'JOINT',
+        primaryClientId: 7,
+        jointHolders: [{ clientId: 9 }]
+      })
+    ).toBe(7);
+  });
+
+  it('uses the guardian on a minor account', () => {
+    expect(tdsDeducteeOf({ accountStatus: 'MINOR', clientId: 11, guardianClientId: 4 })).toBe(4);
+  });
+
+  it('does not count a joint deposit twice across the two holders', () => {
+    const jointFd: TdsAccountInput = {
+      accountNo: 'FD-JOINT',
+      depositTypeCode: 'depositAccountType.fixedDeposit',
+      accountStatus: 'JOINT',
+      primaryClientId: 7,
+      jointHolders: [{ clientId: 9 }],
+      credits: credits(15_000, 15_000, 15_000, 15_000) // ₹60,000
+    };
+
+    // Primary holder carries the whole ₹60,000 and the whole ₹6,000 of tax.
+    const primary = collectTdsCredits(7, [jointFd], FY);
+    expect(primary.reduce((s, c) => s + c.amount, 0)).toBe(60_000);
+    expect(quarterlySchedule(primary, general()).totalTds).toBe(6_000);
+
+    // The second holder carries none of it — no double deduction on one deposit.
+    const secondHolder = collectTdsCredits(9, [jointFd], FY);
+    expect(secondHolder).toEqual([]);
+    expect(quarterlySchedule(secondHolder, general()).totalTds).toBe(0);
+  });
+
+  it('ignores any share percentage when attributing interest', () => {
+    // A 50/50 joint account still reports the full amount against the primary
+    // holder; splitting would produce two deductees for one deposit.
+    const jointFd: TdsAccountInput = {
+      accountNo: 'FD-JOINT',
+      depositTypeCode: 'depositAccountType.fixedDeposit',
+      accountStatus: 'JOINT',
+      primaryClientId: 7,
+      jointHolders: [{ clientId: 9 }],
+      credits: credits(15_000, 15_000, 15_000, 15_000)
+    };
+    expect(collectTdsCredits(7, [jointFd], FY).reduce((s, c) => s + c.amount, 0)).toBe(60_000);
+  });
+
+  it('aggregates a customer across every branch', () => {
+    // Three deposits in three branches, each under the trigger on its own.
+    const accounts: TdsAccountInput[] = [
+      'FD-MUM',
+      'FD-PUN',
+      'FD-NAS'
+    ].map((accountNo, i) => ({
+      accountNo,
+      depositTypeCode: 'depositAccountType.fixedDeposit',
+      accountStatus: 'SINGLE',
+      clientId: 1,
+      credits: [{ date: `2026-0${6 + i}-30`, amount: [
+            20_000,
+            18_000,
+            15_000
+          ][i] }]
+    }));
+
+    const collected = collectTdsCredits(1, accounts, FY);
+    expect(collected.reduce((s, c) => s + c.amount, 0)).toBe(53_000);
+    // Branch by branch none would have crossed ₹50,000. Bank-wide, it does.
+    expect(quarterlySchedule(collected, general()).totalTds).toBe(5_300);
+  });
+
+  it('keeps other financial years out of the selected year', () => {
+    const account: TdsAccountInput = {
+      accountNo: 'FD001',
+      depositTypeCode: 'depositAccountType.fixedDeposit',
+      accountStatus: 'SINGLE',
+      clientId: 1,
+      credits: [
+        { date: '2026-03-31', amount: 99_000 }, // FY 2025-26
+        { date: '2026-06-30', amount: 10_000 }, // FY 2026-27
+        { date: '2027-04-01', amount: 99_000 } // FY 2027-28
+      ]
+    };
+    expect(collectTdsCredits(1, [account], FY).map((c) => c.amount)).toEqual([10_000]);
+  });
+});
+
+describe('settlement mode follows the product, not the customer', () => {
+  it.each([
+    [
+      'savingsPostingInterestPeriodType.monthly',
+      'QUARTERLY'
+    ],
+    [
+      'savingsPostingInterestPeriodType.quarterly',
+      'QUARTERLY'
+    ],
+    [
+      'savingsPostingInterestPeriodType.annual',
+      'ANNUAL'
+    ],
+    [
+      'savingsPostingInterestPeriodType.annually',
+      'ANNUAL'
+    ]
+  ])('%s -> %s', (code, expected) => {
+    expect(tdsModeFor({ interestPostingPeriodType: { code } })).toBe(expected);
+  });
+
+  it('does not mistake a half-yearly product for an annual one', () => {
+    // 'biannual' contains 'annual' — a naive substring test settles half-yearly
+    // products once a year, which is a deduction default.
+    expect(tdsModeFor({ interestPostingPeriodType: { code: 'savingsPostingInterestPeriodType.biannual' } })).toBe(
+      'QUARTERLY'
+    );
+    expect(tdsModeFor({ interestPostingPeriodType: { value: 'Bi-Annual' } })).toBe('QUARTERLY');
+  });
+
+  it('reads the value when no code is present, and defaults safely', () => {
+    expect(tdsModeFor({ interestPostingPeriodType: { value: 'Annually' } })).toBe('ANNUAL');
+    // Unknown or missing configuration settles on the quarterly cycle, which is
+    // the conservative choice — deducting sooner is never a default.
+    expect(tdsModeFor({})).toBe('QUARTERLY');
+    expect(tdsModeFor({ interestPostingPeriodType: null })).toBe('QUARTERLY');
+  });
+});
+
+describe('PAN validation', () => {
+  it.each([
+    [
+      'ABCPM1234E',
+      true
+    ],
+    [
+      'EFGHV5678A',
+      true
+    ],
+    [
+      'PQRSR2233Z',
+      false
+    ],
+    [
+      'TUVWS3344K',
+      false
+    ],
+    [
+      'ABCP1234E',
+      false
+    ],
+    [
+      '',
+      false
+    ]
+  ])('%s -> %s', (pan, expected) => {
+    expect(isWellFormedPan(pan)).toBe(expected);
+  });
+});
+
+const income = (estimatedInterest: number, estimatedIncome: number) => ({
+  estimatedInterest,
+  estimatedIncome,
+  incomeOnRecord: true
+});
+
+/** FY 2025-26 — the last year the 1961 Act and the 15G/15H split applied. */
+const OLD_FY = 'FY 2025-26';
+
+describe('which declaration form is in force', () => {
+  it('splits by age up to FY 2025-26', () => {
+    expect(declarationFormFor(OLD_FY, '1985-02-14')).toBe('15G');
+    expect(declarationFormFor(OLD_FY, '1958-06-22')).toBe('15H');
+  });
+
+  it('is a single Form 121 from FY 2026-27, whatever the age', () => {
+    expect(declarationFormFor(FY, '1985-02-14')).toBe('121');
+    expect(declarationFormFor(FY, '1958-06-22')).toBe('121');
+  });
+
+  it('keeps the senior threshold even though the forms merged', () => {
+    // The two forms became one, but the deduction trigger is still age-based.
+    expect(quarterlySchedule(credits(20_000, 20_000, 20_000, 20_000), general()).threshold).toBe(50_000);
+    expect(quarterlySchedule(credits(20_000, 20_000, 20_000, 20_000), senior()).threshold).toBe(100_000);
+  });
+});
+
+describe('eligibility up to FY 2025-26 — the 15G / 15H tests', () => {
+  const old = (o: Partial<TdsContext> = {}) => general({ fy: OLD_FY, ...o });
+  const oldSenior = (o: Partial<TdsContext> = {}) => senior({ fy: OLD_FY, ...o });
+
+  it('accepts a 15G within both the income and the interest ceiling', () => {
+    const r = checkEligibility(old(), income(90_000, 320_000));
+    expect(r.form).toBe('15G');
+    expect(r.eligible).toBe(true);
+  });
+
+  it('rejects a 15G whose estimated income exceeds the basic exemption', () => {
+    const r = checkEligibility(old(), income(38_500, 850_000));
+    expect(r.eligible).toBe(false);
+    expect(r.reasons.join(' ')).toContain('exceeds the basic exemption');
+  });
+
+  it('rejects a 15G whose interest alone exceeds the basic exemption', () => {
+    // The second limb: interest had to clear the limit as well as income.
+    expect(checkEligibility(old(), income(450_000, 380_000)).eligible).toBe(false);
+  });
+
+  it('places no interest ceiling on a 15H', () => {
+    // A senior citizen with ₹8,00,000 of interest could still declare, provided
+    // deductions and rebate left the liability at nil.
+    const r = checkEligibility(oldSenior(), income(800_000, 900_000));
+    expect(r.form).toBe('15H');
+    expect(r.eligible).toBe(true);
+  });
+
+  it('rejects a 15H that leaves a liability', () => {
+    const r = checkEligibility(oldSenior(), income(800_000, 1_500_000));
+    expect(r.eligible).toBe(false);
+    expect(r.reasons.join(' ')).toContain('nil');
+  });
+
+  it('cites the rule that applied to that year', () => {
+    const r = checkEligibility(old({ pan: '' }), income(10_000, 100_000));
+    expect(r.eligible).toBe(false);
+    expect(r.reasons.join(' ')).toContain('Rule 29C');
+  });
+
+  it('still checks the interest limb when income is not on record', () => {
+    // Income has to be declared by the payee, but the bank knows the interest
+    // figure, so that limb remains assessable.
+    expect(
+      checkEligibility(old(), { estimatedInterest: 450_000, estimatedIncome: 0, incomeOnRecord: false }).eligible
+    ).toBe(false);
+  });
+});
+
+describe('eligibility from FY 2026-27 — the single Form 121 test', () => {
+  it('drops the interest limb entirely', () => {
+    // Under a 15G this failed: interest of ₹4,50,000 was over the basic
+    // exemption limit. Form 121 asks only whether the tax liability is nil, so
+    // the same payee is now eligible.
+    expect(checkEligibility(general({ fy: OLD_FY }), income(450_000, 380_000)).eligible).toBe(false);
+    const r = checkEligibility(general(), income(450_000, 380_000));
+    expect(r.form).toBe('121');
+    expect(r.eligible).toBe(true);
+  });
+
+  it('applies one nil-liability ceiling to every age', () => {
+    for (const ctx of [
+      general(),
+      senior()
+    ]) {
+      expect(checkEligibility(ctx, income(800_000, 900_000)).eligible).toBe(true);
+      const over = checkEligibility(ctx, income(800_000, 1_500_000));
+      expect(over.eligible).toBe(false);
+      expect(over.reasons.join(' ')).toContain('nil');
+    }
+  });
+
+  it('takes PAN only — Aadhaar is not a substitute', () => {
+    const r = checkEligibility(general({ pan: '' }), income(10_000, 100_000));
+    expect(r.eligible).toBe(false);
+    expect(r.reasons.join(' ')).toContain('Rule 211');
+    expect(r.reasons.join(' ')).toContain('Aadhaar is not a substitute');
+  });
+
+  it('refuses an entity PAN', () => {
+    const r = checkEligibility(general({ pan: 'ABCCM1234E' }), income(10_000, 100_000));
+    expect(r.eligible).toBe(false);
+    expect(r.reasons.join(' ')).toContain('entity');
+  });
+
+  it('refuses a non-resident', () => {
+    expect(checkEligibility(general({ resident: false }), income(10_000, 100_000)).eligible).toBe(false);
+  });
+
+  it('reports the nil-liability test as unassessed rather than passing it silently', () => {
+    // The branch cannot compute income earned outside the bank, so a missing
+    // figure must not read as a pass.
+    const r = checkEligibility(general(), {
+      estimatedInterest: 90_000,
+      estimatedIncome: 0,
+      incomeOnRecord: false
+    });
+    expect(r.unassessed.length).toBe(1);
+    expect(r.unassessed[0]).toContain('not on record');
+    // With no interest limb left, nothing else can fail it — so the branch must
+    // read the unassessed note rather than treat the row as cleared.
+    expect(r.eligible).toBe(true);
+  });
+});
+
+describe('statutory references travel with the year', () => {
+  it('quotes the 1961 Act for FY 2025-26 and the 2025 Act for FY 2026-27', () => {
+    expect(FY_TAX_CONFIG['2025-26'].regime).toBe('ITA_1961');
+    expect(FY_TAX_CONFIG['2025-26'].interestTdsSection).toContain('194A');
+    expect(FY_TAX_CONFIG['2025-26'].tdsStatementForm).toBe('Form 26Q');
+    expect(FY_TAX_CONFIG['2025-26'].declarationStatementFrequency).toBe('QUARTERLY');
+
+    expect(FY_TAX_CONFIG['2026-27'].regime).toBe('ITA_2025');
+    expect(FY_TAX_CONFIG['2026-27'].interestTdsSection).toContain('393');
+    expect(FY_TAX_CONFIG['2026-27'].tdsStatementForm).toBe('Form 140');
+    expect(FY_TAX_CONFIG['2026-27'].declarationStatementFrequency).toBe('MONTHLY');
+  });
+
+  it('carries the same thresholds and rates across the changeover', () => {
+    const a = FY_TAX_CONFIG['2025-26'];
+    const b = FY_TAX_CONFIG['2026-27'];
+    expect(b.thresholdGeneral).toBe(a.thresholdGeneral);
+    expect(b.thresholdSenior).toBe(a.thresholdSenior);
+    expect(b.rate).toBe(a.rate);
+    expect(b.rateNoPan).toBe(a.rateNoPan);
+  });
+});
+
+describe('default interest under section 201(1A)', () => {
+  it('counts any part of a month as a full month', () => {
+    expect(monthsOrPartBetween('2026-07-07', '2026-07-07')).toBe(0);
+    expect(monthsOrPartBetween('2026-07-07', '2026-07-08')).toBe(1);
+    expect(monthsOrPartBetween('2026-07-07', '2026-08-07')).toBe(1);
+    expect(monthsOrPartBetween('2026-07-07', '2026-08-08')).toBe(2);
+    expect(monthsOrPartBetween('2026-07-07', '2027-01-07')).toBe(6);
+  });
+
+  it('charges 1% a month for deducting late and 1.5% for depositing late', () => {
+    expect(lateDeductionInterest(6_000, '2026-07-07', '2027-01-07', 'DEDUCTION', FY)).toEqual({
+      months: 6,
+      rate: 0.01,
+      interest: 360
+    });
+    expect(lateDeductionInterest(6_000, '2026-07-07', '2027-01-07', 'DEPOSIT', FY).interest).toBe(540);
+  });
+
+  it('charges nothing when settled on time', () => {
+    expect(lateDeductionInterest(6_000, '2026-07-07', '2026-07-07', 'DEPOSIT', FY).interest).toBe(0);
+  });
+});
+
+describe('helpers', () => {
+  it('resolves the financial year of a date', () => {
+    expect(fyOf('2026-04-01')).toBe('2026-27');
+    expect(fyOf('2027-03-31')).toBe('2026-27');
+    expect(fyOf('2026-03-31')).toBe('2025-26');
+    expect(fyOf('2027-04-01')).toBe('2027-28');
+  });
+
+  it('buckets dated credits into the right quarters and drops out-of-year dates', () => {
+    const b = bucketByQuarter(
+      [
+        { date: '2026-04-05', amount: 100 },
+        { date: '2026-08-01', amount: 200 },
+        { date: '2026-11-30', amount: 300 },
+        { date: '2027-01-15', amount: 400 },
+        { date: '2026-03-31', amount: 999 },
+        { date: '2027-04-01', amount: 999 }
+      ],
+      FY
+    );
+    expect(b).toEqual({ 1: 100, 2: 200, 3: 300, 4: 400 });
+  });
+
+  it('spreads an annual estimate without losing rupees to division', () => {
+    for (const annual of [
+      38_500,
+      52_801,
+      1,
+      999_999
+    ]) {
+      expect(projectQuarterlyCredits(annual, FY).reduce((s, x) => s + x.amount, 0)).toBe(annual);
+    }
+  });
+
+  it('exposes the cumulative liability directly for ad-hoc checks', () => {
+    expect(cumulativeLiability(50_000, 50_000, general())).toBe(0);
+    expect(cumulativeLiability(50_001, 50_001, general())).toBe(5_000);
+  });
+});

src/app/shared/search-select/search-select.component.ts

@@ -0,0 +1,236 @@
+/**
+ * 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, ElementRef, forwardRef, HostListener, Input, ViewChild } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { ControlValueAccessor, FormsModule, NG_VALUE_ACCESSOR } from '@angular/forms';
+
+export interface SearchSelectOption {
+  value: string;
+  label: string;
+  /** What typed text is matched against — defaults to `label` when omitted, but a caller can
+   *  pass a richer string (e.g. account no + customer name + branch) so a search hits fields
+   *  that aren't all visible in the collapsed label. */
+  searchText?: string;
+}
+
+/**
+ * Drop-in replacement for a plain `<select>` when the option list is long enough that scanning
+ * it is impractical (e.g. hundreds of accounts) — a text box that filters the option list as you
+ * type, instead of a native dropdown you can only scroll through. Selection only commits on
+ * click; typing without picking an option reverts the box to the last committed selection on
+ * blur, so the bound ngModel value never drifts from an actual, valid option.
+ *
+ * Usage: <mifosx-search-select [options]="opts" [(ngModel)]="selectedValue"></mifosx-search-select>
+ */
+@Component({
+  selector: 'mifosx-search-select',
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule
+  ],
+  providers: [
+    {
+      provide: NG_VALUE_ACCESSOR,
+      useExisting: forwardRef(() => SearchSelectComponent),
+      multi: true
+    }
+  ],
+  template: `
+    <div class="inv-search-select">
+      <input
+        #inputEl
+        type="text"
+        class="inv-search-select__input"
+        [value]="query"
+        [placeholder]="placeholder"
+        [disabled]="disabled"
+        (input)="onInput($event)"
+        (focus)="onFocus()"
+        (blur)="onBlur()"
+      />
+      @if (open) {
+        <ul
+          class="inv-search-select__list"
+          [style.top.px]="listTop"
+          [style.left.px]="listLeft"
+          [style.width.px]="listWidth"
+          (mousedown)="$event.preventDefault()"
+        >
+          @for (o of filteredOptions; track o.value) {
+            <li
+              class="inv-search-select__option"
+              [class.inv-search-select__option--active]="o.value === value"
+              (click)="selectOption(o)"
+            >
+              {{ o.label }}
+            </li>
+          } @empty {
+            <li class="inv-search-select__empty">No matches</li>
+          }
+        </ul>
+      }
+    </div>
+  `,
+  styles: [
+    `
+      /* Angular view encapsulation stops the host page's shared styles from reaching inside this
+       * component's own template, so its look is re-declared here rather than inherited. */
+      :host {
+        display: block;
+        width: 100%;
+      }
+      .inv-search-select {
+        position: relative;
+        width: 100%;
+      }
+      .inv-search-select__input {
+        width: 100%;
+        height: 36px;
+        padding: 0 10px;
+        border: 1px solid #e2e8f0;
+        border-radius: 8px;
+        font-size: 13px;
+        color: #0d1b2a;
+        font-family: inherit;
+        background: #fff;
+        box-sizing: border-box;
+      }
+      /* position: fixed, anchored via JS to the input's own screen coords (see
+       * updateListPosition()) rather than absolute inside this component — most of this app's
+       * cards use overflow: hidden for rounded corners, which would otherwise clip a dropdown
+       * that extends past the card's edge. */
+      .inv-search-select__list {
+        position: fixed;
+        z-index: 2000;
+        max-height: 260px;
+        overflow-y: auto;
+        margin: 0;
+        padding: 4px;
+        list-style: none;
+        background: #fff;
+        border: 1px solid #e2e8f0;
+        border-radius: 8px;
+        box-shadow: 0 8px 24px rgba(13, 27, 42, 0.18);
+      }
+      .inv-search-select__option {
+        padding: 8px 10px;
+        border-radius: 6px;
+        font-size: 13px;
+        color: #0d1b2a;
+        cursor: pointer;
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+      .inv-search-select__option:hover,
+      .inv-search-select__option--active {
+        background: #eef2ff;
+      }
+      .inv-search-select__empty {
+        padding: 8px 10px;
+        font-size: 12px;
+        color: #94a3b8;
+      }
+    `
+  ]
+})
+export class SearchSelectComponent implements ControlValueAccessor {
+  @Input() options: SearchSelectOption[] = [];
+  @Input() placeholder = 'Search…';
+
+  @ViewChild('inputEl') private inputEl?: ElementRef<HTMLInputElement>;
+
+  value = '';
+  query = '';
+  open = false;
+  disabled = false;
+
+  listTop = 0;
+  listLeft = 0;
+  listWidth = 0;
+
+  private onChangeFn: (v: string) => void = () => {};
+  onTouched: () => void = () => {};
+
+  get filteredOptions(): SearchSelectOption[] {
+    const q = this.query.trim().toLowerCase();
+    if (!q) {
+      return this.options;
+    }
+    return this.options.filter((o) => (o.searchText || o.label).toLowerCase().includes(q));
+  }
+
+  private labelFor(value: string): string {
+    return this.options.find((o) => o.value === value)?.label ?? '';
+  }
+
+  writeValue(v: string): void {
+    this.value = v ?? '';
+    this.query = this.labelFor(this.value);
+  }
+
+  registerOnChange(fn: (v: string) => void): void {
+    this.onChangeFn = fn;
+  }
+
+  registerOnTouched(fn: () => void): void {
+    this.onTouched = fn;
+  }
+
+  setDisabledState(isDisabled: boolean): void {
+    this.disabled = isDisabled;
+  }
+
+  /** Anchors the fixed-position list to the input's current on-screen box. */
+  private updateListPosition(): void {
+    const el = this.inputEl?.nativeElement;
+    if (!el) {
+      return;
+    }
+    const rect = el.getBoundingClientRect();
+    this.listTop = rect.bottom + 4;
+    this.listLeft = rect.left;
+    this.listWidth = rect.width;
+  }
+
+  @HostListener('window:scroll')
+  @HostListener('window:resize')
+  onWindowChange(): void {
+    if (this.open) {
+      this.updateListPosition();
+    }
+  }
+
+  onInput(event: Event): void {
+    this.query = (event.target as HTMLInputElement).value;
+    this.open = true;
+    this.updateListPosition();
+  }
+
+  onFocus(): void {
+    this.open = true;
+    this.updateListPosition();
+  }
+
+  onBlur(): void {
+    this.open = false;
+    this.onTouched();
+    // Discard any uncommitted typed text — only a clicked option ever changes `value`.
+    this.query = this.labelFor(this.value);
+  }
+
+  selectOption(o: SearchSelectOption): void {
+    this.value = o.value;
+    this.query = o.label;
+    this.open = false;
+    this.onChangeFn(this.value);
+    this.onTouched();
+  }
+}

src/app/shares/shares-account-view/passbook-tab/passbook-tab.component.html

@@ -0,0 +1,210 @@
+<!--
+  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="passbook-container">
+  <!-- Filter Bar -->
+  <div class="passbook-filter-bar no-print">
+    <form [formGroup]="dateRangeForm" class="passbook-filter-form">
+      <mat-form-field appearance="outline" class="passbook-date-field" (click)="fromDatePicker.open()">
+        <mat-label>{{ 'labels.inputs.From Date' | translate }}</mat-label>
+        <input matInput [min]="minDate" [max]="maxDate" [matDatepicker]="fromDatePicker" formControlName="fromDate" />
+        <mat-datepicker-toggle matSuffix [for]="fromDatePicker"></mat-datepicker-toggle>
+        <mat-datepicker #fromDatePicker></mat-datepicker>
+      </mat-form-field>
+
+      <mat-form-field appearance="outline" class="passbook-date-field" (click)="toDatePicker.open()">
+        <mat-label>{{ 'labels.inputs.To Date' | translate }}</mat-label>
+        <input matInput [min]="minDate" [max]="maxDate" [matDatepicker]="toDatePicker" formControlName="toDate" />
+        <mat-datepicker-toggle matSuffix [for]="toDatePicker"></mat-datepicker-toggle>
+        <mat-datepicker #toDatePicker></mat-datepicker>
+      </mat-form-field>
+
+      <button
+        mat-raised-button
+        color="primary"
+        type="button"
+        [disabled]="!dateRangeForm.valid"
+        (click)="filterTransactions()"
+      >
+        <mat-icon>filter_list</mat-icon>
+        {{ 'labels.buttons.Filter' | translate }}
+      </button>
+
+      @if (isFiltered) {
+        <button mat-stroked-button type="button" (click)="clearFilter()">
+          <mat-icon>clear</mat-icon>
+          {{ 'labels.buttons.Clear' | translate }}
+        </button>
+      }
+
+      <span class="passbook-filter-spacer"></span>
+
+      <button mat-raised-button color="accent" type="button" (click)="printPassbook()">
+        <mat-icon>print</mat-icon>
+        {{ 'labels.buttons.Print' | translate }}
+      </button>
+    </form>
+  </div>
+
+  <!-- Share Passbook -->
+  <div class="statement-wrapper" #passbookContent>
+    <!-- Bank Header -->
+    <div class="bank-header">
+      <div class="bank-logo-area">
+        <div class="bank-logo-circle">
+          <mat-icon>account_balance</mat-icon>
+        </div>
+        <div class="bank-name-block">
+          <div class="bank-title">LincPay Co-operative Bank Ltd.</div>
+          <div class="bank-subtitle">Share Account Passbook</div>
+        </div>
+      </div>
+      <div class="statement-label">
+        <div class="stmt-label-text">SHARE HOLDING STATEMENT</div>
+        <div class="stmt-period">As on: {{ maxDate | dateFormat }}</div>
+      </div>
+    </div>
+
+    <!-- Account Details -->
+    <div class="account-details-band">
+      <div class="account-details-grid">
+        <div class="detail-block">
+          <div class="detail-label">Member Name</div>
+          <div class="detail-value bold">{{ clientName | uppercase }}</div>
+        </div>
+        <div class="detail-block">
+          <div class="detail-label">Share Account No.</div>
+          <div class="detail-value mono bold">{{ accountNo }}</div>
+        </div>
+        <div class="detail-block">
+          <div class="detail-label">Product</div>
+          <div class="detail-value">{{ productName }}</div>
+        </div>
+        <div class="detail-block">
+          <div class="detail-label">Account Opening Date</div>
+          <div class="detail-value">{{ activatedOnDate | dateFormat }}</div>
+        </div>
+        <div class="detail-block">
+          <div class="detail-label">Status</div>
+          <div class="detail-value status-badge" [class.active]="status === 'Active'">{{ status }}</div>
+        </div>
+        <div class="detail-block">
+          <div class="detail-label">Linked Savings A/C No.</div>
+          <div class="detail-value mono">{{ savingsAccountNumber || '—' }}</div>
+        </div>
+        @if (resolutionNumber) {
+          <div class="detail-block">
+            <div class="detail-label">Resolution No.</div>
+            <div class="detail-value">{{ resolutionNumber }}</div>
+          </div>
+        }
+      </div>
+    </div>
+
+    <!-- Balance Summary Strip -->
+    <div class="balance-summary-strip">
+      <div class="balance-box">
+        <div class="balance-box-label">Approved Shares</div>
+        <div class="balance-box-value">{{ totalApprovedShares }}</div>
+      </div>
+      <div class="balance-divider"></div>
+      <div class="balance-box">
+        <div class="balance-box-label">Share Value</div>
+        <div class="balance-box-value">
+          {{ currentMarketPrice | currency: currency?.code : 'symbol-narrow' : '1.2-2' }}
+        </div>
+      </div>
+      <div class="balance-divider"></div>
+      <div class="balance-box">
+        <div class="balance-box-label">Current Value</div>
+        <div class="balance-box-value">{{ currentValue | currency: currency?.code : 'symbol-narrow' : '1.2-2' }}</div>
+      </div>
+      <div class="balance-divider"></div>
+      <div class="balance-box">
+        <div class="balance-box-label">Total Transactions</div>
+        <div class="balance-box-value">{{ filteredTransactions.length }}</div>
+      </div>
+    </div>
+
+    <!-- Transactions Table -->
+    @if (filteredTransactions.length > 0) {
+      <table class="statement-table">
+        <thead>
+          <tr>
+            <th class="col-sr">#</th>
+            <th class="col-date">Date</th>
+            <th class="col-desc">Description</th>
+            <th class="col-ref">Ref No.</th>
+            <th class="col-amount text-right">Shares Purchased</th>
+            <th class="col-amount text-right">Shares Redeemed</th>
+            <th class="col-balance text-right">Share Balance</th>
+            <th class="col-amount text-right">Amount (&#8377;)</th>
+            <th class="col-desc">Resolution No. / Meeting</th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (txn of filteredTransactions; track txn.id; let i = $index) {
+            <tr [class.debit-row]="isRedeem(txn)" [class.credit-row]="!isRedeem(txn)">
+              <td class="col-sr text-center">{{ i + 1 }}</td>
+              <td class="col-date">{{ txn.purchasedDate | dateFormat }}</td>
+              <td class="col-desc">
+                <span class="txn-desc">{{ txn.type.value }} ({{ txn.status.value }})</span>
+              </td>
+              <td class="col-ref text-muted mono">{{ txn.id }}</td>
+              <td class="col-amount text-right credit-amount">
+                @if (!isRedeem(txn)) {
+                  {{ txn.numberOfShares }}
+                }
+              </td>
+              <td class="col-amount text-right debit-amount">
+                @if (isRedeem(txn)) {
+                  {{ txn.numberOfShares }}
+                }
+              </td>
+              <td class="col-balance text-right balance-amount">{{ txn.runningBalance }}</td>
+              <td class="col-amount text-right">
+                {{ txn.amount | currency: currency?.code : 'symbol-narrow' : '1.2-2' }}
+              </td>
+              <td class="col-desc">
+                @if (isRedeem(txn)) {
+                  {{ txn.resolutionNumber || '—' }}
+                  @if (txn.meetingDate) {
+                    ({{ txn.meetingDate | dateFormat }})
+                  }
+                } @else {
+                  —
+                }
+              </td>
+            </tr>
+          }
+        </tbody>
+        <tfoot>
+          <tr class="total-row">
+            <td colspan="6" class="text-right total-label">Closing Share Balance</td>
+            <td class="text-right closing-balance">{{ totalApprovedShares }}</td>
+            <td colspan="2"></td>
+          </tr>
+        </tfoot>
+      </table>
+    } @else {
+      <div class="no-data-block">
+        <mat-icon>inbox</mat-icon>
+        <p>No transactions found for the selected date range.</p>
+      </div>
+    }
+
+    <!-- Statement Footer -->
+    <div class="statement-footer">
+      <div class="footer-note">
+        This is a computer-generated statement and does not require a signature. For queries, contact your branch or
+        call customer care.
+      </div>
+      <div class="footer-meta">Generated on: {{ maxDate | dateFormat }} &nbsp;|&nbsp; Account No: {{ accountNo }}</div>
+    </div>
+  </div>
+</div>

src/app/shares/shares-account-view/passbook-tab/passbook-tab.component.scss

@@ -0,0 +1,462 @@
+/**
+ * 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/.
+ */
+
+// ─── Variables ──────────────────────────────────────────────────────────────
+$bank-primary: #1a3a6b; // deep navy
+$bank-accent: #c8a951; // gold trim
+$debit-color: #c0392b;
+$credit-color: #1a7a3f;
+$balance-color: #1a3a6b;
+$border-color: #d0d7e3;
+$row-alt: #f4f7fb;
+
+// ─── Container ──────────────────────────────────────────────────────────────
+.passbook-container {
+  padding: 16px;
+  background: #eef1f7;
+  min-height: 100%;
+}
+
+// ─── Filter Bar ─────────────────────────────────────────────────────────────
+.passbook-filter-bar {
+  margin-bottom: 16px;
+  background: #fff;
+  border-radius: 8px;
+  padding: 12px 16px;
+  border: 1px solid $border-color;
+}
+
+.passbook-filter-form {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.passbook-date-field {
+  width: 180px;
+}
+
+.passbook-filter-spacer {
+  flex: 1;
+}
+
+// ─── Statement Wrapper ───────────────────────────────────────────────────────
+.statement-wrapper {
+  background: #fff;
+  border: 1px solid $border-color;
+  border-radius: 8px;
+  overflow: hidden;
+  box-shadow: 0 2px 12px rgb(0 0 0 / 8%);
+  font-family: 'Segoe UI', Arial, sans-serif;
+}
+
+// ─── Bank Header ─────────────────────────────────────────────────────────────
+.bank-header {
+  background: $bank-primary;
+  padding: 18px 24px;
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  border-bottom: 4px solid $bank-accent;
+}
+
+.bank-logo-area {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+}
+
+.bank-logo-circle {
+  width: 52px;
+  height: 52px;
+  border-radius: 50%;
+  background: $bank-accent;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+
+  mat-icon {
+    color: $bank-primary;
+    font-size: 28px;
+    width: 28px;
+    height: 28px;
+  }
+}
+
+.bank-name-block {
+  .bank-title {
+    color: #fff;
+    font-size: 18px;
+    font-weight: 700;
+    letter-spacing: 0.3px;
+  }
+
+  .bank-subtitle {
+    color: $bank-accent;
+    font-size: 11px;
+    font-weight: 500;
+    letter-spacing: 1.5px;
+    text-transform: uppercase;
+    margin-top: 2px;
+  }
+}
+
+.statement-label {
+  text-align: right;
+
+  .stmt-label-text {
+    color: $bank-accent;
+    font-size: 13px;
+    font-weight: 700;
+    letter-spacing: 2px;
+    text-transform: uppercase;
+  }
+
+  .stmt-period {
+    color: rgb(255 255 255 / 75%);
+    font-size: 11px;
+    margin-top: 4px;
+  }
+}
+
+// ─── Account Details Band ────────────────────────────────────────────────────
+.account-details-band {
+  background: #f0f3f9;
+  border-bottom: 1px solid $border-color;
+  padding: 14px 24px;
+}
+
+.account-details-grid {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 12px 24px;
+}
+
+.detail-block {
+  .detail-label {
+    font-size: 9px;
+    font-weight: 700;
+    color: #7a8aaa;
+    text-transform: uppercase;
+    letter-spacing: 0.8px;
+    margin-bottom: 3px;
+  }
+
+  .detail-value {
+    font-size: 13px;
+    color: #222;
+
+    &.bold {
+      font-weight: 600;
+    }
+
+    &.mono {
+      font-family: 'Courier New', monospace;
+      letter-spacing: 1px;
+    }
+
+    &.status-badge {
+      display: inline-block;
+      padding: 1px 8px;
+      border-radius: 10px;
+      font-size: 11px;
+      font-weight: 600;
+      background: #eee;
+      color: #555;
+
+      &.active {
+        background: #d4edda;
+        color: #155724;
+      }
+    }
+  }
+}
+
+// ─── Balance Summary Strip ───────────────────────────────────────────────────
+.balance-summary-strip {
+  display: flex;
+  align-items: stretch;
+  background: $bank-primary;
+  padding: 0;
+}
+
+.balance-box {
+  flex: 1;
+  padding: 12px 20px;
+  text-align: center;
+
+  .balance-box-label {
+    font-size: 10px;
+    font-weight: 600;
+    color: rgb(255 255 255 / 65%);
+    text-transform: uppercase;
+    letter-spacing: 1px;
+    margin-bottom: 4px;
+  }
+
+  .balance-box-value {
+    font-size: 16px;
+    font-weight: 700;
+    color: $bank-accent;
+  }
+}
+
+.balance-divider {
+  width: 1px;
+  background: rgb(255 255 255 / 15%);
+  margin: 8px 0;
+}
+
+// ─── Transactions Table ───────────────────────────────────────────────────────
+.statement-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12.5px;
+
+  thead tr {
+    background: #e8edf5;
+    border-top: 1px solid $border-color;
+    border-bottom: 2px solid $bank-primary;
+  }
+
+  thead th {
+    padding: 9px 10px;
+    font-size: 11px;
+    font-weight: 700;
+    color: $bank-primary;
+    text-transform: uppercase;
+    letter-spacing: 0.4px;
+    white-space: nowrap;
+  }
+
+  tbody tr {
+    border-bottom: 1px solid #e8ecf3;
+    transition: background 0.1s;
+
+    &:nth-child(even) {
+      background: $row-alt;
+    }
+
+    &:hover {
+      background: #dce6f5;
+    }
+  }
+
+  tbody td {
+    padding: 7px 10px;
+    vertical-align: middle;
+    color: #333;
+  }
+
+  tfoot .total-row {
+    background: #e8edf5;
+    border-top: 2px solid $bank-primary;
+
+    td {
+      padding: 9px 10px;
+    }
+  }
+}
+
+// ─── Column widths ────────────────────────────────────────────────────────────
+.col-sr {
+  width: 38px;
+}
+
+.col-date {
+  width: 100px;
+  white-space: nowrap;
+}
+
+.col-desc {
+  min-width: 140px;
+}
+
+.col-ref {
+  width: 70px;
+}
+
+.col-amount {
+  width: 100px;
+}
+
+.col-balance {
+  width: 90px;
+}
+
+// ─── Amount colors ────────────────────────────────────────────────────────────
+.debit-amount {
+  color: $debit-color;
+  font-weight: 500;
+}
+
+.credit-amount {
+  color: $credit-color;
+  font-weight: 500;
+}
+
+.balance-amount {
+  color: $balance-color;
+  font-weight: 600;
+  font-family: 'Courier New', monospace;
+}
+
+.total-label {
+  font-size: 12px;
+  font-weight: 700;
+  color: $bank-primary;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}
+
+.closing-balance {
+  font-size: 14px;
+  font-weight: 700;
+  color: $bank-primary;
+  font-family: 'Courier New', monospace;
+}
+
+// ─── Badges & misc ────────────────────────────────────────────────────────────
+.txn-desc {
+  font-weight: 500;
+}
+
+.text-right {
+  text-align: right;
+}
+
+.text-center {
+  text-align: center;
+}
+
+.text-muted {
+  color: #999;
+}
+
+.mono {
+  font-family: 'Courier New', monospace;
+  font-size: 11px;
+}
+
+// ─── No Data ──────────────────────────────────────────────────────────────────
+.no-data-block {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 48px;
+  color: #aaa;
+
+  mat-icon {
+    font-size: 48px;
+    width: 48px;
+    height: 48px;
+    margin-bottom: 12px;
+  }
+
+  p {
+    font-size: 14px;
+    margin: 0;
+  }
+}
+
+// ─── Statement Footer ─────────────────────────────────────────────────────────
+.statement-footer {
+  background: #f0f3f9;
+  border-top: 1px solid $border-color;
+  padding: 12px 24px;
+  text-align: center;
+
+  .footer-note {
+    font-size: 10px;
+    color: #888;
+    margin-bottom: 4px;
+    font-style: italic;
+  }
+
+  .footer-meta {
+    font-size: 10px;
+    color: #aaa;
+    letter-spacing: 0.3px;
+  }
+}
+
+// ─── Responsive ───────────────────────────────────────────────────────────────
+@media (width <= 768px) {
+  .account-details-grid {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  .bank-header {
+    flex-direction: column;
+    gap: 12px;
+    align-items: flex-start;
+  }
+
+  .statement-label {
+    text-align: left;
+  }
+
+  .balance-summary-strip {
+    flex-direction: column;
+  }
+
+  .balance-divider {
+    width: auto;
+    height: 1px;
+    margin: 0 20px;
+  }
+
+  .passbook-filter-form {
+    flex-direction: column;
+    align-items: stretch;
+  }
+
+  .passbook-date-field {
+    width: 100%;
+  }
+
+  .passbook-filter-spacer {
+    display: none;
+  }
+}
+
+@media (width <= 480px) {
+  .account-details-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+// ─── Print ────────────────────────────────────────────────────────────────────
+@media print {
+  .no-print {
+    display: none !important;
+  }
+
+  .passbook-container {
+    background: #fff;
+    padding: 0;
+  }
+
+  .statement-wrapper {
+    border: none;
+    box-shadow: none;
+    border-radius: 0;
+  }
+
+  .bank-header {
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+  }
+
+  .balance-summary-strip {
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+  }
+}

src/app/shares/shares-account-view/passbook-tab/passbook-tab.component.ts

@@ -0,0 +1,182 @@
+/**
+ * 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/.
+ */
+
+/** Angular Imports */
+import { Component, OnInit, ElementRef, ViewChild, inject } from '@angular/core';
+import { ActivatedRoute } from '@angular/router';
+import { UntypedFormBuilder, Validators } from '@angular/forms';
+import { CurrencyPipe } from '@angular/common';
+import { MatIcon } from '@angular/material/icon';
+import { DateFormatPipe } from '../../../pipes/date-format.pipe';
+import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
+
+/**
+ * Share Account Passbook — a printable, chronological (oldest-first) ledger of every
+ * Purchase/Redeem entry, mirroring PassbookTabComponent (Savings) but for share holdings:
+ * shares purchased/redeemed instead of amount deposited/withdrawn, plus the Board Resolution
+ * Number / Date of Meeting on redeem rows.
+ */
+@Component({
+  selector: 'mifosx-shares-passbook-tab',
+  templateUrl: './passbook-tab.component.html',
+  styleUrls: ['./passbook-tab.component.scss'],
+  standalone: true,
+  imports: [
+    ...STANDALONE_SHARED_IMPORTS,
+    MatIcon,
+    DateFormatPipe,
+    CurrencyPipe
+  ]
+})
+export class SharesPassbookTabComponent implements OnInit {
+  private route = inject(ActivatedRoute);
+  private formBuilder = inject(UntypedFormBuilder);
+
+  @ViewChild('passbookContent') passbookContent: ElementRef;
+
+  /** Account data */
+  accountNo = '';
+  clientName = '';
+  productName = '';
+  currency: any = null;
+  status = '';
+  activatedOnDate: any = null;
+  resolutionNumber = '';
+  savingsAccountNumber = '';
+  totalApprovedShares = 0;
+  currentMarketPrice = 0;
+
+  /** Transactions */
+  allTransactions: any[] = [];
+  filteredTransactions: any[] = [];
+
+  /** Date range form */
+  minDate = new Date(2000, 0, 1);
+  maxDate = new Date();
+  dateRangeForm: any;
+  isFiltered = false;
+
+  get currentValue(): number {
+    return this.totalApprovedShares * this.currentMarketPrice;
+  }
+
+  ngOnInit(): void {
+    this.route.parent.data.subscribe((data: { sharesAccountData: any }) => {
+      const account = data.sharesAccountData;
+      this.accountNo = account.accountNo || '';
+      this.clientName = account.clientName || '';
+      this.productName = account.productName || '';
+      this.currency = account.currency || null;
+      this.status = account.status?.value || '';
+      this.activatedOnDate = account.timeline?.activatedDate || null;
+      this.resolutionNumber = account.resolutionNumber || '';
+      this.savingsAccountNumber = account.savingsAccountNumber || '';
+      this.totalApprovedShares = account.summary?.totalApprovedShares || 0;
+      this.currentMarketPrice = account.currentMarketPrice || 0;
+
+      const transactions = (account.purchasedShares || []).filter(
+        (transaction: any) => transaction.type.value !== 'Charge Payment'
+      );
+      this.allTransactions = this.recalculateRunningBalances(this.sortAscending(transactions));
+      this.filteredTransactions = [...this.allTransactions];
+    });
+
+    this.dateRangeForm = this.formBuilder.group({
+      fromDate: [
+        '',
+        Validators.required
+      ],
+      toDate: [
+        '',
+        Validators.required
+      ]
+    });
+  }
+
+  isRedeem(transaction: any): boolean {
+    return transaction.type?.value === 'Redeem';
+  }
+
+  filterTransactions(): void {
+    const fromDate = this.dateRangeForm.value.fromDate;
+    const toDate = this.dateRangeForm.value.toDate;
+
+    if (!fromDate || !toDate) return;
+
+    const from = new Date(fromDate).getTime();
+    const to = new Date(toDate).getTime();
+
+    this.filteredTransactions = this.allTransactions.filter((txn: any) => {
+      const txnDate = this.getTransactionDateAsTime(txn.purchasedDate);
+      return txnDate >= from && txnDate <= to;
+    });
+    this.isFiltered = true;
+  }
+
+  clearFilter(): void {
+    this.dateRangeForm.reset();
+    this.filteredTransactions = [...this.allTransactions];
+    this.isFiltered = false;
+  }
+
+  private getTransactionDateAsTime(date: any): number {
+    if (Array.isArray(date) && date.length >= 3) {
+      return new Date(date[0], date[1] - 1, date[2]).getTime();
+    }
+    return new Date(date).getTime();
+  }
+
+  printPassbook(): void {
+    const content = this.passbookContent?.nativeElement?.innerHTML;
+    if (!content) return;
+
+    const printWindow = window.open('', 'SharePassbook', 'height=700,width=900');
+    printWindow.document.write(`
+      <html>
+      <head>
+        <title>Share Account Passbook - ${this.accountNo}</title>
+        <style>
+          * { margin: 0; padding: 0; box-sizing: border-box; }
+          body { font-family: 'Segoe UI', Arial, sans-serif; padding: 20px; color: #333; }
+          .passbook-header { text-align: center; margin-bottom: 20px; border-bottom: 2px solid #1a3a6b; padding-bottom: 12px; }
+          table { width: 100%; border-collapse: collapse; font-size: 11px; }
+          th { background: #1a3a6b; color: #fff; padding: 6px 8px; text-align: left; font-weight: 600; }
+          td { padding: 5px 8px; border-bottom: 1px solid #e0e0e0; }
+          tr:nth-child(even) { background: #fafafa; }
+          .text-right { text-align: right; }
+        </style>
+      </head>
+      <body>
+        ${content}
+      </body>
+      </html>
+    `);
+    printWindow.document.close();
+    printWindow.focus();
+    printWindow.print();
+    printWindow.close();
+  }
+
+  private recalculateRunningBalances(transactions: any[]): any[] {
+    let balance = 0;
+    return transactions.map((txn) => {
+      const shares = Number(txn.numberOfShares) || 0;
+      balance += this.isRedeem(txn) ? -shares : shares;
+      return { ...txn, runningBalance: balance };
+    });
+  }
+
+  private sortAscending(transactions: any[]): any[] {
+    return [...transactions].sort((a, b) => {
+      const dateA = this.getTransactionDateAsTime(a.purchasedDate);
+      const dateB = this.getTransactionDateAsTime(b.purchasedDate);
+      if (dateA !== dateB) return dateA - dateB;
+      return (a.id as number) - (b.id as number);
+    });
+  }
+}

src/app/shares/shares-account-view/shares-account-view.component.html

@@ -124,6 +124,13 @@
   </mat-card-header>
 
   <mat-card-content class="content">
+    @if (sharesAccountData.status?.value === 'Active' && (sharesAccountData.summary?.totalApprovedShares ?? 0) === 0) {
+      <div class="closure-eligible-banner">
+        <fa-icon icon="info-circle"></fa-icon>
+        <span>All shares have been withdrawn from this account — it is now eligible for closure.</span>
+        <a class="closure-eligible-banner__link" [routerLink]="['/clerk/share-closure-request']"> Request Closure </a>
+      </div>
+    }
     <nav mat-tab-nav-bar class="navigation-tabs" [tabPanel]="tabPanel">
       <a
         mat-tab-link

src/app/shares/shares-account-view/shares-account-view.component.scss

@@ -14,3 +14,33 @@
   min-width: 60%;
   font-weight: 400;
 }
+
+.closure-eligible-banner {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 10px 16px;
+  margin: 0 0 12px;
+  background: #eaf2ff;
+  border: 1px solid rgb(52 87 213 / 25%);
+  border-left: 3px solid #3457d5;
+  border-radius: 8px;
+  font-size: 13px;
+  color: #1b3a8a;
+
+  fa-icon {
+    color: #3457d5;
+  }
+
+  &__link {
+    margin-left: auto;
+    font-weight: 700;
+    color: #3457d5;
+    text-decoration: none;
+    white-space: nowrap;
+
+    &:hover {
+      text-decoration: underline;
+    }
+  }
+}

src/app/shares/shares-account-view/shares-buttons.config.ts

@@ -102,11 +102,11 @@ export class SharesButtonsConfiguration {
           {
             name: 'Share Certificate',
             taskPermissionName: 'READ_SHAREACCOUNTPURCHASE'
-          },
-          {
-            name: 'Close',
-            taskPermissionName: 'CLOSE_SHAREACCOUNT'
           }
+          // 'Close' is intentionally not offered here — closing a share account must go through
+          // the Clerk Dashboard maker-checker flow (Clerk Dashboard > My Share Closures), never a
+          // direct one-step action from this view. The native close command also force-redeems any
+          // remaining shares, bypassing the governed Share Withdrawal approval flow entirely.
         ];
         break;
       case 'Submitted and pending approval':

src/app/tasks/checker-inbox-and-tasks-tabs/pending-client-edits/client-edit-email-dialog/client-edit-email-dialog.component.html

@@ -0,0 +1,84 @@
+<!--
+  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/.
+-->
+
+<h1 mat-dialog-title class="ced-title">
+  <span class="ced-title__icon">✉</span>
+  Approval Email
+  
+  <div class="ced-status-row">
+    @if (data.emailSent) {
+      <span class="ced-chip ced-chip--sent">
+        <span class="ced-chip__dot"></span>Sent
+      </span>
+    } @else {
+      <span class="ced-chip ced-chip--notsent">
+        <span class="ced-chip__dot"></span>Not sent
+      </span>
+    }
+
+    @if (data.emailOpenedAt) {
+      <span class="ced-chip ced-chip--seen">
+        <fa-icon icon="eye" class="ced-chip__icon"></fa-icon>Seen
+      </span>
+    } @else {
+      <span class="ced-chip ced-chip--notseen">
+        <fa-icon icon="eye-slash" class="ced-chip__icon"></fa-icon>Not yet seen
+      </span>
+    }
+  </div>
+</h1>
+
+<div mat-dialog-content class="ced-content">
+  
+  <!-- Classic Email Header (Gmail Style) -->
+  <div class="ced-gmail-header">
+    <h2 class="ced-gmail-subject">{{ data.emailSubject ?? '(No Subject)' }}</h2>
+    
+    <div class="ced-gmail-meta">
+      <div class="ced-gmail-avatar">
+        <div class="ced-gmail-avatar-letter">C</div>
+      </div>
+      
+      <div class="ced-gmail-meta-content">
+        <div class="ced-gmail-meta-top">
+          <span class="ced-gmail-sender-name">CBSNexora</span>
+          <span class="ced-gmail-sender-email">&lt;{{ data.emailFrom ?? 'noreply@cbsnexora.in' }}&gt;</span>
+          <span class="ced-gmail-spacer"></span>
+          <span class="ced-gmail-date">{{ data.emailSentAt ? formatDate(data.emailSentAt) : '—' }}</span>
+        </div>
+        <div class="ced-gmail-meta-bottom">
+          <span class="ced-gmail-to">
+            to 
+            @if (data.emailTo) {
+              {{ data.emailTo }}
+            } @else {
+              <span style="font-style: italic; color: #d32f2f">No email on file</span>
+            }
+          </span>
+          <fa-icon icon="caret-down" class="ced-gmail-caret"></fa-icon>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- HTML email body -->
+  @if (data.emailBody) {
+    <div class="ced-email-body" [innerHTML]="safeBody"></div>
+  } @else {
+    <div class="ced-empty">
+      <p>No email content available.</p>
+      @if (!data.emailSent) {
+        <p class="ced-empty__hint">The email has not been sent yet for this edit.</p>
+      }
+    </div>
+  }
+</div>
+
+<mat-dialog-actions align="end">
+  <button mat-raised-button color="primary" mat-dialog-close>Close</button>
+</mat-dialog-actions>

src/app/tasks/checker-inbox-and-tasks-tabs/pending-client-edits/client-edit-email-dialog/client-edit-email-dialog.component.scss

@@ -0,0 +1,219 @@
+/**
+ * Copyright since 2025 Mifos Initiative
+ * MPL-2.0
+ */
+
+:host {
+  display: block;
+}
+
+.ced-title {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  font-size: 1.15rem;
+  font-weight: 600;
+  color: #1a237e;
+  position: relative; /* For aligning badges to the right */
+
+  &__icon {
+    font-size: 1.3rem;
+  }
+}
+
+.ced-content {
+  min-width: 560px;
+  max-width: 760px;
+  max-height: 72vh;
+  overflow-y: auto;
+  padding: 0 4px;
+}
+
+/* ── Gmail-Style Email Header ─────────────────────────────────────────────────── */
+.ced-gmail-header {
+  display: flex;
+  flex-direction: column;
+  margin-bottom: 30px;
+  padding: 0 4px;
+  font-family: 'Roboto', 'Inter', sans-serif; /* Gmail-like typography */
+}
+
+.ced-gmail-subject {
+  font-size: 1.35rem;
+  font-weight: 400;
+  color: #202124;
+  margin: 0 0 24px 0;
+  line-height: 1.4;
+}
+
+.ced-gmail-meta {
+  display: flex;
+  align-items: center; /* Avatar vertically centered with text */
+  gap: 12px;
+}
+
+.ced-gmail-avatar {
+  width: 40px;
+  height: 40px;
+  border-radius: 50%;
+  background-color: #f06292;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+}
+
+.ced-gmail-avatar-letter {
+  color: white;
+  font-size: 1.25rem;
+  font-weight: 500;
+}
+
+.ced-gmail-meta-content {
+  display: flex;
+  flex-direction: column;
+  flex-grow: 1;
+  justify-content: center;
+  gap: 2px;
+}
+
+.ced-gmail-meta-top {
+  display: flex;
+  align-items: baseline;
+  width: 100%;
+}
+
+.ced-gmail-spacer {
+  flex-grow: 1;
+}
+
+.ced-gmail-sender-name {
+  font-size: 0.95rem;
+  font-weight: 600;
+  color: #202124;
+  margin-right: 6px;
+}
+
+.ced-gmail-sender-email {
+  color: #5f6368;
+  font-size: 0.8rem;
+}
+
+.ced-gmail-date {
+  color: #5f6368;
+  font-size: 0.75rem;
+  white-space: nowrap;
+}
+
+.ced-gmail-meta-bottom {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.ced-gmail-to {
+  font-size: 0.75rem;
+  color: #5f6368;
+}
+
+.ced-gmail-caret {
+  font-size: 0.75rem;
+  color: #5f6368;
+  cursor: pointer;
+}
+
+.ced-status-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-left: auto; /* Pushes badges to the right in the flex container */
+}
+
+/* ── Status chips ───────────────────────────────────────────────────────── */
+.ced-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 12px 4px 10px;
+  border-radius: 20px;
+  font-size: 0.82rem;
+  font-weight: 500;
+
+  &__dot {
+    width: 8px;
+    height: 8px;
+    border-radius: 50%;
+    flex-shrink: 0;
+  }
+
+  &__icon {
+    font-size: 0.82rem;
+  }
+
+  &--sent {
+    background: #e8f5e9;
+    color: #1b5e20;
+    .ced-chip__dot { background: #43a047; }
+  }
+
+  &--notsent {
+    background: #f5f5f5;
+    color: #757575;
+    .ced-chip__dot { background: #bdbdbd; }
+  }
+
+  &--seen {
+    background: #e3f2fd;
+    color: #0d47a1;
+  }
+
+  &--notseen {
+    background: #f5f5f5;
+    color: #9e9e9e;
+  }
+}
+
+/* ── Divider ────────────────────────────────────────────────────────────── */
+.ced-divider {
+  border: none;
+  border-top: 1px solid #eeeeee;
+  margin: 12px 0;
+}
+
+/* ── Email body iframe-like container ───────────────────────────────────── */
+.ced-email-body {
+  background: #fafafa;
+  border: 1px solid #e0e0e0;
+  border-radius: 8px;
+  padding: 20px 24px;
+  font-family: Arial, sans-serif;
+  font-size: 0.93rem;
+  line-height: 1.6;
+  color: #333;
+
+  // Reset any Angular Material overrides inside the rendered HTML
+  table {
+    border-collapse: collapse;
+    width: 100%;
+  }
+
+  td, th {
+    padding: 6px 12px;
+    border: 1px solid #e0e0e0;
+  }
+
+  p { margin: 0 0 10px; }
+  ul { padding-left: 20px; }
+}
+
+/* ── Empty state ────────────────────────────────────────────────────────── */
+.ced-empty {
+  text-align: center;
+  padding: 32px 0;
+  color: #9e9e9e;
+
+  &__hint {
+    font-size: 0.85rem;
+    margin-top: 6px;
+  }
+}

src/app/tasks/checker-inbox-and-tasks-tabs/pending-client-edits/client-edit-email-dialog/client-edit-email-dialog.component.ts

@@ -0,0 +1,65 @@
+/**
+ * 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, inject } from '@angular/core';
+import {
+  MAT_DIALOG_DATA,
+  MatDialogTitle,
+  MatDialogContent,
+  MatDialogActions,
+  MatDialogClose
+} from '@angular/material/dialog';
+import { CdkScrollable } from '@angular/cdk/scrolling';
+import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
+import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
+import { FaIconComponent } from '@fortawesome/angular-fontawesome';
+
+export interface ClientEditEmailDialogData {
+  emailSubject: string | null;
+  emailBody: string | null;
+  emailSent: boolean;
+  emailSentAt: string | null;
+  emailOpenedAt: string | null;
+  emailFrom: string | null;
+  emailTo: string | null;
+}
+
+/** Displays the exact confirmation email sent to the client when their pending edit was approved.
+ *  Shows subject, HTML body (rendered), sent timestamp, and read/seen status. */
+@Component({
+  selector: 'mifosx-client-edit-email-dialog',
+  templateUrl: './client-edit-email-dialog.component.html',
+  styleUrls: ['./client-edit-email-dialog.component.scss'],
+  standalone: true,
+  imports: [
+    ...STANDALONE_SHARED_IMPORTS,
+    MatDialogTitle,
+    CdkScrollable,
+    MatDialogContent,
+    MatDialogActions,
+    MatDialogClose,
+    FaIconComponent
+  ]
+})
+export class ClientEditEmailDialogComponent {
+  data = inject<ClientEditEmailDialogData>(MAT_DIALOG_DATA);
+  private sanitizer = inject(DomSanitizer);
+
+  get safeBody(): SafeHtml {
+    return this.sanitizer.bypassSecurityTrustHtml(this.data.emailBody ?? '');
+  }
+
+  formatDate(isoDate: string | null | undefined): string {
+    if (!isoDate) return '—';
+    const d = new Date(isoDate);
+    return d.toLocaleString('en-IN', {
+      day: '2-digit', month: 'short', year: 'numeric',
+      hour: '2-digit', minute: '2-digit', hour12: true
+    });
+  }
+}

src/app/tasks/checker-inbox-and-tasks-tabs/share-closure-requests/share-closure-requests.component.html

@@ -0,0 +1,82 @@
+<!--
+  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-card">
+  <div class="pos-section-label">Share Closure Requests — Review, Approve or Reject</div>
+  <div class="inv-form-grid" style="padding: 12px 16px">
+    <label class="inv-form-field">
+      <span>Status</span>
+      <select [(ngModel)]="filterStatus" (change)="onFilterChange()">
+        @for (opt of statusOptions; track opt.value) {
+          <option [value]="opt.value">{{ opt.label }}</option>
+        }
+      </select>
+    </label>
+    <label class="inv-form-field" style="align-self: end">
+      <button type="button" class="pg-btn pg-btn--ghost" [disabled]="loading" (click)="load()">Refresh</button>
+    </label>
+  </div>
+  <table class="pg-table">
+    <thead>
+      <tr>
+        <th>Account No</th>
+        <th>Client</th>
+        <th>Closed Date</th>
+        <th>Clerk</th>
+        <th>Manager</th>
+        <th>Submitted At</th>
+        <th>Status</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      @if (loading) {
+        <tr>
+          <td colspan="8" class="pg-empty">Loading…</td>
+        </tr>
+      } @else if (loaded && requests.length === 0) {
+        <tr>
+          <td colspan="8" class="pg-empty">No {{ filterStatus | lowercase }} share closure requests.</td>
+        </tr>
+      } @else {
+        @for (r of requests; track r.id) {
+          <tr>
+            <td>
+              <span class="pg-chip">{{ r.account_no }}</span>
+            </td>
+            <td>{{ r.client_name }}</td>
+            <td>{{ formatDateTime(r.closed_date) }}</td>
+            <td>{{ r.clerk_name }}</td>
+            <td>{{ r.manager_name || r.manager_username || '—' }}</td>
+            <td>{{ formatDateTime(r.submitted_at) }}</td>
+            <td>
+              <span [class]="statusClass(r.status)">{{ statusLabel(r.status) }}</span>
+            </td>
+            <td>
+              <button type="button" class="pg-btn pg-btn--ghost" (click)="review(r)">Review</button>
+            </td>
+          </tr>
+        }
+      }
+    </tbody>
+  </table>
+</div>
+
+@if (showReviewModal && reviewRequestId) {
+  <div class="swr-list-popup-backdrop" (click)="closeReviewModal()">
+    <div class="swr-list-popup-panel" (click)="$event.stopPropagation()">
+      <mifosx-share-closure-request
+        [embedded]="true"
+        [overrideMode]="'review'"
+        [overrideRequestId]="reviewRequestId"
+        (closeRequested)="closeReviewModal()"
+        (actionCompleted)="onReviewActionCompleted()"
+      ></mifosx-share-closure-request>
+    </div>
+  </div>
+}

src/app/tasks/checker-inbox-and-tasks-tabs/share-closure-requests/share-closure-requests.component.ts

@@ -0,0 +1,128 @@
+/**
+ * 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 { catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+
+import { ClerkShareClosureService } from '../../../cashier/clerk-share-closure.service';
+import { ShareClosureRequestComponent } from '../../../clerk/share-closure-request/share-closure-request.component';
+
+/** Approval Center — Share Closure Requests tab. A Bank Manager (checker) reviews, approves or
+ *  rejects share account closure requests submitted from the Clerk Dashboard. Mirrors
+ *  ShareWithdrawalRequestsComponent. Clicking "Review" opens the review screen in a popup on top of
+ *  this list, rather than navigating away, so approving/rejecting drops the manager straight back
+ *  into the (now refreshed) list. */
+@Component({
+  selector: 'mifosx-share-closure-requests',
+  templateUrl: './share-closure-requests.component.html',
+  styleUrls: [
+    '../../../cashier/cashier-shared.scss',
+    '../../../clerk/clerk-shared.scss',
+    '../share-withdrawal-requests/share-withdrawal-requests.component.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    ShareClosureRequestComponent
+  ]
+})
+export class ShareClosureRequestsComponent implements OnInit {
+  private service = inject(ClerkShareClosureService);
+
+  requests: any[] = [];
+  totalRecords = 0;
+  loading = false;
+  loaded = false;
+
+  filterStatus = 'PENDING';
+
+  showReviewModal = false;
+  reviewRequestId: number | null = null;
+
+  get statusOptions(): { value: string; label: string }[] {
+    return [
+      { value: 'PENDING', label: 'Pending' },
+      { value: 'APPROVED', label: 'Approved' },
+      { value: 'REJECTED', label: 'Rejected' }
+    ];
+  }
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  load(): void {
+    this.loading = true;
+    this.service
+      .getPendingRequests(this.filterStatus, 0, 50)
+      .pipe(catchError(() => of({ pageItems: [], totalFilteredRecords: 0 })))
+      .subscribe((res: any) => {
+        this.requests = res?.pageItems ?? [];
+        this.totalRecords = Number(res?.totalFilteredRecords ?? 0);
+        this.loading = false;
+        this.loaded = true;
+      });
+  }
+
+  onFilterChange(): void {
+    this.load();
+  }
+
+  review(req: any): void {
+    this.reviewRequestId = req.id;
+    this.showReviewModal = true;
+  }
+
+  closeReviewModal(): void {
+    this.showReviewModal = false;
+    this.reviewRequestId = null;
+  }
+
+  onReviewActionCompleted(): void {
+    this.closeReviewModal();
+    this.load();
+  }
+
+  statusClass(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'inv-badge--active',
+      APPROVED: 'inv-badge--matured',
+      REJECTED: 'inv-badge--written_off'
+    };
+    return `inv-badge ${map[status] ?? ''}`;
+  }
+
+  statusLabel(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'Pending',
+      APPROVED: 'Approved',
+      REJECTED: 'Rejected'
+    };
+    return map[status] ?? status;
+  }
+
+  formatDateTime(val: any): string {
+    if (!val) return '—';
+    try {
+      const d = new Date(val);
+      return d.toLocaleString('en-IN', {
+        day: '2-digit',
+        month: 'short',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit'
+      });
+    } catch {
+      return String(val);
+    }
+  }
+}

src/app/tasks/checker-inbox-and-tasks-tabs/share-withdrawal-requests/share-withdrawal-requests.component.html

@@ -0,0 +1,86 @@
+<!--
+  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-card">
+  <div class="pos-section-label">Share Withdrawal Requests — Review, Approve or Reject</div>
+  <div class="inv-form-grid" style="padding: 12px 16px">
+    <label class="inv-form-field">
+      <span>Status</span>
+      <select [(ngModel)]="filterStatus" (change)="onFilterChange()">
+        @for (opt of statusOptions; track opt.value) {
+          <option [value]="opt.value">{{ opt.label }}</option>
+        }
+      </select>
+    </label>
+    <label class="inv-form-field" style="align-self: end">
+      <button type="button" class="pg-btn pg-btn--ghost" [disabled]="loading" (click)="load()">Refresh</button>
+    </label>
+  </div>
+  <table class="pg-table">
+    <thead>
+      <tr>
+        <th>Account No</th>
+        <th>Client</th>
+        <th class="num">Shares</th>
+        <th>Resolution No.</th>
+        <th>Meeting Date</th>
+        <th>Clerk</th>
+        <th>Manager</th>
+        <th>Submitted At</th>
+        <th>Status</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      @if (loading) {
+        <tr>
+          <td colspan="10" class="pg-empty">Loading…</td>
+        </tr>
+      } @else if (loaded && requests.length === 0) {
+        <tr>
+          <td colspan="10" class="pg-empty">No {{ filterStatus | lowercase }} share withdrawal requests.</td>
+        </tr>
+      } @else {
+        @for (r of requests; track r.id) {
+          <tr>
+            <td>
+              <span class="pg-chip">{{ r.account_no }}</span>
+            </td>
+            <td>{{ r.client_name }}</td>
+            <td class="num">{{ r.requested_shares }}</td>
+            <td>{{ r.resolution_number }}</td>
+            <td>{{ formatDateTime(r.meeting_date) }}</td>
+            <td>{{ r.clerk_name }}</td>
+            <td>{{ r.manager_name || r.manager_username || '—' }}</td>
+            <td>{{ formatDateTime(r.submitted_at) }}</td>
+            <td>
+              <span [class]="statusClass(r.status)">{{ statusLabel(r.status) }}</span>
+            </td>
+            <td>
+              <button type="button" class="pg-btn pg-btn--ghost" (click)="review(r)">Review</button>
+            </td>
+          </tr>
+        }
+      }
+    </tbody>
+  </table>
+</div>
+
+@if (showReviewModal && reviewRequestId) {
+  <div class="swr-list-popup-backdrop" (click)="closeReviewModal()">
+    <div class="swr-list-popup-panel" (click)="$event.stopPropagation()">
+      <mifosx-share-withdrawal-request
+        [embedded]="true"
+        [overrideMode]="'review'"
+        [overrideRequestId]="reviewRequestId"
+        (closeRequested)="closeReviewModal()"
+        (actionCompleted)="onReviewActionCompleted()"
+      ></mifosx-share-withdrawal-request>
+    </div>
+  </div>
+}

src/app/tasks/checker-inbox-and-tasks-tabs/share-withdrawal-requests/share-withdrawal-requests.component.scss

@@ -0,0 +1,64 @@
+/**
+ * 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/.
+ */
+
+@keyframes swr-list-popup-fade {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes swr-list-popup-zoom {
+  from {
+    opacity: 0;
+    transform: scale(0.97) translateY(10px);
+  }
+
+  to {
+    opacity: 1;
+    transform: scale(1) translateY(0);
+  }
+}
+
+.swr-list-popup-backdrop {
+  position: fixed;
+  inset: 0;
+  // No backdrop-filter here: filter/backdrop-filter on an ancestor makes browsers treat it as a new
+  // containing block for `position: fixed` descendants — the embedded review screen inside this popup
+  // renders its OWN fixed-position dialogs (Validate, Reject, Confirm-Submit), which would then be
+  // confined to this backdrop's box instead of the real viewport. Extra opacity on the background
+  // color compensates for the loss of the blur look.
+  background: rgb(15 25 45 / 65%);
+  z-index: 1100;
+  display: flex;
+  align-items: flex-start;
+  justify-content: center;
+  padding: 32px 20px;
+  overflow-y: auto;
+  animation: swr-list-popup-fade 0.2s ease-out;
+}
+
+.swr-list-popup-panel {
+  background: #f7f9fc;
+  border-radius: 16px;
+  width: 100%;
+  max-width: 1100px;
+  box-shadow: 0 24px 60px rgb(0 0 0 / 25%);
+  animation: swr-list-popup-zoom 0.25s ease-out;
+  padding: 4px;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .swr-list-popup-backdrop,
+  .swr-list-popup-panel {
+    animation: none;
+  }
+}

src/app/tasks/checker-inbox-and-tasks-tabs/share-withdrawal-requests/share-withdrawal-requests.component.ts

@@ -0,0 +1,128 @@
+/**
+ * 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 { catchError } from 'rxjs/operators';
+import { of } from 'rxjs';
+
+import { ClerkShareWithdrawalService } from '../../../cashier/clerk-share-withdrawal.service';
+import { ShareWithdrawalRequestComponent } from '../../../clerk/share-withdrawal-request/share-withdrawal-request.component';
+
+/** Approval Center — Share Withdrawal Requests tab. A Bank Manager (checker) reviews, approves
+ *  or rejects share withdrawal requests submitted from the Clerk Dashboard. Mirrors
+ *  WithdrawalRequestsComponent (cash withdrawal), adapted for shares. Clicking "Review" opens the
+ *  review screen in a popup on top of this list, rather than navigating away, so approving/rejecting
+ *  drops the manager straight back into the (now refreshed) list. */
+@Component({
+  selector: 'mifosx-share-withdrawal-requests',
+  templateUrl: './share-withdrawal-requests.component.html',
+  styleUrls: [
+    '../../../cashier/cashier-shared.scss',
+    '../../../clerk/clerk-shared.scss',
+    './share-withdrawal-requests.component.scss'
+  ],
+  standalone: true,
+  imports: [
+    CommonModule,
+    FormsModule,
+    ShareWithdrawalRequestComponent
+  ]
+})
+export class ShareWithdrawalRequestsComponent implements OnInit {
+  private service = inject(ClerkShareWithdrawalService);
+
+  requests: any[] = [];
+  totalRecords = 0;
+  loading = false;
+  loaded = false;
+
+  filterStatus = 'PENDING';
+
+  showReviewModal = false;
+  reviewRequestId: number | null = null;
+
+  get statusOptions(): { value: string; label: string }[] {
+    return [
+      { value: 'PENDING', label: 'Pending' },
+      { value: 'APPROVED', label: 'Approved' },
+      { value: 'REJECTED', label: 'Rejected' }
+    ];
+  }
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  load(): void {
+    this.loading = true;
+    this.service
+      .getPendingRequests(this.filterStatus, 0, 50)
+      .pipe(catchError(() => of({ pageItems: [], totalFilteredRecords: 0 })))
+      .subscribe((res: any) => {
+        this.requests = res?.pageItems ?? [];
+        this.totalRecords = Number(res?.totalFilteredRecords ?? 0);
+        this.loading = false;
+        this.loaded = true;
+      });
+  }
+
+  onFilterChange(): void {
+    this.load();
+  }
+
+  review(req: any): void {
+    this.reviewRequestId = req.id;
+    this.showReviewModal = true;
+  }
+
+  closeReviewModal(): void {
+    this.showReviewModal = false;
+    this.reviewRequestId = null;
+  }
+
+  onReviewActionCompleted(): void {
+    this.closeReviewModal();
+    this.load();
+  }
+
+  statusClass(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'inv-badge--active',
+      APPROVED: 'inv-badge--matured',
+      REJECTED: 'inv-badge--written_off'
+    };
+    return `inv-badge ${map[status] ?? ''}`;
+  }
+
+  statusLabel(status: string): string {
+    const map: Record<string, string> = {
+      PENDING: 'Pending',
+      APPROVED: 'Approved',
+      REJECTED: 'Rejected'
+    };
+    return map[status] ?? status;
+  }
+
+  formatDateTime(val: any): string {
+    if (!val) return '—';
+    try {
+      const d = new Date(val);
+      return d.toLocaleString('en-IN', {
+        day: '2-digit',
+        month: 'short',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit'
+      });
+    } catch {
+      return String(val);
+    }
+  }
+}

src/app/tasks/checker-inbox-and-tasks/checker-inbox-and-tasks.component.html

@@ -135,6 +135,24 @@
       <fa-icon icon="money-bill-wave" class="ac-tab__ic"></fa-icon>
       <span>Withdrawal Requests</span>
     </a>
+    <a
+      class="ac-tab"
+      routerLink="./share-withdrawal-requests"
+      routerLinkActive="ac-tab--active"
+      *mifosxHasPermission="'ALL_FUNCTIONS_READ'"
+    >
+      <fa-icon icon="hand-holding-usd" class="ac-tab__ic"></fa-icon>
+      <span>Share Withdrawal Requests</span>
+    </a>
+    <a
+      class="ac-tab"
+      routerLink="./share-closure-requests"
+      routerLinkActive="ac-tab--active"
+      *mifosxHasPermission="'ALL_FUNCTIONS_READ'"
+    >
+      <fa-icon icon="lock" class="ac-tab__ic"></fa-icon>
+      <span>Share Closure Requests</span>
+    </a>
     <a
       class="ac-tab"
       routerLink="./deposit-requests"

src/app/tasks/tasks-routing.module.ts

@@ -17,6 +17,8 @@ import { Route } from '../core/route/route.service';
 import { CheckerInboxAndTasksComponent } from './checker-inbox-and-tasks/checker-inbox-and-tasks.component';
 import { CheckerInboxComponent } from './checker-inbox-and-tasks-tabs/checker-inbox/checker-inbox.component';
 import { WithdrawalRequestsComponent } from './checker-inbox-and-tasks-tabs/withdrawal-requests/withdrawal-requests.component';
+import { ShareWithdrawalRequestsComponent } from './checker-inbox-and-tasks-tabs/share-withdrawal-requests/share-withdrawal-requests.component';
+import { ShareClosureRequestsComponent } from './checker-inbox-and-tasks-tabs/share-closure-requests/share-closure-requests.component';
 import { DepositRequestsComponent } from './checker-inbox-and-tasks-tabs/deposit-requests/deposit-requests.component';
 import { DisbursementRequestsComponent } from './checker-inbox-and-tasks-tabs/disbursement-requests/disbursement-requests.component';
 import { ClientApprovalComponent } from './checker-inbox-and-tasks-tabs/client-approval/client-approval.component';
@@ -159,6 +161,16 @@ const routes: Routes = [
           component: WithdrawalRequestsComponent,
           data: { title: 'Withdrawal Requests' }
         },
+        {
+          path: 'share-withdrawal-requests',
+          component: ShareWithdrawalRequestsComponent,
+          data: { title: 'Share Withdrawal Requests' }
+        },
+        {
+          path: 'share-closure-requests',
+          component: ShareClosureRequestsComponent,
+          data: { title: 'Share Closure Requests' }
+        },
         {
           path: 'deposit-requests',
           component: DepositRequestsComponent,
@@ -200,6 +212,32 @@ const routes: Routes = [
         }
       ]
     },
+    {
+      path: 'checker-inbox-and-tasks/share-withdrawal-requests',
+      children: [
+        {
+          path: ':id/review',
+          loadComponent: () =>
+            import('../clerk/share-withdrawal-request/share-withdrawal-request.component').then(
+              (m) => m.ShareWithdrawalRequestComponent
+            ),
+          data: { title: 'Review Share Withdrawal Request', breadcrumb: 'Review Share Withdrawal', mode: 'review' }
+        }
+      ]
+    },
+    {
+      path: 'checker-inbox-and-tasks/share-closure-requests',
+      children: [
+        {
+          path: ':id/review',
+          loadComponent: () =>
+            import('../clerk/share-closure-request/share-closure-request.component').then(
+              (m) => m.ShareClosureRequestComponent
+            ),
+          data: { title: 'Review Share Closure Request', breadcrumb: 'Review Share Closure', mode: 'review' }
+        }
+      ]
+    },
     {
       path: 'checker-inbox-and-tasks/disbursement-requests',
       children: [

src/app/tds-reports/tds-interest-report.component.html

@@ -0,0 +1,325 @@
+<!--
+  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="tdsr">
+  <div class="tdsr__head">
+    <div class="tdsr__head-l">
+      <fa-icon icon="percentage" class="tdsr__head-ic"></fa-icon>
+      <div>
+        <h2 class="tdsr__title">Deposit Interest &amp; TDS</h2>
+        <div class="tdsr__sub">
+          Quarter-wise and yearly interest on time deposits, with tax deductible under {{ statute.section }} ·
+          {{ scopeLabel }}
+        </div>
+      </div>
+    </div>
+    <button type="button" class="tdsr__btn" (click)="exportWorkbook()" [disabled]="exporting">
+      <fa-icon icon="download"></fa-icon>
+      {{ exporting ? 'Preparing…' : 'Export' }}
+    </button>
+  </div>
+
+  <!-- Summary -->
+  <div class="tdsr__kpis">
+    <div class="tdsr__kpi">
+      <div class="tdsr__kpi-n">{{ summary.deductees | number }}</div>
+      <div class="tdsr__kpi-l">Deductees</div>
+    </div>
+    <div class="tdsr__kpi">
+      <div class="tdsr__kpi-n">₹{{ summary.applicableInterest | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Interest on FD / RD</div>
+    </div>
+    <div class="tdsr__kpi tdsr__kpi--muted">
+      <div class="tdsr__kpi-n">₹{{ summary.exemptInterest | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Savings interest — outside the charge</div>
+    </div>
+    <div class="tdsr__kpi tdsr__kpi--warn">
+      <div class="tdsr__kpi-n">₹{{ summary.totalTds | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">TDS payable</div>
+    </div>
+    <div class="tdsr__kpi tdsr__kpi--warn">
+      <div class="tdsr__kpi-n">{{ summary.crossed | number }}</div>
+      <div class="tdsr__kpi-l">Crossed the threshold</div>
+    </div>
+    <button type="button" class="tdsr__kpi tdsr__kpi--action" (click)="showNearThreshold()">
+      <div class="tdsr__kpi-n">{{ summary.nearThreshold | number }}</div>
+      <div class="tdsr__kpi-l">Within ₹{{ nearBand | number: '1.0-0' }} of it — chase a declaration</div>
+    </button>
+    <div class="tdsr__kpi tdsr__kpi--ok">
+      <div class="tdsr__kpi-n">₹{{ summary.tdsSaved | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Saved by {{ summary.declarations | number }} declarations</div>
+    </div>
+    @if (summary.noPan > 0) {
+      <div class="tdsr__kpi tdsr__kpi--warn">
+        <div class="tdsr__kpi-n">{{ summary.noPan | number }}</div>
+        <div class="tdsr__kpi-l">No PAN — deducted at 20%</div>
+      </div>
+    }
+  </div>
+
+  <!-- Quarter strip -->
+  <div class="tdsr__card">
+    <div class="tdsr__card-head"><fa-icon icon="calendar"></fa-icon> Quarter by quarter</div>
+    <div class="tdsr__qstrip">
+      @for (q of summary.byQuarter; track q.quarter) {
+        <div class="tdsr__qcell">
+          <div class="tdsr__qcell-l">{{ quarterLabel[q.quarter] }}</div>
+          <div class="tdsr__qcell-n">₹{{ q.interest | number: '1.0-0' }}</div>
+          <div class="tdsr__qcell-s">TDS ₹{{ q.tds | number: '1.0-0' }}</div>
+        </div>
+      }
+    </div>
+  </div>
+
+  <!-- Filters -->
+  <div class="tdsr__filters">
+    <label class="tdsr__filter">
+      <span>Financial year</span>
+      <select [(ngModel)]="filter.fy">
+        @for (year of financialYears; track year) {
+          <option [value]="year">FY {{ year }}</option>
+        }
+      </select>
+    </label>
+
+    @if (canSelectBranch) {
+      <label class="tdsr__filter">
+        <span>Branch</span>
+        <select [(ngModel)]="filter.branchCode">
+          <option value="">All branches</option>
+          @for (b of branches; track b.code) {
+            <option [value]="b.code">{{ b.name }}</option>
+          }
+        </select>
+      </label>
+    }
+
+    <label class="tdsr__filter">
+      <span>Quarter</span>
+      <select [(ngModel)]="filter.quarter">
+        <option [ngValue]="0">Whole year</option>
+        @for (q of quarters; track q) {
+          <option [ngValue]="q">{{ quarterLabel[q] }}</option>
+        }
+      </select>
+    </label>
+
+    <label class="tdsr__filter">
+      <span>Threshold band</span>
+      <select [(ngModel)]="filter.band">
+        <option value="">Both bands</option>
+        <option value="GENERAL">General (below 60)</option>
+        <option value="SENIOR">Senior citizen (60+)</option>
+      </select>
+    </label>
+
+    <label class="tdsr__filter tdsr__filter--wide">
+      <span>Customer / CIF / PAN</span>
+      <input type="text" [(ngModel)]="filter.search" placeholder="name, CIF or PAN" />
+    </label>
+
+    <label class="tdsr__check">
+      <input type="checkbox" [(ngModel)]="filter.crossedOnly" />
+      <span>Threshold crossed only</span>
+    </label>
+
+    <label class="tdsr__check">
+      <input type="checkbox" [(ngModel)]="filter.nearThresholdOnly" />
+      <span>Near threshold only</span>
+    </label>
+
+    @if (hasFilters) {
+      <button type="button" class="tdsr__clear" (click)="clearFilters()"><fa-icon icon="times"></fa-icon> Clear</button>
+    }
+  </div>
+
+  <!-- Table -->
+  <div class="tdsr__card">
+    <div class="tdsr__table-wrap">
+      <table class="tdsr__table">
+        <thead>
+          <tr>
+            <th>Customer · PAN</th>
+            <th>Branch</th>
+            <th>Form · Band</th>
+            <th class="num">Q1</th>
+            <th class="num">Q2</th>
+            <th class="num">Q3</th>
+            <th class="num">Q4</th>
+            <th class="num">Year total</th>
+            <th class="num">Threshold</th>
+            <th>Crossed</th>
+            <th class="num">TDS</th>
+            <th class="num">Saved</th>
+            <th class="col-actions"></th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (row of rows; track trackRow($index, row)) {
+            <tr [class.tdsr__row--warn]="!row.panOnRecord" [class.tdsr__row--near]="row.nearThreshold">
+              <td>
+                <div class="tdsr__name">{{ row.deductee.name }}</div>
+                <div class="mono small muted">
+                  {{ row.deductee.customerId }} ·
+                  @if (row.panOnRecord) {
+                    {{ row.deductee.pan }}
+                  } @else {
+                    <span class="tdsr__pill tdsr__pill--warn">no PAN</span>
+                  }
+                </div>
+              </td>
+              <td class="small">{{ branchName(row.branchCode) }}</td>
+              <td>
+                <span class="tdsr__pill" [class.tdsr__pill--ok]="row.hasDeclaration">
+                  {{ row.form === '121' ? '121' : row.form }}
+                </span>
+                <div class="small muted">{{ row.band === 'SENIOR' ? 'Senior' : 'General' }}</div>
+                @if (row.hasDeclaration) {
+                  <div class="mono small muted">{{ row.declarationUin }}</div>
+                }
+              </td>
+              @for (q of quarters; track q) {
+                <td class="num small">
+                  @if (row.quarters[q]) {
+                    ₹{{ row.quarters[q] | number: '1.0-0' }}
+                  } @else {
+                    <span class="muted">—</span>
+                  }
+                </td>
+              }
+              <td class="num">
+                <strong>₹{{ row.tdsApplicableInterest | number: '1.0-0' }}</strong>
+                @if (row.exemptInterest) {
+                  <div class="small muted">+₹{{ row.exemptInterest | number: '1.0-0' }} SB (exempt)</div>
+                }
+              </td>
+              <td class="num small muted">₹{{ row.threshold | number: '1.0-0' }}</td>
+              <td class="small">
+                @if (row.crossedInQuarter) {
+                  <span class="tdsr__pill tdsr__pill--warn">Q{{ row.crossedInQuarter }}</span>
+                } @else if (row.nearThreshold) {
+                  <span class="tdsr__pill tdsr__pill--near"> ₹{{ row.headroom | number: '1.0-0' }} left </span>
+                } @else {
+                  <span class="muted">—</span>
+                }
+              </td>
+              <td class="num">
+                @if (row.schedule.totalTds) {
+                  <strong>₹{{ row.schedule.totalTds | number: '1.0-0' }}</strong>
+                  <div class="small muted">@ {{ row.rateApplied * 100 | number: '1.0-0' }}%</div>
+                } @else {
+                  <span class="muted">—</span>
+                }
+              </td>
+              <td class="num">
+                @if (row.tdsSaved) {
+                  <strong class="tdsr__ok">₹{{ row.tdsSaved | number: '1.0-0' }}</strong>
+                } @else {
+                  <span class="muted">—</span>
+                }
+              </td>
+              <td class="col-actions">
+                <button type="button" class="tdsr__icon-btn" (click)="toggleExpanded(row)">
+                  <fa-icon [icon]="isExpanded(row) ? 'chevron-up' : 'chevron-down'"></fa-icon>
+                </button>
+              </td>
+            </tr>
+
+            @if (isExpanded(row)) {
+              <tr class="tdsr__row--detail">
+                <td colspan="13">
+                  @for (note of row.schedule.notes; track note) {
+                    <div class="tdsr__note">
+                      <fa-icon icon="info-circle"></fa-icon>
+                      <div>{{ note }}</div>
+                    </div>
+                  }
+                  @if (row.jointHeldInterest) {
+                    <div class="tdsr__note">
+                      <fa-icon icon="info-circle"></fa-icon>
+                      <div>
+                        ₹{{ row.jointHeldInterest | number: '1.0-0' }} of interest sits on deposits where this customer
+                        is a joint holder but not the first-named one. Tax there is deducted against the first-named
+                        holder, so it is excluded from the figures above.
+                      </div>
+                    </div>
+                  }
+
+                  <table class="tdsr__table tdsr__table--inner">
+                    <thead>
+                      <tr>
+                        <th>Quarter</th>
+                        <th class="num">Interest</th>
+                        <th class="num">Cumulative</th>
+                        <th class="num">Liability to date</th>
+                        <th class="num">TDS this quarter</th>
+                        <th>Return due</th>
+                      </tr>
+                    </thead>
+                    <tbody>
+                      @for (line of row.schedule.lines; track line.quarter) {
+                        <tr [class.tdsr__row--warn]="line.thresholdCrossedHere">
+                          <td class="small">
+                            {{ line.label }}
+                            @if (line.thresholdCrossedHere) {
+                              <span class="tdsr__pill tdsr__pill--warn">crossed here</span>
+                            }
+                            @if (line.declarationActive) {
+                              <span class="tdsr__pill tdsr__pill--ok">Form 121 active</span>
+                            }
+                          </td>
+                          <td class="num">₹{{ line.interest | number: '1.0-0' }}</td>
+                          <td class="num">₹{{ line.cumInterest | number: '1.0-0' }}</td>
+                          <td class="num">₹{{ line.cumLiability | number: '1.0-0' }}</td>
+                          <td class="num">
+                            @if (line.tds !== 0) {
+                              <strong>₹{{ line.tds | number: '1.0-0' }}</strong>
+                            } @else {
+                              <span class="muted">—</span>
+                            }
+                          </td>
+                          <td class="small muted">{{ line.dueDate }}</td>
+                        </tr>
+                      }
+                    </tbody>
+                  </table>
+
+                  <div class="tdsr__meta">
+                    <span
+                      >Settlement: <strong>{{ row.mode === 'QUARTERLY' ? 'Quarterly' : 'Year end' }}</strong> (set by
+                      the deposit product)</span
+                    >
+                    @if (row.declarationAcceptedOn) {
+                      <span
+                        >Declaration accepted: <strong>{{ row.declarationAcceptedOn | date: 'd MMM y' }}</strong></span
+                      >
+                    }
+                    @if (row.paidWithoutDeduction) {
+                      <span>
+                        Paid without deduction:
+                        <strong>₹{{ row.paidWithoutDeduction | number: '1.0-0' }}</strong> — reportable in
+                        {{ statute.statement }}
+                      </span>
+                    }
+                  </div>
+                </td>
+              </tr>
+            }
+          }
+          @if (rows.length === 0) {
+            <tr>
+              <td colspan="13" class="tdsr__empty">
+                <fa-icon icon="info-circle"></fa-icon> No deductees match the current filters.
+              </td>
+            </tr>
+          }
+        </tbody>
+      </table>
+    </div>
+  </div>
+</div>

src/app/tds-reports/tds-interest-report.component.ts

@@ -0,0 +1,250 @@
+/**
+ * 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 { FormsModule } from '@angular/forms';
+import { FaIconComponent } from '@fortawesome/angular-fontawesome';
+import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
+import * as ExcelJS from 'exceljs';
+
+import { BranchScopeService } from '../core/branch-scope.service';
+import { GL_BRANCHES, glBranchName } from '../gl-reports/gl-reports-data';
+import { FY_TAX_CONFIG, Quarter, QUARTER_LABEL } from '../letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+import { TDS_FYS } from './tds-reports-data';
+import {
+  NEAR_THRESHOLD_BAND,
+  TdsInterestRow,
+  TdsInterestSummary,
+  TdsReportFilter,
+  tdsInterestRows,
+  tdsInterestSummary
+} from './tds-reports.compute';
+
+@Component({
+  selector: 'mifosx-tds-interest-report',
+  templateUrl: './tds-interest-report.component.html',
+  styleUrls: ['./tds-reports.shared.scss'],
+  imports: [
+    ...STANDALONE_SHARED_IMPORTS,
+    FaIconComponent,
+    FormsModule
+  ]
+})
+export class TdsInterestReportComponent implements OnInit {
+  private scope = inject(BranchScopeService);
+
+  readonly branches = GL_BRANCHES.filter((b) => b.code !== 'HO');
+  readonly financialYears = TDS_FYS;
+  readonly quarterLabel = QUARTER_LABEL;
+  readonly nearBand = NEAR_THRESHOLD_BAND;
+  readonly quarters: Quarter[] = [
+    1,
+    2,
+    3,
+    4
+  ];
+
+  filter: TdsReportFilter = {
+    fy: TDS_FYS[0],
+    branchCode: '',
+    quarter: 0,
+    band: '',
+    search: '',
+    crossedOnly: false,
+    nearThresholdOnly: false
+  };
+
+  /** Which customer's quarter-wise detail is open. */
+  expandedId: string | null = null;
+  exporting = false;
+
+  ngOnInit(): void {
+    // A branch login sees only its own book and cannot widen the scope.
+    const own = this.scope.ownBranchCode;
+    if (own) {
+      this.filter.branchCode = own;
+    }
+  }
+
+  /**
+   * Provision and return references for the selected year. The charge moved from
+   * section 194A to section 393(1) on 01 April 2026 and the quarterly return
+   * became Form 140, so the labels are read from the config rather than written
+   * into the template.
+   */
+  get statute(): { section: string; statement: string; frequency: string } {
+    const cfg = FY_TAX_CONFIG[this.filter.fy];
+    return {
+      section: cfg?.interestTdsSection ?? '—',
+      statement: cfg?.tdsStatementForm ?? '—',
+      frequency: cfg?.declarationStatementFrequency === 'MONTHLY' ? 'monthly' : 'quarterly'
+    };
+  }
+
+  get canSelectBranch(): boolean {
+    return this.scope.canSelectBranch;
+  }
+
+  get scopeLabel(): string {
+    return this.filter.branchCode ? glBranchName(this.filter.branchCode) : 'All branches';
+  }
+
+  get rows(): TdsInterestRow[] {
+    return tdsInterestRows(this.filter);
+  }
+
+  get summary(): TdsInterestSummary {
+    return tdsInterestSummary(this.filter);
+  }
+
+  get hasFilters(): boolean {
+    return !!(
+      this.filter.search ||
+      this.filter.quarter ||
+      this.filter.band ||
+      this.filter.crossedOnly ||
+      this.filter.nearThresholdOnly
+    );
+  }
+
+  clearFilters(): void {
+    this.filter = {
+      ...this.filter,
+      quarter: 0,
+      band: '',
+      search: '',
+      crossedOnly: false,
+      nearThresholdOnly: false
+    };
+  }
+
+  /** Jump straight to the customers worth chasing a declaration from. */
+  showNearThreshold(): void {
+    this.filter = { ...this.filter, crossedOnly: false, nearThresholdOnly: true };
+  }
+
+  toggleExpanded(row: TdsInterestRow): void {
+    this.expandedId = this.expandedId === row.deductee.customerId ? null : row.deductee.customerId;
+  }
+
+  isExpanded(row: TdsInterestRow): boolean {
+    return this.expandedId === row.deductee.customerId;
+  }
+
+  branchName(code: string): string {
+    return glBranchName(code);
+  }
+
+  trackRow(_: number, row: TdsInterestRow): string {
+    return row.deductee.customerId;
+  }
+
+  async exportWorkbook(): Promise<void> {
+    this.exporting = true;
+    try {
+      const wb = new ExcelJS.Workbook();
+      const ws = wb.addWorksheet(`TDS Interest FY ${this.filter.fy}`);
+
+      ws.addRow([`Deposit Interest & TDS — FY ${this.filter.fy}`]);
+      ws.addRow([`Scope: ${this.scopeLabel}`]);
+      ws.addRow([]);
+      ws.addRow([
+        'Customer',
+        'CIF',
+        'PAN',
+        'Branch',
+        'Form',
+        'Band',
+        'Age',
+        'Q1',
+        'Q2',
+        'Q3',
+        'Q4',
+        'Interest (FD/RD)',
+        'Savings interest (exempt)',
+        'Threshold',
+        'Crossed in',
+        'Rate %',
+        'TDS payable',
+        'Declaration',
+        'UIN',
+        'TDS saved',
+        'Paid without deduction'
+      ]);
+
+      for (const r of this.rows) {
+        ws.addRow([
+          r.deductee.name,
+          r.deductee.customerId,
+          r.deductee.pan || 'NOT ON RECORD',
+          this.branchName(r.branchCode),
+          r.form === '121' ? 'Form 121' : `Form ${r.form}`,
+          r.band === 'SENIOR' ? 'Senior citizen' : 'General',
+          r.age,
+          r.quarters[1],
+          r.quarters[2],
+          r.quarters[3],
+          r.quarters[4],
+          r.tdsApplicableInterest,
+          r.exemptInterest,
+          r.threshold,
+          r.crossedInQuarter ? `Q${r.crossedInQuarter}` : '—',
+          r.rateApplied * 100,
+          r.schedule.totalTds,
+          r.hasDeclaration ? 'Yes' : 'No',
+          r.declarationUin ?? '',
+          r.tdsSaved,
+          r.paidWithoutDeduction
+        ]);
+      }
+
+      const s = this.summary;
+      ws.addRow([]);
+      ws.addRow([
+        'TOTAL',
+        `${s.deductees} deductees`,
+        '',
+        '',
+        '',
+        '',
+        '',
+        s.byQuarter[0].interest,
+        s.byQuarter[1].interest,
+        s.byQuarter[2].interest,
+        s.byQuarter[3].interest,
+        s.applicableInterest,
+        s.exemptInterest,
+        '',
+        '',
+        '',
+        s.totalTds,
+        `${s.declarations} filed`,
+        '',
+        s.tdsSaved,
+        s.paidWithoutDeduction
+      ]);
+
+      ws.getRow(1).font = { bold: true, size: 13 };
+      ws.getRow(4).font = { bold: true };
+      ws.columns.forEach((c) => (c.width = 18));
+
+      const buffer = await wb.xlsx.writeBuffer();
+      const blob = new Blob([buffer], {
+        type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+      });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = `TDS-Interest-FY${this.filter.fy}.xlsx`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } finally {
+      this.exporting = false;
+    }
+  }
+}

src/app/tds-reports/tds-remittance-report.component.html

@@ -0,0 +1,237 @@
+<!--
+  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="tdsr">
+  <div class="tdsr__head">
+    <div class="tdsr__head-l">
+      <fa-icon icon="building-columns" class="tdsr__head-ic"></fa-icon>
+      <div>
+        <h2 class="tdsr__title">TDS Remitted to Government</h2>
+        <div class="tdsr__sub">
+          Challan-wise deposits and the {{ statute.statement }} year-end position · {{ scopeLabel }} · as at
+          {{ asAt | date: 'd MMM y' }}
+        </div>
+      </div>
+    </div>
+    <div class="tdsr__head-r">
+      <label class="tdsr__filter">
+        <span>Financial year</span>
+        <select [(ngModel)]="fy">
+          @for (year of financialYears; track year) {
+            <option [value]="year">FY {{ year }}</option>
+          }
+        </select>
+      </label>
+      <button type="button" class="tdsr__btn" (click)="exportWorkbook()" [disabled]="exporting">
+        <fa-icon icon="download"></fa-icon>
+        {{ exporting ? 'Preparing…' : 'Export' }}
+      </button>
+    </div>
+  </div>
+
+  <!-- The control figure, first thing on the page -->
+  @if (reconciled) {
+    <div class="tdsr__banner tdsr__banner--ok">
+      <fa-icon icon="check-circle"></fa-icon>
+      <div>
+        <strong>Reconciled.</strong>
+        ₹{{ summary.totalDeducted | number: '1.0-0' }} deducted, ₹{{
+          summary.totalDeposited | number: '1.0-0'
+        }}
+        deposited, ₹{{ summary.pendingDeposit | number: '1.0-0' }} still within its due date.
+      </div>
+    </div>
+  } @else {
+    <div class="tdsr__banner tdsr__banner--warn">
+      <fa-icon icon="exclamation-triangle"></fa-icon>
+      <div>
+        <strong>Does not reconcile — ₹{{ summary.difference | number: '1.0-0' }} unaccounted.</strong>
+        Tax deducted must equal tax deposited plus tax still within its due date. Find the difference before filing the
+        return.
+      </div>
+    </div>
+  }
+
+  @if (summary.overdueChallans > 0) {
+    <div class="tdsr__banner tdsr__banner--warn">
+      <fa-icon icon="exclamation-triangle"></fa-icon>
+      <div>
+        <strong>{{ summary.overdueChallans }} challan{{ summary.overdueChallans === 1 ? '' : 's' }} overdue.</strong>
+        Interest runs at 1.5% for every month or part of a month until the tax reaches the Government.
+      </div>
+    </div>
+  }
+
+  <!-- KPIs -->
+  <div class="tdsr__kpis">
+    <div class="tdsr__kpi tdsr__kpi--warn">
+      <div class="tdsr__kpi-n">₹{{ summary.totalDeducted | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Total TDS deducted</div>
+    </div>
+    <div class="tdsr__kpi tdsr__kpi--ok">
+      <div class="tdsr__kpi-n">₹{{ summary.totalDeposited | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Deposited with Government</div>
+    </div>
+    <div class="tdsr__kpi">
+      <div class="tdsr__kpi-n">₹{{ summary.pendingDeposit | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Within due date</div>
+    </div>
+    <div class="tdsr__kpi" [class.tdsr__kpi--warn]="totalDefaultInterest > 0">
+      <div class="tdsr__kpi-n">₹{{ totalDefaultInterest | number: '1.0-0' }}</div>
+      <div class="tdsr__kpi-l">Interest on late deposit</div>
+    </div>
+    <div class="tdsr__kpi">
+      <div class="tdsr__kpi-n">{{ summary.deductees | number }}</div>
+      <div class="tdsr__kpi-l">Deductees in the return</div>
+    </div>
+  </div>
+
+  <!-- Part A: challans -->
+  <div class="tdsr__card">
+    <div class="tdsr__card-head"><fa-icon icon="receipt"></fa-icon> Part A — challan-wise remittance</div>
+    <div class="tdsr__table-wrap">
+      <table class="tdsr__table">
+        <thead>
+          <tr>
+            <th>Quarter</th>
+            <th>Deduction month</th>
+            <th class="num">Amount</th>
+            <th>Due date</th>
+            <th>Deposited on</th>
+            <th>Challan · BSR</th>
+            <th>Status</th>
+            <th class="num">Late-deposit interest</th>
+            <th>{{ statute.statement }} due</th>
+          </tr>
+        </thead>
+        <tbody>
+          @for (row of rows; track trackRow($index, row)) {
+            <tr [class.tdsr__row--warn]="row.late || row.overdue">
+              <td>
+                <strong>{{ quarterLabel[row.quarter] }}</strong>
+              </td>
+              <td class="small">{{ row.month }}</td>
+              <td class="num">
+                <strong>₹{{ row.amount | number: '1.0-0' }}</strong>
+              </td>
+              <td class="small">{{ row.dueDate | date: 'd MMM y' }}</td>
+              <td class="small">
+                @if (row.depositedOn) {
+                  {{ row.depositedOn | date: 'd MMM y' }}
+                } @else {
+                  <span class="muted">—</span>
+                }
+              </td>
+              <td class="mono small">
+                @if (row.challanNo) {
+                  {{ row.challanNo }}
+                  <div class="muted">BSR {{ row.bsrCode }}</div>
+                } @else {
+                  <span class="muted">—</span>
+                }
+              </td>
+              <td>
+                @if (row.overdue) {
+                  <span class="tdsr__pill tdsr__pill--warn">Overdue</span>
+                } @else if (row.late) {
+                  <span class="tdsr__pill tdsr__pill--warn">Late by {{ row.delayMonths }}m</span>
+                } @else if (row.depositedOn) {
+                  <span class="tdsr__pill tdsr__pill--ok">On time</span>
+                } @else {
+                  <span class="tdsr__pill">Within due date</span>
+                }
+              </td>
+              <td class="num">
+                @if (row.defaultInterest) {
+                  <strong class="tdsr__warn-text">₹{{ row.defaultInterest | number: '1.0-0' }}</strong>
+                  <div class="small muted">1.5% × {{ row.delayMonths }}</div>
+                } @else {
+                  <span class="muted">—</span>
+                }
+              </td>
+              <td class="small muted">{{ row.returnDueDate }}</td>
+            </tr>
+          }
+          @if (rows.length === 0) {
+            <tr>
+              <td colspan="9" class="tdsr__empty">
+                <fa-icon icon="info-circle"></fa-icon> No tax was deducted in this financial year.
+              </td>
+            </tr>
+          }
+        </tbody>
+      </table>
+    </div>
+    <div class="tdsr__foot">
+      Tax deducted in a month must reach the Government by the seventh of the following month; March runs to 30 April.
+    </div>
+  </div>
+
+  <!-- Part B: return summary -->
+  <div class="tdsr__card">
+    <div class="tdsr__card-head">
+      <fa-icon icon="file-alt"></fa-icon> Part B — {{ statute.statement }} year-end position
+    </div>
+    <div class="tdsr__ledger">
+      <div class="tdsr__ledger-row">
+        <span>Total interest paid on time deposits</span>
+        <span class="num">₹{{ summary.totalInterestPaid | number: '1.0-0' }}</span>
+      </div>
+      <div class="tdsr__ledger-row tdsr__ledger-row--indent">
+        <span>with tax deducted</span>
+        <span class="num">₹{{ summary.interestWithDeduction | number: '1.0-0' }}</span>
+      </div>
+      <div class="tdsr__ledger-row tdsr__ledger-row--indent">
+        <span>
+          without deduction — declaration on record
+          <em>mandatory disclosure in {{ statute.statement }}</em>
+        </span>
+        <span class="num">₹{{ summary.interestWithoutDeduction | number: '1.0-0' }}</span>
+      </div>
+
+      <div class="tdsr__ledger-row tdsr__ledger-row--sep">
+        <span>TDS at standard rate — PAN on record</span>
+        <span class="num">₹{{ summary.tdsAtStandardRate | number: '1.0-0' }}</span>
+      </div>
+      <div class="tdsr__ledger-row">
+        <span>TDS at higher rate — no PAN on record</span>
+        <span class="num">₹{{ summary.tdsAtHigherRate | number: '1.0-0' }}</span>
+      </div>
+
+      <div class="tdsr__ledger-row tdsr__ledger-row--total">
+        <span>Total TDS deducted</span>
+        <span class="num">₹{{ summary.totalDeducted | number: '1.0-0' }}</span>
+      </div>
+      <div class="tdsr__ledger-row">
+        <span>Deposited with Government</span>
+        <span class="num">₹{{ summary.totalDeposited | number: '1.0-0' }}</span>
+      </div>
+      <div class="tdsr__ledger-row">
+        <span>Still within due date</span>
+        <span class="num">₹{{ summary.pendingDeposit | number: '1.0-0' }}</span>
+      </div>
+      <div class="tdsr__ledger-row tdsr__ledger-row--control" [class.tdsr__ledger-row--bad]="!reconciled">
+        <span>Difference — must be zero</span>
+        <span class="num">₹{{ summary.difference | number: '1.0-0' }}</span>
+      </div>
+
+      @if (summary.defaultInterest > 0) {
+        <div class="tdsr__ledger-row tdsr__ledger-row--sep">
+          <span>Interest payable by the bank for late deposit</span>
+          <span class="num">₹{{ summary.defaultInterest | number: '1.0-0' }}</span>
+        </div>
+      }
+    </div>
+    <div class="tdsr__foot">
+      The "without deduction" line is not optional — interest paid gross against a declaration must be reported in the
+      quarterly {{ statute.statement }} return with the appropriate remark code, and the consolidated statement of
+      declarations received is uploaded {{ statute.frequency }}. Confirm the remark code against the current
+      specification before generating the file.
+    </div>
+  </div>
+</div>

src/app/tds-reports/tds-remittance-report.component.ts

@@ -0,0 +1,203 @@
+/**
+ * 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, inject } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { FaIconComponent } from '@fortawesome/angular-fontawesome';
+import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
+import * as ExcelJS from 'exceljs';
+
+import { BranchScopeService } from '../core/branch-scope.service';
+import { FY_TAX_CONFIG, QUARTER_LABEL } from '../letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+import { TDS_AS_AT, TDS_FYS } from './tds-reports-data';
+import { Tds26qSummary, TdsRemittanceRow, tds26qSummary, tdsRemittanceRows } from './tds-reports.compute';
+
+@Component({
+  selector: 'mifosx-tds-remittance-report',
+  templateUrl: './tds-remittance-report.component.html',
+  styleUrls: ['./tds-reports.shared.scss'],
+  imports: [
+    ...STANDALONE_SHARED_IMPORTS,
+    FaIconComponent,
+    FormsModule
+  ]
+})
+export class TdsRemittanceReportComponent {
+  private scope = inject(BranchScopeService);
+
+  readonly financialYears = TDS_FYS;
+  readonly quarterLabel = QUARTER_LABEL;
+  readonly asAt = TDS_AS_AT;
+
+  fy = TDS_FYS[0];
+  exporting = false;
+
+  /**
+   * Provision and return references for the selected year. The quarterly return
+   * became Form 140 under the 2025 Act, so the labels are read from the config
+   * rather than written into the template.
+   */
+  get statute(): { section: string; statement: string; frequency: string } {
+    const cfg = FY_TAX_CONFIG[this.fy];
+    return {
+      section: cfg?.interestTdsSection ?? '—',
+      statement: cfg?.tdsStatementForm ?? '—',
+      frequency: cfg?.declarationStatementFrequency === 'MONTHLY' ? 'monthly' : 'quarterly'
+    };
+  }
+
+  get scopeLabel(): string {
+    return this.scope.isHeadOffice ? 'Bank as a whole' : this.scope.officeName;
+  }
+
+  get rows(): TdsRemittanceRow[] {
+    return tdsRemittanceRows(this.fy, this.asAt);
+  }
+
+  get summary(): Tds26qSummary {
+    return tds26qSummary(this.fy, this.asAt);
+  }
+
+  /**
+   * The control that matters. Tax deducted must equal tax deposited plus tax
+   * still within its due date. Anything else means something has gone missing
+   * and must be found before the return is filed.
+   */
+  get reconciled(): boolean {
+    return this.summary.difference === 0;
+  }
+
+  get totalDefaultInterest(): number {
+    return this.summary.defaultInterest;
+  }
+
+  trackRow(_: number, row: TdsRemittanceRow): string {
+    return `${row.fy}-${row.quarter}`;
+  }
+
+  async exportWorkbook(): Promise<void> {
+    this.exporting = true;
+    try {
+      const s = this.summary;
+      const wb = new ExcelJS.Workbook();
+
+      const challan = wb.addWorksheet('Challans');
+      challan.addRow([`TDS remitted to Government — FY ${this.fy}`]);
+      challan.addRow([`Scope: ${this.scopeLabel} · as at ${this.asAt}`]);
+      challan.addRow([]);
+      challan.addRow([
+        'Quarter',
+        'Deduction month',
+        'Amount deducted',
+        'Due date',
+        'Deposited on',
+        'Challan no.',
+        'BSR code',
+        'Status',
+        'Delay (months)',
+        'Late-deposit interest',
+        `${this.statute.statement} due`
+      ]);
+      for (const r of this.rows) {
+        challan.addRow([
+          `Q${r.quarter}`,
+          r.month,
+          r.amount,
+          r.dueDate,
+          r.depositedOn ?? 'PENDING',
+          r.challanNo ?? '',
+          r.bsrCode ?? '',
+          r.overdue ? 'OVERDUE' : r.late ? 'LATE' : r.depositedOn ? 'On time' : 'Within due date',
+          r.delayMonths || '',
+          r.defaultInterest || '',
+          r.returnDueDate
+        ]);
+      }
+      challan.getRow(1).font = { bold: true, size: 13 };
+      challan.getRow(4).font = { bold: true };
+      challan.columns.forEach((c) => (c.width = 18));
+
+      const recon = wb.addWorksheet('Return Summary');
+      recon.addRow([`${this.statute.statement} year-end position — FY ${this.fy}`]);
+      recon.addRow([]);
+      const lines: [string, number | string][] = [
+        [
+          'Deductees',
+          s.deductees
+        ],
+        [
+          'Total interest paid on time deposits',
+          s.totalInterestPaid
+        ],
+        [
+          '  — with tax deducted',
+          s.interestWithDeduction
+        ],
+        [
+          '  — without deduction (declaration on record)',
+          s.interestWithoutDeduction
+        ],
+        [
+          'TDS at standard rate (PAN on record)',
+          s.tdsAtStandardRate
+        ],
+        [
+          'TDS at higher rate (no PAN)',
+          s.tdsAtHigherRate
+        ],
+        [
+          'Total TDS deducted',
+          s.totalDeducted
+        ],
+        [
+          'Total deposited with Government',
+          s.totalDeposited
+        ],
+        [
+          'Still within due date',
+          s.pendingDeposit
+        ],
+        [
+          'DIFFERENCE (must be zero)',
+          s.difference
+        ],
+        [
+          'Interest payable for late deposit',
+          s.defaultInterest
+        ],
+        [
+          'Challans deposited late',
+          s.lateChallans
+        ],
+        [
+          'Challans overdue',
+          s.overdueChallans
+        ]
+      ];
+      for (const line of lines) {
+        recon.addRow(line);
+      }
+      recon.getRow(1).font = { bold: true, size: 13 };
+      recon.columns.forEach((c) => (c.width = 42));
+      recon.getColumn(2).width = 20;
+
+      const buffer = await wb.xlsx.writeBuffer();
+      const blob = new Blob([buffer], {
+        type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+      });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = `TDS-Remittance-FY${this.fy}.xlsx`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } finally {
+      this.exporting = false;
+    }
+  }
+}

src/app/tds-reports/tds-reports-data.ts

@@ -0,0 +1,396 @@
+/**
+ * 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/.
+ */
+
+/**
+ * Deductees and their deposit interest, for the two TDS reports.
+ *
+ * The bank's deduction obligation runs on time deposits, so the seed
+ * gives each customer a mix of fixed and recurring deposits — and some savings
+ * accounts, which are outside the section and must stay out of the aggregate.
+ *
+ * Everything is generated from a fixed seed so the figures do not move between
+ * loads, and the challan schedule is deliberately imperfect: one quarter is
+ * deposited late so the default-interest column has something to show.
+ */
+
+import { GL_BRANCHES } from '../gl-reports/gl-reports-data';
+import {
+  Declaration,
+  Form15Kind,
+  InterestCredit,
+  TdsAccountInput
+} from '../letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+
+/** The years the seed covers. 2025-26 is complete; 2026-27 is in progress. */
+export const TDS_FYS = [
+  '2026-27',
+  '2025-26'
+];
+
+/** Business date the book is drawn to — Q1 of 2026-27 is closed, Q2 is running. */
+export const TDS_AS_AT = '2026-08-01';
+
+export interface TdsDeductee {
+  clientId: number;
+  customerId: string;
+  name: string;
+  pan: string;
+  dob: string;
+  branchCode: string;
+  /** Declarations on record, keyed by financial year. */
+  declarations: Record<string, Declaration>;
+  accounts: TdsAccountInput[];
+}
+
+/** One month's remittance of deducted tax to the Government. */
+export interface TdsChallan {
+  fy: string;
+  /** Quarter the deduction belongs to. */
+  quarter: 1 | 2 | 3 | 4;
+  /** Month the tax was deducted in, e.g. '2026-06'. */
+  month: string;
+  amount: number;
+  /** Statutory date by which it had to be deposited. */
+  dueDate: string;
+  /** When it actually reached the Government — null while still pending. */
+  depositedOn: string | null;
+  challanNo: string | null;
+  bsrCode: string | null;
+}
+
+/** Deterministic linear congruential generator — same figures on every load. */
+function lcg(seed: number): () => number {
+  let s = seed >>> 0;
+  return () => {
+    s = (Math.imul(s, 1664525) + 1013904223) >>> 0;
+    return s / 4294967296;
+  };
+}
+
+function pick<T>(rand: () => number, list: T[]): T {
+  return list[Math.floor(rand() * list.length)];
+}
+
+const FIRST_NAMES = [
+  'Ramesh',
+  'Sunita',
+  'Vitthal',
+  'Kamala',
+  'Ganpat',
+  'Shobha',
+  'Dnyaneshwar',
+  'Mangala',
+  'Bhaskar',
+  'Anita',
+  'Tukaram',
+  'Sarika',
+  'Nivrutti',
+  'Rekha',
+  'Popat',
+  'Chhaya',
+  'Ashok',
+  'Vaishali',
+  'Sitaram',
+  'Jayshree',
+  'Madhukar',
+  'Pushpa',
+  'Eknath',
+  'Sulochana',
+  'Hanumant',
+  'Kalpana'
+];
+
+const SURNAMES = [
+  'Jadhav',
+  'Pawar',
+  'Shinde',
+  'Gaikwad',
+  'More',
+  'Kadam',
+  'Bhosale',
+  'Patil',
+  'Sawant',
+  'Chavan',
+  'Salunkhe',
+  'Mane',
+  'Deshmukh',
+  'Thorat',
+  'Nikam',
+  'Wagh'
+];
+
+/**
+ * Quarter-end dates for a financial year. Interest is credited on these, which
+ * is what makes the deduction fall due.
+ */
+function quarterEnds(fy: string): string[] {
+  const y = Number(fy.slice(0, 4));
+  return [
+    `${y}-06-30`,
+    `${y}-09-30`,
+    `${y}-12-31`,
+    `${y + 1}-03-31`
+  ];
+}
+
+/** A well-formed individual PAN — fourth character 'P'. */
+function makePan(rand: () => number, surname: string): string {
+  const letter = () => String.fromCharCode(65 + Math.floor(rand() * 26));
+  const digits = `${1000 + Math.floor(rand() * 9000)}`;
+  return `${letter()}${letter()}${letter()}P${surname[0].toUpperCase()}${digits}${letter()}`;
+}
+
+let deducteeCache: TdsDeductee[] | null = null;
+
+/**
+ * The bank's deductees.
+ *
+ * The spread is deliberate so both reports have every case in them: customers
+ * comfortably under the trigger, customers sitting just below it, customers well
+ * over, senior citizens on the higher threshold, a few with no PAN on record
+ * (deducted at the 206AA rate), some joint deposits held as second holder, and
+ * some declarations that only came in mid-year.
+ */
+export function tdsDeductees(): TdsDeductee[] {
+  if (deducteeCache) {
+    return deducteeCache;
+  }
+  const rand = lcg(20260801);
+  const branches = GL_BRANCHES.filter((b) => b.code !== 'HO');
+  const out: TdsDeductee[] = [];
+
+  for (let i = 0; i < 64; i++) {
+    const branch = branches[i % branches.length];
+    const first = pick(rand, FIRST_NAMES);
+    const last = pick(rand, SURNAMES);
+    const clientId = 5000 + i;
+
+    // A third of the book is senior citizens, which is about right for a
+    // co-operative bank's deposit base.
+    const senior = rand() < 0.34;
+    const birthYear = senior ? 1948 + Math.floor(rand() * 15) : 1972 + Math.floor(rand() * 22);
+    const dob = `${birthYear}-${`${1 + Math.floor(rand() * 12)}`.padStart(2, '0')}-${`${1 + Math.floor(rand() * 28)}`.padStart(2, '0')}`;
+
+    // Every seventeenth customer has no PAN on record, so tax comes off at the
+    // higher section 206AA rate. Fixed by index rather than drawn at random, so
+    // the case is always present.
+    const hasPan = i % 17 !== 3;
+
+    // Aim each customer's annual time-deposit interest at a band, so the report
+    // has a proper spread either side of the trigger.
+    const draw = rand();
+    let annualInterest: number;
+    const limit = senior ? 100_000 : 50_000;
+    if (draw < 0.3) {
+      annualInterest = 4_000 + Math.floor(rand() * (limit - 10_000)); // comfortably under
+    } else if (draw < 0.45) {
+      annualInterest = limit - 6_000 + Math.floor(rand() * 6_000); // just below the threshold
+    } else if (draw < 0.8) {
+      annualInterest = limit + 2_000 + Math.floor(rand() * 40_000); // over
+    } else {
+      annualInterest = 110_000 + Math.floor(rand() * 320_000); // well over
+    }
+
+    // Push two of the no-PAN customers over the trigger. Left to chance they can
+    // all land under it, and then the 20% line of the return summary comes out
+    // empty — a report line that is never exercised is one nobody has checked.
+    if (!hasPan && (i === 3 || i === 37)) {
+      annualInterest = 70_000 + i * 400;
+    }
+
+    const accounts: TdsAccountInput[] = [];
+    const acctBase = 41_00_000 + i * 137;
+
+    // One or two time deposits, split across the year's quarter ends.
+    const depositCount = rand() < 0.4 ? 2 : 1;
+    for (let d = 0; d < depositCount; d++) {
+      const isRd = rand() < 0.3;
+      const share = depositCount === 1 ? 1 : d === 0 ? 0.6 : 0.4;
+      const credits: InterestCredit[] = [];
+
+      for (const fy of TDS_FYS) {
+        // The current year is only part-run, so later quarters have no postings.
+        const ends = quarterEnds(fy).filter((date) => date <= TDS_AS_AT);
+        if (!ends.length) {
+          continue;
+        }
+        // The prior year ran in full; scale the current year to what has posted.
+        const perQuarter = Math.round((annualInterest * share) / 4);
+        for (const date of ends) {
+          credits.push({ date, amount: perQuarter });
+        }
+      }
+
+      accounts.push({
+        accountNo: `${branch.code}${`${acctBase + d}`.padStart(8, '0')}`,
+        depositTypeCode: isRd ? 'depositAccountType.recurringDeposit' : 'depositAccountType.fixedDeposit',
+        accountStatus: 'SINGLE',
+        clientId,
+        interestPostingPeriodType: {
+          // A fifth of the book is on annual posting, so tax on those settles
+          // once at year end rather than quarterly.
+          code: rand() < 0.2 ? 'savingsPostingInterestPeriodType.annual' : 'savingsPostingInterestPeriodType.quarterly'
+        },
+        credits
+      });
+    }
+
+    // Most customers also hold a savings account. Its interest must never reach
+    // the deduction aggregate — that is the point of including it here.
+    if (rand() < 0.75) {
+      const sbCredits: InterestCredit[] = [];
+      for (const fy of TDS_FYS) {
+        for (const date of quarterEnds(fy).filter((x) => x <= TDS_AS_AT)) {
+          sbCredits.push({ date, amount: 900 + Math.floor(rand() * 2_600) });
+        }
+      }
+      accounts.push({
+        accountNo: `${branch.code}${`${acctBase + 50}`.padStart(8, '0')}`,
+        depositTypeCode: 'depositAccountType.savingsDeposit',
+        accountStatus: 'SINGLE',
+        clientId,
+        interestPostingPeriodType: { code: 'savingsPostingInterestPeriodType.quarterly' },
+        credits: sbCredits
+      });
+    }
+
+    // One in eight is the second holder on somebody else's deposit. Tax there is
+    // deducted against the first-named holder, so it must not land on this
+    // customer's aggregate.
+    if (rand() < 0.12) {
+      const jointCredits: InterestCredit[] = [];
+      for (const fy of TDS_FYS) {
+        for (const date of quarterEnds(fy).filter((x) => x <= TDS_AS_AT)) {
+          jointCredits.push({ date, amount: 16_000 });
+        }
+      }
+      accounts.push({
+        accountNo: `${branch.code}${`${acctBase + 70}`.padStart(8, '0')}`,
+        depositTypeCode: 'depositAccountType.fixedDeposit',
+        accountStatus: 'JOINT',
+        // Somebody else is first-named.
+        primaryClientId: clientId + 1,
+        clientId: clientId + 1,
+        jointHolders: [{ clientId }],
+        interestPostingPeriodType: { code: 'savingsPostingInterestPeriodType.quarterly' },
+        credits: jointCredits
+      });
+    }
+
+    // Declarations. Only worth filing where tax would otherwise be deducted, so
+    // they cluster on the customers over the trigger.
+    const declarations: Record<string, Declaration> = {};
+    if (annualInterest > (senior ? 100_000 : 50_000) && hasPan && rand() < 0.45) {
+      const kind: Form15Kind = senior ? '15H' : '15G';
+      for (const fy of TDS_FYS) {
+        const y = Number(fy.slice(0, 4));
+        // A quarter of them only came in mid-year, which leaves tax already
+        // deducted that the branch cannot reverse.
+        const midYear = rand() < 0.25;
+        declarations[fy] = {
+          kind,
+          acceptedOn: midYear ? `${y}-10-01` : `${y}-04-05`,
+          fy,
+          uin: `${branch.code}${kind}${`${i + 1}`.padStart(4, '0')}`
+        };
+      }
+    }
+
+    out.push({
+      clientId,
+      customerId: `CIF${`${clientId}`.padStart(8, '0')}`,
+      name: `${first} ${last}`,
+      pan: hasPan ? makePan(rand, last) : '',
+      dob,
+      branchCode: branch.code,
+      declarations,
+      accounts
+    });
+  }
+
+  deducteeCache = out;
+  return out;
+}
+
+/**
+ * Statutory date by which tax deducted in a given month must be deposited.
+ *
+ * The seventh of the following month, except for March, which runs to 30 April.
+ */
+export function depositDueDate(month: string): string {
+  const [
+    y,
+    m
+  ] = month.split('-').map(Number);
+  if (m === 3) {
+    return `${y}-04-30`;
+  }
+  const nextY = m === 12 ? y + 1 : y;
+  const nextM = m === 12 ? 1 : m + 1;
+  return `${nextY}-${`${nextM}`.padStart(2, '0')}-07`;
+}
+
+let challanCache: Record<string, TdsChallan[]> | null = null;
+
+/**
+ * The remittance schedule, derived from what the engine says was deducted.
+ *
+ * Deductions land at each quarter end, so there is one challan per quarter. The
+ * Q2 challan of the prior year is deliberately deposited a month and a bit late
+ * so the late-deposit interest column is exercised, and the current year's latest
+ * quarter is left pending, which is the ordinary state of a live book.
+ */
+export function tdsChallans(deductedByQuarter: Record<string, Record<number, number>>): Record<string, TdsChallan[]> {
+  if (challanCache) {
+    return challanCache;
+  }
+  const out: Record<string, TdsChallan[]> = {};
+
+  for (const fy of TDS_FYS) {
+    const y = Number(fy.slice(0, 4));
+    const months: Record<number, string> = {
+      1: `${y}-06`,
+      2: `${y}-09`,
+      3: `${y}-12`,
+      4: `${y + 1}-03`
+    };
+    const rows: TdsChallan[] = [];
+
+    for (const q of [
+      1,
+      2,
+      3,
+      4
+    ] as (1 | 2 | 3 | 4)[]) {
+      const amount = Math.round(deductedByQuarter[fy]?.[q] ?? 0);
+      if (amount <= 0) {
+        continue;
+      }
+      const month = months[q];
+      const dueDate = depositDueDate(month);
+      // Anything falling after the business date has not been deposited yet.
+      const pending = dueDate > TDS_AS_AT;
+      const late = fy === '2025-26' && q === 2;
+
+      rows.push({
+        fy,
+        quarter: q,
+        month,
+        amount,
+        dueDate,
+        depositedOn: pending ? null : late ? `${y}-11-14` : dueDate,
+        challanNo: pending ? null : `${y}${q}${`${amount % 10000}`.padStart(4, '0')}`,
+        bsrCode: pending ? null : '0510308'
+      });
+    }
+    out[fy] = rows;
+  }
+
+  challanCache = out;
+  return out;
+}

src/app/tds-reports/tds-reports.compute.spec.ts

@@ -0,0 +1,301 @@
+/**
+ * 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 { isTdsApplicable, tdsDeducteeOf } from '../letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+import { TDS_AS_AT, TDS_FYS, depositDueDate, tdsDeductees } from './tds-reports-data';
+import {
+  NEAR_THRESHOLD_BAND,
+  TdsReportFilter,
+  deductedByQuarter,
+  tds26qSummary,
+  tdsInterestRows,
+  tdsInterestRowsForFy,
+  tdsInterestSummary,
+  tdsRemittanceRows
+} from './tds-reports.compute';
+
+/** The complete year in the seed — the one a return would be filed for. */
+const CLOSED_FY = '2025-26';
+
+function filter(overrides: Partial<TdsReportFilter> = {}): TdsReportFilter {
+  return {
+    fy: CLOSED_FY,
+    branchCode: '',
+    quarter: 0,
+    band: '',
+    search: '',
+    crossedOnly: false,
+    nearThresholdOnly: false,
+    ...overrides
+  };
+}
+
+describe('the seed has every case the reports need to show', () => {
+  it('produces deductees on both sides of the threshold', () => {
+    const rows = tdsInterestRowsForFy(CLOSED_FY);
+    expect(rows.length).toBeGreaterThan(20);
+    expect(rows.some((r) => r.crossed)).toBe(true);
+    expect(rows.some((r) => !r.crossed)).toBe(true);
+    expect(rows.some((r) => r.nearThreshold)).toBe(true);
+    expect(rows.some((r) => r.band === 'GENERAL')).toBe(true);
+    expect(rows.some((r) => r.band === 'SENIOR')).toBe(true);
+    expect(rows.some((r) => !r.panOnRecord)).toBe(true);
+    expect(rows.some((r) => r.hasDeclaration)).toBe(true);
+  });
+
+  it('gives senior citizens the higher threshold', () => {
+    const rows = tdsInterestRowsForFy(CLOSED_FY);
+    for (const row of rows) {
+      expect(row.threshold).toBe(row.band === 'SENIOR' ? 100_000 : 50_000);
+    }
+  });
+
+  it('deducts at the higher rate wherever PAN is missing', () => {
+    for (const row of tdsInterestRowsForFy(CLOSED_FY)) {
+      expect(row.rateApplied).toBe(row.panOnRecord ? 0.1 : 0.2);
+    }
+  });
+});
+
+describe('the reports follow the Act that governed each year', () => {
+  it('shows 15G / 15H for FY 2025-26 and Form 121 for FY 2026-27', () => {
+    const old = tdsInterestRowsForFy('2025-26');
+    expect(old.some((r) => r.form === '15G')).toBe(true);
+    expect(old.some((r) => r.form === '15H')).toBe(true);
+    expect(old.some((r) => r.form === '121')).toBe(false);
+
+    // The two forms merged on 01 April 2026.
+    const current = tdsInterestRowsForFy('2026-27');
+    expect(current.every((r) => r.form === '121')).toBe(true);
+  });
+
+  it('keeps the age-based threshold band in both years', () => {
+    for (const fy of TDS_FYS) {
+      const rows = tdsInterestRowsForFy(fy);
+      expect(rows.some((r) => r.band === 'SENIOR')).toBe(true);
+      expect(rows.some((r) => r.band === 'GENERAL')).toBe(true);
+      for (const row of rows) {
+        expect(row.threshold).toBe(row.band === 'SENIOR' ? 100_000 : 50_000);
+      }
+    }
+  });
+});
+
+describe('savings interest stays out of the 194A aggregate', () => {
+  it('reports it separately and never inside the applicable interest', () => {
+    const rows = tdsInterestRowsForFy(CLOSED_FY);
+    const withSavings = rows.filter((r) => r.exemptInterest > 0);
+    expect(withSavings.length).toBeGreaterThan(0);
+
+    for (const row of withSavings) {
+      // The applicable figure must equal only the time-deposit interest where
+      // this customer is the deductee.
+      const expected = row.deductee.accounts
+        .filter((a) => isTdsApplicable(a) && tdsDeducteeOf(a) === row.deductee.clientId)
+        .flatMap((a) => a.credits)
+        .filter((c) => c.date >= '2025-04-01' && c.date <= '2026-03-31')
+        .reduce((s, c) => s + c.amount, 0);
+      expect(row.tdsApplicableInterest).toBe(expected);
+    }
+  });
+
+  it('leaves the savings totals out of the summary base', () => {
+    const s = tdsInterestSummary(filter());
+    expect(s.exemptInterest).toBeGreaterThan(0);
+    expect(s.applicableInterest).toBe(tdsInterestRows(filter()).reduce((acc, r) => acc + r.tdsApplicableInterest, 0));
+  });
+});
+
+describe('joint deposits are attributed to the first-named holder only', () => {
+  it('excludes second-holder interest from the aggregate and shows it apart', () => {
+    const rows = tdsInterestRowsForFy(CLOSED_FY);
+    const secondHolders = rows.filter((r) => r.jointHeldInterest > 0);
+    expect(secondHolders.length).toBeGreaterThan(0);
+
+    for (const row of secondHolders) {
+      const jointAccounts = row.deductee.accounts.filter(
+        (a) => isTdsApplicable(a) && tdsDeducteeOf(a) !== row.deductee.clientId
+      );
+      expect(jointAccounts.length).toBeGreaterThan(0);
+      // None of that interest may appear in the figure the threshold is tested
+      // against, or one deposit would be taxed against two people.
+      const jointTotal = jointAccounts
+        .flatMap((a) => a.credits)
+        .filter((c) => c.date >= '2025-04-01' && c.date <= '2026-03-31')
+        .reduce((s, c) => s + c.amount, 0);
+      expect(row.jointHeldInterest).toBe(jointTotal);
+      expect(row.tdsApplicableInterest).toBeLessThan(row.tdsApplicableInterest + jointTotal);
+    }
+  });
+});
+
+describe('quarter figures add up to the year', () => {
+  it('per row', () => {
+    for (const row of tdsInterestRowsForFy(CLOSED_FY)) {
+      const quarterInterest = row.quarters[1] + row.quarters[2] + row.quarters[3] + row.quarters[4];
+      expect(quarterInterest).toBe(row.tdsApplicableInterest);
+      expect(row.schedule.lines.reduce((s, l) => s + l.tds, 0)).toBe(row.schedule.totalTds);
+    }
+  });
+
+  it('and across the summary', () => {
+    const s = tdsInterestSummary(filter());
+    expect(s.byQuarter.reduce((acc, q) => acc + q.interest, 0)).toBe(s.applicableInterest);
+    expect(s.byQuarter.reduce((acc, q) => acc + q.tds, 0)).toBe(s.totalTds);
+  });
+});
+
+describe('filters', () => {
+  it("narrows to a branch without changing anyone's figures", () => {
+    const all = tdsInterestRows(filter());
+    const branch = all[0].branchCode;
+    const scoped = tdsInterestRows(filter({ branchCode: branch }));
+    expect(scoped.length).toBeGreaterThan(0);
+    expect(scoped.every((r) => r.branchCode === branch)).toBe(true);
+    // A branch view must not re-aggregate — the threshold is computed bank-wide.
+    const sample = scoped[0];
+    const sameRow = all.find((r) => r.deductee.customerId === sample.deductee.customerId);
+    expect(sample.tdsApplicableInterest).toBe(sameRow?.tdsApplicableInterest);
+  });
+
+  it('finds the customers worth chasing a declaration from', () => {
+    const near = tdsInterestRows(filter({ nearThresholdOnly: true }));
+    expect(near.length).toBeGreaterThan(0);
+    for (const row of near) {
+      expect(row.crossed).toBe(false);
+      expect(row.headroom).toBeGreaterThan(0);
+      expect(row.headroom).toBeLessThanOrEqual(NEAR_THRESHOLD_BAND);
+    }
+  });
+
+  it('narrows to customers who crossed', () => {
+    const crossed = tdsInterestRows(filter({ crossedOnly: true }));
+    expect(crossed.length).toBeGreaterThan(0);
+    expect(crossed.every((r) => r.crossed && r.tdsApplicableInterest > r.threshold)).toBe(true);
+  });
+
+  it('searches on name, CIF and PAN', () => {
+    const target = tdsInterestRowsForFy(CLOSED_FY).find((r) => r.panOnRecord)!;
+    expect(tdsInterestRows(filter({ search: target.deductee.customerId })).length).toBe(1);
+    expect(tdsInterestRows(filter({ search: target.deductee.pan })).length).toBeGreaterThanOrEqual(1);
+  });
+});
+
+describe('declarations', () => {
+  it('save tax and record the interest paid gross', () => {
+    const declared = tdsInterestRowsForFy(CLOSED_FY).filter((r) => r.hasDeclaration);
+    expect(declared.length).toBeGreaterThan(0);
+    expect(declared.some((r) => r.tdsSaved > 0)).toBe(true);
+    // Interest paid without deduction is a mandatory 26Q disclosure, so it must
+    // be carried even though no tax came off it.
+    expect(declared.some((r) => r.paidWithoutDeduction > 0)).toBe(true);
+    for (const row of declared) {
+      expect(row.declarationUin).toBeTruthy();
+    }
+  });
+
+  it('leaves tax deducted before a mid-year declaration in place', () => {
+    // Some declarations in the seed were accepted in October. Tax already taken
+    // in Q1/Q2 cannot be reversed, so those rows still carry a deduction.
+    const midYear = tdsInterestRowsForFy(CLOSED_FY).filter(
+      (r) => r.hasDeclaration && r.declarationAcceptedOn && r.declarationAcceptedOn.slice(5, 7) === '10'
+    );
+    expect(midYear.length).toBeGreaterThan(0);
+    expect(midYear.some((r) => r.schedule.totalTds > 0)).toBe(true);
+  });
+});
+
+describe('remittance schedule', () => {
+  it('deposits by the seventh of the following month, and 30 April for March', () => {
+    expect(depositDueDate('2025-06')).toBe('2025-07-07');
+    expect(depositDueDate('2025-12')).toBe('2026-01-07');
+    expect(depositDueDate('2026-03')).toBe('2026-04-30');
+  });
+
+  it('remits exactly what the engine says was deducted', () => {
+    const deducted = deductedByQuarter(CLOSED_FY);
+    const rows = tdsRemittanceRows(CLOSED_FY, TDS_AS_AT);
+    for (const row of rows) {
+      expect(row.amount).toBe(Math.round(deducted[row.quarter]));
+    }
+  });
+
+  it('charges section 201(1A) interest on a late deposit and nothing on a timely one', () => {
+    const rows = tdsRemittanceRows(CLOSED_FY, TDS_AS_AT);
+    const late = rows.filter((r) => r.late);
+    expect(late.length).toBeGreaterThan(0);
+    for (const row of late) {
+      expect(row.delayMonths).toBeGreaterThan(0);
+      expect(row.defaultInterest).toBe(Math.round(row.amount * 0.015 * row.delayMonths));
+    }
+    for (const row of rows.filter((r) => !r.late && !r.overdue)) {
+      expect(row.defaultInterest).toBe(0);
+    }
+  });
+});
+
+describe('the 26Q reconciliation control', () => {
+  it.each(TDS_FYS)('balances for FY %s', (fy) => {
+    const s = tds26qSummary(fy, TDS_AS_AT);
+    // Deducted must equal deposited plus what is still within its due date.
+    // Anything else means tax has gone missing between the ledger and the
+    // Government, and the return must not be filed until it is found.
+    expect(s.difference).toBe(0);
+    expect(s.totalDeducted).toBe(s.totalDeposited + s.pendingDeposit);
+  });
+
+  it('splits the tax between the standard and the no-PAN rate without loss', () => {
+    const s = tds26qSummary(CLOSED_FY, TDS_AS_AT);
+    expect(s.tdsAtStandardRate + s.tdsAtHigherRate).toBe(s.totalDeducted);
+    expect(s.tdsAtHigherRate).toBeGreaterThan(0);
+  });
+
+  it('splits interest into the deducted and the paid-gross halves', () => {
+    const s = tds26qSummary(CLOSED_FY, TDS_AS_AT);
+    expect(s.interestWithDeduction + s.interestWithoutDeduction).toBe(s.totalInterestPaid);
+    // The gross-paid half is the Form 121 disclosure and must not be zero here,
+    // or the report would never exercise that line.
+    expect(s.interestWithoutDeduction).toBeGreaterThan(0);
+  });
+
+  it('agrees with the interest report on the same year', () => {
+    const summary = tdsInterestSummary(filter());
+    expect(tds26qSummary(CLOSED_FY, TDS_AS_AT).totalDeducted).toBe(summary.totalTds);
+  });
+});
+
+describe('the part-run current year', () => {
+  it('has postings only up to the business date', () => {
+    for (const deductee of tdsDeductees()) {
+      for (const account of deductee.accounts) {
+        for (const credit of account.credits) {
+          expect(credit.date <= TDS_AS_AT).toBe(true);
+        }
+      }
+    }
+  });
+
+  it('shows the closed quarter as settled and future obligations as not yet due', () => {
+    const rows = tdsRemittanceRows('2026-27', TDS_AS_AT);
+
+    // Q1 (Apr–Jun) has closed, so its tax was deducted and is due by 07 Jul.
+    expect(rows.some((r) => r.quarter === 1)).toBe(true);
+
+    // Q3 cannot appear: no interest has posted there and nothing settles there.
+    expect(rows.some((r) => r.quarter === 3)).toBe(false);
+
+    // Q4 *can* appear even in a part-run year — deposits on annual interest
+    // posting settle once, at year end — but that is a future obligation, so it
+    // must read as pending and must never be flagged overdue.
+    for (const row of rows.filter((r) => r.quarter === 4)) {
+      expect(row.depositedOn).toBeNull();
+      expect(row.overdue).toBe(false);
+      expect(row.defaultInterest).toBe(0);
+    }
+  });
+});

src/app/tds-reports/tds-reports.compute.ts

@@ -0,0 +1,395 @@
+/**
+ * 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/.
+ */
+
+/**
+ * Aggregation for the two TDS reports.
+ *
+ * Every rupee figure here comes out of `tds-15gh.compute` — the reports do no
+ * tax arithmetic of their own. Writing it twice is how the register and the
+ * return end up disagreeing, so the engine is the single authority and this
+ * module only groups and totals what it returns.
+ */
+
+import {
+  DeclarationForm,
+  FY_TAX_CONFIG,
+  Quarter,
+  TdsMode,
+  TdsSchedule,
+  ageInFy,
+  buildSchedule,
+  collectTdsCredits,
+  declarationFormFor,
+  formKindFor,
+  fyOf,
+  isSeniorInFy,
+  isTdsApplicable,
+  isWellFormedPan,
+  lateDeductionInterest,
+  monthsOrPartBetween,
+  tdsDeducteeOf,
+  tdsModeFor
+} from '../letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+import { TdsChallan, TdsDeductee, tdsChallans, tdsDeductees } from './tds-reports-data';
+
+// ─────────────────────────────── Filtering ───────────────────────────────
+
+export interface TdsReportFilter {
+  fy: string;
+  /** '' means every branch. */
+  branchCode: string;
+  /** 0 means the whole year. */
+  quarter: 0 | Quarter;
+  /** '' means both declaration types. */
+  band: '' | 'GENERAL' | 'SENIOR';
+  /** Free text over name, CIF and PAN. */
+  search: string;
+  /** Only customers whose aggregate crossed the deduction trigger. */
+  crossedOnly: boolean;
+  /** Only customers sitting just below the trigger — the follow-up list. */
+  nearThresholdOnly: boolean;
+}
+
+/** How close to the trigger counts as "worth chasing a declaration for". */
+export const NEAR_THRESHOLD_BAND = 6_000;
+
+// ───────────────────────── Report 1: interest ─────────────────────────
+
+export interface TdsInterestRow {
+  deductee: TdsDeductee;
+  branchCode: string;
+  /** The form in force for the year — '121' from FY 2026-27. */
+  form: DeclarationForm;
+  /** Which deduction trigger applies. Age-based, even after the forms merged. */
+  band: 'GENERAL' | 'SENIOR';
+  /**
+   * The 15G/15H label. A form distinction only up to FY 2025-26; from FY 2026-27
+   * the two merged, so it duplicates `band` and is kept for pre-2026 years.
+   */
+  kind: '15G' | '15H';
+  age: number;
+  /** Settlement timing, from the customer's deposit products. */
+  mode: TdsMode;
+  /** Interest on time deposits where this customer is the deductee, by quarter. */
+  quarters: Record<Quarter, number>;
+  /** Total of the above — the figure the deduction trigger is tested against. */
+  tdsApplicableInterest: number;
+  /** Savings interest, shown alongside but outside the charge on time deposits. */
+  exemptInterest: number;
+  /** Interest on deposits where somebody else is the first-named holder. */
+  jointHeldInterest: number;
+  threshold: number;
+  crossed: boolean;
+  /** The quarter the aggregate crossed the trigger, if it did. */
+  crossedInQuarter: Quarter | null;
+  /** How much more interest before the trigger bites. */
+  headroom: number;
+  nearThreshold: boolean;
+  schedule: TdsSchedule;
+  hasDeclaration: boolean;
+  declarationUin: string | null;
+  declarationAcceptedOn: string | null;
+  /** Tax the declaration kept out of the customer's pocket. */
+  tdsSaved: number;
+  /** Interest paid gross on the strength of the declaration — reportable in the return. */
+  paidWithoutDeduction: number;
+  panOnRecord: boolean;
+  rateApplied: number;
+}
+
+function emptyQuarters(): Record<Quarter, number> {
+  return { 1: 0, 2: 0, 3: 0, 4: 0 };
+}
+
+/**
+ * One row per deductee for the selected year.
+ *
+ * Memoised on the year alone: building a row runs two schedules, and the getters
+ * that feed the template are read many times per change-detection pass.
+ */
+let rowCacheKey = '';
+let rowCache: TdsInterestRow[] = [];
+
+export function tdsInterestRowsForFy(fy: string): TdsInterestRow[] {
+  if (rowCacheKey === fy) {
+    return rowCache;
+  }
+
+  const rows: TdsInterestRow[] = [];
+
+  for (const deductee of tdsDeductees()) {
+    const ctx = {
+      fy,
+      dateOfBirth: deductee.dob,
+      pan: deductee.pan,
+      resident: true
+    };
+
+    // Rules 8 to 12 live in the engine: savings interest dropped, joint deposits
+    // attributed to the first-named holder, every branch aggregated.
+    const credits = collectTdsCredits(deductee.clientId, deductee.accounts, fy);
+    if (!credits.length && !deductee.accounts.length) {
+      continue;
+    }
+
+    const declaration = deductee.declarations[fy] ?? null;
+    const mode = overallModeFor(deductee);
+    const schedule = buildSchedule(mode, credits, { ...ctx, declaration });
+    const withoutDeclaration = declaration ? buildSchedule(mode, credits, { ...ctx, declaration: null }) : schedule;
+
+    const quarters = emptyQuarters();
+    for (const line of schedule.lines) {
+      quarters[line.quarter] = line.interest;
+    }
+
+    let exemptInterest = 0;
+    let jointHeldInterest = 0;
+    for (const account of deductee.accounts) {
+      const inYear = account.credits.filter((c) => fyOf(c.date) === fy).reduce((s, c) => s + c.amount, 0);
+      if (!isTdsApplicable(account)) {
+        exemptInterest += inYear;
+      } else if (tdsDeducteeOf(account) !== deductee.clientId) {
+        jointHeldInterest += inYear;
+      }
+    }
+
+    const crossedLine = schedule.lines.find((l) => l.thresholdCrossedHere);
+    const headroom = Math.max(0, schedule.threshold - schedule.totalInterest);
+
+    rows.push({
+      deductee,
+      branchCode: deductee.branchCode,
+      form: declarationFormFor(fy, deductee.dob),
+      band: isSeniorInFy(deductee.dob, fy) ? 'SENIOR' : 'GENERAL',
+      kind: formKindFor(deductee.dob, fy),
+      age: ageInFy(deductee.dob, fy),
+      mode,
+      quarters,
+      tdsApplicableInterest: schedule.totalInterest,
+      exemptInterest,
+      jointHeldInterest,
+      threshold: schedule.threshold,
+      crossed: schedule.totalInterest > schedule.threshold,
+      crossedInQuarter: crossedLine?.quarter ?? null,
+      headroom,
+      nearThreshold: headroom > 0 && headroom <= NEAR_THRESHOLD_BAND,
+      schedule,
+      hasDeclaration: !!declaration,
+      declarationUin: declaration?.uin ?? null,
+      declarationAcceptedOn: declaration?.acceptedOn ?? null,
+      tdsSaved: declaration ? Math.max(0, withoutDeclaration.totalTds - schedule.totalTds) : 0,
+      paidWithoutDeduction: schedule.shieldedInterest,
+      panOnRecord: isWellFormedPan(deductee.pan),
+      rateApplied: schedule.rateApplied
+    });
+  }
+
+  rows.sort((a, b) => b.tdsApplicableInterest - a.tdsApplicableInterest);
+  rowCacheKey = fy;
+  rowCache = rows;
+  return rows;
+}
+
+/**
+ * When tax settles for a customer whose deposits post interest on different
+ * cycles. A quarterly deposit anywhere means a deduction falls due at the first
+ * quarter end, so that governs.
+ */
+function overallModeFor(deductee: TdsDeductee): TdsMode {
+  const applicable = deductee.accounts.filter((a) => isTdsApplicable(a) && tdsDeducteeOf(a) === deductee.clientId);
+  return applicable.some((a) => tdsModeFor(a) === 'QUARTERLY') ? 'QUARTERLY' : 'ANNUAL';
+}
+
+export function tdsInterestRows(filter: TdsReportFilter): TdsInterestRow[] {
+  const needle = filter.search.trim().toLowerCase();
+  return tdsInterestRowsForFy(filter.fy).filter((row) => {
+    if (filter.branchCode && row.branchCode !== filter.branchCode) {
+      return false;
+    }
+    if (filter.band && row.band !== filter.band) {
+      return false;
+    }
+    if (filter.crossedOnly && !row.crossed) {
+      return false;
+    }
+    if (filter.nearThresholdOnly && !row.nearThreshold) {
+      return false;
+    }
+    // A quarter filter narrows to customers who actually had interest in it.
+    if (filter.quarter && !row.quarters[filter.quarter]) {
+      return false;
+    }
+    if (!needle) {
+      return true;
+    }
+    const d = row.deductee;
+    return (
+      d.name.toLowerCase().includes(needle) ||
+      d.customerId.toLowerCase().includes(needle) ||
+      d.pan.toLowerCase().includes(needle)
+    );
+  });
+}
+
+export interface TdsInterestSummary {
+  deductees: number;
+  /** Interest on time deposits — the base the charge applies to. */
+  applicableInterest: number;
+  /** Savings interest, outside the section. */
+  exemptInterest: number;
+  totalTds: number;
+  crossed: number;
+  nearThreshold: number;
+  declarations: number;
+  tdsSaved: number;
+  paidWithoutDeduction: number;
+  noPan: number;
+  byQuarter: { quarter: Quarter; interest: number; tds: number }[];
+}
+
+export function tdsInterestSummary(filter: TdsReportFilter): TdsInterestSummary {
+  const rows = tdsInterestRows(filter);
+  const byQuarter = ([
+      1,
+      2,
+      3,
+      4
+    ] as Quarter[]).map((quarter) => ({
+    quarter,
+    interest: rows.reduce((s, r) => s + r.quarters[quarter], 0),
+    tds: rows.reduce((s, r) => s + (r.schedule.lines.find((l) => l.quarter === quarter)?.tds ?? 0), 0)
+  }));
+
+  return {
+    deductees: rows.length,
+    applicableInterest: rows.reduce((s, r) => s + r.tdsApplicableInterest, 0),
+    exemptInterest: rows.reduce((s, r) => s + r.exemptInterest, 0),
+    totalTds: rows.reduce((s, r) => s + r.schedule.totalTds, 0),
+    crossed: rows.filter((r) => r.crossed).length,
+    nearThreshold: rows.filter((r) => r.nearThreshold).length,
+    declarations: rows.filter((r) => r.hasDeclaration).length,
+    tdsSaved: rows.reduce((s, r) => s + r.tdsSaved, 0),
+    paidWithoutDeduction: rows.reduce((s, r) => s + r.paidWithoutDeduction, 0),
+    noPan: rows.filter((r) => !r.panOnRecord).length,
+    byQuarter
+  };
+}
+
+// ─────────────────────── Report 2: remittance ───────────────────────
+
+export interface TdsRemittanceRow extends TdsChallan {
+  /** Statutory due date has passed with nothing deposited. */
+  overdue: boolean;
+  /** Deposited, but after the due date. */
+  late: boolean;
+  /** Months or part months of delay. */
+  delayMonths: number;
+  /** Interest charged for depositing late. */
+  defaultInterest: number;
+  /** Return the quarter's deduction is reported in. */
+  returnDueDate: string;
+}
+
+const RETURN_DUE: Record<Quarter, string> = {
+  1: '31 Jul',
+  2: '31 Oct',
+  3: '31 Jan',
+  4: '31 May'
+};
+
+/** Tax deducted per quarter, from the engine, for one year. */
+export function deductedByQuarter(fy: string): Record<number, number> {
+  const out: Record<number, number> = { 1: 0, 2: 0, 3: 0, 4: 0 };
+  for (const row of tdsInterestRowsForFy(fy)) {
+    for (const line of row.schedule.lines) {
+      out[line.quarter] += line.tds;
+    }
+  }
+  return out;
+}
+
+export function tdsRemittanceRows(fy: string, asAt: string): TdsRemittanceRow[] {
+  const deducted: Record<string, Record<number, number>> = {};
+  for (const year of Object.keys(FY_TAX_CONFIG)) {
+    deducted[year] = deductedByQuarter(year);
+  }
+  const challans = tdsChallans(deducted)[fy] ?? [];
+
+  return challans.map((c) => {
+    const overdue = !c.depositedOn && c.dueDate < asAt;
+    const late = !!c.depositedOn && c.depositedOn > c.dueDate;
+    // While a payment is overdue the clock runs to today; once paid it stops on
+    // the payment date.
+    const settledOn = c.depositedOn ?? asAt;
+    const delayMonths = late || overdue ? monthsOrPartBetween(c.dueDate, settledOn) : 0;
+    const defaultInterest =
+      late || overdue ? lateDeductionInterest(c.amount, c.dueDate, settledOn, 'DEPOSIT', fy).interest : 0;
+
+    return {
+      ...c,
+      overdue,
+      late,
+      delayMonths,
+      defaultInterest,
+      returnDueDate: RETURN_DUE[c.quarter]
+    };
+  });
+}
+
+/**
+ * The year-end position — what the quarterly TDS return has to reconcile to.
+ *
+ * `difference` is the control figure: tax the engine says was deducted, less what
+ * actually reached the Government. Anything other than zero, once the pending
+ * challans are settled, means something is wrong and must be found before filing.
+ */
+export interface Tds26qSummary {
+  fy: string;
+  deductees: number;
+  totalInterestPaid: number;
+  interestWithDeduction: number;
+  /** Paid gross against a declaration — a mandatory disclosure in the return. */
+  interestWithoutDeduction: number;
+  tdsAtStandardRate: number;
+  tdsAtHigherRate: number;
+  totalDeducted: number;
+  totalDeposited: number;
+  pendingDeposit: number;
+  /** Deducted less deposited less still-pending. Must be zero. */
+  difference: number;
+  defaultInterest: number;
+  lateChallans: number;
+  overdueChallans: number;
+}
+
+export function tds26qSummary(fy: string, asAt: string): Tds26qSummary {
+  const rows = tdsInterestRowsForFy(fy);
+  const challans = tdsRemittanceRows(fy, asAt);
+  const standard = rows.filter((r) => r.panOnRecord);
+  const higher = rows.filter((r) => !r.panOnRecord);
+  const totalDeducted = rows.reduce((s, r) => s + r.schedule.totalTds, 0);
+  const totalDeposited = challans.filter((c) => c.depositedOn).reduce((s, c) => s + c.amount, 0);
+  const pendingDeposit = challans.filter((c) => !c.depositedOn).reduce((s, c) => s + c.amount, 0);
+
+  return {
+    fy,
+    deductees: rows.length,
+    totalInterestPaid: rows.reduce((s, r) => s + r.tdsApplicableInterest, 0),
+    interestWithDeduction: rows.reduce((s, r) => s + r.schedule.liableInterest, 0),
+    interestWithoutDeduction: rows.reduce((s, r) => s + r.paidWithoutDeduction, 0),
+    tdsAtStandardRate: standard.reduce((s, r) => s + r.schedule.totalTds, 0),
+    tdsAtHigherRate: higher.reduce((s, r) => s + r.schedule.totalTds, 0),
+    totalDeducted,
+    totalDeposited,
+    pendingDeposit,
+    difference: Math.round(totalDeducted - totalDeposited - pendingDeposit),
+    defaultInterest: challans.reduce((s, c) => s + c.defaultInterest, 0),
+    lateChallans: challans.filter((c) => c.late).length,
+    overdueChallans: challans.filter((c) => c.overdue).length
+  };
+}

src/app/tds-reports/tds-reports.shared.scss

@@ -0,0 +1,546 @@
+/**
+ * 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/.
+ */
+
+/* Shared by the interest report and the remittance report. */
+
+.tdsr {
+  --tdsr-line: #e5e7eb;
+  --tdsr-bg: #f9fafb;
+  --tdsr-ink: #111827;
+  --tdsr-muted: #6b7280;
+  --tdsr-blue: #1d4ed8;
+  --tdsr-green: #15803d;
+  --tdsr-amber: #b45309;
+
+  padding: 20px 24px 40px;
+  font-size: 13px;
+  color: var(--tdsr-ink);
+}
+
+/* ── Header ── */
+.tdsr__head {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 16px;
+  align-items: flex-start;
+  justify-content: space-between;
+  margin-bottom: 18px;
+}
+
+.tdsr__head-l {
+  display: flex;
+  gap: 14px;
+  align-items: flex-start;
+}
+
+.tdsr__head-r {
+  display: flex;
+  gap: 12px;
+  align-items: flex-end;
+}
+
+.tdsr__head-ic {
+  font-size: 22px;
+  color: var(--tdsr-blue);
+  margin-top: 3px;
+}
+
+.tdsr__title {
+  margin: 0;
+  font-size: 19px;
+  font-weight: 800;
+}
+
+.tdsr__sub {
+  margin-top: 4px;
+  color: var(--tdsr-muted);
+  font-size: 12px;
+  line-height: 1.5;
+}
+
+.tdsr__btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 7px;
+  padding: 9px 15px;
+  border: 1px solid var(--tdsr-line);
+  border-radius: 7px;
+  background: #fff;
+  font-size: 12.5px;
+  font-weight: 700;
+  color: var(--tdsr-ink);
+  cursor: pointer;
+
+  &:hover:not(:disabled) {
+    background: var(--tdsr-bg);
+  }
+
+  &:disabled {
+    opacity: 0.55;
+    cursor: default;
+  }
+}
+
+/* ── Banners ── */
+.tdsr__banner {
+  display: flex;
+  gap: 11px;
+  align-items: flex-start;
+  margin-bottom: 14px;
+  padding: 13px 15px;
+  border-radius: 9px;
+  border-left: 4px solid var(--tdsr-blue);
+  background: color-mix(in srgb, var(--tdsr-blue) 6%, transparent);
+  line-height: 1.55;
+
+  fa-icon {
+    flex-shrink: 0;
+    margin-top: 1px;
+    color: var(--tdsr-blue);
+  }
+
+  &--ok {
+    border-left-color: var(--tdsr-green);
+    background: color-mix(in srgb, var(--tdsr-green) 7%, transparent);
+
+    fa-icon {
+      color: var(--tdsr-green);
+    }
+  }
+
+  &--warn {
+    border-left-color: var(--tdsr-amber);
+    background: color-mix(in srgb, var(--tdsr-amber) 9%, transparent);
+
+    fa-icon {
+      color: var(--tdsr-amber);
+    }
+  }
+}
+
+/* ── KPI strip ── */
+.tdsr__kpis {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(165px, 1fr));
+  gap: 10px;
+  margin-bottom: 16px;
+}
+
+.tdsr__kpi {
+  padding: 13px 15px;
+  border: 1px solid var(--tdsr-line);
+  border-left: 3px solid var(--tdsr-blue);
+  border-radius: 9px;
+  background: #fff;
+  text-align: left;
+
+  &--ok {
+    border-left-color: var(--tdsr-green);
+  }
+
+  &--warn {
+    border-left-color: var(--tdsr-amber);
+  }
+
+  &--muted {
+    border-left-color: var(--tdsr-line);
+  }
+
+  /* The near-threshold tile doubles as the button that filters to it. */
+  &--action {
+    border-left-color: var(--tdsr-green);
+    cursor: pointer;
+    font: inherit;
+    color: inherit;
+
+    &:hover {
+      background: var(--tdsr-bg);
+    }
+  }
+}
+
+.tdsr__kpi-n {
+  font-size: 20px;
+  font-weight: 800;
+  font-variant-numeric: tabular-nums;
+}
+
+.tdsr__kpi-l {
+  margin-top: 3px;
+  font-size: 11px;
+  color: var(--tdsr-muted);
+  line-height: 1.4;
+}
+
+/* ── Filters ── */
+.tdsr__filters {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 14px;
+  align-items: flex-end;
+  margin-bottom: 16px;
+  padding: 14px 16px;
+  border: 1px solid var(--tdsr-line);
+  border-radius: 9px;
+  background: #fff;
+}
+
+.tdsr__filter {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
+
+  > span {
+    font-size: 10.5px;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    color: var(--tdsr-muted);
+  }
+
+  select,
+  input {
+    min-width: 150px;
+    padding: 7px 10px;
+    border: 1px solid var(--tdsr-line);
+    border-radius: 6px;
+    background: #fff;
+    font-size: 13px;
+    color: inherit;
+  }
+
+  &--wide input {
+    min-width: 230px;
+  }
+}
+
+.tdsr__check {
+  display: inline-flex;
+  gap: 7px;
+  align-items: center;
+  padding-bottom: 8px;
+  font-size: 12.5px;
+  cursor: pointer;
+}
+
+.tdsr__clear {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin-bottom: 4px;
+  padding: 7px 12px;
+  border: 1px solid var(--tdsr-line);
+  border-radius: 6px;
+  background: var(--tdsr-bg);
+  font-size: 12px;
+  font-weight: 700;
+  color: var(--tdsr-muted);
+  cursor: pointer;
+}
+
+/* ── Cards ── */
+.tdsr__card {
+  margin-bottom: 18px;
+  border: 1px solid var(--tdsr-line);
+  border-radius: 10px;
+  background: #fff;
+  overflow: hidden;
+}
+
+.tdsr__card-head {
+  display: flex;
+  align-items: center;
+  gap: 9px;
+  padding: 12px 16px;
+  background: var(--tdsr-bg);
+  border-bottom: 1px solid var(--tdsr-line);
+  font-weight: 800;
+  font-size: 12.5px;
+
+  fa-icon {
+    color: var(--tdsr-muted);
+  }
+}
+
+.tdsr__foot {
+  padding: 11px 16px;
+  border-top: 1px solid var(--tdsr-line);
+  background: var(--tdsr-bg);
+  color: var(--tdsr-muted);
+  font-size: 11.5px;
+  line-height: 1.55;
+}
+
+.tdsr__empty {
+  padding: 26px 16px;
+  text-align: center;
+  color: var(--tdsr-muted);
+
+  fa-icon {
+    margin-right: 6px;
+    color: var(--tdsr-blue);
+  }
+}
+
+/* ── Quarter strip ── */
+.tdsr__qstrip {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+}
+
+.tdsr__qcell {
+  padding: 14px 16px;
+  border-right: 1px solid var(--tdsr-line);
+
+  &:last-child {
+    border-right: 0;
+  }
+}
+
+.tdsr__qcell-l {
+  font-size: 10.5px;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--tdsr-muted);
+}
+
+.tdsr__qcell-n {
+  margin-top: 4px;
+  font-size: 17px;
+  font-weight: 800;
+  font-variant-numeric: tabular-nums;
+}
+
+.tdsr__qcell-s {
+  margin-top: 2px;
+  font-size: 11.5px;
+  color: var(--tdsr-muted);
+}
+
+/* ── Tables ── */
+.tdsr__table-wrap {
+  overflow-x: auto;
+}
+
+.tdsr__table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12.5px;
+
+  th {
+    text-align: left;
+    padding: 11px 14px;
+    background: #fff;
+    border-bottom: 1px solid var(--tdsr-line);
+    color: var(--tdsr-muted);
+    font-weight: 700;
+    font-size: 10.5px;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    white-space: nowrap;
+  }
+
+  td {
+    padding: 11px 14px;
+    border-bottom: 1px solid #f3f4f6;
+    vertical-align: top;
+  }
+
+  tr:last-child td {
+    border-bottom: 0;
+  }
+
+  .num {
+    text-align: right;
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+  }
+
+  .mono {
+    font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  }
+
+  .small {
+    font-size: 11.5px;
+  }
+
+  .muted {
+    color: var(--tdsr-muted);
+  }
+
+  .col-actions {
+    width: 44px;
+    text-align: right;
+  }
+
+  &--inner {
+    border: 1px solid var(--tdsr-line);
+    border-radius: 8px;
+    overflow: hidden;
+    margin-bottom: 10px;
+  }
+}
+
+.tdsr__row--warn > td {
+  background: color-mix(in srgb, var(--tdsr-amber) 7%, transparent);
+}
+
+.tdsr__row--near > td {
+  background: color-mix(in srgb, var(--tdsr-green) 5%, transparent);
+}
+
+.tdsr__row--detail > td {
+  background: var(--tdsr-bg);
+  padding: 16px;
+}
+
+.tdsr__name {
+  font-weight: 700;
+}
+
+.tdsr__ok {
+  color: var(--tdsr-green);
+}
+
+.tdsr__warn-text {
+  color: var(--tdsr-amber);
+}
+
+.tdsr__icon-btn {
+  padding: 5px 8px;
+  border: 1px solid var(--tdsr-line);
+  border-radius: 6px;
+  background: #fff;
+  color: var(--tdsr-muted);
+  cursor: pointer;
+
+  &:hover {
+    background: var(--tdsr-bg);
+  }
+}
+
+.tdsr__note {
+  display: flex;
+  gap: 9px;
+  align-items: flex-start;
+  margin-bottom: 11px;
+  padding: 10px 12px;
+  border-radius: 8px;
+  border-left: 3px solid var(--tdsr-blue);
+  background: color-mix(in srgb, var(--tdsr-blue) 6%, transparent);
+  font-size: 12px;
+  line-height: 1.5;
+
+  fa-icon {
+    flex-shrink: 0;
+    margin-top: 2px;
+    color: var(--tdsr-blue);
+  }
+}
+
+.tdsr__meta {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 18px;
+  font-size: 11.5px;
+  color: var(--tdsr-muted);
+}
+
+/* ── Ledger (Part B of the remittance report) ── */
+.tdsr__ledger-row {
+  display: flex;
+  justify-content: space-between;
+  gap: 20px;
+  padding: 11px 16px;
+  border-bottom: 1px solid #f3f4f6;
+  line-height: 1.5;
+
+  &:last-child {
+    border-bottom: 0;
+  }
+
+  .num {
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+    font-weight: 600;
+  }
+
+  em {
+    display: block;
+    font-size: 10.5px;
+    color: var(--tdsr-amber);
+    font-style: normal;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.03em;
+  }
+
+  &--indent {
+    padding-left: 36px;
+    color: var(--tdsr-muted);
+  }
+
+  &--sep {
+    border-top: 1px solid var(--tdsr-line);
+  }
+
+  &--total {
+    border-top: 1px solid var(--tdsr-line);
+    background: var(--tdsr-bg);
+    font-weight: 800;
+  }
+
+  /* The reconciliation control. Green when zero, red when not. */
+  &--control {
+    background: color-mix(in srgb, var(--tdsr-green) 8%, transparent);
+    font-weight: 800;
+    color: var(--tdsr-green);
+  }
+
+  &--bad {
+    background: color-mix(in srgb, var(--tdsr-amber) 10%, transparent);
+    color: var(--tdsr-amber);
+  }
+}
+
+/* ── Pills ── */
+.tdsr__pill {
+  display: inline-flex;
+  align-items: center;
+  padding: 2px 9px;
+  border-radius: 999px;
+  border: 1px solid var(--tdsr-line);
+  background: var(--tdsr-bg);
+  color: var(--tdsr-muted);
+  font-size: 10.5px;
+  font-weight: 700;
+  white-space: nowrap;
+
+  & + & {
+    margin-left: 5px;
+  }
+
+  &--ok {
+    border-color: color-mix(in srgb, var(--tdsr-green) 35%, transparent);
+    background: color-mix(in srgb, var(--tdsr-green) 10%, transparent);
+    color: var(--tdsr-green);
+  }
+
+  &--warn {
+    border-color: color-mix(in srgb, var(--tdsr-amber) 35%, transparent);
+    background: color-mix(in srgb, var(--tdsr-amber) 12%, transparent);
+    color: var(--tdsr-amber);
+  }
+
+  &--near {
+    border-color: color-mix(in srgb, var(--tdsr-blue) 30%, transparent);
+    background: color-mix(in srgb, var(--tdsr-blue) 8%, transparent);
+    color: var(--tdsr-blue);
+  }
+}

src/app/tds-reports/tds-statutory.compute.ts

@@ -0,0 +1,466 @@
+/**
+ * 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/.
+ */
+
+/**
+ * The three things the bank actually has to file or hand over.
+ *
+ *   1. The consolidated statement of declarations received — monthly from
+ *      FY 2026-27, due on the 7th of the following month, carrying the UIN the
+ *      branch allotted to each Form 121.
+ *   2. The deductee annexure of the quarterly return (Form 140), which needs the
+ *      UIN against every payee paid gross so the department can tie a
+ *      nil-deduction back to a declaration.
+ *   3. The certificate issued to each deductee (Form 131), which is what the
+ *      customer uses to claim credit in their own return.
+ *
+ * All figures come from the TDS engine. Nothing here recomputes tax — a return
+ * that disagrees with the register is worse than no return at all.
+ */
+
+import {
+  FY_TAX_CONFIG,
+  Quarter,
+  buildUin,
+  declarationStatementDueDate,
+  isWellFormedPan,
+  normaliseFy,
+  quarterEnd,
+  quarterOf
+} from '../letter-mgmt/certificates/form-15gh/tds-15gh.compute';
+import { TDS_AS_AT } from './tds-reports-data';
+import { TdsInterestRow, tdsInterestRowsForFy } from './tds-reports.compute';
+
+/** The bank's own deductor particulars, which head every filing. */
+export interface DeductorParticulars {
+  tan: string;
+  pan: string;
+  name: string;
+  branchAddress: string;
+  responsiblePerson: string;
+  designation: string;
+}
+
+/**
+ * Placeholder particulars for the demo book. In a live install these come from
+ * the organisation's tax registration, not from a constant.
+ */
+export const DEDUCTOR: DeductorParticulars = {
+  tan: 'MUMC12345E',
+  pan: 'AAACC1234C',
+  name: 'CBS Nexora Co-operative Bank Ltd.',
+  branchAddress: 'Head Office, Mumbai 400001',
+  responsiblePerson: 'Chief Financial Officer',
+  designation: 'Principal Officer'
+};
+
+// ───────────────── 1. Consolidated statement of declarations ─────────────────
+
+export interface DeclarationStatementLine {
+  /** Running number within the statement. */
+  serial: number;
+  uin: string;
+  payeeName: string;
+  pan: string;
+  customerId: string;
+  branchCode: string;
+  /** Date the branch accepted the declaration. */
+  acceptedOn: string;
+  /**
+   * Income the declaration covers, as estimated when it was accepted. The
+   * statement reports the amount the payer expects to pay gross.
+   */
+  estimatedIncome: number;
+  /** Interest actually paid without deduction so far. */
+  paidWithoutDeduction: number;
+  /** Whether the declaration would survive scrutiny on the branch's own record. */
+  eligible: boolean;
+}
+
+export interface DeclarationStatementPeriod {
+  /** 'MONTHLY' periods are keyed '2026-04'; quarterly ones 'Q1'. */
+  key: string;
+  label: string;
+  /** Statutory upload deadline for this period. */
+  dueDate: string;
+  overdue: boolean;
+  lines: DeclarationStatementLine[];
+  totalPaidWithoutDeduction: number;
+}
+
+export interface DeclarationStatement {
+  fy: string;
+  form: string;
+  rule: string;
+  frequency: 'MONTHLY' | 'QUARTERLY';
+  periods: DeclarationStatementPeriod[];
+  totalDeclarations: number;
+  /** Declarations on record that the branch could not lawfully have accepted. */
+  ineligibleCount: number;
+  /** Declarations with no UIN allotted — these cannot be filed at all. */
+  missingUinCount: number;
+}
+
+function monthLabel(key: string): string {
+  const months = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec'
+  ];
+  return `${months[Number(key.slice(5, 7)) - 1]} ${key.slice(0, 4)}`;
+}
+
+/**
+ * Groups every declaration on record for the year into the periods the payer has
+ * to upload, and flags the ones that are already past their due date.
+ *
+ * A declaration with no UIN is counted separately rather than filed with a blank:
+ * the portal rejects the line, and a silently dropped row is how a bank ends up
+ * reporting fewer declarations than it holds.
+ */
+export function declarationStatement(fy: string, asAt: string = TDS_AS_AT): DeclarationStatement {
+  const year = normaliseFy(fy);
+  const cfg = FY_TAX_CONFIG[year];
+  if (!cfg) {
+    throw new Error(`No tax configuration for FY ${year}`);
+  }
+
+  const declared = tdsInterestRowsForFy(year).filter((r) => r.hasDeclaration && r.declarationAcceptedOn);
+  const buckets = new Map<string, DeclarationStatementLine[]>();
+  let serial = 0;
+  let ineligibleCount = 0;
+  let missingUinCount = 0;
+
+  for (const row of declared) {
+    const acceptedOn = row.declarationAcceptedOn as string;
+    const key =
+      cfg.declarationStatementFrequency === 'MONTHLY' ? acceptedOn.slice(0, 7) : `Q${quarterOf(acceptedOn)}`;
+
+    if (!row.declarationUin) {
+      missingUinCount++;
+    }
+    // The branch cannot compute income earned elsewhere, so eligibility here is
+    // only what the register can see: a valid PAN on an individual.
+    const eligible = isWellFormedPan(row.deductee.pan);
+    if (!eligible) {
+      ineligibleCount++;
+    }
+
+    const line: DeclarationStatementLine = {
+      serial: ++serial,
+      uin: row.declarationUin ?? '',
+      payeeName: row.deductee.name,
+      pan: row.deductee.pan,
+      customerId: row.deductee.customerId,
+      branchCode: row.branchCode,
+      acceptedOn,
+      estimatedIncome: row.tdsApplicableInterest,
+      paidWithoutDeduction: row.paidWithoutDeduction,
+      eligible
+    };
+
+    const list = buckets.get(key);
+    if (list) {
+      list.push(line);
+    } else {
+      buckets.set(key, [line]);
+    }
+  }
+
+  const periods: DeclarationStatementPeriod[] = [...buckets.entries()]
+    .sort((a, b) => a[0].localeCompare(b[0]))
+    .map(([
+      key,
+      lines
+    ]) => {
+      const dueDate = declarationStatementDueDate(lines[0].acceptedOn, year);
+      return {
+        key,
+        label: cfg.declarationStatementFrequency === 'MONTHLY' ? monthLabel(`${key}-01`) : key,
+        dueDate,
+        overdue: dueDate < asAt,
+        lines,
+        totalPaidWithoutDeduction: lines.reduce((s, l) => s + l.paidWithoutDeduction, 0)
+      };
+    });
+
+  return {
+    fy: year,
+    form: cfg.declarationForm === '121' ? 'Form 121' : 'Form 15G / 15H',
+    rule: cfg.declarationRule,
+    frequency: cfg.declarationStatementFrequency,
+    periods,
+    totalDeclarations: declared.length,
+    ineligibleCount,
+    missingUinCount
+  };
+}
+
+/**
+ * Allots UINs to declarations that do not have one.
+ *
+ * Sequence numbers continue from the highest already in use for the year, so a
+ * re-run does not renumber declarations that have already been filed.
+ */
+export function allotMissingUins(rows: TdsInterestRow[], fy: string, tan: string = DEDUCTOR.tan): Map<string, string> {
+  const out = new Map<string, string>();
+  let next = rows.reduce((max, r) => {
+    const seq = r.declarationUin ? Number(r.declarationUin.slice(1, 10)) : 0;
+    return Number.isFinite(seq) && seq > max ? seq : max;
+  }, 0);
+
+  for (const row of rows) {
+    if (row.hasDeclaration && !row.declarationUin) {
+      out.set(row.deductee.customerId, buildUin(++next, fy, tan));
+    }
+  }
+  return out;
+}
+
+// ──────────────────── 2. Deductee annexure of the return ────────────────────
+
+/** One deductee line in the quarterly return's annexure. */
+export interface ReturnAnnexureLine {
+  serial: number;
+  payeeName: string;
+  pan: string;
+  /** 'Individual' or 'HUF', from the fourth character of the PAN. */
+  payeeType: string;
+  /** Amount paid or credited in the quarter. */
+  amountPaid: number;
+  /** Tax deducted in the quarter. */
+  taxDeducted: number;
+  rate: number;
+  /**
+   * Reason the payer deducted nothing or less than the standard rate.
+   * Blank where tax was deducted normally.
+   */
+  remark: string;
+  /** UIN of the declaration, required wherever the remark cites one. */
+  uin: string;
+  branchCode: string;
+}
+
+export interface ReturnAnnexure {
+  fy: string;
+  quarter: Quarter;
+  form: string;
+  rule: string;
+  section: string;
+  /** Last day of the quarter the return covers. */
+  periodEnd: string;
+  dueDate: string;
+  lines: ReturnAnnexureLine[];
+  totalPaid: number;
+  totalDeducted: number;
+  /** Lines carrying a nil-deduction remark — these need a UIN. */
+  nilDeductionLines: number;
+  /** Nil-deduction lines with no UIN. The portal will reject these. */
+  missingUinLines: number;
+}
+
+const RETURN_DUE_DATE: Record<Quarter, (startYear: number) => string> = {
+  1: (y) => `${y}-07-31`,
+  2: (y) => `${y}-10-31`,
+  3: (y) => `${y + 1}-01-31`,
+  4: (y) => `${y + 1}-05-31`
+};
+
+/**
+ * Remark codes for a nil or lower deduction.
+ *
+ * The department's file specification assigns a letter per reason. The letters
+ * have been revised more than once, so they live here as named constants and
+ * must be checked against the current specification before a file is generated —
+ * a wrong code fails validation at upload, or worse, passes and misreports.
+ */
+export const NIL_DEDUCTION_REMARK = {
+  /** Payee filed a declaration for receipt without deduction. */
+  DECLARATION: 'B',
+  /** Aggregate stayed within the threshold, so nothing was deductible. */
+  BELOW_THRESHOLD: 'Y',
+  /** Higher rate applied because PAN was not furnished. */
+  NO_PAN: 'C'
+};
+
+function payeeTypeOf(pan: string): string {
+  const p = (pan || '').toUpperCase();
+  if (!isWellFormedPan(p)) {
+    return 'Unknown';
+  }
+  return p[3] === 'H' ? 'HUF' : p[3] === 'P' ? 'Individual' : 'Entity';
+}
+
+/**
+ * The deductee annexure for one quarter.
+ *
+ * Every payee who was paid interest in the quarter appears, whether or not tax
+ * came off — a payee paid gross against a declaration is precisely what the
+ * department cross-checks, so omitting them is the error to avoid.
+ */
+export function returnAnnexure(fy: string, quarter: Quarter): ReturnAnnexure {
+  const year = normaliseFy(fy);
+  const cfg = FY_TAX_CONFIG[year];
+  if (!cfg) {
+    throw new Error(`No tax configuration for FY ${year}`);
+  }
+  const startYear = Number(year.slice(0, 4));
+  const lines: ReturnAnnexureLine[] = [];
+  let serial = 0;
+
+  for (const row of tdsInterestRowsForFy(year)) {
+    const line = row.schedule.lines.find((l) => l.quarter === quarter);
+    const amountPaid = line?.interest ?? 0;
+    const taxDeducted = line?.tds ?? 0;
+    if (amountPaid === 0 && taxDeducted === 0) {
+      continue;
+    }
+
+    // The remark explains why the deduction is not simply rate × amount.
+    let remark = '';
+    if (taxDeducted <= 0 && amountPaid > 0) {
+      if (row.hasDeclaration && line?.declarationActive) {
+        remark = NIL_DEDUCTION_REMARK.DECLARATION;
+      } else if (!row.crossed) {
+        remark = NIL_DEDUCTION_REMARK.BELOW_THRESHOLD;
+      }
+    } else if (taxDeducted > 0 && !row.panOnRecord) {
+      remark = NIL_DEDUCTION_REMARK.NO_PAN;
+    }
+
+    lines.push({
+      serial: ++serial,
+      payeeName: row.deductee.name,
+      pan: row.deductee.pan,
+      payeeType: payeeTypeOf(row.deductee.pan),
+      amountPaid,
+      taxDeducted,
+      rate: row.rateApplied,
+      remark,
+      uin: row.declarationUin ?? '',
+      branchCode: row.branchCode
+    });
+  }
+
+  const nilDeduction = lines.filter((l) => l.remark === NIL_DEDUCTION_REMARK.DECLARATION);
+
+  return {
+    fy: year,
+    quarter,
+    form: cfg.tdsStatementForm,
+    rule: cfg.tdsStatementRule,
+    section: cfg.interestTdsSection,
+    periodEnd: quarterEnd(quarter, year),
+    dueDate: RETURN_DUE_DATE[quarter](startYear),
+    lines,
+    totalPaid: lines.reduce((s, l) => s + l.amountPaid, 0),
+    totalDeducted: lines.reduce((s, l) => s + l.taxDeducted, 0),
+    nilDeductionLines: nilDeduction.length,
+    missingUinLines: nilDeduction.filter((l) => !l.uin).length
+  };
+}
+
+// ───────────────────── 3. Certificate for the deductee ─────────────────────
+
+export interface TdsCertificateQuarterLine {
+  quarter: Quarter;
+  label: string;
+  amountPaid: number;
+  taxDeducted: number;
+  /** Tax the bank has actually remitted for this quarter. */
+  taxDeposited: number;
+}
+
+export interface TdsCertificate {
+  fy: string;
+  form: string;
+  section: string;
+  /** Certificate number, unique per deductee per year. */
+  certificateNo: string;
+  deductor: DeductorParticulars;
+  payeeName: string;
+  pan: string;
+  customerId: string;
+  branchCode: string;
+  lines: TdsCertificateQuarterLine[];
+  totalPaid: number;
+  totalDeducted: number;
+  /** Interest paid gross against a declaration, disclosed on the certificate. */
+  paidWithoutDeduction: number;
+  declarationUin: string | null;
+  rate: number;
+  /** A certificate cannot be issued without a valid PAN to issue it against. */
+  issuable: boolean;
+  blockingReason: string | null;
+}
+
+/**
+ * The TDS certificate for one deductee.
+ *
+ * Quarterly deposits are taken as equal to the quarter's deduction: the branch
+ * remits what it deducts, and the remittance report is where any gap between the
+ * two is surfaced. Wiring the certificate to actual challans is the right next
+ * step once challan records come from the backend rather than the seed.
+ */
+export function tdsCertificate(row: TdsInterestRow, fy: string): TdsCertificate {
+  const year = normaliseFy(fy);
+  const cfg = FY_TAX_CONFIG[year];
+  if (!cfg) {
+    throw new Error(`No tax configuration for FY ${year}`);
+  }
+
+  const lines: TdsCertificateQuarterLine[] = row.schedule.lines.map((l) => ({
+    quarter: l.quarter,
+    label: l.label,
+    amountPaid: l.interest,
+    taxDeducted: l.tds,
+    taxDeposited: Math.max(0, l.tds)
+  }));
+
+  const issuable = isWellFormedPan(row.deductee.pan);
+  return {
+    fy: year,
+    form: cfg.certificateForm,
+    section: cfg.interestTdsSection,
+    certificateNo: `${DEDUCTOR.tan}/${uinSafe(year)}/${row.deductee.customerId}`,
+    deductor: DEDUCTOR,
+    payeeName: row.deductee.name,
+    pan: row.deductee.pan,
+    customerId: row.deductee.customerId,
+    branchCode: row.branchCode,
+    lines,
+    totalPaid: row.tdsApplicableInterest,
+    totalDeducted: row.schedule.totalTds,
+    paidWithoutDeduction: row.paidWithoutDeduction,
+    declarationUin: row.declarationUin,
+    rate: row.rateApplied,
+    issuable,
+    blockingReason: issuable
+      ? null
+      : `No valid PAN on record. A certificate cannot be issued without one — the deductee would be unable to claim credit.`
+  };
+}
+
+function uinSafe(fy: string): string {
+  return normaliseFy(fy).replace('-', '');
+}
+
+/** Certificates for every deductee who had tax deducted in the year. */
+export function tdsCertificates(fy: string): TdsCertificate[] {
+  return tdsInterestRowsForFy(normaliseFy(fy))
+    .filter((r) => r.schedule.totalTds > 0 || r.paidWithoutDeduction > 0)
+    .map((r) => tdsCertificate(r, fy));
+}

src/environments/.env.ts

@@ -9,8 +9,8 @@
 /* tslint:disable */
 export default {
   'mifos_x': {
-    'version': '260803',
-    'hash': 'b43ed877'
+    'version': '260806',
+    'hash': 'ddb215de'
   },
   'allow_switching_backend_instance': true
 };