라이선스 (게이팅)
TFlow의 라이선스는 회사(조직)가 구매해 조직원 개개인에게 나눠 주는 이용권입니다. 라이선스가 없어도 화면을 열람할 수는 있지만, 편집·생성·승인·삭제 같은 변경 동작에는 라이선스가 필요합니다.
💡 누가 쓰나요? 팀원에게 유료 기능 사용 권한을 나눠 줘야 하는 회사의 Master(최고 관리자), 그리고 "왜 저장/승인 버튼을 누르면 라이선스가 필요하다고 뜨지?"가 궁금한 일반 조직원. 라이선스 개수 자체를 사고파는 것은 구독 · 결제 · 토큰에서, 그 라이선스를 사람에게 배정하는 것은 이 문서에서 다룹니다.
ℹ️ 가시성 조건 — 라이선스 게이팅은 운영 설정
LICENSE_GATING_ENABLED(클라이언트VITE_LICENSE_GATING_ENABLED)로 켜고 끄며, 기본값은 OFF입니다. 꺼져 있는 환경에서는 라이선스 없이도 기능을 그대로 쓸 수 있고, 아래에서 설명하는 차단 모달도 나타나지 않습니다.
1. 개념 — 조직이 사서 사람에게 배정
- 구매 단위: 라이선스는 회사(조직) 단위로 구매합니다. → 구독 · 결제 · 토큰
- 배정 주체: 회사의 Master 가 조직원 한 명 한 명에게 라이선스를 켜 줍니다.
- 미보유자: 라이선스가 배정되지 않은 조직원은 열람은 가능하지만, 변경 동작을 시도하면 차단됩니다.
ℹ️ 즉 "라이선스를 산다"와 "라이선스를 배정한다"는 별개입니다. 회사가 라이선스 5개를 샀어도, Master가 배정하지 않은 사람은 아직 변경 권한이 없습니다.
ℹ️ 신규 가입 시 기본 상태 — 새로 가입한 계정에는 라이선스가 자동으로 주어지지 않습니다(열람 위주). 무료 체험을 시작하거나 구독을 결제해 라이선스를 확보하세요. 구독을 결제한 본인과 체험을 시작한 본인에게는 1좌석이 자동 배정되므로, 결제·체험 직후 별도 배정 없이 바로 편집 기능을 쓸 수 있습니다.
2. 라이선스가 필요한 기능
변경 동작에 라이선스가 필요한 대표 기능은 다음과 같습니다.
| 영역 | 라이선스가 필요한 동작(예) |
|---|---|
| 문서 | 문서 뷰어·목록에서 편집, AI 분석 실행(분석 드롭다운) |
| 캘린더 / 일정 | 일정 생성·수정 |
| 태스크 | 태스크 생성·상태 변경 |
| QT 견적 | 견적 편집·승인·Accept 등 모든 액션 → QT 핸드셰이크 |
| AI 분석 | IRR·LEO 등 분석 요청 |
| AI 챗봇(Lyra) | 변경을 일으키는 챗봇 동작 |
| 스토어 셀러 영업 | 수신 RFQ의 바이어 정보(회사명·담당자·연락처) 확인, 상태 변경·담당자 배정, 견적 작성·발송, 문의(1:1 채팅) 열람·답장, 챗봇 상담 기록 열람 → 판매자 가이드 |
| 매일 지급되는 AI 토큰 ✨ | 일일 기본 토큰은 라이선스 보유자에게만 지급됩니다 → 구독 · 결제 · 토큰 |
2-1. 어디까지 확인하나 — 읽기는 자유, 변경은 라이선스
ℹ️ 서버가 프로젝트·문서·캘린더·태스크·카테고리·PO·이메일·운송·통관·채팅·친구·문의·부서 등 폭넓은 영역에서 변경 요청에 라이선스를 확인합니다. 읽기(조회)는 대부분 자유롭고, 무언가를 바꾸는 순간 라이선스가 필요하다고 이해하면 됩니다.
2-2. 스토어프론트 예외
ℹ️ 스토어프론트는 예외적으로 열려 있습니다 — 상점 개설·상품 등록·공개(퍼블리시) 같은 스토어 운영과 구매자의 RFQ 제출·카트 담기·문의(1:1 채팅) 제출은 라이선스 없이 가능합니다. 스토어의 유료 지점은 셀러의 영업 대응입니다: 받은 RFQ의 바이어 정보 확인·견적 응대, 문의 열람·답장, 챗봇 상담 기록 열람. 라이선스가 없으면 RFQ 목록·상세에서 바이어 정보가 🔒 마스킹된 채 표시되고, 문의함·상담 기록은 잠금 화면으로, 견적 작성 등 응대 액션은 구독 안내로 이어집니다.
3. 라이선스가 없을 때 — 통일 안내 모달
라이선스 없이 변경 동작을 하면 화면 가운데에 통일된 안내 모달이 뜹니다(서버가 변경 요청을 403으로 막거나, 클라이언트가 미리 막는 경우 모두 같은 모달).
| 상황 | 안내 |
|---|---|
| 개인 미보유(license.required) | "라이선스가 필요합니다" — 회사 Master에게 라이선스 배정을 요청 |
| 회사 초과 배정(license.overCapacity) | 회사가 보유한 라이선스보다 많이 배정된 상태 — 별도 안내 문구 표시 |
🖼️ 화면 캡처 라이선스 필요 통일 모달 — "라이선스가 필요합니다" 안내 + 조직 관리로 가는 안내 📍
tflowx.com· 저장 위치images/common/license-required-modal.png
4. 조직 라이선스 배정 (조직 관리 > 라이선스 탭)
진입: 우상단 프로필 메뉴 → 조직 관리(tflowx.com/my/organization) → 라이선스 탭
라이선스를 조직원에게 켜고 끄는 화면입니다.
- 구독이 없으면: "구독 없음" 과 함께 구독하러 가기 가 표시됩니다.
- 조직원 카드 목록: 조직원마다 카드가 있고, 각 카드의 라이선스 아이콘 토글로 배정/해제합니다. 편집은 Master만 할 수 있고, 라이선스를 보유한 조직원 카드는 배경이 강조됩니다.
- 수용 한도: 배정 가능한 총 인원 = 보유 라이선스 수 × 라이선스당 사용자 수. 한도를 넘겨 배정하려 하면 초과 배정 경고 토스트가 뜹니다.
- KPI 요약 바: 조직 관리 상단에 보유 / 배정 / 수용 인원이 요약 표시됩니다.
🖼️ 화면 캡처 조직 관리 > 라이선스 탭 — 조직원 카드 + 라이선스 토글 + 상단 KPI 요약 바(보유/배정/수용) 📍
tflowx.com/my/organization· 저장 위치images/common/org-license-tab.png
5. 라이선스 수량을 줄일 때 — 축소 안내 모달
이미 배정된 인원보다 라이선스 수를 더 적게 줄이려 하면, 서버가 이를 막고(409) 2버튼 모달을 띄웁니다.
- 라이선스 사용자 변경하기 → 조직 관리 > 라이선스 탭으로 이동해 배정을 먼저 정리
- 확인 → 모달 닫기
즉, "먼저 사람에게서 라이선스를 회수한 뒤 → 수량을 줄인다"는 순서를 지켜야 합니다.
🖼️ 화면 캡처 라이선스 감소 2버튼 모달 — 라이선스 사용자 변경하기 / 확인 📍
tflowx.com/my/subscription· 저장 위치images/common/license-reduce-modal.png
ℹ️ 라이선스 수량을 줄일 때의 환불/예약 감액 규칙은 구독 · 결제 · 토큰 — 환불 정책을 참고하세요.
💡 문제 해결 (FAQ)
Q. 조회는 되는데 저장·승인 버튼을 누르면 "라이선스가 필요합니다"가 떠요. A. 라이선스가 아직 배정되지 않은 계정입니다. 회사 Master 에게 조직 관리 > 라이선스 탭에서 라이선스를 켜 달라고 요청하세요.
Q. 라이선스를 켰는데 "초과 배정" 경고가 떠요. A. 배정하려는 인원이 보유 라이선스 × 라이선스당 사용자 수(수용 한도)를 넘었습니다. 라이선스를 더 구매하거나, 다른 조직원의 배정을 해제해 자리를 비워야 합니다.
Q. 라이선스 수량을 줄이려는데 모달이 뜨면서 막혀요. A. 현재 배정된 인원보다 적게 줄일 수 없습니다. 모달의 라이선스 사용자 변경하기 로 이동해 배정을 먼저 회수한 뒤 수량을 줄여 주세요.
Q. 우리 환경에서는 라이선스 제한이 전혀 없어요.
A. 라이선스 게이팅이 꺼진 환경(LICENSE_GATING_ENABLED OFF, 기본값)일 수 있습니다.가시성 조건 이때는 라이선스 배정과 무관하게 기능을 사용할 수 있습니다.
Q. 라이선스 개수 자체는 어디서 사나요? A. 라이선스 구매·수량 변경은 구독 · 결제 · 토큰에서, 산 라이선스를 사람에게 배정하는 것은 이 문서의 조직 관리 > 라이선스 탭에서 합니다.