实现多商户履约平台基础
This commit is contained in:
yml2213
@@ -0,0 +1,270 @@
|
||||
package model
|
||||
|
||||
import (
|
||||
"time"
|
||||
|
||||
"gorm.io/gorm"
|
||||
)
|
||||
|
||||
const (
|
||||
MerchantStatusActive = "active"
|
||||
MerchantStatusDisabled = "disabled"
|
||||
|
||||
MemberRoleOwner = "owner"
|
||||
MemberRoleOperator = "operator"
|
||||
MemberRoleFinance = "finance"
|
||||
MemberRoleViewer = "viewer"
|
||||
|
||||
APIClientStatusActive = "active"
|
||||
APIClientStatusDisabled = "disabled"
|
||||
|
||||
ProductStatusActive = "active"
|
||||
ProductStatusInactive = "inactive"
|
||||
|
||||
PaymentStatusPending = "pending"
|
||||
PaymentStatusPaid = "paid"
|
||||
PaymentStatusRefunded = "refunded"
|
||||
PaymentStatusCancelled = "cancelled"
|
||||
|
||||
FulfillmentStatusPending = "pending"
|
||||
FulfillmentStatusProcessing = "processing"
|
||||
FulfillmentStatusSucceeded = "succeeded"
|
||||
FulfillmentStatusFailed = "failed"
|
||||
FulfillmentStatusCancelled = "cancelled"
|
||||
|
||||
FulfillmentJobStatusPending = "pending"
|
||||
FulfillmentJobStatusProcessing = "processing"
|
||||
FulfillmentJobStatusSucceeded = "succeeded"
|
||||
FulfillmentJobStatusFailed = "failed"
|
||||
|
||||
WalletLedgerCredit = "credit"
|
||||
WalletLedgerDebit = "debit"
|
||||
WalletLedgerRefund = "refund"
|
||||
WalletLedgerAdjust = "adjust"
|
||||
|
||||
CallbackStatusActive = "active"
|
||||
CallbackStatusDisabled = "disabled"
|
||||
|
||||
CallbackDeliveryPending = "pending"
|
||||
CallbackDeliverySending = "sending"
|
||||
CallbackDeliveryDelivered = "delivered"
|
||||
CallbackDeliveryFailed = "failed"
|
||||
)
|
||||
|
||||
// Merchant 商户租户，是所有新业务数据的隔离边界。
|
||||
type Merchant struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
Code string `gorm:"uniqueIndex;size:64;not null" json:"code"`
|
||||
Name string `gorm:"size:128;not null" json:"name"`
|
||||
Status string `gorm:"size:16;not null;default:active;index" json:"status"`
|
||||
ContactName string `gorm:"size:64" json:"contact_name"`
|
||||
ContactInfo string `gorm:"size:128" json:"contact_info"`
|
||||
}
|
||||
|
||||
// MerchantMember 将系统账号和商户权限分离，账号可以属于多个商户。
|
||||
type MerchantMember struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
|
||||
MerchantID uint `gorm:"not null;uniqueIndex:idx_merchant_member;index" json:"merchant_id"`
|
||||
UserID uint `gorm:"not null;uniqueIndex:idx_merchant_member;index" json:"user_id"`
|
||||
Role string `gorm:"size:32;not null;default:operator" json:"role"`
|
||||
Status int `gorm:"not null;default:1" json:"status"`
|
||||
IsDefault bool `gorm:"not null;default:false" json:"is_default"`
|
||||
|
||||
Merchant *Merchant `gorm:"foreignKey:MerchantID" json:"merchant,omitempty"`
|
||||
User *User `gorm:"foreignKey:UserID" json:"user,omitempty"`
|
||||
}
|
||||
|
||||
// APIClient 为一个商户的外部系统集成凭证。SecretCiphertext 仅保存加密后的密钥。
|
||||
type APIClient struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
MerchantID uint `gorm:"not null;index" json:"merchant_id"`
|
||||
Name string `gorm:"size:128;not null" json:"name"`
|
||||
AppKey string `gorm:"uniqueIndex;size:96;not null" json:"app_key"`
|
||||
SecretCiphertext string `gorm:"type:text;not null" json:"-"`
|
||||
SignatureVersion string `gorm:"size:16;not null;default:v1" json:"signature_version"`
|
||||
Scopes string `gorm:"type:text;not null" json:"scopes"`
|
||||
Status string `gorm:"size:16;not null;default:active;index" json:"status"`
|
||||
ExpiresAt *time.Time `json:"expires_at"`
|
||||
LastUsedAt *time.Time `json:"last_used_at"`
|
||||
|
||||
Merchant *Merchant `gorm:"foreignKey:MerchantID" json:"merchant,omitempty"`
|
||||
}
|
||||
|
||||
// Product 是平台通用商品目录；商品特性通过 Attributes 保存，避免把游戏、角色等字段写死。
|
||||
type Product struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
Code string `gorm:"uniqueIndex;size:96;not null" json:"code"`
|
||||
Name string `gorm:"size:160;not null" json:"name"`
|
||||
Category string `gorm:"size:64;index" json:"category"`
|
||||
Description string `gorm:"type:text" json:"description"`
|
||||
Attributes string `gorm:"type:text" json:"attributes"`
|
||||
Status string `gorm:"size:16;not null;default:active;index" json:"status"`
|
||||
}
|
||||
|
||||
// MerchantProduct 是商户可售商品及其价格、库存和履约配置。
|
||||
type MerchantProduct struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
MerchantID uint `gorm:"not null;uniqueIndex:idx_merchant_product_sku;index" json:"merchant_id"`
|
||||
ProductID uint `gorm:"not null;index" json:"product_id"`
|
||||
SKU string `gorm:"size:96;not null;uniqueIndex:idx_merchant_product_sku" json:"sku"`
|
||||
DisplayName string `gorm:"size:160" json:"display_name"`
|
||||
PriceAmount int64 `gorm:"not null;default:0" json:"price_amount"`
|
||||
CostAmount int64 `gorm:"not null;default:0" json:"cost_amount"`
|
||||
Currency string `gorm:"size:12;not null;default:CNY" json:"currency"`
|
||||
Stock int64 `gorm:"not null;default:-1" json:"stock"`
|
||||
Status string `gorm:"size:16;not null;default:active;index" json:"status"`
|
||||
FulfillmentConfig string `gorm:"type:text" json:"fulfillment_config"`
|
||||
|
||||
Product *Product `gorm:"foreignKey:ProductID" json:"product,omitempty"`
|
||||
Merchant *Merchant `gorm:"foreignKey:MerchantID" json:"merchant,omitempty"`
|
||||
}
|
||||
|
||||
// WalletAccount 以最小货币单位记录商户余额，绝不使用 float64 做账。
|
||||
type WalletAccount struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
MerchantID uint `gorm:"not null;uniqueIndex" json:"merchant_id"`
|
||||
Currency string `gorm:"size:12;not null;default:CNY" json:"currency"`
|
||||
AvailableBalance int64 `gorm:"not null;default:0" json:"available_balance"`
|
||||
FrozenBalance int64 `gorm:"not null;default:0" json:"frozen_balance"`
|
||||
}
|
||||
|
||||
// WalletLedgerEntry 记录每一笔余额变化，BalanceAfter 方便审计与对账。
|
||||
type WalletLedgerEntry struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
MerchantID uint `gorm:"not null;index;uniqueIndex:idx_wallet_ledger_idempotency" json:"merchant_id"`
|
||||
WalletAccountID uint `gorm:"not null;index" json:"wallet_account_id"`
|
||||
EntryNo string `gorm:"uniqueIndex;size:64;not null" json:"entry_no"`
|
||||
Type string `gorm:"size:24;not null;index" json:"type"`
|
||||
Amount int64 `gorm:"not null" json:"amount"`
|
||||
BalanceAfter int64 `gorm:"not null" json:"balance_after"`
|
||||
ReferenceType string `gorm:"size:32;not null" json:"reference_type"`
|
||||
ReferenceNo string `gorm:"size:96;not null;index" json:"reference_no"`
|
||||
IdempotencyKey *string `gorm:"uniqueIndex:idx_wallet_ledger_idempotency;size:128" json:"-"`
|
||||
Note string `gorm:"size:255" json:"note"`
|
||||
}
|
||||
|
||||
// FulfillmentOrder 将支付和履约状态拆分，并保留商品及请求快照。
|
||||
type FulfillmentOrder struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
MerchantID uint `gorm:"not null;index;uniqueIndex:idx_order_client_no" json:"merchant_id"`
|
||||
OrderNo string `gorm:"uniqueIndex;size:64;not null" json:"order_no"`
|
||||
ClientOrderNo string `gorm:"size:96;not null;uniqueIndex:idx_order_client_no" json:"client_order_no"`
|
||||
MerchantProductID uint `gorm:"not null;index" json:"merchant_product_id"`
|
||||
ProductSKU string `gorm:"size:96;not null" json:"product_sku"`
|
||||
ProductName string `gorm:"size:160;not null" json:"product_name"`
|
||||
Quantity int64 `gorm:"not null;default:1" json:"quantity"`
|
||||
Amount int64 `gorm:"not null" json:"amount"`
|
||||
Currency string `gorm:"size:12;not null;default:CNY" json:"currency"`
|
||||
PaymentStatus string `gorm:"size:16;not null;default:pending;index" json:"payment_status"`
|
||||
FulfillmentStatus string `gorm:"size:16;not null;default:pending;index" json:"fulfillment_status"`
|
||||
BuyerReference string `gorm:"size:128" json:"buyer_reference"`
|
||||
RequestData string `gorm:"type:text" json:"request_data"`
|
||||
ResultData string `gorm:"type:text" json:"result_data"`
|
||||
ProviderOrderNo string `gorm:"size:96;index" json:"provider_order_no"`
|
||||
FailureReason string `gorm:"size:512" json:"failure_reason"`
|
||||
CancelledAt *time.Time `json:"cancelled_at"`
|
||||
DeliveredAt *time.Time `json:"delivered_at"`
|
||||
|
||||
MerchantProduct *MerchantProduct `gorm:"foreignKey:MerchantProductID" json:"merchant_product,omitempty"`
|
||||
}
|
||||
|
||||
// FulfillmentJob 为后续履约器保留可重试的持久化任务边界。
|
||||
type FulfillmentJob struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
|
||||
MerchantID uint `gorm:"not null;index" json:"merchant_id"`
|
||||
OrderID uint `gorm:"not null;uniqueIndex" json:"order_id"`
|
||||
Status string `gorm:"size:16;not null;default:pending;index" json:"status"`
|
||||
Attempts int `gorm:"not null;default:0" json:"attempts"`
|
||||
NextRunAt time.Time `gorm:"not null;index" json:"next_run_at"`
|
||||
ProviderOrderNo string `gorm:"size:96;index" json:"provider_order_no"`
|
||||
RequestPayload string `gorm:"type:text" json:"request_payload"`
|
||||
ResultPayload string `gorm:"type:text" json:"result_payload"`
|
||||
LastError string `gorm:"size:512" json:"last_error"`
|
||||
}
|
||||
|
||||
// CallbackSubscription 为商户提供独立、可禁用的事件订阅。
|
||||
type CallbackSubscription struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
MerchantID uint `gorm:"not null;index" json:"merchant_id"`
|
||||
Name string `gorm:"size:128;not null" json:"name"`
|
||||
URL string `gorm:"size:1024;not null" json:"url"`
|
||||
Events string `gorm:"type:text;not null" json:"events"`
|
||||
SecretCiphertext string `gorm:"type:text;not null" json:"-"`
|
||||
Status string `gorm:"size:16;not null;default:active;index" json:"status"`
|
||||
}
|
||||
|
||||
// CallbackDelivery 是事务性 outbox 记录；事件 ID 可供接收方做幂等。
|
||||
type CallbackDelivery struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
MerchantID uint `gorm:"not null;index" json:"merchant_id"`
|
||||
CallbackSubscriptionID uint `gorm:"not null;index" json:"callback_subscription_id"`
|
||||
EventID string `gorm:"uniqueIndex;size:64;not null" json:"event_id"`
|
||||
Event string `gorm:"size:64;not null;index" json:"event"`
|
||||
Payload string `gorm:"type:text;not null" json:"payload"`
|
||||
Status string `gorm:"size:16;not null;default:pending;index" json:"status"`
|
||||
Attempts int `gorm:"not null;default:0" json:"attempts"`
|
||||
NextAttemptAt time.Time `gorm:"not null;index" json:"next_attempt_at"`
|
||||
LastStatusCode int `gorm:"not null;default:0" json:"last_status_code"`
|
||||
LastResponse string `gorm:"type:text" json:"last_response"`
|
||||
DeliveredAt *time.Time `json:"delivered_at"`
|
||||
|
||||
CallbackSubscription *CallbackSubscription `gorm:"foreignKey:CallbackSubscriptionID" json:"callback_subscription,omitempty"`
|
||||
}
|
||||
|
||||
// APIRequestNonce 使 API 重放保护跨进程、跨重启生效。
|
||||
type APIRequestNonce struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
APIClientID uint `gorm:"not null;uniqueIndex:idx_api_nonce;index" json:"api_client_id"`
|
||||
Nonce string `gorm:"size:96;not null;uniqueIndex:idx_api_nonce" json:"nonce"`
|
||||
ExpiresAt time.Time `gorm:"not null;index" json:"expires_at"`
|
||||
}
|
||||
|
||||
// AuditLog 留存后台和开放接口的重要业务操作。
|
||||
type AuditLog struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
MerchantID *uint `gorm:"index" json:"merchant_id"`
|
||||
ActorUserID *uint `gorm:"index" json:"actor_user_id"`
|
||||
APIClientID *uint `gorm:"index" json:"api_client_id"`
|
||||
RequestID string `gorm:"size:64;index" json:"request_id"`
|
||||
Action string `gorm:"size:96;not null;index" json:"action"`
|
||||
EntityType string `gorm:"size:64;not null;index" json:"entity_type"`
|
||||
EntityID string `gorm:"size:96;not null;index" json:"entity_id"`
|
||||
Metadata string `gorm:"type:text" json:"metadata"`
|
||||
}
|
||||
@@ -8,7 +8,7 @@ import (
|
||||
|
||||
// 用户角色
|
||||
const (
|
||||
RoleAdmin = "admin" // 管理员
|
||||
RoleAdmin = "admin" // 管理员
|
||||
RoleDistributor = "distributor" // 分销商
|
||||
)
|
||||
|
||||
@@ -35,16 +35,17 @@ type Skin struct {
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
Name string `gorm:"size:128;not null" json:"name"` // 中文名（展示用，保持原名）
|
||||
SKU string `gorm:"uniqueIndex;size:64;not null" json:"sku"` // 英文固定标识
|
||||
Game string `gorm:"size:64;index" json:"game"` // 所属游戏
|
||||
Category string `gorm:"size:64;index" json:"category"` // 品类：套装/背包/...
|
||||
MerchantID uint `gorm:"index;uniqueIndex:idx_skins_merchant_sku;not null;default:0" json:"merchant_id"`
|
||||
Name string `gorm:"size:128;not null" json:"name"` // 中文名（展示用，保持原名）
|
||||
SKU string `gorm:"uniqueIndex:idx_skins_merchant_sku;size:64;not null" json:"sku"` // 英文固定标识
|
||||
Game string `gorm:"size:64;index" json:"game"` // 所属游戏
|
||||
Category string `gorm:"size:64;index" json:"category"` // 品类：套装/背包/...
|
||||
CoverURL string `gorm:"size:512" json:"cover_url"`
|
||||
Price float64 `gorm:"not null;default:0" json:"price"` // 售价
|
||||
CostPrice float64 `gorm:"default:0" json:"cost_price"` // 成本价
|
||||
Commission float64 `gorm:"default:0" json:"commission"` // 佣金比例 0-1
|
||||
Stock int `gorm:"default:0" json:"stock"` // -1 无限
|
||||
Status int `gorm:"default:1" json:"status"` // 1上架 0下架
|
||||
Price float64 `gorm:"not null;default:0" json:"price"` // 售价
|
||||
CostPrice float64 `gorm:"default:0" json:"cost_price"` // 成本价
|
||||
Commission float64 `gorm:"default:0" json:"commission"` // 佣金比例 0-1
|
||||
Stock int `gorm:"default:0" json:"stock"` // -1 无限
|
||||
Status int `gorm:"default:1" json:"status"` // 1上架 0下架
|
||||
Description string `gorm:"type:text" json:"description"`
|
||||
}
|
||||
|
||||
@@ -55,16 +56,17 @@ type Order struct {
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
||||
|
||||
OrderNo string `gorm:"uniqueIndex;size:64;not null" json:"order_no"`
|
||||
SkinID uint `gorm:"index;not null" json:"skin_id"`
|
||||
Skin *Skin `gorm:"foreignKey:SkinID" json:"skin,omitempty"`
|
||||
DistributorID uint `gorm:"index;not null" json:"distributor_id"`
|
||||
Distributor *User `gorm:"foreignKey:DistributorID" json:"distributor,omitempty"`
|
||||
BuyerName string `gorm:"size:64" json:"buyer_name"`
|
||||
Amount float64 `gorm:"not null" json:"amount"`
|
||||
CommissionAmt float64 `gorm:"default:0" json:"commission_amt"`
|
||||
Status string `gorm:"size:32;default:pending;index" json:"status"`
|
||||
Remark string `gorm:"size:255" json:"remark"`
|
||||
MerchantID uint `gorm:"index;not null;default:0" json:"merchant_id"`
|
||||
OrderNo string `gorm:"uniqueIndex;size:64;not null" json:"order_no"`
|
||||
SkinID uint `gorm:"index;not null" json:"skin_id"`
|
||||
Skin *Skin `gorm:"foreignKey:SkinID" json:"skin,omitempty"`
|
||||
DistributorID uint `gorm:"index;not null" json:"distributor_id"`
|
||||
Distributor *User `gorm:"foreignKey:DistributorID" json:"distributor,omitempty"`
|
||||
BuyerName string `gorm:"size:64" json:"buyer_name"`
|
||||
Amount float64 `gorm:"not null" json:"amount"`
|
||||
CommissionAmt float64 `gorm:"default:0" json:"commission_amt"`
|
||||
Status string `gorm:"size:32;default:pending;index" json:"status"`
|
||||
Remark string `gorm:"size:255" json:"remark"`
|
||||
|
||||
// 发货相关（上游皮肤源头对接）
|
||||
ProviderOrderNo string `gorm:"size:64;index" json:"provider_order_no"` // 上游单号
|
||||
@@ -74,7 +76,7 @@ type Order struct {
|
||||
GameChannel string `gorm:"size:64" json:"game_channel"` // 账号区服(安卓/IOS-微信/QQ)
|
||||
GameUID string `gorm:"size:128" json:"game_uid"` // 游戏角色UUID
|
||||
RoleName string `gorm:"size:64" json:"role_name"` // 角色名
|
||||
PayScore int `gorm:"default:0" json:"pay_score"` // 消耗积分
|
||||
PayScore int `gorm:"default:0" json:"pay_score"` // 消耗积分
|
||||
}
|
||||
|
||||
// 订单状态
|
||||
@@ -99,12 +101,13 @@ type ShipLog struct {
|
||||
ID uint `gorm:"primarykey" json:"id"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
|
||||
MerchantID uint `gorm:"index;not null;default:0" json:"merchant_id"`
|
||||
OrderNo string `gorm:"size:64;index;not null" json:"order_no"`
|
||||
OrderID uint `gorm:"index" json:"order_id"`
|
||||
ShipStatus string `gorm:"size:32;not null" json:"ship_status"` // success/failed/processing
|
||||
ProviderOrderNo string `gorm:"size:64" json:"provider_order_no"`
|
||||
FailReason string `gorm:"size:512" json:"fail_reason"`
|
||||
Payload string `gorm:"type:text" json:"payload"` // 原始请求 JSON
|
||||
Payload string `gorm:"type:text" json:"payload"` // 原始请求 JSON
|
||||
ResultStatus string `gorm:"size:32" json:"result_status"` // 处理后订单状态
|
||||
Message string `gorm:"size:255" json:"message"`
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user