Feature #1585
open
상이
[T45] 개인화 직무·공고 추천 API
10%
Description
제목: [T45] 개인화 직무·공고 추천 API
목표 및 사용자 시나리오: 사용자가 보유 기술·목표 직무를 바탕으로 맞춤 공고 추천 목록을 받는다. 요청마다 추천 실행(run)과 계산 기준 버전을 저장하고, 순위·추천 이유와 함께 최근 추천을 다시 조회할 수 있게 한다. 데이터가 부족하면 baseline(최신 공고) 또는 빈 결과임을 명확히 표시
범위/비범위: POST /api/v1/recommendation-runs(생성), GET /api/v1/recommendation-runs/latest, GET /api/v1/recommendation-runs/{recommendation_run_id}, run·item DTO, 서비스·저장소, pytest(동점·중복 공고·만료 필터·최소 결과 수·모델 버전·사용자 데이터 격리·422). 추천 피드백 API(T47), 학습 모델, Staging DB 변경은 비범위
담당자: 이상재 (GitHub: sangjae-lee97)
선행조건: T15 인증 (#1499, main 머지), T17 직무·기술 조회 (일감 미등록), T18 기업·공고 조회 (#1526), T25 AI·ML 공통 계약 (#1542), T27 적합도·추천 규칙 Baseline (#1531), T33 보유 기술 API (#1557), T35 목표 직무 API (#1548) — 미완료 선행은 mock 계약으로 먼저 진행하고 실 API·DB 연동은 HOLD. 적합도 계산(T41 #1584)의 match_rule 재사용 검토
관련 화면/API/DB: UI-017, UI-N01 / createRecommendationRun·getLatestRecommendationRun·getRecommendationRun (docs/api/openapi.yaml, FR-ANL-003, FR-ANL-004) / recommendation_runs, recommendation_items, recommendation_feedback, user_target_roles, user_skills, job_postings, model_versions
완료조건(테스트·증빙 포함): 재현 가능한 결과 순위(동점 처리 규칙 고정), 내 사용자 데이터 격리(다른 사람 run 404), 만료·중복 공고 제외, 데이터 부족 시 baseline/빈 결과 표시, 재현 명령·테스트 로그·Swagger 증빙·CI URL·커밋 SHA를 PR에 기재. mock으로만 통과하면 PARTIAL 표기
예상 일정: 2026-11-09 ~
브랜치 / PR / Merge SHA: task/t45-recommendation-api / - / -
Staging 검증 결과: 해당 없음 (Staging 변경 없음)
결정 메모: 작업지시서의 경로는 /api/v1/recommendations/jobs이나, T06 확정 계약(openapi.yaml)은 /recommendation-runs 계열. 계약 기준으로 구현하고 차이는 PR에 기록. 선행 일감 완료 후 결과를 다시 확인·수정
링크
- 작업지시서: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/work-orders/next-30/T45.md
- API 계약(T06): https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/API_CONTRACT.md
- OpenAPI: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/api/openapi.yaml
- 데이터 사전(T05): https://github.com/ai-career-platform/ai-career-platform/blob/main/database/DATA_DICTIONARY.md
- 관련 T41: https://sulfite-footbath-next.ngrok-free.dev/issues/1584
- 선행 T27: https://sulfite-footbath-next.ngrok-free.dev/issues/1531 / T33: https://sulfite-footbath-next.ngrok-free.dev/issues/1557 / T35: https://sulfite-footbath-next.ngrok-free.dev/issues/1548 / T15: https://sulfite-footbath-next.ngrok-free.dev/issues/1499
- 후행 일감: T47, T104, T107
Subtasks