Feature #1559
Updated by Yeoreum Kim 11 days ago
## 등록 정보 - 신청자: 김여름 (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 작업지시서 원문 https://github.com/ai-career-platform/ai-career-platform/blob/docs/next-30-work-orders-20261106/docs/work-orders/next-30/T51.md