chore: 初始开源发布

2026-10-22 15:16:43 +08:00
commit 92f239fcc4
114 changed files with 8018 additions and 0 deletions
@@ -0,0 +1,23 @@
+---
+layout: home
+
+hero:
+  name: iotLCM 使用手册
+  text: 操作指南
+  tagline: 按使用端查看卡片查询、业务管理与移动服务说明。
+  actions:
+    - theme: brand
+      text: Web端手册
+      link: /manual/web/
+    - theme: alt
+      text: 小程序端手册
+      link: /manual/mini-program/
+
+features:
+  - title: 版本选型指引
+    details: 使用浏览器登录企业管理后台，请阅读 Web 端手册；使用 IOTLCM 物联卡用户服务小程序，请阅读小程序端手册。不同端的功能入口、权限和页面结构有所区别。
+  - title: Web端
+    details: 面向企业管理员和业务人员，覆盖首页、卡信息、智能诊断、业务受理、企业管理、工单、API 凭证与执行日志。
+  - title: 小程序端
+    details: 对应 iotlcm-app v1.0.1，覆盖首页公开查卡、扫码与拍照识别、卡片详情、卡片排查和账号密码登录；办理、绑定、微信登录及注册等功能暂未开放。
+---
@@ -0,0 +1,39 @@
+# 卡片详情
+
+从首页查询结果点击“详情”后进入卡片详情页。首页会以公开来源打开详情，因此未登录或公开来源都会使用受限展示模式。
+
+## 公开详情展示内容
+
+公开模式包含两组信息：
+
+- 基础信息：卡号、卡状态、在线状态；
+- 流量信息：已用流量。
+
+![卡片详情中的基础信息和流量信息](/images/manual/mini-program/card-details-traffic.png)
+
+卡号可能已经脱敏，页面显示什么就以什么为准。点击或长按卡号行可以复制当前显示值。
+
+公开模式不会展示完整 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. 首页查询成功后点击“卡片排查”，系统会带入当前查询值；
+
+![首页查询结果中的卡片排查入口](/images/manual/mini-program/diagnosis-entry-from-query-v2.png)
+
+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. 点击“查询”，等待查询完成。
+
+![点击查询并等待查询完成](/images/manual/mini-program/query-complete.png)
+
+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. 点击“扫码”。
+
+![首页扫码入口](/images/manual/mini-program/scan-entry-highlight.png)
+
+2. 将卡片条码或二维码放入扫描区域。
+3. 扫描成功后，识别出的内容会自动填入输入框并立即发起查询。
+
+光线不足、反光或距离不合适时可能扫描失败；此时请调整卡片位置，或改用手动输入。
+
+## 拍照识别 ICCID
+
+1. 点击“拍照”。
+
+![首页拍照入口](/images/manual/mini-program/photo-entry.png)
+
+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。
+
+![小程序首页卡片查询输入框](/images/manual/mini-program/home-card-query.png)
+
+2. 也可以点击“扫码”读取卡片条码，或点击“拍照”识别卡片上的 ICCID。
+
+   ![首页扫码和拍照入口](/images/manual/mini-program-scan-photo-entry.png)
+
+3. 点击“查询”，查看卡号、卡状态、使用流量和在线状态。
+
+![点击查询查看卡号、卡状态、使用流量和在线状态](/images/manual/mini-program/query-result.png)
+
+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. 输入已有账号和密码，完成页面要求的安全验证后点击“登录”。
+
+![账号密码登录表单](/images/manual/mini-program/account-password-login.png)
+
+3. 如果同一账号匹配多个登录身份，按页面提示选择本次要进入的账号。
+4. 登录成功后返回原页面；设备页会按账号权限加载卡片数据。
+
+![登录后设备页按账号权限加载卡片数据](/images/manual/mini-program/devices-page.png)
+
+当前版本不开放注册和微信登录。“忘记密码”页面会提示短信服务接入后开放，无法登录时请联系账号管理员或客服。
+
+## 使用边界
+
+- 公开查询和排查结果仅供辅助判断，最终以运营商和业务系统状态为准。
+- 未登录查询不会展示完整 IMSI、IMEI、APN、IP、套餐内部信息等受限字段。
+- 请勿在查询、排查或反馈内容中提交身份证号、银行卡号等无关敏感信息；密码只应填写在登录表单中。
+
+## 阅读指引
+
+- [首页查卡、扫码与拍照](./home)
+- [卡片详情](./devices)
+- [卡片排查](./diagnosis)
+- [常见问题](./faq)
@@ -0,0 +1,53 @@
+# API 凭证与执行日志
+
+## 我的 API 凭证
+
+**入口：** 左侧菜单 → **我的 API 凭证**。
+
+![我的 API 凭证页面](/images/manual/api-credentials-entry.png)
+
+页面显示本企业的企业 ID、企业名称、`appKey`（API 账号标识）和 `appSecret`（API 密钥），并提供复制按钮。接口鉴权和请求格式请配合 [OpenAPI 接口文档](/openapi/) 使用。
+
+::: warning appKey ≠ appId
+- **`appKey`** 和 **`appSecret`** 仅用于调用 `/openapi/v3/query/token` 换取 token
+- **`appId`**（客户组织编码，如 `CUS-202601-0001`）由 token 接口返回，调用其他接口时在请求体中传入
+- 不要把 `appKey` 当作 `appId` 使用，两者是不同的概念
+:::
+
+### 安全要求
+
+- `appSecret` 等同接口密码，只能提供给获准的开发和运维人员。
+- 不要把凭证写入前端代码、公开仓库、工单正文、聊天截图或日志。
+- 服务端应通过环境变量或密钥管理服务保存凭证。
+- 不同环境不要共用同一份配置文件。
+- 怀疑泄露时立即停止相关调用并联系平台支持更换凭证。
+
+复制后粘贴到配置前，检查是否带入多余空格或换行。接口返回鉴权失败时，先核对企业对应的 appId 与 appSecret 是否配套，再检查签名、时间戳和请求地址。
+
+## 执行日志（暂未开放）
+
+**入口：** 左侧菜单 → **执行日志**。
+
+批量续费、套餐变更、加油包、重启、停复机、划拨、达量断网等任务提交后，均应通过执行日志确认最终结果。
+
+### 查询批次
+
+可按关键字、批次编号、批次类型、异步处理状态和创建时间查询。列表显示：
+
+- 批次编号和批次类型。
+- 来源方式，如 Excel 或批量输入。
+- 运行结果和异步状态。
+- 总数量、开始时间和结束时间。
+
+点击批次编号可查看逐卡明细，包括行号、ICCID、MSISDN、IMSI、明细状态和异常原因。点击“查看”可查看批次概要、失败原因、源文件、结果文件和处理时间。
+
+### 处理失败任务
+
+1. 用提交时记录的批次号查询。
+2. 确认批次已结束，避免把“处理中”误判为失败。
+3. 点击批次号查看失败卡及异常原因。
+4. 下载结果文件，修正卡号、状态、套餐或模板数据。
+5. 只重提失败且可修正的卡，不要整批重复提交。
+6. 无法处理的上游错误通过工单反馈，并附批次号和失败原因。
+
+常见失败原因包括卡号不属于当前企业、卡状态不允许办理、套餐不匹配、余额不足、模板字段错误、上游超时或重复业务仍在处理中。
@@ -0,0 +1,99 @@
+# 业务受理与达量断网
+
+## 业务受理入口
+
+左侧菜单 → **通讯管理 → 业务受理**。
+
+![业务受理入口](/images/manual/business-acceptance-entry.png)
+
+页面按“套餐及数据”“生命周期”“预警中心”展示业务入口。每个入口都有独立按钮权限，未授权的入口不会显示。
+
+可能出现的业务包括：
+
+| 分类 | 业务 | 用途 |
+| --- | --- | --- |
+| 套餐及数据 | 续费套餐 | 延长当前套餐或购买可续费套餐 |
+| 套餐及数据 | 变更套餐 | 将卡切换到其他可购套餐 |
+| 套餐及数据 | 加油包订购 | 为单卡或流量池购买叠加包 |
+| 套餐及数据 | 开停数据 | 开启或关闭数据通信服务 |
+| 套餐及数据 | 达量断网 | 设置达到指定流量后断网 |
+| 生命周期 | 重启 | 向运营商提交卡重启 |
+| 生命周期 | 自主停机/自主复机 | 暂停或恢复卡服务 |
+| 生命周期 | 转销户 | 将卡转为销户状态 |
+| 生命周期 | 划拨 | 将卡划拨给目标下级企业 |
+| 生命周期 | 退订 | 退订符合条件的套餐或业务 |
+| 预警中心 | 流量预警配置 | 配置单卡流量阈值预警 |
+| 预警中心 | 流量池预警配置 | 配置流量池阈值预警 |
+
+## 通用办理方式（部分开放）
+
+不同业务会提供以下一种或多种数据来源：
+
+- **Excel：** 先下载页面提供的最新模板，按模板填写后上传 `.xls` 或 `.xlsx` 文件。不要修改表头或合并单元格。
+- **批量输入：** 通常每行一个 ICCID；部分业务支持每行填写 `ICCID MSISDN IMSI`。
+- **连续号段：** 填写 ICCID、MSISDN 或 IMSI 的起始值和结束值，适合连续卡段。
+
+标准操作流程：
+
+1. 选择业务入口和数据来源。
+2. 上传文件或输入卡号，提交预处理。
+3. 记录系统返回的批次号。
+4. 核对有效数量、失败数量、目标套餐、购买时长、生效方式、金额和余额等信息。
+5. 确认无误后提交正式任务。
+6. 前往“执行日志”查询批次最终状态和失败原因。
+
+::: warning 提交前确认
+批量任务可能影响通信、套餐、费用或卡生命周期。提交前应抽查卡号、目标企业、套餐编码、阈值、生效方式和付款方式。不要重复提交仍在处理中的批次。
+:::
+
+## 续费、变更与加油包（暂未开放）
+
+### 续费套餐
+
+支持 Excel 或批量输入。预处理后选择可续费套餐、续费年限、续费日期和付款方式。余额支付时必须确认余额充足；线下支付时按页面要求完成线下确认。
+
+### 变更套餐
+
+支持 Excel、批量输入和连续号段。预处理后选择新套餐、购买时长、赠送时长和“立即生效/次月生效”。变更前重点确认生效方式，避免影响当前套餐剩余资源。
+
+### 加油包订购
+
+可选择“单卡加油包”或“流量池加油包”。单卡 Excel 需填写 ICCID 和加油包套餐编码；流量池 Excel 需填写流量池编码和套餐编码。预处理后核对数量、单价、总金额、付款账户和余额。
+
+## 生命周期和数据服务（部分开放）
+
+重启、自主停机、自主复机、开停数据、转销户和退订通常支持 Excel 或批量输入。生命周期任务提交后不会立即在列表全部完成，应通过批次号在执行日志中跟踪。
+
+- 重启适合设备长时间不在线且卡状态正常的场景。
+- 自主停机和关闭数据会中断通信，恢复前请确认业务窗口。
+- 转销户通常不可逆或需要人工处理，提交前必须复核卡号。
+- 划拨前确认目标企业，任务完成后卡的数据归属和可见范围会变化。
+
+## 达量断网批量配置（部分开放）
+
+在“业务受理”点击“达量断网”，可通过 Excel、批量输入或连续号段批量配置：
+
+1. 选择开启或关闭。
+2. 开启时填写阈值，单位为 MB，阈值必须大于 0，最多保留 3 位小数。
+3. 填写卡号或上传模板后提交。
+4. 记录批次号并在执行日志中检查结果。
+
+关闭配置表示不再按该阈值触发断网，不等同于立即恢复所有因其他原因停机的卡。
+
+## 达量断网页面（部分开放）
+
+**入口：** 左侧菜单 → **通讯管理 → 达量断网**。
+
+![达量断网入口](/images/manual/data-usage-cutoff-entry.png)
+
+该页面用于查看和维护已有配置：
+
+- 可按 MSISDN、ICCID、IMSI、IMEI 或配置状态查询。
+- 列表显示通道、所属公司、当前套餐、配置状态和阈值。
+- 有编辑权限时，可修改开启/关闭状态及阈值。
+- 有删除权限时，可删除该卡的达量断网配置。
+- 有导出权限时，可按当前条件导出配置。
+
+批量新增或修改建议从“业务受理 → 达量断网”完成；单卡核对和调整可在本页面完成。
+
+![业务受理中的达量断网批量输入](/images/manual/business-operations-batch-threshold.png)
@@ -0,0 +1,84 @@
+# 卡信息
+
+## 页面入口
+
+左侧菜单 → **通讯管理 → 卡信息**。
+
+该页面是日常查卡的主要入口，可查询卡的身份标识、运营商状态、套餐、流量、归属企业、通道和到期情况。
+![日常查卡页面入口](/images/manual/card-info-main-entry.png)
+
+## 查询卡片
+
+常用查询条件如下：
+
+| 条件 | 用法 |
+| --- | --- |
+| 卡号 | 输入 MSISDN、ICCID 或 IMSI 任一标识 |
+| 卡状态 | 按运营商卡状态筛选 |
+| IMEI | 按终端设备号查询 |
+| 所属通道 | 按运营商或接入通道筛选，支持搜索 |
+| 时间类型、时间范围 | 按所选业务时间区间筛选 |
+| 查询条件、起始号段、结束号段 | 选择号段类型，并按起止号段范围筛选卡片 |
+| 备注信息 | 按备注内容筛选 |
+| 维度、维度状态、维度值 | 按指定业务维度进行组合筛选 |
+| 排序值、排序类型 | 指定排序字段及升降序 |
+
+查询不到卡时，先确认使用的是完整卡号，再清空状态、时间和通道等附加条件重试。
+
+## 列表信息
+
+| 字段 | 说明 |
+| --- | --- |
+| ICCID | SIM 卡芯片的唯一识别码，业务办理和故障定位最常用 |
+| MSISDN | 运营商分配的移动号码，也常称卡号 |
+| IMSI | SIM 卡在移动网络中的用户识别码 |
+| 卡状态 | 运营商侧当前生命周期状态 |
+| 类型 | “单卡”表示独立计量，“池卡”表示参与流量池共享 |
+| 通道 | 卡接入的运营商或上游通道 |
+| 所属公司 | 当前卡归属的企业 |
+| 套餐 | 当前主套餐名称 |
+| 总流量、已用流量、剩余流量 | 当前套餐流量，单位为 MB |
+| 到期时间 | 当前套餐预计到期日期 |
+| 出库时间 | 卡片分配出库日期 |
+| 备注信息 | 企业维护的业务备注 |
+
+列表中的流量不是实时会话流量。需要最新结果时，执行“同步用量”后再刷新。
+
+## 查看卡详情
+
+点击目标卡右侧“查看”。详情上方展示：MSISDN、ICCID、IMSI、IMEI、卡状态、网络类型、流量同步时间、套餐总流量、到期时间、出库时间、当前套餐、已用流量、剩余流量、所属企业、所属通道、达量断网配置状态、限额、备注。
+
+![在卡信息列表点击“查看”打开卡详情](/images/manual/card-info-view-entry.png)
+
+详情下方包含以下页签：
+
+- **会话信息：** APN、IPv4、IPv6、接入方式、在线状态、会话建立时间、实时 IMEI、开关机状态等。点击“刷新”重新查询；“未查询到会话”通常表示设备当前未建立数据会话，并不等同于卡已销户。
+- **归属信息：** 当前套餐编号、套餐名称、所属企业和所属通道（所属通道不予展示）。
+- **主套餐：** 订单编号、套餐名称、套餐类型、订购状态、生效时间和到期时间。
+- **叠加套餐：** 加油包名称、总流量、支付方式和交易时间。
+- **变更历史：** 变更前后套餐、订购状态和办理时间。
+
+![卡详情页签](/images/manual/card-detail-tabs.png)
+
+## 常用操作
+
+页面上的操作按钮以账号权限为准。
+
+- **备注：** 编辑本企业对卡片的业务备注，便于按项目、设备或使用场景检索。
+- **同步用量：** 向上游请求最新用量。同步成功后查看“流量同步时间”是否更新。
+- **同步状态：** 向上游请求最新运营商卡状态。
+- **导出：** 按当前筛选条件导出卡信息。
+- **诊断：** 在卡详情点击“诊断”，系统会携带当前 ICCID 跳转到智能诊断并自动查询。
+
+“批量操作”当前仍显示为待接入功能。
+
+![卡信息列表更多操作菜单](/images/manual/card-info-more-actions.png)
+
+## 查看数据异常时
+
+1. 先核对卡号和所属企业。
+2. 查看卡状态、套餐到期时间及流量同步时间。
+3. 分别执行“同步状态”和“同步用量”。
+4. 打开详情刷新会话信息。
+5. 进入[智能诊断](./intelligent-diagnosis)做完整排查。
+6. 仍有异常时创建工单，并提供 ICCID、异常时间和已完成的操作。
@@ -0,0 +1,102 @@
+# 企业、用户与角色
+
+## 企业信息
+
+**入口：** 左侧菜单 → **企业管理 → 企业信息**。
+
+![企业信息页面入口](/images/manual/enterprise-information-entry.png)
+
+该页面用于维护当前企业资料，分为单位信息和实名认证信息。
+
+单位信息通常包括联系电话、邮箱、统一社会信用代码、组织所在地和详细地址。实名认证信息包括单位全称、行业、法人姓名、法人身份证号、单位类型、成立时间、开户行名称和开户行账号。
+
+单位信息如需修改请联系管理员。
+
+## 角色管理
+
+**入口：** 左侧菜单 → **企业管理 → 角色管理**。
+
+![角色管理页面入口](/images/manual/role-management-entry.png)
+
+角色用于把菜单和按钮权限批量授予用户。列表可按角色名称、权限字符和状态查询。
+
+### 创建角色
+
+1. 点击“新增”。
+![创建角色时点击新增](/images/manual/role-create-add-button.png)
+2. 填写角色名称和角色权限字符。
+3. 设置角色状态。
+4. 在“菜单权限”中勾选该角色需要使用的页面和操作。
+5. 需要传递给直属下级企业时，按业务要求设置“下发给下一级”。
+
+   ![设置下发给下一级](/images/manual/role-management-distribute-to-child.png)
+
+6. 保存后回到“用户管理”，将角色分配给用户。
+![在用户管理中分配角色](/images/manual/assign-role-to-user.png)
+
+本级机构绑定的默认角色不能修改或删除。新增自定义角色时遵循最小权限原则，不要为普通查询人员授予企业删除、用户删除、角色修改或批量业务提交权限。
+
+## 企业客户
+
+**入口：** 左侧菜单 → **企业管理 → 企业客户**。
+
+![企业客户页面入口](/images/manual/enterprise-customer-entry.jpg)
+
+该页面面向获准管理下级企业的客户。可按企业名称和状态查询，列表显示企业名称、登录账号、负责人、联系电话、邮箱、组织所在地、详细地址、创建时间和状态。
+
+根据按钮权限，可执行：
+
+- **新增：** 创建直属企业客户之前，需在角色管理界面创建该企业客户同名角色，之后返回新增页面设置登录账号、初始密码、联系方式和企业地址等信息。
+![角色管理中创建企业客户同名角色](/images/manual/enterprise-customer-role-match.png)
+
+![新增企业客户页面](/images/manual/enterprise-customer-create-form.jpg)
+- **修改：** 调整企业名称、登录账号、负责人。
+
+  ![修改企业客户信息](/images/manual/enterprise-customer-edit.png)
+
+- **重置密码：** 为该企业主账号设置新密码，密码长度为 5 至 20 位。
+![企业客户重置密码](/images/manual/enterprise-customer-reset-password.png)
+- **企业管理：** 分两步维护单位信息和实名认证信息。
+
+  ![维护企业单位信息](/images/manual/enterprise-customer-manage.png)
+
+- **删除：** 删除前确认该企业没有仍在使用的卡、用户和业务数据。删除属于高风险操作。
+![企业客户删除确认](/images/manual/enterprise-customer-delete-confirm.png)
+
+新增企业后，应及时通知对方修改初始密码，并按需要创建角色和用户。
+
+## 用户管理
+
+**入口：** 左侧菜单 → **企业管理 → 用户管理**。
+
+![用户管理入口](/images/manual/user-management-entry.png)
+
+可按用户名称、昵称、联系电话、状态和创建时间查询。列表显示用户名称、昵称、角色、联系电话、邮箱、状态和创建时间。
+
+### 新增用户
+
+1. 点击“新增”。
+2. 填写用户名称、初始密码、昵称、联系电话、邮箱、性别和备注。
+3. 设置账号状态。
+4. 至少选择一个角色后保存。
+
+初始密码长度为 5 至 20 位。建议使用更长且不重复的密码，并要求用户首次登录后修改。
+![新增用户页面](/images/manual/user-create-form.png)
+
+### 维护用户
+
+- “修改”可调整资料、状态和角色。
+- “重置密码”可设置新密码。
+- “删除”会使用户失去登录和数据访问能力，操作前确认账号不再使用。
+
+![维护用户信息](/images/manual/user-management-maintain-user.png)
+
+## 建议的角色划分
+
+| 角色 | 建议权限 |
+| --- | --- |
+| 查询人员 | 卡信息查看、智能诊断，只读查看执行日志 |
+| 业务操作员 | 查询权限，以及已批准的业务受理按钮 |
+| 工单人员 | 我的工单、沟通、工单记录 |
+| 接口开发 | 我的 API 凭证，只读卡信息；凭证按需单独授权 |
+| 企业管理员 | 用户、角色和企业资料管理；高风险权限严格控制 |
@@ -0,0 +1,58 @@
+# 常见问题
+
+## 登录后看不到某个菜单
+
+平台按角色显示菜单。先联系本企业管理员检查用户是否绑定正确角色、角色是否正常以及菜单权限是否勾选。若整个企业都没有该功能，需要联系平台支持开通。
+
+## 同事有按钮，我没有
+
+页面权限和按钮权限分别控制。即使都能进入同一页面，新增、编辑、导出、同步、删除或业务提交按钮也可能不同。由企业管理员对比双方角色权限。
+
+## 卡信息查询不到卡
+
+1. 清空其他筛选条件。
+2. 使用完整 MSISDN、ICCID 或 IMSI 查询。
+3. 检查是否有前后空格或字符缺失。
+4. 确认该卡已划拨到当前企业，且账号有相应数据范围。
+5. 仍无结果时创建工单并提供卡号。
+
+## 卡状态或流量没有更新
+
+在“卡信息”中分别执行“同步状态”和“同步用量”，完成后刷新列表，并查看同步时间是否变化。运营商接口可能有延迟；短时间内不要反复同步。
+
+## 智能诊断显示未查询到会话
+
+表示当前没有查到数据会话，不一定是卡异常。检查设备供电、信号、APN 和天线，确认数据服务已开启后重启设备，再稍后诊断。
+
+## 诊断提示运营商不支持
+
+当前卡所属通道未提供该项实时查询能力。结合卡信息、同步时间、设备侧日志和其他诊断模块判断；需要运营商侧核实时提交工单。
+
+## 批量业务提交后一直没有结果
+
+记录批次号，进入“执行日志”查看异步状态。仍在处理中时请等待；已失败时查看批次明细和失败原因。不要在结果未明确前重复提交同一批卡。
+
+## Excel 上传失败
+
+- 使用页面当次下载的最新模板。
+- 文件格式必须为 `.xls` 或 `.xlsx`，且不超过页面限制。
+- 不修改表头、不合并单元格、不增加公式。
+- 卡号列按文本格式保存，避免科学计数法或末位被修改。
+- 根据失败提示修正后，仅重提失败数据。
+
+## 达量断网开启后没有立即断网
+
+确认阈值单位为 MB、配置任务已成功、卡用量已同步且确实达到阈值。运营商侧执行可能有延迟；同时检查卡是否受其他套餐或通道策略影响。
+
+## 如何提交高质量工单
+
+提供完整 ICCID、MSISDN、故障开始时间、影响数量、设备位置、复现步骤、诊断结果、执行日志批次号和必要截图。描述中避免使用“卡有问题”这类无法定位的表述，也不要发送密码或 API 凭证。
+
+## 使用安全建议
+
+- 为每位操作人员创建独立账号，不共享管理员账号。
+- 查询人员、业务操作员和管理员使用不同角色。
+- 定期停用离职或不再使用的账号。
+- 高风险批量任务实行复核，保留批次号和结果文件。
+- 导出的卡信息、企业资料和 API 凭证按敏感数据管理。
+
@@ -0,0 +1,52 @@
+# 首页与通用操作
+
+## 首页（暂未开放）
+
+**入口：** 登录后默认进入“首页”；如已授权，也可点击左侧“首页”。
+
+首页用于快速掌握企业卡业务概况，通常包括：
+
+- SIM 卡总数、本月新增、本月数据用量、本月短信用量和 SIM 卡月活跃度。
+- 生命周期分布、流量池、物联卡位置分布等图表。
+- 欠费停机、主动停机、机卡分离停机、强制停机等业务预警。
+- 流量用尽关停、限额管控关停、封顶关停和套餐余量提醒等流量预警。
+- 卡信息、智能诊断等快捷入口。
+
+首页数据用于概览和发现异常。处理单张卡时，应进入“卡信息”查看最新详情；预警统计与明细可能存在同步时间差。
+
+## 列表页通用操作
+
+### 查询与重置
+
+1. 在查询区填写一个或多个条件。
+2. 点击“查询”；部分页面修改条件后会自动查询。
+3. 条件过多导致无结果时，点击“重置”后只保留卡号、批次号等关键条件重试。
+
+卡号输入框通常支持 MSISDN、ICCID、IMSI。输入前后不要带空格；批量输入时一般每行一张卡。
+
+![卡号查询](/images/manual/card-info-query-single.jpg)
+
+![按号段批量查询](/images/manual/card-info-query-batch.jpg)
+
+### 表格工具
+
+列表右上角可能提供刷新、列设置、密度或全屏等工具。横向字段较多时可左右滚动，固定在右侧的“操作”列用于查看或办理业务。
+
+![表格工具](/images/manual/table-tools.png)
+
+### 导出（暂未开放）
+
+“导出”通常按当前查询条件导出，而不是只导出当前页。建议先缩小查询范围再导出，并妥善保管包含卡号、设备号和企业信息的文件。
+
+### 状态与数据时间
+
+卡状态、流量、会话和执行结果来自不同上游接口，更新时间可能不同。判断数据是否最新时，优先查看“同步时间”“开始时间”“结束时间”等时间字段，不要只看页面打开时间。
+
+## 权限与数据范围
+
+- 菜单权限决定页面是否显示。
+- 按钮权限决定是否能新增、编辑、导出、同步或删除。
+- 数据权限决定能看到本企业、下级企业还是仅本人数据。
+- 同一企业内不同用户看到的菜单和数据可能不同。
+
+企业管理员可通过“企业管理 → 用户管理”和“角色管理”调整本企业用户权限。涉及平台未向企业开放的功能时，需要联系平台支持。
@@ -0,0 +1,90 @@
+# Web 端使用手册
+
+本手册面向 iotLCM Web 管理平台的企业客户，说明登录平台后各页面的入口、信息含义和常用操作。
+
+::: info 权限说明
+平台按企业、角色和用户分配权限。左侧菜单、页面按钮可能因企业实际授权不同而不同；看不到某项功能时，先联系本企业管理员确认角色权限。按钮以页面实际显示为准。
+:::
+
+## 登录平台
+
+![iotLCM 管理平台登录页面](/images/manual/login-page.png)
+
+1. 访问 [iotLCM 管理平台](https://iotlcm.example.com/)。
+2. 输入平台分配的账号和密码登录。
+3. 首次登录后建议立即修改初始密码，并确认绑定的手机号、邮箱是否正确。
+4. 登录后通过左侧菜单进入业务页面；顶部标签可在已打开页面间切换。
+
+若提示账号停用、密码错误或无可用菜单，请联系本企业管理员；企业管理员无法处理时，可通过工单联系平台支持。
+
+## 功能地图（部分开放）
+
+| 菜单 | 页面 | 主要用途 |
+| --- | --- | --- |
+| 顶级菜单 | 首页 | 查看卡量、用量、生命周期和预警概览 |
+| 通讯管理 | 业务受理 | 批量办理套餐、数据服务、生命周期和预警业务 |
+| 通讯管理 | 卡信息 | 查询卡、查看套餐和会话、同步状态与用量 |
+| 通讯管理 | 达量断网 | 查询、编辑和导出单卡达量断网配置 |
+| 通讯管理 | 智能诊断 | 按 MSISDN、ICCID 或 IMSI 一键排查卡和网络状态 |
+| 企业管理 | 企业信息 | 维护本企业基础资料和实名认证资料 |
+| 企业管理 | 用户管理 | 管理本企业用户及其角色 |
+| 企业管理 | 角色管理 | 配置角色菜单权限和状态 |
+| 企业管理 | 企业客户 | 管理直属企业客户、登录账号和企业资料 |
+| 工单管理 | 我的工单 | 创建工单、沟通、跟踪处理和评价 |
+| 工单管理 | 工单记录 | 查询工单的状态变更与操作轨迹 |
+| 顶级菜单 | 我的 API 凭证 | 查看并复制本企业接口凭证 |
+| 顶级菜单 | 执行日志 | 跟踪批量任务结果及逐卡失败原因 |
+
+“工单问题沟通”是从“我的工单”进入的详情页面，不在左侧单独显示。
+
+## 推荐使用流程
+
+### 日常查卡
+
+1. 进入“通讯管理 → 卡信息”。
+2. 用 MSISDN、ICCID、IMSI 或 IMEI 查询目标卡。
+3. 打开“查看”，核对卡状态、套餐、用量、到期时间和同步时间。
+4. 数据较旧时使用“同步用量”或“同步状态”，再刷新查看。
+
+![卡信息同步操作示意图](/images/manual/card-info-sync-actions.png)
+
+### 排查不能联网
+
+1. 从卡详情点击“诊断”，或进入“通讯管理 → 智能诊断”。
+
+   ![从卡详情进入智能诊断](/images/manual/card-detail-diagnosis-entry-new.png)
+
+   ![从通讯管理进入智能诊断](/images/manual/intelligent-diagnosis-entry-new.jpg)
+
+2. 输入卡号并执行“一键诊断”。
+
+   ![输入卡号并执行一键诊断](/images/manual/intelligent-diagnosis-submit.jpg)
+
+3. 依次查看 SIM 卡状态、通信服务、实时流量、策略限制和网络连接。
+
+   ![智能诊断结果页面](/images/manual/intelligent-diagnosis-result.png)
+
+4. 仍无法定位时创建工单，并附上卡号、故障时间、诊断结果和终端现象。
+
+   ![进入我的工单并创建工单](/images/manual/work-order-create-entry-new.jpg)
+
+   ![填写创建工单信息](/images/manual/work-order-create-form-new.jpg)
+
+### 办理批量业务（暂未开放）
+
+1. 进入“通讯管理 → 业务受理”，选择已授权的业务。
+2. 下载最新 Excel 模板，或使用批量输入、连续号段方式提交卡号。
+3. 对需要预处理的业务先核对有效数量、失败项、套餐、价格和生效方式。
+4. 确认提交后记录批次号。
+5. 进入“执行日志”按批次号查看最终结果。
+
+## 阅读指引
+
+- [首页与通用操作](./home)：了解查询、重置、导出和数据刷新规则。
+- [卡信息](./card-info)：了解卡列表字段、卡详情和会话信息。
+- [智能诊断](./intelligent-diagnosis)：了解入口、诊断步骤和结果判断。
+- [业务受理与达量断网](./business-operations)：了解批量业务及达量断网配置。
+- [企业、用户与角色](./enterprise-management)：了解组织和账号权限管理。
+- [工单管理](./work-orders)：了解问题提交、沟通、关闭和评价。
+- [API 凭证与执行日志](./api-and-logs)：了解凭证保管和批次追踪。
+- [常见问题](./faq)：快速排查菜单、数据、任务和诊断问题。
@@ -0,0 +1,71 @@
+# 智能诊断
+
+## 入口
+
+有两种进入方式：
+
+1. 左侧菜单 → **通讯管理 → 智能诊断**。
+
+   ![从左侧菜单进入智能诊断](/images/manual/intelligent-diagnosis-menu.png)
+
+2. 左侧菜单 → **通讯管理 → 卡信息** → 找到目标卡 → “查看” → “诊断”。第二种方式会自动带入 ICCID 并开始查询。
+
+   ![从卡详情进入智能诊断](/images/manual/card-detail-diagnosis-entry-attachment.png)
+
+## 开始诊断
+
+1. 输入 MSISDN、ICCID 或 IMSI 任一完整标识。
+2. 点击“一键诊断”。
+3. 等待页面提示“诊断完成”。不同上游能力返回速度可能不同，请勿连续重复点击。
+4. 展开各诊断模块查看状态、详细字段和提示。
+
+诊断完成后，页面顶部显示 MSISDN、ICCID、IMSI 和实时 IMEI；下方同时查询近 7 天、近 30 天和近 6 个月的流量趋势。
+
+![智能诊断输入卡号并执行一键诊断](/images/manual/intelligent-diagnosis-submit-button.png)
+
+## 诊断结果
+
+![智能诊断结果总览](/images/manual/intelligent-diagnosis-result-attachment.png)
+
+### SIM 卡状态
+
+关注卡状态、停机原因、是否冻结、冻结原因和冻结操作时间。若卡处于停机、冻结、待激活或销户状态，应先处理卡生命周期问题，再排查终端网络。
+
+### 通信服务
+
+关注 APN、IPv4、IPv6、通信服务状态、在线状态、会话状态、会话建立时间、接入方式和实时 IMEI。
+
+- 通信服务关闭时，需先办理开通或复机。
+- 没有会话时，检查设备是否开机、天线和信号是否正常、APN 是否正确。
+- 实时 IMEI 与预期设备不一致时，确认是否换机、换卡或发生机卡分离。
+
+### 实时流量
+
+展示已用流量、剩余流量和同步时间。历史趋势用于判断设备是否持续上报、是否出现突增或长时间无流量。
+
+### 策略限制
+
+展示区域限制订购、触发状态、限制区域和人联网访问限制等。卡和设备均正常但仍无法联网时，应重点检查此模块。
+
+### 网络连接
+
+展示开关机状态、设备状态和机卡绑定状态。出现关机、设备异常或机卡分离时，优先在终端侧核查供电、信号、插卡和绑定关系。
+
+## 推荐排查顺序
+
+1. **卡是否可用：** 卡状态、冻结和停机原因。
+2. **服务是否开启：** 数据通信服务和套餐是否有效。
+3. **流量是否充足：** 剩余流量、达量限制和到期时间。
+4. **策略是否限制：** 区域、人联网及其他策略。
+5. **设备是否在线：** 开关机、设备状态、会话和实时 IMEI。
+6. **趋势是否异常：** 对比近 7 天、30 天、6 个月流量。
+
+## 结果提示说明
+
+- **查询成功但未返回数值：** 上游已响应，但本次没有可展示的数据；结合同步时间和其他模块判断。
+- **未查询到会话：** 当前没有在线数据会话，可稍后重试并检查终端。
+- **运营商暂不支持/不支持查询：** 当前通道没有对应实时查询能力，不代表卡一定异常。
+- **查询暂时未完成：** 可能是上游忙、缓存或接口超时，稍后重试。
+- **系统无记录：** 先检查卡号是否完整以及卡是否归属当前企业。
+
+需要提交工单时，建议附上诊断时间、完整 ICCID、异常模块、终端所在地、设备指示灯或日志，以及问题首次出现时间。
@@ -0,0 +1,61 @@
+# 工单管理
+
+## 我的工单
+
+**入口：** 左侧菜单 → **工单管理 → 我的工单**。
+
+![我的工单页面入口](/images/manual/work-orders-entry.png)
+
+可按工单编号、工单类型和当前处理状态查询。列表显示工单编号、类型、标题、关联业务号、创建人、当前状态、首次响应时间和创建时间。
+
+常见状态包括已分派、处理中、已解决和已完结；取消后的工单也会保留记录。
+
+## 创建工单
+
+1. 点击“创建工单”。
+2. 选择工单类型，如卡问题、套餐问题、订单问题、系统问题或其他问题。
+3. 填写关联业务 ID。卡问题建议填写完整 ICCID，并在问题描述中补充 MSISDN。
+4. 填写清晰的工单标题和问题描述。
+5. 按需上传截图、日志或结果文件。
+6. 核对创建人信息后提交。
+
+问题描述建议包含：发生时间、影响范围、卡号、设备所在地、预期结果、实际现象、已执行的同步或诊断操作。不要在附件中上传 API 密钥、账号密码等敏感信息。
+
+![创建工单表单](/images/manual/work-order-create-form-attachment.png)
+
+## 沟通与处理
+
+点击工单右侧“沟通”；工单已结束时按钮显示为“查看”。工单问题沟通页会显示历史消息、附件、工单信息和处理轨迹。
+
+![工单沟通入口](/images/manual/work-order-communication-entry.png)
+
+- 在输入区填写回复内容，或按权限上传附件后发送。
+- 平台回复后可继续补充信息，尽量在同一工单中保持上下文完整。
+- 有转单权限时，可把工单转交其他处理方。
+- 问题确认解决后可执行“解决”；不再需要处理时可“取消”。
+- 工单完成后可“关闭”，并按 1 至 5 分提交满意度和评价内容。
+
+![工单沟通与处理操作](/images/manual/work-orders-communication.png)
+
+![已关闭工单的服务评价入口](/images/manual/work-orders-closed-evaluation.png)
+
+按钮是否出现取决于工单当前状态和用户权限。已完结或已取消的工单通常只能查看。
+
+## 工单记录
+
+**入口：** 左侧菜单 → **工单管理 → 工单记录**。
+
+![工单记录页面入口](/images/manual/work-orders-records-entry.png)
+
+该页面用于审计工单流转，可按工单编号和操作类型查询。主要字段包括操作类型、操作机构、操作用户、目标部门、目标用户、变更前状态和变更后状态。
+
+常见操作类型为创建、分派、处理、完成、关单和取消。需要核对“谁在何时改变了工单状态”时，以此页面记录为准；如已授权，可查看详情或导出当前查询结果。
+
+## 何时新建工单
+
+- 同一张卡完成状态同步和智能诊断后仍无法联网。
+- 批量任务在执行日志中失败，错误原因无法自行处理。
+- 套餐、费用或归属与实际业务不符。
+- 页面持续报错，且刷新或重新登录后仍可复现。
+
+同一问题不要重复创建多个工单。补充信息应在原工单的沟通页继续发送。