docs: sync reviewed public manuals

Sync manuals, navigation and screenshots from open-source c8fa783 while preserving public README, LICENSE and history.
This commit is contained in:
Dai0814
2026-10-26 16:10:40 +08:00
parent 92f239fcc4
commit 19455e1cbc
152 changed files with 812 additions and 241 deletions
+55
View File
@@ -0,0 +1,55 @@
# 预警管理
**适用人员:** 获授权的企业管理员和业务人员。左侧菜单查找预警中心-卡配置-新增预警或预警中心-流量池配置-新增预警;批量设置也可从“通讯管理 → 业务受理 → 预警中心”进入。
预警用于在达到阈值时提醒;[达量断网](./business-operations)用于限制通信,两者需要分别核对。保存配置成功不代表已经发送通知或执行断网。
## 新增或编辑配置
1. 选择单卡或流量池配置页面,按对象编码及状态查询,避免重复维护。
![卡预警配置页面按 ICCID 和状态查询](/images/manual/card-warning-config-search.png)
2. 点击“新增”,或对已有记录点击“修改”。
![新增单卡预警配置](/images/manual/card-warning-add-form.png)
3. 填写对应卡号或流量池编号。单卡使用流量阈值(MB),流量池使用百分比;不要混用单位。
4. 填写第一次提醒阈值,按需设置第二、第三次提醒,按表单与服务端提示校验各档数值。
5. 核对提醒方式。站内提醒为基础方式;选择邮箱或短信时,填写相应接收地址或手机号。
6. 设置启用状态和备注,保存后重新查询并查看详情。
接收人填写错误、短信或邮件服务未配置,都可能导致外部通知无法送达。不要将配置存在等同于通知已送达;必要时请管理员核查通知记录与服务状态。
## 启停、删除与批量配置
- 列表可以按权限启用、停用、查看、修改或删除规则;删除前保留必要业务记录。
![单卡预警规则列表中的查看、修改、停用和删除操作](/images/manual/card-warning-list-actions.png)
- 停用规则表示不再按该规则继续触发,不会撤销已执行的通信操作。
- 批量配置从业务受理选择单卡或流量池预警。单卡提供 Excel、输入及号段方式;流量池不支持连续号段。Excel 使用当前模板填写。
- 提交后记录批次号,前往[执行日志](./api-and-logs)核对结果,再抽查配置页面。
## 未收到提醒时
依次检查对象编码、单位、阈值、启用状态、用量同步时间和接收人;仍有异常时提供对象编码、配置时间、预期触发档位和批次号创建工单。提交工单时不要附带消息服务密钥。
## 告警与通知记录
预警是否真的发出了提醒,要通过发送记录核对,不能只看配置是否存在。
| 页面 | 主要字段 | 用途 |
| --- | --- | --- |
| 消息日志 | 消息类型(系统通知、活动通知、订单通知、账户通知)、接收用户、消息标题、消息内容、跳转链接、发送时间、是否撤回 | 核对站内消息是否写入、发给了哪些用户、是否被撤回 |
| 通知日志 | 通知标题、通知内容、发送用户类型(代理商/终端用户)、发送时间 | 核对面向客户的通知记录 |
- 两个页面都支持按标题和发送时间查询,有权限时可导出当前查询结果。
- 当前版本没有独立的“告警记录”页面。判断一次预警是否触发,要结合预警配置、消息日志和通知日志一起看:配置决定阈值和接收人,日志决定有没有发出去。
- 日志中出现记录,说明消息已写入并进入发送流程;短信、邮件是否送达仍取决于部署的消息服务和登记的联系方式,这两个页面不能替代短信服务商的发送回执。
## 套餐到期提醒
套餐到期提醒与上面的流量阈值配置不同:本地服务按有效单卡套餐的到期时间自动扫描,默认在到期前 30 天、15 天、7 天分档判断。阈值由服务端配置决定,当前 Web 的“卡预警配置”表单只提供流量阈值(MB),不提供到期天数设置。
收到提醒后,先在[卡信息](./card-info)核对到期日期、套餐和归属企业,再决定是否办理续费。站内消息会按符合条件的账号写入消息中心;短信、邮件是否发送取决于已登记的联系方式和部署的消息服务。未收到时,请管理员检查通知或消息日志及后台任务,不要只根据首页的固定预警面板判断。