Feature #1560
open
YK
YK
[T56] RAG Q&A API·인용 근거 검증
Feature #1560:
[T56] RAG Q&A API·인용 근거 검증
Start date:
12/07/2026
Due date:
12/16/2026 (Due in 29 days)
% Done:
90%
Estimated time:
Description
등록 정보¶
- 신청자: 김여름 (GitHub ID: kyrdufmal-summer)
- 신청 상태: 신청. 사용자 요청으로 담당자 김여름(계정 표시명: Yeoreum Kim) 지정. PM 승인 여부는 별도 확인.
- 영역: Backend/AI / 작업지시서 우선순위: P2
- 등록은 착수·완료 또는 PM 승인 확정을 의미하지 않음. 일정 미정.
목적¶
검색 근거로만 답변하고 인용 chunk/ref와 모델 버전·거부/근거없음 상태 반환.
개발 범위¶
근거 없는 질문·허위 인용·프롬프트 인젝션·시간초과·비용/토큰 상한·사용자 ACL 검증.
선행조건¶
- 선행 일감: T25,T54
- 관련 요구사항 및 DB/API 계약의 확정·미확정 사항 확인. 선행 결과의 실제 완료 증빙 또는 명시적으로 승인된 mock 계약 확인 후 구현. 선행 미완료 시 설계/mock 범위로 제한하고 실제 연동은 HOLD.
- 참조: docs/FULL_SCOPE_TRACEABILITY.md, docs/API_CONTRACT.md, database/FULL_DATABASE_MODEL.md, docs/AI_SYSTEM_ARCHITECTURE.md
산출물¶
/api/v1/knowledge/answer·citation verifier·pytest.
- 개인 브랜치: task/t56-short-description (담당 확정 후 생성)
완료 기준¶
- 응답 인용이 실제 권한 있는 chunk와 일치, 근거없음 처리 PASS.
- 정상·오류·입력 경계 및 권한/보안 테스트의 재현 가능한 증빙 제출.
- 코드·문서·테스트 PR 리뷰 및 CI 결과 확인. mock/격리 환경만 검증했거나 CI가 범위를 검증하지 못하면 PARTIAL, 미실행 검사를 PASS로 표시하지 않음.
- 작업과 무관한 변경 및 비밀정보·실제 사용자 개인정보 노출 없음.
테스트 증빙 (개발 후 제출)¶
- 실제 실행 명령과 재현 방법, 테스트 로그, 정상 및 예외/거부 사례.
- Swagger 또는 해당 화면 캡처(비밀정보 마스킹), PR URL, CI 실행 URL, 테스트 커밋 SHA.
- 영향 범위, 미해결 항목, BLOCKER 기록. 현재 개발·테스트 미수행.
제한·중단 조건¶
- 사용자 자료 외부 전송·LLM 제공자 확정 이전에는 fixture/mock로 검증.
- 승인 없이 공용 Staging DB Schema/DDL/Seed 및 운영 컨테이너·배포 설정 변경 금지. 로컬/격리 테스트 우선.
GitHub 작업지시서 원문¶
Subtasks
Related issues