chore: 初始开源发布
This commit is contained in:
MiFaZhan
@@ -0,0 +1,39 @@
|
||||
# 卡片详情
|
||||
|
||||
从首页查询结果点击“详情”后进入卡片详情页。首页会以公开来源打开详情，因此未登录或公开来源都会使用受限展示模式。
|
||||
|
||||
## 公开详情展示内容
|
||||
|
||||
公开模式包含两组信息：
|
||||
|
||||
- 基础信息：卡号、卡状态、在线状态；
|
||||
- 流量信息：已用流量。
|
||||
|
||||
|
||||
|
||||
卡号可能已经脱敏，页面显示什么就以什么为准。点击或长按卡号行可以复制当前显示值。
|
||||
|
||||
公开模式不会展示完整 IMSI、IMEI、备注、总流量、剩余流量、会话信息、APN、IPv4、IPv6 和服务状态，也不会提供重启、开通数据、停用数据等操作按钮。
|
||||
|
||||
## 登录后详情
|
||||
|
||||
登录并通过权限校验后，设备列表和卡片详情可以展示更完整的账号范围数据，例如 MSISDN、ICCID、IMSI、设备 IMEI、套餐流量和同步时间。字段是否出现取决于接口返回值和账号权限。
|
||||
|
||||
<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-v2.jpg" alt="登录后的设备列表和账号范围数据" style="display: block; width: 100%; height: auto;">
|
||||
</figure>
|
||||
<figure style="margin: 0;">
|
||||
<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>
|
||||
|
||||
|
||||
## 查不到详情时
|
||||
|
||||
- 确认查询号码没有空格或遗漏字符；
|
||||
- 从首页重新查询后再点击“详情”；
|
||||
- 若页面提示当前账号没有权限，请使用公开查询，或联系账号管理员确认数据范围。
|
||||
@@ -0,0 +1,61 @@
|
||||
# 卡片排查
|
||||
|
||||
卡片排查用于根据卡片状态、在线状态、流量和设备信息整理处理方向。
|
||||
|
||||
## 进入排查
|
||||
|
||||
可以从以下位置进入：
|
||||
|
||||
1. 首页点击“卡片排查”，手动输入卡号；
|
||||
2. 首页查询成功后点击“卡片排查”，系统会带入当前查询值；
|
||||
|
||||
|
||||
|
||||
3. 直接打开卡片排查页，在输入框填写 `ICCID`、`MSISDN` 或 `IMSI`。
|
||||
|
||||
<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.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.jpg" alt="卡片排查页手动输入卡号" style="display: block; width: 100%; height: auto;">
|
||||
<figcaption style="text-align: center;">输入卡号开始排查</figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
|
||||
点击“开始排查”提交。排查过程中不要连续重复点击。
|
||||
|
||||
## 结果摘要
|
||||
|
||||
普通用户或未登录用户通常可以看到：
|
||||
|
||||
- 卡片状态；
|
||||
- 在线状态；
|
||||
- 已用流量或流量状态；
|
||||
|
||||
管理员账号可能看到更多卡片、数据服务、停机冻结和限制策略信息。页面会按实际接口返回值隐藏没有数据的字段。
|
||||
|
||||
## 流量使用分析
|
||||
|
||||
当前页面提供“近1个月、近3个月、近6个月”三个周期。**`v1.0.1` 默认只对顶层管理员显示流量趋势模块；其他账号即使登录，也不保证看到该模块。**
|
||||
|
||||
有数据时会显示周期总用量、日均或月均用量、单期峰值和趋势图；没有数据时显示“暂无历史流量数据”。趋势只用于辅助排查，不等同于实时计费结果。
|
||||
|
||||
## 排查结果的处理方向
|
||||
|
||||
| 结果 | 建议核对 |
|
||||
| --- | --- |
|
||||
| 在线 | 继续核对设备业务表现和应用侧请求 |
|
||||
| 离线 | 检查设备供电、开机状态、信号、天线和 APN |
|
||||
| 未查询到会话 | 稍后重试，并确认设备是否产生数据会话；不等同于卡已销户 |
|
||||
| 流量不足或用量异常 | 核对套餐流量、设备上报和业务使用情况 |
|
||||
| 机卡分离 | 核对卡片与设备的使用关系 |
|
||||
| 区域受限 | 核对业务限制区域、订购状态和触发状态 |
|
||||
| 停机或冻结 | 根据页面提示联系业务管理员确认 |
|
||||
|
||||
## 当前版本限制
|
||||
|
||||
排查页的“重启卡”“开通数据服务”“停用数据服务”按钮只有在登录且账号拥有对应权限时才会出现。业务办理路由、套餐、预警、订单和工单在 `v1.0.1` 中暂未开放。
|
||||
|
||||
排查接口或流量接口提示请求过于频繁时，请等待一段时间后再试，不要连续提交。
|
||||
@@ -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，再稍后重新排查。“未查询到会话”只表示当前没有查到数据会话，不等同于卡片已销户。
|
||||
|
||||
## 账号密码登录有什么限制？
|
||||
|
||||
当前版本只开放已有账号的账号密码登录；微信登录和注册账号未开放。忘记密码页面会提示短信服务接入后开放，请联系管理员或客服处理账号问题。
|
||||
|
||||
## 排查结果是否是最终结论？
|
||||
|
||||
不是。排查结果仅用于辅助判断，最终以运营商和业务系统状态为准。请勿在查询、排查和反馈内容中提交身份证号、银行卡号或其他无关敏感信息。
|
||||
@@ -0,0 +1,67 @@
|
||||
# 首页查卡
|
||||
|
||||
首页是当前版本的主要使用入口。查询不要求登录，支持手动输入、微信小程序扫码和图片识别三种录入方式。
|
||||
|
||||
## 登录入口
|
||||
|
||||
首页和登录页都保留“未登录也可查卡”入口。需要查看账号名下设备时，再通过账号密码登录；微信登录和注册账号暂未开放。
|
||||
|
||||
## 手动查询
|
||||
|
||||
1. 在“卡片查询”输入框输入完整的 `ICCID`、`MSISDN`、`IMSI` 或 `IMEI`。
|
||||
2. 点击“查询”，等待查询完成。
|
||||
|
||||
|
||||
|
||||
3. 查询成功后，结果区域显示卡号、使用流量和在线状态。
|
||||
4. 点击“详情”查看公开卡片详情，或点击“卡片排查”查看状态摘要。
|
||||
|
||||
<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-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-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-v2.jpg" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
|
||||
<figcaption style="text-align: center;">卡片排查</figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
|
||||
输入内容请去除前后空格并核对末位字符。查询失败时先检查输入值，再重新提交。
|
||||
|
||||
## 扫码查询
|
||||
|
||||
1. 点击“扫码”。
|
||||
|
||||
|
||||
|
||||
2. 将卡片条码或二维码放入扫描区域。
|
||||
3. 扫描成功后，识别出的内容会自动填入输入框并立即发起查询。
|
||||
|
||||
光线不足、反光或距离不合适时可能扫描失败；此时请调整卡片位置，或改用手动输入。
|
||||
|
||||
## 拍照识别 ICCID
|
||||
|
||||
1. 点击“拍照”。
|
||||
|
||||
|
||||
|
||||
2. 从相机或相册选择一张卡片图片。
|
||||
3. 确保图片中只有一张卡片，并且 ICCID 完整、清晰、无反光。
|
||||
4. 识别成功后，系统会将 ICCID 填入输入框并继续查询。
|
||||
|
||||
常见提示及处理方式：
|
||||
|
||||
| 提示 | 处理方式 |
|
||||
| --- | --- |
|
||||
| 图片中存在多个可能的 ICCID | 重新拍摄单张卡片 |
|
||||
| 未能识别清晰的 ICCID | 保持卡片平整、对焦清楚后重拍 |
|
||||
| 图片识别超时或请求过于频繁 | 等待后重试，或使用扫码、手动输入 |
|
||||
|
||||
## 首页结果
|
||||
|
||||
首页结果中的“剩余流量”按“剩余 / 套餐总量”展示；在线状态可能为在线、离线、未知或未查询到会话。结果区域的查询和排查说明均提示：内容仅供参考，以业务系统结果为准。
|
||||
@@ -0,0 +1,99 @@
|
||||
---
|
||||
title: 小程序端使用手册
|
||||
---
|
||||
|
||||
# 小程序端使用手册
|
||||
|
||||
本文介绍 iotLCM 平台当前已开放的页面及操作功能，具体可用内容以账号实际权限为准。当前版本以**公开查卡和状态排查**为主，业务办理入口暂未开放。
|
||||
|
||||
<div class="mini-program-entry">
|
||||
<figure class="mini-program-entry__qr">
|
||||
<img src="/images/manual/mini-program/mini-program-code.jpg" alt="扫码进入 iotLCM 小程序">
|
||||
<figcaption>扫码进入 iotLCM 小程序</figcaption>
|
||||
</figure>
|
||||
<p class="mini-program-entry__hint">使用微信扫一扫即可打开小程序，体验公开查卡和卡片状态排查功能。</p>
|
||||
</div>
|
||||
|
||||
## 版本范围
|
||||
|
||||
| 页面或功能 | 当前状态 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| 首页 | 已开放 | 手动输入、扫码、拍照识别并查询卡片 |
|
||||
| 卡片详情 | 已开放 | 公开查询只展示卡号、卡状态、在线状态和已用流量 |
|
||||
| 卡片排查 | 已开放 | 输入卡号查看状态摘要；流量趋势仅对管理员账号显示 |
|
||||
| 账号密码登录 | 已开放 | 企业、代理商和终端用户使用已有账号登录 |
|
||||
| 设备列表 | 登录后使用 | 显示当前账号权限范围内的卡片；未登录不要用此页进行公开查卡 |
|
||||
| 办理、订单、工单、预警、开停数据等 | 暂未开放 | 入口或路由会提示“当前版本暂未开放此功能” |
|
||||
| 微信登录、注册、绑定卡片、卡片更多操作 | 暂未开放 | 本版本不提供这些入口 |
|
||||
|
||||
## 推荐流程
|
||||
|
||||
1. 打开小程序首页，在“卡片查询”中输入 ICCID、MSISDN、IMSI 或 IMEI。
|
||||
|
||||
|
||||
|
||||
2. 也可以点击“扫码”读取卡片条码，或点击“拍照”识别卡片上的 ICCID。
|
||||
|
||||
|
||||
|
||||
3. 点击“查询”，查看卡号、卡状态、使用流量和在线状态。
|
||||
|
||||
|
||||
|
||||
4. 需要查看公开字段时点击“详情”；需要判断异常原因时点击“卡片排查”。
|
||||
|
||||
<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-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-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-v2.jpg" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
|
||||
<figcaption style="text-align: center;">卡片排查</figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
|
||||
5. 如果需要停复机、开通数据服务、套餐办理、预警或工单，请等待后续版本开放。
|
||||
|
||||
## 账号密码登录
|
||||
|
||||
1. 在需要账号数据的页面进入登录页，或在首页点击登录入口。
|
||||
|
||||
<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.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.jpg" alt="登录页中的账号密码登录入口" style="display: block; width: 100%; height: auto;">
|
||||
<figcaption style="text-align: center;">账号密码登录</figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
|
||||
2. 输入已有账号和密码，完成页面要求的安全验证后点击“登录”。
|
||||
|
||||
|
||||
|
||||
3. 如果同一账号匹配多个登录身份，按页面提示选择本次要进入的账号。
|
||||
4. 登录成功后返回原页面；设备页会按账号权限加载卡片数据。
|
||||
|
||||
|
||||
|
||||
当前版本不开放注册和微信登录。“忘记密码”页面会提示短信服务接入后开放，无法登录时请联系账号管理员或客服。
|
||||
|
||||
## 使用边界
|
||||
|
||||
- 公开查询和排查结果仅供辅助判断，最终以运营商和业务系统状态为准。
|
||||
- 未登录查询不会展示完整 IMSI、IMEI、APN、IP、套餐内部信息等受限字段。
|
||||
- 请勿在查询、排查或反馈内容中提交身份证号、银行卡号等无关敏感信息；密码只应填写在登录表单中。
|
||||
|
||||
## 阅读指引
|
||||
|
||||
- [首页查卡、扫码与拍照](./home)
|
||||
- [卡片详情](./devices)
|
||||
- [卡片排查](./diagnosis)
|
||||
- [常见问题](./faq)
|
||||
Reference in New Issue
Block a user