Cómo funciona Habemus Ecclesiam
El compañero inteligente para parroquias, diócesis e instituciones de la Iglesia: digitaliza libros sacramentales, emite certificados verificables, gestiona la comunidad y recibe donativos con transparencia.
Esta documentación describe cada módulo por dentro y por fuera. Está pensada para que la use el equipo, los usuarios y un chatbot de soporte (se puede indexar y responder citando el módulo).
Introducción General
Qué es la plataforma, para quién y cómo está organizada.
Habemus Ecclesiam es una plataforma multi-institución: cada parroquia, diócesis o institución tiene su propio espacio con sus libros, su comunidad y su billetera. Se accede de dos formas:
- Web pública — habemusecclesiam.com: cualquiera navega el producto y la página pública de cada parroquia (sin cuenta).
- Aplicación — despacho.habemusecclesiam.com: el panel privado donde se trabaja (login, libros, comunidad, billetera…).
Según el tipo de institución cambian los módulos visibles: una parroquia emite actas (Despacho), mientras una diócesis o institución usan "Solicitudes" como buzón de trámites y "Estadísticas" para su memoria.
Primeros pasos Onboarding
Crear cuenta, entrar y elegir con qué institución trabajas.
- Crear cuenta / entrar: desde despacho.habemusecclesiam.com (o el botón "Crear cuenta" de la web). Se puede entrar con correo o con Google.
- Institución activa: si tienes acceso a varias, se elige la institución con la que trabajas; el resto de módulos se filtran por ella.
- Panel de Inicio: aterrizas en el resumen del día con el buscador global y los accesos rápidos.
Roles y accesos Permisos
Quién puede ver y hacer qué dentro de una institución.
Los permisos se asignan por rol dentro de cada institución. Un usuario puede tener distinto rol en distintas instituciones.
| Rol | Para qué sirve |
|---|---|
| Propietario (owner) | Control total de la institución, facturación y equipo. |
| General | Trabajo diario: despacho, comunidad, billetera… |
| Gestor (manager) | Gestión ampliada según configuración. |
| Encargado de Archivo (filemanager) | Responsable de los libros y quién puede certificar documentos (firma las partidas). |
| Asistente virtual | Acceso acotado para tareas asistidas. |
Los accesos compartidos (p. ej. compartir un libro o una estadística con la diócesis) se gestionan en Ajustes › Accesos compartidos.
Inicio Módulo
El panel de bienvenida: resumen del día y buscador global.

Qué encuentras
- Buscador global: busca personas, actas, libros o solicitudes desde un único campo.
- Accesos rápidos: Emitir certificado, Registrar donativo, Biblioteca, Comunidad.
- Resumen de hoy: solicitudes pendientes, donativos del mes, sacramentos del año.
- Modo litúrgico y lecturas del día.
Rutas: /dashboard
Despacho Módulo estrella
El corazón del trabajo parroquial: intenciones de misa, solicitudes y libros, en una pantalla con tres pestañas.

1) Intenciones de misa
Qué misa, a qué hora y por quién se ofrece. El horario de misas y los avisos parroquiales viven aquí. Los fieles también pueden pedir una intención desde el portal público.
2) Solicitudes
Lo que pide el feligrés (una partida/certificado) y su estado. Llegan solas desde el portal o se crean a mano. Si el registro no está digitalizado, se genera desde "Buscar acta".
3) Libros (Biblioteca)
Los libros sacramentales digitalizados y sus actas. Desde un acta se emite el certificado (PDF verificable con código HE + QR). "Nuevo libro" crea un libro; la digitalización (OCR) extrae el texto de una foto para no teclear.
Rutas: /despacho · /library · /library/:id · /library/:id/digitize
Comunidad Módulo
El padrón vivo de la parroquia: personas, grupos y catequesis.

Personas
Listado por letra con buscador. Cada persona pertenece a la institución directamente o porque tiene un acta en ella (así, quien tiene partida aparece aunque venga de libros antiguos). Desde su ficha se ve/edita su catequesis y se puede emitir un PDF de pertenencia.
Grupos
Crear grupos (catequesis, coro, pastoral…) y asignar personas; sirve para filtrar y para alimentar la memoria anual (Estadísticas).
Tarjeta «Hoy»
Onomásticas (santo del día) y cumpleaños de la gente, con un botón para felicitar por correo.
Rutas: /community · /community/:id
Solicitudes / Trámites Módulo
El buzón de peticiones: partidas que piden los fieles y trámites de diócesis/institución.
En parroquia, las solicitudes viven dentro del Despacho. En diócesis e institución es su buzón principal (cancillería, tribunal, contacto): las peticiones de su portal caen aquí con su estado (recibida, en proceso, lista…). Cuando está lista, se avisa al fiel con enlace de descarga.
Rutas: /requests
Billetera Módulo
El dinero de la institución, ordenado y transparente.

Qué gestiona
- Donativos: entran solos desde el portal (tarjeta, Bizum, transferencia, Zelle…) o se registran a mano; con su destino (hucha/proyecto) y datos del donante.
- Huchas y proyectos: campañas de recaudación que aparecen como tarjetas y se publican en el portal.
- Banco (lectura): conectar la cuenta para cuadrar movimientos.
- Fiscal: justificantes y modelos (p. ej. Modelo 182).
Los canales de cobro se activan en Ajustes › Cobros; solo se ofrecen al fiel los que la parroquia haya activado.
Rutas: /wallet · /fiscal
Estadísticas · Status Animarum Módulo
La memoria anual de la parroquia, que se llena casi sola.

La memoria (Status Animarum) se rellena a partir de los libros (sacramentos del año) y de los grupos de Comunidad. Solo hay que apuntar la asistencia a misa y confirmar las cifras. Se exporta en PDF y Excel.
Rutas: /statistics
Mercado Módulo
Servicios y recursos para la institución.
Espacio donde la institución encuentra servicios/recursos ofrecidos dentro del ecosistema Habemus. (Módulo en evolución.)
Rutas: /market
Recompensas Módulo
Incentivos por el uso y la digitalización.
Reconocimientos/beneficios asociados a la actividad de la institución (p. ej. digitalizar libros, completar la comunidad). (Módulo en evolución.)
Rutas: /rewards
Ajustes Configuración
Todo lo de la institución, ordenado por temas.

Mi parroquia
- Datos, logo y sello: nombre, dirección, logo, sello y acreditación (aparecen en los documentos).
- Formulario de Actas: catálogos de ministros, lugares, catequistas, etapas y grupos.
- Horario de misas: temporadas, confesiones y excepciones.
- Avisos parroquiales: se muestran en Intenciones y en el portal.
- Responsables y firmas: quién entra y quién puede firmar (Encargados de Archivo).
Conexiones
- Plantillas y marca: el diseño de los documentos.
- Integraciones: Claude (IA), Google, WhatsApp, Telegram y otras.
- Comunicación: plantillas de mensajes por email y WhatsApp.
- Accesos compartidos: compartir libros, billetera, comunidad o estadística con la diócesis u otra institución.
Billetera
- Cobros: conectar Stripe, PayPal, MercadoPago o cobros manuales.
- Banco: conectar la cuenta (lectura) para cuadrar movimientos.
- Huchas y proyectos · Fiscal (Modelo 182, recibos deducibles).
Facturación y soporte
Facturación: plan, método de pago y consumo. Soporte: contacto de ayuda.
Rutas: /settings · /institution · /act-form · /integrations · /communication · /appearance · /billing · /team · /shared-access · /web-profile · /support
Diócesis y Archivo diocesano Institución
Módulos específicos para diócesis / archivos diocesanos.
Cuando la institución es una diócesis o archivo diocesano, en lugar de emitir actas ve: Estadísticas de la diócesis (agregados de sus parroquias) y el Archivo diocesano (fichas de sus parroquias, con lo que cada una haya compartido vía Accesos compartidos).
Rutas: /diocese · /diocese-archive
Portal público Público
La cara pública: web del producto y página de cada parroquia (sin cuenta).

Web pública (habemusecclesiam.com)
Navegación: Inicio, Despacho Online (Directorio, Gestoría), Herramientas (Cancillería, Escáner), Servicios (Planes, Brújula, Programa Nonprofit). Los botones Entrar / Crear cuenta llevan a la aplicación (despacho).
Perfil público de la parroquia (tótem)
Cada parroquia tiene su página /parish/{slug} con accesos para: pedir una partida, apuntar una intención de misa, inscribirse a catequesis y hacer un donativo. Todo cae ya clasificado en el despacho, con avisos automáticos. Un único enlace y un QR descargable.
Rutas públicas: /directorio · /gestoria · /planes · /brujula · /nonprofit · /parish/:slug
Emisión de documentos (PDF) Certificados
Cómo se generan partidas, volantes y demás documentos verificables.
Desde un acta (o desde el editor de actas) se abre «Descargar documento»: se elige el tipo (Volante, Partida, Partida literal, Recordatorio…) y el Encargado de Archivo que certifica. El sistema genera un PDF con el membrete de la parroquia y su código HE + QR verificable.
| Tipo | Uso |
|---|---|
| Volante | Nota simple para gestiones internas. |
| Partida | Certificado oficial del sacramento. |
| Partida literal | Transcripción literal del acta. |
| Recordatorio | Documento conmemorativo. |
Ruta API: GET /api/certificates/{código}/pdf
Verificación · Cancillería Público
Comprobar que un documento es auténtico, con el código HE o el QR.
Cada documento lleva un código HE y un QR. En la Cancillería online del portal, quien recibe el documento teclea el código (o escanea el QR) y ve «Documento auténtico» con el tipo, el número y la institución emisora — o «no válido» si no consta. Es público y no expone datos internos.
Rutas: /cancilleria · /verificar · /verify/{código} · API GET /api/public/document-verifications/{código}
Arquitectura e infraestructura Técnico
Cómo está construido y desplegado (resumen para el equipo técnico).
Laravel 13 · PHP 8.4 · MySQL 8 · Sanctum (auth) · Cashier/Stripe.
React 19 + TypeScript + Vite + Tailwind (SPA servida por el mismo Laravel).
dompdf y snappy (wkhtmltopdf). Documentos con código HE + QR.
Digitalización de libros con IA para extraer el texto de fotos.
Docker en Coolify (VPS). Proxy con HTTPS Let's Encrypt automático.
web pública (apex + www) · app (despacho) · api (futuras apps móviles).
Multi-institución
Cada petición se acota a la institución activa; los permisos van por rol dentro de cada institución.
Despliegue
El código se lleva a la rama staging y se reconstruye en Coolify (build con Dockerfile).
Los certificados HTTPS se emiten y renuevan solos al asignar el dominio. (Detalle completo en el manual
«Proceso de migración y despliegue».)
Administración · Panel Maestro Interno
La consola del operador de la plataforma (no de las parroquias).
El superadministrador de Habemus dispone de un Panel Maestro para operar la plataforma: Inicio, Solicitudes, Gestoría, Soporte, Acreditaciones, Instituciones, Usuarios, Negocio, Operación y Ajustes. No es visible para las instituciones.
Rutas: /admin · /admin/:sección