Glitter Economy는 Gnuboard7에서 공통으로 사용할 수 있는 ledger 기반 가상 가치 인프라 모듈입니다.
커뮤니티 포인트, 이커머스 리워드, 경매, 출석 보상, 광고 보상, 커미션, 크레딧 및 향후 wallet 기반 기능을 지원하기 위한 공통 경제 계층을 목표로 합니다.
이번 v0.9.13은 관리자 메뉴 및 frontend i18n 표시를 정리한 안정화 릴리스입니다.
주요 변경 사항
관리자 사이드바 메뉴 정비
관리자 메뉴에서 해석되지 않은 translation key가 노출되던 문제를 수정했습니다.
메뉴 entity 자체에 한국어와 영어 이름을 명확히 정의하도록 정리했으며, 관리자 화면에서 모듈 기능을 쉽게 식별할 수 있도록 메뉴 구조를 보완했습니다.
주요 변경:
- 관리자 사이드바의 미해결 translation key 제거
- 상위 메뉴를
Economy Wallet Management의미에 맞게 명확화 - 지갑 및 거래 관련 하위 메뉴 이름 정규화
- 한국어/영어 다국어 메뉴 metadata 정리
Frontend i18n 회귀 방지
관리자 메뉴와 frontend translation이 다시 깨지지 않도록 회귀 검증을 추가했습니다.
검증 대상:
- 관리자 메뉴 metadata
- 한국어 frontend translation resolution
- 영어 frontend translation resolution
현재 제공 기능
Glitter Economy는 다음 ledger 및 wallet 기능을 포함합니다.
Wallet
- 사용자별 wallet 관리
- available balance
- locked balance
- wallet balance cache
- 사용자 wallet 자동 초기화
Ledger / Transaction
- credit
- debit
- transfer
- hold
- hold release
- hold void
- 거래 후 잔액 snapshot
- idempotency key 기반 중복 처리 방지
Hold
- 금액 잠금
- 잠금 해제
- 잠금 취소
- 상태 기반 hold 관리
- wallet 및 hold row locking
관리자 기능
- wallet 조회
- 관리자 credit
- 관리자 debit
- hold 생성
- hold release
- hold void
- 거래 내역 확인
- 관리자 wallet/transaction JSON Layout
사용자 기능
- 내 wallet 조회
- 거래 내역 조회
- 설정에 따른 wallet transfer
- 사용자 wallet JSON Layout
권한 구조
Gnuboard7의 표준 module permission 규약을 사용합니다.
권한 identifier는 다음 형태를 따릅니다.
{module}.{category}.{action}
Glitter Economy는 user/admin 권한을 분리하고, 관리자 조정 및 감사 관련 권한도 별도로 정의합니다.
안정성 및 무결성
경제 데이터의 무결성을 위해 다음 원칙을 적용합니다.
- DB transaction 기반 mutation
- wallet row locking
- hold row locking
- ledger-first 기록
- balance snapshot
- idempotency key
- bcmath 기반 decimal 연산
- float fallback 제거
- domain exception 기반 실패 처리
검증 도구
모듈에는 설치 후 및 관리자 동작 검증을 위한 CLI command가 포함되어 있습니다.
검증 범위에는 다음이 포함됩니다.
- credit
- debit
- transfer
- hold release
- hold void
- wallet cache
- ledger row
- 관리자 credit/debit action
- 잘못된 관리자 조정 요청 차단
검증 command들은 지속 데이터 변경을 피하기 위해 rollback 기반 검증을 지향합니다.
호환성
- Gnuboard7 module architecture
- Laravel 12.x
- PHP 8.2+
- JSON Layout
- Gnuboard7 module permission / lifecycle / i18n 구조
참고
Glitter Economy는 단순 포인트 모듈이 아니라 여러 서비스가 공유할 수 있는 공통 wallet 및 ledger 계층을 목표로 합니다.
향후 경매 보증금, 리워드, 정산, 티켓, 디지털 자산 및 커뮤니티 경제 기능의 기반 모듈로 확장할 수 있도록 설계되어 있습니다.
v0.9.13 변경 요약
- 관리자 사이드바 미해결 translation key 수정
- 관리자 메뉴 이름 정리
- wallet/transaction 메뉴 label 정규화
- 한국어/영어 frontend i18n contract 회귀 테스트 추가