spring-gift-order (Mission 4)

API 명세

홈 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
메인 페이지	GET	/	메인 페이지

회원 관리 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
로그인 페이지	GET	/members/login	로그인 페이지
로그인 처리	POST	/members/login	로그인
회원가입 페이지	GET	/members/register	회원가입 페이지
회원가입 처리	POST	/members/register	회원가입
로그아웃 처리	POST	/members/logout	로그아웃
마이페이지	GET	/members/mypage	마이페이지 조회
비밀번호 변경 페이지	GET	/members/edit	비밀번호 변경 페이지
비밀번호 변경	POST	/members/edit	비밀번호 변경 처리
회원 탈퇴	POST	/members/delete	회원 탈퇴 처리

카카오 로그인 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
카카오 로그인 처리	GET	/members/login/oauth2/code/kakao	카카오 로그인 성공 후 인가 코드를 받아 처리

상품 관리 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
상품 목록 페이지	GET	/products	전체 상품 목록 조회

상품 관리 관리자 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
상품 목록 조회	GET	/admin/product	전체 상품 목록 조회
상품 상세 조회	GET	/admin/product/{productId}	상품 상세 정보 조회
상품 추가	POST	/admin/product/add	새 상품 등록
상품 수정	POST	/admin/product/edit/{productId}	상품 정보 수정
상품 삭제	DELETE	/admin/product/{productId}	상품 삭제

상품 옵션 관리자 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
상품 옵션 관리 페이지	GET	/admin/products/{productId}/options	특정 상품의 옵션 목록 및 추가/삭제 페이지
상품 옵션 추가	POST	/admin/products/{productId}/options/add	특정 상품에 새 옵션 추가
상품 옵션 삭제	POST	/admin/products/{productId}/options/delete/{optionId}	특정 상품의 옵션 삭제

위시리스트 관리 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
위시리스트 페이지	GET	/wishes	사용자의 위시리스트 목록 페이지를 표시
위시리스트 추가 처리	POST	/wishes/add	상품을 위시리스트에 추가하고 목록 페이지로 리다이렉트
위시리스트 수량 수정 처리	POST	/wishes/update/{wishId}	위시리스트 상품의 수량을 수정하고 목록 페이지로 리다이렉트
위시리스트 삭제 처리	POST	/wishes/delete/{wishId}	위시리스트에서 상품을 삭제하고 목록 페이지로 리다이렉트

주문 관리 View

기능	HTTP Method	엔드포인트 (Endpoint)	설명
주문서 작성 페이지	GET	/orders/form	위시리스트 ID(wishId)를 받아 주문서 페이지를 표시
주문 처리	POST	/orders/create	주문 정보를 받아 주문을 생성하고 성공 페이지로 리다이렉트
주문 성공 페이지	GET	/orders/success	주문 성공 후 표시되는 페이지

회원 관리 API

기능	HTTP Method	엔드포인트 (Endpoint)	요청 (Request)	응답 (Response)
일반 회원가입	POST	/api/members/register	Body: MemberRegisterRequest	201 Created Body: JWT 토큰
관리자 회원가입	POST	/api/members/register/admin	Body: MemberRegisterRequest	201 Created Body: JWT 토큰
로그인	POST	/api/members/login	Body: MemberLoginRequest	200 OK Body: JWT 토큰

상품 관리 API

기능	HTTP Method	엔드포인트 (Endpoint)	요청 (Request)	응답 (Response)
상품 등록	POST	/api/admin/products	Body: ProductRequestDto (상품 정보)	201 Created Body 없음
전체 상품 조회	GET	/api/admin/products	없음	200 OK Body: List<ProductResponseDto> (상품 목록)
특정 상품 조회	GET	/api/admin/products/{productId}	Path: productId	200 OK Body: ProductResponseDto (상품 상세 정보)
상품 정보 수정	PUT	/api/admin/products/{productId}	Path: productId Body: ProductRequestDto (수정할 상품 정보)	204 No Content Body 없음
상품 삭제	DELETE	/api/admin/products/{productId}	Path: productId (상품 ID)	204 No Content Body 없음

상품 옵션 API

기능	HTTP Method	엔드포인트 (Endpoint)	요청 (Request)	응답 (Response)
상품 옵션 목록 조회	GET	/api/products/{productId}/options	Path: productId	200 OK Body: List<ProductOptionResponseDto>

위시리스트 관리 API

기능	HTTP Method	엔드포인트 (Endpoint)	요청 (Request)	응답 (Response)
위시리스트 추가	POST	/api/wishes	Header: Authorization (JWT 토큰) Body: WishRequest	201 Created Body: 없음
위시리스트 조회	GET	/api/wishes	Header: Authorization (JWT 토큰) Query: page, size, sort	200 OK Body: Page<WishListResponse> (위시리스트 목록)
위시리스트 수량 수정	PATCH	/api/wishes/{wishId}	Header: Authorization (JWT 토큰) Path: wishId Body: WishUpdateRequest	204 No Content Body: 없음
위시리스트 삭제	DELETE	/api/wishes/{wishId}	Header: Authorization (JWT 토큰) Path: wishId	204 No Content Body: 없음

주문 관리 API

기능	HTTP Method	엔드포인트 (Endpoint)	요청 (Request)	응답 (Response)
주문 생성	POST	/api/orders	Header: Authorization (JWT 토큰)Body: OrderRequestDto	201 CreatedBody: OrderResponseDto (생성된 주문 정보)

주문하기 - 외부 API 연동

0단계 - 기본 코드 준비

• 상품 관리 페이지 번호 하이퍼링크 수정

1단계 - 카카오 로그인

• 토큰 응답 매핑 DTO 생성
• 사용자 정보 응답 매핑 DTO 생성
• 카카오 API 통신 클라이언트 구현
• 인가 코드 리다이렉트 컨트롤러 구현
• 카카오 로그인 페이지 UI 구현
• 카카오 로그인 테스트 코드 작성

1단계 - 코드 리뷰 반영

• Test code를 실행할 때 JwtUtil 대신 FakeJwtUtil 적용해서 JWT 의존성 제거
• test용 properties 파일 정의

2단계 - 주문하기

• orders 도메인, repository 구현
• 카카오 메시지 템플릿용 DTO 구현
• orderService 구현 - 주문 시 상품 옵션 재고 차감 처리
  • 일반 로그인 사용자 : 주문만 완료
  • 카카오 로그인 사용자 : 주문 완료 후 카카오톡 메시지 발송
• orderController 구현
• 상품 주문 페이지 구현

2단계 - 코드 리뷰 반영

• kakao OAuth RestClient baseUrl 상수를 KakaoProperties로 이동
• CreateOrder Transaction 단위 조정
• 주문하기 시 해당 상품이 위시 리스트에 있는 경우 위시 리스트에서 삭제하기
• 주문하기 테스트 코드 추가

3단계 - 배포하기

• EC2 생성 및 배포 스크립트 작성
• GitHub Action workflow 작성
• CORS 문제 해결
• (옵션) HTTPS 적용하기

spring-gift-product (Mission 1)

상품관리 - 스프링 입문

1단계 - 상품 API

• Product 도메인 구현
• Product DTO 구현
• Product Service 구현
• Product Controller 구현
• 공통 예외 처리 구현 (NOT_FOUND)

1단계 - 코드 리뷰 반영

• 불필요한 주식 제거
• 테스트용 코드 제거
• 규칙 9: getter/setter/프로퍼티를 쓰지 않는다 - Product setter 제거
• service 계층의 id, Map 객체를 repository 계층으로 이동

2단계 - 관리자 화면

• 상품 리스트 조회 페이지 구현
• 상품 추가 페이지 구현
• 상품 상세 페이지 구현
• 상품 수정 & 삭제 페이지 구현

2단계 - 코드 리뷰 반영

• 주석 제거
• 불필요한 생성자 제거
• Optional 예외 처리 refactoring
• 매직 넘버 제거

3단계 - 데이터베이스 적용

• schema.sql 작성
• interface를 사용해서 기존 repo 추상화
• JdbcProductRepository 구현
• 테스트 코드 보완(ProductApiControllerTest)

3단계 - 코드 리뷰 반영

• JdbcClient에서 사용할 RowMapper 직접 구현하고 setter와 기본 생성자 제거
• 사용하지 않는 메소드 제거
• validation 사용자 경험 개선(500 error -> forwarding)

spring-gift-wishlist (Mission 2)

위시 리스트 - 요청과 응답 심화

0단계 - 기본 코드 준비

1단계 - 유효성 검사 및 예외 처리

• 유효성 검사 로직 구현하기(검증기).
• API 에 유효성 검사 적용
• 상품관리 관리자 페이지에 적용

1단계 - 코드 리뷰 반영

• 유효성 검사 실패시 모든 실패 항목 메시지에 포함하기
• README.md 에 체크박스 사용해보기
• 400 에러 테스트 코드 추가하기

2단계 - 회원 로그인

• Member 도메인 구현, 스키마 추가
• MemberRepository 구현
• JWT 토큰 생성, 토근 정보 추출 구현
• MemberService 구현
• MemberController 구현
• Member 예외 처리 구현
• JWT 인증 필터(인터셉터) 적용
• 인증 예외 처리 구현
• 테스트 코드 JWT 인증 추가

2단계 - 코드 리뷰 반영

• 헬퍼 메서드 접근 지정자 수정
• 표기법 통일(properties)
• JWT expiration 적용
• JWT 관련 deprecated 메소드 사용 제거
• Interceptor: authHeader 토큰 문제 수정
• Member register, login 테스트 코드 작성
• 테스트 코드 메소드 추출, 불필요한 코드 제거

3단계 - 위시 리스트

• 회원 login, register 페이지 구현
• cookie 기반 토큰 인터셉터 처리 로직 구현
• 위시 리스트 domain, repository 설계
• 위시 리스트 service, controller 설계
• 위시 리스트 페이지 구현
• 상품 관리 관리자 페이지 접근 권한 검증
• 회원 수정, 삭제에 필요한 service, repository 추가 구현
• 회원 수정, 삭제 페이지 구현
• 암호화 적용하기

3단계 - 코드 리뷰 반영

• wish service, repository, controller 피드백 내용 수정
• AccessDeniedException 제거 후 적절한 커스텀 예외 도입
• Interceptor 간 의존성 제거하기

spring-gift-enhancement (Mission 3)

상품 고도화 - JPA

0단계 - 기본 코드 준비

1단계 - 엔티티 매핑

• domain 모델 JPA entity로 전환하기
• repository interface 추가
• JdbcClient -> JPA 전환하기
• @DataJpaTest를 활용한 테스트 코드 작성해보기

1단계 - 코드 리뷰 반영

• import 시 와일드 카드 사용 제거
• 코드 포매팅 개선
• @ManyToOne optional 설정
• 외래 키 제약조건 명시적으로 설정하기
• member repository 인터페이스 파라미터 참조형으로 변경
• member repository 불필요한 Adapter 코드 제거
• product repository 인터페이스 파라미터 참조형으로 변경
• product repository 불필요한 Adapter 코드 제거
• wish repository 인터페이스 파라미터 참조형으로 변경
• wish repository 불필요한 Adapter 코드 제거
• wish repository Response 의존성 제거
• wish repository 메소드에서 JPA 변경 감지 활용하기

2단계 - 페이지네이션

• Pageable 객체를 활용해서 product pagination 적용하기
• product Thymeleaf 페이지 기반으로 수정하기
• Pageable 객체를 활용해서 wish pagination 적용하기
• wish Thymeleaf 페이지 기반으로 수정하기
• 페이지네이션 기능 확인용 DB에 테스트 데이터 추가하기

2단계 - 코드 리뷰 반영

• 페이지네이션 sort 필드 유효성 검증 로직 추가
• 페이지네이션 ID 값 기준으로 다음 데이터 찾는 메서드 구현

3단계 - 상품 옵션

• Option 엔티티 생성 및 Product 연관 관계 설정
• Option 재고 차감, 중복 이름 검증 구현
• Option repository 구현
• Option service 구현
• Option controller 구현
• (선택) 상품 옵션 서비스 화면 추가
• Option Api 요청 테스트 코드 추가

3단계 - 코드 리뷰 반영

• 사용하지 않는 변수 제거
• product, productOption 연관관계 설정 메서드 리팩토링, 중복 제거
• Product update시 변경되는 필드만 접근하도록 변경
• 페이지네이션 sort 인자 에러를 PropertyReferenceException가 아닌 Controller 단에서 처리하도록 수정
• Transactional 범위 축소
• '카카오' 이름 사용 가능 여부 RolyType에 따라 제한하도록 수정하기