그누보드7 자산 원장 모듈 - Glitter Economy
포인트/예치금/보증금/정산 등 다양한 잔액과 거래를 관리하는 범용 지갑·원장 시스템
개요
glitter-economy는 그누보드7(G7) 환경에서 포인트 잔액과 거래 원장을 일관되게 관리하기 위한 Wallet & Ledger 모듈입니다.
사용자별 지갑을 생성하고 Credit, Debit, Hold, Release, Void 거래 유형을 통해 잔액 변화를 관리하며, 모든 거래 내역을 원장(Ledger)에 기록합니다.
주요 기능
Wallet
- 사용자별 지갑 관리
- 사용 가능 잔액(Available Balance) 관리
- 잠금 잔액(Locked Balance) 관리
Ledger
- 모든 금액 변동 이력 기록
- 거래 후 잔액(balance_after) 추적
- 거래 원장 기반 감사(Audit) 가능
Transaction Types
- Credit
- Debit
- Hold
- Release
- Void
Admin
- Admin Adjustment
- Wallet 조회
- Transaction 조회
- 거래 필터 검색
활용 사례
- 경매 플랫폼 보증금 관리
- 포인트/마일리지 시스템
- 디지털 자산 관리
- 티켓 예매 결제 흐름
- 크리에이터 정산 시스템
- 커뮤니티 경제 모듈
기술 스택
- PHP 8.2+
- Laravel 12.x
- MySQL 8
- Laravel Sanctum
- JSON Layout Engine
- TypeScript
설치 방법
Release에서 번들 패키지 다운로드
압축 해제 후 생성된 폴더(glitter-economy)를 아래 경로에 복사합니다.
modules/_bundled/
관리자 페이지 > 모듈 관리에서 해당 모듈 설치(활성화)
관리자 페이지 설치
1. GitHub 저장소에서 설치 (권장)
관리자 → 모듈 관리 → 수동 설치 → GitHub
아래의 저장소 URL을 입력합니다.
https://github.com/glitter-node/glitter-economy
설치 완료 후 모듈을 활성화하면 이코노미 지갑 관리 메뉴가 생성됩니다.
2. ZIP 패키지 설치
Release에서 ZIP 패키지를 다운로드한 후 관리자 → 모듈 관리 → 수동 설치 → 파일 업로드를 통해 설치할 수도 있습니다.
다만 GitHub 저장소를 통한 설치 및 업데이트를 권장합니다.
3. 설치 후 생성된 페이지의 로드 에러 발생 시
관리자 → 환경설정 → 고급 → 캐시 모두 삭제
저장소
Release https://github.com/glitter-node/glitter-economy/releases/tag/v0.9.13
GitHub https://github.com/glitter-node/glitter-economy
라이선스
MIT License
다른 창작물 살펴보기
G7 워크플로 자동화 모듈 - Glitter Workflow
Gnuboard7의 이벤트를 조건과 순차 작업으로 연결해 자동화하는 Workflow & Automation 모듈.
그누보드7 감사 로그 모듈 - Glitter Audit Log
G7 활성 로그를 기반으로 감사 이벤트 탐색, Registry 관리, Coverage 진단을 제공하는 읽기 전용 감사 로그 모듈
그누보드7 알림 허브 모듈- Glitter Notification Hub
알림의 시작부터 전달, 재시도, 실패 관리까지 하나의 허브로 연결하는 그누보드7 통합 알림 오케스트레이션 모듈.