Project

General

Profile

Feature #1599

open
희채 희채

[T67] 채용시장 추세 조회 API

Feature #1599: [T67] 채용시장 추세 조회 API

Added by 희주 채 8 days ago. Updated 8 days ago.

Status:
In Progress
Priority:
Normal
Assignee:
Start date:
Due date:
% Done:

90%

Estimated time:

Description

목표 및 사용자 시나리오:
로그인 사용자가 기간·직무·지표별 채용시장 관측 결과(및 구분된 예측값)를 조회하는 API를 구현한다. (F-024, 작업지시서 우선순위 P1)

범위:

  • GET /api/v1/market-trends: 기간(from~to)·직무·지표·집계 단위 필터
  • 응답에 단위·기준 시점·출처 포함, 관측과 예측 구분
  • 페이징, 빈 결과, 잘못된 기간 422, 인증(401) 처리
  • 산출물: API, Swagger, pytest

비범위:

  • 지표 정의: T65 / 집계 적재: T66
  • 대시보드 UI: T68 / 예측 모델: T69
  • 승인 없는 Staging DB Schema/Seed 변경

관련 화면/API/DB:
API GET /api/v1/market-trends (API_CONTRACT MarketTrend·MarketPoint), DB market_observations·market_forecasts·data_sources, UI-024. 관련 문서: docs/FULL_SCOPE_TRACEABILITY.md, docs/API_CONTRACT.md, database/FULL_DATABASE_MODEL.md

완료조건(테스트·증빙 포함):

  • 조회/필터/빈 데이터/422 테스트 PASS
  • 정상·실패·권한/보안 경계 재현 증빙
  • CI와 실제 테스트 범위를 구분해 PASS/PARTIAL/HOLD 판정

담당자:
채희주 (Redmine: 희주 채 / GitHub: kixxuya). PM 담당 확정 여부는 별도 확인.

선행조건:
T14 (완료), T18 (PR #128 merge), T65·T66 (같은 담당자 진행 예정). T65·T66 완료 전 실데이터 연동은 HOLD.

예상 일정:
PM 확정 필요.

브랜치 / PR / Merge SHA:

  • 브랜치: task/t67-market-trends (예정)
  • PR / Merge SHA: 미생성

Staging 검증 결과:
미실행. Merge·자동 배포 후 Staging Swagger로 확인 예정.

참고:


Add

Subtasks


Add

Related issues

희채 Updated by 희주 채 8 days ago Actions #1

  • Status changed from New to In Progress
  • % Done changed from 0 to 10

착수: 2026-11-09 KST. T65 계약(PR #171) 기준으로 브랜치 task/t67-market-trends에서 GET /api/v1/market-trends 구현 시작. T65 미병합 상태라 T65 브랜치 위에 쌓아 진행.

희채 Updated by 희주 채 8 days ago Actions #2

  • % Done changed from 10 to 90

개발·자체 테스트 완료, PR 생성 및 리뷰 요청(Crasnec).

  • PR: https://github.com/ai-career-platform/ai-career-platform/pull/174 (T67 커밋 183d5b3, T65 PR #171 선행 merge 필요)
  • 구현: GET /api/v1/market-trends (로그인 필요, 관측/예측 분리, 단위·출처·직무·기술 포함, 빈 구간 0 미채움), openapi.yaml·frontend schema.gen.ts 갱신
  • 테스트: 서비스·HTTP·OpenAPI 계약 26 passed, 일회용 PostgreSQL 18.1 7 passed(T65 정답 일치), 로컬 uvicorn 호출 7개 시나리오·Swagger 확인
  • 주의: Staging DB에 migration 0003 적용 전 배포되면 이 API만 500. 0003 적용 후 merge 필요.
  • 판정: T67_API=PASS (합성 fixture). Staging 실데이터는 0003 적용·T66 실행·T61 실수집 승인 후.

Also available in: PDF Atom