sequence-diagram.md

Sequence Diagram

---

• 1. 상품 검색
• 2. 상품 상세 조회
• 3. 인기 상품
• 4. 주문 / 결제
• 5. 잔액
• 6. 선착순 쿠폰
• 7. 장바구니

---

1. 상품 검색

상품명, 카테고리, 가격 범위, 인기순 등의 조건으로 상품 검색 시 상품 목록을 반환한다.

sequenceDiagram
	autonumber
    actor 사용자
    사용자 ->>+ Search: 상품 검색 호출
    Search -->>- 사용자: 상품 목록

Loading

---

2. 상품 상세 조회

상품 ID로 상품 정보(이름, 가격, 잔여 수량 등)를 조회 한다.

sequenceDiagram
	autonumber
    actor 사용자
    사용자 ->>+ Product: 상품 조회
    Product -->>- 사용자: 상품 상세 정보

Loading

---

3. 인기 상품

인기 상품 목록 조회

Cache 처리 되어있는 인기 상품 목록을 조회 한다.

sequenceDiagram
	autonumber
    actor 사용자
    사용자 ->>+ Ranking: 인기 상품 조회 요청 
    Ranking ->>+ Cache: 인기 상품 조회 
    Cache -->>- Ranking: 인기 상품 목록 반환 
    Ranking -->>- 사용자: 인기 상품 목록 반환

Loading

인기 상품 목록 생성

배치 작업이 매 00시 마다 실행되어 인기 상품(최근 3일간 판매량 기준, 가장 많이 팔린 상위 5개 상품) 데이터를 생성한다.

sequenceDiagram
    autonumber
	loop 하루 1회 실행 
		Batch ->>+ Ranking: 인기 상품 데이터 생성 요청 
		Ranking ->>+ Order: 최근 3일 기준 판매량 Top 5 조회
		Order -->>- Ranking: 판매량 Top 5 상품 반환
		Ranking ->> Ranking: 인기 상품 목록 저장 
		Ranking -->>- Batch: 배치 작업 완료 
	end

Loading

---

4. 주문 / 결제

주문 생성

회원 식별자와 장바구니 정보, 쿠폰 식별자를 입력받아 주문을 생성.

sequenceDiagram
	autonumber
	actor 사용자
	
	사용자 ->>+ Order: 주문 생성 요청

	Order ->>+ Cart: 장바구니 정보 조회
	Cart -->>- Order: 장바구니 정보 반환
	
	Order ->>+ Product: 상품 정보 조회
	Product -->>- Order: 상품 정보 반환
	
	Order ->>+ Stock: 재고 차감
	break 재고 없음
		Stock -->>- 사용자: 재고 없음
	end
	
	opt 쿠폰 사용
		Order ->>+ Coupon: 쿠폰 상태 변경 (사용)
		break 유효하지 않은 쿠폰
			Coupon -->>- 사용자: 유효하지 않은 쿠폰
		end
	end
	
	Order ->> Order: 주문정보 생성
	
	Order -) Cart: 해당 주문 장바구니 제거
	
	Order -->>- 사용자: 주문 정보 반환

Loading

결제 요청

생성된 주문 정보로 결제를 요청한다.

sequenceDiagram
	autonumber
	actor 사용자
	
	사용자 ->>+ Payment: 결제 요청
	
	Payment ->>+ Order: 주문 정보 조회
	Order -->>- Payment: 주문 정보 반환
	
	Payment ->>+ User: 잔액 차감
	break 잔액 부족
		User -->>- 사용자: 잔액 부족
	end
	
	Payment ->>+ Order: 주문 상태 변경(결제 완료)
	Order -->>- Payment: 주문 상태 완료
	
	Payment -) DataPlatform: 외부 데이터 플랫폼 호출
	
	Payment -->>- 사용자: 결제 완료

Loading

결제 취소

생성된 주문/결제 정보를 취소 처리한다.

sequenceDiagram 
	autoNumber
	actor 사용자
	
	사용자 ->>+ Payment: 결제 취소 요청
	Payment ->>+ Payment: 결제 상태 확인
	
	alt 취소 불가한 결제 상태인 경우
		Payment -->>- 사용자: 유효하지 않은 주문 상태
	else 취소 가능한 결제 상태인 경우
		Payment ->> Payment: 결제 취소 처리
		
		Payment ->>+ Order: 주문 취소 요청
		Order -->>- Payment: 주문 취소 처리 완료
		
		Payment ->>+ User: 포인트 환불 처리
		User -->>- Payment: 포인트 환불 완료
		
		opt 쿠폰 사용
			alt 쿠폰 만료일 <= 현재 날짜
				Payment ->>+ User: 쿠폰 복원 처리
				User -->>- Payment: 쿠폰 복원 완료
			end
		end
		
		Payment -) DataPlatform: 외부 데이터 플랫폼 호출
		
		Payment -->>- 사용자: 결제 취소 완료
	end

Loading

---

5. 잔액

잔액 충전

회원 식별자를 통해 결제에 사용할 금액(포인트)을 충전 할 수 있음

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ User: 잔액 충전 요청
	
	break 유효하지 않은 충전 금액
		User -->> 사용자: 유효하지 않은 충전 금액
	end
	User -->>- 사용자: 잔액 충전 완료

Loading

잔액 조회

충전된 포인트의 잔액을 실시간으로 조회 가능

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ User: 잔액 조회 요청
	User -->>- 사용자: 잔액 반환

Loading

---

6. 선착순 쿠폰

• 금액 할인 쿠폰(예: 5,000원 할인)과 정률 할인 쿠폰(예: 10% 할인) 제공
• 제한된 수량만 선착순 발급 가능
• 발급받은 쿠폰 목록을 조회하고, 주문 시 쿠폰을 사용하여 전체 금액 할인 가능

발급 쿠폰 목록 조회

사용자가 발급 받은 쿠폰 목록을 조회한다.

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ User: 발급 쿠폰 목록 조회 요청
	User -->>- 사용자: 발급 쿠폰 목록 반환

Loading

선착순 쿠폰 발급

선착순 쿠폰을 발급 받는다.

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ Coupon: 선착순 쿠폰 발급 요청
	break 잔여 쿠폰 없음
		Coupon -->> 사용자: 잔여 쿠폰 없음
	end
	Coupon -->>- 사용자: 선착순 쿠폰 발급 완료

Loading

---

7. 장바구니

장바구니에 상품 추가

회원/비회원 상품을 장바구니에 추가 한다.

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ Cart: 장바구니 상품 추가
	Cart ->>+ Product: 상품 조회
	Product -->>- Cart: 상품 정보 반환
	break 유효하지 않은 상품 판매 상태
		Cart -->> 사용자: 유효하지 않은 상품 판매 상태
	end
	Cart -->>- 사용자: 장바구니 상품 추가 완료

Loading

장바구니 조회

회원/비회원의 장바구니를 조회 한다.

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ Cart: 장바구니 조회 요청
	Cart ->>+ Product: 상품 조회
	Product -->>- Cart: 상품 정보 반환
	Cart ->> Cart: 상품 정보 반영
	Cart -->>- 사용자: 장바구니 정보 반환

Loading

장바구니 상품 삭제

회원/비회원의 장바구니를 삭제한다.

sequenceDiagram
	autoNumber
	actor 사용자

	사용자 ->>+ Cart: 장바구니 상품 삭제 요청
	Cart -->>- 사용자: 장바구니 상품 삭제 완료

Loading

비회원 장바구니 병합

비회원이 담은 장바구니는 로그인 시 해당 회원의 장바구니로 병합한다.

sequenceDiagram
autoNumber
	actor 사용자

사용자 ->>+ Cart: 장바구니 병합 요청
Cart ->> Cart: 회원 장바구니 정보 조회
Cart ->> Cart: 비회원 장바구니 정보 조회
Cart ->> Cart: 회원 장바구니 병합 처리
Cart -->>- 사용자: 장바구니 병합 완료

Loading