49 lines
2.7 KiB
Go
49 lines
2.7 KiB
Go
|
package repository
|
||
|
|
|
||
|
|
import (
|
||
|
|
"code.30cm.net/digimon/app-cloudep-wallet-service/pkg/domain/entity"
|
||
|
|
"code.30cm.net/digimon/app-cloudep-wallet-service/pkg/domain/wallet"
|
||
|
|
"context"
|
||
|
|
"github.com/shopspring/decimal"
|
||
|
|
)
|
||
|
|
|
||
|
|
// UserWalletManager 負責單一使用者對單一資產的錢包操作：
|
||
|
|
// · 建立初始錢包
|
||
|
|
// · 查詢／鎖定餘額
|
||
|
|
// · 本地暫存變動（錢包層面與訂單層面）
|
||
|
|
// · 最後一次性寫回資料庫
|
||
|
|
type UserWalletManager interface {
|
||
|
|
// InitWallets 為新使用者建立所有類型錢包，並寫入資料庫與本地緩存
|
||
|
|
InitWallets(ctx context.Context, brand string) ([]entity.Wallet, error)
|
||
|
|
// FetchAllWallets 查詢資料庫所有錢包類型餘額，不鎖表，並更新本地緩存
|
||
|
|
FetchAllWallets(ctx context.Context) ([]entity.Wallet, error)
|
||
|
|
// FetchWalletsByTypes 查詢指定類型錢包餘額，不鎖表
|
||
|
|
FetchWalletsByTypes(ctx context.Context, kinds []wallet.Types) ([]entity.Wallet, error)
|
||
|
|
// LockWalletsByTypes 查詢並鎖定指定類型錢包 (FOR UPDATE)
|
||
|
|
LockWalletsByTypes(ctx context.Context, kinds []wallet.Types) ([]entity.Wallet, error)
|
||
|
|
// GetCachedBalance 從本地緩存讀取指定類型錢包餘額
|
||
|
|
GetCachedBalance(kind wallet.Types) decimal.Decimal
|
||
|
|
// CreditWallet 增加本地緩存錢包餘額，並記錄一筆 WalletTransaction
|
||
|
|
CreditWallet(kind wallet.Types, orderID string, amount decimal.Decimal) error
|
||
|
|
// DebitWallet 扣減本地緩存錢包餘額，並記錄一筆 WalletTransaction
|
||
|
|
DebitWallet(kind wallet.Types, orderID string, amount decimal.Decimal) error
|
||
|
|
// BuildWalletTransactions 填充所有暫存 WalletTransaction 的共用欄位，回傳可落庫之切片
|
||
|
|
BuildWalletTransactions(txID int64, brand string, biz wallet.BusinessName) []entity.WalletTransaction
|
||
|
|
// CommitWalletBalances 將本地緩存的最終錢包餘額一次性寫回 wallet 表
|
||
|
|
CommitWalletBalances(ctx context.Context) error
|
||
|
|
// FetchOrderTx 從 transaction 表讀取一筆訂單交易，並緩存其後餘額
|
||
|
|
FetchOrderTx(ctx context.Context, orderID string) (entity.Transaction, error)
|
||
|
|
// LockOrderTx 同 FetchOrderTx 但加上 FOR UPDATE
|
||
|
|
LockOrderTx(ctx context.Context, orderID string) (entity.Transaction, error)
|
||
|
|
// CreditOrderBalance 增加本地緩存的訂單後餘額
|
||
|
|
CreditOrderBalance(txID int64, amount decimal.Decimal) error
|
||
|
|
// DebitOrderBalance 扣減本地緩存的訂單後餘額
|
||
|
|
DebitOrderBalance(txID int64, amount decimal.Decimal) error
|
||
|
|
// CommitOrderBalances 將本地暫存的訂單後餘額寫回 transaction.post_transfer_balance
|
||
|
|
CommitOrderBalances(ctx context.Context) error
|
||
|
|
// HasAvailableWallet 檢查是否已有「可用餘額」類型的錢包
|
||
|
|
HasAvailableWallet(ctx context.Context) (bool, error)
|
||
|
|
// Reset 清空本地所有緩存
|
||
|
|
Reset()
|
||
|
|
}
|