Saltar al contenido principal

Enrutamiento de sitios web y multisitio

Una sola iglesia ahora puede servir más de un sitio web distinto, y cada uno puede vivir en un subdominio *.b1.church o en un dominio personalizado totalmente propio de la iglesia. Esta página describe la capa de enrutamiento que está debajo del creador: cómo una solicitud entrante se resuelve en una iglesia y en un sitio específico, el modelo de datos multisitio (el centinela siteId que mantiene funcionando sin cambios todos los sitios preexistentes) y el borde de dominios personalizados: un proxy Caddy administrado por la propia iglesia en EC2 que termina TLS y reescribe cada dominio de la iglesia hacia su upstream *.b1.church. Para lo que realmente se muestra una vez que una solicitud se ha resuelto (el árbol de páginas, secciones y elementos), consulte Creador de sitios web.

Descripción general​

   grace.b1.church              www.gracechurch.org  (dominio personalizado)
(subdominio de b1.church) │
│ ▼
│ ┌──────────────────────────────────────────┐
│ │ Borde Caddy — EC2 3.23.251.61 │
│ │ (proxy.b1.church) │
│ │ • termina TLS (certificado LE por dominio)│
│ │ • reescribe Host → {sub}.b1.church │
│ │ • hace proxy inverso hacia B1App │
│ └────────────────────┬─────────────────────┘
│ Host = {sub}.b1.church
▼ ▼
┌────────────────────────────────────────────────────────────┐
│ B1App src/middleware.ts │
│ • siempre: elimina cualquier x-site enviado por el cliente │
│ (anti-suplantación) │
│ • host interno *.b1.church ⇒ la búsqueda de dominios queda inactiva │
│ • Host personalizado sin Caddy ⇒ búsqueda → establece x-site │
└───────────────────────────┬────────────────────────────────┘
▼ next.config.mjs → primera etiqueta del host → /[sdSlug]/…
┌─────────────────────────────────────────────────┐
│ [sdSlug] · ConfigHelper.load(sdSlug) │
│ GET /membership/churches/lookup/?subDomain=… │
│ → { id, name, subDomain, siteId? } │
│ propaga ?siteId= en cada llamada de contenido: │
│ /content/pages/:id/tree · /globalStyles · │
│ /blocks/public/footer · /links · sitemap │
└─────────────────────────────────────────────────┘

guardar/eliminar dominio (B1Admin Settings→Domains → POST /membership/domains)
└─ CaddyHelper.updateCaddy() de mejor esfuerzo (envuelto, no fatal, 10 s de timeout)
Caddy lee la tabla domains por sí mismo mediante dos endpoints anónimos:
GET /membership/domains/authorize — `ask` de TLS bajo demanda (200 conocido / 404 desconocido)
GET /membership/domains/hostmap — mapa host→{sub}.b1.church (actualización cada 5 min)

Tres reglas se cumplen en toda esta capa:

  1. Un centinela mantiene todo compatible hacia atrás. siteId = '' es el sitio principal. Cada página, bloque, enlace, estilo global y fila de dominio que existía antes de esta función tiene '' y se muestra exactamente igual que antes. Un segundo sitio web es simplemente un conjunto de filas con un siteId no vacío, y cualquier endpoint de contenido llamado sin ?siteId= devuelve el sitio principal: exactamente la misma solicitud de antes, byte por byte.
  2. La resolución se basa en la etiqueta del host y converge. Un subdominio *.b1.church se enruta directamente por su etiqueta del host; un dominio personalizado se reescribe a su etiqueta {sub}.b1.church en el borde Caddy antes de que B1App lo vea (con una búsqueda en base de datos en el middleware que establece un encabezado x-site como respaldo para cualquier Host personalizado sin Caddy). Ambas rutas llegan a la misma ruta [sdSlug] y a la misma llamada a churches/lookup, así que el renderizado posterior es idéntico.
  3. El borde Caddy no tiene estado, sobre una única fuente de verdad. Los dominios personalizados terminan en un proxy Caddy administrado por la propia iglesia en EC2, que reescribe cada dominio hacia su upstream {sub}.b1.church. Al guardar un dominio se dispara una sola llamada CaddyHelper.updateCaddy() de mejor esfuerzo, y Caddy también lee directamente la tabla domains (los endpoints authorize y hostmap de abajo). La tabla es la autoridad: un Caddy inalcanzable nunca puede hacer fallar un guardado.

Resolución del sitio​

Subdominios *.b1.church​

B1App/next.config.mjs reescribe las solicitudes entrantes según el host. Una regla de host con el patrón (?<subdomain>.*?)\..* captura la primera etiqueta del host y reescribe / y /:path* a /{subdomain}: el segmento [sdSlug] del App Router. Así, grace.b1.church/about se convierte en /grace/about.

Dentro de src/app/[sdSlug]/, ConfigHelper.load(sdSlug) (src/helpers/ConfigHelper.ts) llama a GET /membership/churches/lookup/?subDomain={sdSlug}. La respuesta de ChurchController.getBySubDomain tiene ahora dos ramas:

El slug coincide conRespuestaSignificado
churches.subDomain{ id, name, subDomain }Sitio principal de esa iglesia
sites.subDomain{ id, name, subDomain, siteId }Un sitio secundario: el controlador recurre a sites, resuelve la iglesia propietaria y devuelve el slug consultado más el siteId adicional

Ese siteId adicional es lo único que distingue una solicitud de sitio secundario de una principal; todo lo demás del proceso es compartido.

Un slug que no coincide con ninguna de las dos tablas devuelve {} con un 200. ConfigHelper.load trata una respuesta sin id como un sitio desconocido y llama a notFound() de Next, así que un subdominio desconocido recibe un 404 real, en lugar de que cada llamada posterior pida /…/undefined. La ruta de la página del creador también construye su ruta de árbol con pageTreePath() (src/helpers/pageTreePath.ts), que codifica el slug en la URL, de modo que un slug mal formado (barras invertidas, espacios) devuelve 404 en lugar de convertir el 400 de la API en un 500.

Dominios personalizados​

Un dominio propiedad de la iglesia termina en el borde Caddy (descrito abajo), que reescribe el encabezado Host al {sub}.b1.church del sitio antes de hacer proxy hacia B1App. Así, en la ruta normal, B1App recibe un host interno *.b1.church y lo resuelve por su etiqueta exactamente como un subdominio nativo; la búsqueda en base de datos del middleware nunca se activa. src/middleware.ts sigue ejecutándose en cada solicitud, pero con un trabajo permanente y un respaldo:

  1. Siempre: elimina cualquier encabezado x-site enviado por el cliente. Ese encabezado es una entrada de reescritura suplantable y solo se confía en él cuando el propio middleware lo establece; eliminarlo es el trabajo real del middleware detrás de Caddy.
  2. Respaldo, solo para Host no internos: para un Host de dominio personalizado sin Caddy que llegue directamente a B1App sin la reescritura de Caddy, llama a GET /membership/domains/public/lookup/{host} y, si devuelve un subDomain, establece x-site: {subDomain}.b1.church. Detrás de Caddy esta rama queda inactiva, porque el Host ya es *.b1.church.

Los hosts internos (localhost, b1.church y los sufijos .b1.church, .localtest.me, .localhost, .up.railway.app, .vercel.app) omiten por completo la búsqueda, porque ya se resuelven con la reescritura por etiqueta del host, o son hosts de vista previa o de despliegue.

La búsqueda en sí (DomainRepo.loadByName) hace un LEFT JOIN de domains → churches y de domains → sites, y devuelve COALESCE(NULLIF(sites.subDomain,''), churches.subDomain): el subdominio del sitio secundario asignado si el dominio apunta a uno, o si no el de la iglesia. Primero busca el host exacto; si ese host empezaba con www. y no se encontró, reintenta una vez con el dominio raíz sin www.

De vuelta en next.config.mjs, las reglas de reescritura de x-site se colocan antes de las reglas genéricas de host, así que tienen prioridad. x-site: grace.b1.church → primera etiqueta grace → [sdSlug] = grace, y a partir de ahí la resolución es idéntica a la ruta por subdominio (mismo churches/lookup, mismo siteId).

info

El encabezado x-site no es confiable desde el exterior. El middleware elimina incondicionalmente cualquier x-site entrante antes de establecer el suyo, y las reglas de reescritura solo ven el valor que establece el middleware: un cliente no puede forzarse sobre el contenido de otra iglesia enviando un encabezado.

Dos detalles operativos del middleware:

  • Caché. El resultado de cada host (un acierto o un fallo confirmado, nunca un error de red) se guarda en caché durante 10 minutos en un Map en memoria, por instancia serverless.
  • Matcher. El matcher vuelve a incluir deliberadamente /sitemap.xml, /robots.txt y /manifest.webmanifest. Su primer patrón excluye las rutas con punto, lo que de otro modo descartaría esos archivos; se vuelven a agregar para que los archivos SEO/PWA por iglesia de un dominio personalizado también reciban el encabezado x-site.
  • Encabezado canónico. En las páginas de la iglesia, el middleware agrega un encabezado de respuesta Link: <{proto}://{host}{path}>; rel="canonical" que nombra el host desde el que realmente se sirvió la página: subdominio o dominio personalizado (helpers/canonicalLink.ts). Cuando un dominio personalizado llega a B1App a través del proxy Caddy, el host de la solicitud es el subdominio {sub}.b1.church, así que el middleware usa en cambio el dominio del visitante desde X-Church-Host, pero solo después de que /domains/public/lookup/{host} confirma que ese dominio apunta al mismo subdominio (ownsSubdomain()). El enlace canónico, robots.txt y sitemap.xml entonces nombran el dominio personalizado en lugar del subdominio b1.church. Se omite en hosts que no son de la iglesia (b1.church, localhost, *.vercel.app, *.up.railway.app) y en /mobile, /login, /logout y los archivos robots/sitemap/manifest generados.

Sitio web público desactivado​

Una iglesia puede activar Disable Public Website en B1Admin (configuración de contenido a nivel de iglesia hidePublicSite = "true"). El sitio entonces sirve solo sus rutas para miembros:

  • El middleware de B1App busca el subdominio (/membership/churches/lookup y luego /content/settings/public/:churchId) y redirige las solicitudes anónimas de cualquier ruta fuera de la lista permitida a /login?returnUrl={path}{query}. La lista permitida (helpers/publicSite.ts) es /login, /logout, /mobile/*, /register/*, /guest-register y los archivos manifest/robots/sitemap. Solo se guardan en caché las respuestas confirmadas (60 segundos en producción, porque la llamada de revalidación del administrador no puede limpiar este mapa por instancia; sin caché en desarrollo/pruebas). Un error de la API sirve el sitio en lugar de bloquear a todos.
  • Los miembros con sesión iniciada ven el sitio completo. Una solicitud que lleva una cookie jwt no vencida (hasSession() del middleware decodifica el exp del payload sin verificar la firma; es una compuerta suave, no un control de acceso) omite la redirección, así que después de iniciar sesión un miembro regresa a la página que pidió y ve las páginas normales, las páginas integradas (Grupos, Sermones, etc.) y la navegación del encabezado. Los componentes de página y Header ya no verifican hidePublicSite por sí mismos.
  • robots.txt bloquea todo, igual que en los hosts con noindex.
  • API. GET /content/pages/public/:churchId (la lista de páginas del sitemap) devuelve [], así que quienes llaman de forma anónima no pueden listar las páginas.

Propagación de siteId​

ConfigHelper guarda el siteId resuelto en su ConfigurationInterface por solicitud (memorizado con cache() de React) y agrega ?siteId= a las llamadas de contenido que él y los componentes de página hacen, de forma condicional: un siteId vacío (un subdominio de iglesia principal) omite el parámetro por completo. Los endpoints que lo propagan son el árbol de páginas (/content/pages/:id/tree), la lista pública de páginas usada por el sitemap (/content/pages/public/:id), los estilos globales (/content/globalStyles/church/:id), los enlaces de navegación (/content/links/church/:id) y el bloque de pie de página independiente (/content/blocks/public/footer/:id). En la ruta de renderizado normal, el pie de página llega dentro del árbol de páginas (secciones etiquetadas con zone: "siteFooter"), ya obtenido con siteId, así que no hay un hueco de pie de página sin alcance.

El portal de miembros (B1App mobile) queda intencionalmente fuera de esto: loadChurchAppearance.ts resuelve la iglesia mediante churches/lookup, pero lee /settings/public/{id} a nivel de iglesia y nunca propaga siteId; el portal es para toda la iglesia en la v1 (vea más abajo).

Varios sitios web por iglesia​

Modelo de datos​

La nueva tabla membership.sites es deliberadamente pequeña:

ColumnaTipoNotas
idchar(11) PK
churchIdchar(11)Iglesia propietaria
namevarchar(255)Nombre visible (por ejemplo, "Español", "Youth")
subDomainvarchar(45)Índice único: espacio de nombres global (abajo)

El alcance por sitio es entonces una única columna, no nullable, agregada a las tablas de contenido y de dominios:

Tabla (módulo)Columna'' significa
domains (membership)siteId char(11) NOT NULL DEFAULT ''El dominio sirve el sitio principal
pages, links, globalStyles, blocks (content)siteId char(11) NOT NULL DEFAULT ''Sitio principal; y en blocks, '' además significa compartido entre todos los sitios

Dos migraciones agregan todo esto (tools/migrations/membership/2026-07-02_sites.ts, tools/migrations/content/2026-07-02_site_id.ts). Como la columna tiene '' por defecto, cada fila existente conserva el comportamiento actual sin necesidad de rellenar datos.

Espacio de nombres global de subdominios. sites.subDomain comparte un único espacio de nombres con churches.subDomain: un subdominio de sitio nunca puede chocar con un subdominio de iglesia ni con el de otro sitio. Esto se aplica en ambas rutas de guardado: SiteController.save rechaza un slug que coincida con churches o con sites, y ChurchController.validateSave hace lo mismo en sentido inverso. Un índice único en sites.subDomain lo respalda a nivel de base de datos.

La unicidad de páginas se amplió de (churchId, url) a (churchId, siteId, url), de modo que dos sitios de una misma iglesia pueden tener cada uno su propio /about.

Contenido por sitio, con respaldos​

Cada endpoint de lista/árbol de contenido con alcance por sitio acepta un ?siteId= opcional (ausente ⇒ '' = principal): árbol / lista / pública de páginas, lista / por tipo / pie de página de bloques, enlaces (anónimos / filtrados / todos) y estilos globales. Las secciones y los elementos no tienen alcance directo: lo heredan de su página o bloque padre.

Dos cadenas de resolución hacen el trabajo interesante:

  • Estilos globales: sitio → principal → predeterminado. GlobalStyleRepo.loadForChurch(churchId, siteId) devuelve la fila propia del sitio; si un sitio secundario no tiene una, devuelve la fila principal ('') tal cual (conservando el id/siteId del principal, que el cliente usa para la copia al escribir); si tampoco hay una principal, GlobalStyleController devuelve una paleta y fuentes predeterminadas codificadas en el propio código.
  • Bloque de pie de página: gana el específico del sitio, y lo compartido es el respaldo. BlockRepo.loadByBlockType(churchId, "footerBlock", siteId) devuelve las filas compartidas ('') y las específicas del sitio; el resolutor elige el pie propio del sitio si existe, y si no, el compartido. La misma lógica se ejecuta tanto en TreeHelper.insertBlocks (árbol de páginas) como en el endpoint independiente /content/blocks/public/footer/:churchId.

Cascada de eliminación de un sitio​

SiteController.delete (protegido por el permiso Settings→Edit de membership) elimina un sitio secundario en tres pasos:

  1. ContentModuleGateway.deleteSiteContent(churchId, siteId) elimina en cascada todo el contenido que posee el sitio: sus páginas → sus secciones, elementos, pageHistory y posts; sus propios bloques → sus secciones, elementos y pageHistory; sus enlaces y globalStyles. Una guarda se niega a ejecutarse para '': el centinela principal/compartido nunca se elimina en cascada.
  2. DomainRepo.clearSiteId reasigna los dominios del sitio de vuelta al principal (siteId → '') en lugar de borrarlos, de modo que un dominio personalizado sobrevive a la eliminación de un sitio.
  3. Se borra la fila de sites y se resincronizan las rutas de Caddy (de mejor esfuerzo).

Superficie en B1Admin​

CapacidadDóndeMecanismo
Selector de sitiouseSiteSelection + SiteSwitcher (vacío = "Main Website")Lee un parámetro de URL ?site= y lo propaga como ?siteId= en las llamadas a ContentApi. Está presente en las tres áreas de lista de Sitio: Pages, Blocks y Appearance, pero no en los editores de página/bloque, que llevan siteId en el registro
Crear/eliminar sitiosSitesDialog, abierto desde la entrada "Manage websites…" del selectorPOST /membership/sites / DELETE /membership/sites/:id (nombre + subDomain). Protegido por el permiso Settings→Edit de membership (Permissions.settings.edit en el servidor; Permissions.membershipApi.settings.edit en B1Admin). Solo crear/eliminar: no hay interfaz de cambio de nombre en la v1
Asignación de sitio por dominioDomainSettingsEdit en Settings→DomainsUn selector de sitio por fila envía siteId por dominio a /membership/domains. La columna se oculta si la API no devuelve sitios (backend anterior)
Estilos de copia al escribirStylesManager.prepareForSaveCuando la fila de estilos globales cargada tiene un siteId que no coincide con el sitio seleccionado (es decir, la API devolvió el principal heredado como respaldo), elimina el id del principal y establece el siteId actual, forzando una inserción de una nueva fila específica del sitio en lugar de sobrescribir el principal. La misma bifurcación por no coincidencia se aplica al bloque de pie de página del sitio
info

Lo que sigue siendo a nivel de toda la iglesia en la v1 (una elección deliberada de alcance, no un límite del modelo de datos): el blog (BlogPage no tiene selector y carga /posts sin siteId), los widgets del sitio (banner de anuncios y lanzador), las redirecciones, el logotipo / GA4 / configuración de la iglesia y el portal de miembros (B1App móvil). Nótese que esto no es "toda la sección Apariencia": los estilos globales de un sitio secundario (paleta, fuentes, tipografía, espaciado, navegación, CSS personalizado) sí son por sitio mediante la ruta de copia al escribir descrita arriba; solo los subpaneles de banner/lanzador/redirecciones/logotipo de la página Apariencia siguen siendo de toda la iglesia.

Dominios personalizados: borde Caddy (plan de configuración estática)​

info

Dirección revisada el 2026-07-02. Un plan anterior para mover el alojamiento de dominios personalizados a dominios administrados por Vercel fue cancelado, y todo el código de registro de dominios en Vercel (VercelHelper, sus variables de entorno vercelToken/vercelProjectId/vercelTeamId, los parámetros de SSM y las entradas de salud) se eliminó de la API. El proxy Caddy administrado por la propia iglesia en EC2 se mantiene como borde permanente para dominios personalizados. El único trabajo pendiente es interno: cambiar la configuración de ejecución de la API de administración de Caddy por una configuración estática que sobreviva a los reinicios.

El borde​

Cada dominio personalizado de una iglesia apunta su DNS a una sola máquina EC2, 3.23.251.61, también accesible como proxy.b1.church. La pantalla Settings→Domains de B1Admin indica a las iglesias agregar un A del dominio raíz hacia 3.23.251.61 o un CNAME hacia proxy.b1.church. Caddy termina TLS con un certificado de Let's Encrypt por dominio, reescribe el encabezado Host al upstream {sub}.b1.church del dominio y hace proxy inverso hacia B1App, que luego lo enruta por etiqueta de host como cualquier subdominio nativo (vea Dominios personalizados más arriba).

El mapeo de upstream proviene de DomainRepo.loadPairs, cuyo destino hace COALESCE del subdominio del sitio asignado, de modo que un dominio hace proxy hacia el sitio secundario correcto, y si no, hacia el principal de la iglesia:

CONCAT(COALESCE(NULLIF(s.subDomain,''), c.subDomain), '.b1.church:443')  AS dial
WHERE d.domainName NOT LIKE '%www.%'

Las filas www.* se excluyen del mapa; Caddy sirve www.{host} mediante una redirección 302 hacia el dominio raíz.

Dos endpoints anónimos alimentan el borde​

DomainController expone dos endpoints de solo lectura sin autenticar que la máquina consume directamente; son anónimos por necesidad, ya que el borde los consulta antes de que exista cualquier contexto de iglesia:

EndpointDevuelveFunción
GET /membership/domains/authorize?domain=200 si el dominio, o, para un fallo de www., su dominio raíz, existe en domains; 404 en otro caso (incluido un domain vacío)El ask de TLS bajo demanda de Caddy: el control contra abusos que decide si emitir un certificado para un SNI entrante
GET /membership/domains/hostmaptext/plain, una línea ordenada {domain} {sub}.b1.church por cada dominio enrutableEl archivo de mapa host→upstream que la máquina actualiza periódicamente

authorize reutiliza DomainRepo.loadByName (host exacto, y luego un reintento único de www.→dominio raíz); hostmap reutiliza loadPairs, por lo que es consciente del sitio y excluye www.*, idéntico a las rutas del proxy, y solo quita el sufijo :443.

Guardar/eliminar dominio: un envío de mejor esfuerzo​

DomainController.save escribe las filas de domains y luego hace una única llamada de mejor esfuerzo a CaddyHelper.updateCaddy(), envuelta en un try/catch que registra (console.error) y descarta el error; delete hace lo mismo (lo que además corrigió un antiguo error de ruta obsoleta al eliminar), como también lo hace la eliminación de sitios secundarios (SiteController.delete). updateCaddy tiene además un límite de 10 s de timeout de Axios, así que un Caddy inalcanzable o detenido nunca puede devolver un 500 al guardar un dominio: la tabla domains es la fuente de verdad.

Estado actual: configuración estática, sin estado en ejecución​

La máquina (un EC2 de Windows detrás de la IP elástica permanente) ejecuta Caddy con un Caddyfile estático: TLS bajo demanda cuyo ask apunta a /membership/domains/authorize, más un archivo de mapa host→upstream que una tarea programada actualiza cada 5 minutos desde /membership/domains/hostmap, y que termina con un caddy reload controlado. La configuración sobrevive a los reinicios sin ningún estado en ejecución (sin el proceso de volver a cargarla manualmente), y un SNI desconocido recibe un rechazo de TLS (no se emite ningún certificado para un host que authorize rechaza), mientras que un host autorizado pero aún no mapeado (un dominio recién creado dentro de la ventana de sincronización) recibe un 404 limpio. Los dominios nuevos se vuelven enrutables en unos 5 minutos después de guardarlos; sus certificados se emiten en la primera visita. Construcción y configuración, operación y trampas probadas en la práctica: Proxy de dominio personalizado con Caddy.

Envío heredado en tiempo de ejecución: ruta de reversión, eliminación pendiente​

CaddyHelper (módulo membership) todavía puede controlar Caddy mediante su API de administración en caddyHost:caddyPort (SSM caddyHost/caddyPort; no hace nada si no están configurados; se muestra en el grupo Integrations de ServerHealthController): updateCaddy() hace PATCH de un arreglo completo de rutas, y initializeCaddy() más los endpoints GET /membership/domains/caddy/init / GET /membership/domains/caddy reconstruyen desde cero un servidor configurado en ejecución. La configuración de ese modo vivía solo en la memoria de Caddy: la pérdida de memoria al reiniciar que esta arquitectura reemplazó. La maquinaria permanece únicamente como ruta de reversión y está programada para eliminarse cuando la máquina estática lleve tiempo estable; el envío de updateCaddy() de mejor esfuerzo al guardar o eliminar un dominio es un no-op inofensivo frente a la máquina estática (su API de administración solo es accesible desde localhost).

Páginas relacionadas​

  • Proxy de dominio personalizado con Caddy: la máquina del borde en sí: configuración desde cero, servicio WinSW, tarea de sincronización del mapa y trampas operativas
  • Creador de sitios web: el árbol de páginas/secciones/elementos, los renderizadores, el blog, el SEO y la generación con IA (lo que se muestra una vez que una solicitud se ha resuelto a una iglesia/sitio)
  • Endpoints de Content: la superficie REST para páginas, bloques, enlaces y estilos globales, todos ahora sensibles a ?siteId=
  • B1App: la aplicación Next.js que aloja el middleware y el enrutamiento [sdSlug]
  • Despliegue de aplicaciones web: cómo se despliega B1App en Vercel