Skip to content

✨ [Feat] 상세 분석 리포트 조회 API + 기준 직무 anchor#58

Merged
jwon0523 merged 1 commit into
developfrom
feat/52
Jun 4, 2026
Merged

✨ [Feat] 상세 분석 리포트 조회 API + 기준 직무 anchor#58
jwon0523 merged 1 commit into
developfrom
feat/52

Conversation

@jwon0523

@jwon0523 jwon0523 commented Jun 4, 2026

Copy link
Copy Markdown
Collaborator

✨ PR 유형

Feat

🛠️ 작업 내용

  • GET /api/v1/recommendations/report 추가 — 활성 추천 기준 역량 충족도(현재 / 다음 N개 이수 시 / 전체 3단)·분야별 분석·잔여 과목(전공필수·선택)·다음 액션·집계를 한 묶음으로 반환
  • 추천 생성 시 AI 충족도 스냅샷 보존(coverage / job_coverage / course_contribution / next_action), 조회 시 카탈로그·이수 이력으로 잔여 과목 계산 → 홈 추천 결과와 정합
  • 기준 직무(anchor)를 응답에 포함 → 화면의 "○○ 직무 기준" 라벨 렌더 가능
  • anchorJobCode 쿼리 파라미터로 기준 직무를 바꿔 조회(기본값 = 매칭 1순위) → 보존된 직무별 충족도로 헤드라인 재산출
  • 예외: 추천 직무 목록 외 코드 → 400 INVALID_ANCHOR_JOB, 활성 추천 없음 → 404 RECOMMENDATION_NOT_FOUND

📋 추후 진행 상황

  • 비기본 anchor 완전형(직무별 다음 액션·기여 배지까지 재산출)은 AI 재계산 cascade 선행 필요 — 데모 이후. 현재는 보존 데이터 기반 읽기 전용 재정렬(비기본 anchor는 현재→전체 2단).
  • AI 측 충족도 데이터가 현재 비어 있어(직무 요구 토큰 공백) 라이브에선 충족도 0으로 표기됨 — AI 데이터 보강 시 BE 변경 없이 점등.

📌 리뷰 포인트

  • AnalysisReportAssembler anchor 분기: 기본 anchor(최고 점수 직무) = 전체 3단 + 다음 액션/배지 / 비기본 = 직무별 현재→전체 2단(중간단 = 현재값, invariant 유지)·다음 액션 빈 배열
  • 충족도 보존 시점(생성)과 잔여 과목 계산 시점(조회) 분리가 홈 결과와 정합하는지
  • 카운트 invariant: current ≤ nextActions ≤ expected

🔗 관련 이슈

Closes #52

📸 스크린샷

(해당 없음 — 백엔드 API)

✅ 체크리스트

  • ./gradlew spotlessApply 로 포매팅 적용
  • ./gradlew spotlessCheck 통과
  • ./gradlew checkstyleMain checkstyleTest 통과
  • ./gradlew build 성공
  • ./gradlew test 모든 테스트 통과
  • 라이브 e2e(기본/전환 anchor·400·404) 검증 + 커밋 메시지 컨벤션 확인

@jwon0523 jwon0523 self-assigned this Jun 4, 2026
@jwon0523 jwon0523 added the enhancement New feature or request label Jun 4, 2026
@jwon0523 jwon0523 merged commit 0867cf0 into develop Jun 4, 2026
2 checks passed
@jwon0523 jwon0523 deleted the feat/52 branch June 4, 2026 05:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ Feat: 상세 분석 리포트 조회 API

1 participant