> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lexq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 도메인 템플릿

> 업계별로 큐레이션된 팩트 카탈로그와 샘플 규칙으로 빠르게 시작하세요. 템플릿을 적용하면 바로 게시 가능한 정책 그룹이 몇 초 만에 생성됩니다.

## 도메인 템플릿이란?

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

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

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

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

## 사용 가능한 템플릿

<CardGroup cols={1}>
  <Card title="이커머스" icon="cart-shopping">
    충성도 등급 할인, 첫 구매 보너스, 고LTV 고객 무료 배송, 온라인 리테일용 프로모션 코드 처리.

    **팩트 8개** · **샘플 규칙 5개**
  </Card>
</CardGroup>

추가 템플릿(핀테크, 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`)을 공유합니다 — 매칭되는 규칙 중 우선순위가 가장 높은 하나만 실행됩니다. 첫 구매 보너스와 무료 배송은 독립적으로 실행됩니다.

## 템플릿 적용

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

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

## 적용 시 동작

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

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

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

## 적용 후 커스터마이징

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

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

## 자주 묻는 질문

**같은 템플릿을 두 번 적용할 수 있나요?**

네. 적용할 때마다 새 정책 그룹이 생성됩니다. 기존 팩트는 재사용됩니다 (중복 생성되지 않음). 기본 그룹명이 이미 사용 중이면 날짜 접미사가 자동으로 붙습니다.

**나중에 템플릿의 팩트를 삭제할 수 있나요?**

네. 템플릿으로 생성된 팩트는 일반 테넌트 팩트입니다 — 특별한 보호가 없습니다. 단, 사용 중인 팩트를 삭제하면 해당 팩트를 참조하는 규칙이 그 조건을 `false`로 평가합니다.

**적용을 롤백할 수 있나요?**

단일 작업으로는 불가능합니다. 되돌리려면 정책 그룹을 직접 보관 처리하거나 (또는 버전을 삭제) 필요 없는 팩트를 삭제하세요. 적용 이력 기록은 감사를 위해 남습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="정책 그룹" icon="layer-group" href="/ko/guides/policy-groups">
    정책 그룹과 버전의 동작 방식을 알아보세요.
  </Card>

  <Card title="팩트 정의" icon="database" href="/ko/guides/fact-definitions">
    팩트 모델을 자세히 이해하세요.
  </Card>
</CardGroup>