01.software 문서

기능 계획

플랜과 운영 방식에 맞는 최소 기능 범위를 선택합니다.

기능 계획

기능을 켜거나 워크스페이스 플랜을 바꾸기 전에 이 페이지를 사용합니다. 첫 출시는 보통 가장 작은 유효 기능 범위가 가장 안전합니다.

기능 토큰과 유효 가용성

tenant-admin 또는 super-admin이 활성 워크스페이스의 기능 선택을 검토합니다. 기능 토큰은 번역된 메뉴 이름과 별개인 고정 기계 식별자입니다. 최소 플랜과 자동 의존성은 다음과 같습니다.

기능 토큰최소 플랜의존 기능
ecommercefree—
customersfree—
playlistsfree—
galleriesfree—
linksfree—
formsfree—
articlesfree—
documentsfree—
canvasfree—
videosstarter—
live-streamingenterprise—
communityfreecustomers
eventsfree—
membershipfreecustomers

선택한 기능 중 플랜이 허용하는 기능을 먼저 구한 뒤 필수 의존성을 추가합니다. 예를 들어 community나 membership을 선택하면 customers가 추가되며, ecommerce는 자동 추가되지 않습니다. 출시 전에 유효 기능, 자동 추가된 의존성, 플랜에 막힌 선택을 확인합니다. 기능 활성화가 역할 부여·콘텐츠 게시·고객 OAuth 클라이언트 등록을 대신하지 않습니다. 앱 구현은 도메인 작업 가이드를 사용하고, 이 페이지에서는 운영 범위와 가용성을 확인합니다.

플랜별 사용 가능 기능

플랜사용 가능 기능
Freeplaylists, galleries, links, forms, articles, documents, ecommerce, customers, community, events, membership, canvas
StarterFree 기능과 videos (동영상). 기존 구독만 유지되며 신규 가입이나 플랜 변경 대상으로는 선택할 수 없습니다
BasicFree 기능과 videos (동영상)
ProBasic 기능 범위와 더 높은 쿼터
Enterpriselive-streaming을 포함한 모든 tenant 기능

커머스·이벤트 일반 이메일은 KST 월간 공통 풀을 사용합니다: Free100 / Starter1,000 / Basic1,000 / Pro3,000건. Enterprise는 무제한입니다. 고객 OTP·비밀번호 재설정·행사 취소는 관측되지만 일반 한도·고객 과금에서 제외합니다. Sandbox는 세대별 월 공통100회이며 필수 메일도 포함하고 외부 발송·청구는 없습니다. 동영상은 Starter·Basic·Pro에서, 라이브 스트리밍은 Enterprise에서 사용할 수 있습니다.

갤러리 아이템은 기본적으로 이미지를 사용합니다. 피드형 콘텐츠나 포트폴리오에서는 아이템마다 영상 하나를 연결해 같은 갤러리 순서로 배치할 수 있습니다. 영상 아이템은 워크스페이스의 현재 플랜에서 동영상 기능을 사용할 수 있고 해당 기능이 켜져 있어야 하며, 기존 영상 업로드·처리·재생 흐름을 사용합니다. 이미지 갤러리는 Free에서도 사용할 수 있습니다.

유료 플랜 포함량

신규로 선택할 수 있는 유료 플랜은 Basic과 Pro이며, Pro보다 큰 규모는 Enterprise로 문의합니다. 가격은 VAT 포함이고 연간 결제는 월간 10개월분입니다.

항목BasicPro
월간 / 연간 가격20,000원 / 200,000원60,000원 / 600,000원
API 호출 / 월500,0002,000,000
스토리지100GiB100GiB
문서100,000100,000
운영 멤버5050
웹훅 등록1010
일반 이메일 공통 / 월1,0003,000
  • 연간 결제도 API 호출과 일반 이메일은 월 제공량입니다. 둘 다 KST 달력 월 1일에 초기화되며, 카드 결제일(구독 기간)과는 별개입니다.
  • 스토리지·문서·웹훅은 보유량이며 매월 초기화되지 않습니다. 100GiB는 107,374,182,400바이트입니다.
  • API 호출은 X-Publishable-Key를 보낸 /api 요청을 셉니다. 키가 없는 요청과 CORS preflight(OPTIONS)는 세지 않고, 처리 중 오류가 난 요청은 셉니다. 한도를 넘은 다음 요청부터 429 usage_limit_exceeded가 반환됩니다. Live에서 사용량 저장소에 일시적으로 접근할 수 없으면 요청을 허용하고, Sandbox에서는 거절합니다. 따라서 API 한도는 비용 상한을 보장하지 않습니다.

API 계량 저장이 불명확해도 tenant-only·Live API는 유지됩니다. 완전성 근거가 없으므로 정상처럼 보이는 월을 포함해 Enterprise 월별 사용량의 최초 청구서 발행은 보류합니다. 기존 청구서의 후속 처리와 정액 구독 결제는 유지하며 추정 수량으로 청구하지 않습니다.

  • 스토리지는 한도의 100%에서 경고하고, 기본 2배 안전 상한에 도달하면 용량을 늘리는 업로드를 막습니다. 기존 파일 읽기·삭제는 유지됩니다.
  • 사용량이 낮은 플랜의 한도를 넘어도 자동 삭제, 자동 추가 청구, 자동 업그레이드는 없습니다. 한도를 넘는 동안 해당 항목의 새 생성·발송·업로드가 제한될 수 있습니다.
  • 웹훅 등록 10개는 무제한 전송이나 재시도를 뜻하지 않습니다.

기능 결정

필요먼저 시작할 기능나중에 추가할 조건
소식이나 가이드 게시articles 또는 documents편집자가 분류나 승인 책임을 가져야 할 때
요청 수집forms제출 내용을 확인할 팀이 배정되었을 때
상품 판매ecommerce카탈로그, 주문 처리 방식, 결제, 반품 정책, 옵션 프리셋, 지원 담당자가 준비되었을 때
고객 계정 관리customers인증과 복구 정책을 지원팀이 소유할 때
커뮤니티 공간 운영customers와 community모더레이션 책임이 준비되었을 때
이벤트 운영events이벤트 담당자, 캘린더 소유자, 일정 업데이트 담당자가 정해졌을 때

의존 관계

  • Community는 고객 계정에 의존합니다.
  • Membership은 고객 계정을 필요로 합니다. 상품과 주문도 사용하려면 ecommerce를 별도로 선택하세요.
  • 진행 중이거나 설정이 끝나지 않은 멤버십 또는 미해결 청구가 있으면 Membership을 끌 수 없습니다. 다른 변경으로 기능이 비활성화되면 갱신 청구가 멈추고 기존 멤버십은 결제된 기간이 끝날 때 종료됩니다. 고객은 계속 조회·해지할 수 있으며, 기능을 다시 켜도 중지된 갱신은 자동 재개되지 않습니다.
  • 기존 유료 회원은 갱신 결과가 확정되기 전까지 결제 기간 종료 후 최대 2시간 그룹 혜택을 유지합니다. 갱신 거절, 해지, 결제 수단 revoke, 환불이 확정되면 즉시 종료됩니다. past_due에는 이 추가 시간이 적용되지 않으며, 결제 기간 안의 기존 혜택 규칙은 유지됩니다. 이미 확정된 Checkout·Order 가격은 바뀌지 않습니다.
  • 플랜에 막힌 기능 의도는 저장될 수 있지만, 플랜이 허용하기 전까지는 유효하지 않습니다.
  • 사용하지 않는 기능을 꺼두면 내비게이션과 준비 상태 점검이 선명해집니다.

의도는 보존하되, 출시는 가장 작은 유효 기능 범위로 시작하세요. 담당자, 콘텐츠, 지원, 준비 상태 점검이 생긴 뒤 기능을 추가합니다.

Console 메뉴 이름

Console에서 tenant-admin 또는 super-admin은 설정 → 메뉴 표시명에서 활성 워크스페이스의 메뉴 이름을 바꿀 수 있습니다. 같은 이름이 컬렉션 화면의 제목, 경로 안내, Cmd+K에도 표시됩니다. 메뉴 이름 변경은 필드명, 콘텐츠 문서 제목, URL, 메뉴 순서, 권한에 영향을 주지 않습니다. 커머스 설정과 브랜딩 · SEO · 사업자정보 설정 화면은 메뉴 이름을 문서 제목에도 사용하며 설정으로 돌아가는 링크를 제공합니다.

각 메뉴마다 모든 Console UI 언어에서 사용할 이름을 최대 40자의 한 줄로 입력합니다. 빈 값으로 저장하거나 기본 이름으로 복원하면 선택한 UI 언어의 기본 이름이 표시됩니다. 저장된 이름은 다른 워크스페이스 운영자에게도 적용됩니다.

공용 결제 설정

이커머스를 켜지 않아도 설정 → 결제 설정에서 결제 제공자 연결을 관리할 수 있습니다. tenant-admin은 명시적으로 선택한 워크스페이스에서 제공자 설정과 자격 증명을 관리합니다. 저장한 비밀 값은 다시 표시되지 않습니다. 마켓 연결은 선택 사항이며, 마켓이 없는 계정은 커머스 체크아웃에서 선택되지 않습니다. 토스 설정 확인과 활성화는 이커머스 없이 가능합니다. PortOne 활성화에는 기존에 검증된 웹훅 라우트가 필요합니다. 라우트 조회와 tenant-admin의 발급·확인·폐기는 이커머스 없이 가능하며, 기존 워크스페이스 권한과 명시적 활성 워크스페이스 조건은 유지됩니다. 커머스 연결 전환에는 여전히 이커머스가 필요합니다. 이 변경은 공개 Events 결제 API를 활성화하지 않습니다.

다음 액션

고객 계정은 회원가입 또는 권한이 있는 서버 연동을 통해 생성할 수 있습니다. 운영자는 관계 필드를 포함한 Admin Panel에서 고객을 직접 생성할 수 없습니다. 기존 계정은 고객 목록에서 확인하세요.

로컬 비밀번호가 있는 고객은 재인증 후 셀프 탈퇴할 수 있습니다. 멤버십 제한과 기록 보존은 고객 셀프 탈퇴를 확인하세요.

멤버십 관리자는 결제되었지만 가입 상태에 반영되지 않은 결과를 Console의 멤버십 → 미반영 멤버십 결제 증거 목록 또는 연결된 멤버십·결제 상세 화면에서 확인할 수 있습니다. 보존된 행에는 결제 내역, 결과 경로(dispatch, webhook 또는 queryCharge), 미반영 사유가 표시됩니다. 환불은 워크스페이스가 처리합니다.

워크스페이스 관리자는 단일 내장 앱의 실행 허용 역할을 설정할 수 있습니다. editor/viewer는 허용된 실행 화면만 보며 수신자 서버도 역할을 허용하고 기능별 권한을 검증해야 합니다. Embedded Admin을 참고하세요.

Ecommerce에는 워크스페이스가 정의한 1회용 고객 혜택권도 포함됩니다. 워크스페이스 서버가 발급·사용 처리·무효화하고, 고객은 본인 목록을 조회합니다. 콘솔 고객 상세에서 tenant-admin·tenant-editor는 사용 가능한 혜택권을 사용 처리하고, tenant-admin은 무효화할 수 있습니다.

목차