Habemus EcclesiamCentro de ayuda
Web ↗ API ↗
Base de conocimiento · v1

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úblicahabemusecclesiam.com: cualquiera navega el producto y la página pública de cada parroquia (sin cuenta).
  • Aplicacióndespacho.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.

  1. Crear cuenta / entrar: desde despacho.habemusecclesiam.com (o el botón "Crear cuenta" de la web). Se puede entrar con correo o con Google.
  2. 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.
  3. Panel de Inicio: aterrizas en el resumen del día con el buscador global y los accesos rápidos.
La primera vez, un breve onboarding ayuda a completar los datos de la institución (nombre, logo, sello) que luego aparecen en los documentos.

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.

RolPara qué sirve
Propietario (owner)Control total de la institución, facturación y equipo.
GeneralTrabajo 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 virtualAcceso 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.

Pantalla de Inicio
Inicio de una parroquia: saludo, buscador global, accesos rápidos y resumen del día.

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

Para el chatbot: "buscar a alguien" = usar el buscador global de Inicio; no se busca personas dentro de "Libros".

Despacho Módulo estrella

El corazón del trabajo parroquial: intenciones de misa, solicitudes y libros, en una pantalla con tres pestañas.

Despacho · Libros
Pestaña "Libros" del Despacho: los libros sacramentales agrupados por tipo, con su uso.

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

P: ¿Dónde está el horario de misas? · R: Dentro de Intenciones.
P: ¿La diócesis emite actas? · R: No; usa Solicitudes como buzón de trámites.
Sinónimos: «partida» = certificado/acta · «intención» = misa por alguien · «digitalizar» = OCR/escanear · «libro» = registro sacramental.

Comunidad Módulo

El padrón vivo de la parroquia: personas, grupos y catequesis.

Comunidad · Personas
Directorio de personas con grupos (Cáritas, Coro, Biblia, Liturgia) e índice A–Z.

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

Sinónimos: «padrón» = directorio de personas · «feligrés» = persona de la comunidad · «catequesis» = iniciación cristiana · «onomástica» = santo.

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.

Billetera · Huchas y proyectos
Huchas y proyectos: campañas con meta y plazo que se publican en el portal público.

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

Sinónimos: «hucha» = proyecto/destino del donativo · «TPV» = datáfono · «certificado de donativo» = recibo para desgravar.

Estadísticas · Status Animarum Módulo

La memoria anual de la parroquia, que se llena casi sola.

Estadísticas · Status Animarum
Memoria anual: asistencia a misa, cifras que vienen de los grupos de Comunidad y otros datos.

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.

Ajustes
Centro de Ajustes: Mi parroquia, Conexiones, Billetera y Facturación/soporte.

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).

Portal · Directorio público
Directorio público de parroquias verificadas en habemusecclesiam.com.

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

Sinónimos: «portal» / «perfil público» / «tótem» = página pública de la parroquia · «link público» = enlace del perfil.

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.

TipoUso
VolanteNota simple para gestiones internas.
PartidaCertificado oficial del sacramento.
Partida literalTranscripción literal del acta.
RecordatorioDocumento conmemorativo.
Quién certifica: solo los Encargados de Archivo (personas del equipo con ese rol) aparecen en el desplegable de certificador. Se configuran en Ajustes › Responsables y firmas.
RGPD / apostasía: si el titular pidió su baja, la partida no se entrega salvo confirmación explícita del Encargado de Archivo, y esa excepción queda registrada.

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}

Sinónimos: «cancillería» = verificación de documentos · «código HE» / «QR» = sello verificable · «comprobar partida» = verificar documento.

Arquitectura e infraestructura Técnico

Cómo está construido y desplegado (resumen para el equipo técnico).

Backend
Laravel 13 · PHP 8.4 · MySQL 8 · Sanctum (auth) · Cashier/Stripe.
Frontend
React 19 + TypeScript + Vite + Tailwind (SPA servida por el mismo Laravel).
PDF
dompdf y snappy (wkhtmltopdf). Documentos con código HE + QR.
OCR
Digitalización de libros con IA para extraer el texto de fotos.
Infra
Docker en Coolify (VPS). Proxy con HTTPS Let's Encrypt automático.
Dominios
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».)

Para el chatbot: preguntas de "cómo desplegar", "dónde está el servidor" o "cómo se hace una copia" se responden desde el manual de migración/despliegue del equipo, no desde el uso del producto.

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