feat(shares): dynamic Share Reports module, voucher attach/GL sync fixes

- Add the full Share Reports surface (final balance, account statement,
  issued/status/nominal/share-wise/guarantor/member-interest reports, enquiry,
  payment certificate, share detail, dividend statement, folio statement,
  distinctive numbers, area-wise, mailing labels/letters, share transfer) as
  standalone routed components, wired into the Share menu
- Wire the unattributed Share Collection receipt list into Apply Collection
  and Apply Additional Shares, with an Attach action independent of
  account/client
- Sync the GL Account and Voucher No fields to whichever receipt is ticked or
  found, and surface the receipt's real Dr/Cr GL entries in its detail popup
- Block Apply Additional Shares until the account's original application is
  settled

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

src/app/shares/reports/share-area-wise/share-area-wise.component.ts

@@ -0,0 +1,188 @@
+/**
+ * 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 } from '@angular/router';
+import { FaIconComponent } from '@fortawesome/angular-fontawesome';
+import { of } from 'rxjs';
+import { catchError } from 'rxjs/operators';
+
+import { SharesService } from '../../shares.service';
+import { shareReportCsv, shareReportPrint } from '../share-report.util';
+
+interface AreaRow {
+  area: string;
+  memberCount: number;
+  shares: number;
+  shareValue: number;
+}
+
+interface AreaMemberRow {
+  clientId: number;
+  cifNumber: string;
+  clientName: string;
+  mobileNo: string;
+  officeName: string;
+  area: string;
+  postalCode: string;
+  sharesHeld: number;
+  shareValue: number;
+}
+
+/**
+ * Area Wise — where the society's members and its share capital actually sit.
+ *
+ * <p>
+ * A co-operative's area of operation is part of its licence, so "how much of our capital comes from
+ * which area" is a question both the board and the Registrar ask. Grouped on the member's own
+ * recorded address rather than the branch that serves them: the two answer different questions, and
+ * a licence is written against the address.
+ *
+ * <p>
+ * Members with no address are their own group rather than dropped — an unaddressable member is a gap
+ * in the register worth seeing.
+ */
+@Component({
+  selector: 'mifosx-share-area-wise',
+  templateUrl: './share-area-wise.component.html',
+  styleUrls: [
+    '../../../letter-mgmt/certificates/certificates.shared.scss',
+    '../share-report.shared.scss'
+  ],
+  imports: [
+    CommonModule,
+    FormsModule,
+    FaIconComponent
+  ]
+})
+export class ShareAreaWiseComponent implements OnInit {
+  private sharesService = inject(SharesService);
+  private router = inject(Router);
+
+  loading = true;
+  loadError = '';
+  areas: AreaRow[] = [];
+  members: AreaMemberRow[] = [];
+  totals: any = null;
+
+  search = '';
+  /** Set by clicking an area row; '' means every area. */
+  areaFilter = '';
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  load(): void {
+    this.loading = true;
+    this.loadError = '';
+    this.sharesService
+      .getShareAreaWise({})
+      .pipe(
+        catchError((err) => {
+          this.loadError = this.readError(err, 'The area-wise report could not be loaded.');
+          return of(null);
+        })
+      )
+      .subscribe((res: any) => {
+        this.areas = res?.areas || [];
+        this.members = res?.members || [];
+        this.totals = res?.totals || null;
+        this.loading = false;
+      });
+  }
+
+  get filteredMembers(): AreaMemberRow[] {
+    const term = this.search.trim().toLowerCase();
+    return this.members.filter((m) => {
+      if (this.areaFilter && m.area !== this.areaFilter) {
+        return false;
+      }
+      if (!term) {
+        return true;
+      }
+      return [
+        m.clientName,
+        m.cifNumber,
+        m.area,
+        m.postalCode
+      ]
+        .filter(Boolean)
+        .some((field) => String(field).toLowerCase().includes(term));
+    });
+  }
+
+  /** An area's share of the society's capital — the reading this report exists for. */
+  capitalShare(row: AreaRow): number {
+    const total = Number(this.totals?.shareValue || 0);
+    return total ? (Number(row.shareValue || 0) * 100) / total : 0;
+  }
+
+  barWidth(row: AreaRow): number {
+    const largest = Math.max(...this.areas.map((a) => Number(a.shareValue || 0)), 1);
+    return (Number(row.shareValue || 0) * 100) / largest;
+  }
+
+  selectArea(area: string): void {
+    this.areaFilter = this.areaFilter === area ? '' : area;
+  }
+
+  openMember(row: AreaMemberRow): void {
+    this.router.navigate([
+      '/clients',
+      row.clientId,
+      'general'
+    ]);
+  }
+
+  clearFilters(): void {
+    this.search = '';
+    this.areaFilter = '';
+  }
+
+  exportCsv(): void {
+    shareReportCsv(
+      'share-area-wise',
+      [
+        'Area',
+        'Member',
+        'Membership No',
+        'Mobile',
+        'Branch',
+        'Postal Code',
+        'Shares Held',
+        'Share Value'
+      ],
+      this.filteredMembers.map((m) => [
+        m.area,
+        m.clientName,
+        m.cifNumber,
+        m.mobileNo,
+        m.officeName,
+        m.postalCode,
+        m.sharesHeld,
+        m.shareValue
+      ])
+    );
+  }
+
+  print(): void {
+    shareReportPrint();
+  }
+
+  private readError(err: any, fallback: string): string {
+    return (
+      err?.error?.errors?.[0]?.defaultUserMessage ||
+      err?.error?.defaultUserMessage ||
+      err?.error?.developerMessage ||
+      fallback
+    );
+  }
+}