功能说明
构建运营平台短信资源管理页面:平台选择、资源调整/历史、小区列表、配置/历史/使用弹窗、低库存预警。校验与二次确认。
关联任务
- 依赖后端任务:[后端] 短信资源管理-数据库与接口开发 - /api/sms/*
- 关联测试任务:[测试-前端] 短信资源管理前端测试
接口对接(来自后端任务)
| 接口 | 参数对接 | 响应字段用途 |
|---|
| GET /api/sms/platforms | keyword←平台下拉搜索 | name→下拉, id→后续请求 |
| GET /api/sms/platform/{id}/summary | id←下拉选中 | remain→服务商卡片, allocatable→分配卡片 |
| GET /api/sms/communities | platformId←下拉, name←搜索框 | 列表列: name, remain, usedTotal, usedMonth |
| POST /api/sms/platform/adjust | type, amount, remark←资源调整弹窗 | 返回最新剩余用于刷新 |
| POST /api/sms/community/allocate | communityId, mode, amount, rate, mappedValue, expire, remark←配置弹窗 | 返回最新平台/小区剩余 |
| GET /api/sms/history | platformId/ communityId | 表格展示历史 |
页面结构
Page
├── PlatformSelect (searchable)
├── WarningBar (低于1000提示)
├── Cards: ServiceProvider, Allocation
├── SearchInput[communityName]
└── Table[communities]
├── Column[name]
├── Column[remain] (高亮<1000)
├── Column[usedTotal/usedMonth]
└── Column[操作:配置/历史/使用]
Modals: 平台资源调整/历史,小区配置/历史/使用控件交互逻辑
| 控件 | 事件 | 行为 | 调用接口 |
|---|
| 平台下拉 | change | 刷新卡片+列表 | GET summary, GET communities |
| 小区搜索 | input/enter | 过滤列表 | GET communities |
| 资源调整提交 | confirm | 校验正数+提交 | POST platform/adjust |
| 小区配置提交 | 二次确认后提交 | 换算四舍五入+校验 | POST community/allocate |
| 历史/使用按钮 | click | 拉取弹窗数据 | GET history |
条件渲染
| 元素 | 显示条件 | 数据来源 |
|---|
| 预警条 | lowCount>0 | summary.lowCount |
| 剩余高亮 | remain<1000 | 行数据 |