测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3>
<p>实现平台资源调整（增加/减少）接口及调整历史查询接口，支持记录前后数量、操作人、备注并更新平台剩余条数。</p>

<h3>文件位置</h3>
<ul>
  <li>Controller: src/controller/smsPlatformAdjustController.ts</li>
  <li>Service: src/service/smsPlatformAdjustService.ts</li>
  <li>Model: src/model/smsPlatformAdjustLog.ts</li>
</ul>

<h3>接口定义</h3>
<table border="1" cellpadding="6" cellspacing="0">
  <tr><td>请求方式</td><td>POST / GET</td></tr>
  <tr><td>请求路径</td><td>/api/v1/sms/platform/adjust (POST提交调整); /api/v1/sms/platform/adjust/history (GET历史)</td></tr>
</table>

<h4>请求参数</h4>
<table border="1" cellpadding="6" cellspacing="0" width="100%">
  <thead><tr style="background:#f2f2f2"><th>参数名</th><th>类型</th><th>必填</th><th>说明</th></tr></thead>
  <tbody>
    <tr><td>platformId</td><td>number</td><td>是</td><td>平台ID</td></tr>
    <tr><td>adjustType</td><td>number</td><td>是</td><td>1增加 2减少</td></tr>
    <tr><td>adjustAmount</td><td>number</td><td>是</td><td>正整数调整数量</td></tr>
    <tr><td>remark</td><td>string</td><td>否</td><td>备注</td></tr>
    <tr><td>page/pageSize (GET)</td><td>number</td><td>否</td><td>分页参数</td></tr>
  </tbody>
</table>

<h4>响应格式</h4>
<pre>{
  "code":200,
  "data":{
    "afterCount":15000,
    "beforeCount":10000
  },
  "message":"success"
}</pre>

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

<h3>错误处理</h3>
<table border="1" cellpadding="6" cellspacing="0">
  <tr><td>400</td><td>参数错误</td><td>缺少平台ID或调整数量非正数</td></tr>
  <tr><td>403</td><td>无权限</td><td>无资源调整权限</td></tr>
  <tr><td>404</td><td>数据不存在</td><td>平台不存在</td></tr>
</table>

<h3>验收标准</h3>
<ul>
  <li>必填校验生效，未填不可提交</li>
  <li>增加5000后平台剩余+5000并记录日志</li>
  <li>历史列表字段完整含前后数量、操作人、备注</li>
</ul>

添加之后

返回任务列表

返回研发需求列表

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

所属模块

所有模块