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

[jychoi0831]

BE 레포 기준 변경사항이 FE 동일본 문서/코드에 반영되어야 하는지 확인하기 위한 Sync 대기열입니다.

검수 기준

• 검수 일시: 2026-06-19 17:28 KST
• BE develop 기준: 0f7453fdf0660a8314ea6add226f077e4ea1e406
• FE develop 기준: d1464f15f72c11e3cabf95d72cf88129b0cf57c7
• 검수 범위: FE/BE 레포의 열린/닫힌 PR, 열린/닫힌 이슈, develop 기준 코드와 docs
• 이미 FE develop에 반영된 항목은 Sync 대기열에서 제거했습니다.

• OAuth 로그인 실패 redirect query 처리 반영

  • BE 기준: OAuth provider 오류, token 교환 실패, 사용자 정보 조회 실패 등은 FE redirect URI에 error=oauth_failed query로 전달합니다.
  • 현재 확인: BE docs/api/api-contract.md, docs/requirements/requirements-definition.md, OAuth2FailureHandler에는 기준이 반영되어 있으나, FE App.tsx는 withdrawn=restore_required만 감지하고 error=oauth_failed 처리는 확인되지 않습니다.
  • 확인 대상: FE 로그인 화면, OAuth redirect 진입 처리, docs/api/frontend-api-usage.md, docs/features/auth-and-onboarding.md

• 가이드 투어 완료 상태 API/필드 반영

  • BE 기준: GET/PATCH /api/v1/users/profile 응답에 guideTourCompletedHome, guideTourCompletedWardrobe, guideTourCompletedFeed, guideTourCompletedMypage가 포함되고, PATCH /api/v1/users/guide-tour로 부분 업데이트합니다.
  • 현재 확인: BE develop에는 API와 DTO가 존재하지만, FE develop 코드/docs에서 해당 필드와 API 사용처가 확인되지 않습니다.
  • 확인 대상: FE 홈/옷장/피드/마이페이지 가이드 표시/건너뛰기 상태 저장 흐름, docs/api/frontend-api-usage.md, docs/features/auth-and-onboarding.md, docs/features/mypage.md, docs/frontend/domain-types.md

• 취향 기반 추천 응답 타입/문서 정합성 보완

  • BE 기준: RecommendResponse에는 brandName, category, primaryColor, primaryColorDisplay, primaryStyle, clothesId가 포함됩니다.
  • 현재 확인: FE 코드 일부는 primaryColorDisplay와 primaryStyle을 사용하지만, FE docs/api/frontend-api-usage.md의 주요 필드 표와 docs/frontend/domain-types.md의 예시 타입에는 일부 필드가 누락되어 있습니다.
  • 확인 대상: src/types/recommendations.ts, HomeTab, docs/api/frontend-api-usage.md, docs/frontend/domain-types.md, docs/features/home-recommendation.md

• AI MD 코디 저장의 wardrobeClothesIds 빈 배열/null 허용 기준 반영

  • BE 기준: AI MD 코디는 외부/내부 추천 상품만으로도 완성될 수 있으며 wardrobeClothesIds는 빈 배열 또는 null일 수 있습니다.
  • 현재 확인: FE src/api/aiMd.ts는 ownedItems의 모든 항목에 wardrobeClothesId가 있어야 저장 가능하도록 예외를 발생시킵니다.
  • 확인 대상: src/api/aiMd.ts, src/types/aiMd.ts, AI MD 코디 저장 UI, docs/api/frontend-api-usage.md, docs/features/home-recommendation.md, docs/frontend/implementation-gaps.md

• 운영 배포/S3 이미지 저장소 기준과 FE gap 문서 정리

  • BE 기준: 운영은 EC2/RDS/S3 및 /api/v1/images/** 프록시 URL 또는 공개 URL 기준을 문서화하고, S3 저장소 구현이 존재합니다.
  • 현재 확인: FE deploy 문서는 존재하지만 docs/frontend/implementation-gaps.md에는 AWS 배포 또는 CD workflow가 아직 구현되지 않았다는 표현이 남아 있습니다.
  • 확인 대상: FE 루트 README, deploy/README.md, docs/architecture/system-architecture.md, docs/architecture/tech-stack.md, docs/frontend/implementation-gaps.md

• FE 공통 응답 타입 문서/코드 정리

  • BE 기준: 공통 응답은 success, data, message입니다.
  • 현재 확인: FE src/types/be.ts의 BeApiResponse<T>는 BE 기준과 맞지만, src/types/index.ts의 ApiResponse<T>에는 status가 남아 있고 docs/frontend/implementation-gaps.md에도 해당 gap이 남아 있습니다.
  • 확인 대상: src/types/index.ts, src/types/be.ts, docs/frontend/domain-types.md, docs/frontend/implementation-gaps.md