## 功能说明 提供平台层短信资源查询、调整与调整历史查询接口，支持切换平台查看与调整记录留痕。 ## 文件位置 - Controller: src/controller/smsPlatformController.ts - Service: src/service/smsPlatformService.ts - Model: src/model/smsPlatformModel.ts ## 接口定义 - 请求方式: GET - 请求路径: /api/v1/sms/platforms - 请求参数: 无 - 响应格式: ```json {"code":200,"data":[{"platformId":1,"platformName":"平台A","providerName":"供应商","remainingCount":5000,"warningThreshold":1000}],"message":"success"} ``` - 请求方式: GET - 请求路径: /api/v1/sms/platform/:platformId/overview - 请求参数: path platformId:number - 响应格式: ```json {"code":200,"data":{"platformId":1,"platformName":"平台A","providerName":"供应商","remainingCount":5000,"allocatedUnused":1200,"availableForAllocate":3800},"message":"success"} ``` - 请求方式: POST - 请求路径: /api/v1/sms/platform/:platformId/adjust - 请求参数: ```json {"adjustType":1,"changeCount":5000,"remark":"补充"} ``` - 响应格式: ```json {"code":200,"data":{"before":5000,"after":10000},"message":"success"} ``` - 请求方式: GET - 请求路径: /api/v1/sms/platform/:platformId/adjust/history - 请求参数: query page:number=1, pageSize:number=20 - 响应格式: ```json {"code":200,"data":{"list":[{"id":1,"adjustType":1,"changeCount":5000,"beforeCount":5000,"afterCount":10000,"operator":"ops","remark":"补充","createdAt":"2024-09-01 10:00:00"}],"total":1},"message":"success"} ``` ## 数据库操作 - 涉及表: sms_platform_resource, sms_platform_adjust_log, sms_community_quota - SQL示例: - 查询平台列表: SELECT id AS platformId, platform_name, provider_name, remaining_count, warning_threshold FROM sms_platform_resource; - 计算已分配未使用: SELECT SUM(allocated_total - used_count) FROM sms_community_quota WHERE platform_id=?; - 调整更新: UPDATE sms_platform_resource SET remaining_count = remaining_count + ? WHERE platform_id=?; - 记录日志: INSERT INTO sms_platform_adjust_log(...); ## 业务逻辑 1. 参数校验: adjustType∈{1,2}; changeCount>0; platformId存在。 2. 权限检查: 需运营角色(示例: hasRole('ops_sms')). 3. 数据处理: - overview: 查询平台资源; 计算已分配未使用=Σ(allocated_total-used_count); 剩余可分配=remaining-已分配未使用。 - adjust: 根据类型增加/减少remaining_count；记录before/after；写入日志；返回新值。 - history: 分页查询sms_platform_adjust_log按时间倒序。 4. 返回结果: 统一code/message格式，data含计算值。 ## 错误处理 - 400: 参数错误 - adjustType非法或changeCount<=0 - 403: 无权限 - 非运营角色 - 404: 数据不存在 - platformId无记录 - 409: 余额不足 - 减少且平台剩余不足 ## 验收标准 - [ ] 接口能正常调用并返回预期数据 - [ ] 参数校验正确 - [ ] 错误处理完善