Project

General

Profile

Feature #1529

Updated by 상재 이 11 days ago

제목: [T06] 전체 API·DTO 계약 확정 
 목표 및 사용자 시나리오: S04 API 후보를 T04 화면·기능과 T05 테이블에 1:1 대응시키고, 인증 방식·오류·페이징·응답 타입·비동기 상태 계약을 확정. OpenAPI 3.1 초안과 mock 예시 작성 
 범위/비범위: API 계약 문서·OpenAPI·DTO 목록·검증 스크립트. FastAPI 구현(T13~T18), 프런트 구현(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) 

 링크 
 * 작업지시서: https://github.com/ai-career-platform/ai-career-platform/blob/main/docs/work-orders/initial-30/T06.md 
 * 선행 T04: https://sulfite-footbath-next.ngrok-free.dev/issues/1495 / https://github.com/ai-career-platform/ai-career-platform/pull/13 
 * 선행 T05: https://sulfite-footbath-next.ngrok-free.dev/issues/1521 / https://github.com/ai-career-platform/ai-career-platform/pull/17 
 * 후행 일감: T13~T18, T21~T24, T29

Back