需求描述 (PRD)

1. 功能总览

本需求旨在为运营平台提供一个短信资源管理功能，实现对旗下各小区短信资源的统一分配、监控和调整。平台可以管理自身的短信总额度，并将额度分配给具体小区。同时，提供详细的分配历史、使用记录查询，并建立资源预警机制。

- 原型链接: 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

2. 主要功能模块

2.1 短信资源管理主界面

此界面是功能的核心视图，集中展示平台和各小区的短信资源状态。

页面布局与字段：

• 平台切换：

  • 提供下拉列表，支持搜索，可切换不同平台。

  • 默认选中平台列表的第一项。

• 服务商信息 (当前平台)：

  • 服务商名称：从推送渠道配置中获取。

  • 剩余条数：由运营在"资源调整"弹框中手动设置和更新。当此数值小于1000条时，以告警样式（如红色字体）突出显示。

  • 作废字段：账户余额、有效期，不再从服务商接口获取。

• 分配情况 (当前平台)：

  • 剩余可分配条数：计算公式为 平台剩余条数 - 已分配且未使用条数。

  • 已分配且未使用条数：计算公式为 SUM(所有小区的已分配条数 - 所有小区的已使用条数)。

• 小区列表：

  • 数据范围： 展示当前平台下的所有小区，按小区创建时间的倒序排列。

  • 列表字段：

    • 小区名称：小区的简称。

    • 剩余条数：小区当前可用的短信总数。

    • 历史使用：分为"总计"和"本月"两个维度，分别统计小区历史总使用量和当月使用量。

    • 操作列：

      • 资源配置：点击打开为该小区分配资源的弹框。

      • 配置历史：点击打开该小区的资源分配历史记录弹框。

      • 使用情况：点击打开该小区的短信发送记录弹框。

主要功能：

• 小区查询： 支持按小区名称进行搜索和筛选。

• 资源预警： 当有小区剩余条数低于1000条时，页面顶部出现提示："检测到n个小区资源不足1000条，请及时补充"。

• 资源调整： 平台运营人员可调整自身的短信资源总量（见2.2模块）。

2.2 平台资源调整与历史记录 (弹框)

运营平台用此功能来更新自身的短信资源总额。

资源调整弹框：

• 调整类型：（必填）单选，"增加资源" / "减少资源"。

• 调整数量：（必填）正整数。

• 备注：（非必填）文本输入。

• 提交逻辑： 提交后，根据所选类型对平台的"剩余条数"进行加减。

资源调整历史弹框：

• 以列表形式展示所有平台层面的资源调整记录。

• 列表字段： 调整时间、调整类型、调整数量、调整前条数、调整后条数、操作人、备注。

2.3 小区资源配置 (弹框)

为单个小区分配短信资源。

表单字段：

• 小区名称：自动带入，不可修改。

• 分配方式：（必填）单选，"按金额分配" / "按条数分配"。

• 分配金额 / 分配条数：（必填）根据分配方式二选一展示。

• 转换系数：（必填）平台与小区的短信单价。

• 对应条数 / 对应金额：根据输入和转换系数自动计算得出，允许修改。计算结果四舍五入取整。

• 有效期限：（非必填）默认为"长期有效"。

• 备注：（非必填）。

功能逻辑：

• 自动换算：

  • 对应条数 = 分配金额 * 转换系数

  • 对应金额 = 分配条数 / 转换系数

• 确认分配：

  • 提交前进行必填项校验，并弹出二次确认提示："请确认后再提交，提交后无法修改及退款"。

  • 确认后，增加该小区的可用短信条数，并生成一条"配置历史"记录。

  • 同时更新平台"分配情况"中的剩余可分配条数（减少）和已分配且未使用条数（增加）。

2.4 小区配置历史记录 (弹框)

展示单个小区的所有历史分配记录。

• 列表字段： 操作时间、分配方式、分配条数、支付金额、转换系数、原剩余条数、现剩余条数、有效期、备注。

2.5 小区短信使用情况 (弹框)

展示单个小区的短信发送明细。

• 列表字段： 推送时间、推送名称、推送内容、推送状态、接收成功/失败（格式：成功数/失败数）。