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
YK Updated by Yeoreum Kim 11 days ago
- Description updated (diff)
- Assignee set to Yeoreum Kim
YK Updated by Yeoreum Kim 8 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 90
[T56 진행 기록 — PR 리뷰 대기] (2026-11-09)
- PR #176: https://github.com/ai-career-platform/ai-career-platform/pull/176
- 구현: POST /api/v1/knowledge/answers — 내 문서+공용 자료만 근거(SQL 권한 필터 + 인용 재검증), 근거 없으면 답변 안 함, 허위 인용 시 답변 폐기, 문서 속 지시문 미준수, 질문 원문 미저장(sha256), 시간초과 504·장애 503, retrieval_runs·retrieval_citations 기록
- 테스트: API 38 + PostgreSQL 2 passed, 전체 565 passed / DB Schema·Staging 변경 없음
- 상태: PARTIAL — 선행 T53(색인)·T54(검색) 미완료, LLM 미승인 → 본문·검색·생성은 교체 가능한 mock