Пријавите се на главни садржај

Рутирање веб-сајтова и више сајтова

Једна црква сада може да служи више различитих веб-сајтова, а сваки може да живи на поддомену *.b1.church или на потпуно прилагођеном домену који је у власништву цркве. Ова страница описује слој рутирања који се налази испод градитеља: како долазни захтев добија везу и са црквом и са одређеним сајтом, модел података за више сајтова (сентинел вредност siteId која чува сваки постојећи сајт непромењеним) и ивицу за прилагођене домене, односно самоуправљани Caddy прокси на EC2 који завршава TLS и преписује сваки домен цркве на њен *.b1.church извор. За оно што се заиста приказује након што се захтев разреши, односно стабло страница, секција и елемената, погледајте Градитељ веб-сајта.

Преглед​

   grace.b1.church              www.gracechurch.org  (прилагођени домен)
(b1.church поддомен) │
│ ▼
│ ┌──────────────────────────────────────────┐
│ │ Caddy ивица — EC2 3.23.251.61 │
│ │ (proxy.b1.church) │
│ │ • завршава TLS (LE сертификат по домену)│
│ │ • преписује Host → {sub}.b1.church │
│ │ • reverse-proxy до B1App │
│ └────────────────────┬─────────────────────┘
│ Host = {sub}.b1.church
▼ ▼
┌────────────────────────────────────────────────────────────┐
│ B1App src/middleware.ts │
│ • увек: брише сваки клијентски x-site (анти-спуфинг) │
│ • интерни *.b1.church Host ⇒ претрага домена остаје неактивна│
│ • сирови прилагођени Host (заобилази Caddy) ⇒ претрага → постави x-site│
└───────────────────────────┬────────────────────────────────┘
▼ next.config.mjs → прва ознака хоста → /[sdSlug]/…
┌─────────────────────────────────────────────────┐
│ [sdSlug] · ConfigHelper.load(sdSlug) │
│ GET /membership/churches/lookup/?subDomain=… │
│ → { id, name, subDomain, siteId? } │
│ прослеђује ?siteId= у сваки позив садржаја: │
│ /content/pages/:id/tree · /globalStyles · │
│ /blocks/public/footer · /links · sitemap │
└─────────────────────────────────────────────────┘

чување/брисање домена (B1Admin Settings→Domains → POST /membership/domains)
└─ најбољим напором CaddyHelper.updateCaddy() (омотано, не-фатално, 10s тајм-аут)
Caddy сам чита табелу domains преко две анонимне крајње тачке:
GET /membership/domains/authorize — on-demand-TLS `ask` (200 познат / 404 непознат)
GET /membership/domains/hostmap — мапа host→{sub}.b1.church (освежавање на 5 минута)

Три правила важе у овом слоју:

  1. Сентинел вредност одржава компатибилност уназад. siteId = '' је главни сајт. Свака страница, блок, веза, глобални стил и ред домена који је постојао пре ове функционалности носи '' и приказује се потпуно исто као и раније. Други веб-сајт је једноставно скуп редова са непразним siteId, а свака крајња тачка садржаја позвана без ?siteId= враћа главни сајт, односно бајт-за-бајт исти захтев као и стари.
  2. Разрешавање се заснива на ознаци хоста и конвергира. Поддомен *.b1.church рутира се директно по својој ознаци хоста, а прилагођени домен се на Caddy ивици преписује на своју ознаку {sub}.b1.church пре него што га B1App види (уз DB претрагу у middleware-у која поставља заглавље x-site као резерву за сваки сирови прилагођени Host). Обе гране стижу на исту руту [sdSlug] и исти позив churches/lookup, тако да је даље приказивање идентично.
  3. Caddy ивица је без стања над једним извором истине. Прилагођени домени завршавају се на самоуправљаном Caddy проксију на EC2 који преписује сваки домен на свој {sub}.b1.church извор. Чување домена покреће један најбољи покушај CaddyHelper.updateCaddy(), а Caddy такође директно чита табелу domains (крајње тачке authorize и hostmap доле). Табела је меродавна, па недоступан Caddy никада не може да изазове неуспех чувања.

Разрешавање сајта​

Поддомени *.b1.church​

B1App/next.config.mjs преписује долазне захтеве по хосту. Правило хоста са шаблоном (?<subdomain>.*?)\..* хвата прву ознаку хоста и преписује / и /:path* у /{subdomain}, што је сегмент [sdSlug] App Router-а. Дакле, grace.b1.church/about постаје /grace/about.

Унутар src/app/[sdSlug]/, ConfigHelper.load(sdSlug) (src/helpers/ConfigHelper.ts) позива GET /membership/churches/lookup/?subDomain={sdSlug}. Одговор ChurchController.getBySubDomain сада има две гране:

Слаг се поклапаОдговорЗначење
churches.subDomain{ id, name, subDomain }Главни сајт те цркве
sites.subDomain{ id, name, subDomain, siteId }Секундарни сајт: контролер се враћа на sites, разрешава цркву власника и враћа упитани слаг заједно са додатним siteId

Тај додатни siteId је једина ствар која разликује захтев за секундарним сајтом од захтева за главним. Све остало у току обраде је заједничко.

Слаг који не одговара ниједној табели враћа се као {} са 200. ConfigHelper.load третира одговор без id као непознат сајт и позива Next-ов notFound(), па непознат поддомен добија прави 404, а не да сваки каснији позив тражи /…/undefined. Рута странице градитеља такође гради своју путању стабла помоћу pageTreePath() (src/helpers/pageTreePath.ts), која URL-кодира слаг. Тако неисправан слаг (косе црте уназад, размаци) даје 404, а не да API-јев 400 постане 500.

Прилагођени домени​

Домен у власништву цркве завршава се на Caddy ивици (детаљно у наставку), која преписује заглавље Host на {sub}.b1.church сајта пре прослеђивања B1App-у. На нормалној путањи B1App прима интерни хост *.b1.church и разрешава га по ознаци хоста исто као и изворни поддомен, тако да се DB претрага middleware-а никада не покреће. src/middleware.ts и даље ради на сваком захтеву, али са једним увек активним задатком и једном резервном опцијом:

  1. Увек: брише сваки заглавље x-site које је послао клијент. То заглавље је подложно лажирању и поверава му се само кад га сам middleware постави. Брисање је стварни посао middleware-а иза Caddy-ја.
  2. Резерва, само за не-интерни Host: за сирови Host прилагођеног домена који стиже до B1App-а без Caddy преписивања, позива GET /membership/domains/public/lookup/{host} и, ако то врати subDomain, поставља x-site: {subDomain}.b1.church. Иза Caddy-ја ова грана је неактивна, јер је Host већ *.b1.church.

Интерни хостови (localhost, b1.church и суфикси .b1.church, .localtest.me, .localhost, .up.railway.app, .vercel.app) потпуно прескачу претрагу. Они су већ разрешени преписивањем ознаке хоста или су хостови за преглед или деплој.

Сама претрага (DomainRepo.loadByName) спаја domains → churches и domains → sites и враћа COALESCE(NULLIF(sites.subDomain,''), churches.subDomain), односно поддомен додељеног секундарног сајта ако домен указује на њега, иначе поддомен цркве. Прво тражи тачан хост. Ако је тај хост почео са www. и није ништа нашао, покушава једном са голим апексом.

У next.config.mjs су правила преписивања x-site постављена испред општих правила хоста, па имају предност. x-site: grace.b1.church → прва ознака grace → [sdSlug] = grace, а даље је разрешавање идентично путањи поддомена (исти churches/lookup, исти siteId).

инфо

Заглавље x-site је споља непоуздано. Middleware безусловно уклања сваки долазни x-site пре него што евентуално постави свој, а правила преписивања виде само вредност коју је поставио middleware. Клијент не може да се наметне садржају друге цркве слањем заглавља.

Два оперативна детаља о middleware-у:

  • Кеш. Резултат за сваки хост (погодак или потврђени промашај, никада мрежна грешка) кешира се 10 минута у меморијској Map структури, по serverless изолату.
  • Matcher. Matcher намерно поново укључује /sitemap.xml, /robots.txt и /manifest.webmanifest. Његов први образац искључује путање с тачкама, што би иначе одбацило те фајлове. Они се враћају тако да и SEO и PWA фајлови сваког прилагођеног домена добијају заглавље x-site.
  • Канонично заглавље. За странице цркве middleware додаје заглавље одговора Link: <{proto}://{host}{path}>; rel="canonical", које именује хост са којег је страница заправо послужена, односно поддомен или прилагођени домен (helpers/canonicalLink.ts). Када прилагођени домен стигне до B1App-а преко Caddy проксија, хост захтева је поддомен {sub}.b1.church. Зато middleware уместо тога користи посетиочев домен из X-Church-Host, али тек након што /domains/public/lookup/{host} потврди да тај домен мапира на исти поддомен (ownsSubdomain()). Канонична веза, robots.txt и sitemap.xml тада именују прилагођени домен, а не поддомен b1.church. Прескаче се на не-црквеним хостовима (b1.church, localhost, *.vercel.app, *.up.railway.app) и на /mobile, /login, /logout и генерисаним фајловима robots, sitemap и manifest.

Искључен јавни сајт​

Црква може да укључи Disable Public Website у B1Admin-у (подешавање садржаја на нивоу цркве hidePublicSite = "true"). Сајт тада служи само своје руте за чланове:

  • B1App middleware проверава поддомен (/membership/churches/lookup, па /content/settings/public/:churchId) и преусмерава анонимне захтеве за било коју путању ван дозвољене листе на /login?returnUrl={path}{query}. Дозвољена листа (helpers/publicSite.ts) су /login, /logout, /mobile/*, /register/*, /guest-register и фајлови manifest, robots и sitemap. Кеширају се само потврђени одговори: 60 секунди у продукцији, јер админов позив за revalidate не може да обрише ову мапу по инстанци, а без кеша у dev и test окружењу. Грешка API-ја служи сајт, уместо да све закључа.
  • Пријављени чланови виде цео сајт. Захтев који носи неистекли колачић jwt (функција hasSession() middleware-а декодира exp из payload-а без провере потписа; ово је мека капија, а не контрола приступа) прескаче преусмеравање. Након пријаве члан се враћа на страницу коју је тражио и види нормалне странице, уграђене странице (Групе, Проповеди итд.) и навигацију у заглављу. Компоненте страница и Header више сами не проверавају hidePublicSite.
  • robots.txt забрањује све, као и на noindex хостовима.
  • API. GET /content/pages/public/:churchId (листа страница за sitemap) враћа [], па анонимни позиваоци не могу да листају странице.

Прослеђивање siteId​

ConfigHelper чува разрешени siteId у свом ConfigurationInterface објекту по захтеву (мемоизован помоћу React cache()) и додаје ?siteId= позивима садржаја које он и компоненте страница праве. Ово се ради условно: празан siteId (поддомен главне цркве) изоставља параметар у потпуности. Крајње тачке обухваћене овим су стабло страница (/content/pages/:id/tree), јавна листа страница која се користи за sitemap (/content/pages/public/:id), глобални стилови (/content/globalStyles/church/:id), навигационе везе (/content/links/church/:id) и самостални блок подножја (/content/blocks/public/footer/:id). На нормалној путањи приказивања подножје долази унутар стабла страница (секције означене zone: "siteFooter"), већ преузето са siteId, тако да нема непокривене празнине за подножје.

Портал за чланове (B1App mobile) намерно је изван овога. loadChurchAppearance.ts разрешава цркву преко churches/lookup, али чита подешавања на нивоу цркве из /settings/public/{id} и никада не прослеђује siteId. Портал је у v1 цела црква (видети испод).

Више веб-сајтова по цркви​

Модел података​

Нова табела membership.sites је намерно мала:

КолонаТипНапомене
idchar(11) PK
churchIdchar(11)Црква власник
namevarchar(255)Приказни назив (нпр. "Español", "Youth")
subDomainvarchar(45)Јединствени индекс, глобални именски простор (испод)

Обухват по сајту додаје се табелама садржаја и домена као једна колона која не сме бити NULL:

Табела (модул)Колона'' значи
domains (membership)siteId char(11) NOT NULL DEFAULT ''Домен служи главни сајт
pages, links, globalStyles, blocks (content)siteId char(11) NOT NULL DEFAULT ''Главни сајт. На blocks, '' додатно значи дељено за све сајтове

Две миграције додају све ово (tools/migrations/membership/2026-07-02_sites.ts, tools/migrations/content/2026-07-02_site_id.ts). Пошто колона подразумевано има '', сваки постојећи ред задржава данашње понашање без накнадног попуњавања.

Глобални именски простор поддомена. sites.subDomain дели један именски простор са churches.subDomain. Поддомен сајта никада не може да се судари са поддоменом цркве или са поддоменом другог сајта. Ово се спроводи на оба пута чувања: SiteController.save одбија слаг који погађа било churches било sites, а ChurchController.validateSave ради исто у обрнутом смеру. Јединствени индекс на sites.subDomain то подупире на нивоу базе.

Јединственост страница проширена је са (churchId, url) на (churchId, siteId, url), па два сајта исте цркве могу сваки да имају свој /about.

Садржај по сајту, са резервама​

Свака крајња тачка за листу или стабло садржаја са обухватом по сајту прима опционални ?siteId= (без њега се подразумева '', односно главни сајт). То важи за стабло страница, листу и јавне странице, листу блокова, блокове по типу и подножје, везе (анонимне, филтриране и све) и глобалне стилове. Секције и елементи се не обухватају директно. Они наслеђују обухват преко своје родитељске странице или блока.

Два ланца разрешавања раде занимљив посао:

  • Глобални стилови: сајт → главни → подразумевано. GlobalStyleRepo.loadForChurch(churchId, siteId) враћа сопствени ред сајта. Ако секундарни сајт нема свој ред, враћа ред главног сајта ('') као такав, задржавајући његов id и siteId, што клијент користи за copy-on-write. Ако нема ни главног, GlobalStyleController враћа тврдо кодирану подразумевану палету и фонтове.
  • Блок подножја: сајт-специфичан побеђује, дељени се користи као резерва. BlockRepo.loadByBlockType(churchId, "footerBlock", siteId) враћа дељене редове ('') и редове специфичне за сајт. Разрешивач бира подножје самог сајта ако постоји, иначе дељено. Иста логика се извршава и у TreeHelper.insertBlocks (стабло страница) и у самосталној крајњој тачки /content/blocks/public/footer/:churchId.

Каскадно брисање сајта​

SiteController.delete (зависи од дозволе membership Settings→Edit) уклања секундарни сајт у три корака:

  1. ContentModuleGateway.deleteSiteContent(churchId, siteId) каскадно брише сав садржај који сајт поседује: његове странице заједно са њиховим секцијама, елементима, pageHistory и posts; његове блокове заједно са њиховим секцијама, елементима и pageHistory; његове везе и globalStyles. Заштита одбија да се покрене за ''. Главни или дељени сентинел никада није укључен у каскаду.
  2. DomainRepo.clearSiteId враћа домене сајта главном (siteId → '') уместо да их брише, па прилагођени домен преживљава брисање сајта.
  3. Ред sites се брише, а Caddy руте се поново синхронизују (најбољим напором).

Површина B1Admin-а​

МогућностГдеМеханизам
Прекидач сајтоваuseSiteSelection + SiteSwitcher (празно = "Главни сајт")Чита параметар URL-а ?site= и прослеђује га као ?siteId= у ContentApi позиве. Присутан је на три листе области сајта, Странице, Блокови и Изглед, али не и у уређивачима страница и блокова, који носе siteId на самом запису
Креирање и брисање сајтоваSitesDialog, отворен из уноса "Manage websites…" у прекидачуPOST /membership/sites / DELETE /membership/sites/:id (назив и subDomain). Зависи од дозволе membership Settings→Edit (Permissions.settings.edit на серверу; Permissions.membershipApi.settings.edit у B1Admin-у). Само креирање и брисање. У v1 нема UI-ја за преименовање
Додела сајта по доменуDomainSettingsEdit под Settings→DomainsПадајући мени сајта по реду шаље siteId по домену на /membership/domains. Колона се сакрива ако API не врати сајтове (старији backend)
Copy-on-write стиловиStylesManager.prepareForSaveКада се siteId учитаног реда глобалног стила не поклапа са изабраним сајтом (односно API је вратио наслеђени главни као резерву), функција уклања id главног и поставља тренутни siteId. Тако се приморава уметање новог реда специфичног за сајт, уместо преписивања главног. Иста грана при неподударању важи и за блок подножја сајта
инфо

Шта остаје цела црква у v1 (намерна одлука о обиму, а не ограничење модела података): блог (BlogPage нема прекидач и учитава /posts без siteId), виџети сајта (банер за најаве и покретач), преусмеравања, логотип, GA4 и подешавања цркве и портал за чланове (B1App mobile). Ово није сав Изглед. Глобални стилови секундарног сајта (палета, фонтови, типографија, размаци, навигација, прилагођени CSS) јесу по сајту, кроз copy-on-write путању горе. Остају само подпанели банера, покретача, преусмеравања и логотипа на страници Изглед који су цела црква.

Прилагођени домени: Caddy ивица (план статичке конфигурације)​

инфо

Измењен правац 2026-07-02. Ранији план да се хостовање прилагођених домена пребаци на домене којима управља Vercel је отказан. Сав код за регистрацију домена на Vercel-у (VercelHelper, његове env променљиве vercelToken, vercelProjectId и vercelTeamId, SSM параметри и уноси здравља) уклоњен је из Api-ја. Самоуправљани Caddy прокси на EC2 остаје као трајна ивица за прилагођене домене. Преостали посао је интерне природе: замена Caddy-јеве конфигурације у време рада, која се добија преко admin API-ја, статичком конфигурацијом која преживљава рестартовање.

Ивица​

Сваки прилагођени домен цркве усмерава DNS на једну EC2 машину, 3.23.251.61, која је такође доступна као proxy.b1.church. Екран B1Admin-а Settings→Domains упућује цркве да додају апекс A → 3.23.251.61 или CNAME → proxy.b1.church. Caddy завршава TLS помоћу сертификата Let's Encrypt по домену, преписује заглавље Host на {sub}.b1.church извор домена и прослеђује захтев B1App-у. B1App га онда рутира по ознаци хоста као и било који изворни поддомен (видети Прилагођени домени горе).

Мапирање извора долази из DomainRepo.loadPairs. Његов израз за одредиште користи COALESCE поддомена додељеног сајта, тако да домен прослеђује на исправан секундарни сајт, уз резерву на главни сајт цркве:

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

Редови www.* искључени су из мапе. Caddy служи www.{host} преко 302 преусмеравања на апекс.

Две анонимне крајње тачке напајају ивицу​

DomainController излаже две непровереније, само читајуће крајње тачке које машина директно користи. Оне су анонимне по нужди, јер ивица их пита пре него што постоји црквени контекст:

Крајња тачкаВраћаУлога
GET /membership/domains/authorize?domain=200 ако домен (или, за промашај www., његов голи апекс) постоји у domains, иначе 404 (укључујући празан domain)Caddy-јев on-demand-TLS ask: контрола злоупотребе која одлучује да ли да се изда сертификат за долазни SNI
GET /membership/domains/hostmaptext/plain, по један сортирани ред {domain} {sub}.b1.church за сваки рутабилни доменФајл мапе host→извор који машина освежава по тајмеру

authorize поново користи DomainRepo.loadByName (тачан хост, па један покушај www.→апекс). hostmap поново користи loadPairs, тако да је свестан сајтова и искључује www.*, исто као и прокси руте. Затим само скида суфикс :443.

Чување и брисање домена: једно гурање најбољим напором​

DomainController.save уписује редове domains, па шаље једнократни позив најбољим напором CaddyHelper.updateCaddy(), омотан у try/catch који бележи грешку (console.error) и прогута је. delete ради исто, што је такође поправило ранији бug са застарелим рутама при брисању. Исто важи и за брисање секундарног сајта (SiteController.delete). Сам updateCaddy ограничен је 10s Axios тајм-аутом, па недоступан или заустављен Caddy никада не може да врати 500 при чувању домена. Табела domains је извор истине.

Тренутно стање: статичка конфигурација, без стања у време рада​

Машина (Windows EC2 иза трајне Elastic IP адресе) покреће Caddy из статичког Caddyfile-а. Он садржи on-demand TLS чији ask указује на /membership/domains/authorize, као и фајл мапе host→извор који се освежава сваких 5 минута из /membership/domains/hostmap. Освежавање ради заказани задатак који се завршава грацијозним caddy reload-ом. Конфигурација преживљава рестартовање без иједног стања у меморији и без поновног поступка припреме. Непознат SNI се одбија на TLS нивоу (сертификат се не издаје за хост који authorize одбија). Ауторизован, али још није мапиран хост (нови домен у прозору синхронизације) добија чист 404. Нови домени постају рутабилни у року од ~5 минута од чувања, а њихови сертификати се издају при првом приступу. Изградња и подешавање, рад и проверене замке: Caddy прокси за прилагођене домене.

Наслеђено гурање у време рада: путања за враћање, чека брисање​

CaddyHelper (membership модул) и даље може да управља Caddy-јем преко његовог admin API-ја на caddyHost:caddyPort (SSM caddyHost/caddyPort; нема ефекта кад нису постављени; приказан је у групи Integrations у ServerHealthController-у). updateCaddy() врши PATCH целог низа руте, а initializeCaddy() заједно са крајњим тачкама GET /membership/domains/caddy/init и GET /membership/domains/caddy поново граде сервер конфигурисан у време рада од нуле. Конфигурација тог режима живела је само у меморији Caddy-ја, што је губитак памћења при рестарту који је ова архитектура заменила. Механизам остаје само као путања за враћање и заказан је за брисање када статична машина буде стабилна. Најбоље гурање updateCaddy() при чувању или брисању домена је безопасна операција без ефекта на статичкој машини, јер је њен admin API доступан само са localhost-а.

Повезане странице​