2024.07 - ing

구분	기술
백엔드(Java)	Spring Boot, JPA, QueryDSL
백엔드(Kotlin)	Spring Boot
백엔드(TypeScript)	Nest.js, MikroORM
데이터베이스	MySQL, PostgreSQL, MongoDB
보안/인증	Spring Security, JWT
배포	Docker
기타	CSRF 보호, 테스트 프로필 분리

주요 기능 요약

기능 그룹	기능
회원(Member)	회원가입, 로그인, 로그아웃
상품(Product)	등록, 수정, 상세 조회, 리스트 조회(전체/내가 등록한 제품), 판매 상태 변경
주문(Order)	주문 생성, 주문 리스트 조회, 주문 상세 조회, 주문 상태 변경
로그(Log)	활동 로그 기록 및 조회

Sequence Diagram

1. 제품 등록

sequenceDiagram
    actor User as 판매자(Client)
    
    box API Server
        participant Resolver as Auth Resolver
        participant Controller as API Controller
        participant Service as Business Logic Service
        participant Repository as Data Access Layer
    end
    
    participant DB as Database
  
    User->>Resolver: POST /api/products<br>Authorization: Bearer <token>
    note right of User: 제품 등록 요청
    
    alt 유효한 토큰 (Valid Token)
        note right of Resolver: Authorization 헤더 토큰 검증
        Resolver->>Controller: Forward Request (사용자 정보, 제품 정보)
        note right of Resolver: 제품 등록 요청
        
        Controller->>Service: Process Product Registration (제품 정보)
        note right of Controller: 제품 등록을 위한 비즈니스 로직 호출
        
        Service->>Repository: Save Product (제품 정보)
        note right of Service: 제품 정보 전달
        
        Repository->>DB: INSERT INTO products...
        note right of Repository: 제품 정보 저장
        
        alt 저장 성공 (201 Created)
            DB-->>Repository: 저장 성공 응답
            note right of DB: 제품 정보 저장 완료
            Repository-->>Service: 저장 성공 응답
            Service-->>Controller: Product Registration Successful
            Controller-->>Resolver: 201 Created
            Resolver-->>User: 201 Created (제품 등록 성공)
            note right of Resolver: 제품 등록 성공 알림
        else 저장 실패 (500 Internal Server Error)
            DB-->>Repository: 저장 실패 응답
            note right of DB: 제품 정보 저장 중 오류 발생
            Repository-->>Service: 저장 실패 응답
            Service-->>Controller: Registration Failed
            Controller-->>Resolver: 500 Internal Server Error
            Resolver-->>User: 500 Internal Server Error (제품 등록 실패)
            note right of Resolver: 제품 등록 실패 알림
        end
    else 유효하지 않은 토큰 (Invalid Token)
        Resolver-->>User: 401 Unauthorized (유효하지 않은 토큰)
        note right of Resolver: 유효하지 않은 토큰 알림
    end

2. 제품 주문

sequenceDiagram
    actor Buyer as 구매자(Client)
    
    box API Server
        participant Resolver as Auth Resolver
        participant Controller as API Controller
        participant Service as Business Logic Service
        participant Repository as Data Access Layer
    end
    
    participant DB as Database
  
    Buyer->>Resolver: POST /api/products/{productId}/orders<br>Authorization: Bearer <token>
    note right of Buyer: 제품 주문 요청
    
    alt 유효한 토큰 (Valid Token)
        note right of Resolver: Authorization 헤더 토큰 검증
        Resolver->>Controller: Forward Request (사용자 정보, 구매 정보)
        note right of Resolver: 제품 구매 요청
        
        Controller->>Service: Process Purchase (구매 정보)
        note right of Controller: 구매를 위한 비즈니스 로직 호출
        
        Service->>Repository: Check Product Availability (제품 ID)
        note right of Service: 구매 가능 가격/상태/재고 확인
        
        Repository->>DB: SELECT * FROM products WHERE id = 제품 ID
        note right of Repository: 제품 정보 조회
        
        DB-->>Repository: 제품 정보 반환
        Repository-->>Service: 제품 확인 결과 전달
            
        alt 상태/가격/재고 확인 성공 (200 OK)                
            Service->>Repository: Save Purchase (구매 정보)
            note right of Service: 구매 정보 전달
            
            Repository->>DB: INSERT INTO purchases...
            note right of Repository: 구매 정보 저장
            
            alt 저장 성공 (201 Created)
                DB-->>Repository: 저장 성공 응답
                Repository-->>Service: 저장 성공 응답
                Service-->>Controller: Purchase Successful
                Controller-->>Resolver: 201 Created
                Resolver-->>Buyer: 201 Created (구매 성공)
                note right of Resolver: 구매 성공 알림
            else 저장 실패 (500 Internal Server Error)
                DB-->>Repository: 저장 실패 응답
                Repository-->>Service: 저장 실패 응답
                Service-->>Controller: Purchase Failed
                Controller-->>Resolver: 500 Internal Server Error
                Resolver-->>Buyer: 500 Internal Server Error (구매 실패)
                note right of Resolver: 오류 메시지 알림
            end
        else 재고 없음 (404 Not Found)
            Service-->>Controller: Purchase Failed
            Controller-->>Resolver: 404 Not Found
            Resolver-->>Buyer: 404 Not Found (재고 부족)
            note right of Resolver: 재고 부족 메시지 알림
        else 가격 변동 (404 Not Found)
            Service-->>Controller: Purchase Failed
            Controller-->>Resolver: 404 Not Found
            Resolver-->>Buyer: 404 Not Found (가격 변동)
            note right of Resolver: 가격 변동 메시지 알림
            end
    else 유효하지 않은 토큰 (Invalid Token)
        Resolver-->>Buyer: 401 Unauthorized (유효하지 않은 토큰)
        note right of Resolver: 유효하지 않은 토큰 알림
    end

ERD

erDiagram
    members {
		    long id PK "아이디"
				string name "이름"
				string nick_name "닉네임"
				string email "이메일"
				string password "비밀번호"
        timestamp created_date "생성일시"
        timestamp modified_date "수정일시"
    }
    
    products {
		    long id PK "아이디"
		    long provider_id FK "판매자 아이디"
        string name "이름"
				int total_quantity "총 수량"
				int sold_quantity "판매 수량"
        decimal price "가격"
		    int status "제품 판매 상태"
        timestamp created_date "제품 등록일시"
        timestamp modified_date "제품 수정일시"
    }
   
    orders {
		    long id PK "아이디"
		    long customer_id FK "구매자 아이디"
		    int status "주문 상태"
		    decimal price "가격"
		    decimal total_price "결제 비용"
		    long quantity "수량"
        timestamp created_date "주문 생성일시"
        timestamp modified_date "주문 수정일시"
    }
    
    logs {
	    long id PK "아이디"
	    long member_id FK "멤버 아이디"
	    long target_id "대상 아이디"
	    int target_type "대상 타입"
 	    int action_type "행동 타입"
      timestamp created_date "주문 생성일시"
      timestamp modified_date "주문 수정일시"
    }
    
		members ||--|{ products : manages
    products ||--|{ orders : contains
    members ||--|{ orders : places
    members ||--|{ logs : manages

Flow Chart

flowchart TB

    start(((시작))) --비회원--> Join[회원가입]
		start --비회원--> Login[로그인]
	  start --> ProductList[제품 리스트 조회]
	  start --회원--> ProductCreate[제품 등록]
	  start --회원--> OrderList[주문 리스트 조회]
	  start --회원--> LogList[활동 로그 조회]
    start --회원--> Logout[로그아웃]
    
	  ProductList --> Product[제품 상세 조회]
	  ProductList --회원--> ProductOwned[등록 제품 리스트 조회]
	  Product --회원--> ProductOrder[제품 주문]
	  ProductOwned --회원--> ProductOrderList[특정 제품 주문 리스트 조회]
	  ProductOrderList --회원--> ProductStatue[제품 상태 변경]
	  ProductOrderList --회원--> OrderStatue[주문 상태 변경]
	  
	  OrderList --회원--> Order[주문 상세 조회]
	  Order --회원--> OrderStatus[주문 상태 변경]

API Documentation

API 명세 (요약본)

리소스	메서드	경로	설명
회원	POST	`/api/members/join`	회원가입
	POST	`/api/members/login`	로그인(JWT 발급)
	DELETE	`/api/members/logout`	로그아웃
상품	POST	`/api/products`	상품 등록
	GET	`/api/products`	전체 상품 조회
	GET	`/api/products/{id}`	상품 상세 조회
	PATCH	`/api/products/{id}`	상품 정보 수정
	GET	`/api/products/owned`	내가 등록한 상품 조회
	PATCH	`/api/products/owned/{id}`	상품 상태 변경
주문	POST	`/api/products/{id}`	상품 주문 생성
	GET	`/api/orders`	주문 리스트 조회
	GET	`/api/orders/{id}`	주문 상세 조회
	DELETE	`/api/orders/{id}`	주문 취소
로그	GET	`/api/logs`	활동 로그 조회

상태값 정의

분류	상태값	설명
Product Status	`FOR_SALE`, `SOLD_OUT`	판매중, 판매완료
Order Status	`IN_PROGRESS`, `COMPLETED`, `CANCELED`	진행중, 완료, 취소
Target Type	`PRODUCT`, `ORDER`	로그 대상
Action Type	`CREATE`, `UPDATE`, `DELETE`, `COMPLETE`, `ACTIVATE`, `DEACTIVATE`	로그 액션

Sequence Diagram

1. 제품 등록

2. 제품 주문

ERD

Flow Chart

API Documentation

Request Headers