클라우드 관리자 라이선스 운영

권한을 가진 HandyCafe 플랫폼 관리자는 고객 상세 페이지에서 해당 고객의 상용 서비스 접근 권한을 관리할 수 있습니다. 페이지 상단에는 계정 개요, 프로필 상태, 실시간 연결 상태, Genesis 라이선스 수가 먼저 표시됩니다. 각 Genesis 라이선스에는 현재 플랜, PC 및 콘솔 한도, AI 잔액, 회원 잔액, 부가 서비스 접근 권한, Stripe 상태를 보여 주는 운영 카드가 하나씩 있습니다.

레거시 도구와 베타 도구는 별도의 펼침 영역에 보관됩니다. 핑 활동과 프로필 변경 내역은 진단 및 변경 이력에서 확인할 수 있습니다. 이렇게 하면 예전 지원 도구를 없애지 않으면서도 현재 Genesis 작업 흐름을 눈에 잘 띄게 유지할 수 있습니다.

모든 Genesis 라이선스 보기

내부 관리자 대시보드에서 라이선스를 엽니다. Genesis 탭이 기본으로 열리며 현재의 Free 및 Genesis 플랜만 표시됩니다. 과거에 부여된 베타 라이선스는 별도의 Beta 탭에 남아 있습니다.

요약 카드에는 전체, 활성, 유료, 무료 라이선스 수가 표시됩니다. 목록은 카페, 계정, 이메일, 플랜 또는 라이선스 키로 검색할 수 있습니다. 관리자는 플랜 유형이나 상태로 필터링할 수도 있습니다. 각 행에는 수용 한도, 클라우드 및 카페테리아 접근 권한, AI 잔액, 유효 기간, 상태가 표시됩니다. 관리를 선택하면 플랜, 서비스, 크레딧, 결제 작업을 처리하는 고객 작업 공간이 열립니다.

첫 Genesis 라이선스 생성

계정에 Genesis 라이선스가 하나도 없으면 고객 상세 페이지는 빈 결과 대신 라이선스 생성 양식을 표시합니다. 활성 Genesis 플랜과 미래의 만료일을 선택합니다. 확인 대화 상자에서 플랜, 만료일, 국가를 검토합니다. 라이선스 생성을 선택하면 고객 계정에 바로 할당됩니다.

라이선스를 생성하려면 계정에 카페 이름과 국가가 먼저 입력되어 있어야 합니다. 누락된 정보는 프로필 편집을 선택해 추가합니다. 플랜이 PC 한도와 콘솔 한도를 모두 결정합니다. 선택한 만료일은 해당 UTC 날짜가 끝날 때까지 유효합니다.

사용 가능한 작업

Genesis 플랜 할당. 수동 라이선스에는 선택한 플랜의 수용 한도와 만료일이 적용됩니다. Stripe로 관리되는 구독은 즉시 청구나 예약 변경을 포함해 일반적인 업그레이드 및 다운그레이드 규칙을 따릅니다.
클라우드 및 카페테리아 관리. 클라우드 이용 권한은 라이선스에 반영됩니다. 카페테리아를 활성화하면 handy.cafe의 해당 테넌트도 함께 생성되거나 다시 활성화되며, 비활성화하면 그 테넌트가 정지됩니다. 두 서비스는 데이터베이스 잠금이 유지되는 동안에는 절대 동기화되지 않습니다.
AI 크레딧 부여. 크레딧 작업 영역은 관리자가 충전 금액을 입력하기 전에 선택한 라이선스의 현재 AI 잔액을 보여 줍니다. 크레딧을 부여하면 AI 지갑에 선불 USD 크레딧이 추가되고 감사 기록이 남습니다.
회원 크레딧 부여. 동일한 이메일 주소를 쓰는 HandyCafe 회원 계정에 보너스 크레딧을 추가합니다. 일치하는 회원이 없으면 이 작업을 사용할 수 없습니다.
다음 결제일 변경. Stripe 구독의 경우 날짜가 Stripe에서 먼저 갱신된 뒤 로컬 구독과 라이선스에 동기화됩니다. 예약된 플랜 변경이 있다면 먼저 취소해야 합니다.
결제 환불. 관리자가 환불 가능한 Stripe 청구 건을 선택하고, Stripe 환불 사유를 고르고, 필수 항목인 내부 설명을 입력한 뒤 환불을 확정합니다. 환불한다고 해서 구독이 해지되거나 제품 접근 권한이 사라지지는 않습니다.

안전장치와 감사 동작

데이터를 변경하는 모든 작업은 대시보드에서 확인 절차를 거칩니다. 영향이 큰 백엔드 작업은 관리자 API 키로 제한되고, Stripe 청구 건의 소유권을 검증하며, 추가만 가능한 감사 기록을 남깁니다. 결제 내역은 요청한 경우에만 불러오며 최근 청구 건으로 범위가 제한됩니다. 환불에는 고유한 멱등성 키를 사용해 실수로 중복 제출되는 것을 방지합니다.

오래된 라이선스에 복구 가능한 평문 키가 남아 있지 않으면 카페테리아 자동 프로비저닝이 안전하게 중단되며, 대시보드는 관리자가 먼저 라이선스 자격 증명 문제를 해결해야 한다고 알립니다.

라이선스 국가 접두사

계정에 연결된 새 라이선스 키는 고객이 작성을 완료한 프로필의 두 자리 국가 코드를 사용합니다. 예를 들어 관리자가 생성한 Genesis 라이선스는 GEN-TR-..., 플랜과 무관한 계정 라이선스는 HC-TR-... 형태입니다. 프로필에 유효한 국가가 없으면 관리자 생성이 중단됩니다. 시스템은 GEN-XX-...나 HC-XX-... 키를 새로 만들지 않습니다.

기존 라이선스의 국가 항목을 수정해도 활성 키가 조용히 교체되지는 않습니다. 자격 증명이 바뀌면 설치된 서버가 다시 로그인해야 하므로, 관리자는 국가 정정과 키 교체를 함께 조율해야 합니다.