Feature #1599
open
희채
희채
[T67] 채용시장 추세 조회 API
Feature #1599:
[T67] 채용시장 추세 조회 API
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로 확인 예정.
참고:
Subtasks
Related issues
희채 Updated by 희주 채 8 days ago
- % 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 실수집 승인 후.