glitter-economy는 Credit, Debit, Hold, Release, Void와 관리자 조정을 하나의 거래 흐름으로 묶어 지갑 상태와 거래 이력을 일관되게 관리하는 G7 모듈입니다.
실시간 운영값이 아니라 지갑 흐름을 설명하기 위한 예시입니다.
사용자 지갑과 거래 내역을 분리하지 않고, 잔액 변화가 발생하는 순간마다 같은 규칙으로 기록합니다.
사용 가능 잔액과 잠금 잔액을 분리해 지갑 상태를 관리합니다.
잔액 변화는 거래 원장에 남아 추적 가능한 흐름이 됩니다.
관리자는 사유와 함께 수동 조정을 수행하고 거래 내역을 조회할 수 있습니다.
보상 지급부터 잠금, 해제, 사용 확정, 거래 조회까지 지갑 잔액이 어떻게 움직이는지 한 화면에서 설명합니다.
회원 또는 대상 사용자에게 지갑이 연결됩니다.
가입 보상, 이벤트 지급, 운영 보정처럼 금액을 적립합니다.
예약, 주문, 입찰처럼 확정 전 금액을 잠금 처리합니다.
취소되거나 조건이 해제되면 잠금 금액을 사용 가능 잔액으로 되돌립니다.
실제 사용이 확정되면 사용 가능 잔액에서 차감합니다.
관리자는 거래 유형, 지갑, 기간 기준으로 원장 흐름을 조회합니다.
지갑 상태 확인, 수동 조정, 거래 조회, 권한 분리를 관리자 화면의 운영 흐름으로 연결합니다.
지갑별 잔액과 잠금 잔액을 확인합니다.
사유를 기록하며 Credit 또는 Debit 조정을 수행합니다.
거래 유형, 지갑 ID, 기간 기준으로 원장을 조회합니다.
조회와 조정 권한을 분리해 관리자 역할에 맞게 노출합니다.
원장 동작은 여섯 가지 기본 개념으로 구성되어 운영 정책에 맞게 조합할 수 있습니다.
사용 가능 잔액을 늘리는 거래입니다.
사용 가능 잔액을 줄이는 거래입니다.
사용 가능 잔액 일부를 잠금 잔액으로 이동합니다.
잠금 잔액을 다시 사용 가능 잔액으로 되돌립니다.
확정 전 거래를 안전하게 무효화합니다.
각 거래 이후의 잔액을 기록해 흐름을 추적합니다.
모듈의 기본 범위와 운영 환경에서 확장할 수 있는 영역을 분리해 소개합니다.
번들 모듈 소스를 배치한 뒤 관리자에서 설치, 활성화, 권한 설정, 거래 운영으로 이어집니다.
modules/_bundled/glitter-economy에 모듈 소스를 배치합니다.
관리자에서 모듈을 설치하고 활성화합니다.
module lifecycle update로 활성 출력과 메타데이터를 갱신합니다.
역할과 권한을 운영 정책에 맞게 설정합니다.
관리자 조정과 거래 내역 화면에서 지갑 흐름을 운영합니다.