测试-建任务

建任务

所属执行

任务类型

父任务

指派给

多人任务

任务名称

日程规划

优先级

预计（单位：小时）

任务描述

<h3>功能说明</h3>
<p>实现短信资源管理页面，包括平台切换、服务商信息卡片、分配情况卡片、小区列表、预警条、搜索框，以及资源调整、调整历史、小区资源配置、配置历史、使用情况等弹框交互。</p>

<h3>文件位置</h3>
<ul>
  <li>页面组件: src/pages/sms-resource/index.tsx</li>
  <li>子组件: src/components/sms-resource/PlatformCard.tsx, AllocationCard.tsx, CommunityTable.tsx, Modals/*</li>
  <li>样式文件: src/pages/sms-resource/index.module.scss</li>
  <li>API调用: src/api/smsResource.ts</li>
</ul>

<h3>页面结构</h3>
<pre>
PageContainer
├── PlatformSelector (下拉搜索)
├── AlertBar (低库存预警)
├── ProviderCard (服务商信息)
├── AllocationCard (剩余可分配/已分配未使用)
├── SearchBar (按小区名称)
└── CommunityTable (列表)
    └── Actions: 资源配置/配置历史/使用情况/资源调整历史
Modals
├── PlatformAdjustModal
├── PlatformAdjustHistoryModal
├── CommunityAllocateModal (二次确认)
├── CommunityAllocateHistoryModal
└── CommunityUsageModal
</pre>

<h3>依赖的API接口</h3>
<table border="1" cellpadding="6" cellspacing="0" width="100%">
  <thead><tr style="background:#f2f2f2"><th>功能</th><th>方式</th><th>接口路径</th></tr></thead>
  <tbody>
    <tr><td>平台概览</td><td>GET</td><td>/api/v1/sms/platforms/overview</td></tr>
    <tr><td>平台调整</td><td>POST</td><td>/api/v1/sms/platform/adjust</td></tr>
    <tr><td>调整历史</td><td>GET</td><td>/api/v1/sms/platform/adjust/history</td></tr>
    <tr><td>小区列表</td><td>GET</td><td>/api/v1/sms/communities</td></tr>
    <tr><td>小区配置</td><td>POST</td><td>/api/v1/sms/community/{id}/allocate</td></tr>
    <tr><td>配置历史</td><td>GET</td><td>/api/v1/sms/community/{id}/allocations</td></tr>
    <tr><td>使用情况</td><td>GET</td><td>/api/v1/sms/community/{id}/usage</td></tr>
  </tbody>
</table>

<h3>类型定义</h3>
<pre>
interface PlatformOverview { id: number; name: string; providerName: string; remainCount: number; allocatedUnused: number; allocatable: number; }
interface CommunityItem { id: number; name: string; remain: number; usedTotal: number; usedMonth: number; createdAt: string; }
interface AdjustForm { adjustType: number; adjustAmount: number; remark?: string; }
interface AllocateForm { mode: number; amount?: number; smsCount?: number; convertRatio: number; finalSmsCount?: number; finalAmount?: number; validRange?: [string, string]; remark?: string; }
</pre>

<h3>状态管理</h3>
<ul>
  <li>loading: 页面/弹框加载状态</li>
  <li>platforms/currentPlatform: 平台数据</li>
  <li>alertLowCount: 低库存数量</li>
  <li>communityList/pagination: 小区列表与分页</li>
  <li>modalVisible & modalForm: 各弹框显隐与表单数据</li>
</ul>

<h3>交互逻辑</h3>
<ol>
  <li>页面加载：获取平台概览，默认首个平台并请求小区列表</li>
  <li>切换平台：更新当前平台，重新拉取卡片与列表</li>
  <li>搜索：输入名称点击查询，重置恢复</li>
  <li>预警：根据lowStockCount显示顶部提示</li>
  <li>资源调整：打开弹框校验必填，提交后刷新概览与列表；历史弹框分页展示</li>
  <li>小区资源配置：弹框展示小区名不可编辑；按金额/条数自动换算四舍五入，可手动修改后提交；提交前二次确认文案；成功后刷新卡片、列表与历史</li>
  <li>配置历史/使用情况：按小区打开对应弹框分页查询</li>
</ol>

<h3>表单字段</h3>
<table border="1" cellpadding="6" cellspacing="0" width="100%">
  <thead><tr style="background:#f2f2f2"><th>字段名</th><th>类型</th><th>必填</th><th>校验规则</th><th>说明</th></tr></thead>
  <tbody>
    <tr><td>adjustType</td><td>Select</td><td>是</td><td>必选</td><td>增加/减少</td></tr>
    <tr><td>adjustAmount</td><td>InputNumber</td><td>是</td><td>正整数</td><td>调整数量</td></tr>
    <tr><td>mode</td><td>Radio</td><td>是</td><td>必选</td><td>按金额/按条数</td></tr>
    <tr><td>amount</td><td>InputNumber</td><td>mode=1</td><td>正数</td><td>分配金额</td></tr>
    <tr><td>smsCount</td><td>InputNumber</td><td>mode=2</td><td>正整数</td><td>分配条数</td></tr>
    <tr><td>convertRatio</td><td>InputNumber</td><td>是</td><td>正数</td><td>转换系数</td></tr>
    <tr><td>validRange</td><td>DateRangePicker</td><td>否</td><td>-</td><td>有效期限，默认长期</td></tr>
  </tbody>
</table>

<h3>验收标准</h3>
<ul>
  <li>页面默认首个平台数据渲染，切换后同步更新</li>
  <li>预警条在存在低库存时显示正确数量</li>
  <li>表单校验符合必填与正数要求，二次确认文案展示</li>
  <li>分配/调整后卡片与列表刷新一致，历史/使用弹框数据完整</li>
</ul>

添加之后

返回任务列表

返回研发需求列表

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

所属模块

所有模块