feat(portal): 移除教程模块（导航入口、教程中心页、三项目教程视频页）

按要求删除导航栏「教程」及整个教程模块。删除内容 - 导航项「教程」(/guide/videos) 及其 activeMatch - 侧边栏「教程中心」条目 - pages/guide/videos.md（教程中心页，76 行） - pages/projects/{iotlcm,xiu-dtu,xiu-admin}/guide/tutorial.md（三份教程视频页，共 251 行） - data/projects.ts 里三个项目的「教程视频」子页面登记同步清理的引用（避免 404） - pages/projects/iotlcm/index.md：“下一步”表格里的教程视频行 - pages/projects/iotlcm/guide/quickstart.md：“下一步”里的教程链接 - 4 个审计脚本里的教程路径： audit-band-offset.mjs / audit-layout.mjs / audit-sidebar-footer.mjs / render-check.mjs - 注释里「教程等」的措辞保留的内容（与本次无关，未动） - DemoVideo.vue 及其 data/demo.ts 里的 demoVideos：那是「系统演示」页里的 BV 号外链卡片，不是教程栏目 - compare.md 里「录屏教程」对比维度：属于竞品对比表的正常描述验证 - 导航实测 8 项：首页/系统演示/产品功能/核心能力/界面预览/项目/官方文档/联系我们，无「教程」 - 侧边栏实测仅「门户部署」 - 干净副本构建成功，产物中无 tutorial/videos 文件 - 断链检查：失效项里无一条与教程相关 - check-registry 与 check-nav-brand 通过
2026-11-06 11:56:25 +08:00
parent fefad82e78
commit 07b8321d18
12 changed files with 369 additions and 341 deletions
@@ -1,6 +1,6 @@
 ---
 title: 快速开始
-description: 三步把 iotLCM 开源版跑起来
+description: 三步把 Iotlcm 开源版跑起来
 outline: deep
 ---

@@ -78,4 +78,3 @@ docker compose down -v       # 停止并删除数据卷（不可恢复）
 ## 下一步

 - [部署与运维](/projects/iotlcm/guide/deploy)
- [教程视频](/projects/iotlcm/guide/tutorial)
@@ -1,138 +0,0 @@
---
-title: 教程视频
-description: iotLCM 开源版的部署、使用与接口接入录屏教程
-outline: deep
---
-
-# 教程视频
-
-iotLCM 分三支：怎么装起来、怎么用起来、怎么接进去。前两支面向实施与业务方，第三支面向第三方开发者。
-
-## V1 部署教程：从零到可用
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | iotLCM 开源版部署教程：从零到可用 |
-| 目标观众 | 具备 Linux 与 Docker 基础的实施工程师 |
-| 时长 | 12 ~ 15 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | [快速开始](/projects/iotlcm/guide/quickstart)、[部署与运维](/projects/iotlcm/guide/deploy) |
-| 关联仓库路径 | `deploy/`、`docs/` |
-
-分镜：
-
-1. **环境准备**（1.5 分钟）：Docker 与 Compose 版本检查、机器规格建议、端口占用确认
-2. **取代码**（0.5 分钟）：`git clone` 公开仓库，展示目录结构
-3. **启动**（4 分钟）：`cd deploy && docker compose up -d`，`docker compose logs -f mysql` 看初始化直到种子数据导入完成
-4. **验证**（3 分钟）：登录管理端、打开文档站 `/docs/`、打开 OpenAPI 文档、跑一次卡状态查询
-5. **收尾**（2 分钟）：改默认口令清单、`docker compose down` 与 `down -v` 的区别
-6. **踩坑预告**（1 分钟）：MySQL 初始化失败要清卷、文档站必须带 `/docs/` 路径
-
-## V2 使用教程：核心功能实操
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | iotLCM 开源版使用教程：核心功能实操 |
-| 目标观众 | 已完成部署、准备给业务方上手的管理员与运营人员 |
-| 时长 | 15 ~ 20 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | [功能概览](/projects/iotlcm/) |
-| 关联仓库路径 | `admin-ui/vue/apps/web-antd/src/views/iotlcm/`、`admin-svr/server/api/iot/v1/` |
-
-录制环境：Web 管理端 `http://<主机>:8009/`（部署视频里那套已起好的环境），数据用 mock 挡板或测试库，
-不要在压测或生产环境上录。
-
-### 分镜（按后台真实菜单顺序）
-
-**1. 登录与工作台**（1 分钟）
-
- 打开管理端，用 admin 登录（口令打码）
- 进「工作台」看概览：卡总量、在网量、流量与告警概览
- 一句话交代后台的菜单分组：生命周期、通信管理、资费定价、通道、预警中心、智能诊断、系统与组织
-
-**2. 卡信息**（3 分钟）——菜单「通信管理 / 卡信息」
-
- 列表页看全量卡：分页、列筛选
- 按 ICCID / MSISDN / IMSI 三种卡号任一检索（`cardValue` 支持单卡与批量两种输入）
- 按通道、卡状态、套餐编码再叠一层筛选，体现组合筛选能力
- 点开一张卡的详情：基本信息、状态、有效期、绑定套餐
- 说明列表右上角的导出（导出当前显示列）
-
-**3. 入库与库存**（2.5 分钟）——菜单「生命周期 / 入库管理」「库存卡信息」
-
- 入库管理：Excel 模板下载 → 批量导入卡 → 导入结果反馈（成功 / 失败条数）
- 库存卡信息：看在库卡、按状态与维度筛、看单卡出入库轨迹
- 串一句：入库是所有下游动作（划拨、激活、续费）的前提
-
-**4. 业务受理**（3 分钟）——菜单「通信管理 / 业务受理」
-
- 新建受理单：选卡 → 选动作（开卡 / 复机 / 停机 / 续费 / 变更套餐 / 销户）→ 提交
- 提交前确认卡状态与套餐是否满足该动作的前置条件
- 提交后到「批次管理」看任务生成
- 顺带展示销户卡信息页与库存的差别
-
-**5. 批次与执行日志**（3 分钟）——菜单「生命周期 / 批次管理」「执行日志」
-
- 批次管理：看批次列表、批次类型（开停复机 / 续费 / 变更套餐）、处理进度
- 打开一个批次的卡明细：逐卡的成功 / 失败与失败原因
- 执行日志：看异步执行记录与耗时，失败批次点详情看日志
- 说明这里为什么是异步：批量动作走 worker 队列，页面只提交不等待
-
-**6. 套餐与流量**（2.5 分钟）——菜单「资费定价」
-
- SIM 流量套餐：看套餐定义、有效期、生效与到期策略
- 流量池：看池的总量与已用量
- 流量池套餐配置：池与套餐的绑定关系
-
-**7. 达量断网**（1.5 分钟）——菜单「通信管理 / 达量断网」
-
- 新建规则：选池 / 选套餐、设阈值与动作
- 说明触发时机与卡状态的关系：这是运营商侧断网前的自保手段
-
-**8. 智能诊断**（1.5 分钟）——菜单「智能诊断」
-
- 输入卡号，查诊断信息：基本信息 + 会话信息 + 套餐信息三块同屏
- 查该卡的流量使用情况
- 说明诊断给的是「当前结论 + 依据」，处置仍要回到对应菜单操作
-
-### 录制注意
-
- 上面 8 段是**必须录到**的最小集合。若时间紧，4（业务受理）、5（批次与执行日志）、8（智能诊断）三段是平台区别于普通 CRUD 的核心，不可省
- 每一段开头用一句话说清「这一步在业务上解决什么问题」，观众跟得上
- 卡号、IMEI 用演示值；不要展示真实客户名与真实生产卡号
- 批次那段的异步特性建议当场等一次执行结果（mock 环境秒级），让观众看到状态从「执行中」到「成功」
- 全程不要出现真实口令与 token
-
-### 明确不录的内容
-
- OpenAPI 调用演示 → 属于 V3 接口那支
- 通道与接入模板的详细配置 → 属于平台实施方内容，不是业务方日常操作
- 租户、角色、菜单的系统管理页 → 与使用教程的受众不匹配，放进「组织与账号」类材料
-
-## V3 OpenAPI 接入实战
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | iotLCM OpenAPI 接入实战：从申请凭证到跑通调用 |
-| 目标观众 | 要把平台接进自己系统的第三方开发者 |
-| 时长 | 10 ~ 12 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | 文档站 OpenAPI 合同章节 |
-| 关联仓库路径 | `openapi/`、`docs/` |
-
-分镜：
-
-1. **申请凭证**（2 分钟）：管理端申请 API 凭证、看凭证与权限范围
-2. **鉴权方式**（2 分钟）：JWT 令牌获取、令牌与权限的关系
-3. **第一次调用**（3 分钟）：卡信息查询接口的请求参数、响应结构、逐字段解释
-4. **错误处理**（2 分钟）：常见业务错误码与参数校验失败的处理路径
-5. **兼容接口**（1.5 分钟）：旧版兼容接口与 V3 的差异，何时该用哪套
-6. **收尾**（1 分钟）：接入自检清单
-
-## 录制备忘
-
- 录屏环境用干净 Ubuntu + Compose V2，不在已有业务实例上录
- 涉及口令的片段一律打码，用编排里的默认值
- 步骤与[快速开始](/projects/iotlcm/guide/quickstart)严格一致，视频里出现的每条命令都必须能原样复制执行
- 每个视频产出配套字幕或要点说明（Markdown），随视频一起发布
- 视频文件命名 `iotlcm-deploy-v1.mp4` 这类，官网用相对路径引用；改投外部托管则不进仓库
@@ -1,10 +1,10 @@
 ---
-title: iotLCM
+title: Iotlcm
 description: 物联网卡全生命周期管理平台
 outline: deep
 ---

-# iotLCM
+# Iotlcm

 物联网卡全生命周期管理平台。卡片从运营商渠道入库 → 划拨给代理商 → 激活 / 续费 / 停机 → 流量与状态同步 → 销户，一个平台覆盖 SIM 卡管理全程。

@@ -50,9 +50,8 @@ outline: deep
 | --- | --- |
 | [快速开始](/projects/iotlcm/guide/quickstart) | 三步把整套跑起来 |
 | [部署与运维](/projects/iotlcm/guide/deploy) | 生产部署前的必改项、可选组件、离线部署与排错 |
-| [教程视频](/projects/iotlcm/guide/tutorial) | 部署与使用的录屏教程 |
 | [方案对比](/projects/iotlcm/compare) | 与同类开源方案的可验证差异 |

 ## 边界

-开源版发布的是微服务家族，不含老平台的私有定制模块。运营商通道的生产凭据不随仓发布，需自行申请与配置。
+开源版发布的是微服务家族。运营商通道的生产凭据不随仓发布，需自行申请与配置。
@@ -1,55 +0,0 @@
---
-title: 教程视频
-description: XiuAdmin 中后台框架的一键部署与二开实操录屏教程
-outline: deep
---
-
-# 教程视频
-
-XiuAdmin 是开发底座而不是业务系统，两支视频分别回答「怎么跑起来」和「怎么用它写自己的业务」。
-
-## V6 一键部署：三个容器跑起中后台
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | XiuAdmin 一键部署：三个容器跑起中后台 |
-| 目标观众 | 要用这个框架搭中后台的开发者 |
-| 时长 | 8 ~ 10 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | 代码仓 `deploy/README.md` |
-| 关联仓库路径 | `deploy/`、`build/` |
-
-分镜：
-
-1. **三个容器是什么**（1.5 分钟）：MySQL 8.0、Redis 7.2、前后端一体应用，MySQL 与 Redis 只在内部网络可达、不映射宿主端口
-2. **一条命令启动**（3 分钟）：`cd deploy && ./run.sh`，看它自动生成 `.env`（随机数据库口令、Redis 口令、JWT 密钥，权限 600）、拉镜像、起容器、等健康检查通过
-3. **访问与改密**（1.5 分钟）：打开 `http://<服务器IP>:8199/`，初始账号 admin / 123456 登录后立即改密
-4. **常用命令**（1.5 分钟）：`status` 看状态与健康检查、`logs` 跟日志、`restart` 改 `.env` 后重建应用容器、`down` 保留数据卷、`destroy` 清数据需二次确认
-5. **手工部署路线**（1 分钟）：`cp .env.example .env` 后用 `docker compose up -d`，说明 `.env` 里各变量含义（镜像前缀、APP_TAG、APP_PORT、四个口令、JWT_SIGNING_KEY 必须够长且随机）
-
-## V7 框架上手：代码生成到业务模块落地
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | XiuAdmin 框架上手：代码生成到业务模块落地 |
-| 目标观众 | 要基于框架二次开发的工程师 |
-| 时长 | 15 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | 代码仓 `README.md` 的内置功能清单与目录说明 |
-| 关联仓库路径 | `server/`、`vue/` |
-
-分镜：
-
-1. **框架全貌**（2 分钟）：GoFrame2 后端 + Vue3 前端（Vben Admin）+ Ant Design Vue，单仓结构（`server/`、`vue/`、`docs/`、`build/`、`deploy/`）与「前后端一体镜像」的思路
-2. **代码生成**（4 分钟）：建表 → 简单配置 → 生成 CURD / 树表 / 消息队列 / 定时任务代码，表单控件勾选即生成
-3. **生成代码怎么接进系统**（3 分钟）：生成的 API、控制器、菜单权限如何挂进路由，前端页面如何挂进菜单
-4. **多租户与数据权限**（2.5 分钟）：租户与租户套餐、角色按机构或上下级关系划数据范围
-5. **异步与通知**（2 分钟）：Asynq 消息队列怎么用、WebSocket 实时推送通知公告与私信
-6. **运维视图**（1.5 分钟）：在线用户、定时任务、服务监控、缓存监控、附件大文件分片上传
-
-## 录制备忘
-
- 录屏环境用干净 Ubuntu + Docker，不要连生产或预演环境
- 口令一律打码，`run.sh` 生成随机口令这一步可展示但值要遮住
- 代码生成那段用一个明显的示例表（如 demo_order），避免观众误以为是框架内置表
- 步骤与代码仓 `deploy/README.md` 严格一致，视频里的每条命令都要能原样复制执行
@@ -1,58 +0,0 @@
---
-title: 教程视频
-description: 秀杰 DTU 管理平台的部署与设备实操录屏教程
-outline: deep
---
-
-# 教程视频
-
-秀杰 DTU 分两支：把服务起起来并让设备连上，然后在平台上真的操作一遍设备。
-
-## V4 部署教程：源码起服务到设备接入
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | 秀杰 DTU 部署教程：源码起服务到设备接入 |
-| 目标观众 | 做 DTU 设备接入的开发者 |
-| 时长 | 12 ~ 15 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | 代码仓 `docs_ui/` 文档站（快速上手、通信协议、控制台说明） |
-| 关联仓库路径 | `server/`、`vue/`、`docs_ui/`、`docker/`、`deploy/` |
-
-分镜：
-
-1. **环境准备**（1.5 分钟）：Go 1.25+、Node.js 24+ 与 pnpm 10+、MySQL 8、Redis 7 的版本检查
-2. **初始化数据库**（2 分钟）：建库 `xiujie_dtu` 并按顺序导入四个初始化 SQL（基础表、业务表、菜单、角色）
-3. **配置后端**（1.5 分钟）：复制 `config_default.yaml` 为 `config.yaml`、改数据库与 Redis 连接、设置 JWT 签名密钥环境变量（长度不少于 32 位，未提供时服务拒绝签发令牌）
-4. **启动后端**（2.5 分钟）：`go run main.go`，说明三个监听端口的用途：控制台 5689、设备 HTTP 5692、设备 TCP 5690
-5. **启动前端与文档站**（2 分钟）：`pnpm install && pnpm dev`（前端 5688）、`npm run docs:dev`（文档站 5687）
-6. **登录与改密**（1 分钟）：初始 admin 账号登录后立即改密
-7. **Docker 部署路线**（2 分钟）：`docker/dtu_base` 初始化中间件 → `docker/dtu_iot` 部署业务服务、`make docker-build docker-push` 构建推送镜像
-
-## V5 设备实操：双通道接入、指令下发与 OTA
-
-| 项 | 内容 |
-| --- | --- |
-| 标题 | 秀杰 DTU 设备实操：双通道接入、指令下发与 OTA |
-| 目标观众 | 设备端与平台端联调工程师 |
-| 时长 | 15 ~ 18 分钟 |
-| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
-| 关联文档 | 代码仓文档站「通信协议」章节（HTTP API、TCP 帧、指令、属性上报、配置同步、OTA、UART 隧道） |
-| 关联仓库路径 | `tools/`、`server/`、`docs_ui/` |
-
-分镜：
-
-1. **HTTP 通道联调**（3 分钟）：用 `tools/test-device-http-v4.sh` 带 DEVICE_KEY / PRODUCT_KEY / PROJECT_KEY 打一次设备注册与上报，看平台侧设备列表出现
-2. **TCP 通道联调**（3 分钟）：`tools/test-device-tcp-v4.py --heartbeat --listen-command` 建连、维持心跳、接收平台下发指令
-3. **指令下发**（2.5 分钟）：从控制台对设备下指令，两端同时看帧与日志
-4. **属性上报与配置同步**（2.5 分钟）：设备上报属性、平台侧改配置并下发，验证端到端一致性
-5. **OTA 升级**（2.5 分钟）：研发中心建固件版本、发起 OTA 升级任务、看设备侧升级结果
-6. **UART 隧道**（1.5 分钟）：透传串口数据的用法与适用场景
-7. **压测**（2 分钟）：`tools/stress-2w-devices.py --count 20000` 演示 2 万设备压测怎么发起、看指标
-
-## 录制备忘
-
- 录屏环境用干净 Ubuntu，MySQL / Redis 独立装，不要连生产或预演环境
- DEVICE_KEY / PRODUCT_KEY / PROJECT_KEY 等示例值用文档里的测试值，画面出现即可
- 2 万设备压测那段只演示命令与指标入口，不在录屏环境真压 2 万台
- 步骤与代码仓文档站的「快速上手」严格一致，视频里的每条命令都要能原样复制执行