01.software 문서

워크스페이스 설정

소유자, 팀 접근, 결제 상태, 운영 책임을 정리합니다.

워크스페이스 설정

워크스페이스를 새로 만들거나, 소유권을 넘겨받거나, 팀에 운영을 인계할 때 이 페이지를 사용합니다.

이 페이지는 Console과 Admin Panel을 사용하는 운영자를 위한 워크스페이스 관리 입구입니다. 앱 구현은 빠른 시작과 도메인 작업 가이드에서 시작합니다. P0 작업 가이드 완료는 해당 앱 작업의 확인이며, 출시에는 출시 준비 점검의 운영 확인도 필요합니다.

변경 전에 Console의 활성 워크스페이스를 확인합니다. 한 워크스페이스의 역할로 다른 워크스페이스에 접근할 수 없으며, 워크스페이스 이름·쿠키·헤더가 멤버십을 부여하지 않습니다.

설정 단계

워크스페이스 식별 정보 확인

명확한 워크스페이스 이름을 사용하고, 소유자를 확인하며, 이후 관리자가 이해할 수 있도록 목적을 짧게 남깁니다.

관리자 접근 배정

초기 tenant-admin 사용자를 추가하고, 임시 접근을 제거하며, 출시 전에는 신뢰할 수 있는 관리자를 최소 두 명 둡니다.

결제 상태 확인

고객 대상 작업을 시작하기 전에 활성 플랜과 주의가 필요한 구독 상태가 있는지 확인합니다.

사용량 기반 요금에서는 최종 청구 예정 금액이 1–99원인 경우 해당 금액을 면제하여 0원으로 안내합니다. 산출 내역은 청구서에 보존되며, 이미 안내된 청구서는 자동으로 변경하지 않습니다.

Enterprise 사용량 요금의 등록, 계산, 청구서 확인은 아래 Enterprise 사용량 요금을 참고합니다.

운영 담당자 기록

팀이 일상 운영을 시작하기 전에 콘텐츠, 커머스, 지원, 모더레이션, 결제, 연동 담당자를 지정합니다.

브랜딩

Console의 설정 → 사이트 & 브랜딩 → 브랜딩 · SEO · 사업자정보에서 로고와 사업자정보를 입력합니다. 입력한 값은 다음 위치에 쓰입니다.

위치사용하는 값
Console 사이드바 상단로고(없으면 로고마크), 다크 모드 로고
고객 알림 메일(주문·배송·반품·이벤트)로고, 상호, 입력된 사업자정보. 발신자 표시 이름을 비워 두면 워크스페이스 이름으로 보냅니다.
고객 로그인 코드·비밀번호 재설정 메일로고, 상호
고객 로그인 화면(호스티드 로그인)OAuth 클라이언트의 로고 URL. 비어 있으면 워크스페이스 로고와 다크 모드 로고

상호는 사업자정보의 상호, 사이트 제목, 워크스페이스 이름 순서로 정해집니다. 메일에는 SVG 로고가 표시되지 않으며, 고객 로그인 화면은 01 SOFTWARE 미디어 CDN에 있는 로고만 표시합니다.

Console 로그인·비밀번호 재설정·MFA처럼 워크스페이스를 고르기 전의 운영자 화면은 01 SOFTWARE로 표시됩니다. 고객 로그인 화면은 고객의 언어 설정에 따라 한국어 또는 영어로 표시됩니다.

Enterprise 사용량 요금

Enterprise는 셀프서비스 요금제가 아니라 워크스페이스별 계약 요금표로 계산하는 사용량 기반 요금입니다. 시작하려면 software@01.works로 영업팀에 문의합니다.

계약 조건 확인과 카드 등록

  1. 영업팀이 워크스페이스의 요금표를 활성화한 뒤 01.software 구독 화면으로 연결되는 계약 조건 확인 링크를 전달합니다.
  2. 해당 워크스페이스의 tenant-admin으로 로그인해 링크를 엽니다. 화면에 계약 요금표 이름, 기본료, 월 최저 청구액, 적용 기간, 카드 등록 시 결제액, 청구 사전 안내 기간, 미터별 단가·버킷·포함량이 표시됩니다.
  3. 조건을 확인한 뒤 카드를 등록합니다. 카드 등록 시 결제액은 0원이며, 등록만으로는 청구되지 않습니다.

조건을 확인할 수 없다는 안내가 나오면 링크가 최신인지 영업팀에 확인합니다. 등록 중 조건이 바뀌면 등록이 진행되지 않고 최신 조건이 다시 표시되므로, 다시 확인한 뒤 등록합니다. 적용 기간은 계약 요금표에 기록된 날짜를 보여 주며, 기간에 따른 가격 전환이나 가격 유지는 계약 내용을 따릅니다.

요금 계산 방식

청구 금액은 한국 표준시(KST) 달력월 단위로 계산합니다.

항목의미
기본료매월 청구되는 고정 금액
월 최저 청구액기본료와 종량 초과분의 합이 이 금액보다 적으면 차액을 최저 청구 조정으로 더함
버킷사용량을 세는 묶음 크기. 사용량을 버킷 크기로 나눈 뒤 올림
포함량추가 요금 없이 포함되는 버킷 수. 원시 사용량이 아님
단가포함량을 넘는 버킷 1개당 금액(원)
미터별 청구 단위    = max(0, ceil(사용량 ÷ 버킷 크기) − 포함량)
미터별 금액        = 청구 단위 × 단가
소계              = 기본료 + 미터별 금액의 합
조정·면제 전 금액   = max(소계, 월 최저 청구액)

서비스가 월 중간에 시작되거나 끝나면 기본료와 월 최저 청구액을 일할합니다. 이용 일수는 그 달 안에서 이용 시작부터 종료까지의 시간을 24시간 단위로 올림한 값이며, 이용한 달력 날짜 수가 아닙니다. 각 금액에 이용 일수 ÷ 그 달 일수를 곱하고 1원 미만은 올립니다.

확정 청구서 합계는 조정·면제 전 금액에 사전 안내 전에 기록된 조정을 더하고(0원 미만이면 0원), 그 결과가 1–99원이면 위 결제 상태 확인 단계의 면제를 적용한 값입니다. 자세한 내용은 예상액과 확정 청구서 확인을 참고합니다.

다음 값은 계산 방식을 보여 주는 가상의 예이며, 실제 계약 단가나 기본값이 아닙니다. 사용량 25,001, 버킷 10,000, 포함량 1버킷, 버킷당 100원이면 ceil(25,001 ÷ 10,000) = 3버킷에서 포함량 1버킷을 빼 청구 단위는 2, 미터 금액은 200원입니다. 포함량 1은 사용량 1이 아니라 10,000 단위 버킷 1개입니다.

요금표에는 다음 여섯 미터가 있으며, 마감된 달의 사용량 스냅샷 값을 사용합니다.

화면 이름사용량
API 호출API 호출 수
AI 생성AI 생성 수
동영상 전송 시간동영상 전송 시간(분)
스토리지 GB (마지막 성공 표본)마지막 성공 표본의 저장 용량을 GB(10억 바이트)로 환산한 값
알림알림 이메일 수
문서 수 (마지막 성공 표본)마지막 성공 표본의 문서 수

스토리지와 문서는 해당 월이 진행 중일 때 마지막으로 성공한 사용량 표본의 값입니다. 월중 사용량이 줄면 다음 성공 표본에도 감소가 반영되며, 표본 갱신이 실패하면 이전 성공 표본을 유지합니다. 월평균, 최대값, 이용 기간에 걸쳐 누적한 값이 아닙니다. 실제 청구 수량은 확정 청구서의 미터별 내역으로 확인합니다.

예상액과 확정 청구서 확인

tenant-admin은 01.software 대시보드에서 워크스페이스를 열고 결제 탭에서 다음을 확인합니다.

  • 이번 달 사용량 예상액: 진행 중인 달에 지금까지 기록된 사용량과 활성 요금표로 계산한 확정 전 금액입니다. 확정 청구서 금액과 다를 수 있습니다.
  • 사용량 청구서: 마감된 달의 확정 청구서입니다. 상태(확정, 청구완료, 실패), 합계, 기본료, 종량 초과분, 최저 청구 조정, 사전통지일, 청구일, 미터별 내역(사용량, 버킷, 포함, 청구 단위 × 단가 = 금액)이 표시됩니다.

확정 청구서의 합계에는 1–99원 면제나 사전 안내 전에 기록된 조정이 반영될 수 있어 기본료, 종량 초과분, 최저 청구 조정의 합과 다를 수 있습니다. 확정된 청구서는 이후 요금표 변경이나 사용량 재집계로 바뀌지 않습니다.

정산과 결제 시점

  • 한 달의 사용량은 다음 달 5일(KST)까지의 정산 기간이 지난 뒤 정기 처리에서 확정 청구서로 만들어집니다. 청구서 생성일은 고정되어 있지 않습니다.
  • 청구서가 확정되면 워크스페이스 tenant-admin에게 확정 금액을 이메일로 안내합니다. 한 명 이상에게 발송되면 사전통지일이 기록되며, 모든 수신자에게 도착한다고 보장하지 않으므로 결제 탭에서 사전통지일을 확인합니다.
  • 결제는 사전통지일로부터 최소 7일이 지난 뒤 정기 처리에서 시도합니다. 정확한 결제일은 고정되어 있지 않으며, 결제된 날짜는 청구일로 확인합니다. 0원 청구서는 카드 결제 없이 청구완료로 처리됩니다.
  • 결제가 거절되면 청구서가 실패로 표시됩니다. 결제 탭에서 상태를 확인하고 software@01.works로 문의합니다.

청구 문의와 환불

청구 금액이나 환불 문의는 software@01.works로 보냅니다. 환불 접수 절차는 환불 규정을 따릅니다. 이 문서는 사용량 청구서의 환불 가능 조건, 처리 기한, 셀프서비스 환불 화면을 별도로 약속하지 않습니다.

청구 오류 정정은 플랫폼 super-admin이 Admin Panel에서 검토·승인합니다. 워크스페이스 관리자에게 별도 실행 권한이나 셀프서비스 환불 화면을 제공하지 않습니다. 결제사 결과가 불명확하면 재전송하지 않고 확인 필요 상태로 보존합니다. 정정해도 원 청구서와 구독·서비스 권한은 유지되며, 신규 Enterprise 청구를 재개하지 않습니다.

운영 리듬

  • 매주 tenant-admin이 접근 권한, 콘텐츠 대기열, 실패한 웹훅, 준비 상태 blocker를 검토합니다.
  • 매월 workspace owner가 플랜, 결제, 쿼터, 키, 사용하지 않는 기능을 검토합니다.
  • 이슈 발생 시 workspace owner가 결제, 키, CORS, 커머스, 모더레이션이 막히면 출시 또는 고객 노출을 중지합니다.

접근 역할

운영자의 정확한 역할은 다음과 같습니다. super-admin은 플랫폼 역할이며 나머지 세 역할은 워크스페이스별로 배정합니다. 고객 계정과 운영자 계정은 별개입니다.

역할책임경계
super-admin플랫폼 관리와 지원전역 권한. 워크스페이스 작업에서는 대상 워크스페이스를 선택
tenant-admin워크스페이스 설정, 기능, 키, 결제, 팀 접근 관리해당 역할을 배정받은 워크스페이스에 한함
tenant-editor허용된 콘텐츠·커머스 작업컬렉션별 쓰기 권한. 워크스페이스 설정·키·결제·멤버십 관리는 불가
tenant-viewer허용된 검토와 리포트 확인읽기 전용. 운영 변경 불가

workspace owner는 소유권 관계이며 다섯 번째 역할이 아닙니다. 소유권은 이전·삭제를 제어하며, 일반 관리 작업은 운영자의 워크스페이스 역할을 확인합니다. 개인별 로그인 계정을 사용하고 워크스페이스마다 접근 권한을 검토합니다.

인계 체크리스트

  • workspace owner가 최신 상태입니다
  • 신뢰할 수 있는 관리자가 최소 두 명 있습니다
  • 임시 접근이 제거되었습니다
  • 결제 상태가 명확합니다
  • 활성화한 기능별 담당자가 정해졌습니다
  • 출시 지원과 모더레이션 담당자가 정해졌습니다

접근 권한, CORS, 운영 담당자를 확인하기 전에는 Secret Key 소유권을 개인이나 외부 업체에 넘기지 마세요.

다음 액션

목차