< 김동일 튜터님 >
- API 명세
- 대면 피드백 드렸던 내용들 대체적으로 잘 반영해주셨습니다. 이번에 추가 수정사항이 발생한 것들 위주로 피드백 드리겠습니다.
- 브랜드 등록 API의 경우 response header에 json을 작성해주었습니다. 잘못 작성해주신 것 같으니 수정해주시기 바랍니다.
- 관리자 로그인/로그아웃의 응답값으로 data 부분은 빈 객체입니다. 빈 객체 보다는 data : true/false 혹은 data : { adminId : 1L } 과 같이 수정해주시면 좋을 것 같습니다.
- 대면 피드백 이후에 옵션을 테이블로 별도로 분리하셔서 옵션 관련 API도 추가된 것 같습니다. 옵션 등록 시 itemId가 필요하니 옵션 수정과 같이 itemId를 PathVariable로 받으시는 것이 좋을 것 같습니다. 또한, DB 테이블에 재고 컬럼도 있으니 재고 관련 값도 request body에 담아 주시는 것이 좋을 것 같습니다.
- 소셜 로그인 API URL이 너무 긴 것 같습니다. 추가적으로 현재는 카카오로그인만 구현하기 위해 URL에 kakao를 명시해주셨지만 네이버 로그인, 구글 로그인과 같이 기능이 추가되었을 때는 API가 추가적으로 만들어지게 될 것 같습니다. 그래서 확장성을 고려해 /api/users/login/{provider} 이렇게 URL을 구성하면 어떨지 생각해보시고 선정하시면 좋을 것 같습니다.
- 구매 입찰 및 판매 등록 API에서 request에서 optionId가 필요할 것 같습니다.
- 사용자 구매 내역 및 사용자 판매 내역은 request 부분을 고민하셔서 마저 작성해주시기 바랍니다.
- 중간 중간 response key값이 스네이크케이스로 작성되어있는데 이 부분도 모두 카멜케이스로 통일되면 좋을 것 같습니다.
- API 명세서에 에러 관련 응답도 추가되면 좋을 것 같습니다.
- ERD 작성
- account 테이블을 제외한 모든 테이블에서 varchar 길이가 정해져 있지 않습니다. 이 부분을 팀원들과 정하고 개발하시면 좋을 것 같습니다.
- item 테이블의 description 컬럼의 경우 설명이기 떄문에 길이가 길어질 것으로 예상됩니다. VARCHAR 보다는 TEXT로 변경하는 것이 좋을 것 같습니다.
- review 테이블에 image 필드가 1개의 리뷰에 1개의 이미지만 저장할 수 있는 구조입니다. 대부분의 서비스에서 리뷰는 이미지를 여러 장 등록할 수 있어 별도 테이블로 구성하시는 것이 서비스 기획 측면에서는 좋아 보이지만 개발 기간을 감안해서 설계하신 것이라면 설계하신 대로 진행하셔도 무방할 것 같습니다.
- 데이터 타입에 enum으로 작성해 주신 컬럼들은 비고란에 어떤 enum값들을 정의할 것인지도 추가되면 좋을 것 같습니다.
- 역할 분담
- 제출하신 노션에 담당자가 아직 지정되어 있지 않아 역할 분담에 대해 파악이 어렵습니다. 하지만 이전 대면 피드백 때 이야기했던 것처럼 도메인별로 역할 분담을 하시고 지속적인 커뮤니케이션을 통해 유동적으로 서로 도우면서 개발을 진행하시면 좋을 것 같습니다.
- git 컨벤션 및 브랜치 전략 그리고 협업 시 준수해야 할 사항들을 팀원들과 잘 논의해서 작성하신 것 같습니다!
- 협업 시 준수해야 할 규칙에 나오는 코드 리뷰는 꼭 활성화가 되면 좋을 것 같습니다.
- 추가 사항
- API 기준으로 보았을 때 스코프는 적정한 것 같지만 아직 역할 분담이 안되어 가늠하기는 힘든 것 같습니다. 역할 분담 후 업무를 더욱 세분화 시켜서 일정을 최대한 구체적으로 산정하시면 좋을 것 같습니다.
- 테스트 코드 작성 및 배포 일정 그리고 도전해 볼 것들까지도 같이 고려하시면 좋을 것 같습니다.
- 프론트 구현까지 고려하셨지만 대면 피드백 드렸던 것처럼 우선순위는 API 개발이니 일정 산출 잘 하셔서 개발 진행하시면 좋을 것 같습니다!
- 팀원 간 커뮤니케이션을 활성화해서 각 팀원의 진행률을 공유하시면 좋을 것 같습니다.
- 최종 프로젝트 화이팅입니다!