Marketplace Install Flow
사용자가 필요한 도구를 발견하고 작업공간에 추가할 때 권한, 사용권, capability, 실행 조건이 명확한지 검수한다.
핵심 결론
설치는 구매나 실행과 같지 않다.
Marketplace Install Flow는 도구를 작업공간에 추가하는 흐름이며, 결제/환불/정산은 후속 BM/License 기준으로 분리한다.
마켓 설치 다이어그램
탐색
사용자는 Marketplace에서 앱을 찾는다
검색·카테고리·추천·링크로 노출된 앱을 찾는다.
상세
설치 전에 신뢰 정보를 확인한다
일반·인증 등록 여부, 경고, 필요한 기능과 권한을 본다.
가격
무료인지 유료인지로 보유 방식이 갈린다
무료는 가격 0원의 보유 상태를 만들고, 유료는 결제 흐름으로 넘어간다.
보유
사용권은 개인 계정에 연결된다
무료는 가격 0원의 보유 상태, 유료는 구매로 개인 사용권을 얻는다. 보유는 설치와 별개다.
설치
작업공간에 앱을 배치한다
특정 작업공간에서 보이게 둔다. 설치는 소유권이나 사용권을 대신하지 않는다.
결제
유료 앱은 결제로 사용권을 발급한다
결제가 끝나면 개인 계정에 사용권이 연결된다.
대기
결제·권한이 없으면 설치를 보류한다
결제 미완, 사용권 없음, 설치 권한 부족이면 설치를 멈추고 이유를 알린다.
다음
설치가 끝나면 실행 요청으로 넘어간다
앱을 열 수 있게 되지만, 열리는 순간의 최종 판정은 App Runtime Flow에서 처리한다.
이 다이어그램은 앱을 들여오는 구간만 다룬다. 설치된 앱이 실제로 열릴 수 있는지는 App Runtime Flow에서 사용권, 역할, 조작 주체(Operator), 기능 허용 범위를 다시 확인한다.
흐름
| 단계 | 사용자 체감 | 검수 질문 |
|---|---|---|
| 발견 | 작업공간에 필요한 도구를 찾는다 | 왜 필요한지 프로젝트 맥락에 연결되는가 |
| 조건 확인 | 권한, capability, 사용권 조건을 본다 | 설치 전 위험과 제한이 보이는가 |
| 설치 | 도구를 작업공간에 추가한다 | 누가 사용할 수 있는지 보이는가 |
| 사용 가능 판정 | 실행 조건을 확인한다 | 설치됨과 실행 가능함이 분리되는가 |
| 차단/회수 | 만료, 권한 부족, 위험으로 막힌다 | 원인과 해결 경로가 보이는가 |
검수 규칙
- 설치 전 capability와 권한을 숨기지 않는다.
- 설치 후 실행 불가 상태가 오류처럼 보이면 안 된다.
- 구매/환불/정산은 설치 흐름의 중심이 아니라 License/BM 후속 기준이다.