### 1. 사전 준비 사항 - Docker 및 Docker Compose가 설치되어 있어야 합니다. - Docker가 실행중이어야 합니다. ### 2. 데이터베이스 실행 애플리케이션을 시작하기 전에 데이터베이스를 Docker Compose를 사용하여 설정해야 합니다.
다음 명령어를 사용하여 각 서버의 데이터베이스를 실행합니다. ```shell docker-compose -f ./docker-compose.auth.yml up -d ``` 위 명령어는 백그라운드에서 데이터베이스 컨테이너를 실행합니다.
실행 중인 상태를 확인하려면 `docker ps` 명령어를 사용하세요. ### 3. 서버 실행 (포트 8080) 서버별로 터미널을 열어 다음 명령어를 실행합니다. ```shell ./gradlew :bootJar ``` ```shell java -jar ./build/libs/yousinsa-0.0.1-SNAPSHOT.jar ```

### 1. 서버 종료 서버를 종료하려면 터미널에서 다음 명령어를 실행합니다. ```shell sudo lsof -i :8080 sudo kill -9 [PID] # [PID]는 실제 프로세스 ID로 대체 ``` ### 2. 데이터베이스 종료 데이터베이스를 종료하려면 다음 명령어를 사용합니다. ```shell docker-compose -f ./docker-compose.auth.yml down ```

디렉터리 구조는 크게 domain과 global로 구분합니다. - **domain**: 서비스의 핵심 비즈니스 로직 코드가 도메인별로 구현되어 있습니다. - **global**: 핵심 비즈니스 로직에 종속적이지 않고 전역에서 사용할 수 있는 리스폰스 형식, 예외 처리 등을 관리합니다. ### domain 도메인은 비즈니스 로직에 맞춰 세분화되어 있으며, 각각의 도메인은 공통적으로 controller, dto, entity, repository, service 계층을 가집니다. 도메인의 종류는 아래와 같습니다. - **auth**: 인증 및 인가와 관련된 로직을 담당합니다. JWT 기반의 인증 필터, 토큰 제공자, 유저 정보 관리 서비스 등을 구현합니다. - **brand**: 브랜드 관련 데이터 관리 로직을 담당합니다. 브랜드 정보를 관리하고, 브랜드 엔티티 및 관련 리포지토리를 통해 데이터베이스와 상호작용합니다. - **product**: 상품과 관련된 로직을 담당합니다. 상품 정보, 상세 정보 등을 제공하며, 컨트롤러 및 서비스 계층에서 비즈니스 로직을 처리합니다. - **user**: 사용자 정보와 관련된 로직을 담당합니다. 사용자 등록, 로그인, 등급 관리 등의 비즈니스 로직을 구현합니다. 각 도메인은 아래와 같은 하위 패키지 구조로 이루어져 있습니다. - **controller**: 사용자 요청이 진입하는 지점이며, 요청을 적절한 서비스로 전달하여 처리하는 역할을 합니다. - **dto**: 데이터를 전송할 때 사용하는 객체를 관리합니다. 사용자 요청(request) 및 응답(response) 데이터를 처리합니다. - **entity**: 데이터베이스 테이블과 매핑되는 객체를 관리합니다. - **repository**: 데이터베이스와의 상호작용을 관리하며, JPA를 이용해 CRUD를 처리합니다. - **service**: 비즈니스 로직을 담당하며, 필요한 데이터를 가공하고 처리합니다. ### global **global** 디렉토리는 전역적으로 사용되는 유틸리티 클래스, 예외 처리 클래스 등을 포함합니다. - **api**: API 응답 형식 및 공통 유틸리티 메서드를 관리합니다. - **entity**: 공통적으로 사용되는 엔티티를 정의합니다. - **exception**: 전역 예외 처리 로직을 포함하며, 사용자 정의 예외 클래스와 에러 코드를 관리합니다.

``` . ├── HELP.md ├── build.gradle ├── docker-compose.yml ├── gradle │   └── wrapper │   ├── gradle-wrapper.jar │   └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── settings.gradle └── src ├── main │   ├── java │   │   └── com │   │   └── yhkim │   │   └── yousinsa │   │   ├── YousinsaApplication.java │   │   ├── domain │   │   │   ├── auth │   │   │   │   ├── JwtAuthenticationEntryPoint.java │   │   │   │   ├── JwtAuthenticationFilter.java │   │   │   │   ├── JwtTokenProvider.java │   │   │   │   ├── TokenType.java │   │   │   │   ├── UserDetailsImpl.java │   │   │   │   ├── config │   │   │   │   │   └── WebSecurityConfig.java │   │   │   │   ├── controller │   │   │   │   │   └── AuthController.java │   │   │   │   ├── dto │   │   │   │   │   ├── JwtTokenInfo.java │   │   │   │   │   └── ReissueTokenResponse.java │   │   │   │   ├── entity │   │   │   │   │   └── RefreshToken.java │   │   │   │   ├── repository │   │   │   │   │   └── RefreshTokenRepository.java │   │   │   │   └── service │   │   │   │   ├── AuthService.java │   │   │   │   ├── AuthServiceImpl.java │   │   │   │   └── UserDetailsServiceImpl.java │   │   │   ├── brand │   │   │   │   ├── dto │   │   │   │   │   └── BrandInfo.java │   │   │   │   ├── entity │   │   │   │   │   └── Brand.java │   │   │   │   └── repository │   │   │   │   └── BrandRepository.java │   │   │   ├── product │   │   │   │   ├── controller │   │   │   │   │   └── ProductController.java │   │   │   │   ├── dto │   │   │   │   │   ├── GetProductDetailResponse.java │   │   │   │   │   ├── GetProductResponse.java │   │   │   │   │   └── ProductInfo.java │   │   │   │   ├── entity │   │   │   │   │   └── Product.java │   │   │   │   ├── repository │   │   │   │   │   └── ProductRepository.java │   │   │   │   └── service │   │   │   │   ├── ProductService.java │   │   │   │   └── ProductServiceImpl.java │   │   │   └── user │   │   │   ├── controller │   │   │   │   └── UserController.java │   │   │   ├── dto │   │   │   │   ├── Links.java │   │   │   │   ├── LoginUserRequest.java │   │   │   │   ├── LoginUserResponse.java │   │   │   │   ├── SignupUserRequest.java │   │   │   │   └── SignupUserResponse.java │   │   │   ├── entity │   │   │   │   ├── Grade.java │   │   │   │   └── User.java │   │   │   ├── repository │   │   │   │   └── UserRepository.java │   │   │   └── service │   │   │   ├── UserService.java │   │   │   └── UserServiceImpl.java │   │   └── global │   │   ├── api │   │   │   └── ApiUtils.java │   │   ├── entity │   │   │   ├── BaseEntity.java │   │   │   └── config │   │   │   └── JpaConfig.java │   │   └── exception │   │   ├── CustomException.java │   │   ├── ErrorCode.java │   │   └── GlobalExceptionHandler.java │   └── resources │   ├── application.yml │   ├── data.sql │   ├── static │   └── templates └── test └── java └── com └── yhkim └── yousinsa └── YousinsaApplicationTests.java ```