feat(distribution): 分销站点消息中心与钱包提现多租户独立分支隔离

- 新增 000070 数据库迁移:支持 chat_conversations、wallet_accounts、wallet_ledger、withdrawal_requests 按 distribution_site_id 隔离
- 消息中心:会话列表、未读数统计、站点专属客服及订单群聊与主站实现双向完全隔离
- 资金账户与提现:独立按 (user_id, distribution_site_id) 建账,分销订单自动结算至对应分站钱包,提现与流水相互独立
- 前台界面:Axios 自动透传 X-Distribution-Site-Code,钱包、提现与消息页面呈现分站专属标牌与独立说明
This commit is contained in:
yml2213
2026-09-07 18:11:27 +08:00
parent 72b805c499
commit e024319860
35 changed files with 1109 additions and 298 deletions
+99 -42
View File
@@ -3,7 +3,9 @@ package wallet
import (
"context"
"crypto/rand"
"errors"
"fmt"
"strings"
"time"
"hfb_sys/backend/internal/model"
@@ -19,27 +21,52 @@ type Repository struct {
}
type Entry struct {
UserID uint64
OrderID *uint64
Direction string
AmountCent int64
BalanceType string
BizType string
BizNo string
Remark string
UserID uint64
DistributionSiteID uint64
OrderID *uint64
Direction string
AmountCent int64
BalanceType string
BizType string
BizNo string
Remark string
}
func NewRepository(db *gorm.DB) *Repository {
return &Repository{db: db}
}
func (r *Repository) Account(ctx context.Context, userID uint64) (*AccountDTO, error) {
func (r *Repository) resolveSiteID(ctx context.Context, siteCode string) (uint64, error) {
siteCode = strings.TrimSpace(siteCode)
if siteCode == "" {
return 0, nil
}
var site model.DistributionSite
if err := r.db.WithContext(ctx).Where("site_code = ? AND status = 'active'", siteCode).First(&site).Error; err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
return 0, errors.New("distribution site unavailable")
}
return 0, err
}
return site.ID, nil
}
func (r *Repository) Account(ctx context.Context, userID uint64, siteCode ...string) (*AccountDTO, error) {
var code string
if len(siteCode) > 0 {
code = siteCode[0]
}
siteID, err := r.resolveSiteID(ctx, code)
if err != nil {
return nil, err
}
var account model.WalletAccount
err := r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
if err := ensureAccount(tx, userID); err != nil {
err = r.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
if err := ensureAccount(tx, userID, siteID); err != nil {
return err
}
return tx.Where("user_id = ?", userID).First(&account).Error
return tx.Where("user_id = ? AND distribution_site_id = ?", userID, siteID).First(&account).Error
})
if err != nil {
return nil, err
@@ -47,14 +74,36 @@ func (r *Repository) Account(ctx context.Context, userID uint64) (*AccountDTO, e
return toAccountDTO(account), nil
}
func (r *Repository) Ledger(ctx context.Context, userID uint64, page, pageSize int) (*PaginatedResult, error) {
func (r *Repository) Ledger(ctx context.Context, userID uint64, page, pageSize int, siteCode ...string) (*PaginatedResult, error) {
var code string
if len(siteCode) > 0 {
code = siteCode[0]
}
siteID, err := r.resolveSiteID(ctx, code)
if err != nil {
return nil, err
}
query := r.db.WithContext(ctx).Model(&model.WalletLedger{}).Where("user_id = ?", userID)
if siteID > 0 {
query = query.Where("distribution_site_id = ?", siteID)
} else {
query = query.Where("distribution_site_id = 0 OR distribution_site_id IS NULL")
}
var total int64
if err := r.db.WithContext(ctx).Model(&model.WalletLedger{}).Where("user_id = ?", userID).Count(&total).Error; err != nil {
if err := query.Count(&total).Error; err != nil {
return nil, err
}
offset := (page - 1) * pageSize
var rows []model.WalletLedger
if err := r.db.WithContext(ctx).Where("user_id = ?", userID).Order("id DESC").Offset(offset).Limit(pageSize).Find(&rows).Error; err != nil {
dataQuery := r.db.WithContext(ctx).Where("user_id = ?", userID)
if siteID > 0 {
dataQuery = dataQuery.Where("distribution_site_id = ?", siteID)
} else {
dataQuery = dataQuery.Where("distribution_site_id = 0 OR distribution_site_id IS NULL")
}
if err := dataQuery.Order("id DESC").Offset(offset).Limit(pageSize).Find(&rows).Error; err != nil {
return nil, err
}
items := make([]LedgerDTO, 0, len(rows))
@@ -127,11 +176,11 @@ func AppendEntries(tx *gorm.DB, entries ...Entry) error {
if entry.AmountCent <= 0 {
continue
}
if err := ensureAccount(tx, entry.UserID); err != nil {
if err := ensureAccount(tx, entry.UserID, entry.DistributionSiteID); err != nil {
return err
}
var account model.WalletAccount
if err := tx.Clauses(clause.Locking{Strength: "UPDATE"}).Where("user_id = ?", entry.UserID).First(&account).Error; err != nil {
if err := tx.Clauses(clause.Locking{Strength: "UPDATE"}).Where("user_id = ? AND distribution_site_id = ?", entry.UserID, entry.DistributionSiteID).First(&account).Error; err != nil {
return err
}
balanceAfterCent, err := applyEntry(&account, entry)
@@ -146,16 +195,17 @@ func AppendEntries(tx *gorm.DB, entries ...Entry) error {
return err
}
ledger := model.WalletLedger{
LedgerNo: ledgerNo,
UserID: entry.UserID,
OrderID: entry.OrderID,
Direction: entry.Direction,
AmountCent: entry.AmountCent,
BalanceAfterCent: balanceAfterCent,
BalanceType: entry.BalanceType,
BizType: entry.BizType,
BizNo: entry.BizNo,
Remark: entry.Remark,
LedgerNo: ledgerNo,
UserID: entry.UserID,
DistributionSiteID: entry.DistributionSiteID,
OrderID: entry.OrderID,
Direction: entry.Direction,
AmountCent: entry.AmountCent,
BalanceAfterCent: balanceAfterCent,
BalanceType: entry.BalanceType,
BizType: entry.BizType,
BizNo: entry.BizNo,
Remark: entry.Remark,
}
if err := tx.Create(&ledger).Error; err != nil {
return err
@@ -164,14 +214,19 @@ func AppendEntries(tx *gorm.DB, entries ...Entry) error {
return nil
}
func ensureAccount(tx *gorm.DB, userID uint64) error {
return EnsureAccountTx(tx, userID)
func ensureAccount(tx *gorm.DB, userID uint64, siteID ...uint64) error {
return EnsureAccountTx(tx, userID, siteID...)
}
// EnsureAccountTx 在事务内确保用户钱包账户存在(幂等)。
func EnsureAccountTx(tx *gorm.DB, userID uint64) error {
func EnsureAccountTx(tx *gorm.DB, userID uint64, siteID ...uint64) error {
var sID uint64
if len(siteID) > 0 {
sID = siteID[0]
}
account := model.WalletAccount{
UserID: userID,
DistributionSiteID: sID,
AvailableBalanceCent: 0,
FrozenBalanceCent: 0,
Status: "active",
@@ -213,6 +268,7 @@ func roundWalletMoney(yuan float64) float64 {
func toAccountDTO(account model.WalletAccount) *AccountDTO {
return &AccountDTO{
UserID: account.UserID,
DistributionSiteID: account.DistributionSiteID,
AvailableBalanceCent: account.AvailableBalanceCent,
FrozenBalanceCent: account.FrozenBalanceCent,
Status: account.Status,
@@ -221,18 +277,19 @@ func toAccountDTO(account model.WalletAccount) *AccountDTO {
func toLedgerDTO(ledger model.WalletLedger) LedgerDTO {
return LedgerDTO{
ID: ledger.ID,
LedgerNo: ledger.LedgerNo,
UserID: ledger.UserID,
OrderID: ledger.OrderID,
Direction: ledger.Direction,
AmountCent: ledger.AmountCent,
BalanceAfterCent: ledger.BalanceAfterCent,
BalanceType: ledger.BalanceType,
BizType: ledger.BizType,
BizNo: ledger.BizNo,
Remark: ledger.Remark,
CreatedAt: ledger.CreatedAt,
ID: ledger.ID,
LedgerNo: ledger.LedgerNo,
UserID: ledger.UserID,
DistributionSiteID: ledger.DistributionSiteID,
OrderID: ledger.OrderID,
Direction: ledger.Direction,
AmountCent: ledger.AmountCent,
BalanceAfterCent: ledger.BalanceAfterCent,
BalanceType: ledger.BalanceType,
BizType: ledger.BizType,
BizNo: ledger.BizNo,
Remark: ledger.Remark,
CreatedAt: ledger.CreatedAt,
}
}