docs/ Sync: FE 기준 변경사항 동기화

[jychoi0831]

📌 작업 개요

어떤 기능을 구현하는지 간략하게 설명해 주세요.

FE 레포의 기준 문서/API/도메인 변경사항 중 BE 레포에 동기화가 필요한 항목을 추적합니다.

✅ 작업 목표

• FE comment: 주석 한줄추가 #28: 구매내역 기반 등록 복수 상품 FE 연동 및 공용 문서 변경 확인
  • 변경: REG-002 FE 구현에서 items[], itemIndex, pendingItemCount, captureCompleted, 상품 건너뛰기 API를 사용하고 관련 공용 문서/API 사용 문서를 갱신
  • 확인 필요:
    • docs/features/garment-registration.md
    • docs/requirements/feature-index.md
    • docs/api/api-contract.md
    • src/main/java/com/closetnangam/be/domain/purchase/**

💡 구현 방법

구현 방법이나 접근 방식을 작성해 주세요. (선택사항)

관련 BE 작업 또는 문서 정비 시 위 항목을 확인하고, 반영 완료된 항목은 체크합니다.

🔗 참고 자료

관련 문서, 링크, 이슈를 작성해 주세요. (선택사항)

• 출처 PR: Feat/#23 구매내역, 사진 폼 AIBE5_FinalProject_Team4_FE#28
• 상대 레포: prgrms-aibe-devcourse/AIBE5_FinalProject_Team4_BE

🚧 브랜치 정보

• Base branch: develop
• 작업 branch: docs/#이슈번호

[jychoi0831]

닫힌 후 확인 기록을 남깁니다.

이 Sync 항목은 FE #28의 구매내역 기반 등록 복수 상품 연동 변경이 BE 기준 문서와 BE 구현에도 반영되어 있는지 확인하기 위한 항목이었습니다.

반영 시점

• FE 출처 PR: Feat/#23 구매내역, 사진 폼 AIBE5_FinalProject_Team4_FE#28

  • 제목: Feat/#23 구매내역, 사진 폼
  • merge 시각: 2026-06-08 16:09 KST
  • merge commit: 51319baf69ba1a46a78629e1ac6515d19a31a51c

• BE 반영 PR: Feat/#70 복수 상품 분석  #77

  • 제목: Feat/#70 복수 상품 분석
  • merge 시각: 2026-06-08 16:18 KST
  • merge commit: 0be0954edfeca1699d0d99f131634f0694f8c20a

반영 이유

FE #28에서 구매내역 기반 등록 화면이 복수 상품 흐름을 사용하게 되면서, BE의 공식 문서와 실제 API/서비스 구현이 같은 계약을 가져야 했습니다.

특히 아래 항목이 FE/BE 공통으로 맞아야 했습니다.

• items[]
• itemIndex
• pendingItemCount
• captureCompleted
• 상품별 저장
• 상품별 건너뛰기 API

BE develop 기준 확인 결과

아래 파일과 코드에서 해당 내용이 이미 반영되어 있음을 확인했습니다.

• docs/features/garment-registration.md

  • 복수 상품 캡처 흐름
  • itemIndex별 저장/건너뛰기
  • items[], status, pendingItemCount, captureCompleted 설명 반영

• docs/requirements/feature-index.md

  • REG-002에 복수 상품 후보(items[])와 itemIndex별 저장·건너뛰기 기준 반영

• docs/api/api-contract.md

  • POST /api/v1/users/{userId}/clothes/purchase-captures/{captureId}/save
  • POST /api/v1/users/{userId}/clothes/purchase-captures/{captureId}/items/{itemIndex}/skip
  • items[], pendingItemCount, captureCompleted, itemIndex, imageUrl 설명 반영

• src/main/java/com/closetnangam/be/domain/purchase/**

  • PurchaseCaptureRegistrationController
  • PurchaseCaptureRegistrationService
  • PurchaseCaptureSaveRequest
  • PurchaseCaptureDraftResponse
  • PurchaseCaptureItemDraft
  • PurchaseCaptureRegistrationResponse

결론

현재 BE develop 기준으로 FE #28에서 요구한 Sync 내용은 BE #77을 통해 이미 반영되어 있습니다.

따라서 이 이슈는 추가 BE docs 수정 없이 완료 처리합니다.