Panel Administrativo de Comfaca Créditos en Línea

GET /api/admin/dashboard/estadisticas
Authorization: Bearer <token>

{
  solicitudes: {
    total: number;
    activas: number;               // Solicitudes en estados activos
    pendientesFirma: number;       // Estado PENDIENTE_FIRMADO
    tasaAprobacion: number;        // Porcentaje aprobadas / total
    montoTotalAprobado: number;    // Suma de montos aprobados en COP
    porEstado: Array<{
      estado: string;
      count: number;
      color: string;               // Color para gráficas
    }>;
  };
  convenios: {
    activos: string;               // Número como string (normalizado a number por el composable)
    topEmpresas: Array<{
      razon_social: string;
      nit: string;
      numero_empleados: string;
      tipo_empresa: string;
    }>;
  };
  usuarios: {
    trabajadores: string;          // Conteo del rol user_trabajador (string desde Prisma)
    porRol: Array<{ role: string; count: string }>;
  };
  actividadReciente: {
    solicitudesRecientes: Array<{
      numero_solicitud: string;
      estado: string;
      created_at: string;
      owner_username: string;
    }>;
    usuariosRecientes: Array<{
      username: string;
      created_at: string;
      full_name: string;
      roles: string[];
    }>;
  };
  ultimaActualizacion: string; // ISO 8601
}

const {
  stats,                      // AdminStats con todos los indicadores
  loading,
  error,
  lastUpdated,
  tieneDatos,
  tiempoSinActualizar,        // "Actualizado hace 5 min"
  totalUsuarios,              // Suma de usuariosPorRol[].count
  cargarEstadisticas,
  refrescarEstadisticas,
  cargarEstadisticasUsuarios, // Carga solo estadísticas de usuarios
  cargarEstadisticasConvenios // Carga solo estadísticas de convenios
} = useAdminDashboard();

const filtrosActivos = ref<FiltrosSolicitudes>({
  skip: 0,
  limit: 20,
  // Opcionales:
  estados: [],          // Array de IDs de estado
  numero_documento: "",
  nombre_usuario: "",
  owner_username: "",
  numero_solicitud: ""
});

GET /api/admin/solicitudes?limit=20&skip=0&estado=<estadoId>
Authorization: Bearer <token>

// Abre el modal
cambiarEstado(solicitud);

// Confirma el cambio vía PUT
await actualizarEstado(solicitudId, nuevoEstado, descripcionOpcional);
// PUT /api/admin/solicitudes/:id/estado

interface EmpresaConvenio {
  id: string;
  nit: string;                    // NIT de la empresa
  razon_social: string;           // Razón social
  fecha_convenio: string;         // Fecha de firma del convenio
  fecha_vencimiento: string;      // Fecha de vencimiento
  estado: "Activo" | "Inactivo";  // Estado del convenio
  representante_documento: string;
  representante_nombre: string;
  telefono: string;
  correo: string;
  createdAt: string;
  updatedAt: string;
}

const filtros = reactive({
  estado: null as string | null,  // "Activo" | "Inactivo"
  nit: "",
  busqueda: ""                    // Búsqueda con debounce de 500 ms
});

// Toggle estado Activo ↔ Inactivo
await toggleEstadoEmpresa(empresa);
// PUT /api/admin/convenios/:id

interface EstadisticasFirmas {
  total: number;
  pendientes: number;
  firmados: number;
  rechazados: number;
  expirados: number;
  porcentajeCompletado: number; // (firmados / total) × 100
}