베스킨 라빈스 FAQ 프로젝트

배경¶

• #510에서 Codex Skill Lambda 기반 문서 RAG 업로드 v2 PoC와 운영 테스트 UI를 릴리즈했다.
• 현재 v2는 기존 RAG 등록 옆 AB 테스트 흐름이며, codes/app/web-admin/src/page/vectocore/codexRagUpload에 패키징되어 있다.
• AGENTS.md에 문서 RAG 업로드 v2 / Codex Skill 프로세스 섹션을 추가했으므로, 이 일감은 해당 프로세스를 반드시 읽고 따른다.
• 현재 페이지 판정 소스 인덱스는 br-promotion-01이고, 제조법/제법 페이지만 예외적으로 br-recipe-01로 라우팅한다.

목표¶

인덱스 및 카테고리별 Codex Skill을 추가/고도화해, 문서 업로드 후 페이지별 targetIndexName, categoryKey, pageSummary, confidence, reason, sourcePageNo, segmentNo를 AI가 안정적으로 판정하도록 만든다.

반드시 유지할 프로세스¶

1. 기존 운영 RAG 등록 프로세스는 유지한다. v2 흐름만 확장한다.
2. 업로드 결과는 imageUrls만 쓰지 말고 pages 메타데이터를 유지한다.
3. 페이지 판정은 룰 확정이 아니라 Codex Skill Lambda의 AI 판정 결과를 사용한다.
4. 낮은 신뢰도 또는 미지원 인덱스/카테고리 조합은 저장 불가 상태로 두고 수동 검토/보정을 요구한다.
5. 라우팅 결과는 반드시 targetIndexName + categoryKey 기준으로 그룹핑한다. 서로 다른 인덱스/카테고리를 하나의 RAG job에 섞지 않는다.
6. 그룹별 RAG 구조화는 getRagKeywordPromptByIndex(indexName, categoryKey) 흐름을 사용한다.
7. 저장 전 검수는 page coverage, 누락/중복 페이지, 필수 필드, 이미지 URL, docBody.data JSON 파싱 가능 여부를 확인한다.
8. mixed index 저장은 v2에서만 useDocumentSaveQueue.enqueueEntries({ indexName, item })로 수행한다.
9. docBody.data / DocumentDetail.data는 JSON 문자열 계약을 유지한다. 새 top-level 필드를 추가하지 않는다.
10. API key, tenant key, presigned URL, raw secret header는 코드/로그/Redmine에 남기지 않는다.

1차 구현 범위¶

• codes/lambda/codex-skill-poc-lambda/src/skills 아래에 인덱스/카테고리 판정 스킬을 추가하거나 기존 br-promotion-page-router를 구조화한다.
• br-promotion-01 범위는 우선 신제품 출시, 홍보물, 프로모션, 재출시, 매출활성화, 출하 제한, 진열기준, 출하종료로 제한한다.
• 제조법/제법 판정 시 targetIndexName=br-recipe-01, categoryKey=제법으로 라우팅한다.
• 파일명, OCR text, 페이지 이미지 메타, split page 정보가 판정 prompt에 충분히 들어가도록 한다.
• codexRagRouteOptions.ts의 인덱스 표시명/허용 카테고리/기본 카테고리와 스킬 결과가 맞도록 갱신한다.
• 카테고리별 prompt가 필요한 경우 ragKeywordPrompts.ts와 backend PDF RAG validation/test도 같이 갱신한다.

완료 조건¶

• Lambda page_route 또는 후속 skill mode가 페이지별 라우팅 JSON을 안정적으로 반환한다.
• web-admin v2 페이지 판정/보정 UI에서 select 후보와 스킬 결과가 일치한다.
• 저장 후보 JSON preview, 그룹/검수, mixed index save 흐름이 유지된다.
• frontend unit test, 관련 lambda/backend test, web-admin lint/build가 통과한다.
• 프로세스 변경이 있으면 AGENTS.md의 문서 RAG 업로드 v2 / Codex Skill 프로세스도 함께 업데이트한다.

참고¶

• 릴리즈 커밋: b8997245ba28bfa035f537e558b567454e05a7d1
• 관련 작업: #510 RAG 생성 AI