El cliente
La Parroquia Nuestra Señora de la Reconciliación está ubicada en La Molina, Lima. Como cualquier organización con operación administrativa real, gestiona servicios litúrgicos (bautismos, matrimonios, misas, constancias), campañas sociales, registros financieros, múltiples colaboradores con distintos roles, y la responsabilidad de mantener trazabilidad para auditoría interna.
El desafío
Antes del sistema, el registro de cada servicio se hacía en cuaderno físico — proceso lento, propenso a errores y sin trazabilidad para auditoría. La campaña anual "Cajas del Amor" (asignación de cajas a familias beneficiadas, registro de devoluciones y excedentes) se manejaba en hojas sueltas. Los cobros con métodos diversos (efectivo, Yape, Plin, transferencia, tarjeta) se conciliaban a mano. Y todo esto operado por múltiples colaboradores — sacerdote, supervisor, operadores de servicios, operadores sociales — cada uno con responsabilidades y nivel de acceso distintos.
La parroquia necesitaba un sistema que digitalizara toda esta operación sin perder la trazabilidad que una institución de su naturaleza exige.
La solución
Construimos un ERP de gestión parroquial a medida con modelo de roles y permisos granular (RBAC), que cubre el ciclo completo: registro de servicios litúrgicos con pagos múltiples, emisión de comprobantes correlativos por serie en impresora térmica, gestión de feligreses, control de la campaña "Cajas del Amor" (familias beneficiadas, asignación, devoluciones, excedentes), reportes contables y un panel de auditoría con trazabilidad completa de cada operación.
El sistema reemplazó un proceso manual de minutos por un flujo de segundos — con comprobante impreso al instante — y eliminó por completo la dependencia del cuaderno físico.
Funcionalidades destacadas
- Registro de servicios parroquiales con pagos múltiples (efectivo, Yape, Plin, transferencia, interbancario, tarjeta) e impresión de tickets en impresora térmica
- Comprobantes PDF de 80mm optimizados para impresoras térmicas Epson TM-T20III, con QR de verificación y diseño compacto
- Búsqueda automática de DNI/RUC vía APIs externas (APISPeru / ApisNetPe), con caché local para feligreses recurrentes
- Etiquetas con código de barras para identificación física de las cajas de la campaña
- Reportes contables con exportación a Excel y filtros por fecha, método de pago, tipo de servicio y usuario operador
- Anulación auditable: ningún registro se borra; las anulaciones quedan trazadas (motivo, usuario, timestamp) y se reflejan en KPIs y reportes
- Backups automáticos de BD con purga selectiva y respaldo previo de seguridad
- Filtrado por usuario operador: cada colaborador solo ve los registros que él generó, mientras el administrador ve la totalidad
Stack técnico
Frontend: React 18 + Vite · TailwindCSS · React Router · Axios · ExcelJS · qrcode
Backend: Node.js + Express · MariaDB / MySQL2 (con pooling) · PDFKit (tickets térmicos a medida) · JWT (autenticación stateless) · bcrypt · sistema propio de RBAC con caché de permisos en memoria
Integraciones externas: APISPeru y ApisNetPe (consulta DNI/RUC en RENIEC y SUNAT) · impresora térmica Epson TM-T20III (driver Windows + comandos ESC/POS embebidos en PDF)
Infraestructura
- VPS Contabo (Ubuntu Linux)
- Nginx como reverse proxy y servidor estático del frontend
- Let's Encrypt + Certbot para certificados SSL con renovación automática
- forever como process manager del servicio Node
- MariaDB con zona horaria configurada en UTC-5 (Lima)
- HestiaCP para administración de subdominios
- Despliegue continuo desde repositorio GitHub privado
Resultados
- Sistema en producción atendiendo el registro diario de servicios y comprobantes
- Más de 6 roles operativos con permisos diferenciados, escalable a cualquier número de colaboradores
- Trazabilidad completa de operaciones financieras para auditoría interna
- Reducción del tiempo de registro de minutos a segundos, con comprobante impreso al instante