[后端] 平台资源调整与历史接口开发 109
任务名称
任务描述

功能说明

实现平台资源调整(增加/减少)接口及调整历史查询接口,支持记录前后数量、操作人、备注并更新平台剩余条数。

文件位置

  • 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历史)

请求参数

参数名类型必填说明
platformIdnumber平台ID
adjustTypenumber1增加 2减少
adjustAmountnumber正整数调整数量
remarkstring备注
page/pageSize (GET)number分页参数

响应格式

{
  "code":200,
  "data":{
    "afterCount":15000,
    "beforeCount":10000
  },
  "message":"success"
}

业务逻辑

  1. 参数校验:adjustType必填且为1/2;adjustAmount为正整数;平台存在性校验
  2. 权限检查:需具备平台资源调整权限
  3. 数据处理:读取当前剩余,按类型加减;写入sms_platform_adjust_log记录前后值、操作人;更新sms_platform.remain_count;返回更新结果
  4. 历史查询:按platformId分页倒序返回调整记录

错误处理

400参数错误缺少平台ID或调整数量非正数
403无权限无资源调整权限
404数据不存在平台不存在

验收标准

  • 必填校验生效,未填不可提交
  • 增加5000后平台剩余+5000并记录日志
  • 历史列表字段完整含前后数量、操作人、备注
相关研发需求
附件
基本信息
所属执行
所属模块
父任务
任务模式
指派给
任务类型
任务状态
优先级
进度
关键词
抄送给
工时信息
预计开始
截止日期
最初预计
h
总计消耗
0.00h
预计剩余
h
任务的一生
实际开始
由谁完成
实际完成
由谁取消
取消时间
由谁关闭
关闭原因
关闭时间