🛒 ShoppingMall

Spring Boot로 만든 쇼핑몰 프로젝트입니다.
어느 곳에서든 사용하며 접할 수 있는 인터넷 쇼핑몰들을 모티브하여 설계하였습니다.
사용자, 판매자, 관리자의 권한이 있는 쇼핑몰 API입니다.

⚙ 기술 스택

• Language: Java
• JDK: 17
• Framework: Spring Boot 2.7.16
• ORM: Spring Data JPA
• Security: Spring Security
• DB: AWS RDS, AWS S3, MySQL
• Server: AWS EC2
• Test: JUnit5, AssertJ
• Build Tool: Gradle
• CI/CD: GitHub Actions, Docker

💡 주요 기능

( ▶ 를 누르면 간략한 기능 설명이 나옵니다. )

회원

• Spring Security 회원가입 및 로그인
  • 이메일 중복 체크
  • JWT 토큰
  • 로그인 시 Access Token, Refresh Token 발급
  • Refresh Token 이용해서 Access Token 재발급
• 자신의 회원 정보 조회
• 회원 정보 수정
• 회원 탈퇴
  • 전체 사용자: 회원의 장바구니, refresh token, 권한 삭제
  • 판매자: 사용자의 장바구니에 존재하는 판매자 판매 상품 삭제
  • 관리자: 해당 없음
• 비밀번호 변경
• (관리자) 회원 정보 전체 조회

주문

• 주문번호 생성(UUID)
• 주문 등록
  • 주문 수량 > 주문하려는 상품 재고 시, 주문 불가
  • 품절/판매중단인 상품 주문 불가
  • 주문 수량만큼 해당 상품 재고 감소
  • 총 주문 금액의 1% 적립금 부여
  • 주문 상품이 장바구니에 존재할 경우, 장바구니 DB에서 삭제
• 주문 취소(결제 취소)
  • 이미 취소한 결제 다시 취소 불가
  • 상품이 배송 중일 경우 취소 불가
  • 결제 회원과 다른 회원이 대신 결제 취소 불가
• 주문 전체 조회
• 주문 상세 조회

상품

• 상품 등록(판매자)
  • 상품 이미지는 1장 이상 필수 등록
  • 상품 이미지들은 AWS S3에 저장
  • 이미 존재하는 동일한 이름으로 상품 등록 불가
  • 상품 옵션 추가는 필수 X
• 상품 수정(판매자)
  • 사이트에 이미 존재하는 상품명으로 상품 수정 불가
• 상품 전체 조회(판매자)
• 상품 삭제(판매자)
• 상품 상세 조회(전체 사용자)
• 상품 전체 조회(전체 사용자)

장바구니

• 장바구니 생성
  • 장바구니에 담을 상품 수량 > 상품 재고 시, 장바구니에 등록 불가
  • 품절/판매중단인 상품 장바구니에 등록 불가
  • 장바구니에 이미 존재하는 상품이면 재등록 불가
• 장바구니 수정
• 회원에 해당하는 장바구니 전체 조회
• 선택한 장바구니들 다중 삭제

리뷰

• 리뷰 등록
  • 주문 완료 후 14일이내에 리뷰 등록 가능
• 리뷰 수정
• 리뷰 삭제
• (상품 상세조회) 리뷰 조회
• (마이페이지) 리뷰 조회

카테고리

• 카테고리 생성(관리자)
  • 이미 존재하는 동일한 이름으로 카테고리 등록 불가
• 카테고리 수정(관리자)
• 카테고리 조회(전체 사용자)
• 카테고리 삭제(관리자)
  • 카테고리내에 상품이 존재할 시 카테고리 삭제 불가

📂 패키지 구조

🔗 REST API 문서

• ShoppingMall API 문서

✔ 테스트 진행도

🔗 ERD

📃 Git 전략 - GitHub Flow

✏ Commit Convention

• [Feat]: 새로운 기능 구현
• [Fix]: 버그, 오류 해결, 코드 수정
• [Add]: Feat 이외의 부수적인 코드 추가
• [Test]: 테스트 코드 작성
• [Refactor]: 전면 수정이 있을 때 사용
• [Remove]: 파일 삭제, 필요없는 코드 삭제
• [Move]: 코드의 이동이 있는경우
• [Style]: 코드 포맷 변경, 세미콜론 누락, 코드 수정이 없는 경우
• [Chore]: 빌드 업무 수정, 패키지 매니저 수정
• [Docs]: 문서 개정
• [Setting]: 프로젝트 관련 세팅
• [Comment]: 필요한 주석 추가 및 변경
  
  

🛠 구조도

✍ 느낀점

1. 많은 에러를 겪으며 시행착오를 통해 더 성장하고 배움을 얻었습니다.
2. 프로젝트를 진행하며 새로운 기능의 추가 및 기존 코드의 수정이 빈번히 요구되었습니다. 이 과정에서 확장성과 유지보수를 고려한 코드의 중요성을 깨달았습니다.
3. 원래는 빌드 테스트, DB 테스트, Postman으로만 테스트를 하였으나, 이것만으로는 코드 오류를 완벽히 잡을 수 없다고 생각하여 테스트 코드를 도입하였습니다. 각 브랜치 별로 테스트 코드를 작성하며 기존 코드에서 발견하지 못했던 문제점을 발견하였고, 그것을 개선해나가며 테스트 코드의 중요성을 깨달았습니다.
4. 서로 코드를 보며 자신의 코드에 문제점을 알게 되었고, 그것을 고치는 과정에서 의사소통의 중요성을 알게 되었습니다. 또한 의사소통을 해가는 과정에서 누구나 이해하기 쉬운 코드가 좋은 코드라는 것을 깨달았습니다.
5. 처음에는 개발 시작에 급급하여 규칙을 정하지 않고 개발을 하였습니다. 하지만 복잡한 코드 구조와 통일성 없는 프로젝트는 오히려 개발속도를 더뎌지게 하였고, 다시 처음부터 Git convention과 패키지 구조의 설계, 시퀀스 다이어그램, 요구사항 명세서, 각 api 당 요청/응답 규칙, 변수명 규칙 등을 작성하며 구현 전 상세한 설계와 문서화의 중요성을 깨달았습니다.