feat: 实现账号与佣金管理模块
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 4m35s
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 4m35s
新增功能: - 店铺佣金查询:店铺佣金统计、店铺佣金记录列表、店铺提现记录 - 佣金提现审批:提现申请列表、审批通过、审批拒绝 - 提现配置管理:配置列表、新增配置、获取当前生效配置 - 企业管理:企业列表、创建、更新、删除、获取详情 - 企业卡授权:授权列表、批量授权、批量取消授权、统计 - 客户账号管理:账号列表、创建、更新状态、重置密码 - 我的佣金:佣金统计、佣金记录、提现申请、提现记录 数据库变更: - 扩展 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 依赖问题
This commit is contained in:
@@ -0,0 +1,142 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 佣金提现申请扩展字段
|
||||
系统 SHALL 在佣金提现申请表中支持以下扩展字段:
|
||||
- 提现单号(`withdrawal_no`):唯一标识,格式 W + 时间戳 + 随机数
|
||||
- 申请人ID(`applicant_id`):提交申请的账号ID
|
||||
- 店铺ID(`shop_id`):冗余字段,方便查询
|
||||
- 手续费比率(`fee_rate`):申请时的费率快照,基点单位
|
||||
- 放款类型(`payment_type`):如 manual(人工打款)
|
||||
- 处理人ID(`processor_id`):审批/放款人
|
||||
- 处理时间(`processed_at`):审批时间
|
||||
- 备注(`remark`):审批备注
|
||||
|
||||
#### Scenario: 创建提现申请时自动生成提现单号
|
||||
- **WHEN** 代理商发起提现申请
|
||||
- **THEN** 系统自动生成唯一提现单号
|
||||
- **AND** 记录申请人ID和店铺ID
|
||||
- **AND** 记录当前生效的手续费比率
|
||||
|
||||
#### Scenario: 审批提现申请时记录处理信息
|
||||
- **WHEN** 管理员审批(通过或拒绝)提现申请
|
||||
- **THEN** 系统记录处理人ID和处理时间
|
||||
- **AND** 可选记录备注信息
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 店铺主账号标识
|
||||
系统 SHALL 支持标识店铺的主账号,通过 `is_primary` 字段区分。
|
||||
|
||||
#### Scenario: 创建店铺时标记主账号
|
||||
- **WHEN** 创建店铺时同步创建账号
|
||||
- **THEN** 该账号的 `is_primary` 字段设置为 `true`
|
||||
|
||||
#### Scenario: 查询店铺主账号
|
||||
- **WHEN** 查询代理商列表
|
||||
- **THEN** 可以关联查询每个店铺的主账号信息(用户名、手机号)
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 佣金记录店铺关联
|
||||
系统 SHALL 在佣金记录表中支持店铺关联:
|
||||
- 店铺ID(`shop_id`):佣金主要跟着店铺走
|
||||
- 入账后余额(`balance_after`):记录每次入账后的累计余额
|
||||
|
||||
#### Scenario: 创建佣金记录时关联店铺
|
||||
- **WHEN** 系统创建佣金记录
|
||||
- **THEN** 记录对应的店铺ID
|
||||
- **AND** 计算并记录入账后的佣金余额
|
||||
|
||||
#### Scenario: 按店铺查询佣金明细
|
||||
- **WHEN** 查询某店铺的佣金明细
|
||||
- **THEN** 可以直接通过 `shop_id` 字段过滤
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 提现设置每日限制
|
||||
系统 SHALL 支持配置每日提现次数限制,通过 `daily_withdrawal_limit` 字段。
|
||||
|
||||
#### Scenario: 配置每日提现次数
|
||||
- **WHEN** 管理员新增提现设置
|
||||
- **THEN** 可以设置每日提现次数限制
|
||||
|
||||
#### Scenario: 验证每日提现次数
|
||||
- **WHEN** 代理商发起提现申请
|
||||
- **THEN** 系统检查今日已提现次数是否超过限制
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 卡/设备店铺冗余字段
|
||||
系统 SHALL 在物联网卡表和设备表中支持店铺ID冗余字段(`shop_id`),方便数据权限过滤。
|
||||
|
||||
#### Scenario: 分配卡给代理商时设置 shop_id
|
||||
- **WHEN** 将卡从平台分配给代理商
|
||||
- **THEN** 设置卡的 `shop_id` 为目标店铺ID
|
||||
|
||||
#### Scenario: 代理商查询卡列表时按 shop_id 过滤
|
||||
- **WHEN** 代理商用户查询卡列表
|
||||
- **THEN** 系统使用 `shop_id` 字段进行数据权限过滤
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 企业卡授权表
|
||||
系统 SHALL 提供企业卡授权表(`tb_enterprise_card_authorization`),记录企业被授权可见的卡。
|
||||
|
||||
**核心设计**:
|
||||
- 卡的归属(owner)始终是代理商店铺,不会变成企业
|
||||
- 企业通过授权表"看到"被授权的卡
|
||||
- 授权是永久的,回收时更新 `status=0`
|
||||
|
||||
#### Scenario: 授权卡给企业
|
||||
- **WHEN** 代理商将卡授权给企业
|
||||
- **THEN** 创建授权记录,状态为有效(`status=1`)
|
||||
- **AND** 记录授权人和授权时间
|
||||
- **AND** 卡的 owner 不变,仍属于代理商
|
||||
|
||||
#### Scenario: 回收卡授权
|
||||
- **WHEN** 代理商回收企业的卡授权
|
||||
- **THEN** 更新授权记录状态为已回收(`status=0`)
|
||||
- **AND** 卡的 owner 不变
|
||||
|
||||
#### Scenario: 企业查询被授权的卡
|
||||
- **WHEN** 企业用户查询卡列表
|
||||
- **THEN** 系统通过授权表过滤,只返回被授权且有效的卡
|
||||
|
||||
---
|
||||
|
||||
### Requirement: 资产分配记录表
|
||||
系统 SHALL 提供资产分配记录表(`tb_asset_allocation_record`),记录卡/设备在平台和代理商之间的流转历史。
|
||||
|
||||
#### Scenario: 记录卡分配
|
||||
- **WHEN** 平台将卡分配给代理商
|
||||
- **THEN** 创建分配记录,类型为 `allocate`
|
||||
- **AND** 记录来源(平台)和目标(店铺)
|
||||
|
||||
#### Scenario: 记录卡回收
|
||||
- **WHEN** 从代理商回收卡到平台
|
||||
- **THEN** 创建分配记录,类型为 `recall`
|
||||
- **AND** 记录来源(店铺)和目标(平台)
|
||||
|
||||
#### Scenario: 查询资产流转历史
|
||||
- **WHEN** 查询某卡或设备的分配历史
|
||||
- **THEN** 返回完整的流转记录列表
|
||||
|
||||
---
|
||||
|
||||
### Requirement: owner_type 枚举统一
|
||||
系统 SHALL 统一卡/设备的 `owner_type` 枚举值:
|
||||
- `platform`:平台库存
|
||||
- `shop`:代理商持有
|
||||
|
||||
**废弃值**:
|
||||
- `agent`:改为 `shop`
|
||||
- `user`:不再使用
|
||||
- `device`:不再使用
|
||||
|
||||
#### Scenario: 迁移现有数据
|
||||
- **WHEN** 执行数据库迁移
|
||||
- **THEN** 将现有 `owner_type='agent'` 的记录更新为 `owner_type='shop'`
|
||||
|
||||
#### Scenario: 新数据使用统一枚举
|
||||
- **WHEN** 创建或更新卡/设备归属
|
||||
- **THEN** `owner_type` 只能是 `platform` 或 `shop`
|
||||
Reference in New Issue
Block a user