System Audit Logging Specification

+-------------------------------------------------------------------------------+
|                            AUDITED SYSTEM EVENTS                              |
+-------------------+-------------------+-------------------+-------------------+
| Security & Auth   | Product Validation| Wallet & Payout   | System Admin      |
+-------------------+-------------------+-------------------+-------------------+
| USER_LOGIN        | COURSE_SUBMITTED  | WITHDRAWAL_REQ    | ROLE_CHANGE       |
| USER_LOGOUT       | COURSE_APPROVED   | WITHDRAWAL_VERIF  | USER_SUSPENDED    |
| PASSWORD_RESET    | COURSE_REJECTED   | WITHDRAWAL_PAID   | SYSTEM_CONFIG_CHG |
| AUTH_FAILURE      | CONSULTATION_APPR | REFUND_PROCESSED  | AUDIT_LOG_EXPORT  |
+-------------------+-------------------+-------------------+-------------------+

export interface AuditLogEntity {
  id: string;             // Unique UUID
  userId: string;         // Actor who performed the action
  userRole: string;       // Role at time of action (STUDENT, INSTRUCTOR, CONSULTANT, ADMIN)
  action: string;         // Event code (e.g. WITHDRAWAL_APPROVED)
  resourceType: string;   // Affected domain (e.g., COURSE, WITHDRAWAL, USER)
  resourceId: string;     // ID of target entity
  ipAddress: string;      // Client IPv4/IPv6 address
  userAgent: string;      // HTTP User-Agent string
  payload: Record<string, any>; // JSON snapshot of changes/context
  createdAt: Date;        // Immutable timestamp
}