Feature #1559
open
YK
YK
[T51] LLM 기반 이력서 분석 Pipeline·API
Feature #1559:
[T51] LLM 기반 이력서 분석 Pipeline·API
Start date:
11/30/2026
Due date:
12/09/2026 (Due in 22 days)
% Done:
90%
Estimated time:
Description
등록 정보¶
- 신청자: 김여름 (GitHub ID: kyrdufmal-summer)
- 신청 상태: 신청. 사용자 요청으로 담당자 김여름(계정 표시명: Yeoreum Kim) 지정. PM 승인 여부는 별도 확인.
- 영역: Backend/AI / 작업지시서 우선순위: P1
- 등록은 착수·완료 또는 PM 승인 확정을 의미하지 않음. 일정 미정.
목적¶
사용자 문서로부터 구조화된 기술·경력 추출 후 사용자 검수용 결과를 생성하는 비동기 분석 흐름 구현.
개발 범위¶
입력 마스킹·프롬프트/모델 버전·토큰 비용 한도·실패/타임아웃/중복·PII 노출 테스트.
선행조건¶
- 선행 일감: T25,T49
- 관련 요구사항 및 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/document-analyses API·worker 계약·fixture·pytest.
- 개인 브랜치: task/t51-short-description (담당 확정 후 생성)
완료 기준¶
- fixture로 비동기 분석 상태/결과 스키마·실패 처리 PASS.
- 정상·오류·입력 경계 및 권한/보안 테스트의 재현 가능한 증빙 제출.
- 코드·문서·테스트 PR 리뷰 및 CI 결과 확인. mock/격리 환경만 검증했거나 CI가 범위를 검증하지 못하면 PARTIAL, 미실행 검사를 PASS로 표시하지 않음.
- 작업과 무관한 변경 및 비밀정보·실제 사용자 개인정보 노출 없음.
테스트 증빙 (개발 후 제출)¶
- 실제 실행 명령과 재현 방법, 테스트 로그, 정상 및 예외/거부 사례.
- Swagger 또는 해당 화면 캡처(비밀정보 마스킹), PR URL, CI 실행 URL, 테스트 커밋 SHA.
- 영향 범위, 미해결 항목, BLOCKER 기록. 현재 개발·테스트 미수행.
제한·중단 조건¶
- LLM 제공자/사용자 동의·데이터 처리 계약 미승인 시 외부 호출 금지.
- 승인 없이 공용 Staging DB Schema/DDL/Seed 및 운영 컨테이너·배포 설정 변경 금지. 로컬/격리 테스트 우선.
GitHub 작업지시서 원문¶
Subtasks
Related issues