junhong_cmp_fiber/openspec/changes/archive/2026-01-21-add-commission-model-changes/tasks.md

实现任务清单

Change ID: add-commission-model-changes

---

阶段 1: 数据库迁移 (1-2 小时)

Task 1.1: 创建迁移文件

文件: migrations/000010_add_commission_model_changes.up.sql

实现内容:

• 1.1.1 新增 tb_commission_withdrawal_request 表字段
• 1.1.2 新增 tb_account.is_primary 字段
• 1.1.3 新增 tb_commission_record 表字段（shop_id, balance_after）
• 1.1.4 新增 tb_commission_withdrawal_setting.daily_withdrawal_limit 字段
• 1.1.5 新增 tb_iot_card.shop_id 字段
• 1.1.6 新增 tb_device.shop_id 字段
• 1.1.7 创建 tb_enterprise_card_authorization 表
• 1.1.8 创建 tb_asset_allocation_record 表
• 1.1.9 创建必要的索引

验证:

• 迁移脚本语法正确
• 字段类型与需求文档一致

---

Task 1.2: 数据迁移 - owner_type 枚举统一

文件: migrations/000010_add_commission_model_changes.up.sql

实现内容:

• 1.2.1 更新 tb_iot_card 表 owner_type='agent' 为 owner_type='shop'
• 1.2.2 更新 tb_device 表 owner_type='agent' 为 owner_type='shop'
• 1.2.3 填充 tb_iot_card.shop_id 字段（owner_type='shop' 时等于 owner_id）
• 1.2.4 填充 tb_device.shop_id 字段（owner_type='shop' 时等于 owner_id）

验证:

• 数据迁移逻辑正确
• 无数据丢失

---

Task 1.3: 创建回滚迁移

文件: migrations/000010_add_commission_model_changes.down.sql

实现内容:

• 1.3.1 删除新增的表字段
• 1.3.2 删除新增的表
• 1.3.3 恢复 owner_type 枚举值（shop → agent）

验证:

• 回滚脚本可以正确执行
• 回滚后数据库状态正确

---

阶段 2: Model 更新 (1 小时)

Task 2.1: 更新现有 Model

文件:

• internal/model/financial.go
• internal/model/commission.go
• internal/model/account.go
• internal/model/iot_card.go
• internal/model/device.go

实现内容:

• 2.1.1 CommissionWithdrawalRequest 新增字段
• 2.1.2 Account 新增 IsPrimary 字段
• 2.1.3 CommissionRecord 新增 ShopID, BalanceAfter 字段
• 2.1.4 CommissionWithdrawalSetting 新增 DailyWithdrawalLimit 字段
• 2.1.5 IotCard 新增 ShopID 字段
• 2.1.6 Device 新增 ShopID 字段

验证:

• 字段标签正确（gorm, json）
• 字段类型与数据库一致

---

Task 2.2: 新增 Model

文件:

• internal/model/enterprise_card_authorization.go
• internal/model/asset_allocation_record.go

实现内容:

• 2.2.1 创建 EnterpriseCardAuthorization 模型
• 2.2.2 创建 AssetAllocationRecord 模型
• 2.2.3 实现 TableName() 方法

验证:

• 模型定义完整
• 遵循项目 Model 规范

---

Task 2.3: 更新常量定义

文件: pkg/constants/iot.go

实现内容:

• 2.3.1 更新 OwnerType 常量（移除 agent, user, device，保留 platform, shop）
• 2.3.2 新增 EnterpriseCardAuthorizationStatus 常量
• 2.3.3 新增 AssetAllocationType 常量
• 2.3.4 新增 PaymentType 常量
• 2.3.5 新增 Redis Key 生成函数（如有需要）

验证:

• 常量命名符合规范
• 中文注释完整

---

阶段 3: 代码兼容性修复 (30 分钟)

Task 3.1: 更新现有代码中的 owner_type 引用

实现内容:

• 3.1.1 全局搜索 owner_type.*agent 引用
• 3.1.2 更新为 shop
• 3.1.3 验证无遗漏

验证:

• 编译通过
• 无运行时错误

---

阶段 4: 验证 (30 分钟)

Task 4.1: 执行迁移

实现内容:

• 4.1.1 在开发环境执行迁移
• 4.1.2 验证表结构正确
• 4.1.3 验证数据迁移正确
• 4.1.4 验证索引创建正确

验证:

• migrate up 成功
• migrate down 可以回滚

---

Task 4.2: Model 验证

实现内容:

• 4.2.1 验证 Model 与数据库表结构一致
• 4.2.2 简单 CRUD 测试
• 4.2.3 验证 GORM 自动迁移无冲突

验证:

• 所有新字段可正常读写
• 新表 CRUD 正常

---

完成标准

• 所有迁移文件创建完成
• 所有 Model 更新完成
• 常量定义更新完成
• 代码兼容性修复完成
• 迁移执行成功
• 编译通过，无错误