feat: add nominee, auto-debit, charges UI for SB/CA/FD/RD accounts; enforce required fields

- SB/CA/FD/RD Currency Step: add Nomination Facility toggle with multi-nominee form
  (NomineeFormComponent), auto-debit facility toggle, dormancy alert panel
- SB/CA/FD/RD Preview Step: display nominees list, auto-debit status, dormancy info
- FD/RD create component: validate Deposit Tenure, Monthly Installment (RD), and
  Customer Segment are filled before submit; show clear alert messages on missing fields
- FD account details step: remove duplicate Currency section (already shown in
  Currency & Account Status Configuration step)
- CA/SB create component: handle duplicate externalId API error with user-friendly alert
  instead of raw error display

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

src/app/current-accounts/create-current-account/create-current-account.component.html

@@ -98,7 +98,7 @@
           [currentAccountTermsForm]="currentAccountTermsForm"
           [currentAccount]="currentAccount"
           [currentAccountDigital]="currentAccountDigital"
-          [currentAccountNominee]="currentAccountNominee"
+          [currentAccountNominees]="currentAccountCurrencyStep?.nominees ?? []"
           [currentAccountCurrencyFlags]="currentAccountCurrencyFlags"
           (submitEvent)="submit()"
         >

src/app/current-accounts/create-current-account/create-current-account.component.ts

@@ -118,10 +118,6 @@ export class CreateCurrentAccountComponent {
     return this.currentAccountDigitalStep?.currentAccountDigital ?? null;
   }
 
-  get currentAccountNominee() {
-    return this.currentAccountCurrencyStep?.liveNomineeData ?? null;
-  }
-
   get currentAccountCurrencyFlags() {
     return {
       balanceSwapOption: this.currentAccountCurrencyStep?.balanceSwapOption ?? false,
@@ -142,6 +138,23 @@ export class CreateCurrentAccountComponent {
       });
       return;
     }
+    if (
+      this.currentAccountProductTemplate?.nominationFacility &&
+      (this.currentAccountCurrencyStep?.nominees ?? []).length === 0
+    ) {
+      this.alertService.alert({
+        type: 'Error',
+        message: 'Nomination Facility is enabled for this product. Please add at least one nominee before submitting.'
+      });
+      return;
+    }
+    if (this.currentAccountProductTemplate?.introducerRequired && !this.currentAccountDetailsStep.introducerId) {
+      this.alertService.alert({
+        type: 'Error',
+        message: 'Introducer is required for this product. Please select an introducer before submitting.'
+      });
+      return;
+    }
     const locale = this.settingsService.language.code;
     const dateFormat = this.settingsService.dateFormat;
     const monthDayFormat = 'dd MMMM';
@@ -185,27 +198,45 @@ export class CreateCurrentAccountComponent {
       currentAccount.groupId = this.currentAccountTemplate.groupId;
     }
 
-    const nominee = this.currentAccountNominee;
-    if (nominee) {
-      currentAccount.nominee = {
-        nomineeClientId: nominee.nomineeClientId,
-        nominationType: nominee.nominationType,
-        relationshipId: nominee.relationshipId,
-        percentageShare: nominee.percentageShare,
-        nomineeIsMinor: nominee.nomineeIsMinor,
-        ...(nominee.guardianClientId ? { guardianClientId: nominee.guardianClientId } : {}),
-        remarks: nominee.remarks
-      };
+    const nominees = this.currentAccountCurrencyStep?.nominees ?? [];
+    if (nominees.length > 0) {
+      currentAccount.nominees = nominees.map((n: any) => ({
+        nomineeClientId: n.nomineeClientId,
+        nominationType: n.nominationType,
+        relationshipId: n.relationshipId,
+        percentageShare: n.percentageShare,
+        nomineeIsMinor: n.nomineeIsMinor,
+        ...(n.guardianClientId ? { guardianClientId: n.guardianClientId } : {}),
+        remarks: n.remarks
+      }));
     }
 
-    this.currentAccountsService.createCurrentAccount(currentAccount).subscribe((response: any) => {
-      this.router.navigate(
-        [
-          '../',
-          response.resourceId
-        ],
-        { relativeTo: this.route }
-      );
+    this.currentAccountsService.createCurrentAccount(currentAccount).subscribe({
+      next: (response: any) => {
+        this.router.navigate(
+          [
+            '../',
+            response.resourceId
+          ],
+          { relativeTo: this.route }
+        );
+      },
+      error: (error: any) => {
+        const errorCode =
+          error?.error?.errors?.[0]?.userMessageGlobalisationCode ?? error?.error?.userMessageGlobalisationCode;
+        if (errorCode === 'error.msg.savings.account.duplicate.product.for.client') {
+          this.alertService.alert({
+            type: 'Error',
+            message:
+              'This client already has an active Current account with the selected product. Please choose a different product.'
+          });
+        } else if (errorCode === 'error.msg.savings.account.duplicate.externalid') {
+          this.alertService.alert({
+            type: 'Error',
+            message: 'An account with this External ID already exists. Please use a unique External ID.'
+          });
+        }
+      }
     });
   }
 }

src/app/current-accounts/current-account-stepper/current-account-currency-step/current-account-currency-step.component.html

@@ -73,11 +73,63 @@
       </span>
     </div>
     @if (currentAccountProductTemplate?.nominationFacility) {
-      <mifosx-nominee-form
-        [primaryClientId]="primaryClientId"
-        [showActions]="false"
-        (nomineeChange)="onNomineeChange($event)"
-      ></mifosx-nominee-form>
+      <div class="nom-section">
+        <div class="nom-header">
+          <div class="nom-header__left"><i class="fas fa-user-friends"></i><span>Nominees</span></div>
+          <span class="nom-share-badge" [class.nom-share-badge--full]="totalShare === 100"
+            >{{ totalShare }}% / 100%</span
+          >
+        </div>
+        @if (nominees.length > 0) {
+          <div class="nom-list">
+            @for (nom of nominees; track nom.nomineeClientId; let i = $index) {
+              <div class="nom-item">
+                <div class="nom-item__info">
+                  <span class="nom-item__name">{{ nom.nomineeDisplayName }}</span>
+                  <span class="nom-item__meta">{{ nom.relationshipName }} &bull; {{ nom.percentageShare }}% share</span>
+                  @if (nom.nomineeIsMinor) {
+                    <span class="nom-item__minor">Minor — Guardian: {{ nom.guardianDisplayName }}</span>
+                  }
+                </div>
+                <button type="button" class="nom-remove-btn" (click)="removeNominee(i)">
+                  <i class="fas fa-times"></i>
+                </button>
+              </div>
+            }
+          </div>
+        }
+        @if (canAddMore && !showNomineeForm) {
+          <button type="button" class="nom-add-btn" (click)="showNomineeForm = true">
+            <i class="fas fa-plus"></i> Add Nominee
+            @if (nominees.length > 0) {
+              <span class="nom-add-btn__hint">({{ remainingShare }}% remaining)</span>
+            }
+          </button>
+        }
+        @if (totalShare === 100) {
+          <div class="nom-complete"><i class="fas fa-check-circle"></i> Nominee allocation complete (100%)</div>
+        }
+        @if (showNomineeForm) {
+          <div class="nom-form-wrap">
+            @if (nomineeError) {
+              <div class="nom-error"><i class="fas fa-exclamation-triangle"></i> {{ nomineeError }}</div>
+            }
+            <mifosx-nominee-form
+              [primaryClientId]="primaryClientId"
+              [showActions]="false"
+              (nomineeChange)="onNomineeChange($event)"
+            ></mifosx-nominee-form>
+            <div class="nom-form-actions">
+              <button type="button" class="nom-cancel-btn" (click)="showNomineeForm = false; nomineeError = ''">
+                Cancel
+              </button>
+              <button type="button" class="nom-confirm-btn" (click)="addNominee()">
+                <i class="fas fa-plus"></i> Add
+              </button>
+            </div>
+          </div>
+        }
+      </div>
     }
   </div>
 </div>

src/app/current-accounts/current-account-stepper/current-account-currency-step/current-account-currency-step.component.scss

@@ -128,3 +128,215 @@ $gray-900: #202124;
     color: #0369a1;
   }
 }
+
+/* ── Nominees ── */
+.nom-section {
+  margin-top: 16px;
+  border: 1px solid #e2e8f0;
+  border-radius: 10px;
+  overflow: hidden;
+}
+
+.nom-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 16px;
+  background: #f8fafc;
+  border-bottom: 1px solid #e2e8f0;
+
+  &__left {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    font-size: 13px;
+    font-weight: 700;
+    color: #334155;
+
+    i {
+      color: #1d4ed8;
+      font-size: 12px;
+    }
+  }
+}
+
+.nom-share-badge {
+  font-size: 11px;
+  font-weight: 700;
+  padding: 3px 10px;
+  border-radius: 999px;
+  background: #e0e7ff;
+  color: #3730a3;
+  border: 1px solid #c7d2fe;
+
+  &--full {
+    background: #dcfce7;
+    color: #15803d;
+    border-color: #bbf7d0;
+  }
+}
+
+.nom-list {
+  display: flex;
+  flex-direction: column;
+}
+
+.nom-item {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 10px 16px;
+  border-bottom: 1px dashed #e2e8f0;
+
+  &__info {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  &__name {
+    font-size: 13px;
+    font-weight: 600;
+    color: #0f172a;
+  }
+
+  &__meta {
+    font-size: 11px;
+    color: #64748b;
+  }
+
+  &__minor {
+    font-size: 11px;
+    color: #b45309;
+  }
+}
+
+.nom-remove-btn {
+  width: 28px;
+  height: 28px;
+  border-radius: 50%;
+  border: 1px solid #fecaca;
+  background: #fee2e2;
+  color: #b91c1c;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 11px;
+  flex-shrink: 0;
+  transition: background 0.15s;
+
+  &:hover {
+    background: #fecaca;
+  }
+}
+
+.nom-add-btn {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  padding: 10px 16px;
+  background: #fff;
+  border: none;
+  border-top: 1px dashed #e2e8f0;
+  color: #1d4ed8;
+  font-size: 13px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: background 0.15s;
+
+  i {
+    font-size: 11px;
+  }
+
+  &__hint {
+    font-size: 11px;
+    color: #64748b;
+    margin-left: 4px;
+  }
+
+  &:hover {
+    background: #eff6ff;
+  }
+}
+
+.nom-complete {
+  padding: 10px 16px;
+  font-size: 12px;
+  font-weight: 600;
+  color: #15803d;
+  background: #f0fdf4;
+  border-top: 1px solid #bbf7d0;
+
+  i {
+    margin-right: 6px;
+  }
+}
+
+.nom-form-wrap {
+  padding: 16px;
+  background: #f8fafc;
+  border-top: 1px solid #e2e8f0;
+}
+
+.nom-error {
+  padding: 8px 12px;
+  margin-bottom: 12px;
+  background: #fee2e2;
+  border: 1px solid #fecaca;
+  border-radius: 6px;
+  color: #b91c1c;
+  font-size: 12px;
+  font-weight: 600;
+
+  i {
+    margin-right: 6px;
+  }
+}
+
+.nom-form-actions {
+  display: flex;
+  gap: 10px;
+  justify-content: flex-end;
+  margin-top: 14px;
+}
+
+.nom-cancel-btn {
+  padding: 7px 18px;
+  border-radius: 7px;
+  border: 1px solid #e2e8f0;
+  background: #fff;
+  color: #64748b;
+  font-size: 13px;
+  font-weight: 600;
+  cursor: pointer;
+  font-family: inherit;
+
+  &:hover {
+    background: #f1f5f9;
+  }
+}
+
+.nom-confirm-btn {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 7px 18px;
+  border-radius: 7px;
+  border: none;
+  background: #1d4ed8;
+  color: #fff;
+  font-size: 13px;
+  font-weight: 600;
+  cursor: pointer;
+  font-family: inherit;
+
+  i {
+    font-size: 11px;
+  }
+
+  &:hover {
+    background: #1e40af;
+  }
+}

src/app/current-accounts/current-account-stepper/current-account-currency-step/current-account-currency-step.component.ts

@@ -30,7 +30,10 @@ export class CurrentAccountCurrencyStepComponent implements OnChanges {
   @Input() primaryClientId: number | null = null;
   @ViewChild(NomineeFormComponent) nomineeFormComp: NomineeFormComponent;
 
-  nomineeData: any = null;
+  nominees: any[] = [];
+  pendingNominee: any = null;
+  showNomineeForm = false;
+  nomineeError = '';
 
   // Editable feature toggles (pre-filled from product, overridable by user)
   balanceSwapOption = false;
@@ -46,21 +49,53 @@ export class CurrentAccountCurrencyStepComponent implements OnChanges {
     }
   }
 
+  get totalShare(): number {
+    return this.nominees.reduce((sum, n) => sum + (+n.percentageShare || 0), 0);
+  }
+
+  get remainingShare(): number {
+    return 100 - this.totalShare;
+  }
+
+  get canAddMore(): boolean {
+    return this.totalShare < 100;
+  }
+
   onNomineeChange(event: any): void {
-    this.nomineeData = event;
+    this.pendingNominee = event;
+    this.nomineeError = '';
   }
 
-  get liveNomineeData(): any {
-    return this.nomineeFormComp?.currentNomineeData ?? this.nomineeData;
+  addNominee(): void {
+    const data = this.nomineeFormComp?.currentNomineeData ?? this.pendingNominee;
+    if (!data?.nomineeClientId) {
+      this.nomineeError = 'Please select a nominee before adding.';
+      return;
+    }
+    if (this.nominees.some((n) => n.nomineeClientId === data.nomineeClientId)) {
+      this.nomineeError = 'This person is already added as a nominee.';
+      return;
+    }
+    const newTotal = this.totalShare + (+data.percentageShare || 0);
+    if (newTotal > 100) {
+      this.nomineeError = `Total share cannot exceed 100%. Remaining: ${this.remainingShare}%`;
+      return;
+    }
+    this.nominees.push({ ...data });
+    this.pendingNominee = null;
+    this.showNomineeForm = false;
+    this.nomineeError = '';
+  }
+
+  removeNominee(index: number): void {
+    this.nominees.splice(index, 1);
   }
 
-  /** Called by parent to collect currency step values */
   get currencyStepData() {
     return {
       balanceSwapOption: this.balanceSwapOption,
       msme: this.msme,
-      autoDebitFacility: this.autoDebitFacility,
-      ...(this.nomineeData ? { nominee: this.nomineeData } : {})
+      autoDebitFacility: this.autoDebitFacility
     };
   }
 }

src/app/current-accounts/current-account-stepper/current-account-preview-step/current-account-preview-step.component.html

@@ -565,78 +565,53 @@
   }
 
   <!-- ══ 6. Nominee Details (if filled) ═══════════════════════════ -->
-  @if (currentAccountNominee) {
+  @if (currentAccountNominees?.length > 0) {
     <div class="preview-section">
       <div class="preview-section__header">
         <i class="fas fa-user-shield preview-section__icon"></i>
         <span class="preview-section__title">Nominee Details</span>
-        <span class="preview-section__badge">{{ currentAccountNominee?.nominationType || 'DA1' }}</span>
+        <span class="preview-section__badge">{{ currentAccountNominees.length }} Nominee(s)</span>
       </div>
       <div class="preview-body">
-        <div class="preview-grid preview-grid--three">
-          <div class="preview-field">
-            <span class="preview-label">Name</span>
-            <span class="preview-value">{{ currentAccountNominee?.nomineeDisplayName || '—' }}</span>
+        @for (nom of currentAccountNominees; track nom.nomineeClientId; let i = $index) {
+          @if (i > 0) {
+            <hr class="preview-nom-divider" />
+          }
+          <div class="preview-grid preview-grid--three">
+            <div class="preview-field">
+              <span class="preview-label">Name</span>
+              <span class="preview-value">{{ nom.nomineeDisplayName || '—' }}</span>
+            </div>
+            <div class="preview-field">
+              <span class="preview-label">Client ID</span>
+              <span class="preview-value preview-mono">{{ nom.nomineeClientId || '—' }}</span>
+            </div>
+            <div class="preview-field">
+              <span class="preview-label">Relationship</span>
+              <span class="preview-value">{{ nom.relationshipName || '—' }}</span>
+            </div>
+            <div class="preview-field">
+              <span class="preview-label">Share %</span>
+              <span class="preview-value">{{ nom.percentageShare ?? '—' }}%</span>
+            </div>
+            <div class="preview-field">
+              <span class="preview-label">Minor</span>
+              <span class="preview-value">{{ nom.nomineeIsMinor ? 'Yes' : 'No' }}</span>
+            </div>
+            @if (nom.guardianDisplayName) {
+              <div class="preview-field">
+                <span class="preview-label">Guardian</span>
+                <span class="preview-value">{{ nom.guardianDisplayName }}</span>
+              </div>
+            }
+            @if (nom.remarks) {
+              <div class="preview-field">
+                <span class="preview-label">Remarks</span>
+                <span class="preview-value">{{ nom.remarks }}</span>
+              </div>
+            }
           </div>
-          <div class="preview-field">
-            <span class="preview-label">Client ID</span>
-            <span class="preview-value preview-mono">{{ currentAccountNominee?.nomineeClientId || '—' }}</span>
-          </div>
-          <div class="preview-field">
-            <span class="preview-label">Relationship</span>
-            <span class="preview-value">{{ currentAccountNominee?.relationshipName || '—' }}</span>
-          </div>
-          <div class="preview-field">
-            <span class="preview-label">Share %</span>
-            <span class="preview-value">{{ currentAccountNominee?.percentageShare ?? '—' }}%</span>
-          </div>
-          <div class="preview-field">
-            <span class="preview-label">Minor</span>
-            <span class="preview-value">{{ currentAccountNominee?.nomineeIsMinor ? 'Yes' : 'No' }}</span>
-          </div>
-          @if (currentAccountNominee?.nomineeDateOfBirth) {
-            <div class="preview-field">
-              <span class="preview-label">Date of Birth</span>
-              <span class="preview-value">{{ currentAccountNominee?.nomineeDateOfBirth | dateFormat }}</span>
-            </div>
-          }
-          @if (currentAccountNominee?.nomineeMobileNo) {
-            <div class="preview-field">
-              <span class="preview-label">Mobile No</span>
-              <span class="preview-value preview-mono">{{ currentAccountNominee?.nomineeMobileNo }}</span>
-            </div>
-          }
-          @if (currentAccountNominee?.nomineeAadhaar) {
-            <div class="preview-field">
-              <span class="preview-label">Aadhaar</span>
-              <span class="preview-value preview-mono">{{ currentAccountNominee?.nomineeAadhaar }}</span>
-            </div>
-          }
-          @if (currentAccountNominee?.nomineePan) {
-            <div class="preview-field">
-              <span class="preview-label">PAN</span>
-              <span class="preview-value preview-mono">{{ currentAccountNominee?.nomineePan }}</span>
-            </div>
-          }
-          @if (currentAccountNominee?.guardianDisplayName) {
-            <div class="preview-field">
-              <span class="preview-label">Guardian</span>
-              <span class="preview-value">{{ currentAccountNominee?.guardianDisplayName }}</span>
-            </div>
-          }
-          @if (currentAccountNominee?.guardianClientId) {
-            <div class="preview-field">
-              <span class="preview-label">Guardian Client ID</span>
-              <span class="preview-value preview-mono">{{ currentAccountNominee?.guardianClientId }}</span>
-            </div>
-          }
-          @if (currentAccountNominee?.remarks) {
-            <div class="preview-field">
-              <span class="preview-label">Remarks</span>
-              <span class="preview-value">{{ currentAccountNominee?.remarks }}</span>
-            </div>
-          }
-        </div>
+        }
       </div>
     </div>
   }

src/app/current-accounts/current-account-stepper/current-account-preview-step/current-account-preview-step.component.ts

@@ -90,7 +90,7 @@ export class CurrentAccountPreviewStepComponent implements OnChanges {
   @Input() currentAccountSettingsForm: any;
   @Input() currentAccount: any;
   @Input() currentAccountDigital: any;
-  @Input() currentAccountNominee: any;
+  @Input() currentAccountNominees: any[] = [];
   @Input() currentAccountCurrencyFlags: any;
   @Input() activeClientMembers?: any;