Project

General

Profile

Feature #1529

closed
상이 상이

[T06] 전체 API·DTO 계약 확정

Feature #1529: [T06] 전체 API·DTO 계약 확정

Added by 상재 이 11 days ago. Updated 11 days ago.

Status:
Closed
Priority:
Normal
Assignee:
Start date:
11/06/2026
Due date:
% Done:

100%

Estimated time:
(Total: 0:00 h)

Description

제목: [T06] 전체 API·DTO 계약 확정
목표 및 사용자 시나리오: S04 API 후보를 T04 화면·기능과 T05 테이블에 1:1 대응시키고, 인증 방식·오류·페이징·응답 타입·비동기 상태 계약을 확정. OpenAPI 3.1 초안과 mock 예시 작성
범위/비범위: API 계약 문서·OpenAPI·DTO 목록·검증 스크립트. FastAPI 구현(T13T18), 프런트 구현(T19)은 비범위
담당자: 이상재 (GitHub: sangjae-lee97)
선행조건: T04 (#1495, PR #13 머지), T05 (#1521, PR #17 머지)
관련 화면/API/DB: docs/API_CONTRACT.md, docs/requirements/FEATURE_BASELINE.md, database/DATA_DICTIONARY.md
완료조건(테스트·증빙 포함): API_CONTRACT.md 업데이트, OpenAPI 3.1 초안(문법·참조 검증), DTO 목록, 화면↔API↔테이블 추적 100%, mock 예시 스키마 검증, 팀 리뷰 승인
예상 일정: 2026-11-06 ~
브랜치 / PR / Merge SHA: task/t06-api-contract / https://github.com/ai-career-platform/ai-career-platform/pull/29 / d1fae3a5e146f745b17189f2191d3d57d3db4a29
Staging 검증 결과: 해당 없음

결정 메모: F-001 인증 방식은 담당자 제안으로 "자체 로그인(이메일+비밀번호, JWT access + refresh 쿠키)" 기준 작성. PM 승인 대기 (T04 D-01)

링크


Add

Subtasks 1 (0 open — 1 closed)

Feature #1569: [T06] 공통 에러 계약·에러 DTO·글로벌 예외 핸들러 (후속)Closed상재 이11/06/2026

Remove subtaskActions

Add

Related issues 3 (0 open — 3 closed)

Precedes Feature #1548: [T35] 목표 직무 관리 APIClosed지나 팡11/18/202611/23/2026

Remove relationActions
Precedes Feature #1551: [T37] 개인 경력·프로젝트 이력 APIClosed지나 팡11/18/202611/23/2026

Remove relationActions
Precedes Feature #1553: [T39] 관심 채용공고 북마크 APIClosed지나 팡11/23/202611/26/2026

Remove relationActions

Also available in: PDF Atom