그누보드7 자산 원장 모듈, glitter-economy

포인트/예치금/보증금/정산 등 다양한 잔액과 거래를 관리하는 범용 지갑·원장 시스템

문의하기
그누보드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.


댓글 (2)

로그인 후 댓글을 남길 수 있습니다.
쓴
2026-06-22 (월) 09:29:08

이 모듈이 G7 기본 포인트를 대체하는 방식인지, 아니면 별도의 지갑과 원장을 제공하는 구조인지 궁금합니다. 타 포인트 모듈과 함께 사용할 수 있는지, 그리고 게시판이나 이커머스 같은 다른 모듈과는 어떤 방식으로 연동되는지도.

Glitter Gim

glitter-economy는 G7 기본 포인트를 대체하지 않고, 별도의 지갑/원장 계층으로 동작하는 포인트 거래원장 모듈입니다. 기존 포인트는 그대로 유지한 상태에서 경매 보증금, 예약 결제, 정산 대기금, 커뮤니티 포인트 등 거래 이력과 잠금 상태가 필요한 기능에 붙여 사용할 수 있습니다. 일반적인 포인트 적립/차감 기능도 구현할 수 있지만, 단순 잔액 관리보다 거래 원장과 잠금 상태 관리에 초점을 둔 구조입니다.