Private
Tracker *Bug Feature Support
Subject *
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 Edit
Status *New In Progress Resolved Feedback Closed Rejected
Priority *Low Normal High Urgent Immediate
Assignee AnonymousDONGHYUN WooLio yunRedmine AdminYeoreum Kim길래 문나경 고다라 정박 진상재 이서현 임성용 양성호 최수아 황영우 조예주 김예진 전우섭 심정민 조종복 김중섭 안지나 팡충만 장형준 안희주 노희주 채
Parent task
Start date
Due date
Estimated time Hours
% Done0 % 10 % 20 % 30 % 40 % 50 % 60 % 70 % 80 % 90 % 100 %
Spent time Hours
Activity--- Please select --- Design Development
Comment