Project

General

Profile

Feature #1584

open
상이

[T41] 직무·공고 적합도 평가 API

Feature #1584: [T41] 직무·공고 적합도 평가 API

Added by Anonymous 9 days ago. Updated 8 days ago.

Status:
In Progress
Priority:
Normal
Assignee:
Start date:
11/09/2026
Due date:
% Done:

90%

Estimated time:

Description

제목: [T41] 직무·공고 적합도 평가 API
목표 및 사용자 시나리오: 사용자가 공고 또는 직무 하나를 골라 보유 기술 기준 적합도를 확인한다. 규칙 기반 baseline(T27) 점수를 모델 버전·근거(일치/부족 기술)와 함께 API로 제공하고, 결과를 저장해 다시 조회할 수 있게 한다. 점수는 채용 성공 확률이 아님
범위/비범위: POST /api/v1/matches(계산·저장), GET /api/v1/matches/{match_id}(조회), 요청·응답 DTO, 서비스·저장소, pytest(정상·빈 스킬·만료 공고·동점·소유권·422). 학습 모델 통합, 추천(T45)·설명/피드백(T47), Staging DB 변경은 비범위
담당자: 이상재 (GitHub: sangjae-lee97)
선행조건: T15 인증 (#1499, 90%), T17 직무·기술 조회 (일감 미등록), T18 기업·공고 조회 (#1526), T25 AI·ML 공통 계약 (#1542), T27 적합도 규칙 Baseline (#1531), T33 보유 기술 API (#1557) — 미완료 선행은 mock 계약으로 먼저 진행하고 실 API·DB 연동은 HOLD
관련 화면/API/DB: UI-015, UI-012 / createMatch·getMatch (docs/api/openapi.yaml, FR-ANL-001) / match_evaluations, user_skills, user_project_skills, job_posting_skills, job_role_skills, model_versions
완료조건(테스트·증빙 포함): 재현 가능한 fixture 점수·설명, 422·401·다른 사람 결과 404 차단 PASS, score 범위·모델 버전·입력 스냅샷 저장, 재현 명령·테스트 로그·Swagger 증빙·CI URL·커밋 SHA를 PR에 기재. mock으로만 통과하면 PARTIAL 표기
예상 일정: 2026-11-09 ~
브랜치 / PR / Merge SHA: task/t41-match-evaluation-api / - / -
Staging 검증 결과: 해당 없음 (Staging 변경 없음)

결정 메모: 작업지시서의 경로는 /api/v1/matches/evaluate이나, T06 확정 계약(openapi.yaml)은 POST /matches · GET /matches/{match_id}. 계약 기준으로 구현하고 차이는 PR에 기록

링크


Add

Subtasks


Add

Related issues 2 (2 open — 0 closed)

Related to Feature #1585: [T45] 개인화 직무·공고 추천 APIIn Progress상재 이11/09/2026

Remove relationActions
Precedes Feature #1587: [T42] 직무 적합도 결과 UIIn Progress상재 이11/10/202611/10/2026

Remove relationActions

Updated by Anonymous 9 days ago Actions #1

  • Status changed from New to In Progress

작업 착수 (T06 확정 계약의 createMatch·getMatch 기준으로 DTO·서비스 설계 시작, 미완료 선행은 mock 계약으로 진행)

Updated by Anonymous 9 days ago Actions #2

  • Related to Feature #1585: [T45] 개인화 직무·공고 추천 API added

Updated by Anonymous 9 days ago Actions #3

Updated by Anonymous 8 days ago Actions #4

  • % Done changed from 10 to 90

PR 생성 — 리뷰 대기 (90%)

  • PR: https://github.com/ai-career-platform/ai-career-platform/pull/163
  • 브랜치: task/t41-match-evaluation-api (최신 main d0d18e1 기준 rebase, T45·T26·T49 머지 후)
  • API: POST /api/v1/matches, GET /api/v1/matches/{match_id} (T06 계약 기준)
  • 규칙: match_rule v1 — 필수 2·우대 1 가중 충족도, half-up 반올림 (backend/docs/MATCH_RULE.md)
  • T17·T18·T33 방식으로 정리: 공용 ORM 모델 제거, table() 선언 재사용, 라우터에서 세션으로 서비스 생성

테스트

  • Windows 로컬: T41 35 passed / 전체(T49 제외) 353 passed
  • PostgreSQL 16 일회용 DB(T05 DDL + T10 Seed): 전체 385 passed
  • Staging 읽기 전용 사전 확인(career_reader): match_rule 0건, published 공고 80(요구 기술 4·필수 2), 활성 직무 30, match_evaluations 0건

남은 일

  • Staging에 match_rule v1이 없어 등록 전까지 POST는 503 → 머지 후 PM 승인 받아 등록하고 실제 동작 확인
  • 입력 스냅샷 컬럼 없음(T05/T09 협의), T27 규칙과 통합 여부(T27 담당 협의)

Also available in: PDF Atom