Skip to main content

Tenant Domains & Sites

Tenant Domains & Sites는 Platform Admin(Level 0)이 SaaS/Tenant별 도메인 연결과 사이트 분리 설정을 한 화면에서 확인하고 수정하는 관리 메뉴입니다.

MSK 공식 용어​

MSK에서는 도메인별 운영 방식을 다음 두 용어로 구분합니다.

용어설정구현 범위권장 사용
미러사이트settings.custom_theme같은 route/controller 유지, Blade/브랜딩 오버레이로고, 푸터, 색상, 일부 화면만 다른 경우
독립사이트settings.siteapp/Sites/{StudlyName} 기반 routes/controllers/views 분리사이트 구조, 기능, 운영 경계가 다른 경우

미러사이트는 같은 작업영역을 공유합니다. 독립사이트는 도메인과 함께 실제 작업 폴더 또는 SaaS 모듈을 분리합니다.

관리 항목​

항목필드설명
Primary Domainprimary_domainTenant 대표 도메인
Domain Aliasesdomain_aliases같은 Tenant로 연결되는 별칭 도메인
Subdomain Mappingsubdomain_mapping서브도메인별 권한 level/panel 매핑
미러사이트settings.custom_themeTenant 전용 Blade/브랜딩 오버레이
독립사이트settings.siteapp/Sites/{StudlyName} 기반 독립 작업영역
Legacy Domainssettings.domains기존 settings 기반 도메인 목록

신규 구현은 명시 필드(primary_domain, domain_aliases, subdomain_mapping)를 우선 사용하고, settings.domains는 기존 프로젝트 호환을 위해 함께 표시합니다.

Help Pages​

각 관리페이지의 상단 설명과 ? 모달 도움말은 Help Pages 메뉴에서 편집합니다.

필드값 또는 의미
panel도움말 적용 패널. 예: platform
page_key페이지 키. Tenant Domains & Sites는 tenant-domains.index
summary페이지 제목 아래 설명
guide_body목록 상단 안내 영역
modal_body? 모달 상세 매뉴얼
visible_levels도움말을 볼 수 있는 사용자 level

기본 레코드는 platform / tenant-domains.index입니다. 이 레코드가 비활성 상태이거나 없으면 코드에 포함된 정적 fallback 도움말을 표시합니다.

운영 기준​

  1. 도메인이 고객별로 다르지만 구조가 같으면 미러사이트를 우선 검토합니다.
  2. 라우트, 기능, 데이터 모델, 배포 주기가 달라지면 독립사이트를 사용합니다.
  3. Platform Admin은 Tenant Domains & Sites에서 전체 현황을 확인합니다.
  4. 운영자 문구나 정책 안내가 바뀌면 Help Pages에서 페이지 도움말을 수정합니다.

관련 문서​