Feature #1587
open
상이
[T42] 직무 적합도 결과 UI
90%
Description
제목: [T42] 직무 적합도 결과 UI
목표 및 사용자 시나리오: 사용자가 공고 상세(UI-012) 또는 직무 화면에서 적합도를 요청하고, 적합도 결과 화면(UI-015)에서 점수·충족/부족 기술 수·계산 기준(모델 버전)·분석 시점·한계 설명을 본다. 점수 옆에 "합격 확률이 아닙니다"를 표시하고, 보유 기술 없음·계산 실패·서비스 장애 상태를 안내한다
범위/비범위: 적합도 결과 화면·결과 카드 컴포넌트, POST/GET /api/v1/matches 호출(api 모듈), 상태별 UI(로딩·보유 기술 없음 400 NO_USER_SKILLS·계산 실패 failed·404·503 해당 영역만 오류), mock fixture, UI 테스트. 점수 계산 로직(T41), Skill Gap 화면(T44), 추천 화면(T46), 백분위·합격 가능성 표현은 비범위
담당자: 이상재 (GitHub: sangjae-lee97)
선행조건: T19 Frontend 기본 구조 (#1571, Resolved), T20 공통 레이아웃·UI 컴포넌트 (#1541), T23 직무·기술 탐색 UI (#1496), T24 기업·채용공고 탐색 UI (#1519), T41 적합도 평가 API (#1584, 진행 중) — 미완료 선행은 T06 계약(openapi.yaml Match) 기준 mock으로 먼저 진행하고 실 API 연동은 HOLD
관련 화면/API/DB: UI-015 적합도 결과, UI-012 공고 목록·상세 / createMatch·getMatch (docs/api/openapi.yaml, FR-ANL-001) / DB 직접 변경 없음
완료조건(테스트·증빙 포함): 고정 fixture에서 점수·근거·한계·계산 기준 표시 재현 PASS, 오류·보유 기술 없음·실패 상태 UI 테스트, "합격 확률 아님" 표시, 화면 캡처·테스트 로그·CI URL·커밋 SHA를 PR에 기재. mock으로만 통과하면 PARTIAL 표기
예상 일정: 2026-11-09 ~
브랜치 / PR / Merge SHA: task/t42-match-result-ui / - / -
Staging 검증 결과: 해당 없음 (Staging 변경 없음)
결정 메모: 오류 문구는 공통 에러 계약(API_CONTRACT §1.4)의 message를 그대로 표시하고 code로만 분기(NO_USER_SKILLS → 기술 입력 화면 안내). 부족 기술 클릭 시 Skill Gap 이동(FR-ANL-001 수용 기준 4)은 T44 화면 확정 후 연결. 선행 일감 완료 후 결과를 다시 확인·수정
링크
- 작업지시서: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/work-orders/next-30/T42.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
- 요구사항 FR-ANL-001: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/requirements/functional/ANALYSIS.md
- 선행 T41: https://sulfite-footbath-next.ngrok-free.dev/issues/1584 / T20: https://sulfite-footbath-next.ngrok-free.dev/issues/1541 / T23: https://sulfite-footbath-next.ngrok-free.dev/issues/1496 / T24: https://sulfite-footbath-next.ngrok-free.dev/issues/1519
- 관련 T45: https://sulfite-footbath-next.ngrok-free.dev/issues/1585
Subtasks
Updated by Anonymous 9 days ago
- Status changed from New to In Progress
작업 착수 신청 (T06 계약의 Match 응답 기준 mock으로 화면 설계 시작, T41 API 완료 후 실연동)
Updated by Anonymous 9 days ago
- Due date set to 11/10/2026
- Start date changed from 11/09/2026 to 11/10/2026
- Follows Feature #1584: [T41] 직무·공고 적합도 평가 API added
Updated by Anonymous 8 days ago
- % Done changed from 10 to 90
PR 생성 — 리뷰 대기 (90%)
- PR: https://github.com/ai-career-platform/ai-career-platform/pull/173
- 브랜치: task/t42-match-result-ui (커밋 032e626, main 98ddcc9 기준 — #165·#170 API 계층 방식)
- 화면: 공고·직무 상세의 "내 적합도 계산" 버튼 → /matches/:matchId 결과 화면
- 결과: 점수(/100, 합격 확률 아님)·충족/부족 수·한계 설명·계산 규칙·분석 시점, 근거·부족 역량 표
- 오류: 비로그인, 보유 기술 없음(400), 계산 기준 없음(503), 404, 네트워크, failed/pending, 중복 클릭 방지
테스트
- Windows 로컬: npm test 167 passed / lint 0 / typecheck 통과
- 실제 API 확인(로컬 T41 + PostgreSQL, Staging 미사용): 58.33점 = 손계산 일치, 400 안내, 다른 사용자 404
남은 일
- T41(#163) 머지됨. Staging에 match_rule v1 등록 전까지는 계산 시 503 안내가 정상 → PM 승인 후 Staging 확인