도메인 템플릿

도메인 템플릿이란?

**도메인 템플릿(Domain Template)**은 특정 업계에 맞춰 큐레이션된 팩트 정의와 샘플 규칙의 묶음입니다. 템플릿을 적용하면 다음이 생성됩니다:

테넌트에 등록되는 사전 정의된 팩트 세트 (예: purchase_subtotal_usd, loyalty_tier).
게시하거나 수정할 수 있는 샘플 규칙이 포함된 새 정책 그룹.
그룹 목록의 항목 — 직접 만든 것과 동일합니다.

새 정책 도메인을 시작할 때 빈 화면 문제를 건너뛰려면 템플릿을 사용하세요.

템플릿은 선택 사항입니다. 콘솔에서 적용을 클릭하거나 apply 엔드포인트를 호출할 때만 실행됩니다. 기존 팩트와 정책 그룹은 절대 수정되지 않습니다.

사용 가능한 템플릿

이커머스

충성도 등급 할인, 첫 구매 보너스, 고LTV 고객 무료 배송, 온라인 리테일용 프로모션 코드 처리.팩트 8개 · 샘플 규칙 5개

추가 템플릿(핀테크, SaaS)은 출시 예정입니다.

이커머스 템플릿

팩트 (8)

키	타입	필수	설명
`purchase_subtotal_usd`	NUMBER	✅	할인 전 장바구니 소계 (USD)
`purchase_currency`	STRING		ISO 4217 통화 코드 (예: USD, EUR, KRW)
`cart_category_tags`	LIST_STRING		장바구니 상품의 카테고리 태그
`customer_ltv_usd`	NUMBER		고객 생애 가치 (USD)
`loyalty_tier`	STRING		PLATINUM / GOLD / SILVER / BRONZE / NONE
`applied_promo_code`	STRING		결제 시 입력한 프로모션 코드
`is_first_purchase`	BOOLEAN		첫 구매 여부
`loyalty_credit_usd`	NUMBER		사용 가능한 적립 잔액 (USD)

샘플 규칙 (5)

우선순위	이름	트리거	효과
1	Platinum Tier — 20% Off	`loyalty_tier=PLATINUM` 이고 소계 ≥ USD 100	소계 20% 할인 (mutex: `vip_discount`)
2	Gold Tier — 15% Off	`loyalty_tier=GOLD` 이고 소계 ≥ USD 100	소계 15% 할인 (mutex: `vip_discount`)
3	Silver Tier — 10% Off	`loyalty_tier=SILVER` 이고 소계 ≥ USD 100	소계 10% 할인 (mutex: `vip_discount`)
4	First-Purchase Bonus	`is_first_purchase=true`	소계 USD 10 할인
5	High-LTV Free Shipping	`customer_ltv_usd ≥ 1000`	`free_shipping` 태그 추가

3개의 등급 할인 규칙은 EXCLUSIVE / HIGHEST_PRIORITY 의 mutex 그룹(vip_discount)을 공유합니다 — 매칭되는 규칙 중 우선순위가 가장 높은 하나만 실행됩니다. 첫 구매 보너스와 무료 배송은 독립적으로 실행됩니다.

템플릿 적용

설정 → 도메인 템플릿으로 이동합니다.
템플릿 카드의 미리보기를 클릭하여 적용 전에 팩트와 규칙을 확인합니다.
적용을 클릭하여 정책 그룹을 생성합니다.
선택적으로 사용자 정의 그룹명을 입력합니다. 비워두면 기본 이름이 생성됩니다 (이름이 이미 존재하면 날짜 접미사가 붙습니다).

적용 후 새 정책 그룹으로 이동하며, 거기서 규칙 수정, 적용 기간 설정, 게시를 할 수 있습니다.

적용 시 동작

리소스	동작
팩트	누락된 경우에만 생성됩니다. 같은 키의 기존 팩트는 그대로 유지됩니다 (수정 사항 보존).
정책 그룹	새 그룹, `status=ACTIVE`.
정책 버전	새 버전, `status=DRAFT`. 게시 전에 규칙을 수정하세요.
규칙	5개 샘플 규칙 모두 생성.
적용 이력	감사를 위해 기록됩니다.

전체 작업은 트랜잭션으로 처리됩니다 — 어느 단계라도 실패하면 아무것도 생성되지 않습니다.

생성된 정책 버전은 DRAFT 상태로 시작합니다. 라이브로 전환하려면 정책 그룹 페이지 또는 배포 API에서 게시하세요.

적용 후 커스터마이징

템플릿은 시작점입니다. 적용 후 자유롭게 다음을 할 수 있습니다:

모든 규칙 수정 (조건, 액션, 우선순위, mutex).
버전에서 규칙 추가 또는 제거.
필요 없는 팩트 삭제 (보호되지 않는 일반 커스텀 팩트입니다).
정책 그룹 이름 변경.
게시 전 버전의 적용 기간 조정.

자주 묻는 질문

같은 템플릿을 두 번 적용할 수 있나요? 네. 적용할 때마다 새 정책 그룹이 생성됩니다. 기존 팩트는 재사용됩니다 (중복 생성되지 않음). 기본 그룹명이 이미 사용 중이면 날짜 접미사가 자동으로 붙습니다. 나중에 템플릿의 팩트를 삭제할 수 있나요? 네. 템플릿으로 생성된 팩트는 일반 테넌트 팩트입니다 — 특별한 보호가 없습니다. 단, 사용 중인 팩트를 삭제하면 해당 팩트를 참조하는 규칙이 그 조건을 false로 평가합니다. 적용을 롤백할 수 있나요? 단일 작업으로는 불가능합니다. 되돌리려면 정책 그룹을 직접 보관 처리하거나 (또는 버전을 삭제) 필요 없는 팩트를 삭제하세요. 적용 이력 기록은 감사를 위해 남습니다.