docs: sync reviewed public manuals

Sync manuals, navigation and screenshots from open-source c8fa783 while preserving public README, LICENSE and history.
2026-10-26 16:10:40 +08:00
parent 92f239fcc4
commit 19455e1cbc
152 changed files with 812 additions and 241 deletions
@@ -17,7 +17,7 @@ features:
  - title: 版本选型指引
    details: 使用浏览器登录企业管理后台，请阅读 Web 端手册；使用 IOTLCM 物联卡用户服务小程序，请阅读小程序端手册。不同端的功能入口、权限和页面结构有所区别。
  - title: Web端
-    details: 面向企业管理员和业务人员，覆盖首页、卡信息、智能诊断、业务受理、企业管理、工单、API 凭证与执行日志。
+    details: 面向企业及平台管理人员，覆盖查卡、诊断、业务受理、套餐定价、流量池、预警、入出库、通道、企业权限、工单和执行日志。
  - title: 小程序端
-    details: 对应 iotlcm-app v1.0.1，覆盖首页公开查卡、扫码与拍照识别、卡片详情、卡片排查和账号密码登录；办理、绑定、微信登录及注册等功能暂未开放。
+    details: 当前小程序版本为v1.0.2。无需登录可使用公开查卡和卡片排查；登录后可使用账号获授权的设备、办理和服务功能。
 ---
@@ -0,0 +1,61 @@
+# 登录后办理概览
+
+登录后的页面会根据账号工作区和权限动态显示。看不到某个入口时，通常是账号未配置对应权限，或该业务仍受版本开关限制。
+
+## 登录与身份选择
+
+1. 在首页或需要账号数据的页面进入登录，选择“密码登录”或“验证码登录”。
+
+   ![账号密码登录入口](/images/manual/mini-program/business-account-login-entry.png)
+
+2. 密码登录支持手机号或用户名；验证码登录需要手机号、图形验证和短信验证码。
+
+   ![账号登录中的密码登录和验证码登录选项](/images/manual/mini-program/business-login-methods.jpg)
+
+3. 同一登录凭据匹配多个身份时，按页面提示选择本次进入的账号。
+
+注册、微信登录和“忘记密码”页面当前关闭。无法登录时联系账号管理员或客服。
+
+## 设备与卡片操作
+
+登录后点击底部“设备”进入设备列表，或从“办理”进入“我的卡片”。设备页支持关键词搜索、状态筛选、刷新和加载更多；卡片详情显示账号权限范围内的字段及会话、流量信息。首页最多预览三张卡片，并优先展示即将到期的卡；点击“管理”进入全部设备。
+
+<div 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/business-device-tab.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-my-cards-entry.jpg" alt="从办理页面进入我的卡片" style="display: block; width: 100%; height: auto;">
+    <figcaption style="text-align: center;">“办理”中的“我的卡片”入口</figcaption>
+  </figure>
+</div>
+
+续费、变更加油包、停机、复机等卡片更多操作当前暂未开放。重启、数据服务操作和卡片划拨可按页面位置、账号权限及卡片状态开放。页面只显示当前账号可执行的操作，提交前仍会再次校验。
+
+## 办理入口
+
+“办理”页包含卡片排查、卡片与客户、工单和执行记录等分组。当前版本按权限开放以下能力：
+
+| 能力 | 入口与说明 |
+| --- | --- |
+| 卡片排查 | 输入 ICCID、MSISDN 或 IMSI，查看状态、会话和流量信息 |
+| 卡片划拨 | 选择启用的直属下级客户和卡片；单次最多100张，提交后到批次日志查看结果 |
+| 客户管理 | 查看授权范围内的企业客户及客户详情；终端账号不显示此入口 |
+| 工单服务 | 按列表、提交、详情和处理权限使用相应操作 |
+| 批次执行日志 | 按列表、概览和明细权限查看批次进度与结果 |
+
+续费、变更与加油包当前暂未开放；订单、预警和余额充值等页面仍受版本开关限制，进入时可能提示暂未开放。
+
+## 专题说明
+
+- [客户管理与卡片划拨](./customers-and-allocation)
+- [工单服务](./work-orders)
+- [批次执行日志](./execution-logs)
+- [消息与个人中心](./messages-and-profile)
+
+## 操作提示
+
+- 划拨提交后不要重复创建任务；结果未确认时先核查批次日志和卡片归属。
+- 工单附件上传失败时检查网络后重试；不要在反馈中提交无关敏感信息。
+- 所有状态和排查结果仅供业务处理参考，最终以运营商和平台实际结果为准。
@@ -0,0 +1,60 @@
+# 客户管理与卡片划拨
+
+本页介绍企业、代理及平台工作区中的客户查询和卡片划拨。入口按账号身份和权限显示；终端账号不提供客户管理入口。
+
+## 客户管理
+
+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;">
+     <figure style="margin: 0;">
+       <img src="/images/manual/mini-program/customer-management-from-profile.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/customer-management-from-business.png" alt="从办理页面进入客户管理" style="display: block; width: 100%; height: auto;">
+       <figcaption style="text-align: center;">“办理”中的客户管理入口</figcaption>
+     </figure>
+   </div>
+
+2. 输入企业名称或手机号搜索客户，也可刷新列表或加载更多。
+
+   ![客户管理中的搜索框和刷新入口](/images/manual/mini-program/customer-management-search.png)
+
+3. 点击客户查看详情，包括客户资料、客户类型和实名信息。
+
+   ![客户详情中的客户类型、实名资料状态和持卡统计](/images/manual/mini-program/customer-details-v102.png)
+
+4. 客户详情中的卡片数量和状态统计仅统计该客户直接持有的卡，不包含下级客户。
+
+列表及详情分别需要对应权限。若搜索无结果，检查名称或手机号；若没有入口，联系账号管理员确认账号类型和授权范围。
+
+## 单卡划拨
+
+从卡片详情有权限时显示的“划拨这张卡”入口开始。确认目标客户后检查卡片信息并提交。单卡入口会锁定当前卡，不能改选其他卡。划拨成功后卡片归属转给目标客户。
+
+## 批量划拨
+
+1. 从“办理”进入“卡片划拨”。
+
+   ![从办理页面进入卡片划拨](/images/manual/mini-program/card-allocation-entry-v102.png)
+
+2. 选择目标客户：仅支持已启用的直属下级客户，可按客户名称或编码搜索。
+
+   ![批量卡片划拨中的目标客户选择入口](/images/manual/mini-program/allocation-target-customer-v102.jpg)
+
+3. 搜索并勾选要划拨的卡片。可以选择当前结果；更换搜索条件后，先前选择仍保留。打开已选列表可移除单张或清空选择。
+
+   ![批量划拨中选择目标客户、勾选卡片和查看已选入口](/images/manual/mini-program/allocation-select-cards-v102.jpg)
+
+4. 每次最多选择100张。停机、销户或套餐过期的卡不可划拨。
+5. 核对目标客户和卡数后提交。后台会整批校验；存在失败卡时整批不执行。
+6. 提交后进入批次日志查看进度和结果。任务处理中时使用原页面的刷新操作查看状态。
+
+   ![卡片划拨提交后的批次执行日志、进度结果和刷新入口](/images/manual/mini-program/allocation-batch-logs-v102.png)
+
+若网络中断导致结果未知，不要再次新建划拨任务。先通过原批次号查看日志并核对卡片归属；只有确认原任务未受理且没有待执行任务后，才按页面提示核查并重试原任务。仍无法确认时联系管理员处理。
+
+## 权限与边界
+
+划拨入口要求企业、代理或平台工作区及卡片划拨权限。目标客户和卡片仍受账号数据范围约束。执行记录列表、概览和明细分别受批次日志权限控制；划拨页面可能提供与本次任务关联的结果查看入口。
@@ -11,23 +11,22 @@

 ![卡片详情中的基础信息和流量信息](/images/manual/mini-program/card-details-traffic.png)

-卡号可能已经脱敏，页面显示什么就以什么为准。点击或长按卡号行可以复制当前显示值。
+卡号可能已经脱敏，已页面显示为准。点击或长按卡号行可以复制当前显示值。

 公开模式不会展示完整 IMSI、IMEI、备注、总流量、剩余流量、会话信息、APN、IPv4、IPv6 和服务状态，也不会提供重启、开通数据、停用数据等操作按钮。

 ## 登录后详情

-登录并通过权限校验后，设备列表和卡片详情可以展示更完整的账号范围数据，例如 MSISDN、ICCID、IMSI、设备 IMEI、套餐流量和同步时间。字段是否出现取决于接口返回值和账号权限。
+登录并通过权限校验后，设备列表和卡片详情可以展示更完整的账号范围数据，例如 MSISDN、ICCID、IMSI、设备 IMEI、套餐流量、剩余流量、流量同步时间和会话信息。详情中的流量区域还可能显示昨日客户用量及其统计日期。字段是否出现取决于接口返回值和账号权限。

-<div style="display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; align-items: start;">
+<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/devices-list-account-data-v2.jpg" alt="登录后的设备列表和账号范围数据" style="display: block; width: 100%; height: auto;">
+    <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>
  </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;">
+    <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>
  </figure>
 </div>

@@ -37,3 +36,9 @@
 - 确认查询号码没有空格或遗漏字符；
 - 从首页重新查询后再点击“详情”；
 - 若页面提示当前账号没有权限，请使用公开查询，或联系账号管理员确认数据范围。
+
+## 卡片操作
+
+公开查询详情不会提供业务操作。登录后，卡片详情可按权限显示重启、开通或停用数据服务、卡片划拨及工单入口；操作也会受卡片状态和账号工作区限制。排查页的已用流量信息可在支持时点击同步刷新。当前版本关闭停机、复机等“更多操作”入口，续费、套餐变更和加油包尚未开放。
+
+![卡片详情中的快捷操作入口](/images/manual/mini-program/card-details-quick-actions.png)
@@ -9,24 +9,24 @@
 1. 首页点击“卡片排查”，手动输入卡号；
 2. 首页查询成功后点击“卡片排查”，系统会带入当前查询值；

-![首页查询结果中的卡片排查入口](/images/manual/mini-program/diagnosis-entry-from-query-v2.png)
+![首页查询结果中的卡片排查入口](/images/manual/mini-program/diagnosis-entry-from-query-v3.png)

 3. 直接打开卡片排查页，在输入框填写 `ICCID`、`MSISDN` 或 `IMSI`。

-<div style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start;">
+<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/diagnosis-entry-from-home.png" alt="从首页常用入口进入卡片排查" style="display: block; width: 100%; height: auto;">
+    <img src="/images/manual/mini-program/diagnosis-entry-from-home-v102.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/diagnosis-manual-input.jpg" alt="卡片排查页手动输入卡号" style="display: block; width: 100%; height: auto;">
+    <img src="/images/manual/mini-program/diagnosis-manual-input-v102.png" alt="卡片排查页手动输入卡号" style="display: block; width: 100%; height: auto;">
    <figcaption style="text-align: center;">输入卡号开始排查</figcaption>
  </figure>
 </div>

 点击“开始排查”提交。排查过程中不要连续重复点击。

-## 结果摘要
+## 结果摘要与卡片操作

 普通用户或未登录用户通常可以看到：

@@ -36,11 +36,15 @@

 管理员账号可能看到更多卡片、数据服务、停机冻结和限制策略信息。页面会按实际接口返回值隐藏没有数据的字段。

+账号有对应权限且卡片可办理时，排查结果可提供“重启卡”“开通数据服务”或“停用数据服务”操作。按钮随账号权限、卡片状态和数据服务状态变化；提交前确认卡号和操作，完成后以页面提示及业务系统状态为准。卡片详情同样可显示重启、数据服务操作，以及有权限时的划拨入口。
+
+当前版本停机、复机等卡片更多操作入口关闭；这不影响在办理页或卡片详情中使用已开放且获授权的卡片划拨。
+
 ## 流量使用分析

-当前页面提供“近1个月、近3个月、近6个月”三个周期。**`v1.0.1` 默认只对顶层管理员显示流量趋势模块；其他账号即使登录，也不保证看到该模块。**
+当前页面提供“近1个月、近3个月、近6个月”三个周期。**当前版本只对顶层管理员显示流量趋势模块；其他账号即使登录也看不到该模块。**

-有数据时会显示周期总用量、日均或月均用量、单期峰值和趋势图；没有数据时显示“暂无历史流量数据”。趋势只用于辅助排查，不等同于实时计费结果。
+有数据时会显示周期总用量、日均或月均用量、单期峰值和趋势图；没有数据时显示“暂无历史流量数据”。

 ## 排查结果的处理方向

@@ -56,6 +60,8 @@

 ## 当前版本限制

-排查页的“重启卡”“开通数据服务”“停用数据服务”按钮只有在登录且账号拥有对应权限时才会出现。业务办理路由、套餐、预警、订单和工单在 `v1.0.1` 中暂未开放。
+排查页的“重启卡”“开通数据服务”“停用数据服务”按钮只有在登录且账号拥有对应权限时才会出现。工单、客户管理和卡片划拨已在当前版本按权限开放；续费、变更与加油包暂未开放，预警、订单及余额充值等功能仍受版本开关限制。

 排查接口或流量接口提示请求过于频繁时，请等待一段时间后再试，不要连续提交。
+
+排查结果的已用流量信息在支持时可点击“重新同步流量”刷新。同步仍受上游服务频率限制；若提示限频，等待页面提示的时间后再试，不要连续点击。趋势图中未采集周期不会按 0MB 计算；暂无数据不代表用量为零。
@@ -0,0 +1,34 @@
+# 批次执行日志
+
+批量划拨等任务提交后，可通过“我的”或“办理”中的“批次执行日志”查看执行记录。入口、批次概览和明细分别受权限控制。
+
+## 查询批次
+
+1. 按批次编号搜索，或展开筛选条件。
+2. 可按渠道、操作模式、录入方式和执行状态组合筛选；点击刷新重新查询，清除筛选可恢复完整列表。
+
+   ![批次执行日志中的批次编号搜索、筛选条件和刷新入口](/images/manual/mini-program/execution-log-filters-v102.png)
+
+3. 点击记录查看批次概览和执行明细；需要时刷新详情，或切换为仅查看失败项。
+4. 列表支持加载更多。划拨任务可能从划拨页面直接打开关联批次详情。
+
+   <div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px; align-items: start;">
+     <figure style="margin: 0;">
+       <img src="/images/manual/mini-program/execution-log-load-more.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/execution-log-allocation-entry.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/execution-log-allocation-details.png" alt="划拨任务概览和逐卡执行明细" style="display: block; width: 100%; height: auto;">
+       <figcaption style="text-align: center;">划拨任务概览与卡片明细</figcaption>
+     </figure>
+   </div>
+
+记录会显示批次号、提交渠道、操作类型、录入方式和执行状态。明细权限不足时仍可能看到列表或概览，但无法查看逐卡结果；具体字段按接口权限和返回数据展示。
+
+## 状态未确认
+
+任务处于待处理或处理中时，刷新原批次查看进度。若提交后网络中断且页面提示结果未确认，不要新建相同任务；保留原批次号，先查看日志并核对卡片归属。只有确认任务未受理且不存在待执行任务后，才能按页面提示重试原任务。
@@ -1,45 +0,0 @@
-# 常见问题
-
-## v1.0.1 有哪些可用功能？
-
-无需登录即可在首页手动输入、扫码或拍照识别卡号，并查看公开详情和卡片排查结果。已有账号可以使用账号密码登录，查看权限范围内的设备数据。
-
-## 为什么底部没有“办理”Tab？
-
-`v1.0.1` 关闭了办理 Tab。套餐续费、加油包、套餐变更、停复机、预警、订单、工单和客户管理等路由也暂未开放，直接访问会提示当前版本暂未开放此功能。
-
-## 为什么设备页看不到卡片？
-
-设备页读取登录账号的卡片范围。未登录时请回到首页使用公开查卡；登录后仍为空时，请确认账号已分配卡片或具备相应权限。
-
-## 支持哪些查卡方式？
-
-首页支持输入 `ICCID`、`MSISDN`、`IMSI` 或 `IMEI`，也支持扫码读取内容和从相机或相册拍照识别 ICCID。
-
-## 拍照识别失败怎么办？
-
-请拍摄单张、平整、完整、无反光的卡片，并确保 ICCID 清晰。识别超时或频繁请求时等待后重试；也可以改用扫码或手动输入。
-
-## 公开详情为什么字段少？
-
-公开模式只展示卡号、卡状态、在线状态和已用流量。完整 IMSI、IMEI、会话、APN、IP、服务状态等字段属于受限数据。
-
-## 为什么不能绑定卡片或执行重启？
-
-卡片绑定和“更多操作”在 `v1.0.1` 中统一关闭。即使登录，当前版本也不会提供绑定、套餐办理、停复机、数据服务变更和预警配置入口。
-
-## 为什么看不到流量趋势？
-
-流量趋势模块当前只对顶层管理员开放，且接口必须返回有效历史数据。其他账号或没有历史数据时不会显示趋势图。
-
-## 为什么排查显示离线或未查询到会话？
-
-先检查设备供电、开机状态、信号、天线和 APN，再稍后重新排查。“未查询到会话”只表示当前没有查到数据会话，不等同于卡片已销户。
-
-## 账号密码登录有什么限制？
-
-当前版本只开放已有账号的账号密码登录；微信登录和注册账号未开放。忘记密码页面会提示短信服务接入后开放，请联系管理员或客服处理账号问题。
-
-## 排查结果是否是最终结论？
-
-不是。排查结果仅用于辅助判断，最终以运营商和业务系统状态为准。请勿在查询、排查和反馈内容中提交身份证号、银行卡号或其他无关敏感信息。
@@ -4,29 +4,29 @@

 ## 登录入口

-首页和登录页都保留“未登录也可查卡”入口。需要查看账号名下设备时，再通过账号密码登录；微信登录和注册账号暂未开放。
+首页和登录页都保留“未登录也可查卡”入口。需要查看账号名下设备时，可使用密码或手机号短信验证码登录。同一凭据关联多个身份时，按提示选择本次要进入的身份。

 ## 手动查询

 1. 在“卡片查询”输入框输入完整的 `ICCID`、`MSISDN`、`IMSI` 或 `IMEI`。
 2. 点击“查询”，等待查询完成。

-![点击查询并等待查询完成](/images/manual/mini-program/query-complete.png)
+![点击查询并等待查询完成](/images/manual/mini-program/query-complete-v102.png)

-3. 查询成功后，结果区域显示卡号、使用流量和在线状态。
-4. 点击“详情”查看公开卡片详情，或点击“卡片排查”查看状态摘要。
+3. 查询成功后，结果区域显示卡号、卡状态、已用流量和在线状态；卡号可以点击或长按复制。
+4. 点击结果中的“查看详情”查看公开卡片详情；点击查询框下方的“卡片排查”会带入卡号查看状态摘要。公开查询未找到卡片时，页面也可能直接转入排查页继续核对。

-<div style="display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; align-items: start;">
+<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 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;">
+    <img src="/images/manual/mini-program/query-actions-updated-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/card-details-v2.jpg" alt="卡片详情页展示的公开字段" style="display: block; width: 100%; height: auto;">
+    <img src="/images/manual/mini-program/public-card-details-updated-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/card-diagnosis-v2.jpg" alt="卡片排查页展示的状态摘要" style="display: block; width: 100%; height: auto;">
+    <img src="/images/manual/mini-program/card-diagnosis-updated-v102.png" 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.png)
+![首页拍照入口](/images/manual/mini-program/photo-entry-v102.png)

 2. 从相机或相册选择一张卡片图片。
 3. 确保图片中只有一张卡片，并且 ICCID 完整、清晰、无反光。
@@ -62,6 +62,25 @@
 | 未能识别清晰的 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)
@@ -4,7 +4,7 @@ title: 小程序端使用手册

 # 小程序端使用手册

-本文介绍 iotLCM 平台当前已开放的页面及操作功能，具体可用内容以账号实际权限为准。当前版本以**公开查卡和状态排查**为主，业务办理入口暂未开放。
+当前小程序版本为v1.0.2。无需登录可使用公开查卡和卡片排查；登录后可使用账号获授权的设备、办理和服务功能。

 <div class="mini-program-entry">
  <figure class="mini-program-entry__qr">
@@ -20,17 +20,22 @@ title: 小程序端使用手册
 | --- | --- | --- |
 | 首页 | 已开放 | 手动输入、扫码、拍照识别并查询卡片 |
 | 卡片详情 | 已开放 | 公开查询只展示卡号、卡状态、在线状态和已用流量 |
-| 卡片排查 | 已开放 | 输入卡号查看状态摘要；流量趋势仅对管理员账号显示 |
-| 账号密码登录 | 已开放 | 企业、代理商和终端用户使用已有账号登录 |
-| 设备列表 | 登录后使用 | 显示当前账号权限范围内的卡片；未登录不要用此页进行公开查卡 |
-| 办理、订单、工单、预警、开停数据等 | 暂未开放 | 入口或路由会提示“当前版本暂未开放此功能” |
-| 微信登录、注册、绑定卡片、卡片更多操作 | 暂未开放 | 本版本不提供这些入口 |
+| 卡片排查 | 已开放 | 输入卡号查看状态摘要；历史流量趋势仍限顶层管理员 |
+| 登录 | 已开放 | 支持账号密码或手机号短信验证码；多个身份时选择本次账号 |
+| 设备列表 | 登录后使用 | 查看账号权限范围内的卡片，支持搜索、筛选、刷新和详情 |
+| 办理 | 登录后按权限显示 | 卡片排查、卡片划拨、客户管理、工单和批次日志等按身份与权限显示 |
+| 消息与我的 | 登录后使用 | 查看站内消息、个人资料和授权的业务工作台入口 |
+| 续费、变更与加油包 | 暂未开放 | 当前版本暂未开放 |
+| 订单、预警、余额充值 | 暂未开放 | 当前版本暂未开放 |
+| 绑定卡片、停复机等卡片更多操作 | 暂未开放 | 当前版本不提供这些操作；有划拨权限时可使用卡片划拨 |
+
+当前底部导航为“首页、设备、办理、我的”。

 ## 推荐流程

 1. 打开小程序首页，在“卡片查询”中输入 ICCID、MSISDN、IMSI 或 IMEI。

-![小程序首页卡片查询输入框](/images/manual/mini-program/home-card-query.png)
+![小程序首页卡片查询输入框](/images/manual/mini-program/home-card-query-v102.png)

 2. 也可以点击“扫码”读取卡片条码，或点击“拍照”识别卡片上的 ICCID。

@@ -42,52 +47,62 @@ title: 小程序端使用手册

 4. 需要查看公开字段时点击“详情”；需要判断异常原因时点击“卡片排查”。

-<div style="display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 12px; align-items: start;">
+<div class="manual-image-grid" style="display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 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;">
+    <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;">
    <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;">
+    <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;">
    <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;">
+    <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;">
    <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 style="display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; align-items: start;">
+<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/login-entry-home.jpg" alt="从首页底部的我的入口进入登录" style="display: block; width: 100%; height: auto;">
+    <img src="/images/manual/mini-program/login-entry-home-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/login-page-entry.jpg" alt="登录页中的账号密码登录入口" style="display: block; width: 100%; height: auto;">
+    <img src="/images/manual/mini-program/login-page-entry-v102.png" alt="登录页中的账号密码登录入口" style="display: block; width: 100%; height: auto;">
    <figcaption style="text-align: center;">账号密码登录</figcaption>
  </figure>
 </div>

-2. 输入已有账号和密码，完成页面要求的安全验证后点击“登录”。
+2. 选择“密码登录”，输入已有手机号或用户名及密码，点击“登录”；或选择“验证码登录”，输入手机号，获取验证码时完成滑块验证，再输入收到的短信验证码登录。

-![账号密码登录表单](/images/manual/mini-program/account-password-login.png)
+![密码登录与验证码登录选项](/images/manual/mini-program/account-login-methods-v102.png)

 3. 如果同一账号匹配多个登录身份，按页面提示选择本次要进入的账号。
 4. 登录成功后返回原页面；设备页会按账号权限加载卡片数据。

-![登录后设备页按账号权限加载卡片数据](/images/manual/mini-program/devices-page.png)
+![登录后首页显示账号权限范围内的我的设备](/images/manual/mini-program/login-success-home-v102.png)

-当前版本不开放注册和微信登录。“忘记密码”页面会提示短信服务接入后开放，无法登录时请联系账号管理员或客服。
+当前版本未开放注册、微信登录和找回密码。无法登录时请联系账号管理员或客服。

 ## 使用边界

- 公开查询和排查结果仅供辅助判断，最终以运营商和业务系统状态为准。
 - 未登录查询不会展示完整 IMSI、IMEI、APN、IP、套餐内部信息等受限字段。
 - 请勿在查询、排查或反馈内容中提交身份证号、银行卡号等无关敏感信息；密码只应填写在登录表单中。

@@ -96,4 +111,8 @@ title: 小程序端使用手册
 - [首页查卡、扫码与拍照](./home)
 - [卡片详情](./devices)
 - [卡片排查](./diagnosis)
- [常见问题](./faq)
+- [登录后办理概览](./business)
+- [客户管理与卡片划拨](./customers-and-allocation)
+- [工单服务](./work-orders)
+- [批次执行日志](./execution-logs)
+- [消息与个人中心](./messages-and-profile)
@@ -0,0 +1,24 @@
+# 消息与个人中心
+
+登录后从底部“我的”进入“消息中心”及账号功能。可见内容按当前账号及接口返回数据决定。
+
+## 消息中心
+
+1. 在“我的”点击“消息中心”，查看流量预警、卡片消息、订单通知和系统通知模块及未读数。平台公告等消息可在实际归属的模块中查看，通常归入“系统通知”。
+
+   ![从我的页面进入消息中心](/images/manual/mini-program/message-center-entry.png)
+2. 进入模块后，可按消息标题或内容搜索，并选择最新优先、最近30天或时间正序；点击刷新重新加载。
+3. 点击消息查看详情。进入模块后可将当前模块未读消息全部标记为已读。
+4. 工单相关通知可跳转工单详情，但仍需工单详情权限；无效链接或无权限时返回消息页并联系管理员。
+
+“消息提醒”设置入口会转到消息中心。当前版本的流量预警通知通过站内消息查看，不代表会发送微信模板消息或推送。
+
+## 我的
+
+- **业务工作台**：有对应权限时显示工单、客户管理和批次执行日志入口。只有工单提交权限时进入提交页面。
+- **个人资料**：终端用户可编辑个人及客户资料并保存；企业、代理及平台账号只能查看资料，资料变更由管理平台维护。账号安全区域可查看手机号、邮箱、密码入口和微信绑定状态。
+- **实名认证**：查看实名状态、登记名称、联系电话和客户类型；企业类账号还可查看客户编码及联系地址。该页面用于查看信息。
+- **微信绑定**：可在微信小程序中绑定、更换或解除当前微信。解除绑定会移除当前微信与账号的关联；操作前先确认可通过密码或短信验证码登录。微信登录入口在本版本仍未开放。
+- **退出登录**：在“我的”页或个人资料账号安全区域点击退出并确认。
+
+帮助与反馈页面当前为静态说明入口，不提供在线提交反馈或工单操作；问题请通过工单服务或页面列出的客服联系渠道处理。
@@ -0,0 +1,56 @@
+# 工单服务
+
+登录后可从“办理”或“我的”进入工单服务。卡片详情中的反馈入口可自动带入关联业务并锁定工单类型。列表、提交、详情及处理操作分别受权限控制；只有提交权限的账号仍可直接新建工单。
+
+## 提交工单
+
+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;">
+     <figure style="margin: 0;">
+       <img src="/images/manual/mini-program/work-orders-business-entry-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/work-orders-submit-entry-v102.png" alt="工单列表右上角的提交工单入口" style="display: block; width: 100%; height: auto;">
+       <figcaption style="text-align: center;">工单列表中的提交入口</figcaption>
+     </figure>
+   </div>
+
+2. 填写标题、创建人手机号和问题描述。创建人手机号必填，须为有效的11位手机号。
+3. 标题最多100字，描述最多2000字。最多添加6个附件，每个附件不超过10 MB。
+
+   ![提交工单的标题、问题描述和附件填写页面](/images/manual/mini-program/work-order-submit.jpg)
+
+4. 核对内容并提交。有工单列表权限时，可在列表查看状态；仅有提交权限时，工单由服务部门继续处理。
+
+附件上传或提交失败时检查网络、文件大小和附件数量后重试。不要反复提交已经显示成功的工单。
+
+## 查看工单
+
+列表可按“全部相关”“我提交的”“我收到的”查看（是否出现取决于角色），按全部、已分派、处理中、待确认、已完结或已取消筛选；搜索支持工单编号、标题和内容。使用“加载更多”浏览较早记录。
+
+![工单列表中的查看范围、搜索和状态筛选](/images/manual/mini-program/work-order-list-filters.png)
+
+点击有详情权限的工单查看描述、附件、状态流转和沟通记录。沟通详情会自动刷新，也可手动刷新或加载历史记录。附件可在支持的格式和平台中预览或下载；旧附件若未保存原始文件名，显示名称可能来自文件地址。
+
+![工单详情中的基本信息、问题描述、工单沟通和处理进度](/images/manual/mini-program/work-order-details-v102.png)
+
+## 工单跟进
+
+页面按当前工单状态和角色显示可执行操作：
+
+| 操作 | 适用情况 |
+| --- | --- |
+| 回复 | 创建人或当前处理方在可沟通状态补充文字或附件 |
+| 标记解决 | 当前处理方完成处理后通知创建人确认 |
+| 转单 | 有转单权限的处理方将工单转交给同租户的顶级部门及其负责人；转单后原处理方可能失去办理权限 |
+| 关单 | 当前处理方在已标记解决、等待创建人确认时，可按权限关闭工单 |
+| 反馈未解决 | 创建人在待确认时填写未解决原因，工单重新进入处理中 |
+| 确认解决 | 创建人确认问题已解决，工单完结 |
+| 取消 | 创建人在允许的处理中状态取消工单；历史记录仍可查看 |
+| 评价 | 创建人对已完结工单提交一次1至5星评价 |
+
+**工单进入待确认后，如部署并运行了相应的队列或补偿处理服务，72小时未反馈的工单可能自动完结。**
+
+查看权限不代表可以办理其他人的工单。没有按钮或提示无权限时，联系账号管理员确认工单角色权限。
@@ -8,11 +8,13 @@

 页面显示本企业的企业 ID、企业名称、`appKey`（API 账号标识）和 `appSecret`（API 密钥），并提供复制按钮。接口鉴权和请求格式请配合 [OpenAPI 接口文档](/openapi/) 使用。

-::: warning appKey ≠ appId
+页面或旧截图可能将应用标识标成 `appId` 或显示“APPID复制成功”，当前复制操作实际取的是 `appKey`。请按下方说明及目标接口版本区分字段，不根据旧按钮文案替换请求参数。
+
+**appKey ≠ appId**
+
 - **`appKey`** 和 **`appSecret`** 仅用于调用 `/openapi/v3/query/token` 换取 token
 - **`appId`**（客户组织编码，如 `CUS-202601-0001`）由 token 接口返回，调用其他接口时在请求体中传入
 - 不要把 `appKey` 当作 `appId` 使用，两者是不同的概念
-:::

 ### 安全要求

@@ -22,32 +24,51 @@
 - 不同环境不要共用同一份配置文件。
 - 怀疑泄露时立即停止相关调用并联系平台支持更换凭证。

-复制后粘贴到配置前，检查是否带入多余空格或换行。接口返回鉴权失败时，先核对企业对应的 appId 与 appSecret 是否配套，再检查签名、时间戳和请求地址。
+复制后粘贴到配置前，检查是否带入多余空格或换行。获取 token 失败时，先核对本企业的 appKey 与 appSecret 是否配套；后续请求失败时，按对应版本的接口文档核对 token、appId 和请求地址，不要混用不同版本的鉴权参数。

-## 执行日志（暂未开放）
+## 执行日志

 **入口：** 左侧菜单 → **执行日志**。

+![执行日志入口与操作日志页面](/images/manual/execution-log-entry.png)
+
 批量续费、套餐变更、加油包、重启、停复机、划拨、达量断网等任务提交后，均应通过执行日志确认最终结果。

 ### 查询批次

-可按关键字、批次编号、批次类型、异步处理状态和创建时间查询。列表显示：
+可按关键字、批次编号、批次类型、发起渠道、操作规模、输入方式、异步处理状态和创建时间查询。
+
+![执行日志查询条件](/images/manual/web/execution-log-query.png)
+
+列表显示：

 - 批次编号和批次类型。
 - 来源方式，如 Excel 或批量输入。
+- 发起渠道（如 Web、小程序或接口）及操作规模（单卡、批量）；旧记录可能显示为未知，不能仅凭总数量推断来源。
 - 运行结果和异步状态。
 - 总数量、开始时间和结束时间。

 点击批次编号可查看逐卡明细，包括行号、ICCID、MSISDN、IMSI、明细状态和异常原因。点击“查看”可查看批次概要、失败原因、源文件、结果文件和处理时间。
+划拨批次的概要还显示划拨单位和接收单位；若目标按每张卡分别指定，接收单位会提示在逐卡明细中查看。核对划拨结果时，先看批次单位，再查看每张卡的接收方和失败原因。

 ### 处理失败任务

 1. 用提交时记录的批次号查询。
-2. 确认批次已结束，避免把“处理中”误判为失败。
+2. 核对批次和逐卡状态。“待处理”“处理中”或“待核查”尚无确定结果，应先等待或请平台核实，不要重复提交。
 3. 点击批次号查看失败卡及异常原因。
-4. 下载结果文件，修正卡号、状态、套餐或模板数据。
-5. 只重提失败且可修正的卡，不要整批重复提交。
+4. 有结果文件时下载核对；文件待生成、生成失败或暂无文件时，先查看逐卡明细。无文件或文件生成失败不代表卡片执行失败。
+5. 原批次结束后，只对确认失败且可修正的卡，核实当前卡片、套餐或归属状态后修正原因并重新提交，不要整批重复提交。划拨和出库还需按[结果有误时的处理步骤](./business-operations#划拨或出库结果有误时)核对。
 6. 无法处理的上游错误通过工单反馈，并附批次号和失败原因。

 常见失败原因包括卡号不属于当前企业、卡状态不允许办理、套餐不匹配、余额不足、模板字段错误、上游超时或重复业务仍在处理中。
+
+## 接口资源与权限组（管理员）
+
+获授权管理员可通过“接口资源”维护接口名称、权限标识、请求方法、路径、版本及启停状态；通过“API 权限组”维护组名称、编码、状态和包含的接口资源。具体页面名称与分组以当前菜单为准。
+
+1. 在接口资源中按名称、版本和状态查询目标接口，确认方法、路径及权限标识与已部署接口一致。
+2. 在权限组中新增或编辑所需资源集合，核对启用状态后保存。
+3. 根据企业实际授权关系核对可访问范围；不要将持有 API 密钥理解为可调用全部接口。
+4. 变更后由获授权的接口调用方按对应 OpenAPI 文档验证，保留脱敏错误信息用于排查。
+
+配置资源或权限组不会自动新增后端接口实现。此类权限维护与普通用户复制本企业 API 凭证是不同操作。
@@ -8,7 +8,7 @@

 页面按“套餐及数据”“生命周期”“预警中心”展示业务入口。每个入口都有独立按钮权限，未授权的入口不会显示。

-可能出现的业务包括：
+展示的业务包括：

 | 分类 | 业务 | 用途 |
 | --- | --- | --- |
@@ -25,7 +25,7 @@
 | 预警中心 | 流量预警配置 | 配置单卡流量阈值预警 |
 | 预警中心 | 流量池预警配置 | 配置流量池阈值预警 |

-## 通用办理方式（部分开放）
+## 通用办理方式

 不同业务会提供以下一种或多种数据来源：

@@ -33,24 +33,32 @@
 - **批量输入：** 通常每行一个 ICCID；部分业务支持每行填写 `ICCID MSISDN IMSI`。
 - **连续号段：** 填写 ICCID、MSISDN 或 IMSI 的起始值和结束值，适合连续卡段。

+当前页面提供的来源如下，不要把接口存在视为界面已提供入口：
+
+| 业务 | 当前页面来源 |
+| --- | --- |
+| 续费、加油包、开停数据、达量断网、重启、停复机、划拨、转销户 | Excel、批量输入 |
+| 变更套餐、退订、单卡预警 | Excel、批量输入、连续号段 |
+| 流量池预警 | Excel、批量输入，不支持连续号段 |
+
 标准操作流程：

 1. 选择业务入口和数据来源。
-2. 上传文件或输入卡号，提交预处理。
-3. 记录系统返回的批次号。
-4. 核对有效数量、失败数量、目标套餐、购买时长、生效方式、金额和余额等信息。
-5. 确认无误后提交正式任务。
+2. 上传文件或输入卡号；需要预处理的业务先提交校验。
+3. 记录系统返回的批次号。直接提交型业务按页面确认后提交，不必寻找不存在的预处理步骤。
+4. 对预处理型业务，核对有效数量、失败数量、目标套餐、购买时长、生效方式、金额和余额等信息。
+5. 确认无误后提交原批次的正式任务。
 6. 前往“执行日志”查询批次最终状态和失败原因。

-::: warning 提交前确认
-批量任务可能影响通信、套餐、费用或卡生命周期。提交前应抽查卡号、目标企业、套餐编码、阈值、生效方式和付款方式。不要重复提交仍在处理中的批次。
-:::
+### 提交前确认

-## 续费、变更与加油包（暂未开放）
+批量任务可能影响通信、套餐、费用或卡生命周期。提交前应抽查卡号、目标企业、套餐编码、阈值、生效方式和付款方式。不要重复提交仍在处理中的批次。
+
+## 续费、变更与加油包

 ### 续费套餐

-支持 Excel 或批量输入。预处理后选择可续费套餐、续费年限、续费日期和付款方式。余额支付时必须确认余额充足；线下支付时按页面要求完成线下确认。
+支持 Excel 或批量输入。预处理后选择可续费套餐、续费年限、续费日期和可用付款方式。余额支付时必须确认余额充足；当前续费页顶层机构可按返回条件选择付款方式，非顶层机构使用余额支付。线下支付仅在实际允许且已完成相应确认时使用。

 ### 变更套餐

@@ -60,27 +68,36 @@

 可选择“单卡加油包”或“流量池加油包”。单卡 Excel 需填写 ICCID 和加油包套餐编码；流量池 Excel 需填写流量池编码和套餐编码。预处理后核对数量、单价、总金额、付款账户和余额。

-## 生命周期和数据服务（部分开放）
+## 生命周期和数据服务

 重启、自主停机、自主复机、开停数据、转销户和退订通常支持 Excel 或批量输入。生命周期任务提交后不会立即在列表全部完成，应通过批次号在执行日志中跟踪。

+![业务受理页面中的生命周期业务入口](/images/manual/business-lifecycle-entry.png)
+
 - 重启适合设备长时间不在线且卡状态正常的场景。
 - 自主停机和关闭数据会中断通信，恢复前请确认业务窗口。
 - 转销户通常不可逆或需要人工处理，提交前必须复核卡号。
 - 划拨前确认目标企业，任务完成后卡的数据归属和可见范围会变化。

-## 达量断网批量配置（部分开放）
+**“开停数据”开关的是数据通信服务，不是 APN。** APN 目前只在[卡信息](./card-info)的会话信息、[智能诊断](./intelligent-diagnosis)的通信服务模块和通道测试结果中作为查询结果展示，业务受理没有单独的 APN 开停入口。需要变更 APN 相关配置时，先确认所属通道是否支持，不要用“开停数据”代替。

-在“业务受理”点击“达量断网”，可通过 Excel、批量输入或连续号段批量配置：
+另外，达量断网、区域限制等原因造成的断网不能通过重新开启数据服务或 APN 直接解除。诊断提示断网与在线会话需分别判断时，先处理真正的断网原因，再核对服务状态。
+
+## 达量断网批量配置
+
+在“业务受理”点击“达量断网”，当前页面通过 Excel 或批量输入配置，不显示连续号段入口：
+
+![业务受理中的达量断网入口](/images/manual/business-threshold-entry.png)

 1. 选择开启或关闭。
 2. 开启时填写阈值，单位为 MB，阈值必须大于 0，最多保留 3 位小数。
-3. 填写卡号或上传模板后提交。
-4. 记录批次号并在执行日志中检查结果。
+3. 按需设置“跨月保持断网”。开启后，因达量断网的卡即使跨账期恢复网络，也会再次自动断网，直至人工开网；开启前确认业务要求。
+4. 填写卡号或上传模板后提交。
+5. 记录批次号并在执行日志中检查结果。

 关闭配置表示不再按该阈值触发断网，不等同于立即恢复所有因其他原因停机的卡。

-## 达量断网页面（部分开放）
+## 达量断网页面

 **入口：** 左侧菜单 → **通讯管理 → 达量断网**。

@@ -89,11 +106,49 @@
 该页面用于查看和维护已有配置：

 - 可按 MSISDN、ICCID、IMSI、IMEI 或配置状态查询。
- 列表显示通道、所属公司、当前套餐、配置状态和阈值。
+- 列表显示通道、所属公司、当前套餐、配置状态、阈值及跨月保持断网设置。
 - 有编辑权限时，可修改开启/关闭状态及阈值。
 - 有删除权限时，可删除该卡的达量断网配置。
 - 有导出权限时，可按当前条件导出配置。

-批量新增或修改建议从“业务受理 → 达量断网”完成；单卡核对和调整可在本页面完成。
+![业务受理中的达量断网配置与 Excel 导入](/images/manual/business-operations-batch-threshold.png)

-![业务受理中的达量断网批量输入](/images/manual/business-operations-batch-threshold.png)
+## 划拨给下级客户
+
+划拨用于调整已有业务卡的归属，与库存卡首次出库不同。
+
+1. 进入“业务受理 → 划拨”，选择当前有权使用的输入方式。
+
+   ![业务受理页面中的划拨入口](/images/manual/business-allocation-entry.png)
+
+2. 选择系统返回的目标客户；目标列表为空时先确认客户关系及划拨权限。
+3. 上传最新模板或输入目标卡号，完成页面提供的预处理。
+4. 复核目标客户、有效卡数量和失败原因，再确认提交原批次。
+5. 保存批次号，在执行日志中核对逐卡结果；完成后查询卡片归属。
+
+划拨会改变数据归属和账号可见范围。不要将“任务已提交”当作已划拨成功，也不要在结果未确认时向其他客户重复划拨。
+
+## 划拨或出库结果有误时
+
+当前版本没有“回拨”或“撤销”按钮，划拨、出库出错后不能一键还原。按以下顺序处理：
+
+1. 先用批次号在[执行日志](./api-and-logs)核对批次和逐卡状态。若显示“待处理”“处理中”或“待核查”，结果尚未确认，应先等待或请平台核实，不要重复提交。
+2. 原批次结束后，只对逐卡结果已确认为“未执行”或“失败”的卡，分别在[卡信息](./card-info)或库存卡信息中核对当前归属、库存状态及正式卡记录。确认相关状态未变化后，修正原因，仅重新提交这些卡。
+3. 已成功但归属错误的卡，不要再次划拨到其他企业来“覆盖”错误结果。重复划拨会叠加归属变更记录，让后续核对更困难。
+4. 携带批次号、卡号清单、原归属企业、预期目标企业、当前实际归属、操作时间及相关订单号（如有）提交工单，请平台支持核实并给出处理方案。
+5. 处理完成后在[卡信息](./card-info)核对当前归属：列表中的“所属公司”或卡详情中的“所属企业”。订单和批次记录用于追溯处理过程，不单独作为当前归属已修正的依据。
+
+出库出错参照同样顺序：先看执行日志，再核对订单、库存与卡信息，不要用重复出库或备注掩盖问题。未执行或失败的卡还应确认是否仍在库存；已成功出库的卡会从库存列表移除，需在卡信息中确认正式卡及归属，不能仅凭库存列表查不到就判断出库成功。
+
+## 业务入口不可用时
+
+| 现象 | 处理方法 |
+| --- | --- |
+| 看不到某项业务 | 请管理员核对菜单及该业务的模板、预处理、提交权限 |
+| 可打开但无法下载模板或提交 | 不同操作有独立权限，应补齐所需权限后重试 |
+| 无可选套餐 | 核对当前套餐的可续费、可变更或加油包关系，以及套餐启用状态和价格 |
+| 预处理有失败项 | 按原因修正；正式提交前重新核对有效数量 |
+| 余额不足 | 核对付款账户、金额与付款方式，联系财务处理后再办理 |
+| 提交超时或结果不明 | 先查执行日志与卡片状态，避免重新创建相同任务 |
+
+页面没有配置操作行为的占位入口不属于可用业务。例如“添加安装位置”不能仅因显示在业务面板中就视为已可办理。
@@ -5,7 +5,7 @@
 左侧菜单 → **通讯管理 → 卡信息**。

 该页面是日常查卡的主要入口，可查询卡的身份标识、运营商状态、套餐、流量、归属企业、通道和到期情况。
-![日常查卡页面入口](/images/manual/card-info-main-entry.png)
+![日常查卡页面入口](/images/manual/web/card-info-main-entry.png)

 ## 查询卡片

@@ -25,6 +25,12 @@

 查询不到卡时，先确认使用的是完整卡号，再清空状态、时间和通道等附加条件重试。

+### 批量查询
+
+在列表上方点击“批量操作 → 批量查询”，每行填写 1 至 3 个号码值（ICCID、MSISDN、IMSI），多个号码以空格分隔，同一行应属于同一张卡；单次最多 1000 行。
+
+点击“查询”后，结果保留当前筛选条件和公司范围，可使用原有“导出”按钮导出。若结果少于预期，先核对号码及附加条件。完成后点击“清除批量查询”恢复普通查询。
+
 ## 列表信息

 | 字段 | 说明 |
@@ -46,14 +52,12 @@

 ## 查看卡详情

-点击目标卡右侧“查看”。详情上方展示：MSISDN、ICCID、IMSI、IMEI、卡状态、网络类型、流量同步时间、套餐总流量、到期时间、出库时间、当前套餐、已用流量、剩余流量、所属企业、所属通道、达量断网配置状态、限额、备注。
-
-![在卡信息列表点击“查看”打开卡详情](/images/manual/card-info-view-entry.png)
+点击列表中目标卡的 ICCID 打开详情。详情上方展示：MSISDN、ICCID、IMSI、IMEI、卡状态、网络类型、流量同步时间、套餐总流量、到期时间、出库时间、当前套餐、已用流量、剩余流量、所属企业、所属通道、达量断网配置状态、限额、备注。

 详情下方包含以下页签：

 - **会话信息：** APN、IPv4、IPv6、接入方式、在线状态、会话建立时间、实时 IMEI、开关机状态等。点击“刷新”重新查询；“未查询到会话”通常表示设备当前未建立数据会话，并不等同于卡已销户。
- **归属信息：** 当前套餐编号、套餐名称、所属企业和所属通道（所属通道不予展示）。
+- **归属信息：** 当前套餐编号、套餐名称、所属企业；通道信息以当前账号实际可见字段为准。
 - **主套餐：** 订单编号、套餐名称、套餐类型、订购状态、生效时间和到期时间。
 - **叠加套餐：** 加油包名称、总流量、支付方式和交易时间。
 - **变更历史：** 变更前后套餐、订购状态和办理时间。
@@ -64,15 +68,30 @@

 页面上的操作按钮以账号权限为准。

+![卡信息列表更多菜单中的常用操作](/images/manual/card-info-common-actions.png)
+
 - **备注：** 编辑本企业对卡片的业务备注，便于按项目、设备或使用场景检索。
 - **同步用量：** 向上游请求最新用量。同步成功后查看“流量同步时间”是否更新。
 - **同步状态：** 向上游请求最新运营商卡状态。
- **导出：** 按当前筛选条件导出卡信息。
+- **导出：** 按当前筛选条件导出第一页最多 2000 张卡的信息。匹配数量超过 2000 时，应按卡号、时间或其他条件分段查询并分别导出，核对各文件的记录数。
 - **诊断：** 在卡详情点击“诊断”，系统会携带当前 ICCID 跳转到智能诊断并自动查询。

-“批量操作”当前仍显示为待接入功能。
+列表行的“更多”菜单还可能显示**开通数据、停用数据、自主停机、自主复机、重启**。这些操作各有独立权限；选择后先核对确认框中的 ICCID 和操作名称，再点击“确认提交”。缺少 ICCID 的卡不能提交。

-![卡信息列表更多操作菜单](/images/manual/card-info-more-actions.png)
+单卡操作会创建业务任务；页面提示“任务已提交”或返回批次号不代表运营商侧已经完成。请在[执行日志](./api-and-logs)中按批次号核对最终状态，再刷新卡信息确认结果。
+
+列表“备注”弹窗目前只保存备注；出库时间、套餐周期和到期时间在此页为展示字段，不能通过“备注”入口修改。需要变更卡片业务信息时，使用对应的出库或套餐业务流程，并在提交后复核卡详情。
+
+## 单卡用量与历史月份
+
+列表和卡详情只显示当前账期的总流量、已用流量和剩余流量。需要按时间跨度看用量时，用以下两种方式：
+
+1. **趋势查看：** 在[智能诊断](./intelligent-diagnosis)执行一键诊断，结果中的流量趋势提供近 7 天、近 30 天和近 6 个月三档，适合判断设备是否持续上报、是否突增或长时间无流量。
+2. **逐月数值：** 需要某个月的确切用量时，通过 OpenAPI 的历史月用量接口按 ICCID 和月份（`yyyyMM`）查询，详见[旧版兼容接口 - 查询 SIM 历史月用量](/openapi/legacy/query)。该接口一次返回一个月份，查近 3 个月或近 6 个月需按月份分别调用。
+
+“近 1 个月 / 近 3 个月 / 近 6 个月”这组下拉项在**库存卡信息的“协议到期”条件**里，用于筛选协议到期时间，不是用量区间，两者不要混用。
+
+历史月份用量与当前账期的已用流量来自不同取数路径，口径和更新时间可能不同。跨月对比时先确认月份口径，不要直接把两个数值相减。

 ## 查看数据异常时

@@ -0,0 +1,41 @@
+# 通道与接入管理
+
+本章仅供有接入维护权限的平台管理员使用。企业日常查卡、诊断及业务受理通常不需要修改通道。入口为左侧菜单中的“通道模板”和“通道管理”。
+
+## 通道模板
+
+![通道模板查询入口](/images/manual/channel-template-query.png)
+
+1. 按模板标识、名称、模型或状态查询已有模板，优先使用已确认可用的模板。
+2. 新增时填写模板标识、名称、模型、状态及模板配置。
+3. 模型包括 `shared_token` 和 `direct`；必须与实际上游接入方式匹配。
+4. 模板配置按对应接入实现要求填写有效 JSON，保存后重新查看配置。
+
+模板影响引用它的通道。变更前核对关联通道和兼容性，不在公开手册、截图或工单里展示真实密钥。
+
+## 新增与维护通道
+
+![通道管理中的新增入口](/images/manual/web/channel-add-entry.png)
+
+1. 在“通道管理”新增，填写通道名称、别名、编号、运营商及模板。
+2. 按模板要求配置应用标识、密钥、地址等接入信息，不将凭证填入名称或备注。
+3. 分别核对通道状态、是否正常、是否轮询、共享 Token 及对接信息；这些配置含义不同，不能互相代替。
+4. 保存后打开详情核对，并使用通道测试验证上游返回。
+5. 需要时使用“刷新卡数量”，再核对库存、已出库及已销户数量。
+
+未开启共享 Token 的通道修改编号时，系统会提示迁移关联数据并刷新通道实例。确认前核对旧编号、新编号和关联业务，不把它当作仅修改显示名称。已开启共享 Token 的通道不能在页面修改编号。
+
+## 通道测试
+
+1. 在目标通道点击“测试”，选择“单码直测”“单码补全”或“完整三码”。
+
+   ![通道管理列表中的测试入口](/images/manual/channel-test-entry.png)
+
+2. 单码模式选择 ICCID、IMSI 或 MSISDN 并输入对应值；“单码直测”直接使用所填号码调用查询接口，“单码补全”会先查询完整卡信息再测试。“完整三码”需填写同一张卡的 ICCID、IMSI 和 MSISDN。部分电信接口只能按 MSISDN 查询，测试前应选用适合该通道的模式。
+
+   ![通道测试中的单码直测、单码补全和完整三码模式](/images/manual/web/channel-test-modes.jpg)
+
+3. 选择全部测试项或单项测试。测试项包括基础信息、实时会话、卡状态、停机原因、冻结、机卡绑定、设备、区域限制、IMEI、流量及 APN 等。
+4. 执行后逐项查看成功、失败或超时结果。需要重试时先核对失败原因，只重试相关项目。
+
+某一查询成功不代表所有上游能力均已支持。测试失败时核对模板、凭证、请求地址、上游授权和卡片所属通道，避免高频重复请求。
@@ -16,52 +16,67 @@

 **入口：** 左侧菜单 → **企业管理 → 角色管理**。

-![角色管理页面入口](/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)
+   ![角色管理中的新增角色入口](/images/manual/role-create-entry.jpg)

-6. 保存后回到“用户管理”，将角色分配给用户。
-![在用户管理中分配角色](/images/manual/assign-role-to-user.png)
+2. 填写角色名称和角色权限字符，例如 `agentUser`；角色权限字符用于标识角色，具体页面和操作权限通过“菜单权限”勾选。
+3. 设置角色状态为“正常”或“停用”，按需填写备注。
+4. 在“菜单权限”中选择需要的目录、页面和按钮。可选范围受本机构已获授权的权限限制，不能授予范围之外的权限。默认不启用“父子联动”，勾选父项不会自动选中全部子项；需要联动选择时可勾选“父子联动”，并核对最终选择。

-本级机构绑定的默认角色不能修改或删除。新增自定义角色时遵循最小权限原则，不要为普通查询人员授予企业删除、用户删除、角色修改或批量业务提交权限。
+   ![新增角色时选择菜单权限及父子联动选项](/images/manual/web/role-menu-permissions.png)
+
+5. 保存后回到“用户管理”，为用户选择相应角色。用户表单不会提供用于下发的管理员角色供普通用户选择。
+
+   ![在用户管理中分配角色](/images/manual/web/assign-role-to-user.png)
+
+本级新增角色用于本机构用户授权；下级企业的默认管理员权限由系统的默认角色及下发规则管理，需要调整时联系上级或平台管理员。
+
+为用户配置角色时，只勾选其工作所需的页面和操作，并在分配后核对实际可见菜单及可用按钮。
+
+### 顶级与下级账号的权限核对
+
+账号层级本身不会自动开放整组功能。平台授权管理员可维护[通道](./channels)、[接口资源与权限组](./api-and-logs)及角色；下级企业管理员可在上级下发的范围内创建直属企业客户、用户和本级角色，并按实际授权使用查卡、同步、诊断、[业务受理](./business-operations)、库存、工单及 API 查询。
+
+为下级账号开通业务时，先由上级核对下发角色的菜单范围，再由本级管理员为用户分配角色；用户重新登录后，分别检查左侧菜单、页面按钮和可查询的卡片范围。看得到页面但无法提交时，还需核对该业务独立的模板、预处理或提交权限。默认管理员角色用于本机构管理，并不是一份对所有下级固定相同的功能清单。

 ## 企业客户

 **入口：** 左侧菜单 → **企业管理 → 企业客户**。

-![企业客户页面入口](/images/manual/enterprise-customer-entry.jpg)
+![企业客户页面入口](/images/manual/web/enterprise-customer-entry.png)

 该页面面向获准管理下级企业的客户。可按企业名称和状态查询，列表显示企业名称、登录账号、负责人、联系电话、邮箱、组织所在地、详细地址、创建时间和状态。

 根据按钮权限，可执行：

- **新增：** 创建直属企业客户之前，需在角色管理界面创建该企业客户同名角色，之后返回新增页面设置登录账号、初始密码、联系方式和企业地址等信息。
-![角色管理中创建企业客户同名角色](/images/manual/enterprise-customer-role-match.png)
+- **新增：** 先确认本机构具备有效的下级管理员角色或平台配置的默认角色下发来源，再填写企业名称、登录账号、初始密码、联系方式和地址等信息。当前实现按默认角色及下发规则复制权限，不要求为每个客户创建同名角色。提示未配置唯一的下级管理员角色或默认角色异常时，联系管理员检查角色配置，不反复新建客户。
+
+  ![新增企业客户页面](/images/manual/web/enterprise-customer-create-form.png)

-![新增企业客户页面](/images/manual/enterprise-customer-create-form.jpg)
 - **修改：** 调整企业名称、登录账号、负责人。

-  ![修改企业客户信息](/images/manual/enterprise-customer-edit.png)
+  ![修改企业客户信息](/images/manual/web/enterprise-customer-edit.png)

 - **重置密码：** 为该企业主账号设置新密码，密码长度为 5 至 20 位。
-![企业客户重置密码](/images/manual/enterprise-customer-reset-password.png)
+
+  ![企业客户重置密码](/images/manual/web/enterprise-customer-reset-password.png)
+
 - **企业管理：** 分两步维护单位信息和实名认证信息。

  ![维护企业单位信息](/images/manual/enterprise-customer-manage.png)

 - **删除：** 删除前确认该企业没有仍在使用的卡、用户和业务数据。删除属于高风险操作。
-![企业客户删除确认](/images/manual/enterprise-customer-delete-confirm.png)
+
+  ![企业客户删除确认](/images/manual/web/enterprise-customer-delete-confirm.png)

 新增企业后，应及时通知对方修改初始密码，并按需要创建角色和用户。

@@ -81,7 +96,7 @@
 4. 至少选择一个角色后保存。

 初始密码长度为 5 至 20 位。建议使用更长且不重复的密码，并要求用户首次登录后修改。
-![新增用户页面](/images/manual/user-create-form.png)
+![新增用户页面](/images/manual/web/user-create-form.png)

 ### 维护用户

@@ -89,7 +104,7 @@
 - “重置密码”可设置新密码。
 - “删除”会使用户失去登录和数据访问能力，操作前确认账号不再使用。

-![维护用户信息](/images/manual/user-management-maintain-user.png)
+![维护用户信息](/images/manual/web/user-management-maintain-user.png)

 ## 建议的角色划分

@@ -1,58 +0,0 @@
-# 常见问题
-
-## 登录后看不到某个菜单
-
-平台按角色显示菜单。先联系本企业管理员检查用户是否绑定正确角色、角色是否正常以及菜单权限是否勾选。若整个企业都没有该功能，需要联系平台支持开通。
-
-## 同事有按钮，我没有
-
-页面权限和按钮权限分别控制。即使都能进入同一页面，新增、编辑、导出、同步、删除或业务提交按钮也可能不同。由企业管理员对比双方角色权限。
-
-## 卡信息查询不到卡
-
-1. 清空其他筛选条件。
-2. 使用完整 MSISDN、ICCID 或 IMSI 查询。
-3. 检查是否有前后空格或字符缺失。
-4. 确认该卡已划拨到当前企业，且账号有相应数据范围。
-5. 仍无结果时创建工单并提供卡号。
-
-## 卡状态或流量没有更新
-
-在“卡信息”中分别执行“同步状态”和“同步用量”，完成后刷新列表，并查看同步时间是否变化。运营商接口可能有延迟；短时间内不要反复同步。
-
-## 智能诊断显示未查询到会话
-
-表示当前没有查到数据会话，不一定是卡异常。检查设备供电、信号、APN 和天线，确认数据服务已开启后重启设备，再稍后诊断。
-
-## 诊断提示运营商不支持
-
-当前卡所属通道未提供该项实时查询能力。结合卡信息、同步时间、设备侧日志和其他诊断模块判断；需要运营商侧核实时提交工单。
-
-## 批量业务提交后一直没有结果
-
-记录批次号，进入“执行日志”查看异步状态。仍在处理中时请等待；已失败时查看批次明细和失败原因。不要在结果未明确前重复提交同一批卡。
-
-## Excel 上传失败
-
- 使用页面当次下载的最新模板。
- 文件格式必须为 `.xls` 或 `.xlsx`，且不超过页面限制。
- 不修改表头、不合并单元格、不增加公式。
- 卡号列按文本格式保存，避免科学计数法或末位被修改。
- 根据失败提示修正后，仅重提失败数据。
-
-## 达量断网开启后没有立即断网
-
-确认阈值单位为 MB、配置任务已成功、卡用量已同步且确实达到阈值。运营商侧执行可能有延迟；同时检查卡是否受其他套餐或通道策略影响。
-
-## 如何提交高质量工单
-
-提供完整 ICCID、MSISDN、故障开始时间、影响数量、设备位置、复现步骤、诊断结果、执行日志批次号和必要截图。描述中避免使用“卡有问题”这类无法定位的表述，也不要发送密码或 API 凭证。
-
-## 使用安全建议
-
- 为每位操作人员创建独立账号，不共享管理员账号。
- 查询人员、业务操作员和管理员使用不同角色。
- 定期停用离职或不再使用的账号。
- 高风险批量任务实行复核，保留批次号和结果文件。
- 导出的卡信息、企业资料和 API 凭证按敏感数据管理。
-
@@ -1,10 +1,12 @@
 # 首页与通用操作

-## 首页（暂未开放）
+## 首页

 **入口：** 登录后默认进入“首页”；如已授权，也可点击左侧“首页”。

-首页用于快速掌握企业卡业务概况，通常包括：
+![管理平台首页概览](/images/manual/web/home-dashboard.png)
+
+首页由运行时配置决定显示哪些模块。当前代码中，部分模块已接入业务接口，部分仍为固定展示，阅读时应区分：

 - SIM 卡总数、本月新增、本月数据用量、本月短信用量和 SIM 卡月活跃度。
 - 生命周期分布、流量池、物联卡位置分布等图表。
@@ -12,7 +14,14 @@
 - 流量用尽关停、限额管控关停、封顶关停和套餐余量提醒等流量预警。
 - 卡信息、智能诊断等快捷入口。

-首页数据用于概览和发现异常。处理单张卡时，应进入“卡信息”查看最新详情；预警统计与明细可能存在同步时间差。
+| 模块 | 当前实现及使用方式 |
+| --- | --- |
+| 我的面板、生命周期分布、数据用量、流量池 | 已接入相应业务查询接口，结合账号范围及统计周期阅读 |
+| 近 6 月费用、位置分布、业务预警面板 | 当前使用固定展示数据，不能用于账单核对、实际定位或判断当前告警数量 |
+
+首页只作概览。处理单张卡应进入“卡信息”；费用核对使用订单记录，实际预警核对预警配置和通知记录。
+
+业务量模块当前查询的是数据流量，切换“语音”“短信”页签并未切换到独立的语音或短信统计接口，不能将图中的 GB/MB 数值解释为通话或短信量。

 ## 列表页通用操作

@@ -24,9 +33,7 @@

 卡号输入框通常支持 MSISDN、ICCID、IMSI。输入前后不要带空格；批量输入时一般每行一张卡。

-![卡号查询](/images/manual/card-info-query-single.jpg)
-
-![按号段批量查询](/images/manual/card-info-query-batch.jpg)
+![卡信息页面的卡号输入和搜索入口](/images/manual/web/card-info-query.png)

 ### 表格工具

@@ -34,9 +41,13 @@

 ![表格工具](/images/manual/table-tools.png)

-### 导出（暂未开放）
+### 导出

-“导出”通常按当前查询条件导出，而不是只导出当前页。建议先缩小查询范围再导出，并妥善保管包含卡号、设备号和企业信息的文件。
+导出范围因页面而异，不要假定文件包含全部匹配结果。例如“卡信息”当前按查询条件导出第一页最多 2000 条；结果更多时，应分段筛选并分别导出。导出后核对文件记录数，并妥善保管包含卡号、设备号和企业信息的文件。
+
+![卡信息页面中的导出入口](/images/manual/web/card-info-export.png)
+
+![下载中心中的导出文件和下载入口](/images/manual/web/export-download-center.png)

 ### 状态与数据时间

@@ -50,3 +61,9 @@
 - 同一企业内不同用户看到的菜单和数据可能不同。

 企业管理员可通过“企业管理 → 用户管理”和“角色管理”调整本企业用户权限。涉及平台未向企业开放的功能时，需要联系平台支持。
+
+## 通知公告（管理员）
+
+获授权管理员可从左侧“通知公告”页面按标题、类型、创建人或时间查询公告，并查看状态和内容。新增或修改时填写标题、类型、正文、状态和通知范围；选择指定组织或用户范围时，再核对目标名单后保存。删除支持单条或勾选多条，提交前确认范围，避免误删仍需展示的公告。
+
+“通知公告”的管理权限与普通账号接收站内消息是两回事。保存后可按公告状态、通知范围和用户通知公告记录核对接收对象。小程序[消息中心](../mini-program/messages-and-profile)读取独立的用户消息记录，不能仅凭 Web 公告创建成功就认定小程序会出现同一条公告。
@@ -1,6 +1,6 @@
 # Web 端使用手册

-本手册面向 iotLCM Web 管理平台的企业客户，说明登录平台后各页面的入口、信息含义和常用操作。
+本手册面向 iotLCM Web 管理平台的企业客户、业务人员及获授权的平台管理员，说明页面入口、信息含义和操作流程。套餐配置、通道接入、库存出库等章节包含管理员功能，普通企业账号不一定可见。

 ::: info 权限说明
 平台按企业、角色和用户分配权限。左侧菜单、页面按钮可能因企业实际授权不同而不同；看不到某项功能时，先联系本企业管理员确认角色权限。按钮以页面实际显示为准。
@@ -10,14 +10,19 @@

 ![iotLCM 管理平台登录页面](/images/manual/login-page.png)

-1. 访问 [iotLCM 管理平台](https://iotlcm.example.com/)。
+1. 访问 [iotLCM 管理平台](https://admin.5iot.cn/)。
 2. 输入平台分配的账号和密码登录。
-3. 首次登录后建议立即修改初始密码，并确认绑定的手机号、邮箱是否正确。
+3. 首次登录后，若仍使用初始密码或尚未绑定手机号，页面会弹出“账号安全提示”。按提示点击“去修改”或“去绑定”，分别进入个人中心的安全设置或手机号设置，完成密码修改、手机号绑定。
+
+   ![首次登录后的账号安全提示](/images/manual/account-security-prompt.png)
+
 4. 登录后通过左侧菜单进入业务页面；顶部标签可在已打开页面间切换。

+提示框可选择“稍后再说”，不会阻止进入系统；同一浏览器标签会话内只提示一次。以后仍可从右上角个人中心进入相应设置。邮箱等资料可在个人中心核对。
+
 若提示账号停用、密码错误或无可用菜单，请联系本企业管理员；企业管理员无法处理时，可通过工单联系平台支持。

-## 功能地图（部分开放）
+## 功能地图

 | 菜单 | 页面 | 主要用途 |
 | --- | --- | --- |
@@ -34,6 +39,14 @@
 | 工单管理 | 工单记录 | 查询工单的状态变更与操作轨迹 |
 | 顶级菜单 | 我的 API 凭证 | 查看并复制本企业接口凭证 |
 | 顶级菜单 | 执行日志 | 跟踪批量任务结果及逐卡失败原因 |
+| 系统管理 | 通知公告 | 按权限维护公告内容、状态及通知范围 |
+| 系统管理（以部署为准） | 消息日志、通知日志 | 核对站内消息和通知是否发出、发给了谁 |
+| 套餐相关页面 | 套餐分类、上游套餐、流量套餐信息、流量套餐定价、流量池 | 维护产品、可办理关系和分层价格，查询池用量 |
+| 预警相关页面 | 卡预警配置、流量池预警配置 | 维护提醒阈值、接收方式和启停状态 |
+| 生命周期相关页面 | 入库管理、库存卡信息、批次管理、销户卡信息 | 管理入库、出库、批次和销户记录 |
+| 通道及同步相关页面 | 通道模板、通道管理、全量同步 | 配置上游接入，检查对接，并按权限发起全量或指定通道同步 |
+
+后五组使用页面名称定位；菜单由部署环境和权限配置决定，可能采用不同的分组名称。功能已有页面和接口实现不代表当前账号已获授权。列表或表单提交成功也不代表异步任务和运营商侧操作已完成。

 “工单问题沟通”是从“我的工单”进入的详情页面，不在左侧单独显示。

@@ -43,7 +56,13 @@

 1. 进入“通讯管理 → 卡信息”。
 2. 用 MSISDN、ICCID、IMSI 或 IMEI 查询目标卡。
-3. 打开“查看”，核对卡状态、套餐、用量、到期时间和同步时间。
+
+   ![卡信息页面的卡号和 IMEI 查询入口](/images/manual/card-info-query-filters.png)
+
+3. 点击列表中的 ICCID 打开卡详情，核对卡状态、套餐、用量、到期时间和同步时间。
+
+   ![卡详情中的状态、套餐、用量和时间信息](/images/manual/card-info-detail-summary.jpg)
+
 4. 数据较旧时使用“同步用量”或“同步状态”，再刷新查看。

 ![卡信息同步操作示意图](/images/manual/card-info-sync-actions.png)
@@ -70,9 +89,12 @@

   ![填写创建工单信息](/images/manual/work-order-create-form-new.jpg)

-### 办理批量业务（暂未开放）
+### 办理批量业务

 1. 进入“通讯管理 → 业务受理”，选择已授权的业务。
+
+   ![通讯管理中的业务受理入口](/images/manual/business-acceptance-entry-highlighted.png)
+
 2. 下载最新 Excel 模板，或使用批量输入、连续号段方式提交卡号。
 3. 对需要预处理的业务先核对有效数量、失败项、套餐、价格和生效方式。
 4. 确认提交后记录批次号。
@@ -80,11 +102,14 @@

 ## 阅读指引

- [首页与通用操作](./home)：了解查询、重置、导出和数据刷新规则。
- [卡信息](./card-info)：了解卡列表字段、卡详情和会话信息。
+- [首页与通用操作](./home)：了解查询、重置、导出、通知公告和数据刷新规则。
+- [卡信息](./card-info)：了解卡列表字段、卡详情、会话信息及按权限提交的单卡操作。
 - [智能诊断](./intelligent-diagnosis)：了解入口、诊断步骤和结果判断。
 - [业务受理与达量断网](./business-operations)：了解批量业务及达量断网配置。
 - [企业、用户与角色](./enterprise-management)：了解组织和账号权限管理。
 - [工单管理](./work-orders)：了解问题提交、沟通、关闭和评价。
 - [API 凭证与执行日志](./api-and-logs)：了解凭证保管和批次追踪。
- [常见问题](./faq)：快速排查菜单、数据、任务和诊断问题。
+- [套餐配置与定价](./packages-and-pricing)：维护产品、办理关系及客户价格。
+- [预警管理](./warnings)：设置单卡和流量池提醒，区分预警与达量断网。
+- [入库、库存与出库](./inventory)：管理卡片从入库到出库及销户后的查询。
+- [通道与接入管理](./channels)：供获授权管理员配置上游接入。
@@ -8,7 +8,7 @@

   ![从左侧菜单进入智能诊断](/images/manual/intelligent-diagnosis-menu.png)

-2. 左侧菜单 → **通讯管理 → 卡信息** → 找到目标卡 → “查看” → “诊断”。第二种方式会自动带入 ICCID 并开始查询。
+2. 左侧菜单 → **通讯管理 → 卡信息** → 在目标卡的“更多”菜单选择“诊断”；也可以点击 ICCID 打开卡详情后选择“诊断”。这两种操作都会带入 ICCID 并开始查询。

   ![从卡详情进入智能诊断](/images/manual/card-detail-diagnosis-entry-attachment.png)

@@ -0,0 +1,65 @@
+# 入库、库存与出库
+
+本章供获授权的库存及业务管理员使用。在左侧菜单查找“入库管理”“库存卡信息”“批次管理”和“销户卡信息”。这些操作可能改变卡片归属、套餐和订单，请先确认目标客户与卡片范围。
+
+## 入库
+
+1. 进入“入库管理”，先查询既有批次，确认卡片未重复录入。
+
+   ![入库管理入口与批次编号查询](/images/manual/inventory-inbound-batch-query.png)
+
+2. 选择 Excel、批量输入或连续号段入口；Excel 使用页面下载的当前模板，输入方式按页面要求填写卡标识。
+
+   ![入库管理中的Excel文件、连号和批量输入入口](/images/manual/web/inventory-inbound-methods.png)
+
+3. 填写通道、上游套餐、卡类型、协议到期等表单要求的信息；按需选择是否校验上游基础信息。
+4. 核对通道及数量后提交，保存返回的批次号。
+5. 在执行日志查看处理结果，在库存卡信息中抽查成功卡片；失败卡按原因修正后再处理。
+
+入库只是将卡纳入库存管理，不等于已销售给客户，也不表示已开通通信或订购套餐。
+
+## 查询库存
+
+按 ICCID、MSISDN、IMSI、通道、上游套餐、卡类型、协议到期区间及创建时间查询。优先检查入库批次号、协议到期时间和通道是否正确，再决定出库范围。
+
+号段查询与输入须选择正确的号码类型，卡号应保留完整字符。不要在 Excel 中把长卡号转换成科学计数法或丢掉前导零。
+
+![库存卡信息入口与查询条件](/images/manual/inventory-card-query-filters.png)
+
+## 出库
+
+库存页面提供批量输入、号段及按批次出库等入口，具体以权限为准。按批次出库按“选择批次 → 确认卡 → 填写信息”完成。
+
+![库存卡信息中的出库管理入口及出库方式](/images/manual/inventory-outbound-entry.png)
+
+1. 选择要出库的库存批次或卡片，核对数量及每张卡的状态。
+2. 选择客户/机构与业务套餐，填写套餐开始时间、购买时长和赠送时长，检查预计结束日期。
+3. 核对订单金额、备注和付款安排。正常余额方式会校验客户余额账户存在、状态正常且余额充足。
+4. 若线下合同、销售及走账确已完成，才按实际业务勾选“线下合同/销售/走账已完成”。不要用该选项绕过未完成的付款处理。
+5. 确认后提交，记录批次号和相关订单信息。
+6. 在执行日志核对结果，成功后到“卡信息”确认客户归属、套餐和到期时间，并在订单页面核对交易记录。
+
+余额不足或账户异常时先联系财务及管理员处理，不要多次提交相同卡片。提交超时也应先查原批次。
+
+## 批次及销户记录
+
+![批次管理入口及批次查询页面](/images/manual/inventory-batch-management.png)
+
+- “批次管理”用于查询批次信息，并通过页面入口查看批次卡片；实际执行状态仍需对照执行日志。
+
+![销户卡信息查询与导出页面](/images/manual/web/cancelled-card-info.png)
+
+- “销户卡信息”用于查询已进入销户记录的卡片，有权限时可导出。
+
+![业务受理中的转销户入口](/images/manual/web/business-cancellation-entry.png)
+
+- 申请转销户从[业务受理](./business-operations)进入，不能把查询销户记录视为恢复服务入口。
+
+## 常见问题
+
+| 现象 | 核对方向 |
+| --- | --- |
+| 入库失败或重复 | 原批次结果、卡号格式、通道及库存已有记录 |
+| 库存中找不到卡 | 是否已出库、查询条件及账号数据权限 |
+| 出库不能提交 | 必填项、客户/套餐选择、金额及余额账户状态 |
+| 出库后归属或套餐不符 | 对照原批次与订单，不要另建任务覆盖问题，联系管理员核实 |
@@ -0,0 +1,34 @@
+# 套餐配置与定价
+
+本章面向获授权的产品、定价及企业管理人员。请在左侧菜单查找同名页面；实际菜单分组以部署配置为准。普通查卡账号不需要维护这些配置。
+
+## 套餐配置顺序
+
+套餐分类和上游套餐用于组织产品及上游资源；流量套餐定义对客户提供的产品；定价用于确定不同客户层级的价格。维护产品后，还要配置允许续费、变更和加油包的关系，业务受理页才可能出现相应选项。
+
+1. 在“套餐分类”查询或新增分类，填写表单必填项并保存。
+
+   ![在套餐分类页面点击新增并填写分类编号、分类名称等必填项](/images/manual/package-category-create-form.png)
+
+2. 在“上游套餐”查询对应上游产品，核对编码、名称及关联信息；需要新增或修改时由掌握上游资料的管理员操作。
+3. 在“流量套餐信息”新增产品，选择单卡套餐、单卡加油包、池卡套餐或池卡加油包。
+
+   ![在流量套餐信息页面点击新增，选择单卡套餐、单卡加油包、池卡套餐或池卡加油包](/images/manual/flow-package-add-product.png)
+
+4. 填写套餐名称、编码、计费方式、分类、流量（MB）、启用状态及价格相关字段。
+
+   ![新增单卡套餐表单：必填项为套餐名称、套餐编码、计费方式、套餐分类、套餐流量，价格信息包含目录售价、成本价与利润系数](/images/manual/flow-package-product-form.png)
+
+5. 设置允许的续费时长、折扣、可续费套餐、可变更套餐和可订购加油包；需要续费本套餐时检查对应开关。
+6. 保存后重新查询并查看详情，确认产品类型和关联编码正确，再供业务人员使用。
+
+可配置自动续费套餐和年限时，应同时核对自动续费开关。保存配置仅代表规则已保存，实际自动处理还依赖部署的服务与任务运行情况。
+
+## 常见问题
+
+| 问题 | 核对方向 |
+| --- | --- |
+| 新建套餐后业务页不可选 | 启用状态、套餐类型、当前套餐的允许办理关系及客户价格 |
+| 调价后显示价格没有变化 | 当前选中的机构层级、价格来源及是否存在客户独立覆盖 |
+| 流量池用量与单卡合计暂不一致 | 数据同步时间、统计范围及卡片归属，先刷新后再比较 |
+| 无维护按钮 | 产品、定价、查询和导出可能分别授权，请联系管理员 |
@@ -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)核对到期日期、套餐和归属企业，再决定是否办理续费。站内消息会按符合条件的账号写入消息中心；短信、邮件是否发送取决于已登记的联系方式和部署的消息服务。未收到时，请管理员检查通知或消息日志及后台任务，不要只根据首页的固定预警面板判断。
@@ -4,7 +4,7 @@

 **入口：** 左侧菜单 → **工单管理 → 我的工单**。

-![我的工单页面入口](/images/manual/work-orders-entry.png)
+![我的工单页面入口](/images/manual/web/work-orders-entry.png)

 可按工单编号、工单类型和当前处理状态查询。列表显示工单编号、类型、标题、关联业务号、创建人、当前状态、首次响应时间和创建时间。

@@ -14,38 +14,41 @@

 1. 点击“创建工单”。
 2. 选择工单类型，如卡问题、套餐问题、订单问题、系统问题或其他问题。
-3. 填写关联业务 ID。卡问题建议填写完整 ICCID，并在问题描述中补充 MSISDN。
+3. 如需填写“关联业务 ID”，使用对应业务记录的数字 ID，该字段不是 ICCID 或 MSISDN。无法确认时请联系管理员，完整卡号写在问题描述中，不要将长卡号填入数字 ID 字段。
 4. 填写清晰的工单标题和问题描述。
 5. 按需上传截图、日志或结果文件。
 6. 核对创建人信息后提交。

-问题描述建议包含：发生时间、影响范围、卡号、设备所在地、预期结果、实际现象、已执行的同步或诊断操作。不要在附件中上传 API 密钥、账号密码等敏感信息。
+   ![创建工单表单与附件上传入口](/images/manual/work-order-create-form-upload.png)

-![创建工单表单](/images/manual/work-order-create-form-attachment.png)
+问题描述建议包含：发生时间、影响范围、卡号、设备所在地、预期结果、实际现象、已执行的同步或诊断操作。不要在附件中上传 API 密钥、账号密码等敏感信息。

 ## 沟通与处理

 点击工单右侧“沟通”；工单已结束时按钮显示为“查看”。工单问题沟通页会显示历史消息、附件、工单信息和处理轨迹。

-![工单沟通入口](/images/manual/work-order-communication-entry.png)
+![工单沟通入口](/images/manual/web/work-order-communication-entry.png)

 - 在输入区填写回复内容，或按权限上传附件后发送。
- 平台回复后可继续补充信息，尽量在同一工单中保持上下文完整。
 - 有转单权限时，可把工单转交其他处理方。
 - 问题确认解决后可执行“解决”；不再需要处理时可“取消”。
 - 工单完成后可“关闭”，并按 1 至 5 分提交满意度和评价内容。

-![工单沟通与处理操作](/images/manual/work-orders-communication.png)
-
-![已关闭工单的服务评价入口](/images/manual/work-orders-closed-evaluation.png)
+![工单关闭操作](/images/manual/web/work-order-close.png)

 按钮是否出现取决于工单当前状态和用户权限。已完结或已取消的工单通常只能查看。

+### 处理角色与状态
+
+创建人、当前处理方及仅有查看权限的用户职责不同。取消由创建人按状态执行，解决和转单由有权限的当前处理方办理，评价由创建人在完结后提交。不要因为可查看工单就认为有权处理。
+
+Web 端“已解决”与小程序“待确认”对应同一处理阶段，尚未等同于“已完结”。问题仍存在时按当前端实际提供的操作反馈，保留同一工单的上下文。工单类型在两端可能采用不同的字典或显示文案，按当前表单选择，不根据数字值互相推断。
+
 ## 工单记录

 **入口：** 左侧菜单 → **工单管理 → 工单记录**。

-![工单记录页面入口](/images/manual/work-orders-records-entry.png)
+![工单记录页面入口](/images/manual/web/work-orders-records-entry.png)

 该页面用于审计工单流转，可按工单编号和操作类型查询。主要字段包括操作类型、操作机构、操作用户、目标部门、目标用户、变更前状态和变更后状态。

--- a/Show More
+++ b/Show More