测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3>
<p>提供小区资源配置提交接口（按金额/按条数、转换系数换算、二次确认）及配置历史查询接口，更新平台可分配/已分配未使用与小区剩余，同时记录历史。</p>

<h3>文件位置</h3>
<ul>
  <li>Controller: src/controller/smsCommunityAllocateController.ts</li>
  <li>Service: src/service/smsCommunityAllocateService.ts</li>
  <li>Model: src/model/smsCommunityAllocateLog.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/community/{id}/allocate (POST); /api/v1/sms/community/{id}/allocations (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>id</td><td>number</td><td>是</td><td>路径参数，小区ID</td></tr>
    <tr><td>mode</td><td>number</td><td>是</td><td>1按金额 2按条数</td></tr>
    <tr><td>amount</td><td>number</td><td>mode=1必填</td><td>分配金额，正数</td></tr>
    <tr><td>smsCount</td><td>number</td><td>mode=2必填</td><td>分配条数，正整数</td></tr>
    <tr><td>convertRatio</td><td>number</td><td>是</td><td>转换系数，正数</td></tr>
    <tr><td>finalSmsCount</td><td>number</td><td>否</td><td>可编辑后的最终条数，默认换算值四舍五入</td></tr>
    <tr><td>finalAmount</td><td>number</td><td>否</td><td>可编辑后的最终金额，默认换算值四舍五入</td></tr>
    <tr><td>validFrom/validTo</td><td>string</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":{
    "communityRemain":1500,
    "platformAllocatable":9000,
    "platformAllocatedUnused":3000
  },
  "message":"success"
}</pre>

<h3>业务逻辑</h3>
<ol>
  <li>参数校验：mode必填，金额/条数/转换系数为正数；小区与平台存在性校验；剩余可分配校验（不可超额）</li>
  <li>权限检查：需具备小区资源配置权限</li>
  <li>数据处理：按模式换算对应条数或金额，四舍五入整数，可被final值覆盖；二次确认逻辑由前端触发；更新小区剩余+分配条数，平台可分配-分配条数，已分配未使用+分配条数；写入sms_community_allocate_log含原/现剩余、有效期、备注</li>
  <li>历史查询：按小区ID倒序返回所有配置记录字段完整</li>
</ol>

<h3>错误处理</h3>
<table border="1" cellpadding="6" cellspacing="0">
  <tr><td>400</td><td>参数错误</td><td>未选分配方式或金额/条数/转换系数非正数</td></tr>
  <tr><td>400</td><td>资源不足</td><td>平台可分配不足</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>按金额100元、系数0.1自动算1000条；按条数500、系数0.1算50元</li>
  <li>成功分配1000条后，小区剩余+1000，平台可分配-1000，已分配未使用+1000</li>
  <li>历史记录新增且字段完整</li>
</ul>

添加之后

返回任务列表

返回研发需求列表

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

所属模块

所有模块