MCP 이용 신청 화면 — 신청 가능 여부 사전 체크

사전예약 기간 중 MTS 「MCP 이용 신청」 화면 요구사항

1. 요구사항 요약

MCP 서비스는 홈페이지에서 사전예약(성함·휴대전화번호)을 받고 있다. 사전예약 기간 동안 MTS 이용신청 화면은 사전예약한 고객만 신청할 수 있어야 하며, 신청 가능 여부를 「신청하기」를 누르기 전(화면 진입 시점)에 체크해서 안내한다.

2. 화면 동작

1. 화면 진입 시(계좌 선택·비밀번호 확인 완료) 신청 가능 여부를 조회한다. 계좌를 변경하면 재조회한다.
2. 신청 불가이면 안내 팝업 "현재 신청 가능한 서비스가 아닙니다."를 표시하고 「신청하기」 버튼을 비활성화한다. 비활성 버튼 터치 시 팝업을 다시 표시한다.
3. 신청 가능이면 기존 플로우 그대로 진행한다(약관 동의 → 신청하기).
4. 「신청하기」 처리 시 서버가 동일 체크를 한 번 더 수행한다(진입 후 상태가 바뀐 경우 방어).

3. 판정 기준

• 사전예약 매칭 — 고객의 원장 등록 휴대전화번호와 사전예약 DB의 접수 번호를 대조한다. 접수분은 하이픈 포함 형식이므로 양쪽 모두 숫자만 남겨 비교한다.
• 기간 판정 — 사전예약 기간 여부는 서버 설정값으로 관리한다(앱 배포 없이 정식 오픈 전환 가능해야 함).
• 이미 신청(등록) 상태인 계좌는 기존과 동일하게 처리한다(본 건 범위 아님).

4. 조회 API

화면 진입 시 호출하는 조회 API 1건. 기존 「신청여부 조회」 API가 있으면 응답에 availableYn을 추가하는 방식도 가능.

5. 흐름 도식

sequenceDiagram
    autonumber
    actor U as 고객
    participant M as MTS 이용신청 화면
    participant S as 서버

    U->>M: 화면 진입 (계좌 선택)
    M->>S: 신청 가능 여부 조회 API
    S->>S: 사전예약 기간? → 예약 내역 매칭
(휴대폰번호 대조)
    S-->>M: availableYn (Y/N)
    alt N — 신청 불가
        M-->>U: "현재 신청 가능한 서비스가 아닙니다"
팝업 + 신청하기 비활성
    else Y — 신청 가능
        U->>M: 약관 동의 → 신청하기
        M->>S: 이용 신청 API (신청 시 동일 체크 재수행)
        S-->>M: 완료 (신청여부 = 등록)
    end

화면 진입 시 1회 조회로 판정하고, 신청 확정 시 서버가 같은 체크를 재수행한다.