# 运营平台的短信资源管理 ## 基本信息 - **需求ID**: 137 - **需求名称**: 运营平台的短信资源管理 - **需求类型**: 软件需求 (story) - **优先级**: 2 - **产品**: 幸福家园 - **所属模块**: 消息推送（系统）/短信服务 - **状态**: 激活 (active) - **当前阶段**: 预计中 (projected) ## 关联信息 - **父需求**: #140 系统消息推送 (用户需求) - **指派给**: 邹鹏 (zhoup) - **创建人**: 卓泽敏 (zhuozemin) - **创建时间**: 2025-11-04 10:56:48 - **指派时间**: 2025-11-17 03:24:05 - **验收计划**: 11月28号开发完成，12月5号上线 - **关联任务**: #59 运营平台的短信资源管理 (开发中) ## 需求详细描述 ### 相关链接 - **原型链接**: https://axhub.im/ax9/14c228b50b05a716/#g=1&id=elt036&p=%E7%9F%AD%E4%BF%A1%E6%9C%8D%E5%8A%A1 - **Readdy设计稿**: https://readdy.link/share/740bd25910c6955ba0a3552c950e99d2 ### 需求整合 #### 1. 核心功能：短信服务管理 **目标**: 实现对平台下各小区的短信资源进行统一分配和管理。 **主要内容**: 1. **平台维度数据展示**: - **服务商信息**: 显示当前平台配置的短信服务商名称、接口获取的剩余条数。当服务商剩余条数低于1000条时，系统需进行告警提示。 - **分配情况**: - **剩余可分配条数**: 计算公式为 `服务商剩余条数 - 各小区已分配且未使用的总条数` - **已分配且未使用**: 所有小区 `(已分配总条数 - 已使用总条数)` 的累加值 2. **小区维度列表展示**: - **列表范围**: 默认展示平台下的所有小区，按小区创建时间倒序排列 - **列表字段**: 小区名称、剩余条数、历史使用（总计、本月） - **操作功能**: 资源配置、配置历史、使用情况 3. **页面功能**: - **平台切换**: 支持通过下拉列表搜索并切换不同平台 - **条件查询**: 支持按小区名称进行搜索筛选 - **资源预警**: 当系统检测到有小区剩余资源不足1000条时，需在页面顶部提示"检测到n个小区资源不足1000条，请及时补充" - **资源调整**: 支持调整运营平台的短信资源条数，可以增加或减少资源 #### 2. 核心功能：资源配置（弹框） **目标**: 为指定小区分配短信资源。 **主要内容**: 1. **分配方式**: 支持"按金额分配"和"按条数分配"两种方式，金额和条数可根据"转换系数"相互换算 - **计算公式**: - `对应条数 = 分配金额 * 转换系数`（结果四舍五入取整） - `对应金额 = 分配条数 / 转换系数` 2. **表单字段**: 小区名称（自动带入）、分配方式、分配金额/条数、转换系数、对应条数/金额、有效期限（非必填，默认为长期有效）、备注 3. **提交流程**: - 点击"确认分配"后，系统需弹窗提示："请确认后再提交，提交后无法修改及退款" - 确认后，系统需更新该小区的可用短信条数，同时更新平台维度的"剩余可分配条数"和"已分配且未使用"数据，并生成一条配置历史记录 4. **使用规则**: 小区在使用短信时，优先消耗有效期较短的资源 #### 3. 核心功能：配置历史与使用情况（弹框） - **配置历史记录**: 以列表形式展示对该小区的每一笔资源配置操作，包含操作时间、分配方式、分配条数、支付金额、转换系数、原剩余/现剩余条数、有效期及备注 - **短信使用情况**: 以列表形式展示该小区的所有短信推送记录，包含推送时间、推送名称、内容、状态及成功/失败的接收人数 #### 4. 核心功能：资源调整（运营平台） **目标**: 支持运营平台直接调整短信资源条数。 **主要内容**: 1. **资源调整功能**: - **调整方式**: 支持增加或减少短信资源条数 - **调整表单**: 包含调整原因、调整前条数、调整后条数、调整条数（正数为增加，负数为减少） - **权限控制**: 仅特定角色可进行资源调整操作 - **提交流程**: 调整前需二次确认，确认后更新系统数据 2. **调整历史记录**: - **列表展示**: 以列表形式展示运营平台的所有资源调整历史 - **列表字段**: 调整时间、操作人员、调整原因、调整前条数、调整后条数、调整条数、状态 - **筛选功能**: 支持按时间范围、操作人员、调整类型（增加/减少）进行筛选 3. **资源数据同步**: - **实时更新**: 资源调整后，同步更新平台维度的剩余可分配条数 - **影响计算**: 影响各小区的剩余条数计算逻辑（从资源调整弹框设置的数据获取，会根据使用的实际情况扣除剩余条数） ## 验收标准 ### AP-1：短信服务管理页面 1. **数据展示**: 页面加载后，正确展示默认平台的服务商信息和资源分配情况 2. **数据计算**: "剩余可分配条数"和"已分配且未使用"的数值根据指定公式正确计算 3. **告警提示**: 当服务商或小区的剩余短信条数低于1000条时，页面需有明确的告警提示（服务商信息处高亮，页面顶部横幅提示） 4. **列表功能**: 小区列表默认按创建时间倒序排列，并支持按小区名称正确筛选 5. **交互响应**: 点击"资源配置"、"配置历史"、"使用情况"按钮，能正常弹出对应的功能弹框 6. **资源调整功能**: 页面上新增"资源调整"按钮，点击可弹出资源调整弹框 ### AP-2：资源配置弹框 1. **分配换算**: 支持"按金额"和"按条数"两种分配方式，金额与条数能根据转换系数自动、正确地相互换算 2. **默认逻辑**: 若不填写有效期，该笔分配记录的有效期默认为"长期有效" 3. **提交流程**: 提交分配时，需有二次确认弹框；确认后，系统需正确更新相关数据（小区余量、平台数据），并生成配置历史 ### AP-3：资源调整弹框 1. **调整功能**: 支持增加或减少短信资源条数，调整表单包含必要字段 2. **数据同步**: 调整后正确更新平台的剩余可分配条数 3. **历史记录**: 每次调整操作都生成对应的历史记录 4. **剩余条数逻辑**: 各小区的剩余条数从资源调整设置的数据获取，根据使用实际情况扣除 ### AP-4：配置历史与使用情况 1. **历史记录**: "配置历史"弹框能以列表形式正确、完整地展示所有历史分配记录 2. **使用明细**: "短信使用情况"弹框能以列表形式正确、完整地展示所有短信发送记录 3. **调整历史**: "资源调整历史"弹框能以列表形式正确、完整地展示运营平台的所有资源调整记录 4. **扣费规则**: 小区在使用短信资源时，遵循"优先消耗有效期短的资源"的规则 ## 需求状态变更历史 - 2025-11-04: 创建需求 - 2025-11-05: 调整父需求和阶段 - 2025-11-07: 调整所属计划 - 2025-11-13: 完善需求描述和验收标准 - 2025-11-17: 通过评审，状态转为激活，指派给邹鹏 - 2025-11-19: 关联到项目"幸福家园"和迭代"开发-25年11月第4周" - 2025-11-20: 根据需求调整，更新了需求内容，作废账户余额及资源有效期，修改剩余条数获取逻辑，增加资源调整功能