Tenant Domains & Sites
Tenant Domains & Sites는 Platform Admin(Level 0)이 SaaS/Tenant별 도메인 연결과 사이트 분리 설정을 한 화면에서 확인하고 수정하는 관리 메뉴입니다.
MSK 공식 용어
MSK에서는 도메인별 운영 방식을 다음 두 용어로 구분합니다.
| 용어 | 설정 | 구현 범위 | 권장 사용 |
|---|---|---|---|
| 미러사이트 | settings.custom_theme | 같은 route/controller 유지, Blade/브랜딩 오버레이 | 로고, 푸터, 색상, 일부 화면만 다른 경우 |
| 독립사이트 | settings.site | app/Sites/{StudlyName} 기반 routes/controllers/views 분리 | 사이트 구조, 기능, 운영 경계가 다른 경우 |
미러사이트는 같은 작업영역을 공유합니다. 독립사이트는 도메인과 함께 실제 작업 폴더 또는 SaaS 모듈을 분리합니다.
관리 항목
| 항목 | 필드 | 설명 |
|---|---|---|
| Primary Domain | primary_domain | Tenant 대표 도메인 |
| Domain Aliases | domain_aliases | 같은 Tenant로 연결되는 별칭 도메인 |
| Subdomain Mapping | subdomain_mapping | 서브도메인별 권한 level/panel 매핑 |
| 미러사이트 | settings.custom_theme | Tenant 전용 Blade/브랜딩 오버레이 |
| 독립사이트 | settings.site | app/Sites/{StudlyName} 기반 독립 작업영역 |
| Legacy Domains | settings.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 도움말을 표시합니다.
운영 기준
- 도메인이 고객별로 다르지만 구조가 같으면 미러사이트를 우선 검토합니다.
- 라우트, 기능, 데이터 모델, 배포 주기가 달라지면 독립사이트를 사용합니다.
- Platform Admin은
Tenant Domains & Sites에서 전체 현황을 확인합니다. - 운영자 문구나 정책 안내가 바뀌면
Help Pages에서 페이지 도움말을 수정합니다.