Free Poker Decision Test — Analyze Your Playing Style

HoldemDNA Engineering Contract (SSOT/Trigger/Version Rules) v1.0
- 이 블록은 운영 기준(계약서)이며, 코드 수정 전에 반드시 읽는다.

[베이스]
BASE_HTML: TEST_V31_1226_NO_INSIGHT_TRIGGERS_CONF_FINAL_v34_readingtime_tokens.html
MINI_REPORT_SSOT_JSON: HDNA_chapter_mini_reports_13Q_KR_SSOT_v1.4.6_bridge_partial_midcheck_Q36.json

[핵심 요약]
- 문제는 '파싱'이 아니라 'QID 계약(SSOT-HTML) 불일치'로 인한 매칭 실패였다.
- confirm()은 blocking 팝업이라 챕터 종료 UI 렌더 타이밍을 끊어 불안정해질 수 있다.
- 해결은 2단계:
  (1) SSOT의 trigger_qid를 100% strict suffix(Qxx-MTT/Qxx-CG)로 통일
  (2) 챕터 종료 트리거를 단 한 곳(챕터 엔드 판정 지점)에 고정하고,
      confirm은 '다음 챕터로' CTA 뒤로 미룬다.

[Rules]
RULE 1: QID strict suffix 100% (Qxx 금지)
RULE 2: CURRENT_MODE 단일 SSOT 변수 고정, 추론 금지
RULE 3: QID 정규화 함수 1개로 통일
RULE 4: 미니리포트 트리거 위치 단 1곳
RULE 5: confirm/저장/잠금은 미니리포트 CTA 뒤로
RULE 6: 미니리포트는 Read-only
RULE 7: 베이스 1개 + PATCH 누적(버전 혼용 금지)

[Free 10 Placeholder]
- 챕터0(프리 10문항) 종료: placeholder 표시(문구만)
- CTA '프리미엄 결제하기' 클릭: 즉시 챕터1 시작(결제/UI는 나중)

[File naming]
HTML: TEST_V31_1226_BASE_v34_PATCH01_.html ...
JSON: ...v1.4.6a_SUFFIX_STRICT.json / ...v1.4.6b_.json

[Pricing & Usage Limits SSOT] (2026-04-30, KST 정책 update)
- Free Report: 1일 제한 제거 → stateless 1회 체험 (옛 박제: feedback_free_stateless_policy.md)
- Premium MTT: USD $49 / KRW 49,000 / JPY 4,900
- Premium CG: USD $49 / KRW 49,000 / JPY 4,900
- All-in-One (MTT+CG): USD $79 / KRW 79,000 / JPY 7,900

[Premium Credits 정책(리포트 생성 횟수)]
- 모든 유료 SKU는 "프리미엄 리포트 생성(Generate)" 2회까지 (credits=2)
- credits 차감 시점: 최종 프리미엄 리포트 '생성(Generate)' 순간
- credits=0(3회째)면 리포트 생성/오픈 차단 + 구매 안내

[Free 2회 소진 → Premium 전환 UX]
- 무료 리포트 일일 2회 소진 시: "프리미엄으로 진행하기" 안내 모달만 노출(재응답 질문 금지)
- 프리미엄 시작 전: "1–10번 다시 풀까요?" 모달(다시 풀고 시작 / 그대로 시작 / 취소)
  * credits=0이면 이 모달도 띄우지 말고 즉시 차단

[All-in-One 사용 방식]
- MTT/CG 모두 선택 가능. 단, 프리미엄 리포트 생성 크레딧은 총 2회(전체 합산)
- 2회 안에서 MTT/CG를 섞어 사용 가능 (예: MTT 1회 + CG 1회)

Free Poker Decision Test — Analyze Your Playing Style | HoldemDNA

CANONICAL BASE

HoldemDNA Engineering Contract · v34 LOCKED

단일 베이스 1개만 유지. 패치는 PATCH ID로만 증가. (파일 섞기 금지)

Updated: 2026-01-11

1) 운영 규칙 (지옥 탈출 규약)

베이스는 1개: 이 파일만 기준. 다른 HTML은 "참고/폐기"로 분류.
한 번에 하나: 1 PATCH = 1 변경. (워크스트림 섞지 않음)
분업 고정: JACKP1은 HTML 코어만, JACKP2는 SSOT(JSON)만.
완료 기준(DOD): 완료는 스샷 1장(또는 재현 스텝)으로만 인정.

베이스 파일명: HDNA_CANONICAL_BASE_v34_LOCKED_v1.html 패치 파일명: HDNA_PATCH_###__{WS}__{SHORT}.html

2) QID 계약 (SSOT)

UI 표시용: Q20 (suffix 없음)
엔진키(QID_KEY): Q20-MTT 또는 Q20-CG
금지: 어떤 곳은 Q20, 어떤 곳은 Q20-MTT 같은 "혼종" 상태
원칙: 저장/트리거/SSOT lookup은 무조건 QID_KEY로만.

주의: suffix(-MTT/-CG)는 "한 함수(한 지점)"에서만 붙인다. (재발 방지)

3) 워크스트림 체크리스트 (진행/완료/아카이브)

WS	설명	Owner	Status	Next Patch
WS-A MiniReport	챕터 종료 미니리포트 트리거 단일화 + QID_KEY strict + CTA 뒤 저장(confirm 이동)	JACKP1	IN PROGRESS	`PATCH-001`
WS-B Free10	FREE10 OneCard 라벨 엔진. (SSOT 라벨 ID 계약 잠금 완료, 이제 show 트리거만 고정)	JACKP2/1	PENDING	`PATCH-0B1`
WS-C Limits	1일 제한 제거 → 건바이건 누적 정책	JACKP1	OBSOLETE	`PATCH-0C1`
WS-D Premium Entry	프리미엄 진입: "1–10 재응시?" 모달 + 모드(MTT/CG) 고정 + 올인원(79)	JACKP1	PENDING	`PATCH-0D1`

완료되면 해당 항목은 아래 "DONE ARCHIVE"로 이동하고 PATCH Ledger에 기록한다.

4) PATCH Ledger (append-only)

PATCH-000 (BASE) v34를 Canonical로 잠금 + 운영 규약/체크리스트 삽입
PATCH-001 (WS-A QID) EngineKey Factory 단일화: HDNA_getEngineKey() 도입 + HDNA_qkey는 alias로 유지

DONE ARCHIVE (완료 항목은 여기로 이동)

완료 항목은 "언제/무엇/PATCH"를 남기고 아래로 이동. 상단 체크리스트는 항상 '진행중'만 남긴다.

5) 편집 구역(필수)

JACKP1(HTML 코어): HDNA_nextQuestionCore(), HDNA_handleChapterEnd(), MiniReport 렌더/트리거
JACKP2(SSOT): FREE10 라벨팩/맵핑 JSON만 수정 (HTML 코어 금지)
금지: 다른 방에서 만든 HTML을 그대로 덮어씌우기(파일 섞기)