sync: 同步文档 v1.0.4 并脱敏

This commit is contained in:
MiFaZhan
2026-10-29 15:45:46 +08:00
parent c49b2bf404
commit 3ab3682d14
138 changed files with 514 additions and 477 deletions
+8 -13
View File
@@ -11,22 +11,23 @@
![卡片详情中的基础信息和流量信息](/images/manual/mini-program/card-details-traffic.png)
卡号可能已经脱敏,已页面显示为准。点击或长按卡号行可以复制当前显示值。
卡号可能已经脱敏,页面显示什么就以什么为准。点击或长按卡号行可以复制当前显示值。
公开模式不会展示完整 IMSI、IMEI、备注、总流量、剩余流量、会话信息、APN、IPv4、IPv6 和服务状态,也不会提供重启、开通数据、停用数据等操作按钮。
## 登录后详情
登录并通过权限校验后,设备列表和卡片详情可以展示更完整的账号范围数据,例如 MSISDN、ICCID、IMSI、设备 IMEI、套餐流量、剩余流量、流量同步时间和会话信息。详情中的流量区域还可能显示昨日客户用量及其统计日期。字段是否出现取决于接口返回值和账号权限。
登录并通过权限校验后,设备列表和卡片详情可以展示更完整的账号范围数据,例如 MSISDN、ICCID、IMSI、设备 IMEI、套餐流量和同步时间。字段是否出现取决于接口返回值和账号权限。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start; width: 100%; max-width: 440px; margin: 24px auto;">
<div style="display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; align-items: start;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/devices-list-account-data-v3.png" alt="登录后的设备列表和详情入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">设备列表与详情入口</figcaption>
<img src="/images/manual/mini-program/devices-list-account-data-v2.jpg" alt="登录后的设备列表和账号范围数据" style="display: block; width: 100%; height: auto;">
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/card-details-account-data-v3.png" alt="登录后的卡片基础信息和流量信息" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片基础信息与流量信息</figcaption>
<img src="/images/manual/mini-program/devices-search-account-data-v2.jpg" alt="全部设备中的账号范围数据" style="display: block; width: 100%; height: auto;">
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/card-details-account-data-v2.jpg" alt="登录后的卡片详情账号范围数据" style="display: block; width: 100%; height: auto;">
</figure>
</div>
@@ -36,9 +37,3 @@
- 确认查询号码没有空格或遗漏字符;
- 从首页重新查询后再点击“详情”;
- 若页面提示当前账号没有权限,请使用公开查询,或联系账号管理员确认数据范围。
## 卡片操作
公开查询详情不会提供业务操作。登录后,卡片详情可按权限显示重启、开通或停用数据服务、卡片划拨及工单入口;操作也会受卡片状态和账号工作区限制。排查页的已用流量信息可在支持时点击同步刷新。当前版本关闭停机、复机等“更多操作”入口,续费、套餐变更和加油包尚未开放。
![卡片详情中的快捷操作入口](/images/manual/mini-program/card-details-quick-actions.png)
+8 -14
View File
@@ -9,24 +9,24 @@
1. 首页点击“卡片排查”,手动输入卡号;
2. 首页查询成功后点击“卡片排查”,系统会带入当前查询值;
![首页查询结果中的卡片排查入口](/images/manual/mini-program/diagnosis-entry-from-query-v3.png)
![首页查询结果中的卡片排查入口](/images/manual/mini-program/diagnosis-entry-from-query-v2.png)
3. 直接打开卡片排查页,在输入框填写 `ICCID`、`MSISDN` 或 `IMSI`。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start; width: 100%; max-width: 440px; margin: 24px auto;">
<div style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/diagnosis-entry-from-home-v102.jpg" alt="从首页常用入口进入卡片排查" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/diagnosis-entry-from-home.png" alt="从首页常用入口进入卡片排查" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">首页卡片排查入口</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/diagnosis-manual-input-v102.png" alt="卡片排查页手动输入卡号" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/diagnosis-manual-input.jpg" alt="卡片排查页手动输入卡号" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">输入卡号开始排查</figcaption>
</figure>
</div>
点击“开始排查”提交。排查过程中不要连续重复点击。
## 结果摘要与卡片操作
## 结果摘要
普通用户或未登录用户通常可以看到:
@@ -36,15 +36,11 @@
管理员账号可能看到更多卡片、数据服务、停机冻结和限制策略信息。页面会按实际接口返回值隐藏没有数据的字段。
账号有对应权限且卡片可办理时,排查结果可提供“重启卡”“开通数据服务”或“停用数据服务”操作。按钮随账号权限、卡片状态和数据服务状态变化;提交前确认卡号和操作,完成后以页面提示及业务系统状态为准。卡片详情同样可显示重启、数据服务操作,以及有权限时的划拨入口。
当前版本停机、复机等卡片更多操作入口关闭;这不影响在办理页或卡片详情中使用已开放且获授权的卡片划拨。
## 流量使用分析
当前页面提供“近1个月、近3个月、近6个月”三个周期。**当前版本只对顶层管理员显示流量趋势模块;其他账号即使登录也看不到该模块。**
当前页面提供“近1个月、近3个月、近6个月”三个周期。**`v1.0.1` 默认只对顶层管理员显示流量趋势模块;其他账号即使登录,也不保证看到该模块。**
有数据时会显示周期总用量、日均或月均用量、单期峰值和趋势图;没有数据时显示“暂无历史流量数据”。
有数据时会显示周期总用量、日均或月均用量、单期峰值和趋势图;没有数据时显示“暂无历史流量数据”。趋势只用于辅助排查,不等同于实时计费结果。
## 排查结果的处理方向
@@ -60,8 +56,6 @@
## 当前版本限制
排查页的“重启卡”“开通数据服务”“停用数据服务”按钮只有在登录且账号拥有对应权限时才会出现。工单、客户管理和卡片划拨已在当前版本按权限开放;续费、变更与加油包暂未开放,预警、订单及余额充值等功能仍受版本开关限制。
排查页的“重启卡”“开通数据服务”“停用数据服务”按钮只有在登录且账号拥有对应权限时才会出现。业务办理路由、套餐、预警、订单和工单在 `v1.0.1` 中暂未开放。
排查接口或流量接口提示请求过于频繁时,请等待一段时间后再试,不要连续提交。
排查结果的已用流量信息在支持时可点击“重新同步流量”刷新。同步仍受上游服务频率限制;若提示限频,等待页面提示的时间后再试,不要连续点击。趋势图中未采集周期不会按 0MB 计算;暂无数据不代表用量为零。
+45
View File
@@ -0,0 +1,45 @@
# 常见问题
## v1.0.1 有哪些可用功能?
无需登录即可在首页手动输入、扫码或拍照识别卡号,并查看公开详情和卡片排查结果。已有账号可以使用账号密码登录,查看权限范围内的设备数据。
## 为什么底部没有“办理”Tab?
`v1.0.1` 关闭了办理 Tab。套餐续费、加油包、套餐变更、停复机、预警、订单、工单和客户管理等路由也暂未开放,直接访问会提示当前版本暂未开放此功能。
## 为什么设备页看不到卡片?
设备页读取登录账号的卡片范围。未登录时请回到首页使用公开查卡;登录后仍为空时,请确认账号已分配卡片或具备相应权限。
## 支持哪些查卡方式?
首页支持输入 `ICCID`、`MSISDN`、`IMSI` 或 `IMEI`,也支持扫码读取内容和从相机或相册拍照识别 ICCID。
## 拍照识别失败怎么办?
请拍摄单张、平整、完整、无反光的卡片,并确保 ICCID 清晰。识别超时或频繁请求时等待后重试;也可以改用扫码或手动输入。
## 公开详情为什么字段少?
公开模式只展示卡号、卡状态、在线状态和已用流量。完整 IMSI、IMEI、会话、APN、IP、服务状态等字段属于受限数据。
## 为什么不能绑定卡片或执行重启?
卡片绑定和“更多操作”在 `v1.0.1` 中统一关闭。即使登录,当前版本也不会提供绑定、套餐办理、停复机、数据服务变更和预警配置入口。
## 为什么看不到流量趋势?
流量趋势模块当前只对顶层管理员开放,且接口必须返回有效历史数据。其他账号或没有历史数据时不会显示趋势图。
## 为什么排查显示离线或未查询到会话?
先检查设备供电、开机状态、信号、天线和 APN,再稍后重新排查。“未查询到会话”只表示当前没有查到数据会话,不等同于卡片已销户。
## 账号密码登录有什么限制?
当前版本只开放已有账号的账号密码登录;微信登录和注册账号未开放。忘记密码页面会提示短信服务接入后开放,请联系管理员或客服处理账号问题。
## 排查结果是否是最终结论?
不是。排查结果仅用于辅助判断,最终以运营商和业务系统状态为准。请勿在查询、排查和反馈内容中提交身份证号、银行卡号或其他无关敏感信息。
+10 -29
View File
@@ -4,29 +4,29 @@
## 登录入口
首页和登录页都保留“未登录也可查卡”入口。需要查看账号名下设备时,可使用密码或手机号短信验证码登录。同一凭据关联多个身份时,按提示选择本次要进入的身份。
首页和登录页都保留“未登录也可查卡”入口。需要查看账号名下设备时,再通过账号密码登录;微信登录和注册账号暂未开放。
## 手动查询
1. 在“卡片查询”输入框输入完整的 `ICCID`、`MSISDN`、`IMSI` 或 `IMEI`。
2. 点击“查询”,等待查询完成。
![点击查询并等待查询完成](/images/manual/mini-program/query-complete-v102.png)
![点击查询并等待查询完成](/images/manual/mini-program/query-complete.png)
3. 查询成功后,结果区域显示卡号、卡状态、已用流量和在线状态;卡号可以点击或长按复制。
4. 点击结果中的“查看详情”查看公开卡片详情;点击查询框下方的“卡片排查”会带入卡号查看状态摘要。公开查询未找到卡片时,页面也可能直接转入排查页继续核对。
3. 查询成功后,结果区域显示卡号、使用流量和在线状态。
4. 点击“详情”查看公开卡片详情,或点击“卡片排查”查看状态摘要。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px; align-items: start;">
<div style="display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; align-items: start;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/query-actions-updated-v102.png" alt="查询结果中的详情和卡片排查入口" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/query-actions-v2.jpg" alt="查询结果中的详情和卡片排查入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">详情与卡片排查入口</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/public-card-details-updated-v102.png" alt="卡片详情页展示的公开字段" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/card-details-v2.jpg" alt="卡片详情页展示的公开字段" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片详情</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/card-diagnosis-updated-v102.png" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/card-diagnosis-v2.jpg" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片排查</figcaption>
</figure>
</div>
@@ -48,7 +48,7 @@
1. 点击“拍照”。
![首页拍照入口](/images/manual/mini-program/photo-entry-v102.png)
![首页拍照入口](/images/manual/mini-program/photo-entry.png)
2. 从相机或相册选择一张卡片图片。
3. 确保图片中只有一张卡片,并且 ICCID 完整、清晰、无反光。
@@ -62,25 +62,6 @@
| 未能识别清晰的 ICCID | 保持卡片平整、对焦清楚后重拍 |
| 图片识别超时或请求过于频繁 | 等待后重试,或使用扫码、手动输入 |
## 登录后的设备概览
登录后首页还会显示设备概览,最多预览三张卡,并优先展示即将到期的卡;有卡片数据时显示卡片总数。点击卡片查看详情,点击“管理”进入“全部设备”,可搜索 ICCID、MSISDN、IMSI 或 IMEI,按卡片状态筛选、刷新并加载更多。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start; width: 100%; max-width: 440px; margin: 24px auto;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/home-device-overview-v102.png" alt="登录后首页展示最多三张卡片的设备概览与管理入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">首页设备概览</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/all-devices-v102.png" alt="全部设备页面的卡片搜索、状态筛选和列表" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">全部设备</figcaption>
</figure>
</div>
设备数据按当前账号权限范围返回。未登录时不显示账号设备概览;列表为空时请确认账号已分配卡片或具备相应权限。
## 首页结果
首页公开查询显示“使用流量”(已用流量),不展示账号套餐的剩余流量。在线状态可能为在线、离线、未知或未查询到会话。结果区域的查询和排查说明均提示:内容仅供参考,以业务系统结果为准。
![首页公开查询结果中的卡号、使用流量和在线状态](/images/manual/mini-program/public-query-result-v102.png)
首页结果中的“剩余流量”按“剩余 / 套餐总量”展示;在线状态可能为在线、离线、未知或未查询到会话。结果区域的查询和排查说明均提示:内容仅供参考,以业务系统结果为准。
+22 -41
View File
@@ -4,7 +4,7 @@ title: 小程序端使用手册
# 小程序端使用手册
当前小程序版本为v1.0.2。无需登录可使用公开查卡和卡片排查;登录后可使用账号获授权的设备、办理和服务功能。
本文介绍 iotLCM 平台当前已开放的页面及操作功能,具体可用内容以账号实际权限为准。当前版本以**公开查卡和状态排查**为主,业务办理入口暂未开放。
<div class="mini-program-entry">
<figure class="mini-program-entry__qr">
@@ -20,22 +20,17 @@ title: 小程序端使用手册
| --- | --- | --- |
| 首页 | 已开放 | 手动输入、扫码、拍照识别并查询卡片 |
| 卡片详情 | 已开放 | 公开查询只展示卡号、卡状态、在线状态和已用流量 |
| 卡片排查 | 已开放 | 输入卡号查看状态摘要;历史流量趋势仍限顶层管理员 |
| 登录 | 已开放 | 支持账号密码或手机号短信验证码;多个身份时选择本次账号 |
| 设备列表 | 登录后使用 | 查看账号权限范围内的卡片,支持搜索、筛选、刷新和详情 |
| 办理 | 登录后按权限显示 | 卡片排查、卡片划拨、客户管理、工单和批次日志等按身份与权限显示 |
| 消息与我的 | 登录后使用 | 查看站内消息、个人资料和授权的业务工作台入口 |
| 续费、变更与加油包 | 暂未开放 | 当前版本暂未开放 |
| 订单、预警、余额充值 | 暂未开放 | 当前版本暂未开放 |
| 绑定卡片、停复机等卡片更多操作 | 暂未开放 | 当前版本不提供这些操作;有划拨权限时可使用卡片划拨 |
当前底部导航为“首页、设备、办理、我的”。
| 卡片排查 | 已开放 | 输入卡号查看状态摘要;流量趋势仅对管理员账号显示 |
| 账号密码登录 | 已开放 | 企业、代理商和终端用户使用已有账号登录 |
| 设备列表 | 登录后使用 | 显示当前账号权限范围内的卡片;未登录不要用此页进行公开查卡 |
| 办理、订单、工单、预警、开停数据等 | 暂未开放 | 入口或路由会提示“当前版本暂未开放此功能” |
| 微信登录、注册、绑定卡片、卡片更多操作 | 暂未开放 | 本版本不提供这些入口 |
## 推荐流程
1. 打开小程序首页,在“卡片查询”中输入 ICCID、MSISDN、IMSI 或 IMEI。
![小程序首页卡片查询输入框](/images/manual/mini-program/home-card-query-v102.png)
![小程序首页卡片查询输入框](/images/manual/mini-program/home-card-query.png)
2. 也可以点击“扫码”读取卡片条码,或点击“拍照”识别卡片上的 ICCID。
@@ -47,62 +42,52 @@ title: 小程序端使用手册
4. 需要查看公开字段时点击“详情”;需要判断异常原因时点击“卡片排查”。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px; align-items: start;">
<div style="display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; align-items: start;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/query-actions-v102.png" alt="首页查询结果中的详情和卡片排查入口" style="display: block; width: 100%; height: auto; aspect-ratio: 1 / 2; object-fit: contain; object-position: top;">
<img src="/images/manual/mini-program/query-actions-v2.jpg" alt="首页查询结果中的详情和卡片排查入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">首页入口</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/card-details-v102.png" alt="卡片详情页展示的公开字段" style="display: block; width: 100%; height: auto; aspect-ratio: 1 / 2; object-fit: contain; object-position: top;">
<img src="/images/manual/mini-program/card-details-v2.jpg" alt="卡片详情页展示的公开字段" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片详情</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/card-diagnosis-v102.png" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto; aspect-ratio: 1 / 2; object-fit: contain; object-position: top;">
<img src="/images/manual/mini-program/card-diagnosis-v2.jpg" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">卡片排查</figcaption>
</figure>
</div>
5. 如需工单、客户管理、卡片划拨或批次日志,请登录后在“办理”或“我的”查看获授权的入口;续费、变更与加油包暂未开放。
5. 如果需要停复机、开通数据服务、套餐办理、预警或工单,请等待后续版本开放。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start; width: 100%; max-width: 440px; margin: 24px auto;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/user-workbench-v102.png" alt="我的页面中的工单服务、客户管理和批次执行日志入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">“我的”业务工作台入口</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/business-entry-v102.png" alt="办理页面中的卡片划拨、工单服务、客户管理和批次执行日志入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">“办理”中的业务入口</figcaption>
</figure>
</div>
## 登录与账号选择
## 账号密码登录
1. 在需要账号数据的页面进入登录页,或在首页点击登录入口。
<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start; width: 100%; max-width: 440px; margin: 24px auto;">
<div style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start;">
<figure style="margin: 0;">
<img src="/images/manual/mini-program/login-entry-home-v102.png" alt="从首页底部的我的入口进入登录" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/login-entry-home.jpg" alt="从首页底部的我的入口进入登录" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">首页“我的”入口</figcaption>
</figure>
<figure style="margin: 0;">
<img src="/images/manual/mini-program/login-page-entry-v102.png" alt="登录页中的账号密码登录入口" style="display: block; width: 100%; height: auto;">
<img src="/images/manual/mini-program/login-page-entry.jpg" alt="登录页中的账号密码登录入口" style="display: block; width: 100%; height: auto;">
<figcaption style="text-align: center;">账号密码登录</figcaption>
</figure>
</div>
2. 选择“密码登录”,输入已有手机号或用户名及密码,点击“登录”;或选择“验证码登录”,输入手机号,获取验证码时完成滑块验证,再输入收到的短信验证码登录。
2. 输入已有账号和密码,完成页面要求的安全验证后点击“登录”。
![密码登录与验证码登录选项](/images/manual/mini-program/account-login-methods-v102.png)
![账号密码登录表单](/images/manual/mini-program/account-password-login.png)
3. 如果同一账号匹配多个登录身份,按页面提示选择本次要进入的账号。
4. 登录成功后返回原页面;设备页会按账号权限加载卡片数据。
![登录后首页显示账号权限范围内的我的设备](/images/manual/mini-program/login-success-home-v102.png)
![登录后设备页按账号权限加载卡片数据](/images/manual/mini-program/devices-page.png)
当前版本未开放注册、微信登录和找回密码。无法登录时请联系账号管理员或客服。
当前版本不开放注册和微信登录。“忘记密码”页面会提示短信服务接入后开放,无法登录时请联系账号管理员或客服。
## 使用边界
- 公开查询和排查结果仅供辅助判断,最终以运营商和业务系统状态为准。
- 未登录查询不会展示完整 IMSI、IMEI、APN、IP、套餐内部信息等受限字段。
- 请勿在查询、排查或反馈内容中提交身份证号、银行卡号等无关敏感信息;密码只应填写在登录表单中。
@@ -111,8 +96,4 @@ title: 小程序端使用手册
- [首页查卡、扫码与拍照](./home)
- [卡片详情](./devices)
- [卡片排查](./diagnosis)
- [登录后办理概览](./business)
- [客户管理与卡片划拨](./customers-and-allocation)
- [工单服务](./work-orders)
- [批次执行日志](./execution-logs)
- [消息与个人中心](./messages-and-profile)
- [常见问题](./faq)