그누보드7 자산 원장 모듈, glitter-economy
포인트/예치금/보증금/정산 등 다양한 잔액과 거래를 관리하는 범용 지갑·원장 시스템
PHP 8.2+ / Laravel 12.x
MySQL 8
TypeScript / JSON Layout
Module 확장 구조
개요
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-economy는 G7 기본 포인트를 대체하지 않고, 별도의 지갑/원장 계층으로 동작하는 포인트 거래원장 모듈입니다. 기존 포인트는 그대로 유지한 상태에서 경매 보증금, 예약 결제, 정산 대기금, 커뮤니티 포인트 등 거래 이력과 잠금 상태가 필요한 기능에 붙여 사용할 수 있습니다. 일반적인 포인트 적립/차감 기능도 구현할 수 있지만, 단순 잔액 관리보다 거래 원장과 잠금 상태 관리에 초점을 둔 구조입니다.
glitter-economy는 G7 기본 포인트를 대체하지 않고, 별도의 지갑/원장 계층으로 동작하는 포인트 거래원장 모듈입니다. 기존 포인트는 그대로 유지한 상태에서 경매 보증금, 예약 결제, 정산 대기금, 커뮤니티 포인트 등 거래 이력과 잠금 상태가 필요한 기능에 붙여 사용할 수 있습니다. 일반적인 포인트 적립/차감 기능도 구현할 수 있지만, 단순 잔액 관리보다 거래 원장과 잠금 상태 관리에 초점을 둔 구조입니다.