功能说明
实现平台资源调整(增加/减少)接口及调整历史查询接口,支持记录前后数量、操作人、备注并更新平台剩余条数。
文件位置
- Controller: src/controller/smsPlatformAdjustController.ts
- Service: src/service/smsPlatformAdjustService.ts
- Model: src/model/smsPlatformAdjustLog.ts
接口定义
| 请求方式 | POST / GET |
| 请求路径 | /api/v1/sms/platform/adjust (POST提交调整); /api/v1/sms/platform/adjust/history (GET历史) |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
| platformId | number | 是 | 平台ID |
| adjustType | number | 是 | 1增加 2减少 |
| adjustAmount | number | 是 | 正整数调整数量 |
| remark | string | 否 | 备注 |
| page/pageSize (GET) | number | 否 | 分页参数 |
响应格式
{
"code":200,
"data":{
"afterCount":15000,
"beforeCount":10000
},
"message":"success"
}
业务逻辑
- 参数校验:adjustType必填且为1/2;adjustAmount为正整数;平台存在性校验
- 权限检查:需具备平台资源调整权限
- 数据处理:读取当前剩余,按类型加减;写入sms_platform_adjust_log记录前后值、操作人;更新sms_platform.remain_count;返回更新结果
- 历史查询:按platformId分页倒序返回调整记录
错误处理
| 400 | 参数错误 | 缺少平台ID或调整数量非正数 |
| 403 | 无权限 | 无资源调整权限 |
| 404 | 数据不存在 | 平台不存在 |
验收标准
- 必填校验生效,未填不可提交
- 增加5000后平台剩余+5000并记录日志
- 历史列表字段完整含前后数量、操作人、备注