服务使用和余额跟踪

服务使用系统提供实时监控客户的数据、语音、短信和货币余额消耗。此功能与OCS（在线计费系统）集成，向客户（通过自助服务门户）和工作人员显示当前使用情况、剩余配额和余额到期信息。

概述

使用跟踪使得：

• 实时余额显示 - 查看当前使用情况和剩余配额
• 多种余额类型 - 同时跟踪数据、语音、短信和货币余额
• 到期监控 - 查看余额何时到期
• 余额细分 - 详细查看各个余额桶
• 自动刷新 - 每3秒自动更新使用情况

访问服务使用情况

从服务列表：

1. 导航到服务 → 服务列表
2. 点击某个服务旁边的操作菜单 (⋮)
3. 选择**“使用情况”**

从服务详情：

1. 打开服务的详细页面
2. 点击**“使用情况”**标签

从客户页面：

1. 打开客户概览
2. 导航到服务标签
3. 点击任何服务旁边的**“查看使用情况”**

使用情况模态框或页面打开，显示实时消耗数据。

使用情况显示

使用界面显示每种余额类型的摘要卡和详细进度条。

{.align-center width="800px"}

摘要卡

顶部行显示每种余额类型的快速查看卡：

卡片信息：

• 余额类型 - 图标和标签（数据、语音、短信、货币）
• 剩余金额 - 当前余额以适当单位显示
• 到期时间 - 余额到期前的天数/小时
• 更多信息按钮 - 点击以展开详细细分

进度条

在卡片下方，进度条以视觉方式显示消耗情况，填充部分表示剩余余额。

进度条特性：

• 视觉指示器 - 填充部分显示剩余余额
• 百分比 - 剩余余额的数值百分比
• 绝对值 - 显示已用与总量（例如，“12.5GB / 20GB”）
• 颜色编码：
  • 绿色：>50% 剩余
  • 黄色：20-50% 剩余
  • 红色：<20% 剩余
• 可点击 - 点击以展开详细细分

余额类型

数据余额

跟踪互联网数据消耗。

单位： 千兆字节（GB）或兆字节（MB）

显示格式：

进度：12.5GB / 20GB (62%)

常见场景：

• 移动数据计划 - 5GB、10GB、20GB 每月配额
• 固定无线 - 无限或高额上限（500GB，1TB）
• 充值 - 在周期中购买的额外数据
• 加密狗服务 - 热点设备的预付数据

多个桶：

服务通常有多个数据余额：

• 每月配额（每月到期）
• 奖励数据（在活动期后到期）
• 充值数据（到期时间较短，优先消耗）

语音余额

跟踪电话通话分钟数。

单位： 分钟（min）

显示格式：

进度：125 min / 500 min (25%)

通话时长跟踪：

• 来电（如果收费）
• 去电
• 国际通话（如果适用，单独桶）
• 优质号码

计算：

语音使用情况通过内部通话时长以纳秒计算，转换为分钟以供显示。

短信余额

跟踪短信使用情况。

单位： 短信（msgs）

显示格式：

进度：45 / 250 (18%)

消息类型：

• 标准短信（160个字符）
• 长短信（多个段落）
• 彩信（如果单独跟踪）

货币余额

跟踪预付信用或账户余额。

单位： 货币（£，$，€，等）

显示格式：

进度：£15.50 / £20.00 (77%)

使用情况：

• 预付账户使用货币余额支付使用费用
• 客户使用服务时信用减少
• 可以通过支付或代金券充值
• 如果在有效期内未使用，可能会到期

详细余额细分

点击任何卡片上的**“更多信息”**或点击进度条以展开详细细分。

扩展视图：

📦 每月配额 20GB

: 剩余：12.5 GB 使用：7.5 GB 到期：2025年1月25日（15天） 权重：10

📦 奖励数据 5GB

: 剩余：5.0 GB 使用：0 GB 到期：2025年1月31日（21天） 权重：20

📦 充值数据 3GB

: 剩余：0 GB 使用：3.0 GB 到期：2025年1月18日（已过期） 权重：30

总剩余：17.5 GB

余额桶字段：

• ID/名称 - 余额桶的标识符
• 剩余 - 此特定桶中的剩余金额
• 已用 - 从此桶中消耗的金额
• 到期日期 - 此余额到期的时间
• 权重 - 优先顺序（权重越高，优先消耗）

权重系统

余额具有权重值，决定消耗顺序：

• 权重越高 = 优先消耗
• 权重越低 = 最后消耗

示例权重：

• 充值数据：权重30（优先消耗，过期时间短）
• 奖励数据：权重20（第二消耗）
• 每月配额：权重10（最后消耗，过期时间最长）

这确保了即将到期的余额在更持久的���额之前被使用。

实时更新

使用数据每3秒通过轮询自动刷新。

更新内容：

• 当前余额金额
• 使用进度条
• 到期计时器
• 各个桶的详细信息

用户体验：

• 无需重新加载页面
• 平滑更新，无闪烁
• 刷新期间加载覆盖
• 状态徽章显示当前服务状态

用例：

• 在通话期间监控客户使用情况
• 观察余额在客户使用服务时实时减少
• 购买后立即验证充值

不同服务类型中的使用情况

移动服务

显示所有四种余额类型：

• 数据（GB）
• 语音（分钟）
• 短信（消息）
• 货币（货币）

示例：

数据：12.5GB 剩余 语音：125 min 剩余 短信：45 msgs 剩余 货币：£15.50 剩余

固定无线/互联网

通常仅显示：

• 数据（GB或TB）
• 货币（如果是预付）

示例：

数据：450GB / 500GB 剩余 货币：£45.00（预付信用）

热点/加密狗服务

显示加密狗特定的数据跟踪：

• 数据（消耗与预付）
• 货币（预付余额）

显示模式：

当dongle=true时，组件隐藏语音和短信，仅显示相关的数据和货币余额。

故障排除

使用情况显示为 0 / 0

• 原因： 服务未与OCS或CGRateS集成
• 修复：
  • 验证服务是否在OCS中配置
  • 检查OCS API连接
  • 审查服务UUID映射

使用情况未更新

• 原因： 轮询停止或OCS无法访问
• 修复：
  • 刷新页面
  • 检查浏览器控制台是否有错误
  • 验证OCS API是否在线

余额显示不正确

• 原因： OCS数据不匹配或缓存问题
• 修复：
  • 强制OCS余额刷新
  • 检查是否有待处理的交易
  • 验证OCS配置

到期日期缺失

• 原因： 余额未设置到期
• 修复：
  • 某些余额设置为永不到期（无限有效期）
  • 检查OCS中的余额配置

多个余额令人困惑

• 原因： 添加了多个充值或奖励数据
• 修复：
  • 使用详细细分视图查看所有桶
  • 按权重排序以查看消耗顺序
  • 审查各个到期日期

与OCS/CGRateS的集成

使用数据来自OCS（在线计费系统），通常是CGRateS。

数据流：

1. 用户打开使用视图
2. OmniCRM调用GET /crm/service/{service_id}
3. API通过服务UUID查询OCS
4. OCS返回余额映射：

{
  "BalanceMap": {
    "*data": [
      {
        "ID": "monthly_data_20GB",
        "Value": 13421772800,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*voice": [
      {
        "ID": "monthly_voice_500min",
        "Value": 7500000000000,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*sms": [
      {
        "ID": "monthly_sms_250",
        "Value": 250,
        "ExpiryTime": "2025-01-25T23:59:59Z",
        "Weight": 10
      }
    ],
    "*monetary": [
      {
        "ID": "prepaid_credit",
        "Value": 1550,
        "ExpiryTime": "2025-02-25T23:59:59Z",
        "Weight": 10
      }
    ]
  }
}

5. UI将值转换为显示单位（字节 → GB，纳秒 → 分钟）
6. 渲染进度条和卡片
7. 每3秒继续轮询

OCS余额类型映射：

OCS返回带有类型前缀的余额数据，映射到UI显示：

• *data → 数据卡（互联网使用）
• *voice → 语音卡（通话分钟）
• *sms → 短信卡（文本消息）
• *monetary → 货币卡（预付信用）

每种余额类型可以有多个桶（例如，每月配额 + 奖励数据 + 充值数据），所有这些都在详细细分视图中显示。

余额值转换：

• 数据： 字节 → GB（除以 1024³）
• 语音： 纳秒 → 分钟（除以 60×10⁹）
• 短信： 计数（无转换）
• 货币： 分 → 货币（除以 100）

自动续订和行动计划

启用自动续订的服务在OCS中有行动计划安排。

什么是行动计划？

行动计划是CGRateS中安排的任务，自动在特定时间执行：

• 向账户添加余额（自动充值）
• 续订每月配额
• 应用定期收费
• 过期旧余额

自动续订的工作原理：

1. 服务配置：

   • 当服务创建时设置auto_renew = true
   • 配置剧本在OCS中创建行动计划
   • 行动计划配置为每月运行（或每个计费周期）

2. 行动计划配置：

   行动计划包含：

   • 账户ID - 服务UUID
   • 操作 - 要执行的操作（添加数据、语音、短信、货币余额）
   • 计划 - 执行时间（例如，每月1日00:00 UTC）
   • 金额 - 添加多少余额

3. 自动执行：

   • OCS在预定时间执行行动计划
   • 向账户添加余额（例如，20GB数据，500分钟语音）
   • 设置新余额的到期日期（例如，30天）
   • 客户通过文件中的支付方式收费

4. 查看行动计划：

   • 导航到OCS视图中的服务详情
   • 列出行动计划及下次执行时间
   • 显示：计划名称、下次运行日期、操作详情

示例行动计划：

{
  "ActionPlanId": "ProductID_MonthlyPlan__ProductName_20GB_Mobile__ActionPlan_Monthly_Renew",
  "NextExecTime": "2025-02-01T00:00:00+00:00",
  "ActionName_hr": "每月续订",
  "PlanName": "20GB 移动",
  "ActionFrequency_hr": "每月计划",
  "custom_NextExecTime_hr": "在22天内"
}

管理自动续订：

• 启用 - 在服务创建或修改时设置
• 禁用 - 从OCS中移除行动计划（服务保留现有余额但不会自动续订）
• 修改 - 通过服务修改更改续订金额或频率

手动续订：

如果禁用自动续订，客户必须手动：

• 在余额到期前充值
• 或在余额耗尽时暂停服务

在UI中查看：

服务标签显示自动续订状态：

下次续订：2025年2月1日（在22天内）续订金额：£15.00

最佳实践

对于支持人员：

• 在回答“我的服务为什么慢？”的电话之前检查使用情况
• 在充值后验证余额以确认成功
• 使用详细细分查看过期的桶
• 监控高使用量客户以防止超支

对于客户（自助服务）：

• 定期检查使用情况以避免用尽
• 在余额���期前充值
• 理解权重系统以了解哪个余额优先消耗
• 如果使用情况似乎不正确，请联系支持

对于管理员：

• 配置适当的余额到期
• 设置权重值以优先考虑即将到期的余额
• 监控OCS连接以确保准确报告
• 审查余额配置以匹配产品提供

相关文档

• features_topup_recharge - 充值系统以添加余额
• csa_service_management - 管理服务
• csa_modify - 添加附加功能以增加配额
• concepts_products_and_services - 产品配置