功能说明
为运营平台提供短信资源池管理：平台资源调整、分配计算、预警、小区分配/历史/使用明细查询。需先核对现有代码规范与错误码表。
关联任务
- 关联前端任务：[前端] 短信资源管理页面开发
- 关联测试任务：[测试-后端] 短信资源管理后端测试
接口定义
| 请求方式 | GET |
| 请求路径 | /api/sms/platforms |
请求参数（前端对接用）
| 参数名 | 类型 | 必填 | 说明 | 前端来源 |
|---|---|---|---|---|
| keyword | string | 否 | 平台名称搜索 | 平台下拉搜索 |
响应字段（前端展示用）
| 字段名 | 类型 | 说明 | 前端用途 |
|---|---|---|---|
| id | number | 平台ID | 后续接口参数 |
| name | string | 平台名称 | 下拉展示 |
业务逻辑
- 参数校验（正数、必填、分页）
- 权限检查（平台资源查看/操作）
- 数据处理：计算剩余可分配=剩余-已分配未使用；统计小区低于1000数量；四舍五入换算；调整/分配写历史。
- 返回结果：统一错误码、分页结构。
错误处理（使用系统错误码）
| 错误码 | 场景 | 前端提示 |
|---|---|---|
| E_PARAM | 参数缺失/非正数 | 参数错误 |
| E_PERM | 无操作权限 | 无权限 |
| E_NOT_FOUND | 平台/小区不存在 | 数据不存在 |
| E_CONFLICT | 平台剩余不足 | 剩余不足 |