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>

openspec/specs/order-payment/spec.md

@@ -107,3 +107,162 @@
 #### Scenario: 余额扣减后套餐激活失败
 - **WHEN** 余额扣减成功但套餐激活失败
 - **THEN** 事务回滚，余额恢复，订单状态不变
+## ADDED Requirements
+
+### Requirement: 后台钱包一步支付
+
+系统 SHALL 支持后台订单创建时使用钱包支付立即完成订单，无需后续调用支付接口。
+
+#### Scenario: 后台订单创建时钱包支付
+- **WHEN** 代理在后台创建订单，支付方式为 wallet，钱包余额充足
+- **THEN** 系统创建订单，立即扣减钱包余额，订单状态为已支付（`payment_status` = 2），激活套餐
+
+#### Scenario: 后台钱包支付余额不足
+- **WHEN** 代理在后台创建订单，支付方式为 wallet，钱包余额不足
+- **THEN** 系统返回错误"余额不足"，订单创建失败
+
+#### Scenario: 后台钱包支付订单响应
+- **WHEN** 后台钱包支付订单创建成功
+- **THEN** API 响应包含已支付的订单信息，`payment_status` = 2，`payment_method` = "wallet"，`paid_at` 为当前时间
+
+#### Scenario: 后台钱包支付不创建待支付订单
+- **WHEN** 代理在后台创建 wallet 订单
+- **THEN** 系统不创建待支付订单（`payment_status` != 1），直接完成支付
+
+---
+
+### Requirement: H5 钱包两步支付保持不变
+
+系统 SHALL 保持 H5 端钱包支付的两步流程（创建待支付订单 → 调用支付接口）。
+
+#### Scenario: H5 创建待支付订单
+- **WHEN** 个人客户在 H5 端创建订单，支付方式为 wallet
+- **THEN** 系统创建订单，`payment_status` = 1（待支付），不扣减钱包余额
+
+#### Scenario: H5 调用 WalletPay 接口支付
+- **WHEN** 个人客户调用 WalletPay 接口支付待支付订单
+- **THEN** 系统扣减钱包余额，更新订单状态为已支付，激活套餐
+
+#### Scenario: H5 和后台钱包支付流程独立
+- **WHEN** H5 端创建 wallet 订单
+- **THEN** 不影响后台 wallet 订单的一步支付逻辑
+
+---
+
+### Requirement: 钱包流水记录扩展
+
+系统 SHALL 在钱包流水中记录交易子类型和关联店铺，支持按场景筛选。
+
+#### Scenario: 自购钱包流水
+- **WHEN** 代理为自己的资源购买套餐，使用 wallet
+- **THEN** 钱包流水的 `transaction_subtype` = "self_purchase"，`related_shop_id` 为 NULL，`remark` = "购买套餐"
+
+#### Scenario: 代购钱包流水
+- **WHEN** 代理为下级代理购买套餐，使用 wallet
+- **THEN** 钱包流水的 `transaction_subtype` = "purchase_for_subordinate"，`related_shop_id` = 下级代理店铺 ID，`remark` = "为下级代理【XX】购买套餐"
+
+#### Scenario: 钱包流水查询店铺名称
+- **WHEN** 创建代购钱包流水
+- **THEN** 系统查询下级店铺名称，填充到 `remark` 字段
+
+#### Scenario: 钱包流水筛选
+- **WHEN** 代理查询钱包流水，筛选 `transaction_subtype` = "purchase_for_subordinate"
+- **THEN** 系统返回所有为下级代理购买的流水记录
+
+---
+
+### Requirement: 钱包支付乐观锁
+
+系统 SHALL 使用乐观锁防止钱包并发扣款导致余额不一致。
+
+#### Scenario: 钱包扣款使用 version 字段
+- **WHEN** 扣减钱包余额
+- **THEN** SQL 语句包含 `WHERE balance >= ? AND version = ?`，更新时 `version + 1`
+
+#### Scenario: 钱包并发扣款失败
+- **WHEN** 两个请求同时扣减同一钱包
+- **THEN** 只有一个请求成功，另一个返回"余额不足或并发冲突"
+
+#### Scenario: 乐观锁重试逻辑
+- **WHEN** 钱包扣款因 version 冲突失败
+- **THEN** 系统不自动重试，返回错误（由客户端决定是否重试）
+
+---
+
+### Requirement: 钱包支付幂等性
+
+系统 SHALL 防止同一订单重复创建和重复扣款。
+
+#### Scenario: 订单创建幂等性检查
+- **WHEN** 同一买家对同一载体的同一套餐组合在短时间内重复创建订单
+- **THEN** 系统返回已创建的订单，不重复扣款
+
+#### Scenario: 幂等性使用 Redis 业务键
+- **WHEN** 检查订单幂等性
+- **THEN** 系统使用 Redis key `order:idempotency:{buyer_type}:{buyer_id}:{order_type}:{carrier_type}:{carrier_id}:{sorted_package_ids}`
+
+#### Scenario: 幂等性 TTL
+- **WHEN** 订单创建成功后标记幂等性
+- **THEN** Redis key 的 TTL 为 3 分钟
+
+#### Scenario: 分布式锁防止并发
+- **WHEN** 订单创建前检查幂等性
+- **THEN** 系统使用分布式锁 `order:create:lock:{carrier_type}:{carrier_id}`，TTL 10 秒
+
+---
+
+### Requirement: 后台订单 API 响应扩展
+
+系统 SHALL 在后台订单创建和查询 API 响应中包含钱包支付相关字段。
+
+#### Scenario: 订单响应包含实际支付金额
+- **WHEN** 查询钱包支付的订单
+- **THEN** 响应包含 `actual_paid_amount` 字段
+
+#### Scenario: 订单响应包含操作者信息
+- **WHEN** 查询代购订单
+- **THEN** 响应包含 `operator_id`、`operator_type`、`operator_name` 字段
+
+#### Scenario: 订单响应包含购买备注
+- **WHEN** 查询上级代理购买的订单
+- **THEN** 响应包含 `purchase_remark` 字段，如"由上级代理【XX】购买"
+
+---
+
+### Requirement: 钱包支付错误处理
+
+系统 SHALL 在钱包支付失败时返回明确的错误信息。
+
+#### Scenario: 钱包不存在
+- **WHEN** 钱包支付时钱包不存在
+- **THEN** 系统返回错误"钱包不存在"（`CodeWalletNotFound`）
+
+#### Scenario: 余额不足
+- **WHEN** 钱包支付时余额不足
+- **THEN** 系统返回错误"余额不足"（`CodeInsufficientBalance`）
+
+#### Scenario: 并发冲突
+- **WHEN** 钱包扣款因 version 冲突失败
+- **THEN** 系统返回错误"余额不足或并发冲突"（`CodeInsufficientBalance`）
+
+#### Scenario: 套餐激活失败
+- **WHEN** 钱包扣款成功但套餐激活失败
+- **THEN** 事务回滚，钱包余额恢复，返回激活失败错误
+
+---
+
+### Requirement: 钱包支付与第三方支付的区别
+
+系统 SHALL 区分后台钱包支付和第三方支付的业务逻辑。
+
+#### Scenario: 后台不支持第三方支付
+- **WHEN** 代理在后台创建订单时选择 wechat 或 alipay
+- **THEN** 系统返回错误"后台只支持 wallet 和 offline 支付方式"
+
+#### Scenario: H5 支持第三方支付
+- **WHEN** 个人客户在 H5 端创建订单时选择 wechat 或 alipay
+- **THEN** 系统创建待支付订单，返回支付参数（prepay_id 或 h5_url）
+
+#### Scenario: 钱包支付不需要支付参数
+- **WHEN** 后台钱包支付订单创建成功
+- **THEN** 响应不包含 prepay_id、h5_url 等第三方支付参数