innojini-huni-nlp-builder

name	innojini-huni-nlp-builder
description	HuniPrinting GLM-powered Natural Language Rule Builder skill. Provides GLM prompt templates, printing domain knowledge, and extensive few-shot examples for converting Korean natural language into structured ECA constraints, quantity discount tiers, price mode recommendations, WowPress req_*/rst_* style option dependency rules, and multi-domain composite rules. Covers: single-domain rules, multi-domain composite rules, chain rules (A→B→C), option dependency chains (WowPress pattern), price+constraint combinations, and TypeScript/Drizzle script generation output. Use when building or testing the NL rule builder feature (SPEC-WB-007).
license	Apache-2.0
compatibility	Designed for Claude Code
allowed-tools	Read Grep Glob Bash
user-invocable	false
metadata	{"version":"2.0.0","category":"domain","status":"active","updated":"2026-02-27","modularized":"false","tags":"printing, glm, nlp, eca, price-rules, huni, wowpress, req-rst, composite-rules","related-skills":"innojini-printing-foundation,innojini-huni-printing-estimator,innojini-huni-db-schema,innojini-wowpress","context7-libraries":"openai,drizzle-orm,trpc,zod"}
progressive_disclosure	{"enabled":true,"level1_tokens":130,"level2_tokens":12000}
triggers	{"keywords":["glm","z.ai","자연어","nlp","nl-rule","convertConstraint","convertPriceRule","price_nl_history","nlp-builder","constraint-transformer","req_","rst_","복합규칙","연쇄규칙","wowpress"],"agents":["expert-backend","expert-frontend","manager-tdd","manager-ddd"],"phases":["run"]}

innojini-huni-nlp-builder v2.0

후니프린팅 GLM 자연어 규칙 빌더 — 도메인 지식, 프롬프트 템플릿, 복합 규칙 변환 가이드.

---

1. 시스템 개요

1.1 핵심 설계 원칙

인쇄는 주문제조 — 요리와 같다: 상품은 사이즈·용지·인쇄·후가공 등 재료를 조합해 만든다. GLM은 관리자의 자연어 의도를 구조화된 규칙(ECA 제약, 수량할인)으로 변환하는 번역기다.

WowPress req_/rst_ 패턴 원리:

• req_* = "A를 선택하면 B도 반드시 선택해야 한다" (필수 연계)
• rst_* = "A를 선택하면 B는 선택 불가" (불가 제약) WowPress의 이 두 패턴이 후니프린팅 ECA 시스템의 require_option / exclude_options에 대응됩니다.

자연어 변환의 3가지 출력 레벨:

1. 프리뷰 JSON — GLM이 반환하는 구조화 데이터 (확인용)
2. 확인 후 DB 저장 — recipe_constraints + constraint_nl_history에 트랜잭션 저장
3. Drizzle 스크립트 — 복잡한 복합 규칙의 경우 TypeScript 마이그레이션 스크립트 생성

1.2 GLM API 설정

// z.ai API — OpenAI 호환 인터페이스
// GLM_API_KEY — z.ai API 키 (필수, 서버 전용)
// GLM_MODEL   — glm-5.0 (기본) | glm-4.7 | glm-4.6
// GLM_BASE_URL — https://open.bigmodel.cn/api/paas/v4

const response = await client.chat.completions.create({
  model: process.env.GLM_MODEL ?? 'glm-5.0',
  messages: [
    { role: 'system', content: DOMAIN_SYSTEM_PROMPT },
    { role: 'user', content: nlText },
  ],
  response_format: { type: 'json_object' },
  temperature: 0.1,  // 일관성 우선
  max_tokens: 2000,  // 복합 규칙은 출력이 길어짐
});

---

2. 인쇄 도메인 용어 사전

2.1 옵션 타입 매핑 (WowPress ↔ 후니프린팅)

후니 타입 코드	WowPress 대응	한국어	허용값 예시
PAPER	paperinfo	용지/지질	아트지, 스노우지, 크라프트지, 투명PVC, OPP, 은PET, 금PET
PRINT	colorinfo	인쇄/도수	단면칼라, 양면칼라, 단면흑백, 화이트잉크
COATING	awkjobinfo (코팅)	코팅	없음, 무광PP, 유광PP, UV코팅, 에폭시
SIZE	sizeinfo	사이즈/규격	90×50, A4, A5, free(자유형)
PROCESS	awkjobinfo	후가공	박가공, 도무송, 오시, 미싱, 모서리, 접지
BINDING	awkjobinfo (제본)	제본	중철, 무선, PUR, 트윈링
PAGES	coverinfo pagecnt	페이지수	4의 배수
QTY	ordqty	수량	숫자
PRINT_METHOD	prsjobinfo	인쇄방식	오프셋, 디지털, 합판, 독판

2.2 WowPress 제약 패턴 → ECA 액션 매핑

WowPress 패턴	의미	ECA 액션
req_awkjob	해당 지질 선택 시 후가공 필수	require_option
req_color	해당 지질은 특정 도수만 가능	filter_options
req_width/height	비규격 시 치수 입력 필수	require_option
rst_prsjob	해당 지질은 특정 인쇄기 불가	exclude_options
rst_awkjob	후가공 상호 배제	exclude_options
rst_color	해당 지질은 특정 도수 불가	exclude_options
addtype: select/checkbox	추가 도수 선택 방식	show_addon_list

2.3 인쇄 용어 해설

용어	설명
도무송	칼금형으로 원하는 모양 재단
박가공	금박·은박 열전사 인쇄 (동판비 필수)
오시	접지용 눌림선 (책자 표지 필수)
미싱	뜯기 쉽도록 점선 구멍
동판비	박가공용 금형 제작비 (별도 상품)
칼선	재단 경계선 (도무송/자유형 필수)
합판	여러 작업을 한 판에 배치 (비용 절감)
독판	단일 작업만 인쇄 (품질 우선)
크립	중철 책자 내지 재단 보정값
책등	무선책자 등 두께

---

3. 8종 ECA 액션 타입 정의

type ConstraintAction =
  | { type: "exclude_options"; targetOption: string; excludeValues: string[] }
  // WowPress rst_* 패턴: A 선택 시 B 선택 불가
  // 예: 투명PVC → 무광PP, 유광PP 제거

  | { type: "filter_options"; targetOption: string; allowedValues: string[] }
  // WowPress req_color 패턴: A 선택 시 B는 이 값들만 허용
  // 예: 중철제본 → 페이지수 4의 배수만

  | { type: "show_addon_list"; addonGroupId: number }
  // WowPress addtype 패턴: 추가상품 그룹 UI 표시
  // 예: 현수막 → 설치부속품 목록

  | { type: "auto_add"; productId: number; qty: number }
  // WowPress 동반 필수 상품: 박가공 → 동판비 자동 추가
  // 예: 박가공 선택 → 동판비(id:244) 1개

  | { type: "require_option"; targetOption: string }
  // WowPress req_awkjob 패턴: A 선택 시 B 필수
  // 예: 도무송 → 칼선파일 업로드 필수

  | { type: "show_message"; level: "info" | "warn" | "error"; message: string }
  // 안내/경고/오류 메시지 표시
  // 예: 투명지 → 화이트잉크 안내

  | { type: "change_price_mode"; newMode: "LOOKUP" | "AREA" | "PAGE" | "COMPOSITE" }
  // 가격 계산 방식 전환
  // 예: 자유형 사이즈 → AREA 모드

  | { type: "set_default"; targetOption: string; defaultValue: string };
  // 기본값 변경
  // 예: 크라프트지 → 코팅 기본값을 "없음"으로

---

4. GLM 출력 형식 (4가지)

4.1 단일 ECA 규칙

interface SingleConstraintOutput {
  outputType: "single_constraint";
  constraintName: string;
  triggerOptionType: string;
  triggerOperator: "in" | "equals" | "gte" | "lte" | "not_in";
  triggerValues: string[];
  extraConditions?: object;           // AND/OR 복합 조건
  actions: ConstraintAction[];
  confidence: number;
  explanationKo: string;
  alternativeInterpretations?: SingleConstraintOutput[];
}

4.2 복합 ECA 규칙 묶음 (한 자연어 입력 → 여러 규칙)

interface CompositeConstraintOutput {
  outputType: "composite_constraints";
  totalRules: number;
  rules: SingleConstraintOutput[];    // 여러 독립 규칙
  executionOrder: number[];           // 규칙 적용 순서 (인덱스)
  sharedTrigger?: string;             // 공통 트리거가 있을 경우
  confidence: number;
  explanationKo: string;
}

4.3 수량할인 가격룰

interface QtyDiscountOutput {
  outputType: "qty_discount";
  qtyDiscountTiers: {
    qtyMin: number;
    qtyMax: number | null;
    discountRate: number;
    discountLabel: string;
  }[];
  confidence: number;
  explanationKo: string;
}

4.4 복합 가격+제약 규칙 (한 자연어 → 가격룰 + ECA 동시)

interface MixedRuleOutput {
  outputType: "mixed_rules";
  constraints: SingleConstraintOutput[];
  priceRules: QtyDiscountOutput | PriceModeOutput | null;
  totalActions: number;
  confidence: number;
  explanationKo: string;
  implementationScript?: string;  // TypeScript 스크립트 (복잡도 높을 때)
}

---

5. GLM 프롬프트 템플릿

5.1 마스터 시스템 프롬프트 (모든 변환 공통)

당신은 한국 인쇄업 ECA 규칙 설계 전문가입니다.
관리자의 자연어 설명을 구조화된 인쇄 규칙(ECA 제약조건 + 가격룰)으로 변환합니다.
반드시 JSON 형식으로만 응답하세요.

=== 핵심 원칙 ===
1. 한 문장에 여러 규칙이 있으면 outputType을 "composite_constraints" 또는 "mixed_rules"로 사용하세요
2. 가격 변경 + 제약조건이 동시에 나오면 "mixed_rules"로 처리하세요
3. A→B→C 연쇄 규칙은 executionOrder로 순서를 명시하세요
4. 확신도(confidence)가 낮을 때는 alternativeInterpretations를 1~2개 제공하세요

=== 옵션 타입 코드 ===
PAPER(용지), PRINT(인쇄/도수), COATING(코팅), SIZE(사이즈), PROCESS(후가공),
BINDING(제본), PAGES(페이지수), QTY(수량), PRINT_METHOD(인쇄방식)

=== WowPress req_*/rst_* 패턴 → ECA 변환 규칙 ===
req_awkjob → require_option (후가공 필수 연계)
req_color  → filter_options (도수 범위 제한)
rst_prsjob → exclude_options (인쇄방식 불가)
rst_awkjob → exclude_options (후가공 상호 배제)

5.2 ECA 변환 프롬프트 (단일/복합 자동 판단)

=== 8종 액션 타입 ===
exclude_options, filter_options, show_addon_list, auto_add,
require_option, show_message, change_price_mode, set_default

=== 출력 Schema 선택 기준 ===
- 단순 1개 규칙 → outputType: "single_constraint"
- 여러 독립 규칙 → outputType: "composite_constraints"
- 가격+제약 동시 → outputType: "mixed_rules"
- 수량할인만 → outputType: "qty_discount"

5.3 수량할인 변환 프롬프트

=== 출력 Schema ===
{
  "outputType": "qty_discount",
  "qtyDiscountTiers": [
    {"qtyMin": number, "qtyMax": number|null, "discountRate": number, "discountLabel": "string"}
  ],
  "confidence": 0.0~1.0,
  "explanationKo": "string"
}

주의: qtyMax가 null이면 "이상(상한 없음)"을 의미합니다.
discountRate는 0.0~1.0 범위입니다. (0.05 = 5%)

---

6. Few-shot 예제 — 단일 규칙 (8가지 기본 패턴)

6.1 exclude_options (WowPress rst_awkjob 패턴)

// 입력: "투명PVC 선택하면 PP코팅 못 쓰게 해줘"
{
  "outputType": "single_constraint",
  "constraintName": "투명PVC→PP코팅 제외",
  "triggerOptionType": "PAPER",
  "triggerOperator": "in",
  "triggerValues": ["투명PVC", "OPP"],
  "actions": [{"type": "exclude_options", "targetOption": "COATING", "excludeValues": ["무광PP", "유광PP"]}],
  "confidence": 0.98,
  "explanationKo": "투명 소재는 PP코팅이 불가합니다 (접착력 부족)"
}

6.2 auto_add (WowPress 동반 필수 상품 패턴)

// 입력: "박가공 선택하면 동판비 자동으로 장바구니에 추가"
{
  "outputType": "single_constraint",
  "constraintName": "박가공→동판비 자동추가",
  "triggerOptionType": "PROCESS",
  "triggerOperator": "in",
  "triggerValues": ["금박", "은박", "홀로그램"],
  "actions": [{"type": "auto_add", "productId": 244, "qty": 1}],
  "confidence": 0.95,
  "explanationKo": "박가공(금박/은박/홀로그램) 선택 시 동판비 상품을 자동으로 추가합니다"
}

6.3 show_addon_list (WowPress addtype 패턴)

// 입력: "현수막이나 배너 선택하면 설치부속품 추가상품 목록 보여줘"
{
  "outputType": "single_constraint",
  "constraintName": "현수막→설치부속품 표시",
  "triggerOptionType": "PAPER",
  "triggerOperator": "in",
  "triggerValues": ["현수막천", "메쉬", "터폴린"],
  "actions": [{"type": "show_addon_list", "addonGroupId": 12}],
  "confidence": 0.92,
  "explanationKo": "현수막 소재 선택 시 설치부속품(그로밋, 고리, 봉 등) 목록을 표시합니다"
}

6.4 filter_options (WowPress req_color 패턴)

// 입력: "중철제본은 페이지수를 4의 배수만 허용"
{
  "outputType": "single_constraint",
  "constraintName": "중철→페이지수 4배수 제한",
  "triggerOptionType": "BINDING",
  "triggerOperator": "equals",
  "triggerValues": ["중철"],
  "actions": [{"type": "filter_options", "targetOption": "PAGES", "allowedValues": ["4","8","12","16","20","24","28","32","36","40","44","48"]}],
  "confidence": 0.99,
  "explanationKo": "중철제본은 페이지수가 반드시 4의 배수여야 합니다"
}

6.5 require_option (WowPress req_awkjob 패턴)

// 입력: "도무송이나 자유형 컷 선택하면 칼선파일 업로드 필수로"
{
  "outputType": "single_constraint",
  "constraintName": "도무송→칼선파일 필수",
  "triggerOptionType": "PROCESS",
  "triggerOperator": "in",
  "triggerValues": ["도무송", "자유형컷"],
  "actions": [{"type": "require_option", "targetOption": "CUT_LINE_FILE"}],
  "confidence": 0.97,
  "explanationKo": "도무송/자유형 컷 선택 시 칼선 파일 업로드가 필수입니다"
}

6.6 show_message (안내/경고)

// 입력: "투명지나 OPP 선택하면 화이트잉크 필요하다고 경고"
{
  "outputType": "single_constraint",
  "constraintName": "투명지→화이트잉크 경고",
  "triggerOptionType": "PAPER",
  "triggerOperator": "in",
  "triggerValues": ["투명PVC", "OPP", "투명PET"],
  "actions": [{"type": "show_message", "level": "warn", "message": "투명 소재는 화이트잉크 인쇄를 권장합니다. 흰색 영역이 있는 경우 반드시 화이트잉크를 선택하세요."}],
  "confidence": 0.96,
  "explanationKo": "투명 소재 선택 시 화이트잉크 사용 안내 경고를 표시합니다"
}

6.7 change_price_mode (가격 모드 전환)

// 입력: "자유형이나 비규격 사이즈면 면적으로 가격 계산해줘"
{
  "outputType": "single_constraint",
  "constraintName": "자유형→면적형 가격계산",
  "triggerOptionType": "SIZE",
  "triggerOperator": "equals",
  "triggerValues": ["free", "자유형"],
  "actions": [{"type": "change_price_mode", "newMode": "AREA"}],
  "confidence": 0.94,
  "explanationKo": "자유형(비규격) 사이즈 선택 시 가격 계산을 면적형(㎡당 단가)으로 전환합니다"
}

6.8 set_default (기본값 변경)

// 입력: "크라프트지 선택하면 코팅을 기본적으로 없음으로 해줘"
{
  "outputType": "single_constraint",
  "constraintName": "크라프트지→코팅 기본값 없음",
  "triggerOptionType": "PAPER",
  "triggerOperator": "equals",
  "triggerValues": ["크라프트지"],
  "actions": [{"type": "set_default", "targetOption": "COATING", "defaultValue": "없음"}],
  "confidence": 0.91,
  "explanationKo": "크라프트지 특유의 질감 유지를 위해 코팅 기본값을 '없음'으로 설정합니다"
}

---

7. Few-shot 예제 — 복합 규칙 (composite_constraints)

7.1 박가공 → 동판비 + 코팅 제한 + 안내 (3가지 동시)

// 입력: "박가공 선택하면 동판비 자동추가하고, UV코팅만 허용하고, 에폭시 코팅은 못 쓰게 해줘. 그리고 박가공 주의사항도 안내해줘"
{
  "outputType": "composite_constraints",
  "totalRules": 3,
  "sharedTrigger": "PROCESS in [금박, 은박, 홀로그램]",
  "rules": [
    {
      "constraintName": "박가공→동판비 자동추가",
      "triggerOptionType": "PROCESS",
      "triggerOperator": "in",
      "triggerValues": ["금박", "은박", "홀로그램"],
      "actions": [{"type": "auto_add", "productId": 244, "qty": 1}],
      "confidence": 0.97
    },
    {
      "constraintName": "박가공→에폭시 코팅 제외",
      "triggerOptionType": "PROCESS",
      "triggerOperator": "in",
      "triggerValues": ["금박", "은박", "홀로그램"],
      "actions": [{"type": "exclude_options", "targetOption": "COATING", "excludeValues": ["에폭시"]}],
      "confidence": 0.93
    },
    {
      "constraintName": "박가공→주의사항 안내",
      "triggerOptionType": "PROCESS",
      "triggerOperator": "in",
      "triggerValues": ["금박", "은박", "홀로그램"],
      "actions": [{"type": "show_message", "level": "info", "message": "박가공은 별도 동판(금형) 제작이 필요합니다. 초도 주문 시 동판비가 자동으로 추가됩니다."}],
      "confidence": 0.98
    }
  ],
  "executionOrder": [2, 1, 0],
  "confidence": 0.94,
  "explanationKo": "박가공 선택 시 3가지 규칙이 동시에 적용됩니다: 동판비 자동추가, 에폭시 코팅 제외, 주의사항 안내"
}

7.2 무선책자 옵션 의존성 체인 (WowPress 선택 순서 패턴)

// 입력: "무선책자는 표지에 UV코팅만 허용하고, 내지는 코팅 안 되게 하고, 100페이지 이상이면 PUR제본 권장 안내해줘"
{
  "outputType": "composite_constraints",
  "totalRules": 3,
  "rules": [
    {
      "constraintName": "무선책자→표지 UV코팅만",
      "triggerOptionType": "BINDING",
      "triggerOperator": "equals",
      "triggerValues": ["무선"],
      "extraConditions": {"coverType": "COVER"},
      "actions": [{"type": "filter_options", "targetOption": "COATING", "allowedValues": ["없음", "UV코팅", "무광PP", "유광PP"]}],
      "confidence": 0.85
    },
    {
      "constraintName": "무선책자→내지 코팅 제외",
      "triggerOptionType": "BINDING",
      "triggerOperator": "equals",
      "triggerValues": ["무선"],
      "extraConditions": {"coverType": "INNER"},
      "actions": [{"type": "exclude_options", "targetOption": "COATING", "excludeValues": ["무광PP", "유광PP", "UV코팅", "에폭시"]}],
      "confidence": 0.92
    },
    {
      "constraintName": "무선책자→100P+ PUR 권장",
      "triggerOptionType": "PAGES",
      "triggerOperator": "gte",
      "triggerValues": ["100"],
      "extraConditions": {"binding": "무선"},
      "actions": [{"type": "show_message", "level": "info", "message": "100페이지 이상 무선책자는 PUR제본을 권장합니다. PUR제본은 내구성이 더 강합니다."}],
      "confidence": 0.88
    }
  ],
  "executionOrder": [0, 1, 2],
  "confidence": 0.88,
  "explanationKo": "무선책자 관련 3가지 규칙: 표지 코팅 제한, 내지 코팅 금지, 100P 이상 PUR 권장"
}

7.3 WowPress rst_* 다중 배제 패턴 (용지 + 인쇄기 + 후가공 동시 제약)

// 입력: "은PET 용지는 UV코팅만 가능하고, 오프셋 인쇄기 못 쓰고, 수성코팅도 안 되고, 투명PET랑 같이 합판 못 해"
{
  "outputType": "composite_constraints",
  "totalRules": 4,
  "sharedTrigger": "PAPER in [은PET, 금PET]",
  "rules": [
    {
      "constraintName": "은/금PET→UV코팅만 허용",
      "triggerOptionType": "PAPER",
      "triggerOperator": "in",
      "triggerValues": ["은PET", "금PET"],
      "actions": [{"type": "filter_options", "targetOption": "COATING", "allowedValues": ["없음", "UV코팅"]}],
      "confidence": 0.93
    },
    {
      "constraintName": "은/금PET→오프셋 불가",
      "triggerOptionType": "PAPER",
      "triggerOperator": "in",
      "triggerValues": ["은PET", "금PET"],
      "actions": [{"type": "exclude_options", "targetOption": "PRINT_METHOD", "excludeValues": ["오프셋", "오프셋합판"]}],
      "confidence": 0.96
    },
    {
      "constraintName": "은/금PET→수성코팅 불가",
      "triggerOptionType": "PAPER",
      "triggerOperator": "in",
      "triggerValues": ["은PET", "금PET"],
      "actions": [{"type": "exclude_options", "targetOption": "COATING", "excludeValues": ["수성코팅"]}],
      "confidence": 0.94
    },
    {
      "constraintName": "은/금PET→특수소재 안내",
      "triggerOptionType": "PAPER",
      "triggerOperator": "in",
      "triggerValues": ["은PET", "금PET"],
      "actions": [{"type": "show_message", "level": "info", "message": "메탈릭 소재는 독판(단독) 인쇄로만 처리됩니다. 합판 진행이 불가합니다."}],
      "confidence": 0.90
    }
  ],
  "executionOrder": [0, 1, 2, 3],
  "confidence": 0.93,
  "explanationKo": "은/금PET 메탈릭 소재의 4가지 제약: UV코팅만 허용, 오프셋 불가, 수성코팅 불가, 독판 안내"
}

---

8. Few-shot 예제 — 복합 가격+제약 혼합 (mixed_rules)

8.1 스티커 자유형 사이즈 → 면적가격 + 칼선 필수 + 할증 안내

// 입력: "스티커에서 자유형 모양 선택하면, 면적으로 가격 계산하고, 칼선파일 필수로 하고, 비규격이라 20% 할증된다고 안내해줘"
{
  "outputType": "mixed_rules",
  "constraints": [
    {
      "constraintName": "자유형→면적형 가격계산",
      "triggerOptionType": "SIZE",
      "triggerOperator": "equals",
      "triggerValues": ["free", "자유형"],
      "actions": [{"type": "change_price_mode", "newMode": "AREA"}],
      "confidence": 0.95
    },
    {
      "constraintName": "자유형→칼선파일 필수",
      "triggerOptionType": "SIZE",
      "triggerOperator": "equals",
      "triggerValues": ["free", "자유형"],
      "actions": [{"type": "require_option", "targetOption": "CUT_LINE_FILE"}],
      "confidence": 0.97
    },
    {
      "constraintName": "자유형→비규격 할증 안내",
      "triggerOptionType": "SIZE",
      "triggerOperator": "equals",
      "triggerValues": ["free", "자유형"],
      "actions": [{"type": "show_message", "level": "warn", "message": "비규격(자유형) 스티커는 면적 단가에 20% 비규격 할증이 적용됩니다."}],
      "confidence": 0.89
    }
  ],
  "priceRules": null,
  "totalActions": 3,
  "confidence": 0.93,
  "explanationKo": "자유형 스티커: 면적형 가격 전환 + 칼선 파일 필수 + 할증 안내 (3가지 동시)"
}

8.2 수량할인 + 오프셋 인쇄 시 할인 추가 (가격+제약 혼합)

// 입력: "명함 100장 이상 5%, 500장 이상 10% 할인. 오프셋 합판 선택하면 추가로 5% 더 할인된다고 안내해줘"
{
  "outputType": "mixed_rules",
  "constraints": [
    {
      "constraintName": "합판인쇄→추가할인 안내",
      "triggerOptionType": "PRINT_METHOD",
      "triggerOperator": "in",
      "triggerValues": ["오프셋합판", "디지털합판"],
      "actions": [{"type": "show_message", "level": "info", "message": "합판 인쇄 선택 시 수량할인에 추가 5% 할인이 적용됩니다."}],
      "confidence": 0.87
    }
  ],
  "priceRules": {
    "outputType": "qty_discount",
    "qtyDiscountTiers": [
      {"qtyMin": 1,    "qtyMax": 99,   "discountRate": 0,    "discountLabel": "기본가"},
      {"qtyMin": 100,  "qtyMax": 499,  "discountRate": 0.05, "discountLabel": "소량할인"},
      {"qtyMin": 500,  "qtyMax": null, "discountRate": 0.10, "discountLabel": "중량할인"}
    ],
    "confidence": 0.97,
    "explanationKo": "100~499장 5%, 500장 이상 10% 수량할인"
  },
  "totalActions": 4,
  "confidence": 0.91,
  "explanationKo": "수량할인 2구간 + 합판 선택 시 추가 할인 안내 혼합 규칙"
}

8.3 책자 페이지형 가격 + 표지 옵션 + 오시 필수 (3도메인 혼합)

// 입력: "책자는 페이지수로 가격 계산하고, 표지는 200g 이상 용지만 쓰고, 표지에 오시 자동으로 넣어줘. 그리고 200페이지 넘으면 PUR제본 권장"
{
  "outputType": "mixed_rules",
  "constraints": [
    {
      "constraintName": "책자→200g이상 표지만",
      "triggerOptionType": "BINDING",
      "triggerOperator": "in",
      "triggerValues": ["무선", "PUR", "중철"],
      "extraConditions": {"coverType": "COVER"},
      "actions": [{"type": "filter_options", "targetOption": "PAPER", "allowedValues": ["아트지200g", "스노우지200g", "랑데뷰200g", "크라운지250g"]}],
      "confidence": 0.86
    },
    {
      "constraintName": "책자표지→오시 자동설정",
      "triggerOptionType": "BINDING",
      "triggerOperator": "in",
      "triggerValues": ["무선", "PUR"],
      "actions": [{"type": "set_default", "targetOption": "PROCESS", "defaultValue": "오시"}],
      "confidence": 0.91
    },
    {
      "constraintName": "200P이상→PUR 권장",
      "triggerOptionType": "PAGES",
      "triggerOperator": "gte",
      "triggerValues": ["200"],
      "actions": [{"type": "show_message", "level": "warn", "message": "200페이지 이상 책자는 내구성을 위해 PUR제본을 강력 권장합니다. 무선제본 시 벌어짐 위험이 있습니다."}],
      "confidence": 0.93
    }
  ],
  "priceRules": {
    "outputType": "price_mode_suggestion",
    "priceModeRecommendation": {
      "mode": "PAGE",
      "reasoning": "책자는 페이지수와 인쇄방식(표지/내지 구분)으로 원가가 결정됩니다. PAGE 모드가 가장 적합합니다."
    },
    "confidence": 0.96,
    "explanationKo": "책자 → PAGE 모드(페이지형) 가격 계산 권장"
  },
  "totalActions": 4,
  "confidence": 0.90,
  "explanationKo": "책자 4가지 복합 규칙: 페이지형 가격모드 + 표지 용지 제한 + 오시 기본값 + 200P PUR 권장"
}

---

9. Few-shot 예제 — 연쇄 규칙 (A→B→C 체인)

9.1 비규격 → 면적가격 → 최소면적 경고 체인

// 입력: "자유형 사이즈 선택하면 면적 계산으로 바꾸고, 면적이 0.05㎡ 미만이면 최소 주문 면적 경고를 띄워줘"
{
  "outputType": "composite_constraints",
  "totalRules": 2,
  "rules": [
    {
      "constraintName": "자유형→면적가격 전환",
      "triggerOptionType": "SIZE",
      "triggerOperator": "equals",
      "triggerValues": ["free"],
      "actions": [{"type": "change_price_mode", "newMode": "AREA"}],
      "confidence": 0.95,
      "ruleOrder": 1
    },
    {
      "constraintName": "소면적→최소주문 경고",
      "triggerOptionType": "SIZE",
      "triggerOperator": "lte",
      "triggerValues": ["0.05"],
      "extraConditions": {"unit": "sqm", "priceMode": "AREA"},
      "actions": [{"type": "show_message", "level": "error", "message": "최소 주문 면적은 0.05㎡(500㎠)입니다. 사이즈를 다시 확인해주세요."}],
      "confidence": 0.88,
      "ruleOrder": 2,
      "dependsOn": "자유형→면적가격 전환"
    }
  ],
  "executionOrder": [0, 1],
  "confidence": 0.91,
  "explanationKo": "자유형 선택 → 면적 가격 모드 전환 → 최소 면적 미만이면 오류 안내 (2단계 체인)"
}

9.2 중철제본 → 페이지수 4배수 → 짝수 확인 체인

// 입력: "중철제본이면 페이지수 4배수만 되고, 만약 4배수인데 크립 보정이 필요한 40장 이상이면 안내해줘"
{
  "outputType": "composite_constraints",
  "totalRules": 2,
  "rules": [
    {
      "constraintName": "중철→4배수 페이지만",
      "triggerOptionType": "BINDING",
      "triggerOperator": "equals",
      "triggerValues": ["중철"],
      "actions": [{"type": "filter_options", "targetOption": "PAGES", "allowedValues": ["4","8","12","16","20","24","28","32","36","40","44","48","52","56","60","64"]}],
      "confidence": 0.99,
      "ruleOrder": 1
    },
    {
      "constraintName": "중철40P이상→크립보정 안내",
      "triggerOptionType": "PAGES",
      "triggerOperator": "gte",
      "triggerValues": ["40"],
      "extraConditions": {"binding": "중철"},
      "actions": [{"type": "show_message", "level": "info", "message": "중철제본 40페이지 이상은 크립(creep) 보정이 필요합니다. 내지 바깥쪽 내용이 잘리지 않도록 여백을 여유있게 잡아주세요."}],
      "confidence": 0.92,
      "ruleOrder": 2
    }
  ],
  "executionOrder": [0, 1],
  "confidence": 0.95,
  "explanationKo": "중철 → 4배수 페이지 제한 → 40P 이상이면 크립 보정 안내"
}

---

10. Few-shot 예제 — TypeScript 스크립트 생성 (복잡 규칙)

복잡도가 높은 복합 규칙의 경우 GLM이 직접 실행 가능한 TypeScript 코드를 생성합니다.

10.1 NL → Drizzle 삽입 스크립트

// 입력: "도무송 스티커 상품에 다음 규칙들 한꺼번에 넣어줘:
//   1. 자유형 선택하면 칼선파일 필수
//   2. 투명PVC 선택하면 PP코팅 제외
//   3. 박가공 선택하면 동판비(id:244) 자동추가
//   4. 100장부터 5%, 500장부터 10% 할인"
{
  "outputType": "mixed_rules",
  "constraints": [
    {
      "constraintName": "자유형→칼선파일 필수",
      "triggerOptionType": "SIZE",
      "triggerOperator": "equals",
      "triggerValues": ["free"],
      "actions": [{"type": "require_option", "targetOption": "CUT_LINE_FILE"}],
      "confidence": 0.97
    },
    {
      "constraintName": "투명PVC→PP코팅 제외",
      "triggerOptionType": "PAPER",
      "triggerOperator": "in",
      "triggerValues": ["투명PVC", "OPP"],
      "actions": [{"type": "exclude_options", "targetOption": "COATING", "excludeValues": ["무광PP", "유광PP"]}],
      "confidence": 0.98
    },
    {
      "constraintName": "박가공→동판비 자동추가",
      "triggerOptionType": "PROCESS",
      "triggerOperator": "in",
      "triggerValues": ["금박", "은박", "홀로그램"],
      "actions": [{"type": "auto_add", "productId": 244, "qty": 1}],
      "confidence": 0.95
    }
  ],
  "priceRules": {
    "outputType": "qty_discount",
    "qtyDiscountTiers": [
      {"qtyMin": 1,   "qtyMax": 99,   "discountRate": 0,    "discountLabel": "기본가"},
      {"qtyMin": 100, "qtyMax": 499,  "discountRate": 0.05, "discountLabel": "소량할인"},
      {"qtyMin": 500, "qtyMax": null, "discountRate": 0.10, "discountLabel": "대량할인"}
    ],
    "confidence": 0.97,
    "explanationKo": "100~499장 5%, 500장 이상 10% 수량할인"
  },
  "totalActions": 4,
  "confidence": 0.96,
  "explanationKo": "도무송 스티커 4가지 복합 규칙",
  "implementationScript": "// Auto-generated by GLM NL Builder\n// 실행 전 recipeId와 productId를 실제 값으로 교체하세요\n\nimport { db } from '@/packages/db';\nimport { recipeConstraints, qtyDiscount } from '@/packages/db/schema';\n\nasync function applyRules(recipeId: number, productId: number) {\n  await db.transaction(async (tx) => {\n    // Rule 1: 자유형→칼선파일 필수\n    await tx.insert(recipeConstraints).values({\n      recipeId,\n      inputMode: 'nl',\n      constraintName: '자유형→칼선파일 필수',\n      triggerOptionType: 'SIZE',\n      triggerOperator: 'equals',\n      triggerValues: JSON.stringify(['free']),\n      actions: JSON.stringify([{type: 'require_option', targetOption: 'CUT_LINE_FILE'}]),\n      isActive: true,\n    });\n\n    // Rule 2: 투명PVC→PP코팅 제외\n    await tx.insert(recipeConstraints).values({\n      recipeId,\n      inputMode: 'nl',\n      constraintName: '투명PVC→PP코팅 제외',\n      triggerOptionType: 'PAPER',\n      triggerOperator: 'in',\n      triggerValues: JSON.stringify(['투명PVC', 'OPP']),\n      actions: JSON.stringify([{type: 'exclude_options', targetOption: 'COATING', excludeValues: ['무광PP', '유광PP']}]),\n      isActive: true,\n    });\n\n    // Rule 3: 박가공→동판비 자동추가\n    await tx.insert(recipeConstraints).values({\n      recipeId,\n      inputMode: 'nl',\n      constraintName: '박가공→동판비 자동추가',\n      triggerOptionType: 'PROCESS',\n      triggerOperator: 'in',\n      triggerValues: JSON.stringify(['금박', '은박', '홀로그램']),\n      actions: JSON.stringify([{type: 'auto_add', productId: 244, qty: 1}]),\n      isActive: true,\n    });\n\n    // Rule 4: 수량할인 구간\n    await tx.insert(qtyDiscount).values([\n      { productId, qtyMin: 1,   qtyMax: 99,   discountRate: '0.00', label: '기본가' },\n      { productId, qtyMin: 100, qtyMax: 499,  discountRate: '0.05', label: '소량할인' },\n      { productId, qtyMin: 500, qtyMax: null, discountRate: '0.10', label: '대량할인' },\n    ]);\n  });\n}"
}

10.2 스크립트 추출 및 실행 패턴

// GLM 응답에서 implementationScript 추출 후 파일로 저장
async function handleMixedRuleWithScript(
  output: MixedRuleOutput,
  recipeId: number,
  productId: number
): Promise<void> {
  if (output.implementationScript) {
    // 스크립트를 임시 파일로 저장
    const scriptPath = `scripts/generated/rule-${Date.now()}.ts`;
    await fs.writeFile(scriptPath, output.implementationScript);

    // 관리자 UI에서 "스크립트 다운로드" 버튼 제공
    // 또는 서버에서 eval() 없이 안전하게 실행 (보안 중요!)
    console.log(`Generated script saved to: ${scriptPath}`);
  }

  // 직접 DB 저장 경로 (스크립트 대신)
  await confirmRules(output.constraints, output.priceRules, recipeId, productId);
}

---

11. Few-shot 예제 — 수량할인 (다양한 패턴)

11.1 기본 3구간 할인

// 입력: "100장 이상 5%, 500장부터 10%, 1000장 이상 15%"
{
  "outputType": "qty_discount",
  "qtyDiscountTiers": [
    {"qtyMin": 1,    "qtyMax": 99,   "discountRate": 0,    "discountLabel": "기본가"},
    {"qtyMin": 100,  "qtyMax": 499,  "discountRate": 0.05, "discountLabel": "소량할인"},
    {"qtyMin": 500,  "qtyMax": 999,  "discountRate": 0.10, "discountLabel": "중량할인"},
    {"qtyMin": 1000, "qtyMax": null, "discountRate": 0.15, "discountLabel": "대량특가"}
  ],
  "confidence": 0.97,
  "explanationKo": "4구간 수량할인: 기본/소량/중량/대량"
}

11.2 단순 2구간

// 입력: "50장까지 정가, 51장부터 3% 할인"
{
  "outputType": "qty_discount",
  "qtyDiscountTiers": [
    {"qtyMin": 1,  "qtyMax": 50,   "discountRate": 0,    "discountLabel": "기본가"},
    {"qtyMin": 51, "qtyMax": null, "discountRate": 0.03, "discountLabel": "수량할인"}
  ],
  "confidence": 0.98,
  "explanationKo": "50장 이하 정가, 51장 이상 3% 할인"
}

11.3 후가공 조건부 할인 (복합)

// 입력: "500장 이상이면 10% 할인. 단, 박가공 포함하면 할인 없어 (박가공은 수량할인 적용 안 됨)"
{
  "outputType": "mixed_rules",
  "constraints": [
    {
      "constraintName": "박가공→수량할인 제외 안내",
      "triggerOptionType": "PROCESS",
      "triggerOperator": "in",
      "triggerValues": ["금박", "은박", "홀로그램"],
      "actions": [{"type": "show_message", "level": "warn", "message": "박가공 포함 주문은 수량할인이 적용되지 않습니다."}],
      "confidence": 0.89
    }
  ],
  "priceRules": {
    "outputType": "qty_discount",
    "qtyDiscountTiers": [
      {"qtyMin": 1,   "qtyMax": 499,  "discountRate": 0,    "discountLabel": "기본가"},
      {"qtyMin": 500, "qtyMax": null, "discountRate": 0.10, "discountLabel": "대량할인"}
    ],
    "confidence": 0.92,
    "explanationKo": "500장 이상 10% 할인 (박가공 제외)"
  },
  "totalActions": 2,
  "confidence": 0.90,
  "explanationKo": "수량할인 + 박가공 예외 안내 혼합 규칙"
}

---

12. 가격 모드 제안 (price_mode_suggestion)

12.1 4가지 모드 선택 기준

LOOKUP (단가표형) — 적합:
  - 규격이 정해진 상품 (명함 90×50, 전단지 A4 등)
  - 수량별 단가표가 있는 상품
  - 예: 수량 100장 → 단가 150원 → 총 15,000원

AREA (면적형) — 적합:
  - 비규격, 자유형 사이즈 상품
  - 현수막, 배너, 대형 스티커, 롤업
  - 예: 90cm × 180cm → 1.62㎡ × 45,000원/㎡

PAGE (페이지형) — 적합:
  - 책자, 브로셔, 카탈로그
  - 표지/내지 구분, 페이지수, 제본 방식이 원가 결정
  - 예: 32페이지 무선 → 내지 출력비 + 표지 + 제본비

COMPOSITE (복합가산형) — 적합:
  - 기본비 + 후가공 옵션별 추가비 합산 상품
  - 박가공+도무송+코팅 등 복합 후가공 상품
  - 예: 기본 10,000원 + 박가공 5,000원 + 도무송 3,000원

12.2 가격 모드 제안 예제

// 입력: "배너나 현수막처럼 크기가 다양한 상품은 어떤 가격 계산이 좋아?"
{
  "outputType": "mixed_rules",
  "constraints": [],
  "priceRules": {
    "outputType": "price_mode_suggestion",
    "priceModeRecommendation": {
      "mode": "AREA",
      "reasoning": "배너/현수막은 고객이 직접 가로×세로를 입력하는 비규격 상품입니다. 면적(㎡)당 단가로 계산하는 AREA 모드가 가장 적합합니다. 최소 주문 면적(min_area_sqm)을 설정하여 소량 주문도 관리하세요."
    },
    "confidence": 0.97,
    "explanationKo": "배너/현수막 → AREA 모드 권장"
  },
  "totalActions": 1,
  "confidence": 0.97,
  "explanationKo": "비규격 사이즈 상품에 AREA(면적형) 가격 모드를 권장합니다"
}

---

13. DB 스키마 참조

13.1 price_nl_history (신규 — SPEC-WB-007)

// packages/db/src/schema/widget/04-price-nl-history.ts
export const priceNlHistory = pgTable('price_nl_history', {
  id: serial('id').primaryKey(),
  productId: integer('product_id').notNull()
    .references(() => wbProducts.id, { onDelete: 'cascade' }),
  priceConfigId: integer('price_config_id')
    .references(() => productPriceConfigs.id, { onDelete: 'set null' }),
  ruleType: varchar('rule_type', { length: 30 }).notNull(),
  // 'qty_discount' | 'price_mode' | 'postprocess' | 'formula_hint' | 'mixed'
  nlInputText: text('nl_input_text').notNull(),
  nlInterpretation: jsonb('nl_interpretation'),  // GLM 전체 응답 (composite/mixed 포함)
  aiModelVersion: varchar('ai_model_version', { length: 50 }),
  interpretationScore: decimal('interpretation_score', { precision: 3, scale: 2 }),
  totalRulesGenerated: integer('total_rules_generated').default(1),  // composite/mixed 규칙 수
  isApproved: boolean('is_approved').notNull().default(false),
  approvedBy: varchar('approved_by', { length: 100 }),
  approvedAt: timestamp('approved_at', { withTimezone: true }),
  appliedTiers: jsonb('applied_tiers'),     // 승인 후 저장된 qty_discount 배열
  appliedConstraintIds: jsonb('applied_constraint_ids'),  // 승인 후 생성된 constraint id 배열
  generatedScript: text('generated_script'), // TypeScript 스크립트 (복잡 규칙)
  deviationNote: text('deviation_note'),
  createdBy: varchar('created_by', { length: 100 }).notNull(),
  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
}, (t) => [
  index('idx_pnh_product').on(t.productId),
  index('idx_pnh_rule_type').on(t.ruleType),
  index('idx_pnh_approved').on(t.isApproved, t.productId),
]);

13.2 기존 연계 테이블

recipe_constraints (03-recipe-constraints.ts)
  - inputMode: 'manual' | 'template' | 'nl'  ← NL 변환 결과 저장
  - triggerOptionType, triggerOperator, triggerValues (JSONB)
  - actions (JSONB) — 8종 액션 배열

constraint_nl_history (03-constraint-nl-history.ts)
  - ECA 제약 NL 히스토리 감사 로그 (기존, SPEC-WB-003)

product_price_configs (04-product-price-configs.ts)
  - priceMode: 'LOOKUP' | 'AREA' | 'PAGE' | 'COMPOSITE'
  - formulaText — 관리자 메모용 공식 텍스트

recipe_choice_restrictions
  - WowPress rst_* 패턴의 영구 제약 (Allow/Exclude)

---

14. tRPC 엔드포인트 인터페이스

// apps/web/app/api/trpc/routers/glm.router.ts

// 모든 타입 변환 (outputType 자동 판단)
const convertRule = protectedProcedure
  .input(z.object({
    recipeId: z.number().optional(),
    productId: z.number().optional(),
    nlText: z.string().min(5).max(1000),        // 복합 규칙은 길어질 수 있음
    ruleHint: z.enum(['constraint', 'price', 'composite', 'auto']).default('auto'),
    availableOptions: z.array(z.string()).optional(),
    availableValues: z.record(z.array(z.string())).optional(),
  }))
  .mutation(async ({ input }) => {
    // outputType에 따라 single/composite/mixed/qty_discount 반환
    // implementationScript 포함 가능
  });

// 일괄 승인 (composite/mixed 여러 규칙 동시)
const confirmRules = protectedProcedure
  .input(z.object({
    recipeId: z.number(),
    productId: z.number(),
    nlText: z.string(),
    conversion: z.union([
      SingleConstraintOutputSchema,
      CompositeConstraintOutputSchema,
      QtyDiscountOutputSchema,
      MixedRuleOutputSchema,
    ]),
    approvedBy: z.string(),
  }))
  .mutation(async ({ input, ctx }) => {
    // outputType에 따라 분기 처리
    // composite → 여러 recipe_constraints 트랜잭션 삽입
    // mixed → constraints + qty_discount 동시 삽입
    // price_mode → product_price_configs 업데이트
    // 모든 경우 price_nl_history 또는 constraint_nl_history 기록
  });

---

15. 구현 주의사항

15.1 복합 규칙 트랜잭션 보장

// composite/mixed 규칙은 반드시 트랜잭션으로 묶어야 함
// 일부만 저장되면 데이터 불일치 발생
await db.transaction(async (tx) => {
  for (const constraint of constraints) {
    await tx.insert(recipeConstraints).values({...});
  }
  if (priceRules?.outputType === 'qty_discount') {
    await tx.insert(qtyDiscount).values(priceRules.qtyDiscountTiers.map(...));
  }
  await tx.insert(priceNlHistory).values({
    totalRulesGenerated: constraints.length + (priceRules ? 1 : 0),
    ...
  });
});

15.2 outputType 자동 판단 로직

function detectOutputType(nlText: string): 'constraint' | 'price' | 'auto' {
  const priceKeywords = ['할인', '% 할인', '수량', '구간', '가격 계산', '면적', '페이지형'];
  const constraintKeywords = ['못 쓰게', '제외', '필수', '안 되', '자동 추가', '안내'];

  const hasPrice = priceKeywords.some(kw => nlText.includes(kw));
  const hasConstraint = constraintKeywords.some(kw => nlText.includes(kw));

  if (hasPrice && hasConstraint) return 'auto';  // GLM이 mixed_rules로 판단
  if (hasPrice) return 'price';
  if (hasConstraint) return 'constraint';
  return 'auto';
}

15.3 GLM_API_KEY 보안

// 서버 전용 — 절대 클라이언트 노출 금지
if (typeof window !== 'undefined') {
  throw new Error('GLM service: server-only module');
}

---

16. 관련 파일 위치

SPEC:                .moai/specs/SPEC-WB-007/spec.md
Plan:                .moai/specs/SPEC-WB-007/plan.md

WowPress 도메인:     .claude/skills/innojini-wowpress/SKILL.md
인쇄 기초:           .claude/skills/innojini-printing-foundation/SKILL.md
DB 스키마 참조:      .claude/skills/innojini-huni-db-schema/SKILL.md

DB Schema:           packages/db/src/schema/widget/04-price-nl-history.ts (신규)
                     packages/db/src/schema/widget/03-constraint-nl-history.ts (기존 참조)
                     packages/db/src/schema/widget/03-recipe-constraints.ts (기존 참조)

Backend:             apps/web/app/api/_lib/services/glm.service.ts (신규)
                     apps/web/app/api/trpc/routers/glm.router.ts (신규)
                     apps/web/app/api/trpc/utils/constraint-transformer.ts (신규)
                     apps/web/app/api/trpc/utils/price-rule-transformer.ts (신규)
                     apps/web/app/api/trpc/router.ts (수정)

Admin UI:            apps/admin/src/components/glm/nl-rule-panel.tsx (신규)
                     apps/admin/src/components/glm/conversion-preview.tsx (신규)
                     apps/admin/src/hooks/use-glm-convert.ts (신규)

Tests:               apps/web/__tests__/services/glm.test.ts
                     apps/web/__tests__/utils/constraint-transformer.test.ts
                     apps/web/__tests__/utils/price-rule-transformer.test.ts
                     apps/web/__tests__/pricing/glm-router.test.ts
                     packages/db/__tests__/schema/price-nl-history.test.ts

---

Version: 2.0.0 SPEC: SPEC-WB-007 Updated: 2026-02-27 Changes from 1.0.0:

• Added WowPress req_/rst_ pattern mapping
• Added composite_constraints outputType (multi-rule)
• Added mixed_rules outputType (price + constraint)
• Added chain rules with executionOrder (A→B→C)
• Added TypeScript/Drizzle script generation
• Added 15+ new few-shot examples (expanded from 8)
• Added automatic outputType detection logic
• Added transaction guarantee for composite rules