헤이디

스키마 확정 (설계 + 적대적 교차검증 반영)¶

Wave 0 워크플로(분석3 + 설계1 + 적대적검증2)로 도출. 검증 2렌즈 모두 needs-revision → 아래는 수정 반영본.

저장 (신규 테이블 없음)¶

• theme_config: env_table, pk="theme_config", sk=<theme_id> (예 "vacance_mbti")
• 활성 카탈로그: env_table, pk="theme_config", sk="active" (경량 인덱스, themes[] 요약만)
• 문구: 원문 저장 X, i18n key만 참조. 실제 값은 pk="i18n", sk= translation 맵.

theme_config 주요 필드 (검증 반영)¶

• 식별/스케줄: theme_id, use_yn(bool), startAt/endAt(문자열 범위필터), priority(int), branch("ALL" 대문자 통일), target_lang
• 라우팅 3분리(중요): roiTheme(LLM이 실제 반환하는 enum값 — 이관 시 type_test/well_wishes 유지), kind(렌더 종류), template(TemplateSelector 케이스명)
• triggerKeywords: { : [키워드...] } (ROI 프롬프트 보간 + initUtterance 매칭)
• i18nKeys: { label, heroTitle, resultTitle, resultSubtitle, shareButton, promptTypePrefix, ... } (평면 dotted key. i18next keySeparator 처리 실측 확정 필요)
• assets: { guidePrefix, resultPrefix, resultPattern="{prefix}{code}.png", shareImage }
• questions: [{ id, i18nKey, options:[{ code, i18nKey }] }] (덕담형은 wishes:{targets[],moods[]} 별도 블록)
• resultTypeMap: { "<옵션code 연결값=실제 파일 code>": { short, typeNameI18nKey } } (MBTI 16 vs A/B 8 fallback 규칙 명시)
• ai (단일 아님, phase 맵): { intro?:{command,promptKey}, main:{command,promptKey}, sub?:[{command,promptKey}] } — 신규는 command="streaming_ai_theme_campaign"
• productReco(#677): { enabled, brandSource(aiResult|fixed|opensearchTheme), fixedBrands[], vectorQuery, keywordPrefix, selectPrompt, pinnedCards:[{portalBrandNm,moveUrl,moveMUrl}], count, size }
• events(명시 매핑, prefix 파생 금지): { link:{key,name,label}, image:{key,name,label}, copy:{...} } — 기존 키(personality_type_2026_link 등) 그대로 재현해 집계 연속성 유지
• share: { type(fixedUrl|resultText), baseUrl, initUtterance, encoding }

ACTIVE_CAMPAIGN_THEMES (sk="active")¶

themes[]: { id, roiTheme, kind, triggerKeywords, enabled, startAt, endAt, priority }, updated_at

검증이 확정한 선행조건 (하위일감 스코프 보정)¶

• #786: ai-backend find_first_roi_theme 시그니처/프롬프트 + ai_first_roi_api destructure 3곳 개정으로 activeCampaignThemes 주입. 제네릭 campaign 버킷. roiTheme는 enum 유지.
• #787: promptKey 소비하는 streaming_ai_theme_campaign 신규(필수) + get_theme_config + use_yn/기간/branch 활성필터 함수 신규(get_i18n 단순재사용 불가).
• #788: GlobalChatConsult switch 체인에 kind/template 데이터기반 dispatch 신설 + personality_type_test 핸들러의 하드코딩 오케스트레이션(벡터쿼리/키워드prefix/선택프롬프트/강제삽입카드)을 productReco 필드로 이전.
• #790: save_theme_config + 중첩 저작 폼 신규(범용 에디터 부재).
• #791: i18n 병합은 반드시 client get→merge→update_i18n (update_i18n은 전량 overwrite).

미해결 결정(사용자 확인 필요)¶

• 명절유형/덕담을 지금 데이터로 이관할지(완전통합, #792 확대) vs 신규 테마만 프레임워크로(명절/덕담 현행 유지, 소규모·저위험) — 이 결정이 #786/#788/#792 스코프를 크게 좌우.
• i18n dotted key ↔ i18next 중첩 해석 정합성 실측 후 keySeparator 정책 확정.

전체 스펙/예시레코드/검증 상세는 워크플로 산출물 기준(오케스트레이터 보관).