科杰企业级系统（Web / 移动端 / IoT 架构建议）

1. 文档定位

本文档用于说明科杰企业级系统在多端实施中的建议架构，覆盖：

• Web 管理端
• 移动端
• IoT / 设备接入预留
• 多端之间的数据与消息链路

目标是让系统从一开始就具备多端演进能力，但不过度引入复杂度。

2. Web 管理端架构建议

2.1 定位

Web 管理端是企业内部核心操作端，承担：

• 标准设计资产管理
• 设备主档与档案管理
• 台账管理
• 合规管理
• 售后管理
• 分析与导出

2.2 架构建议

推荐：

• Vue 3 + TypeScript
• 组件化中后台
• 模块路由按业务域拆分
• 权限菜单动态加载

2.3 关键能力

• 大表格管理
• 复杂检索筛选
• 文件预览与下载
• 多角色菜单控制
• 审批与导出

2.4 Web 端最适合承载的模块

• 标准设计中心
• 设备主档与一机一档
• 合规与监管协同
• 数据分析看板
• 系统管理

3. 移动端架构建议

3.1 定位

移动端不是 PC 的缩小版，而是“现场作业与高频动作端”。

一期建议只承载以下场景：

• 日检/月检/维保填报
• 签字确认
• 工单执行
• 设备扫码
• 告警查看
• 我的待办

3.2 推荐形态

优先方案

• H5 + 企业微信 / 钉钉容器

次优方案

• UniApp / Taro 多端统一开发

后续才考虑

• 原生 App（若后续涉及大量离线、蓝牙、扫码硬件、照片批量处理）

3.3 移动端关键能力

• 登录态轻量保持
• 设备二维码扫码
• 签字图片上传
• 离线草稿（可选）
• 拍照上传
• 低步骤提交

3.4 移动端最适合承载的模块

• 台账任务
• 整改处理
• 售后工单
• 设备扫码详情

4. IoT 架构建议

4.1 一期原则

一期不做重型 IoT 平台，但必须预留好未来接入路径。

也就是说：

• 业务系统先准备好设备、采集点、告警、运维记录的数据结构；
• 真正高频工况采集、时序存储、远程控制可放到后续阶段。

4.2 IoT 推荐分层

设备层

• 传感器
• 控制器
• 边缘采集盒
• 4G/5G/有线通信模块

边缘层

• 协议适配
• 数据采集
• 本地缓存
• 简单规则过滤

IoT 平台层（后续）

• 设备接入
• 时序数据存储
• 告警规则
• 指令下发（谨慎）
• 运维日志

业务系统层

• 联网设备档案
• 告警摘要
• 工况摘要
• 告警转工单 / 转维保建议

4.3 一期业务系统需预留的 IoT 数据对象

• iot_device
• telemetry_point
• iot_alarm
• 设备联网状态
• 告警处理状态
• 工况摘要字段

4.4 不建议一期直接承载的能力

• 高频时序原始数据全量入业务主库
• 复杂视频流处理
• 远程控制闭环
• 多协议工业采集网关平台深度建设

5. 多端协同链路建议

5.1 Web 与移动端协同

• 共用统一用户中心
• 共用统一业务主库
• 接口层按终端拆 BFF

典型链路

PC 创建任务 → 移动端执行填报 → 后端写入 → PC 查看结果/审批

5.2 Web 与 IoT 协同

• Web 端配置设备、采集点、告警规则
• IoT 平台/边缘层回传告警摘要
• 业务系统把告警转成工单/维保建议/风险提醒

典型链路

IoT 告警 → 告警服务 → 业务系统风险页 / 工单页 / 维保建议

5.3 移动端与 IoT 协同

• 现场工程师扫码设备
• 查看实时摘要和历史告警
• 处理告警并回填结果

6. 消息链路建议

建议未来形成 3 类消息：

6.1 业务消息

• 待办提醒
• 审批提醒
• 到期提醒
• 整改提醒

6.2 服务消息

• 工单派工通知
• 客户确认提醒
• 服务超时提醒

6.3 IoT 消息（后续）

• 设备离线告警
• 工况异常告警
• 安全风险告警

7. 扫码与设备识别建议

7.1 推荐做法

• 每台设备生成统一二维码
• 二维码对应 equipment_code
• 移动端扫码后跳转设备详情摘要页

7.2 扫码页建议展示

• 设备名称
• 型号
• 设备状态
• 检验/登记状态
• 最近日检/维保/工单
• 快捷发起动作

8. 多端权限建议

8.1 Web

• 功能最全
• 适合审批、配置、导出、分析

8.2 移动端

• 权限最小化
• 适合执行、拍照、签字、扫码、反馈

8.3 IoT

• 不直接赋予“业务操作权限”
• 只允许设备接入、上报和告警事件流转

9. 多端实施顺序建议

第一步

先做 Web 管理端 + 移动端基础待办与填报

第二步

增强移动端工单与扫码体验

第三步

接入 IoT 摘要数据与告警联动

第四步

再做客户/维保商协同门户

10. 技术实施建议

Web

• 独立前端工程
• 后台管理 UI 组件库
• 动态菜单与权限路由

移动端

• 独立移动端工程
• 表单页复用后端接口
• 图片/签字组件优先封装

IoT

• 一期只定义接口和数据模型
• 后续如自建 IoT 平台，可独立部署
• 或接第三方平台，把摘要数据同步到业务系统

11. 结论

多端架构的关键不在于一开始铺得多大，而在于把端的角色分清楚：

• Web 管理端负责管理与配置
• 移动端负责现场执行与反馈
• IoT 负责连接与告警数据输入

只要这三端边界清楚，科杰系统后续从企业管理延伸到设备连接和产业链协同，就会顺很多。