测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

## 功能说明
提供平台层短信资源查询、调整与调整历史查询接口，支持切换平台查看与调整记录留痕。

## 文件位置
- Controller: src/controller/smsPlatformController.ts
- Service: src/service/smsPlatformService.ts
- Model: src/model/smsPlatformModel.ts

## 接口定义
- 请求方式: GET
  - 请求路径: /api/v1/sms/platforms
  - 请求参数: 无
  - 响应格式:
    ```json
    {"code":200,"data":[{"platformId":1,"platformName":"平台A","providerName":"供应商","remainingCount":5000,"warningThreshold":1000}],"message":"success"}
    ```
- 请求方式: GET
  - 请求路径: /api/v1/sms/platform/:platformId/overview
  - 请求参数: path platformId:number
  - 响应格式:
    ```json
    {"code":200,"data":{"platformId":1,"platformName":"平台A","providerName":"供应商","remainingCount":5000,"allocatedUnused":1200,"availableForAllocate":3800},"message":"success"}
    ```
- 请求方式: POST
  - 请求路径: /api/v1/sms/platform/:platformId/adjust
  - 请求参数:
    ```json
    {"adjustType":1,"changeCount":5000,"remark":"补充"}
    ```
  - 响应格式:
    ```json
    {"code":200,"data":{"before":5000,"after":10000},"message":"success"}
    ```
- 请求方式: GET
  - 请求路径: /api/v1/sms/platform/:platformId/adjust/history
  - 请求参数: query page:number=1, pageSize:number=20
  - 响应格式:
    ```json
    {"code":200,"data":{"list":[{"id":1,"adjustType":1,"changeCount":5000,"beforeCount":5000,"afterCount":10000,"operator":"ops","remark":"补充","createdAt":"2024-09-01 10:00:00"}],"total":1},"message":"success"}
    ```

## 数据库操作
- 涉及表: sms_platform_resource, sms_platform_adjust_log, sms_community_quota
- SQL示例:
  - 查询平台列表: SELECT id AS platformId, platform_name, provider_name, remaining_count, warning_threshold FROM sms_platform_resource;
  - 计算已分配未使用: SELECT SUM(allocated_total - used_count) FROM sms_community_quota WHERE platform_id=?;
  - 调整更新: UPDATE sms_platform_resource SET remaining_count = remaining_count + ? WHERE platform_id=?;
  - 记录日志: INSERT INTO sms_platform_adjust_log(...);

## 业务逻辑
1. 参数校验: adjustType∈{1,2}; changeCount>0; platformId存在。
2. 权限检查: 需运营角色(示例: hasRole('ops_sms')).
3. 数据处理:
   - overview: 查询平台资源; 计算已分配未使用=Σ(allocated_total-used_count); 剩余可分配=remaining-已分配未使用。
   - adjust: 根据类型增加/减少remaining_count；记录before/after；写入日志；返回新值。
   - history: 分页查询sms_platform_adjust_log按时间倒序。
4. 返回结果: 统一code/message格式，data含计算值。

## 错误处理
- 400: 参数错误 - adjustType非法或changeCount<=0
- 403: 无权限 - 非运营角色
- 404: 数据不存在 - platformId无记录
- 409: 余额不足 - 减少且平台剩余不足

## 验收标准
- [ ] 接口能正常调用并返回预期数据
- [ ] 参数校验正确
- [ ] 错误处理完善

添加之后

返回任务列表

返回研发需求列表

继续为该研发需求添加任务

所属模块

所有模块