控制台导航与公共界面
目录
概述
本文档说明登录后所有界面共用的控制台框架。当前控制台由 顶部域搜索、右侧实时工具栏、左侧业务组菜单 以及 基于卡片·图表·表格的正文 组成。
整体菜单图和业务流程图可在 整体菜单结构与运行流程图 中一览而知。
运营商通常按照以下流程使用：
- 在 대시보드 中确认站点地图、流水线、KPI 和基础设施健康状况。
- 点击异常 KPI，下钻至 연결 상태、알람、설비、일일 통계。
- 通过顶部 域搜索 直接查找站点·资产·标签·OPC·Edge·Flow·报警设置 ID，并跳转至详细界面。
- 在右上角的 LIVE·报警·Toast 中确认新异常信号。
旧文档中的“摘要”首屏在当前 UI 中统一为 대시보드。内部 URL 保持为
/map/index。
整体界面框架
┌──────────────┬────────────────────────────────────────────────────────────┐
│ PlantPulse │ ☰ [도메인 검색 사이트 / 에셋 / 태그 / OPC / ... CTRL+K] │
│ 좌측 메뉴 │ [LIVE] [알람] [전체] [설정] [매뉴얼] [사용자] │
├──────────────┼────────────────────────────────────────────────────────────┤
│ 개요 │ 페이지 제목 / 현재 업무 설명 │
│ 연결 │ ┌────────────────────────────────────────────────────────┐ │
│ 공장 모델 │ │ 지도·카드·차트·테이블·트리·드로어 등 선택 화면 본문 │ │
│ ... │ └────────────────────────────────────────────────────────┘ │
└──────────────┴────────────────────────────────────────────────────────────┘
| 区域 | 角色 |
|---|---|
| 顶部栏 | 菜单折叠, 全局域搜索, LIVE 状态, 报警, 全屏, 环境设置, 手册, 用户菜单 |
| 左侧菜单 | 基于实际服务器 Web nav-role/admin.jsp 的业务组菜单 |
| 正文顶部 | 页面标题, 当前站点/业务上下文, 查询·刷新·跳转按钮 |
| 正文区域 | 地图, 卡片, 图表, 表格, 树, 详细面板 |
| Toast 区域 | 在右上角简短显示实时诊断·报警事件 |
顶部栏
顶部栏在所有界面中的行为一致。
| 顺序 | 元素 | 使用方法 |
|---|---|---|
| 1 | 菜单切换 | 折叠或展开左侧菜单。用于在窄屏环境下确保正文空间。 |
| 2 | 域搜索 | 点击或使用 Ctrl+K / Mac Cmd+K 打开。搜索控制台全体域 ID。 |
| 3 | LIVE 状态 | WebSocket 连接状态。正常时 LIVE 点以脉冲形式显示。 |
| 4 | 报警 | 显示最近报警数量与预览。可通过菜单页脚跳转至 알람。 |
| 5 | 全屏 | 切换浏览器全屏模式。 |
| 6 | 环境设置 | 打开用户界面设置，如屏幕缩放、报警弹窗、诊断日志显示等。 |
| 7 | 手册 | 在新标签页中打开 GitBook 手册。 |
| 8 | 用户菜单 | 提供个人资料、修改密码、退出登录。 |
顶部搜索与各界面的搜索表单不同。界面内搜索是对当前列表进行过滤，而域搜索是在整个控制台中查找主要 ID 并跳转至详细界面。
域统一搜索
域搜索调用 /api/v5/domain/search 并将结果以 DataTable 形式显示。点击 ID 单元格可复制到剪贴板，操作按钮则跳转至各域的详细界面。
搜索对象
| 域 | 示例 | 跳转目标 |
|---|---|---|
| SITE / AREA / LINE | S1_LOTTE_CS_DJ_SITE | 대시보드, 资产树, 模型 |
| EQUIPMENT / ASSET | ASSET_LINE_01 | 资产树, 设备详情 |
| TAG | TAG_EDGE_00303_90000 | 标签, 数据查询, 趋势 |
| OPC | OPC_MAIN_01 | 连接详情 |
| EDGE | EDGE-303 | 엣지 详情 |
| ALARM_CONFIG | ALARM_CONFIG_000376 | 高级报警 |
| FLOW | 流 ID | 流列表·编辑 |
| USER / SECURITY | 用户·安全策略 ID | 系统·安全管理 |
| EMPLOYEE / CUSTOMER / PRODUCT | 生产主数据 ID | 生产管理界面 |
搜索结果使用
| 动作 | 结果 |
|---|---|
Ctrl+K / Cmd+K | 无论哪个输入框处于焦点，均打开域搜索对话框。 |
| 点击域标签 (Chip) | 仅过滤该域。 |
| 点击 ID | 将 ID 复制到剪贴板。 |
| 点击详情跳转按钮 | 跳转至各域的详细界面或列表界面。 |
| 点击最近搜索词 | 使用相同关键字重新搜索。 |
在运行期间，直接搜索报警消息或诊断 Toast 中显示的 ID，可大幅缩短定位原因对象的时间。
左侧菜单结构
当前左侧菜单按照服务器 Web 的统一菜单渲染顺序排列。菜单组名称遵循界面语言（韩语界面则为 «개요», «연결» ...）。点击可折叠/展开组，折叠左侧菜单后仅保留简写名称。
下表中 USER 栏的 ○ 为普通用户可见的菜单 —— 权限与菜单显示。
概述 (Overview)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 대시보드 | /map/index | 站点地图, 数据流水线, 平台健康状况, 核心 KPI | |
| 통계 | /statistics/index | 年度热力图与选定日运行统计 |
连接 (Connectivity)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 프로토콜 | /connect/index | 注册 OPC/PLC/Modbus/DB/API 等数据源 | |
| 연결 상태 | /connect/status | 监控全体连接的正常·延迟·异常·断开·未连接状态 | |
| 엣지 | /edge/index | 现场 엣지 设备状态与详细控制 |
工厂模型 (Factory Model)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 모델 | /model/index | 站点·区域·线·设备层级模型 | |
| 에셋 | /asset/tree/index | 资产树与详细属性 | ○ |
| 태그 | /tag/index | 采集标签定义与状态 | ○ |
| 온톨로지 | /ontology/index | 语义模型·关系定义 | |
| 메타데이터 | /metadata/index | 各域扩展属性 | |
| 기준정보 | /basedata/index | 运行基准值与公共代码 |
设备 (Equipment)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 설비 목록 | /equipment/index | 设备卡片与设备单元 대시보드 入口 | |
| 데이터 조회 | /asset/data/index | 按资产·标签采集数据查询 | ○ |
| 타임라인 비교 | /timeline/index | 标签·设备间时间轴对比 |
生产 (Production)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 고객 | /customer/index | 客户主数据 | |
| 제품 | /product/index | 产品主数据 | |
| 공정 | /process/index | 设备连接图与工艺段 | |
| 직원 | /employee/index | 操作员·负责人信息 | |
| 근무표 | /calendar/index | 班次与运行日程 | |
| 워크오더 | /order/index | 生产工作指令 | |
| 생산 목표 | /basedata/production-targets | 生产目标 |
维护 (Maintenance)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 정비 현황 | /maintenance/status | 进行中的维护与维护指标 | ○ |
| 정비 오더 | /maintenance/records | 维护订单列表 | ○ |
| 예방정비 계획 | /maintenance/plans | 预防性维护计划 | ○ |
| 고장 기록(RAM) | /analysis/ram/failures | 故障记录与原因 |
ISO
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| ISO 데이터 | /asset/plugin/index | 用于 OEE/RAM/EMS 计算的设备原始数据 | ○ |
| ISO 분석 | /analysis/index | 基于 ISO 22400 的 KPI 分析 |
数据 (Data)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 스트림 | /stream/index | 实时时序流图表 | |
| 트렌드 | /storage/index | 标签时序趋势与采样分析 | |
| 스냅샷 | /snapshot/index | 按间隔的时序快照 | |
| 데이터 출력 | /data/index | 标签时序数据查询·CSV 输出 | |
| 오브젝트 (BLOB) | /blob/store | 图像·文档·二进制文件存储库 |
报警 (Alarm)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 알람 | /alarm/index | 实时报警列表。左侧菜单显示信息·警告·严重计数徽标 | ○ |
| 알람 검색 | /alarm/advsearch/index | 按期间·范围·重要度·激活·确认条件搜索 | ○ |
| 고급 알람 | /alarm/config/index | 报警设置, EQL 报警规则, 暂时隐藏, 服务排除 | ○ |
| 알람 분석 | /alarm/analysis/index | 排名, 趋势, 分布, TreeMap 分析 | ○ |
| 알람 성능 | /alarm/performance/index | 基于 ISA-18.2 / EEMUA 191 的报警系统性能 | ○ |
可视化 (Visualization)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 캔버스 | /canvas/index | 基于 SVG 的现场监控界面 |
自动化 (Automation)
| 菜单 | 内部 URL | 用途 | USER |
|---|---|---|---|
| 플로우 | /flow/index | 自动化图列表·编辑。左侧菜单显示错误计数徽标 | |
| 플로우 실행 이력 | /flow/log | 流执行日志与失败记录 | |
| EQL 쿼리 | /query/index | 实时事件查询执行 | |
| 스테이트먼트 | /statement/index | 管理已部署的 EQL statement |
标准 (Standard)
| 菜单 | 内部 URL / 外部端口 | 用途 | USER |
|---|---|---|---|
| 네임스페이스 | /uns/tree | Unified Namespace 层级与 Kafka/MQTT/SparkplugB 话题预览 | |
| 카탈로그 | /catalog/index | 数据目录 | |
| OPC-UA | http://[현재호스트]:12780 | 在新窗口中打开 OPC-UA 标准工具。 | |
| AAS V3 | http://[현재호스트]:8091/ui/ | 在新窗口中打开 AAS V3 UI。 |
系统 (System)
| 菜单 | 内部 URL / 外部端口 | 用途 | USER |
|---|---|---|---|
| 사용자 | /user/index | 用户账号管理（仅限 ADMIN） | |
| 보안 정책 | /security/index | 密码·访问安全策略 | |
| API 토큰 | /token/index | 外部联动用 API 令牌（仅限 ADMIN） | |
| 모니터링 | /monitoring/index | 基础设施健康度·流水线·引擎指标 | |
| 진단 | /diagnostic/index | 系统诊断事件 | |
| 로그 | /log/index | 应用程序日志 | |
| 클러스터 | /cluster/index | 集群节点状态 | |
| HA | /ha/index | 高可用配置状态 | |
| 감사 | /audit/index | 审计日志 | |
| 설정 | /config/index | 系统键值设置 | |
| 환경정보 | /env/view | 按属性查询环境设置 |
实时通知与 Toast
右上角的 Toast 简短显示新的诊断事件或设备状态变化。
진단 · 192.168.0.41
설비 상태 변경 - 설비=[ASSET_DJ_M_16_2], RUN -> FAULT
| 项目 | 含义 |
|---|---|
| 标题 | 通知类型与发生设备或模块 |
| 正文 | 状态变化, 报警内容, 诊断消息摘要 |
| 颜色 | 根据信息·警告·严重级别进行强调 |
| 后续确认 | 报警在 알람, 设备状态在 설비, 系统事件在 진단 中追踪 |
Toast 仅为信号。在采取实际措施前，请在相关界面中再次确认时间、对象 ID 和详细日志。
公共界面模式
状态颜色
| 颜色 | 一般含义 | 示例 |
|---|---|---|
| 绿色 | 正常 | 连接正常, 基础设施 UP, 设备健康正常 |
| 橙色 | 注意·延迟 | 连接延迟, 警告报警, 处理延迟 |
| 红色 | 异常·严重 | 连接异常, 严重报警, 引擎错误 |
| 灰色 | 未连接·未确认 | 无数据, 尚无采集记录 |
准确的代码含义请参考 상태 코드 정의。
列表与详情
大多数业务界面采用 顶部搜索 → 列表表格 → 点击行进入详情 模式。
| 步骤 | 说明 |
|---|---|
| 选择搜索条件 | 期间, 站点, 状态, 关键字, 显示条数 |
| 查询 | 按当前条件更新列表或卡片 |
| 点击行 | 打开该域的详细界面或抽屉 (Drawer) |
| 刷新 | 当怀疑实时数值时，按前次条件重新查询 |
时间范围
报警·诊断·日志·数据查询界面提供快速时间范围选项。
| 按钮 | 用途 |
|---|---|
10M / 30M | 追踪刚刚发生的故障 |
1H / 6H / 12H | 分析当日交接班时间段 |
ALL | 显示搜索条件的全部期间 |
建议操作流程
交班开始
- 在 대시보드 中确认通信连接率、今日采集量、今日报警数、设备开工率、设备可用率、OEE。
- 在地图中检查是否存在红色·橙色站点或连接状态标签。
- 在右侧健康栏中确认缓存, WS, MQTT, Kafka, 事件DB, 时序状态。
- 在 일일 통계 中对比昨日与今日的采集量·报警量。
发生报警
- 通过右上角 Toast 或报警徽标确认新报警。
- 在 알람 中缩小期间和站点范围，打开详情。
- 将标签·资产 ID 输入域搜索，跳转至设备·数据查询界面。
- 若为重复报警，检查 고급 알람, 알람 성능, 플로우, EQL 도움말 以巡检规则与自动化状态。
连接异常
权限与菜单显示
左侧菜单根据角色而异。 只有在服务器端允许该角色打开时，相关链接才会显示；若组内无任何可见链接，则整个组将消失。菜单与服务器访问控制遵循同一规则 (security-rule.xml)。
| 角色 | 一般范围 | 可见菜单 |
|---|---|---|
| ADMIN | 全局运行·设置·安全·系统管理 | 全部 |
| API | 外部系统联动账号。需同时赋予安全策略 | 除 사용자 · API 토큰 以外的全部 |
| USER | 以查询为主 | 上表中的 ○ —— 资产 · 标签 · 数据查询 · 维护现状 · 维护订单 · 预防性维护计划 · ISO 数据 · 报警 等五个菜单 |
即便菜单可见，界面内的写入权限依然细分。例如，USER 只能逐条 확인 报警，不能执行“全部确认”，且在高级报警中不会出现写入按钮。服务器将拒绝的按钮不会在界面中显示。
若因权限不足导致功能受限，请联系安全管理员请求变更角色。详细账号管理请参考 보안 관리。
常见问题
Q. 看不到之前的 “摘要” 菜单。
A. 界面改版后，首屏菜单名称统一为 대시보드。内部 URL 与 /map/index 相同。
Q. 도구 菜单中的时序引擎·SQL 项目消失了。
A. 左侧菜单中在新窗口打开的外部项目仅有标准组的 OPC-UA 和 AAS V3。常规时序查询请使用数据组的 트렌드, 데이터 출력, 스냅샷 界面。
Q. 菜单可见，但没有保存按钮，或者点击后被拦截。
A. 菜单仅显示角色可打开的内容，写入按钮同样按角色区分。如需权限，请联系 보안 관리 负责人申请变更角色。
Q. 使用顶部搜索查询数据后，当前表格没有变化。
A. 顶部搜索用于全局域跳转。若要过滤当前表格，请使用各界面正文顶部的搜索表单。
Q. Toast 消失后，还能再次查看内容吗？
A. 报警在 알람, 系统事件在 진단, 详细应用程序日志在 시스템 的日志界面中重新查询。
Q. 看不到左侧菜单。
A. 请点击顶部左侧的菜单切换按钮。若浏览器宽度较窄，可能会自动处于折叠状态。