feat: Introduce agent profile verification history tracking and status notifications for agents.

src/users/users.controller.ts

@@ -330,6 +330,16 @@ export class UsersController {
     return this.usersService.updateVerification(id, data, admin.id);
   }
 
+  @Get(':id/verification-history')
+  @Roles(UserRole.ADMIN)
+  @ApiOperation({ summary: 'Admin: Get verification history for an agent' })
+  async getVerificationHistory(@Param('id') id: string) {
+    const user = await this.usersService.findOne(id);
+    const agentProfileId = (user as any)?.agentProfile?.id;
+    if (!agentProfileId) throw new NotFoundException('Agent profile not found');
+    return this.usersService.getVerificationHistory(agentProfileId);
+  }
+
   // ==========================================
   // ADMIN MANAGEMENT (SUPER_ADMIN only)
   // ==========================================

src/users/users.service.ts

@@ -1,6 +1,7 @@
 import { Injectable, BadRequestException, NotFoundException, ForbiddenException } from '@nestjs/common';
 import { UserStatus, UserRole, Prisma, VerificationStatus } from '@prisma/client';
 import { PrismaService } from '../prisma/prisma.service';
+import { EventEmitter2 } from '@nestjs/event-emitter';
 import * as argon2 from 'argon2';
 
 type UserWithProfiles = Prisma.UserGetPayload<{
@@ -9,7 +10,10 @@ type UserWithProfiles = Prisma.UserGetPayload<{
 
 @Injectable()
 export class UsersService {
-  constructor(private readonly prisma: PrismaService) {}
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly eventEmitter: EventEmitter2,
+  ) {}
 
   // =============================================
   // USER PROFILE METHODS (for regular users)
@@ -390,6 +394,24 @@ export class UsersService {
       },
     });
 
+    // Save verification history
+    await this.prisma.verificationHistory.create({
+      data: {
+        agentProfileId: user.agentProfile.id,
+        status: data.status,
+        note: data.note || null,
+        adminId,
+      },
+    });
+
+    // Emit notification to the agent
+    this.eventEmitter.emit('notification.verification', {
+      recipientUserId: userId,
+      status: data.status,
+      note: data.note,
+      agentName: `${updatedProfile.firstName || ''} ${updatedProfile.lastName || ''}`.trim(),
+    });
+
     return {
       id: user.id,
       agentProfileId: updatedProfile.id,
@@ -402,6 +424,17 @@ export class UsersService {
     };
   }
 
+  // Get verification history for an agent
+  async getVerificationHistory(agentProfileId: string) {
+    return this.prisma.verificationHistory.findMany({
+      where: { agentProfileId },
+      include: {
+        admin: { select: { id: true, email: true } },
+      },
+      orderBy: { createdAt: 'desc' },
+    });
+  }
+
   // =============================================
   // NOTIFICATION PREFERENCES
   // =============================================