Comfaca Créditos en Línea: Plataforma Digital de Créditos

Comfaca Créditos en Línea es la plataforma web oficial de la Caja de Compensación Familiar del Caquetá (COMFACA) para la gestión digital de solicitudes de crédito. Desarrollada con Nuxt 4 y Vue 3, moderniza el proceso tradicional de solicitud y aprobación de créditos, permitiendo a los empleados afiliados radicar solicitudes en línea con carga de documentos, firma electrónica integrada y seguimiento en tiempo real. El equipo administrativo, por su parte, cuenta con un panel de back-office completo para gestionar, revisar y aprobar solicitudes sin necesidad de trámites presenciales.

Casos de Uso

Afiliados
Administradores

Los empleados afiliados a COMFACA acceden al front-office de la plataforma para gestionar sus solicitudes de crédito de principio a fin:

Registro y autenticación — inicio de sesión con credenciales empresariales, recuperación de contraseña y gestión del perfil de usuario.
Solicitud de crédito — selección de la línea de crédito, diligenciamiento del formulario y carga de los documentos requeridos.
Seguimiento del estado — visualización en tiempo real del estado de la solicitud a lo largo de su ciclo de vida: POSTULADO → DOCUMENTOS_CARGADOS → ENVIADO_VALIDACION → PENDIENTE_FIRMADO → FIRMADO → ENVIADO_PENDIENTE_APROBACION → APROBADA (o RECHAZADA / DESESTIMADA / CANCELADA / DESISTE según el resultado).
Firma electrónica — visualización de los documentos contractuales generados, firma con código OTP y descarga del comprobante firmado.
Descarga de documentos — acceso a todos los documentos asociados a la solicitud una vez completado el proceso.

Los usuarios con rol administrador acceden al back-office para supervisar y gestionar la operación completa de créditos:

Dashboard administrativo — estadísticas de solicitudes por estado, gráficos de convenios activos, monitor de actividad reciente y distribución de usuarios por rol.
Gestión de solicitudes — listado con filtros avanzados, cambio de estados (de POSTULADO a APROBADA o RECHAZADA) y revisión de documentos adjuntos.
Descarga masiva de documentos — exportación individual o por lote de todos los documentos vinculados a una solicitud.
Monitoreo de firmas — vista en tiempo real del estado de firmas pendientes, estadísticas de completitud y reenvío de notificaciones a los afiliados.
Gestión de convenios — administración del catálogo de líneas de crédito y convenios disponibles para los afiliados.

Tecnologías

Core

Tecnología	Versión	Descripción
Nuxt	^4.4.6	Framework full-stack basado en Vue 3
Vue	^3.5.35	Framework UI progresivo y reactivo
TypeScript	^6.0.3	Tipado estático sobre JavaScript
Tailwind CSS	^4.3.0	Framework CSS utility-first

UI/UX

Tecnología	Versión	Descripción
Nuxt UI	^4.8.1	Biblioteca de componentes UI para Nuxt
@lucide/vue	^1.17.0	Biblioteca de iconos SVG para Vue
Heroicons	^2.2.0	Iconos SVG de Tailwind Labs
Radix Vue	^1.9.17	Primitivos UI accesibles sin estilos

Backend

Tecnología	Versión	Descripción
Prisma	^7.8.0	ORM para modelado y acceso a base de datos
MariaDB Adapter	^7.8.0	Conector oficial de Prisma para MariaDB/MySQL
Nitro	Integrado	Engine de servidor HTTP incluido en Nuxt
Zod	^4.4.3	Validación de esquemas en endpoints de la API

Auth

Tecnología	Versión	Descripción
nuxt-auth-utils	^0.5.29	Gestión de sesiones cifradas para Nuxt
jose	^6.2.3	Implementación JWT (firma y verificación)
bcryptjs	^3.0.3	Hash seguro de contraseñas con salt

Integraciones

Servicio	Descripción
API SISU	Sistema de información de usuarios y afiliados de COMFACA
FirmaPlus	Servicio externo de firma electrónica de documentos contractuales
FlaskPDF	Microservicio de generación de documentos PDF
SFTP	Transferencia segura de archivos firmados vía SSH
SMTP / Nodemailer	Envío de correos transaccionales (notificaciones, OTP, recuperación de contraseña) vía Gmail u otro servidor SMTP

Roles de Usuario

La plataforma reconoce tres tipos de usuario con accesos y capacidades diferenciados:

Rol	Tipo de acceso	Descripción
Público	Sin autenticación	Puede explorar la página de inicio (`/`), ver información general del proceso de crédito y acceder a los formularios de registro y autenticación.
Afiliado	Front-office (`/dash/**`)	Empleado afiliado a COMFACA autenticado. Puede crear y gestionar sus propias solicitudes de crédito, firmar documentos electrónicamente y descargar comprobantes.
Administrador	Back-office (`/admin/**`)	Funcionario de COMFACA con acceso total al panel administrativo. Puede revisar, aprobar o rechazar solicitudes, monitorear firmas y administrar convenios y usuarios.

Las rutas /dash/** y /admin/** están protegidas por middleware de autenticación. El acceso sin sesión válida redirige automáticamente al inicio de sesión. Las sesiones tienen una duración máxima de 8 horas con renovación automática.

Estructura del Proyecto

nuxt-creditos/
├── app/                    # Código fuente de la aplicación
│   ├── components/         # Componentes Vue reutilizables
│   │   ├── admin/          # Componentes de panel admin
│   │   ├── dashboard/      # Componentes de dashboard
│   │   ├── notifications/  # Sistema de notificaciones
│   │   └── ui/             # Componentes UI base
│   ├── composables/        # Composables Vue (lógica reutilizable)
│   │   └── admin/          # Composables específicos de admin
│   ├── layouts/            # Layouts de la aplicación
│   ├── middleware/         # Middleware de autenticación
│   ├── pages/              # Rutas de la aplicación
│   │   ├── admin/          # Rutas de administración
│   │   ├── auth/           # Rutas de autenticación
│   │   └── dash/           # Dashboard de usuario
│   └── assets/             # Recursos estáticos (CSS, imágenes)
├── server/                 # API y lógica del servidor
│   ├── api/                # Endpoints de la API
│   │   ├── auth/           # Rutas de autenticación
│   │   ├── admin/          # Rutas administrativas
│   │   └── solicitudes/    # Rutas de solicitudes de crédito
│   ├── middleware/         # Middleware del servidor
│   ├── services/           # Servicios de negocio
│   │   ├── admin/          # Servicios administrativos
│   │   └── storage/        # Servicios de almacenamiento
│   └── utils/              # Utilidades del servidor
├── tests/                  # Suite de testing
│   ├── setup/              # Configuración de entorno
│   │   ├── global.ts       # Setup global de Vitest
│   │   ├── integration.ts  # Setup para integración
│   │   └── msw.ts          # Configuración de MSW
│   ├── integration/        # Pruebas de integración
│   │   └── api/
│   └── unit/               # Pruebas unitarias
├── shared/                 # Código compartido
│   └── types/              # Definiciones de tipos TypeScript
├── prisma/                 # Esquema y migraciones de Prisma
└── public/                 # Archivos públicos estáticos

El alias @/ apunta a ./app/ y ~~/ apunta a la raíz del proyecto. Úsalos en tus importaciones para mantener rutas consistentes independientemente de la profundidad del archivo.

Instalar y Ejecutar

Levanta el entorno de desarrollo local en menos de 10 minutos con Node.js, pnpm y MariaDB.

Ver Arquitectura

Explora en detalle la arquitectura de capas, el modelo de datos y los flujos de integración.

Introducción

Configuración

Arquitectura

Funcionalidades

Pruebas y Despliegue

Comfaca Créditos en Línea: Plataforma Digital de Créditos

Casos de Uso

Tecnologías

Core

UI/UX

Backend

Auth

Integraciones

Roles de Usuario

Estructura del Proyecto

Instalar y Ejecutar

Ver Arquitectura

​Casos de Uso

​Tecnologías

​Core

​UI/UX

​Backend

​Auth

​Integraciones

​Roles de Usuario

​Estructura del Proyecto

Instalar y Ejecutar

Ver Arquitectura

Casos de Uso

Tecnologías

Core

UI/UX

Backend

Auth

Integraciones

Roles de Usuario

Estructura del Proyecto