Panel Administration

// Lister les utilisateurs avec filtres
const users = await fetch('/api/admin/users?' + new URLSearchParams({
  role: 'PARTICULIER',
  status: 'ACTIVE',
  search: 'dupont',
  page: '1',
  limit: '20',
  sortBy: 'createdAt',
  sortOrder: 'desc',
}), {
  headers: { 'Authorization': 'Bearer ${adminToken}' },
});

// Response: { users: [...], total: 1250, page: 1, totalPages: 63 }

// Modifier le role d'un utilisateur
await fetch('/api/admin/users/usr_abc123/role', {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ${adminToken}',
  },
  body: JSON.stringify({
    role: 'PROFESSIONNEL',
    reason: 'KYB valide - activation compte pro',
  }),
});
// Action auditee automatiquement

// Recuperer les metriques de monitoring
const metrics = await fetch('/api/admin/monitoring', {
  headers: { 'Authorization': 'Bearer ${adminToken}' },
});

// Response
{
  "system": {
    "uptime": "99.98%",
    "cpu": "23%",
    "memory": "4.2GB / 8GB",
    "latency_p50": "12ms",
    "latency_p99": "89ms"
  },
  "agents": {
    "yani_core": { "status": "healthy", "requests_1h": 1247 },
    "fraud_detector": { "status": "healthy", "alerts_24h": 3 },
    "kyc_processor": { "status": "healthy", "pending": 12 }
  },
  "business": {
    "active_users_24h": 8421,
    "transactions_24h": 15893,
    "volume_24h": "€2,847,391.00",
    "kyc_completion_rate": "87.3%"
  }
}

// Structure d'un log d'audit admin
interface AdminAuditLog {
  id: string;
  adminId: string;
  adminEmail: string;
  action: 'USER_ROLE_CHANGE' | 'KYC_APPROVE' | 'KYC_REJECT'
        | 'USER_DISABLE' | 'SETTINGS_UPDATE' | 'DATA_EXPORT';
  target: {
    type: 'user' | 'kyc' | 'program' | 'settings';
    id: string;
  };
  payload: Record<string, unknown>;
  ip: string;
  userAgent: string;
  timestamp: string; // ISO 8601
}

// Example log entry
{
  "id": "audit_xyz789",
  "adminId": "usr_admin001",
  "adminEmail": "admin@yanipay.com",
  "action": "KYC_APPROVE",
  "target": { "type": "kyc", "id": "kyc_abc123" },
  "payload": { "previousStatus": "PENDING", "newStatus": "APPROVED" },
  "ip": "192.168.1.1",
  "userAgent": "Mozilla/5.0...",
  "timestamp": "2026-02-20T14:30:00.000Z"
}