测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3>
<p>提供平台列表、默认首个平台加载，以及单个平台服务商信息、剩余条数、可分配条数、已分配未使用等资源概览查询接口，支撑页面平台切换与顶部卡片展示。</p>

<h3>文件位置</h3>
<ul>
  <li>Controller: src/controller/smsPlatformController.ts</li>
  <li>Service: src/service/smsPlatformService.ts</li>
  <li>Model: src/model/smsPlatform.ts</li>
</ul>

<h3>接口定义</h3>
<table border="1" cellpadding="6" cellspacing="0">
  <tr><td>请求方式</td><td>GET</td></tr>
  <tr><td>请求路径</td><td>/api/v1/sms/platforms/overview</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>不传则默认返回首个平台数据</td></tr>
  </tbody>
</table>

<h4>响应格式</h4>
<pre>{
  "code": 200,
  "data": {
    "platforms": [{"id":1,"name":"平台A"}],
    "current": {
      "id":1,
      "name":"平台A",
      "providerName":"XX服务商",
      "remainCount":12000,
      "allocatedUnused":2000,
      "allocatable":10000
    }
  },
  "message": "success"
}</pre>

<h3>业务逻辑</h3>
<ol>
  <li>参数校验：platformId如传入需为正整数</li>
  <li>权限检查：校验用户是否有平台资源查看权限</li>
  <li>数据处理：查询平台列表按创建时间，选择首个或指定平台；聚合该平台下小区已分配未使用=SUM(已分配-已使用)；可分配=平台剩余-已分配未使用；返回服务商名称与资源概览</li>
  <li>返回结果：含平台列表、当前平台概览数据</li>
</ol>

<h3>错误处理</h3>
<table border="1" cellpadding="6" cellspacing="0">
  <tr><td>400</td><td>参数错误</td><td>platformId非正整数</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>默认不传platformId时返回首个平台及概览</li>
  <li>切换platformId返回对应概览，计算逻辑与需求一致</li>
  <li>异常参数与无权限时返回对应错误码</li>
</ul>

添加之后

返回任务列表

返回研发需求列表

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

所属模块

所有模块