Estructura organizacional

Cada iglesia se organiza de forma diferente. Una iglesia que se reúne en un local pequeño tiene solo Ministerios. Una red multi-sede abarca regiones, sedes, centros y células. Un pastor de campus usa Departamento → Ministerio. No hay un modelo fijo de tres niveles en GCM — tú nombras y anidas tus niveles para que coincidan con cómo tus miembros ya hablan.

Este módulo es lo que hace eso posible. Impulsa los alcances de líderes, los desgloses de asistencia, los reportes de donaciones, la vista de mapa y casi cada filtro en cada lista a lo largo de la app.

¿Ya te sientes cómodo con lo básico?

La guía de inicio rápido recorre la configuración inicial en 5 minutos. Esta sección va más a fondo — cada pantalla, cada caso límite, cada decisión que las tablas subyacentes te permiten tomar.

Tres cosas que conviene tener claras

GCM divide el modelo organizacional en tres conceptos que viven en tres tablas distintas. Se parecen en la UI; se comportan de forma muy distinta en los reportes.

Concepto	Qué es	Tabla	Ejemplo
Nivel	El nombre de un nivel en tu jerarquía	org_level_definitions	"Sede" (nivel 1), "Centro" (nivel 2), "Célula" (nivel 3)
Unidad	Una instancia real en un nivel	org_units	Sede Centro, Centro Norte, Célula Acacia
Asignación	Un miembro que pertenece a una unidad	member_unit_assignments	Jane Doe → Célula Acacia

Los líderes y el personal tienen su propia tabla — user_unit_assignments_v2 — que controla qué pueden ver, no a qué pertenecen. Un pastor es miembro de una célula y el pastor de toda una sede; los dos son registros separados.

Cuándo necesitas este módulo

No siempre necesitas una jerarquía. Una iglesia en casa de una sola sede puede ignorar el módulo por completo y agrupar a todos en Ministerios. Empiezas a necesitarlo cuando se cumple alguna de estas condiciones:

• Tienes más de una ubicación física y necesitas filtrar miembros o asistencia por sede.
• Tienes pastores cuya vista de miembros debe ser más reducida que la del pastor principal.
• Tus reportes necesitan consolidarse — ej. "asistencia dominical por sede, desglosada por centro".
• Imprimes demografía por región para las reuniones de junta.
• Tu vista de mapa debe marcar unidades, no solo miembros.

Si nada de esto aplica, salta a Miembros y vuelve más tarde.

La regla de N niveles

GCM soporta hasta 10 niveles de profundidad. El nivel 1 siempre es obligatorio; los niveles 2 al 10 son opcionales y cada uno puede activarse o desactivarse por organización. El modelo es estrictamente en forma de árbol — cada unidad tiene exactamente un padre (excepto el nivel 1, que no tiene ninguno).

La regla para los miembros es una unidad por nivel. Un miembro puede pertenecer a una sede y una célula, nunca a dos sedes al mismo tiempo. Esto mantiene los consolidados sin ambigüedad: cuando sumas la asistencia de una sede, nadie se cuenta dos veces.

Para el personal la regla es distinta — un líder puede ser asignado a varias unidades del mismo nivel (un pastor multi-campus, un tesorero regional). Su alcance visible es la unión de sus unidades asignadas y cada descendiente.

Orden de configuración

Configura una vez, en este orden, y evitarás la mayor parte del retrabajo que afecta a las iglesias que se lanzan directamente a invitar usuarios:

1. Define tus niveles — nombra los niveles que tu iglesia realmente usa.
2. Crea tus unidades — una fila por cada lugar físico o lógico.
3. Conecta las relaciones padre-hijo — anida cada unidad bajo su padre.
4. Asigna miembros — vincula cada miembro a la unidad hoja a la que pertenece.
5. Asigna líderes y pastores — limita los usuarios a las unidades que supervisan.
6. Archiva lo que cambia — cuando un campus cierra o una célula se divide, archiva — no elimines.

Permisos

Acción	Admin	Pastor	Pastor de célula	Miembro
Definir niveles	sí	sí	no	no
Crear / editar / archivar unidades	sí	sí	no	no
Asignar miembros a una unidad	sí	sí	sí (solo unidades asignadas)	no
Asignar un líder a una unidad	sí	sí	no	no
Ver los miembros de una unidad	sí	sí	sí (subárbol asignado)	solo su unidad

La regla del "subárbol asignado" se aplica en la base de datos vía Row-Level Security sobre la función current_org_id() y el RPC user_visible_unit_ids. Incluso si un pastor inspeccionara las llamadas de red de su navegador y consultara directamente, la base de datos rechazaría las filas fuera de su alcance.

Qué se consolida hacia dónde

Una vez que existe tu jerarquía, cada conteo que menciona una unidad sabe cómo cascadear:

• Conteo de miembros en una sede = miembros directamente en la sede + miembros en cada descendiente.
• Asistencia en una sede el domingo = la unión de la asistencia de cada reunión celebrada por cualquier descendiente.
• Total de donaciones para un centro = donaciones registradas contra cualquier miembro cuya unidad esté en el subárbol del centro.
• Pines de mapa = cada unidad con map_location definida, codificada por color según el nivel.

Por eso importa el nivel en el que pones a un miembro. Poner a todos en el nivel 1 porque es "más fácil" anula la cascada — los totales de sede serían iguales a los totales globales y los centros quedarían vacíos.

Migrar desde una estructura plana

Los clientes existentes de GCM que empezaron antes de que llegara N-niveles estaban en un modelo legado de tres niveles (sede / centro / bascenta). Ese modelo desapareció — tus filas existentes fueron elevadas a org_units durante la migración y las definiciones de nivel se preservaron tal cual. Si estás empezando desde cero hoy no tienes que pensar en esto; si estás re-arquitecturando, consulta Migrar de una estructura plana a N niveles.

Próximos pasos

• Define tus niveles — la base de todo lo demás.
• Crea tu primera unidad — tu registro de nivel 1.
• Asigna miembros — vincula a las personas al árbol.