测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3>
<p>提供按平台切换、按名称搜索、按创建时间倒序的小区资源列表接口，返回剩余条数、历史使用总计、本月使用以及低库存统计用于顶部预警。</p>

<h3>文件位置</h3>
<ul>
  <li>Controller: src/controller/smsCommunityController.ts</li>
  <li>Service: src/service/smsCommunityService.ts</li>
  <li>Model: src/model/smsCommunity.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/communities</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>keyword</td><td>string</td><td>否</td><td>小区名称模糊匹配</td></tr>
    <tr><td>page/pageSize</td><td>number</td><td>否</td><td>分页</td></tr>
  </tbody>
</table>

<h4>响应格式</h4>
<pre>{
  "code":200,
  "data":{
    "list":[{"id":1,"name":"小区A","remain":900,"usedTotal":2000,"usedMonth":300,"createdAt":"2024-03-01"}],
    "lowStockCount":1,
    "total":1
  },
  "message":"success"
}</pre>

<h3>业务逻辑</h3>
<ol>
  <li>参数校验：platformId必填正整数；分页默认page=1,pageSize=20</li>
  <li>权限检查：需具备查看该平台下小区资源权限</li>
  <li>数据处理：查询平台下小区按创建时间倒序；按名称过滤；统计剩余<1000的小区数量；返回列表含剩余、本月/历史使用</li>
  <li>返回结果：列表、分页、lowStockCount用于预警提示</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>列表按创建时间倒序</li>
  <li>搜索后仅返回匹配名称的小区</li>
  <li>lowStockCount准确统计剩余<1000</li>
</ul>

添加之后

返回任务列表

返回研发需求列表

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

所属模块

所有模块