FITinside는 LF몰, 무신사와 같은 온라인 쇼핑몰을 모티브로 한 웹사이트입니다.
사용자는 다양한 상품을 탐색하고, 원하는 상품을 장바구니에 담아 관리할 수 있습니다.
회원가입 및 로그인(구글 로그인 포함)을 통해 주문도 완료할 수 있으며 카테고리별 상품 분류 및 쿠폰 적용 기능 등을 추가해 사용자 경험을 향상시켰습니다.
2024.09.30 ~ 2024.10.25 (1개월)
-
Java 17
- 최신 LTS(Long-Term Support) 버전으로 안정성과 성능 제공
-
Spring Boot 3.3.4
- 경량화된 자바 프레임워크, RESTful API 구축 및 서버 사이드 로직 처리하는 역할을 수행하고 이번 프로젝트 표준 기술로 채택
-
Spring Security 3.3.4
- Spring Boot를 사용하여 개발하는 과정에 높은 연동성을 제공하고 인증, 권한 부여와 엑세스 제어등의 여러 기능을 편리하게 이용하여 사용자 데이터를 안전하게 보호
-
JWT 0.12.1
- 무상태성(State-Less)를 지향하는 HTTP의 특성에 적합하고 로그인 정보가 필요한 부분의 확장을 용이하게하는 장점을 이용하고자 선택
-
JPA 3.3.4
- 개발 과정에서 여러 데이터베이스 사용하고 연동하기 위한 ORM 기술을 사용해 객체지향 언어를 사용한 Spring Boot 프로젝트에 적합, 효율적인 데이터베이스 처리 구현, SQL Mapping 기술보다 단순한 DB조작을 많이 하는 서비스를 구현하는 이번 프로젝트에 적합
-
MySQL(AWS RDS)
- 관계형 데이터베이스, 쇼핑몰의 데이터를 저장 및 관리
-
JUnit 5.9.3
- Java 기반의 단위 테스트 프레임워크로, 테스트 작성 및 실행을 위한 다양한 기능을 제공. 테스트 케이스를 작성하고 관리하는 데 있어 유연성을 높이며, 새로운 기능들과 다양한 확장성을 통해 효율적인 테스트 환경을 구현할 수 있도록 지원
-
Jakarta Mail 2.0.3
- 이메일 발송을 위한 라이브러리로, Spring Boot와 통합하여 비동기적으로 메일을 전송
-
AWS S3 2.2.6
- Amazon의 객체 저장 서비스, 대용량 데이터 저장 및 관리에 최적화, 이미지 파일을 효율적으로 저장하고, 쉽게 접근할 수 있도록 지원
-
HTML, CSS
- 웹 표준을 준수한 마크업 및 스타일링
-
React
- 컴포넌트 기반의 UI 라이브러리를 활용하여 효율적인 상태 관리 및 인터랙티브한 사용자 인터페이스 구현
-
Axios
- 백엔드와의 HTTP 통신을 위한 비동기 요청 처리 라이브러리
-
배포 url
-
프론트엔드 배포
- Netlify
- Netlify
-
백엔드 배포
- 엘리스 클라우드 VM
- GNU/Linux 5.15.0-91-generic
- Ubuntu 22.04.5 LTS
- GNU/Linux 5.15.0-91-generic
- 엘리스 클라우드 VM
- GitLab Project
- GitLab Issues
- GitHub(Netlify 배포용)
- Discord
- Notion
- Mapstruct 1.5.3
- Lombok 1.18.34
- Swagger 2.0.4
-
비동기 작업 통한 이메일 전송 성능 개선
-
쿠폰 도메인에서 여러 메서드에서 n+1 문제가 발생하여 레파지토리에 fetch join을 포함한 jpql을 적용하여 해결
-
토큰 인증 예외가 아닌 경우에도 401 에러가 반환되는 문제가 발생하여 CustomExceptionHandler에 유효성 검사 예외 처리 메서드를 추가하여 해결
- Git-flow 전략을 기반으로 master, develop 브랜치와 featue 등의 기능 브랜치를 활용했습니다.
- master : 기준이 되는 브랜치로 배포를 위한 브랜치입니다.
- develop : 개발 브랜치로 해당 브랜치를 기준으로 각자 작업한 기능들을 merge 합니다.
- review-develop : 기능 브랜치를 develop에 merge하기 전 팀원들간의 코드 리뷰를 통해 작성한 코드 설명 및 공유하기 위한 브랜치입니다.
- publish-develop : 배포를 위해 master 브랜치로 보내기 전에 먼저 QA(품질검사)를 하기위한 브랜치입니다.
- feature: 기능 단위로 독립적인 개발 환경을 위해 사용하고 merge 후 브랜치를 삭제해주었습니다.
- refactor: 기존 코드를 개선하고 구조를 변경하는 브랜치입니다. merge 후 브랜치를 삭제해 주었습니다.
- test: 테스트 코드를 작성하거나 기존 테스트 코드를 리팩토링 하는 브랜치입니다. review-develop으로 merge 후 브랜치를 삭제해 주었습니다.
-
이메일, 비밀번호 기반의 로그인 기능
-
이메일, 비밀번호 기반의 회원가입 기능
-
Google API Cloud 연동한 로그인 기능
-
클라이언트에 저장된 AccessToken으로 로그인 유지 기능
-
토큰 탈취 대책으로 짧은 수명의 AccessToken, 자동 재발급을 위한 RefreshToken 쿠키 저장
- 메인 화면에서 광고 기능
- 배너의 조회, 생성, 수정, 삭제 가능
- 배너를 통한 url 연결 기능
-
공통(회원, 관리자)
-
헤더
부모 카테고리의 드롭 다운을 통해 자식 카테고리 조회 가능
-
이미지 포함 카테고리
이미지와 포함 카테고리 조회 가능
-
-
관리자
- 카테고리 생성, 수정, 삭제 가능(이미지와 정렬 순서 추가 가능)
-
공통
- 상품 조회 & 장바구니로 이동
-
관리자 페이지
- 상품 조회 & 상품 등록
- 상품 관련 데이터를 수정
- 상품 삭제
- 비회원/회원 구분없이 장바구니 추가 가능
- 장바구니 정보가 비회원은 로컬스토리지, 회원은 db에 저장
- 장바구니에 담긴 상품 수량 수정, 삭제 기능
- 배송비, 쿠폰등이 적용된 결제 예정 금액 출력 기능
-
관리자
- 쿠폰 생성, 비활성화 가능
- 쿠폰 목록 (전체 / 활성화만) 조회 (만료일 기준 오름차순 정렬, 페이지네이션 적용) 가능
- 쿠폰 보유 (페이지네이션 적용), 미보유 회원 조회 가능
- 미보유 회원에게 쿠폰 이메일 전송 가능
-
회원
- 쿠폰 다운로드 가능
- 보유한 쿠폰 목록 (전체 / 사용가능) 조회(만료일 기준 오름차순 정렬, 페이지네이션 적용) 가능
- 쿠폰 사용 내역 (주문서) 조회 가능
-
관리자
- 회원의 주문 관리 → 주문 상태 변경, 주문 삭제
- 주문 상태, 날짜별 검색 기능
-
회원
- 배송지 입력 후 주문 생성 가능
- 주문 상세 조회
- 배송 시작 전이면 배송지 수정 / 주문 취소 가능
- 여기서 수정한 배송지는 주문에만 적용 (배송지 목록에 따로 반영 X)
- 주문 목록 조회
- 한 페이지에 총 5개씩 주문 확인 가능 (최신순 정렬)
- 상품명 검색 기능
-
회원
- 배송지는 회원당 최대 5개 저장 가능
- 5개 제한 → 사용자 편의성 고려
- 수령인 이름, 우편번호, 주소, 전화번호 중 하나라도 다르면 다른 배송지로 간주
- 수정, 삭제
- 기본 배송지 설정 / 해제
- 기본 배송지 설정 → 주문서 작성 시 자동으로 입력
- 배송지는 회원당 최대 5개 저장 가능
| MVP | Method | URI | Description | Request Body | Request Params | Response |
|---|---|---|---|---|---|---|
| 사용자 정보 조회 | GET | /api/user/me | 토큰 기반 사용자 정보 조회 | - | - | 성공 { "username": "string", "email": "string", "phone": "string", "creatAt": "localDateTime"} |
| 회원가입 | POST | /api/auth | 회원가입 | { "userName": "string", "email": "string", "password": "string", "phone" : "string" } |
- | 성공 200 : { "id": "long", "userName": "string", "email": "string", "phone" : "string", "createdAt": "datetime" } 실패 401 : { "error": "UNAUTHORIZED" } |
| 로그인 | POST | /api/auth/login | 로그인 | { "email": "string", "password": "string" } |
- | 성공 200 : { "token": "JWT_ACCESS_TOKEN" }실패 401 :{ "error": "UNAUTHORIZED" } |
| MVP | Method | URI | Description | Request body | Request Params | Response |
|---|---|---|---|---|---|---|
| 배너 목록 조회 | GET | /api/banners | 전체 배너 조회 | - | - | 성공 200 OK : [{ "id": "Long", "title": "string", "imageUrl": "string", "displayOrder": "integer", "targetUrl": "string" }] |
| MVP | Method | URI | Description | Request body | Request Params | Response |
|---|---|---|---|---|---|---|
| 카테고리 목록 조회 | GET | /api/categories | 전체 카테고리 조회 | - | - | 성공 200 OK : [{"id": "Long", "name": "string", "displayOrder": "Long", "mainDisplayOrder": "Long", "isDeleted": "Boolean", "parentId": "Long", "imageUrl": "string"}] |
| MVP | Method | URI | Description | Request Body | Request Params | Response |
|---|---|---|---|---|---|---|
| 상품 목록 조회 | GET | /api/products | 전체 상품 목록 조회 (페이지네이션, 정렬, 검색 적용) | - | {"page": "int", "size": "int", "sortField": "string", "sortDir": "string", "keyword": "string"} |
성공 200 OK : 상품 목록 조회 성공 { "id": "Long", "categoryId": "Long", "categoryName": "string", "productName": "string", "price": "int", "createdAt": "datetime", "soldOut": "boolean" }실패 400 BAD REQUEST: 잘못된 요청 |
| 상품 상세 조회 | GET | /api/products/{id} | 특정 상품 상세 조회 | - | {"id": "Long"} |
- **200 OK** : 상품 상세 조회 성공 { "id": "Long", "categoryId": "Long", "categoryName": "string", "productName": "string", "price": "int", "info": "string", "manufacturer": "string", "productImgUrls": ["url1", "url2"], "createdAt": "datetime", "updatedAt": "datetime", "soldOut": "boolean" }실패 400 BAD REQUEST: 잘못된 요청 404 Not Found: 상품을 찾을 수 없음 |
| MVP | Method | URI | Description | Headers | Request Body | Response |
|---|---|---|---|---|---|---|
| 조회 | GET | /api/carts | 장바구니 목록 조회 | Authorization: Bearer JWT_TOKEN |
- | 성공 200 OK: { ”message”: “장바구니 조회 완료했습니다!”, “carts”: [ { ”productId”: Long, “quantity”: int } ]}실패 403 FORBIDDEN: “권한이 없는 사용자입니다.”500 INTERNAL SERVER ERROR: "서버 에러" |
-
관리자
MVP Method URI Description Headers Request Body Request Param Response 쿠폰 목록 조회 GET /api/admin/coupons 존재하는 쿠폰 전체 조회 (유효한 쿠폰만 조회 / 전체 쿠폰 조회) Authorization: Bearer JWT_TOKEN- { “page”: int, “includeInActiveCoupons”: boolean }성공
200 OK:{ ”message”: “쿠폰 목록 조회 완료했습니다!”, “coupons”: [ { “id”: Long, “name”: String, “code”: String, “type”: CouponType, “value”: int, “percentage”: int, “minValue”: int, “active”: boolean, “expiredAt”: LocalDate, “categoryName”: String, “used”: boolean } ], “totalPages”: int}
실패
403 FORBIDDEN:“권한이 없는 사용자입니다.”
404 NOT FOUND:“해당하는 정보의 사용자를 찾을 수 없습니다.”
500 INTERNAL SERVER ERROR:“서버 에러” -
회원
MVP Method URI Description Headers Request Body RequestParam Response 보유 쿠폰 전체 조회 GET /api/coupons 로그인 한 회원의 보유 쿠폰 전체 조회 (유효한 쿠폰만 조회 / 전체 쿠폰 조회) Authorization: Bearer JWT_TOKEN- { “page”: int, “includeInActiveCoupons”: boolean }성공
200 OK:{ ”message”: “쿠폰 목록 조회 완료했습니다!” “coupons”: [ { “id”: Long, “name”: String, “code”: String, “type”: CouponType, “value”: int, “percentage”: int, “minValue”: int, “active”: boolean, “expiredAt”: LocalDate, “categoryName”: String, “used”: boolean } ], “totalPages”: int }
실패
403 FORBIDDEN:“권한이 없는 사용자입니다.”
500 INTERNAL SERVER ERROR:“서버 에러”쿠폰 사용 POST /api/coupon/{couponMemberId} 상품에 쿠폰 사용 Authorization: Bearer JWT_TOKEN- - 성공
200 OK:“쿠폰이 사용되었습니다! couponMemberId: ” + couponMemberId
실패
400 BAD REQUEST:“쿠폰 정보가 유효하지 않습니다.”
403 FORBIDDEN:“권한이 없는 사용자입니다.”
500 INTERNAL SERVER ERROR:“서버 에러”
-
관리자
MVP Method URI Description Request Body Request Params Response 전체 주문 조회 GET /api/admin/orders 모든 회원의 전체 주문 조회 - { "page": "int", "orderStatus": "string", "startDate": "localDateTime", "endDate": "localDateTime" }성공
200 OK:[ { "orders": [ { "orderId": "int", "orderStatus": "string", "totalPrice": "int", "discountedTotalPrice": "int", "email": "string", "createdAt": "localDateTime", "coupons": [ { "couponId": "int", "name": "string", "discountPrice": "int" } ] } ], "totalPages": "int" } ]
실패
403 FORBIDDEN:“권한이 없습니다.”
500 INTERNAL SERVER ERROR:“서버 에러” -
회원
MVP Method URI Description Request Body Request Params Response 전체 주문 조회 GET /api/orders 전체 주문 조회 - { "page":"int", "productName":"string"}성공
200 OK:{ "orders": [ "orderId": "int", "orderStatus": "string", "totalPrice": "int", "discountedTotalPrice": "int", "deliveryAddress": "string", "productNames": [ "string" ], "productImgUrl": "string", "createdAt": "localDateTime" ], "totalPages": "int" }
실패
403 FORBIDDEN:“권한이 없습니다.”
500 INTERNAL SERVER ERROR:“서버 에러”주문 생성 POST /api/order 사용자 주문 생성 { "postalCode": "string", "deliveryAddress": "string", "detailedAddress": "string", "deliveryReceiver": "string", "deliveryPhone": "string", "deliveryMemo": "string", "deliveryFee": "int", "orderItems": [ "productId": "int", "productName": "string", "quantity": "int", "itemPrice": "int", "originalTotalPrice": "int", "discountedTotalPrice": "int", "couponName": "string", "couponMemberId": "int"]}- 성공
201 CREATED:{ "orderId": "int", "orderStatus": "string", "totalPrice": "int", "discountedTotalPrice": "int", "deliveryFee": "int", "postalCode": "string", "deliveryAddress": "string", "detailedAddress": "string", "deliveryReceiver": "string", "deliveryPhone": "string", "deliveryMemo": "string", "createdAt": "localDateTime", "orderProducts": [ "productId": "int", "orderProductName": "string", "orderProductPrice": "int", "count": "int", "discountedPrice": "int", "couponName": "string", "productImgUrl": "stirng" ] }
실패
400 BAD REQUEST:“품절된 상품”
403 FORBIDDEN:“권한이 없습니다.”
404 NOT FOUND:“비어있는 장바구니”
500 INTERNAL SERVER ERROR:“서버 에러”
프로젝트 구조
# address : 배송지
# banner : 광고
# cart : 장바구니
# category : 상품 카테고리
# coupon : 상품 쿠폰
# global : 전역 예외
# member : 회원
# oath : 인증
# order : 주문
# produt : 상품
src
├── main
│ └── java
│ └── com
│ └── team2
│ └── fitinside
│ ├── address
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ ├── banner
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ ├── cart
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ ├── category
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ ├── config
│ ├── coupon
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ ├── global
│ │ └── exception
│ ├── jwt
│ ├── member
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ ├── oath
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── repository
│ │ ├── service
│ │ └── util
│ ├── order
│ │ ├── common
│ │ ├── controller
│ │ ├── dto
│ │ ├── entity
│ │ ├── mapper
│ │ ├── repository
│ │ └── service
│ └── product
│ ├── controller
│ ├── dto
│ ├── entity
│ ├── image
│ ├── mapper
│ ├── repository
│ └── service
└── test
└── java
└── com
└── team2
└── fitinside
├── auth
├── cart
│ ├── controller
│ └── service
├── coupon
│ ├── controller
│ └── service
└── member
└── service
## Exception Handling and HTTP Status Codes
### 1. **400 Bad Request**
클라이언트의 잘못된 요청으로 인해 발생하는 오류입니다.
- **POST_DELETED**: 삭제된 게시글입니다.
- **REVIEW_DELETED**: 삭제된 리뷰입니다.
- **COMMENT_DELETED**: 삭제된 댓글입니다.
- **EMPTY_FILE_EXCEPTION**: 빈 파일입니다.
- **NO_FILE_EXTENSION**: 파일 확장자가 없습니다.
- **INVALID_FILE_EXTENSION**: 허용되지 않는 파일 확장자입니다.
- **INVALID_FILE_FORMAT**: 허용되지 않는 파일 형식입니다.
- **AUTH_CODE_EXTENSION**: 로그인을 실패하였습니다(임시).
- **INVALID_PRODUCT_DATA**: 상품 정보가 유효하지 않습니다.
- **INVALID_PRODUCT_PRICE**: 가격은 0 이상이어야 합니다.
- **INVALID_PRODUCT_NAME_LENGTH**: 상품명은 100자 이하로 입력해야 합니다.
- **INVALID_PRODUCT_INFO_LENGTH**: 상품 설명은 500자 이하로 입력해야 합니다.
- **INVALID_MANUFACTURER_LENGTH**: 제조사는 100자 이하로 입력해야 합니다.
- **INVALID_COUPON_DATA**: 쿠폰 정보가 유효하지 않습니다.
- **INVALID_COUPON_CREATE_DATA**: 쿠폰 생성 정보가 유효하지 않습니다.
- **INVALID_EMAIL_DATA**: 이메일 정보가 유효하지 않습니다.
- **OUT_OF_STOCK**: 현재 주문 가능한 상품의 개수를 초과했습니다.
- **ORDER_MODIFICATION_NOT_ALLOWED**: 배송이 시작된 주문은 수정할 수 없습니다.
- **CART_OUT_OF_RANGE**: 상품 수량은 1개 이상 20개 이하여야 합니다.
- **INVALID_CATEGORY_DATA**: 카테고리 정보가 유효하지 않습니다.
### 2. **401 Unauthorized**
인증되지 않은 사용자가 접근을 시도할 때 발생하는 오류입니다.
- **INVALID_AUTH_TOKEN**: 권한 정보가 없는 토큰입니다.
- **USER_NOT_AUTHENTICATED**: 인증되지 않은 사용자입니다.
### 3. **403 Forbidden**
사용자가 권한이 없는 리소스에 접근하려 할 때 발생하는 오류입니다.
- **USER_NOT_AUTHORIZED**: 권한이 없는 사용자입니다.
### 4. **404 Not Found**
요청한 리소스가 존재하지 않을 때 발생하는 오류입니다.
- **USER_NOT_FOUND**: 해당하는 정보의 사용자를 찾을 수 없습니다.
- **OBJECT_NOT_FOUND**: 대상을 찾을 수 없습니다.
- **RESOURCE_NOT_FOUND**: 대상을 찾을 수 없습니다.
- **PRODUCT_NOT_FOUND**: 해당 상품을 찾을 수 없습니다.
- **CATEGORY_NOT_FOUND**: 해당 카테고리를 찾을 수 없습니다.
- **CART_NOT_FOUND**: 해당 장바구니를 찾을 수 없습니다.
- **COUPON_NOT_FOUND**: 해당 쿠폰을 찾을 수 없습니다.
- **ORDER_NOT_FOUND**: 주문을 찾을 수 없습니다.
- **CART_EMPTY**: 장바구니가 비어있습니다.
- **ORDER_PRODUCT_NOT_FOUND**: 해당 상품에 대한 주문을 찾을 수 없습니다.
- **ADDRESS_NOT_FOUND**: 해당 배송지를 찾을 수 없습니다.
### 5. **409 Conflict**
리소스의 현재 상태와 충돌할 때 발생하는 오류입니다.
- **DUPLICATE_RESOURCE**: 데이터가 이미 존재합니다.
- **DUPLICATE_COUPON**: 쿠폰 등록 이력이 존재합니다.
- **EXCEEDED_MAX_ADDRESS_LIMIT**: 배송지 최대 저장 개수를 초과했습니다.
- **DUPLICATE_ADDRESS**: 배송지가 이미 존재합니다.
### 6. **410 Gone**
리소스가 더 이상 유효하지 않을 때 발생하는 오류입니다.
- **USER_ALREADY_DELETED**: 탈퇴된 사용자입니다.
- **PLACE_DELETED**: 삭제된 장소입니다.
- **CATEGORY_ALREADY_DELETED**: 이미 삭제된 카테고리입니다.
### 7. **500 Internal Server Error**
서버 내부에서 예상치 못한 오류가 발생했을 때 반환하는 상태 코드입니다.
- **IO_EXCEPTION_ON_IMAGE_UPLOAD**: 이미지 업로드 중 입출력 오류가 발생했습니다.
- **PUT_OBJECT_EXCEPTION**: S3에 객체를 업로드하는 중 예외가 발생했습니다.
- **IO_EXCEPTION_ON_IMAGE_DELETE**: 이미지 삭제 중 입출력 오류가 발생했습니다.
- **PRODUCT_LIST_RETRIEVAL_ERROR**: 상품 목록 조회 중 서버 에러 발생.
- **PRODUCT_DETAIL_RETRIEVAL_ERROR**: 상품 상세 조회 중 서버 에러 발생.
- **PRODUCT_CREATION_ERROR**: 상품 등록 중 서버 에러 발생.
- **PRODUCT_UPDATE_ERROR**: 상품 수정 중 서버 에러 발생.
- **PRODUCT_DELETION_ERROR**: 상품 삭제 중 서버 에러 발생.