feat: MFA/2FA, OTP audit logs, KYC + client/user enhancements

- Access Control module: SMS/Email/TOTP/Hardware-token MFA factor management
- OTP Audit Logs module under Admin menu (list + detail) with 401/403 handling
- Two-factor authentication login flow updates
- Client KYC, India address, family-members, ckyc, nominee enhancements
- New shared KYC helpers (kyc-proof-types, kyc-upload-helper.service)
- User create/edit/view enhancements
- Shell navigation: OTP Audit Logs entry under real Admin menu
This commit is contained in:
Aditya
2026-05-10 13:24:48 +05:30
parent 2d4fb4237e
commit 3b752dc6ae
56 changed files with 7741 additions and 599 deletions
@@ -77,6 +77,74 @@
}
</div>
<!-- KYC Verification Status (Aadhaar + PAN) -->
<div class="kyc-status-card" [class.kyc-status-card--complete]="kycComplete">
<div class="kyc-status-card__head">
<div class="kyc-status-card__title">
<fa-icon [icon]="kycComplete ? 'shield-alt' : 'user-shield'" class="kyc-status-card__icon"></fa-icon>
<span>KYC Verification</span>
</div>
@if (kycComplete) {
<span class="kyc-status-card__badge kyc-status-card__badge--ok">
<fa-icon icon="check-circle"></fa-icon>
KYC Done
</span>
} @else if (panVerified || aadhaarVerified) {
<span class="kyc-status-card__badge kyc-status-card__badge--partial">
<fa-icon icon="clock"></fa-icon>
Partially Verified
</span>
} @else {
<span class="kyc-status-card__badge kyc-status-card__badge--pending">
<fa-icon icon="exclamation-circle"></fa-icon>
Not Verified
</span>
}
</div>
<div class="kyc-status-card__body">
<div class="kyc-status-row">
<div class="kyc-status-row__label">
<fa-icon icon="id-card"></fa-icon>
<span>PAN</span>
</div>
@if (panVerified) {
<div class="kyc-status-row__value">
<span class="kyc-status-row__id">{{ panNumber || '—' }}</span>
@if (panHolderName) {
<span class="kyc-status-row__name">{{ panHolderName }}</span>
}
</div>
<span class="kyc-pill kyc-pill--ok"><fa-icon icon="check-circle"></fa-icon> Verified</span>
} @else {
<span class="kyc-status-row__value kyc-status-row__value--missing">{{ panNumber || 'Not provided' }}</span>
<span class="kyc-pill kyc-pill--pending"><fa-icon icon="times-circle"></fa-icon> Pending</span>
}
</div>
<div class="kyc-status-row">
<div class="kyc-status-row__label">
<fa-icon icon="fingerprint"></fa-icon>
<span>Aadhaar</span>
</div>
@if (aadhaarVerified) {
<div class="kyc-status-row__value">
<span class="kyc-status-row__id">{{ aadhaarMasked || '—' }}</span>
@if (aadhaarHolderName) {
<span class="kyc-status-row__name">{{ aadhaarHolderName }}</span>
}
</div>
<span class="kyc-pill kyc-pill--ok"><fa-icon icon="check-circle"></fa-icon> Verified</span>
} @else {
<span class="kyc-status-row__value kyc-status-row__value--missing">{{
aadhaarMasked || 'Not provided'
}}</span>
<span class="kyc-pill kyc-pill--pending"><fa-icon icon="times-circle"></fa-icon> Pending</span>
}
</div>
</div>
</div>
<!-- Client basic info -->
<div class="ckyc-info-grid">
<div class="ckyc-info-item">
@@ -214,6 +214,179 @@
}
}
/* ===================== KYC Verification status ===================== */
.kyc-status-card {
border: 1px solid #e2e8f0;
border-radius: 14px;
background: #fff;
margin-bottom: 18px;
overflow: hidden;
box-shadow: 0 1px 3px rgb(15 23 42 / 4%);
&--complete {
border-color: #bbf7d0;
background: linear-gradient(180deg, #f0fdf4 0%, #fff 60%);
}
&__head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
padding: 14px 18px;
border-bottom: 1px solid #eef2f7;
}
&__title {
display: flex;
align-items: center;
gap: 10px;
font-size: 14px;
font-weight: 700;
color: #0f172a;
}
&__icon {
color: #2563eb;
font-size: 16px;
}
&--complete &__icon {
color: #16a34a;
}
&__badge {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 5px 12px;
border-radius: 20px;
font-size: 11px;
font-weight: 700;
letter-spacing: 0.4px;
text-transform: uppercase;
fa-icon {
font-size: 11px;
}
&--ok {
background: #dcfce7;
color: #166534;
border: 1px solid #bbf7d0;
}
&--partial {
background: #fef3c7;
color: #92400e;
border: 1px solid #fde68a;
}
&--pending {
background: #fee2e2;
color: #991b1b;
border: 1px solid #fecaca;
}
}
&__body {
padding: 6px 18px 14px;
}
}
.kyc-status-row {
display: grid;
grid-template-columns: 140px 1fr auto;
align-items: center;
gap: 14px;
padding: 10px 0;
border-bottom: 1px dashed #eef2f7;
&:last-child {
border-bottom: none;
}
&__label {
display: flex;
align-items: center;
gap: 8px;
font-size: 13px;
font-weight: 600;
color: #475569;
fa-icon {
color: #64748b;
font-size: 13px;
}
}
&__value {
display: flex;
flex-direction: column;
gap: 2px;
min-width: 0;
&--missing {
color: #94a3b8;
font-style: italic;
font-size: 13px;
}
}
&__id {
font-family: 'SF Mono', 'Cascadia Code', Consolas, monospace;
font-size: 13px;
font-weight: 600;
color: #0f172a;
word-break: break-all;
}
&__name {
font-size: 12px;
color: #64748b;
}
}
.kyc-pill {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 4px 10px;
border-radius: 20px;
font-size: 11px;
font-weight: 700;
letter-spacing: 0.3px;
white-space: nowrap;
fa-icon {
font-size: 11px;
}
&--ok {
background: #dcfce7;
color: #166534;
border: 1px solid #bbf7d0;
}
&--pending {
background: #f1f5f9;
color: #64748b;
border: 1px solid #e2e8f0;
}
}
@media (width <= 640px) {
.kyc-status-row {
grid-template-columns: 110px 1fr;
grid-template-rows: auto auto;
.kyc-pill {
grid-column: 2 / 3;
justify-self: start;
}
}
}
/* ===================== Client info grid ===================== */
.ckyc-info-grid {
display: grid;
@@ -67,6 +67,18 @@ export class CkycTabComponent implements OnInit, OnDestroy {
ckycBatchId = '';
checkingExisting = false;
/** KYC verification status (Aadhaar + PAN) — independent of CERSAI sync */
panVerified = false;
aadhaarVerified = false;
panHolderName = '';
aadhaarHolderName = '';
panNumber = '';
aadhaarMasked = '';
get kycComplete(): boolean {
return this.panVerified && this.aadhaarVerified;
}
/** Pre-existing artefacts detected from client data */
existing: Record<'ADDRESS_PROOF' | 'PHOTO_PROOF' | 'CLIENT_IMAGE' | 'CLIENT_SIGNATURE', ExistingArtefact> = {
ADDRESS_PROOF: { present: false },
@@ -170,6 +182,13 @@ export class CkycTabComponent implements OnInit, OnDestroy {
this.ckycNumber = data?.ckycNumber || '';
this.ckycUploadedOn = this.formatJavaDate(data?.ckycUploadedOn);
this.ckycBatchId = data?.ckycBatchId || '';
this.panVerified = data?.panVerified === true || data?.panVerified === 'true' || data?.panVerified === 1;
this.aadhaarVerified =
data?.aadhaarVerified === true || data?.aadhaarVerified === 'true' || data?.aadhaarVerified === 1;
this.panHolderName = data?.panFullName || data?.panHolderName || '';
this.aadhaarHolderName = data?.aadhaarHolderName || '';
this.panNumber = data?.panNumber || '';
this.aadhaarMasked = data?.aadhaarNumberMasked || '';
});
}
@@ -21,138 +21,10 @@ import { FileUploadComponent } from '../../../../shared/file-upload/file-upload.
import { MatIconButton } from '@angular/material/button';
import { STANDALONE_SHARED_IMPORTS } from 'app/standalone-shared.module';
import { ClientsService } from '../../../clients.service';
interface ProofType {
id: string | number;
name: string;
code?: string;
sides?: number;
category?: string;
documentKeyLabel?: string;
documentKeyPlaceholder?: string;
requiresDate?: boolean;
info?: string;
}
import { ProofType, normalizeProofType, groupProofsByCategory } from '../../../shared/kyc-proof-types';
type SectionKey = 'id' | 'address';
/**
* Client-side enrichment for KYC proof types. Backend currently returns
* only { id, name, description (code), position, active, mandatory } — we
* derive sides / category / banner text / input labels from the code.
*/
const PROOF_META: Record<string, Partial<ProofType>> = {
PAN: {
sides: 1,
documentKeyLabel: 'PAN number',
documentKeyPlaceholder: 'e.g. ABCDE1234F',
info: 'PAN card — upload front side only (single copy required).'
},
AADHAAR: {
sides: 2,
documentKeyLabel: '12-digit Aadhaar number',
documentKeyPlaceholder: 'XXXX XXXX XXXX',
category: 'Government-issued ID',
info: 'Aadhaar — both front and back copies mandatory as per UIDAI guidelines.'
},
PASSPORT: {
sides: 2,
documentKeyLabel: 'Passport number',
documentKeyPlaceholder: 'e.g. A1234567',
category: 'Government-issued ID',
info: 'Passport — upload front (photo page) and back (last page with address).'
},
VOTER_ID: {
sides: 2,
documentKeyLabel: 'EPIC number',
documentKeyPlaceholder: 'Voter ID number',
category: 'Government-issued ID',
info: 'Voter ID (EPIC) — both sides required as address appears on the back.'
},
DRIVING_LICENSE: {
sides: 2,
documentKeyLabel: 'Driving licence number',
documentKeyPlaceholder: 'DL number',
category: 'Government-issued ID',
info: 'Driving licence — both sides required; vehicle class and validity are on the back.'
},
NREGA_JOB_CARD: {
sides: 1,
documentKeyLabel: 'NREGA job card number',
documentKeyPlaceholder: 'Job card number',
info: 'NREGA job card — ensure government authority signature is visible.'
},
NPR_LETTER: {
sides: 1,
documentKeyLabel: 'Reference / letter number',
documentKeyPlaceholder: 'NPR reference number',
info: 'NPR letter — upload full document.'
},
UTILITY_BILL: {
sides: 1,
category: 'Utility bills',
requiresDate: true,
info: 'Utility bill — must not be older than 3 months.'
},
ELECTRICITY_BILL: {
sides: 1,
category: 'Utility bills',
requiresDate: true,
info: 'Electricity bill — must not be older than 3 months.'
},
WATER_BILL: {
sides: 1,
category: 'Utility bills',
requiresDate: true,
info: 'Water bill — must not be older than 3 months.'
},
GAS_BILL: {
sides: 1,
category: 'Utility bills',
requiresDate: true,
info: 'Gas bill — must not be older than 3 months.'
},
INTERNET_BILL: {
sides: 1,
category: 'Utility bills',
requiresDate: true,
info: 'Internet bill — must not be older than 3 months.'
},
POSTPAID_MOBILE_BILL: {
sides: 1,
category: 'Utility bills',
requiresDate: true,
info: 'Postpaid mobile bill — must not be older than 3 months.'
},
BANK_STATEMENT: {
sides: 1,
category: 'Financial & other',
requiresDate: true,
info: 'Bank statement / passbook — not older than 3 months.'
},
RENT_AGREEMENT: {
sides: 1,
category: 'Financial & other',
info: 'Registered rent agreement — upload full document. Registration stamp must be visible.'
},
PROPERTY_TAX_RECEIPT: {
sides: 1,
category: 'Financial & other',
requiresDate: true,
info: 'Property tax receipt — latest receipt required.'
},
EMPLOYER_LETTER: {
sides: 1,
category: 'Financial & other',
info: 'Employer letter — must be on official letterhead with HR/management signature.'
},
PENSION_PAYMENT_ORDER: {
sides: 1,
category: 'Financial & other',
info: 'Pension payment order — upload full document issued by pension authority.'
}
};
@Component({
selector: 'mifosx-upload-document-dialog',
templateUrl: './upload-document-dialog.component.html',
@@ -245,9 +117,9 @@ export class UploadDocumentDialogComponent implements OnInit {
this.clientsService.getKycProofTypes().subscribe({
next: (res: any) => {
const activeFilter = (p: any) => p?.active !== false;
this.idProofs = (res?.idProofs || []).filter(activeFilter).map((p: any) => this.normalizeProof(p));
this.addressProofs = (res?.addressProofs || []).filter(activeFilter).map((p: any) => this.normalizeProof(p));
this.buildAddressGroups();
this.idProofs = (res?.idProofs || []).filter(activeFilter).map(normalizeProofType);
this.addressProofs = (res?.addressProofs || []).filter(activeFilter).map(normalizeProofType);
this.addressGroups = groupProofsByCategory(this.addressProofs);
this.loadingProofs = false;
},
error: () => {
@@ -256,37 +128,6 @@ export class UploadDocumentDialogComponent implements OnInit {
});
}
private normalizeProof(p: any): ProofType {
const code = (p.code || p.description || '').toString().toUpperCase();
const meta = PROOF_META[code] || {};
return {
id: p.id,
name: p.name,
code,
sides: p.sides || meta.sides || 1,
category: p.category || meta.category || 'Other',
documentKeyLabel: p.documentKeyLabel || meta.documentKeyLabel || 'Document number',
documentKeyPlaceholder: p.documentKeyPlaceholder || meta.documentKeyPlaceholder || '',
requiresDate: p.requiresDate ?? meta.requiresDate ?? false,
info: p.info || meta.info || ''
};
}
private buildAddressGroups(): void {
const map = new Map<string, ProofType[]>();
this.addressProofs.forEach((p) => {
const key = p.category || 'Other';
if (!map.has(key)) map.set(key, []);
map.get(key).push(p);
});
this.addressGroups = Array.from(map.entries()).map(
([
label,
items
]) => ({ label, items })
);
}
onIdProofChange(proofId: any): void {
this.selectedIdProof = this.idProofs.find((p) => String(p.id) === String(proofId)) || null;
this.idFiles = { front: null, back: null };
@@ -294,7 +294,7 @@ export class NomineeTabComponent implements OnInit {
}
this.searching = true;
this.searchTimer = setTimeout(() => {
this.clientsService.searchByText(text, 0, 8).subscribe({
this.clientsService.searchByText(text, 0, 8, '', '', true).subscribe({
next: (data: any) => {
this.searchResults = data?.content || [];
this.searching = false;
@@ -412,7 +412,7 @@ export class NomineeTabComponent implements OnInit {
}
this.guardianSearching = true;
this.guardianSearchTimer = setTimeout(() => {
this.clientsService.searchByText(text, 0, 8).subscribe({
this.clientsService.searchByText(text, 0, 8, '', '', true).subscribe({
next: (data: any) => {
this.guardianSearchResults = data?.content || [];
this.guardianSearching = false;