ECom은 현대적인 마이크로서비스 아키텍처를 기반으로 구축된 E-commerce 플랫폼입니다. Spring Boot 3.x와 Java 17을 사용하여 개발되었으며, 확장성과 유지보수성을 고려한 멀티모듈 구조로 설계되었습니다.

• 사용자 관리: JWT 기반 인증/인가 시스템
• RBAC 보안: 역할 기반 접근 제어 (User, Admin, Super Admin)
• 상품 관리: 카테고리별 상품 관리, 이미지 업로드, 검색 및 필터링
• 장바구니: 실시간 장바구니 관리 및 세션 유지
• 주문 처리: 주문 생성, 결제 처리, 주문 추적
• 배송 관리: 배송주소 관리, 기본 주소 설정
• 관리자 시스템: 상품, 주문, 사용자 관리

• Framework: Spring Boot 3.4.3, Spring Security, Spring Data JPA
• Language: Java 17
• Build Tool: Gradle 8.x
• Authentication: JWT (jjwt 0.11.5)
• Authorization: RBAC (Role-Based Access Control)
• Query: QueryDSL 5.0.0
• Validation: Spring Boot Starter Validation

• Primary DB: MySQL 8.0
• Cache: Redis
• Connection Pool: HikariCP

• Cloud: AWS S3
• Local Development: MinIO

• Containerization: Docker, Docker Compose
• Testing: JUnit 5, Spring Boot Test, H2 (Test DB)

graph TB
    subgraph "Client Layer"
        WEB[Web Client]
        MOBILE[Mobile App]
        ADMIN[Admin Panel]
    end
    
    subgraph "Gateway Layer"
        LB[Load Balancer]
    end
    
    subgraph "Application Layer"
        API[API Module]
        ADMIN_API[Admin Module]
    end
    
    subgraph "Core Layer"
        CORE[Core Module]
        DOMAIN[Domain Entities]
        REPO[Repositories]
    end
    
    subgraph "Infrastructure Layer"
        DB[(MySQL 8.0)]
        REDIS[(Redis Cache)]
        S3[AWS S3/MinIO]
    end
    
    WEB --> LB
    MOBILE --> LB
    ADMIN --> LB
    LB --> API
    LB --> ADMIN_API
    API --> CORE
    ADMIN_API --> CORE
    CORE --> DB
    CORE --> REDIS
    CORE --> S3
    
    classDef client fill:#e1f5fe
    classDef app fill:#f3e5f5
    classDef core fill:#e8f5e8
    classDef infra fill:#fff3e0
    
    class WEB,MOBILE client
    class API,ADMIN_API app
    class CORE core
    class DB,REDIS,S3 infra

ECom/
├── api/                          # API 모듈 (사용자 대상)
│   └── src/main/java/com/example/api/
│       ├── ApiApplication.java
│       ├── core/config/          # API 설정
│       └── module/               # 기능별 모듈
│           ├── auth/             # 인증
│           ├── cart/             # 장바구니
│           ├── order/            # 주문
│           ├── product/          # 상품
│           ├── payment/          # 결제
│           └── shipping_address/ # 배송주소
├── admin/                        # 관리자 모듈
│   └── src/main/java/com/example/admin/
│       ├── AdminApplication.java
│       └── module/
│           └── auth/             # 관리자 인증
├── core/                         # 핵심 모듈 (공통)
│   └── src/main/java/com/example/core/
│       ├── CoreApplication.java
│       ├── config/               # 공통 설정
│       ├── domain/               # 도메인 엔티티
│       ├── dto/                  # 데이터 전송 객체
│       ├── enums/                # 열거형
│       ├── exception/            # 예외 처리
│       ├── model/                # 응답 모델
│       └── utils/                # 유틸리티
├── docker-compose.yml            # 로컬 개발 환경
└── build.gradle                  # 빌드 설정

• Java 17+
• Docker & Docker Compose
• Gradle 8.x+

1. 저장소 클론

git clone https://github.com/f-lab-edu/ECom.git
cd ECom

2. 인프라 서비스 시작

docker-compose up -d

3. 애플리케이션 빌드 및 실행

# Core 모듈 빌드
./gradlew :core:build

# API 서버 실행
./gradlew :api:bootRun

# 관리자 서버 실행 (별도 터미널)
./gradlew :admin:bootRun

4. 서비스 확인

• API 서버: http://localhost:8080
• 관리자 서버: http://localhost:8081
• MinIO 웹 UI: http://localhost:9001 (minioadmin/minioadmin)

• Method-Level Security: @PreAuthorize 어노테이션 활용
• URL-Level Security: Spring Security 필터 체인 활용
• JWT 통합: 토큰에 역할 정보 포함
• 자동 역할 할당: 회원가입 시 ROLE_USER 자동 부여

• 캐싱: Redis를 활용한 조회 성능 향상
• Pessimistic Lock: 재고 관리 동시성 제어

• RBAC (Role-Based Access Control): 역할 기반 접근 제어 시스템
  • ROLE_USER: 일반 사용자 권한 (장바구니, 주문, 배송주소 관리)
  • ROLE_ADMIN: 관리자 권한 (상품 관리, 사용자 조회)
  • ROLE_SUPER_ADMIN: 최고 관리자 권한 (관리자 생성, 전체 시스템 관리)
• JWT 인증: 토큰 기반 인증/인가, 역할 정보 포함
• Method-Level Security: @PreAuthorize 어노테이션을 통한 세밀한 권한 제어
• URL-Level Security: Spring Security 설정을 통한 엔드포인트별 접근 제어
• 비밀번호 Salt + Hash 저장