도메인 템플릿

도메인 템플릿이란?

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

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

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

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

사용 가능한 템플릿

이커머스

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

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

이커머스 템플릿

fact (9)

키	타입	필수	설명
`purchaseSubtotalUsd`	NUMBER	✅	할인 전 장바구니 소계 (USD)
`purchaseCurrency`	STRING		ISO 4217 통화 코드 (예: USD, EUR, KRW)
`cartCategoryTags`	LIST_STRING		장바구니 상품의 카테고리 태그
`customerLtvUsd`	NUMBER		고객 생애 가치 (USD)
`loyaltyTier`	STRING		PLATINUM / GOLD / SILVER / BRONZE / NONE
`appliedPromoCode`	STRING		결제 시 입력한 프로모션 코드
`isFirstPurchase`	BOOLEAN		첫 구매 여부
`loyaltyCreditUsd`	NUMBER		사용 가능한 적립 잔액 (USD)
`freeShipping`	BOOLEAN		무료 배송

샘플 규칙 (5)

우선순위	이름	트리거	효과
1	`Platinum 등급 — 20% 할인 (USD 100+)`	`loyaltyTier=PLATINUM` 이고 소계 ≥ USD 100	소계 20% 할인 (mutex: `vip_discount`)
2	`Gold 등급 — 15% 할인 (USD 100+)`	`loyaltyTier=GOLD` 이고 소계 ≥ USD 100	소계 15% 할인 (mutex: `vip_discount`)
3	`Silver 등급 — 10% 할인 (USD 100+)`	`loyaltyTier=SILVER` 이고 소계 ≥ USD 100	소계 10% 할인 (mutex: `vip_discount`)
4	`첫 구매 보너스 — USD 10 할인`	`isFirstPurchase=true`	소계 USD 10 할인
5	`고가치 고객 무료 배송 (LTV USD 1,000+)`	`customerLtvUsd ≥ 1000`	SET_FACT `freeShipping` `true`

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

템플릿 적용

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

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

적용 시 동작

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

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

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

적용 후 커스터마이징

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

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

자주 묻는 질문

같은 템플릿을 두 번 적용할 수 있나요? 네. 적용할 때마다 새 정책 그룹이 생성됩니다. 기존 fact는 재사용됩니다 (중복 생성되지 않음). 기본 그룹명이 이미 사용 중이면 날짜 접미사가 자동으로 붙습니다. 나중에 템플릿의 fact를 삭제할 수 있나요? 참조하는 규칙이 없으면 지울 수 있습니다. 템플릿으로 생성된 fact는 일반 테넌트 fact이고 특별한 보호가 없지만, 다른 fact와 같은 가드를 받습니다. 규칙이 참조하는 fact는 삭제(FD-006)도 타입 변경(FD-007)도 거절되며 참조 중인 규칙 수를 함께 알려줍니다. 그 규칙을 지우거나 그 fact를 쓰지 않도록 고치면 삭제가 열립니다. 적용을 롤백할 수 있나요? 단일 작업으로는 불가능합니다. 되돌리려면 정책 그룹을 직접 보관 처리하거나 버전을 삭제한 다음, 필요 없는 fact를 삭제하세요. 순서가 중요합니다. 규칙이 남아 있는 동안에는 그 규칙이 fact를 참조하므로 삭제가 거절됩니다. 적용 이력 기록은 감사를 위해 남습니다.

시작하기

핵심 개념

기능

도메인 템플릿