Files
junhong_cmp_fiber/openspec/changes/archive/2026-01-21-add-commission-withdrawal-settings/tasks.md
huang 91c9bbfeb8
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 4m35s
feat: 实现账号与佣金管理模块
新增功能:
- 店铺佣金查询:店铺佣金统计、店铺佣金记录列表、店铺提现记录
- 佣金提现审批:提现申请列表、审批通过、审批拒绝
- 提现配置管理:配置列表、新增配置、获取当前生效配置
- 企业管理:企业列表、创建、更新、删除、获取详情
- 企业卡授权:授权列表、批量授权、批量取消授权、统计
- 客户账号管理:账号列表、创建、更新状态、重置密码
- 我的佣金:佣金统计、佣金记录、提现申请、提现记录

数据库变更:
- 扩展 tb_commission_withdrawal_request 新增提现单号等字段
- 扩展 tb_account 新增 is_primary 字段
- 扩展 tb_commission_record 新增 shop_id、balance_after
- 扩展 tb_commission_withdrawal_setting 新增每日提现次数限制
- 扩展 tb_iot_card、tb_device 新增 shop_id 冗余字段
- 新建 tb_enterprise_card_authorization 企业卡授权表
- 新建 tb_asset_allocation_record 资产分配记录表
- 数据迁移:owner_type 枚举值 agent 统一为 shop

测试:
- 新增 7 个单元测试文件覆盖各服务
- 修复集成测试 Redis 依赖问题
2026-01-21 18:20:44 +08:00

107 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 实现任务清单
**Change ID**: `add-commission-withdrawal-settings`
---
## 阶段 1: DTO 定义 (15 分钟)
### Task 1.1: 创建 DTO 文件
**文件**: `internal/model/commission_withdrawal_setting_dto.go`
**实现内容**:
- [x] 1.1.1 `CreateWithdrawalSettingReq` 请求结构
- [x] 1.1.2 `WithdrawalSettingListReq` 分页请求
- [x] 1.1.3 `WithdrawalSettingItem` 响应结构
**验证**:
- [x] 验证标签正确(必填项)
- [x] JSON 标签正确
---
## 阶段 2: Store 层 (30 分钟)
### Task 2.1: 扩展 CommissionWithdrawalSetting Store
**文件**: `internal/store/postgres/commission_withdrawal_setting_store.go`
**实现内容**:
- [x] 2.1.1 `Create(setting)` - 创建配置
- [x] 2.1.2 `List(req)` - 分页查询(按创建时间倒序)
- [x] 2.1.3 `GetCurrent()` - 获取当前生效配置is_active=true
- [x] 2.1.4 `DeactivateCurrent()` - 将当前配置设为失效
**验证**:
- [x] 查询逻辑正确
- [x] 关联创建人信息
---
## 阶段 3: Service 层 (45 分钟)
### Task 3.1: 创建 Service
**文件**: `internal/service/commission_withdrawal_setting/service.go`
**实现内容**:
- [x] 3.1.1 `Create(ctx, req)` - 新增配置
- [x] 3.1.2 `List(ctx, req)` - 查询配置列表
- [x] 3.1.3 `GetCurrent(ctx)` - 获取当前生效配置
**业务逻辑**:
- [x] 3.1.4 新增时先失效旧配置,再创建新配置(事务)
**验证**:
- [x] 配置切换逻辑正确
- [x] 权限检查(仅平台用户)
---
## 阶段 4: Handler 层 (30 分钟)
### Task 4.1: 创建 Handler
**文件**: `internal/handler/admin/commission_withdrawal_setting.go`
**实现内容**:
- [x] 4.1.1 `CreateWithdrawalSetting` - POST /api/admin/commission/withdrawal-settings
- [x] 4.1.2 `ListWithdrawalSettings` - GET /api/admin/commission/withdrawal-settings
- [x] 4.1.3 `GetCurrentWithdrawalSetting` - GET /api/admin/commission/withdrawal-settings/current
**验证**:
- [x] 参数校验正确
- [x] 响应格式正确
---
### Task 4.2: 路由注册
**实现内容**:
- [x] 4.2.1 注册三个 API 路由
- [x] 4.2.2 配置权限(仅平台用户可新增)
---
## 阶段 5: 测试 (30 分钟)
### Task 5.1: 功能测试
**实现内容**:
- [x] 5.1.1 新增配置测试
- [x] 5.1.2 配置切换测试(旧配置自动失效)
- [x] 5.1.3 获取当前配置测试
---
## 完成标准
- [x] 所有 DTO 定义完成
- [x] Store 层方法实现完成
- [x] Service 层业务逻辑完成
- [x] Handler 层 API 实现完成
- [x] 配置切换逻辑正确
- [x] 编译通过
- [x] 功能测试通过