测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3>
<p>提供小区短信发送使用明细查询接口，展示推送时间、名称、内容、状态、成功/失败数，支持分页，供前端弹框使用。</p>

<h3>文件位置</h3>
<ul>
  <li>Controller: src/controller/smsUsageController.ts</li>
  <li>Service: src/service/smsUsageService.ts</li>
  <li>Model: src/model/smsUsageLog.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/community/{id}/usage</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>id</td><td>number</td><td>是</td><td>小区ID</td></tr>
    <tr><td>page/pageSize</td><td>number</td><td>否</td><td>分页</td></tr>
  </tbody>
</table>

<h4>响应格式</h4>
<pre>{
  "code":200,
  "data":{
    "list":[{"pushTime":"2024-03-01 10:00","pushName":"营销短信","content":"xxx","status":1,"successCount":900,"failCount":100}],
    "total":1
  },
  "message":"success"
}</pre>

<h3>业务逻辑</h3>
<ol>
  <li>参数校验：id为正整数；分页默认page=1,pageSize=20</li>
  <li>权限检查：需具备小区使用记录查看权限</li>
  <li>数据处理：查询sms_usage_log按push_time倒序；返回推送时间、名称、内容、状态、成功/失败数</li>
  <li>返回结果：列表和总数供前端分页</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>分页生效，排序按推送时间倒序</li>
  <li>异常参数时返回对应错误</li>
</ul>

添加之后

返回任务列表

返回研发需求列表

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

所属模块

所有模块