# Manual de usuario — FLEXI Platform

## 1. Acceso y navegación

El personal recibe una invitación; el enlace dura 60 minutos y permite elegir una contraseña que el administrador nunca conoce. Abra la URL interna suministrada, ingrese correo/contraseña y cierre sesión al terminar. La ruta es configurable; no la publique. La cabecera ofrece Dashboard, Solicitudes, Clientes, Préstamos, Calculadora según rol, Usuarios, Auditoría, Configuración y campana.

## 2. Dashboard

Los indicadores se calculan desde la base: solicitudes por estado/mes, clientes, préstamos activos, capital colocado, balance, cuotas próximas y vencidas. Cero significa ausencia real de registros.

## 3. Solicitudes

1. Abra **Solicitudes** y filtre por estado, fecha o texto.
2. La búsqueda de cédula usa un HMAC normalizado; la cédula cifrada no se escanea masivamente.
3. Abra el número FLEXI para consultar datos, historial, notas y comunicaciones.
4. Crédito/Gerencia pueden cambiar estado. Cada cambio crea historial y, cuando está configurado, correo al solicitante.
5. Las notas son internas y nunca forman parte del correo.
6. Una solicitud aprobada puede crear o vincular un cliente sin alterar su registro histórico.
7. Una comunicación fallida puede reenviarse; esto no crea otra solicitud.

Estados: Pendiente, En revisión, Aprobada, Rechazada y Cancelada.

## 4. Clientes

Busque por nombre, correo, teléfono o identidad. Al crear/editar complete solo datos operativamente necesarios. La cédula se cifra y se mantiene un hash no reversible para duplicados. El detalle reúne solicitudes y préstamos. No se elimina historial financiero; se utiliza estado activo/inactivo.

## 5. Calculadora y amortización

1. Seleccione cliente opcional, monto, tasa nominal anual, plazo, frecuencia mensual/quincenal, desembolso, cargos y seguro.
2. Pulse **Calcular**. La simulación no se guarda.
3. Revise cuota, intereses, total y tabla; el método es cuota nivelada con saldo decreciente y es referencia configurable.
4. Use **Imprimir amortización** para una vista sin navegación.
5. Para formalizar, seleccione cliente y pulse **Crear préstamo**. El sistema persiste un snapshot de términos y cuotas.

## 6. Préstamos, cuotas y avance

El listado muestra número público, cliente, monto, balance, próximo pago y estado. El detalle separa capital pagado de porcentaje de cuotas, presenta términos, avance y cada cuota (pagada, parcial, pendiente o vencida). **Imprimir estado** genera una versión apta para navegador/impresora.

## 7. Pagos

Crédito, Cobros y Gerencia registran monto, fecha, método, referencia y nota. La política provisional aplica FIFO a cuotas y dentro de cada cuota cargos, seguro, interés y capital. Admite parcial, cuota completa y varias cuotas. Mora, penalidades y reglas contractuales definitivas están pendientes de negocio.

## 8. Comunicaciones y notificaciones

La campana muestra solicitudes nuevas sin cédula. Puede marcar una o todas como leídas. En la solicitud, **Comunicaciones** indica destinatario, asunto, estado e intentos. No promete aprobación ni tasa al cliente.

## 9. Usuarios y roles

Superadmin/Admin crean personal ordinario, asignan rol, invitan, desactivan y cierran sesiones. Nadie puede ver contraseñas. Roles: Superadministrador, Administrador, Gerencia, Crédito, Cobros, Servicio al Cliente y Consulta/Auditoría. La interfaz puede ocultar acciones, pero el servidor siempre valida el permiso.

## 10. Auditoría, recuperación y salida

Auditoría registra acciones relevantes sin contraseñas, tokens completos ni cédulas. Para recuperar acceso use **¿Olvidó su contraseña?**; la respuesta no confirma si el correo existe. Al finalizar, pulse **Cerrar sesión**.

