glitter-economy is a G7 module that keeps wallet state and transaction history consistent through Credit, Debit, Hold, Release, Void, and admin adjustments.
This is a conceptual wallet-flow example, not a live production state.
Wallet state and transaction history follow the same rule whenever a balance changes.
Manage available and locked balances separately.
Balance changes become traceable ledger entries.
Admins can adjust balances with reasons and review transaction history.
The example shows how a wallet moves from reward credit to hold, release, confirmed debit, and transaction lookup.
A wallet is connected to a member or target user.
Add value for signup rewards, event grants, or operational correction.
Lock value before confirmation for preorder, order, or bidding flows.
Return locked value to available balance when cancellation or release conditions apply.
Subtract value from available balance when actual usage is confirmed.
Admins review ledger flow by transaction type, wallet, and period.
Wallet review, manual adjustment, transaction lookup, and permissions are connected through the admin operation surface.
Review available and locked balances by wallet.
Apply Credit or Debit adjustments while recording a reason.
Search ledger entries by transaction type, wallet ID, and period.
Separate lookup and adjustment access by admin role.
Ledger behavior is built from six basic concepts that can be combined for operational policy.
A transaction that increases available balance.
A transaction that decreases available balance.
Moves part of available balance into locked balance.
Returns locked balance back into available balance.
Safely invalidates a transaction before confirmation.
Records balance after each transaction so the flow remains traceable.
The page separates the module baseline from areas that can be extended for each operating environment.
Place the bundled module source, then install, activate, configure permissions, and operate ledger flows from admin screens.
Place the module source in modules/_bundled/glitter-economy.
Install and activate the module from admin.
Run module lifecycle update to refresh active output and metadata.
Set roles and permissions according to operating policy.
Operate wallet flow from admin adjustment and transaction screens.