技小云
78 lines
3.8 KiB
Markdown
78 lines
3.8 KiB
Markdown
---
|
||
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-svr/`、`admin-ui/`、`openapi/`、`worker-svr/` |
|
||
|
||
分镜：
|
||
|
||
1. **卡信息**（3 分钟）：列表检索、按 ICCID / MSISDN / IMSI 三码查卡、卡详情与用量查看
|
||
2. **库存与划拨**（2.5 分钟）：入库后按代理商维度划拨、划拨历史
|
||
3. **资费与业务受理**（3 分钟）：套餐与定价配置、开通 / 续费 / 停复机 / 变更套餐、达量断网阈值
|
||
4. **通道与批次**（3.5 分钟）：通道配置查看、批量操作提交、异步进度与执行日志
|
||
5. **账号与工单**（2.5 分钟）：企业与用户管理、角色权限、告警工单处理
|
||
6. **智能诊断**（1.5 分钟）：结合卡状态、通道与用量出诊断结论
|
||
|
||
## 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` 这类，官网用相对路径引用；改投外部托管则不进仓库
|