Chapter 3. UML(Unified Modeling Language)

I. Flow Chart

flowchart TD
    A1["공연 선택"] --> B1["예약 가능 날짜 조회"]
    B1 --> C1{"날짜 선택 가능 여부"}
    C1 -- "가능" --> D1["특정 날짜 선택"]
    C1 -- "불가능" --> B1

    D1 --> E1["대기열 토큰 생성"]
    E1 --> F1["대기 상태 확인 (폴링 시작)"]
    F1 --> G1{"차례인가?"}
    G1 -- "아니오" --> F1
    G1 -- "예" --> H1["예약 가능 좌석 조회"]
    H1 --> I1["좌석 선택"]
    I1 --> J1["좌석 예약 요청"]
    J1 --> K1["결제(포인트 차감)"]
    K1 --> L1{"결제 성공?"}
    L1 -- "예" --> M1["예약 완료"]
    L1 -- "아니오" --> N1["결제 실패 처리"]
    
    %% 부가적인 이벤트
    N1 --> O1["포인트 충전 또는 좌석 재선택"]
    O1 --> H1

    %% 설명을 위한 노트
    style A1 fill:#f9f,stroke:#333,stroke-width:2px
    style M1 fill:#0f0,stroke:#333,stroke-width:2px
    style N1 fill:#f66,stroke:#333,stroke-width:2px

II. API 별 Sequence Diagram

1. 예약 가능 날짜 조회 API

sequenceDiagram
    participant User as 사용자
    participant DatePage as "예약 가능 날짜 조회 페이지"
    participant SeatAPI as "지정 날짜 예약 가능 좌석 조회 API"
    participant ScheduleDB as "공연일정 테이블(DB)"

    User->>DatePage: 공연 선택 후 예약 가능 날짜 조회 요청
    DatePage->>SeatAPI: 지정 날짜 예약 가능 좌석 조회 API 호출
    SeatAPI->>ScheduleDB: 공연 일정 확인 (공연 ID)
    ScheduleDB-->>SeatAPI: 예약 가능 날짜 목록 반환
    SeatAPI-->>DatePage: 예약 가능 날짜 목록 응답
    DatePage-->>User: 예약 가능 날짜 표시

---

2.대기 상태 확인 API : 대기열 최초 진입 시점

sequenceDiagram
    participant User as 사용자
    participant WaitAPI as "대기 상태 확인 API"
    participant TokenCreate as "토큰 생성 모듈"
    participant WaitTokenDB as "대기 상태 토큰 테이블(DB)"
    participant Queue as "대기열 모듈"

    User->>WaitAPI: 대기 상태 확인 요청 (선택 날짜)
    alt 쿠키에 토큰이 없음
        WaitAPI->>TokenCreate: 토큰 생성 요청 (사용자 ID, 공연 ID, 날짜)
        TokenCreate->>WaitTokenDB: 새로운 토큰 저장
        WaitTokenDB-->>TokenCreate: 토큰 생성 완료
        TokenCreate-->>WaitAPI: 토큰 ID 반환
        WaitAPI->>User: 쿠키에 토큰 ID 설정 + 대기 상태 응답
    else 쿠키에 토큰이 있음
        WaitAPI->>Queue: 대기 순번 확인 (토큰 ID)
        Queue-->>WaitAPI: 현재 대기 순번 및 상태
        WaitAPI-->>User: 대기 순번 및 상태 응답
    end

---

3. 대기 상태 확인 API : 폴링 및 토큰 유효성 검증

sequenceDiagram
    participant User as 사용자
    participant WaitAPI as "대기 상태 확인 API"
    participant Queue as "대기열 모듈"
    participant TokenVerify as "토큰 검증 모듈"
    participant ActiveTokenDB as "활성화 상태 토큰 테이블(DB)"
    participant SeatPage as "지정 날짜 예약 가능 좌석 조회 페이지"

    %% 폴링 주기 설정 (1분)
    Note over User, WaitAPI: 사용자는 1분 간격으로 대기 상태를 확인합니다.

    loop 매 1분마다 폴링
        User->>WaitAPI: 대기 상태 재확인 요청 (토큰 ID)
        WaitAPI->>Queue: 현재 순번 확인 (토큰 ID)
        Queue-->>WaitAPI: 순번 및 상태 반환
        alt 차례인 경우
            WaitAPI->>TokenVerify: 토큰 유효성 검증 (토큰 ID)
            TokenVerify->>ActiveTokenDB: 토큰 상태 확인
            ActiveTokenDB-->>TokenVerify: 활성화 상태 반환
            TokenVerify-->>WaitAPI: 유효성 결과
            WaitAPI->>SeatPage: 좌석 조회 페이지로 Redirect (토큰 ID)
            Note right of SeatPage: 폴링 종료
        else 차례가 아닌 경우
            WaitAPI-->>User: 남은 대기 인원 정보 응답
        end
        Note right of WaitAPI: 1분 후 다시 폴링 시작
    end

---

4. 지정 날짜 예약 가능 좌석 조회 API

sequenceDiagram
    participant User as 사용자
    participant SeatPage as "지정 날짜 예약 가능 좌석 조회 페이지"
    participant SeatAPI as "지정 날짜 예약 가능 좌석 조회 API"
    participant TokenVerify as "토큰 검증 모듈"
    participant ActiveTokenDB as "활성화 상태 토큰 테이블(DB)"
    participant SeatDB as "좌석 테이블(DB)"

    User->>SeatPage: 좌석 조회 페이지 접속 (토큰 ID)
    SeatPage->>SeatAPI: 지정 날짜 예약 가능 좌석 조회 API 호출 (토큰 ID, 날짜)
    SeatAPI->>TokenVerify: 토큰 유효성 검증 (토큰 ID)
    TokenVerify->>ActiveTokenDB: 토큰 상태 확인
    ActiveTokenDB-->>TokenVerify: 활성화 상태 반환
    TokenVerify-->>SeatAPI: 유효성 결과
    alt 토큰 유효한 경우
        SeatAPI->>SeatDB: 예약 가능 좌석 목록 조회 (날짜)
        SeatDB-->>SeatAPI: 예약 가능 좌석 목록 반환
        SeatAPI-->>SeatPage: 예약 가능 좌석 목록 응답
        SeatPage-->>User: 예약 가능 좌석 표시
    else 토큰 무효한 경우
        SeatAPI-->>SeatPage: 토큰 무효 응답
        SeatPage-->>User: 날짜 조회 페이지로 Redirect
    end

---

5.좌석 예약 요청 API

sequenceDiagram
    participant User as 사용자
    participant ReserveAPI as "좌석 예약 요청 API"
    participant TokenVerify as "토큰 검증 모듈"
    participant ActiveTokenDB as "활성화 상태 토큰 테이블(DB)"
    participant TentativeDB as "가예약 좌석 테이블(DB)"
    participant PaymentAPI as "결제(포인트 차감) API"

    User->>ReserveAPI: 좌석 예약 요청 (토큰 ID, 사용자 ID, 공연 ID, 좌석 ID)
    ReserveAPI->>TokenVerify: 토큰 유효성 검증 (토큰 ID)
    TokenVerify->>ActiveTokenDB: 토큰 상태 확인
    ActiveTokenDB-->>TokenVerify: 활성화 상태 반환
    TokenVerify-->>ReserveAPI: 유효성 결과
    alt 토큰 유효한 경우
        ReserveAPI->>TentativeDB: 가예약 좌석 등록 (좌석 ID, 5분 타이머 설정)
        TentativeDB-->>ReserveAPI: 가예약 완료
        ReserveAPI-->>User: 결제 페이지로 Redirect
    else 토큰 무효한 경우
        ReserveAPI-->>User: 예약 불가 응답
    end

---

6. 결제(포인트 차감) API

sequenceDiagram
    participant User as 사용자
    participant PaymentAPI as "결제(포인트 차감) API"
    participant UserDB as "사용자 테이블(DB)"
    participant SeatDB as "좌석 테이블(DB)"
    participant TentativeDB as "가예약 좌석 테이블(DB)"

    User->>PaymentAPI: 결제 요청 (사용자 ID, 공연 ID, 공연 날짜, 좌석 ID)
    PaymentAPI->>UserDB: 사용자 포인트 잔액 확인 (사용자 ID)
    alt 잔액 >= 좌석 가격
        PaymentAPI->>UserDB: 포인트 차감 (사용자 ID, 금액)
        PaymentAPI->>SeatDB: 좌석 상태 변경 (좌석 ID, 예약 완료)
        PaymentAPI->>TentativeDB: 가예약 해제 (좌석 ID)
        PaymentAPI-->>User: 예약 완료 응답
    else 잔액 < 좌석 가격
        PaymentAPI-->>User: 결제 실패 응답
    end

---

7. 포인트 충전 API

sequenceDiagram
    participant User as 사용자
    participant RechargeAPI as "포인트 충전 API"
    participant UserDB as "사용자 테이블(DB)"

    User->>RechargeAPI: 포인트 충전 요청 (사용자 ID, 충전 금액)
    RechargeAPI->>UserDB: 사용자 존재 여부 확인 (사용자 ID)
    alt 사용자 존재하는 경우
        RechargeAPI->>UserDB: 현재 포인트 조회 (사용자 ID)
        alt 현재 포인트 + 충전 금액 <= 1,000,000
            RechargeAPI->>UserDB: 포인트 업데이트 (사용자 ID, 충전 금액)
            UserDB-->>RechargeAPI: 업데이트 완료
            RechargeAPI-->>User: 충전 성공 응답 (현재 잔액)
        else 최대 한도 초과
            RechargeAPI-->>User: 충전 실패 응답 (현재 잔액 + 오류 메시지)
        end
    else 사용자 존재하지 않는 경우
        RechargeAPI-->>User: 충전 실패 응답 (오류 메시지)
    end

---

8. 포인트 잔액 조회 API

sequenceDiagram
    participant User as 사용자
    participant BalanceAPI as "포인트 잔액 조회 API"
    participant UserDB as "사용자 테이블(DB)"

    User->>BalanceAPI: 포인트 잔액 조회 요청 (사용자 ID)
    BalanceAPI->>UserDB: 사용자 존재 여부 확인 (사용자 ID)
    alt 사용자 존재하는 경우
        BalanceAPI->>UserDB: 포인트 잔액 조회 (사용자 ID)
        UserDB-->>BalanceAPI: 포인트 잔액 반환
        BalanceAPI-->>User: 포인트 잔액 응답
    else 사용자 존재하지 않는 경우
        BalanceAPI-->>User: 조회 실패 응답 (오류 메시지)
    end