출시 준비 점검
내부 또는 고객 공개 전 준비 상태를 확인합니다.
워크스페이스를 내부 팀, 고객 트래픽, 새 기능 공개에 열기 전에 이 페이지를 사용합니다.
준비 상태는 선택한 워크스페이스의 운영 진단입니다. 앱 작업 가이드는 해당 앱 작업만 확인합니다. 구독 결제, 소유권, 모더레이션, 커머스 결제 준비도는 여기서 확인하고 연결 구성은 공용 결제 설정에서 진행합니다. 출시 전 Console의 현재 결과와 이 페이지의 담당자를 검토합니다.
항목 상태와 전체 상태
항목은 ready, todo, blocked, attention, optional, unknown 상태와 required 또는 recommended 중요도를 사용합니다. unknown은 점검으로 준비 여부를 확인하지 못했다는 뜻이며 성공이 아닙니다. 전체 상태는 다음 순서로 정해집니다.
| 조건 | 전체 상태 |
|---|---|
필수 항목 중 ready나 optional이 아닌 것이 있음 | blocked |
| 그렇지 않고 미해결 항목이 있음 | attention |
| 그 밖의 경우 | ready |
결제에서는 플랜 출처가 구독일 때 past_due(연체), expired(만료), suspended(정지됨)가 항목 blocked를 만듭니다. canceled(해지)는 항목 attention입니다. 결제는 필수이므로 이 attention 항목도 전체 결과를 blocked로 만듭니다. 구독 상태·항목 상태·전체 상태를 구분합니다.
플랜에 막힌 선택, Secret Key 설정, 팀 소유권, 웹훅, 회차 판매 가능성은 권장 진단입니다. 권장 항목의 차단 요소는 필수 차단 수를 늘리지 않으면서 전체 결과를 attention으로 만들 수 있습니다. 출시 범위에 적용되는지 각각 검토합니다.
Secret Key는 권한 있는 서버 연동에 필요하며 모든 공개 읽기 앱에 필요한 것은 아닙니다. 웹훅 등록도 이를 사용하는 흐름에만 필요합니다.
선택한 워크스페이스의 진단은 설정 → 워크스페이스 → 운영 → 진단에서 엽니다. 네 역할 모두 준비 완료 전후에 설정과 Cmd+K 검색으로 찾을 수 있습니다. AI 도구 연결(MCP) 섹션의 세션 전환율과 도구 호출 → 쓰기 전환율은 super-admin에게 표시됩니다. 플랫폼 AI 도구 연결 집계와 감사 로그·웹훅 전송 내역 링크는 super-admin의 워크스페이스 목록 상단에서 확인합니다.
콘솔 진단 화면은 차단·주의·설정 필요 항목을 준비된 항목보다 먼저 보여 줍니다. 각 점검 항목은 준비도 목록에 한 번만 나옵니다. 워크스페이스 관리자와 슈퍼 관리자에게 연동 키 관리와 웹훅 전송 내역 바로가기가 표시됩니다. 선택 항목은 회색으로 표시합니다.
준비 상태 범주
| 범주 | 준비됨의 의미 | 중지해야 할 때 |
|---|---|---|
| workspace | 식별 정보, 소유자, 팀 접근이 명확함 | 관리자 소유자가 없거나 오래된 접근이 남아 있음 |
| features | 선택한 기능 중 하나 이상이 유효함 | 선택 기능이 플랜에 막혀 있음 |
| keys | Publishable Key, CORS, Secret Key 소유권이 명확함 | 브라우저 origin 또는 키 소유권이 빠져 있음 |
| billing | 플랜과 구독 상태를 사용할 수 있음 | 구독이 연체, 시스템에 의해 정지, 만료되었거나 상태가 불명확함 |
| content | 활성 영역에 최소 실제 콘텐츠가 있음 | 활성 영역이 비어 있거나 담당자가 없음 |
| webhooks | 전송 실패 위치를 담당자가 알고 있음 | 실패 소유권이 불명확함 |
| team | tenant-admin 멤버십에 운영 담당자가 있음 | 관리자가 없거나 한 명뿐이면 검토 필요 |
expired 구독은 종료된 상태로, 예를 들어 예약된 해지가 결제 기간 종료 시 적용되면 만료됩니다.
커머스 결제 연결
이커머스 기능이 활성화되면 필수 commerce.paymentConnection 항목이 관리형 연결과 활성화된 사용자 정의 결제사를 함께 확인합니다. 모든 활성 마켓에 선택 가능한 결제사가 있어야 합니다.
| 상황 | 항목 상태 | 다음 행동 |
|---|---|---|
| 저장된 비밀키를 현재 배포에서 읽을 수 없음 | blocked | 각 연결의 자격 증명을 교체한 뒤 구성 확인과 활성화를 진행합니다 |
| 신규 결제에 사용할 연결이 없음 | blocked | 연결을 구성 확인하고 활성화하거나 사용자 정의 결제사를 활성화합니다 |
| 일부 활성 마켓에 선택 가능한 결제사가 없거나 활성 마켓이 없음 | attention | 마켓 지정과 같은 결제사 및 마켓의 연결 중복을 확인합니다 |
| 조회 실패 | unknown | 다시 시도하고 결제 설정을 확인합니다 |
| 모든 활성 마켓에 선택 가능한 결제사가 있음 | ready | 출시 점검을 계속합니다 |
관리형 연결은 현재 자격 증명 버전과 구성에 대한 확인이 신규 결제에 유효해야 합니다. 사용자 정의 결제사는 활성화와 마켓 지정이 필요합니다. 마켓 없는 활성 연결은 공용 설정에서 사용할 수 있으며 커머스 준비도에서는 주의가 필요합니다. 관리형 결제사별로 한 마켓에 유효한 연결이 정확히 하나여야 선택할 수 있습니다.
관리형 연결은 선택한 워크스페이스의 결제 환경 정책에도 맞아야 합니다. PortOne은 사용할 수 있는 Hosted 또는 Standard V2 구성이 하나 이상 필요합니다. Standard V2는 리디렉션 출처가 워크스페이스의 현재 허용 출처에 있는지 확인합니다. Standard 리디렉션 출처를 지워도 유효한 Hosted 구성은 사용할 수 있습니다.
통화 지원은 고객 결제 시 확인합니다.
tenant-admin과 super-admin은 이 항목에서 결제 연결 목록을 엽니다. 필수 항목이므로 attention과 unknown도 전체 출시 준비도를 차단합니다.
기능별 셋업, 01 feature check ecommerce, MCP check-feature-progress도 필수 payment.connection 항목에서 연결 자격과 마켓 범위를 판정합니다.
| 결제 연결 판정 | 기능별 진행도 상태 |
|---|---|
| 신규 결제에 사용할 연결이 없음 | incomplete |
| 일부 활성 마켓을 결제할 수 없거나 활성 마켓이 없음 | attention |
| 조회 실패 | unknown |
| 모든 활성 마켓에 결제 연결이 있음 | complete |
앞의 세 상태에서는 기능별 진행도가 ready로 표시되지 않습니다. 근거에는 판정 상태만 담습니다. 워크스페이스 관리자에게 연결의 구성 확인과 활성화, 모든 활성 마켓의 결제사 할당을 요청하세요.
워크스페이스 진단의 복호화 검사는 저장된 상태를 바꾸지 않습니다. 연결 화면에서도 “조치 필요”를 표시하고 활성화 버튼을 비활성화합니다. 잠금이나 인프라 문제는 unknown으로 표시합니다. 기능 진행률 조회에서는 이 검사를 실행하지 않으므로, 연결 화면이나 워크스페이스 진단에서 저장된 비밀키를 복호화할 수 있는지 확인하세요.
기본 배송 정책
배송을 사용하는 워크스페이스에서는 활성 기본 배송 정책에 배송 요금 행이나 무료배송 조건을 설정합니다. 두 준비도 화면은 장바구니와 같은 배송 계산 기준을 사용하며, 활성 마켓 통화로 사용할 배송 요금 또는 무료배송 조건이 있어야 준비됨으로 표시합니다.
| 상황 | 항목 상태 | 다음 행동 |
|---|---|---|
| 활성 기본 정책에 사용 가능한 배송 요금이나 무료배송 조건이 있음 | ready | 실제 주문 금액과 배송지로 배송비를 확인합니다 |
| 기본 정책에 요금 없는 0원 설정만 있거나 요금 행이 모두 비활성임 | todo | 배송 요금 행이나 무료배송 조건을 추가합니다 |
| 활성 기본 정책이나 활성 마켓이 없음 | todo 또는 attention | 기본 정책을 지정하고 마켓을 활성화합니다 |
| 정책이나 마켓 조회 실패 | unknown | 다시 조회하고 배송 설정을 확인합니다 |
명시적인 0원 요금 행은 사용할 수 있습니다. 첫 장바구니 담기에서 사용할 배송 요금 행은 배송지 선택 전에도 적용되어야 합니다. 조건부 요금과 무료배송 기준은 설정된 주문 금액에서 확인하므로, 출시 전에 판매할 주문 금액과 배송지를 직접 점검합니다. 배송을 사용하지 않는 워크스페이스에서는 이 항목을 생략합니다.
출시 체크리스트
- 소유자와 관리자가 최신 상태입니다
- 유효 기능이 출시 범위와 일치합니다
- 필요한 콘텐츠 또는 커머스 기록이 있습니다
- 입장 유형이 구성되어 있으면 권장 회차 판매 가능 진단을 검토합니다
- CORS, 키, 웹훅 담당자가 정해졌습니다
- 결제 상태가 막고 있지 않습니다
- 지원과 모더레이션 책임이 배정되었습니다
중지 조건
필수 항목이 blocked 상태이거나, 플랜에 막힌 기능이 출시 약속에 포함되어 있거나, 고객 노출 실패를 소유한 사람이 없으면 출시를 멈춥니다.
준비 상태의 차단 요소는 출시 차단 요소로 취급하세요. 노출을 넓히기 전에 소유자, 기능, 키, 결제, 콘텐츠, 지원의 빈틈을 해결합니다.