feat: 实现代理钱包订单创建和订单角色追踪功能

新增功能：
- 代理在后台使用 wallet 支付时，订单直接完成（扣款 + 激活套餐）
- 支持代理自购和代理代购场景
- 新增订单角色追踪字段（operator_id、operator_type、actual_paid_amount、purchase_role）
- 订单查询支持 OR 逻辑（buyer_id 或 operator_id）
- 钱包流水记录交易子类型和关联店铺
- 佣金逻辑调整：代理代购不产生佣金

数据库变更：
- 订单表新增 4 个字段和 2 个索引
- 钱包流水表新增 2 个字段
- 包含迁移脚本和回滚脚本

文档：
- 功能总结文档
- 部署指南
- OpenAPI 文档更新
- Specs 同步（新增 agent-order-role-tracking capability）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

internal/model/agent_wallet.go

@@ -41,13 +41,15 @@ type AgentWalletTransaction struct {
 	AgentWalletID   uint           `gorm:"column:agent_wallet_id;not null;index;comment:代理钱包ID" json:"agent_wallet_id"`
 	ShopID          uint           `gorm:"column:shop_id;not null;index;comment:店铺ID(冗余字段,便于查询)" json:"shop_id"`
 	UserID          uint           `gorm:"column:user_id;not null;comment:操作人用户ID" json:"user_id"`
-	TransactionType string         `gorm:"column:transaction_type;type:varchar(20);not null;comment:交易类型(recharge-充值 | deduct-扣款 | refund-退款 | commission-分佣 | withdrawal-提现)" json:"transaction_type"`
-	Amount          int64          `gorm:"column:amount;type:bigint;not null;comment:变动金额(单位:分,正数为增加,负数为减少)" json:"amount"`
+	TransactionType    string  `gorm:"column:transaction_type;type:varchar(20);not null;comment:交易类型(recharge-充值 | deduct-扣款 | refund-退款 | commission-分佣 | withdrawal-提现)" json:"transaction_type"`
+	TransactionSubtype *string `gorm:"column:transaction_subtype;type:varchar(50);comment:交易子类型（细分 order_payment 场景）" json:"transaction_subtype,omitempty"`
+	Amount             int64   `gorm:"column:amount;type:bigint;not null;comment:变动金额(单位:分,正数为增加,负数为减少)" json:"amount"`
 	BalanceBefore   int64          `gorm:"column:balance_before;type:bigint;not null;comment:变动前余额(单位:分)" json:"balance_before"`
 	BalanceAfter    int64          `gorm:"column:balance_after;type:bigint;not null;comment:变动后余额(单位:分)" json:"balance_after"`
 	Status          int            `gorm:"column:status;type:int;not null;default:1;comment:交易状态(1-成功 2-失败 3-处理中)" json:"status"`
 	ReferenceType   *string        `gorm:"column:reference_type;type:varchar(50);comment:关联业务类型(order | commission | withdrawal | topup)" json:"reference_type,omitempty"`
 	ReferenceID     *uint          `gorm:"column:reference_id;comment:关联业务ID" json:"reference_id,omitempty"`
+	RelatedShopID   *uint          `gorm:"column:related_shop_id;comment:关联店铺ID（代购时记录下级店铺）" json:"related_shop_id,omitempty"`
 	Remark          *string        `gorm:"column:remark;type:text;comment:备注" json:"remark,omitempty"`
 	Metadata        *string        `gorm:"column:metadata;type:jsonb;comment:扩展信息(如手续费、支付方式等)" json:"metadata,omitempty"`
 	Creator         uint           `gorm:"column:creator;not null;comment:创建人ID" json:"creator"`

internal/model/dto/order_dto.go

@@ -16,6 +16,7 @@ type OrderListRequest struct {
 	PaymentStatus *int       `json:"payment_status" query:"payment_status" validate:"omitempty,min=1,max=4" minimum:"1" maximum:"4" description:"支付状态 (1:待支付, 2:已支付, 3:已取消, 4:已退款)"`
 	OrderType     string     `json:"order_type" query:"order_type" validate:"omitempty,oneof=single_card device" description:"订单类型 (single_card:单卡购买, device:设备购买)"`
 	OrderNo       string     `json:"order_no" query:"order_no" validate:"omitempty,max=30" maxLength:"30" description:"订单号(精确查询)"`
+	PurchaseRole  string     `json:"purchase_role" query:"purchase_role" validate:"omitempty,oneof=self_purchase purchased_by_parent purchased_by_platform purchase_for_subordinate" description:"订单角色 (self_purchase:自己购买, purchased_by_parent:上级代理购买, purchased_by_platform:平台代购, purchase_for_subordinate:给下级购买)"`
 	StartTime     *time.Time `json:"start_time" query:"start_time" description:"创建时间起始"`
 	EndTime       *time.Time `json:"end_time" query:"end_time" description:"创建时间结束"`
 }
@@ -49,9 +50,21 @@ type OrderResponse struct {
 	IsPurchaseOnBehalf      bool                 `json:"is_purchase_on_behalf" description:"是否为代购订单"`
 	CommissionStatus        int                  `json:"commission_status" description:"佣金状态 (1:待计算, 2:已计算)"`
 	CommissionConfigVersion int                  `json:"commission_config_version" description:"佣金配置版本"`
-	Items                   []*OrderItemResponse `json:"items" description:"订单明细列表"`
-	CreatedAt               time.Time            `json:"created_at" description:"创建时间"`
-	UpdatedAt               time.Time            `json:"updated_at" description:"更新时间"`
+
+	// 操作者信息
+	OperatorID       *uint  `json:"operator_id,omitempty" description:"操作者ID"`
+	OperatorType     string `json:"operator_type,omitempty" description:"操作者类型 (platform:平台, agent:代理)"`
+	OperatorName     string `json:"operator_name,omitempty" description:"操作者名称"`
+	ActualPaidAmount *int64 `json:"actual_paid_amount,omitempty" description:"实际支付金额(分)"`
+
+	// 订单角色
+	PurchaseRole        string `json:"purchase_role,omitempty" description:"订单角色 (self_purchase:自己购买, purchased_by_parent:上级代理购买, purchased_by_platform:平台代购, purchase_for_subordinate:给下级购买)"`
+	IsPurchasedByParent bool   `json:"is_purchased_by_parent" description:"是否由上级代理购买"`
+	PurchaseRemark      string `json:"purchase_remark,omitempty" description:"购买备注"`
+
+	Items     []*OrderItemResponse `json:"items" description:"订单明细列表"`
+	CreatedAt time.Time            `json:"created_at" description:"创建时间"`
+	UpdatedAt time.Time            `json:"updated_at" description:"更新时间"`
 }
 
 type OrderListResponse struct {

internal/model/order.go

@@ -42,6 +42,16 @@ type Order struct {
 
 	// 代购信息
 	IsPurchaseOnBehalf bool `gorm:"column:is_purchase_on_behalf;type:boolean;default:false;comment:是否为代购订单" json:"is_purchase_on_behalf"`
+
+	// 操作者信息（谁下的单）
+	OperatorID   *uint  `gorm:"column:operator_id;index:idx_orders_operator_id;comment:操作者ID（谁下的单）" json:"operator_id,omitempty"`
+	OperatorType string `gorm:"column:operator_type;type:varchar(20);comment:操作者类型（platform/agent）" json:"operator_type,omitempty"`
+
+	// 实际支付金额（可能与订单金额不同，如代理代购场景）
+	ActualPaidAmount *int64 `gorm:"column:actual_paid_amount;type:bigint;comment:实际支付金额（分）" json:"actual_paid_amount,omitempty"`
+
+	// 订单角色（标识订单中的买卖关系）
+	PurchaseRole string `gorm:"column:purchase_role;type:varchar(50);index:idx_orders_purchase_role;comment:订单角色（self_purchase/purchased_by_parent/purchased_by_platform/purchase_for_subordinate）" json:"purchase_role,omitempty"`
 }
 
 // TableName 指定表名
@@ -83,6 +93,14 @@ const (
 	CommissionStatusCalculated = 2 // 已计算
 )
 
+// 订单角色常量
+const (
+	PurchaseRoleSelfPurchase           = "self_purchase"            // 自己购买
+	PurchaseRolePurchasedByParent      = "purchased_by_parent"      // 上级代理购买
+	PurchaseRolePurchasedByPlatform    = "purchased_by_platform"    // 平台代购
+	PurchaseRolePurchaseForSubordinate = "purchase_for_subordinate" // 给下级购买
+)
+
 // OrderItem 订单明细模型
 // 记录订单中购买的套餐明细，支持一个订单购买多个套餐
 type OrderItem struct {