Libro digital operativo para aprender a usar todo el sistema.
InteractivoIndice, buscador, navegacion y botones directos.
ResponsiveUsable en PC, tablet y celular.
PDFUsa imprimir para guardar una version PDF profesional.
RealBasado en rutas, menus, permisos y modulos existentes.
2
Página 3 de 32/dashboard
Presentacion del sistema
MzaSystem centraliza la operacion diaria de una entidad financiera: clientes, solicitudes, prestamos, cobros, ahorros, caja, reportes, usuarios, sucursales y auditoria.
/dashboard
Panel con indicadores de cartera, cobranza, mora y accesos rapidos.
Flujo de uso
Ingresar al sistema
Seleccionar sucursal
Consultar panel principal
Operar el modulo correspondiente
Verificar reportes y auditoria
Detalles clave
El sistema esta preparado para trabajo por sucursales, control de permisos por rol y seguimiento de operaciones sensibles.
La interfaz usa menues por permisos: cada usuario ve solo las opciones habilitadas para su perfil.
Las acciones criticas muestran confirmaciones, alertas y mensajes de resultado.
Buenas practicas
Antes de operar, verifica la sucursal activa en el menu lateral.Usa el buscador de tablas para encontrar registros rapidamente.
3
Página 4 de 32/admin
Acceso, idioma y modo demo
La pantalla de acceso permite iniciar sesion con usuario y contrasena, recuperar clave, alternar Espanol/Ingles y usar perfiles demo cuando DEMO_MODE esta activo.
/admin
Login financiero con logo configurable, fondo configurable, formulario, idioma y botones demo compactos.
Flujo de uso
Abrir /admin
Elegir idioma si hace falta
Ingresar email y contrasena
Usar Accesos Demo para probar roles
Entrar al panel principal
Detalles clave
El selector ES/EN cambia el idioma de pantallas, botones, estados y textos preparados para traduccion.
El modo demo muestra accesos por roles reales: Administrador, Supervisor, Agente, Cajero y Auditor.
El sexto boton del login abre este manual sin requerir credenciales.
Buenas practicas
En produccion conviene mantener DEMO_MODE=false.Si el login falla, revisa mayusculas, email y usuario activo.
4
Página 5 de 32/dashboard
Panel principal
El dashboard resume total prestado, total cobrado, saldo pendiente, prestamos activos, cobranza diaria, cobranza semanal, solicitudes pendientes y mora.
/dashboard
Tarjetas KPI, accesos rapidos, alertas operativas y estado de cartera.
Flujo de uso
Revisar indicadores superiores
Entrar a acciones rapidas
Atender solicitudes pendientes
Controlar mora
Comparar cobranza mensual contra objetivo
Detalles clave
Los indicadores se calculan con datos de prestamos, transacciones y cronogramas.
Los accesos rapidos permiten crear cliente, crear prestamo y registrar cobro.
Las alertas ayudan a priorizar tareas del dia.
Buenas practicas
Usa el panel como primera revision diaria.Si los datos no coinciden, verifica sucursal activa y fechas de operacion.
5
Página 6 de 32/branch/data
Sucursales
El modulo de sucursales separa cartera, cobros, caja, usuarios y reportes por oficina o punto de atencion.
/branch/data
Listado de sucursales, formulario de alta y pantalla de cambio de sucursal.
Flujo de uso
Crear sucursal
Asignar usuarios
Cambiar sucursal activa
Operar prestamos y cobros en esa sucursal
Revisar reportes filtrados
Detalles clave
Cambiar sucursal afecta listados y operaciones posteriores.
Cada usuario puede tener acceso a una o varias sucursales.
Los reportes respetan la sucursal de trabajo cuando corresponde.
Buenas practicas
No registres cobros sin confirmar sucursal.Usa nombres claros para sucursales y direcciones completas.
6
Página 7 de 32/borrower/data
Clientes
Clientes permite registrar personas o empresas, consultar perfil, documentos, prestamos, garantias, ahorros, comunicaciones y estado operativo.
/borrower/data
Ficha de cliente con resumen, pestanas de actividad y acciones de comunicacion.
Flujo de uso
Agregar cliente
Completar datos personales y contacto
Adjuntar foto/documentos si aplica
Aprobar o rechazar cliente pendiente
Consultar historial desde la ficha
Detalles clave
Los clientes pueden estar activos, pendientes o bloqueados.
Desde la ficha se accede a prestamos, cobros, garantias, comunicaciones y estados de cuenta.
Los campos personalizados agregan informacion propia de la entidad.
Buenas practicas
Completa telefono y email para usar comunicaciones.Bloquea clientes solo cuando exista una politica interna que lo justifique.
7
Página 8 de 32/borrower/group/data
Grupos de clientes
Los grupos organizan clientes por comunidad, convenio, asociacion, empresa, centro o cartera de trabajo.
/borrower/group/data
Pantalla de grupo con miembros asociados y acciones para agregar o quitar clientes.
Flujo de uso
Crear grupo
Agregar clientes
Revisar miembros
Usar el grupo como referencia operativa
Actualizar integrantes cuando cambie la cartera
Detalles clave
El grupo facilita seguimiento comercial y operativo.
Permite ordenar clientes cuando se trabaja con creditos grupales o zonas.
Buenas practicas
Usa nombres estandarizados por zona o convenio.Mantén los miembros actualizados para reportes confiables.
8
Página 9 de 32/guarantor/data
Garantes
Garantes registra personas que respaldan prestamos y permite consultar en que operaciones participan.
/guarantor/data
Listado de garantes y ficha con prestamos relacionados.
Flujo de uso
Agregar garante
Completar datos personales
Asociar a prestamos
Consultar exposicion
Actualizar o eliminar si corresponde
Detalles clave
Un garante puede relacionarse con prestamos de diferentes clientes.
La ficha muestra datos de contacto y prestamos garantizados.
Buenas practicas
Verifica documento y telefono del garante antes de aprobar un credito.No elimines garantes con historial relevante sin respaldo administrativo.
9
Página 10 de 32/loan/data
Prestamos
El modulo central administra solicitudes, aprobaciones, desembolsos, cronogramas, estados, cargos, garantes, comentarios, refinanciaciones y documentos.
/loan/data
Listado con estados, ficha del prestamo, cronograma, transacciones y menu de documentos.
Flujo de uso
Crear prestamo o aprobar solicitud
Seleccionar cliente y producto
Definir capital, plazo, tasa, cargos y fechas
Aprobar y desembolsar
Registrar cobros y monitorear mora
Detalles clave
Estados principales: pendiente, aprobado, desembolsado, rechazado, retirado, reprogramado, castigado y cerrado.
La vista show concentra resumen, cronograma, transacciones, archivos, comentarios y opciones PDF/email/print.
Las acciones criticas respetan permisos: aprobar, desembolsar, revertir, castigar, retirar, reprogramar y cerrar.
Buenas practicas
Revisa el cronograma antes de desembolsar.Usa comentarios para dejar evidencia de decisiones crediticias.
10
Página 11 de 32/loan/loan_product/data
Productos de prestamo
Define las condiciones financieras que se aplican al crear prestamos: capital minimo/maximo, plazo, frecuencia, interes, cargos, penalidades y cuentas contables.
/loan/loan_product/data
Formulario dividido por datos generales, reglas financieras, cargos y contabilidad.
Flujo de uso
Crear producto
Definir reglas de capital y plazo
Configurar interes y frecuencia
Asignar cargos y orden de cobro
Configurar cuentas contables
Detalles clave
El producto controla como se calcula el prestamo y como se registran los movimientos.
El orden de cobro decide como se aplica cada pago a penalidad, cargos, interes y capital.
Las ayudas contextuales explican campos financieros complejos.
Buenas practicas
No modifiques productos activos sin revisar impacto operativo.Crea productos separados para lineas de credito con reglas distintas.
11
Página 12 de 32/loan/loan_calculator/create
Calculadora de prestamos
Permite simular un prestamo antes de registrarlo formalmente, calculando cuotas, intereses, fechas y total a pagar.
/loan/loan_calculator/create
Formulario de simulacion y tabla de cuotas calculadas.
Flujo de uso
Ingresar capital
Elegir plazo, tasa y frecuencia
Definir fecha de desembolso
Generar simulacion
Imprimir o usar como referencia comercial
Detalles clave
Sirve para explicar al cliente el plan de pagos antes de crear el prestamo.
No reemplaza la aprobacion formal ni el desembolso.
Buenas practicas
Usa la simulacion en atencion comercial.Confirma que tasa y frecuencia coincidan con el producto real.
12
Página 13 de 32/repayment/data
Cobros y recibos
Cobranzas permite registrar pagos individuales o masivos, imprimir recibos, enviar comprobantes y reversar operaciones cuando el permiso lo habilita.
/repayment/data
Formulario de cobro, listado de pagos, acciones de PDF, print, email y reversa.
Flujo de uso
Buscar prestamo
Registrar importe, metodo, recibo y fecha
Guardar cobro
Verificar asignacion a capital/interes/cargos/mora
Imprimir o descargar comprobante
Detalles clave
El sistema valida que el importe no supere el saldo y que la fecha no sea futura ni anterior al desembolso.
El tipo de cobro normal aplica el orden del producto; cobro a capital reduce capital pendiente.
Las reversas deben usarse solo para corregir errores documentados.
Buenas practicas
Registra el numero de recibo fisico si la entidad lo usa.Al cierre del dia compara cobranza registrada contra caja.
13
Página 14 de 32/saving/data
Ahorros
Ahorros administra cuentas de ahorro, productos de ahorro, cargos, depositos, retiros, transferencias y estados de cuenta.
/saving/data
Listado de cuentas, ficha de ahorro y movimientos.
Flujo de uso
Crear producto de ahorro
Abrir cuenta para cliente
Registrar transacciones
Transferir si aplica
Emitir estado de cuenta
Detalles clave
Los productos definen intereses, cargos, cuentas contables y reglas operativas.
Las transacciones pueden imprimirse, enviarse por email o descargarse.
El portal cliente permite consultar cuentas si esta habilitado.
Buenas practicas
Configura productos antes de abrir cuentas.Revisa el saldo antes de retiros o transferencias.
14
Página 15 de 32/collateral/data
Garantias y colaterales
Colaterales registra bienes o documentos entregados como garantia de prestamos.
/collateral/data
Registro de garantia con tipo, valor, descripcion y archivos.
Flujo de uso
Crear tipo de garantia
Registrar garantia
Asociar cliente/prestamo
Adjuntar descripcion o documento
Actualizar estado si cambia
Detalles clave
Ayuda a controlar respaldo de operaciones crediticias.
Los tipos ordenan garantias por vehiculo, inmueble, documento, equipo u otra clasificacion.
Buenas practicas
Carga valores y referencias verificables.Usa observaciones para condiciones de custodia.
15
Página 16 de 32/expense/data
Gastos y otros ingresos
Permite registrar salidas de dinero, ingresos no crediticios y sus tipos para reflejar movimientos operativos de la entidad.
/expense/data
Listados, formularios y vistas de detalle para movimientos operativos.
Flujo de uso
Crear tipos
Registrar gasto o ingreso
Indicar fecha, importe y cuenta
Guardar comprobante si aplica
Revisar reportes financieros
Detalles clave
Los movimientos pueden generar asientos contables.
Los tipos permiten ordenar gastos e ingresos para analisis.
Buenas practicas
Usa categorias consistentes.Adjunta comprobantes cuando la politica interna lo requiera.
16
Página 17 de 32/capital/data
Capital y bancos
Capital y bancos registran aportes, fuentes de fondos y cuentas utilizadas para operaciones financieras.
/capital/data
Listados de capital, bancos y formularios con importes y cuentas.
Flujo de uso
Crear cuenta bancaria
Registrar capital
Relacionar con cuentas contables
Controlar saldos
Consultar movimientos
Detalles clave
Estos datos sirven como base para desembolsos, pagos y reportes contables.
La administracion debe mantenerlos actualizados.
Buenas practicas
No mezcles cuentas operativas con cuentas de control.Revisa reportes contables despues de cambios importantes.
17
Página 18 de 32/accounting/journal
Contabilidad
Incluye plan de cuentas, diario, mayor, balance de comprobacion y entradas manuales para control contable.
/accounting/journal
Tablas contables con filtros de fecha y opciones de consulta.
Flujo de uso
Configurar plan de cuentas
Revisar diario
Consultar mayor
Registrar entrada manual autorizada
Emitir balances
Detalles clave
Muchas operaciones del sistema generan movimientos contables automaticamente.
Las entradas manuales deben estar respaldadas y autorizadas.
Buenas practicas
Verifica cuentas contables en productos antes de operar.Usa filtros por fecha para conciliaciones.
18
Página 19 de 32/product/data
Inventario y stock
Administra productos, proveedores, depositos, categorias, ingresos de stock, salidas de stock y vista general.
/product/data
Catalogo de productos, entradas, salidas y resumen de inventario.
Flujo de uso
Crear categorias, proveedores y depositos
Registrar productos
Cargar stock con check-in
Registrar salidas con check-out
Consultar overview
Detalles clave
El modulo puede usarse para entidades que financian bienes o controlan inventario operativo.
Las salidas pueden relacionarse con clientes y operaciones.
Buenas practicas
Mantén codigos y nombres de productos claros.Revisa stock antes de aprobar entregas.
19
Página 20 de 32/payroll/data
Nomina
Permite registrar pagos de personal, usar plantillas de conceptos, imprimir recibos y reflejar egresos contables.
/payroll/data
Formulario de nomina, plantillas y recibo PDF.
Flujo de uso
Configurar plantilla
Crear pago de nomina
Seleccionar empleado
Registrar conceptos
Emitir recibo
Detalles clave
Las plantillas ayudan a estandarizar conceptos recurrentes.
Los pagos pueden registrarse contra cuenta bancaria o caja.
Buenas practicas
Revisa deducciones antes de guardar.Imprime o descarga recibos para archivo interno.
20
Página 21 de 32/asset/data
Activos
Activos controla bienes propios de la entidad, tipos de activos, valores y depreciacion o valuacion en el tiempo.
/asset/data
Ficha de activo con datos generales y valuaciones.
Flujo de uso
Crear tipo de activo
Registrar activo
Agregar valuaciones
Adjuntar datos relevantes
Consultar estado
Detalles clave
Sirve para control patrimonial y reportes financieros.
Las valuaciones pueden actualizarse periodicamente.
Buenas practicas
Usa descripciones identificables.Carga fechas de compra o fabricacion cuando existan.
21
Página 22 de 32/report/loan_report
Reportes
Reportes concentra informacion de clientes, prestamos, cobranzas, finanzas, compania y ahorros, con filtros y exportacion.
/report/loan_report
Panel de reportes con lupa de acceso y pantallas filtrables.
Flujo de uso
Elegir categoria de reporte
Definir fechas y filtros
Consultar en pantalla
Exportar PDF/Excel/CSV si corresponde
Usar datos para decisiones
Detalles clave
Reportes de prestamos incluyen mora, balance, transacciones, clasificacion, proyeccion y planilla de cobro.
Reportes financieros incluyen balance, resultados, provisionamiento y flujo de caja.
Reportes de clientes y compania ayudan a evaluar cartera y desempeno.
Buenas practicas
Siempre valida rango de fechas.Para auditoria, conserva PDF o exportaciones relevantes.
22
Página 23 de 32/communication/email
Comunicacion Email/SMS
Permite enviar emails y SMS a clientes, revisar historial y configurar gateways de SMS.
/communication/email
Bandejas de email/SMS, formularios y configuracion de gateway.
Flujo de uso
Seleccionar email o SMS
Crear mensaje
Elegir destinatario
Usar etiquetas disponibles
Enviar y revisar historial
Detalles clave
Las plantillas y etiquetas permiten personalizar mensajes.
SMS requiere gateway configurado y activo.
La comunicacion queda asociada al usuario que la genera.
Buenas practicas
Prueba plantillas antes de campanas masivas.No envies datos sensibles por SMS si tu politica no lo permite.
23
Página 24 de 32/client
Portal cliente
El portal cliente permite a usuarios externos consultar solicitudes, prestamos, ahorros, estados de cuenta y pagos online cuando las pasarelas estan configuradas.
/client
Dashboard cliente con prestamos, ahorros, solicitudes y opciones de pago.
Flujo de uso
Cliente inicia sesion o se registra
Consulta solicitudes y prestamos
Revisa cronograma o estado de cuenta
Realiza pagos si esta habilitado
Actualiza perfil
Detalles clave
Incluye integraciones de pago como PayNow, Stripe, PayPal y MPesa en rutas existentes.
Las opciones disponibles dependen de configuracion y permisos.
Buenas practicas
Configura correctamente URLs IPN antes de habilitar pagos online.Acompana al cliente en el primer ingreso.
24
Página 25 de 32/user/data
Usuarios, roles y permisos
Administra usuarios internos, perfiles, roles y permisos con Sentinel.
/user/data
Pantallas de usuarios, roles, permisos y perfil personal.
Flujo de uso
Crear rol o revisar rol existente
Asignar permisos por modulo
Crear usuario
Asignar rol y sucursal
Verificar acceso con perfil demo o usuario real
Detalles clave
Roles reales del sistema: Administrador, Supervisor, Agente, Cajero y Auditor.
Los permisos controlan menu, botones y operaciones.
El perfil del usuario permite actualizar datos, clave y foto.
Buenas practicas
Aplica menor privilegio: cada usuario debe tener solo lo necesario.No compartas usuarios entre personas.
25
Página 26 de 32/audit_trail/data
Auditoria
Auditoria registra actividad del sistema para seguimiento, control interno y revision de operaciones.
/audit_trail/data
Listado de eventos con usuario, modulo, accion y fecha.
Flujo de uso
Abrir auditoria
Filtrar o buscar registro
Revisar usuario, accion y fecha
Investigar operacion relacionada
Conservar evidencia si corresponde
Detalles clave
Es clave para detectar cambios, accesos y operaciones sensibles.
Los auditores pueden tener acceso de consulta sin permisos operativos criticos.
Buenas practicas
Revisa auditoria ante anulaciones o cambios de estado.Usa fechas exactas para encontrar eventos rapidamente.
26
Página 27 de 32/setting/data
Configuracion general
Configuracion define empresa, logo, favicon, fondo de login, colores, moneda, idioma, email, SMS, plantillas, actualizaciones y opciones del portal.
/setting/data
Pestanas de configuracion con formularios, previews de imagen y botones guardar por seccion.
Flujo de uso
Revisar datos de empresa
Configurar imagenes y branding
Definir moneda e idioma
Configurar email/SMS
Guardar cambios y probar login/reportes
Detalles clave
Los datos visuales no deben hardcodearse: se administran desde esta pantalla.
Las imagenes tienen recomendaciones de tamano para logo, favicon y fondos.
Comprobar version consulta informacion de actualizacion si el servidor esta disponible.
Buenas practicas
Usa imagenes livianas para evitar pantallas lentas.Prueba envio de email/SMS despues de cambiar credenciales.
27
Página 28 de 32/custom_field/data
Campos personalizados
Permite agregar campos propios a clientes, prestamos, gastos, ingresos, garantias y cobros.
/custom_field/data
Administrador de campos con categoria, tipo y obligatoriedad.
Flujo de uso
Elegir categoria
Definir nombre y tipo
Marcar obligatorio si aplica
Guardar
Usar el campo en el formulario correspondiente
Detalles clave
Tipos comunes: texto, numero, decimal, fecha y area de texto.
Los campos ayudan a adaptar el sistema a politicas internas sin tocar codigo.
Buenas practicas
Evita crear campos duplicados.Usa nombres comprensibles para usuarios no tecnicos.
28
Página 29 de 32/dashboard
Flujo completo recomendado
El flujo operativo recomendado conecta configuracion, clientes, productos, prestamos, desembolsos, cobros, reportes y auditoria.
/dashboard
Linea de proceso desde alta de cliente hasta cierre del prestamo.
Flujo de uso
Configurar empresa, sucursales, usuarios y productos
Crear cliente y verificar datos
Crear o aprobar prestamo
Desembolsar
Cobrar cuotas
Revisar mora y reportes
Auditar cambios
Detalles clave
Una financiera puede operar diariamente desde el dashboard y profundizar por modulo.
Los reportes deben usarse para cierre diario, seguimiento mensual y control de mora.
Buenas practicas
Define responsables para aprobacion, caja y auditoria.Documenta excepciones con comentarios y comprobantes.
29
Página 30 de 32/manual
Preguntas frecuentes
Respuestas rapidas para situaciones habituales de uso diario.
/manual
Guia de diagnostico para soporte interno.
Flujo de uso
No veo un menu: revisar permisos y rol
No aparecen datos: revisar sucursal activa
No puedo cobrar: verificar estado desembolsado y saldo
PDF no refleja logo: revisar configuracion de imagen
No llegan SMS: revisar gateway y servicio activo
Detalles clave
Los permisos y la sucursal activa explican la mayoria de diferencias entre usuarios.
Las operaciones financieras validan fechas, saldos y estados para evitar inconsistencias.
Buenas practicas
Ante errores, copia URL, accion realizada y mensaje exacto.Usa el perfil Auditor para pruebas de consulta sin modificar datos.
30
Página 31 de 32/manual
Glosario
Conceptos usados en el sistema.
/manual
Diccionario operativo financiero.
Flujo de uso
Capital: importe principal prestado
Interes: costo financiero calculado
Mora: cuotas vencidas o atraso
Desembolso: entrega del dinero o bien
Reversa: anulacion controlada de una operacion
Sucursal: unidad operativa de trabajo
Detalles clave
Producto de prestamo define reglas de calculo.
Cronograma muestra fechas e importes esperados.
Estado de cuenta resume movimientos del cliente o prestamo.
Buenas practicas
Usa este glosario para capacitar usuarios nuevos.Mantén criterios internos alineados con estos terminos.
31
Página 32 de 32/manual
Creditos finales
Manual preparado para MzaSystem & beLogic Software Design, orientado a uso operativo real en entidades financieras.
/manual
Cierre institucional con branding MzaSystem.
Flujo de uso
Capacitar usuarios
Definir roles
Operar con datos reales
Medir resultados
Mejorar procesos
Detalles clave
Todos los modulos documentados fueron detectados en rutas, vistas, menus, controladores y permisos del sistema instalado.
El manual cambia de idioma segun el selector del sistema.
Buenas practicas
Actualiza el manual cuando se agreguen modulos nuevos.Usa la funcion imprimir para entregar una version PDF interna.
