Conceptos clave

Hay un puñado de conceptos que aparecen en toda la documentación. Tenerlos claros desde el inicio ahorra confusiones más adelante. Para definiciones cortas de términos puntuales, consulte el Glosario bilingüe.

Tenant

Un tenant es la unidad máxima de aislamiento en Ministrium. En la práctica, un tenant equivale a una iglesia: sus miembros, sus donaciones, sus permisos y sus reportes están separados de los de cualquier otra iglesia en la plataforma.

El aislamiento es estructural, no cosmético: lo aplica Postgres con Row-Level Security antes de que la query devuelva resultados. Aunque hubiera un error de programación que olvidara filtrar por tenant, la base de datos seguiría sin devolver filas de otra iglesia. Ver Aislamiento entre iglesias.

Iglesia

La iglesia es la organización cristiana que contrata Ministrium. Tiene datos legales (nombre, dirección, RFC o EIN), branding (logo, colores, dominio), suscripción (plan, ciclo de facturación) e idioma principal (ES o EN). Cada iglesia es exactamente un tenant.

Una iglesia puede tener uno o varios campus. Esto importa: si su organización es una denominación que agrupa varias iglesias jurídicamente independientes, cada iglesia es su propio tenant aparte (no un campus).

Campus

Un campus es una sede física de la iglesia. Toda iglesia tiene al menos uno (el campus principal). Las iglesias con varios campus operan cada uno con autonomía: su propio kiosko de check-in, su propia asistencia, sus propias campañas de comunicación, sus propios líderes locales.

El campus es la unidad natural de filtrado. La mayoría de los reportes, listas de miembros y vistas operativas se filtran automáticamente por el campus al que pertenece el usuario que está mirando, salvo que tenga permiso para ver varios o todos.

Miembro

Un miembro es una persona que la iglesia reconoce como parte formal de su comunidad. La definición exacta depende de cada iglesia (algunas exigen bautismo, otras un curso de membresía, otras una declaración explícita), pero a nivel de plataforma un miembro es alguien con ficha completa, asignado a un hogar y a un campus, con estado Activo, Inactivo o Trasladado.

Prospecto

Un prospecto es alguien que tiene relación con la iglesia pero todavía no es miembro: típicamente un visitante reciente o alguien capturado en un evento de evangelismo. Los prospectos viven en el pipeline de asimilación, una secuencia configurable de etapas (visitante → contacto → miembro nuevo → miembro activo) por las que el equipo pastoral los acompaña hasta que se convierten en miembros.

La distinción entre prospecto y miembro permite reportes operativos honestos: la iglesia ve cuántos visitantes recibió este mes, cuántos avanzaron de etapa y cuántos se estancaron.

Hogar

Un hogar es la unidad familiar a la que pertenece un miembro: padres, hijos, otras personas que viven en la misma dirección. Ministrium consolida la ficha por hogar, lo que permite ver de un vistazo si toda la familia asistió al culto, si hay niños registrados en check-in y cuál es la donación combinada del hogar.

Los hogares no son rígidos: un mismo miembro puede pertenecer a un hogar primario y, opcionalmente, a un hogar secundario (por ejemplo, hijos con padres separados que asisten a ambas casas).

Rol

Un rol es lo que un usuario puede hacer dentro de la iglesia. Ministrium define 9 roles funcionales (admin, pastor, supervisor, secretaria, contador, finanzas, líder de ministerio, líder de célula, miembro) más un rol técnico interno (super_admin) que solo usa el equipo de Ministrium para soporte. Ver Roles y permisos para el detalle.

Alcance por campus

Cada usuario tiene un rol y, opcionalmente, un alcance por campus que limita lo que puede ver:

• Sin restricción → ve todos los campus de la iglesia.
• Restringido a un campus → solo ve ese campus.
• Restringido a varios campus → ve los campus listados (típico para supervisores de zona).

El alcance se aplica estructuralmente: la base de datos filtra por campus antes de devolver resultados. No es posible ver datos fuera del alcance asignado, ni siquiera por error.

Auditoría

La auditoría es el log inmutable de cada acción crítica que ocurre en la plataforma: quién hizo qué, sobre qué entidad, cuándo y desde dónde. Es append-only: nadie, ni siquiera el equipo de Ministrium, puede modificar entradas pasadas. Se conserva por 7 años en cumplimiento con regulaciones financieras. Ver Auditoría y logs.

Batch contable

Un batch es un grupo de donaciones cerrado para fines contables: típicamente todas las donaciones recibidas en una fecha o en un servicio. Cerrar un batch lo congela: las donaciones del batch ya no se editan y los recibos fiscales se emiten contra esa cifra. Los batches se sincronizan con QuickBooks como un solo asiento agregado o como detalle por donación, según preferencia.

Donación recurrente

Una donación recurrente es un compromiso del donante de aportar una cantidad fija con cierta frecuencia (semanal, quincenal, mensual). Stripe Connect cobra automáticamente en cada ciclo, y Ministrium genera el recibo fiscal correspondiente. Las recurrencias fallidas (tarjeta vencida, fondos insuficientes) disparan automáticamente una secuencia de reintento y notificación al donante.

Próximos pasos

• Glosario bilingüe — definiciones cortas de los términos clave en ES/EN.
• Quick Start — ponga estos conceptos en práctica creando una iglesia de prueba.
• Roles y permisos — el detalle de qué puede hacer cada rol.