# 铁路无人机智能巡检平台左侧导航与页面功能划分设计

## 1. 文档信息

| 项目 | 内容 |
| --- | --- |
| 文档名称 | 左侧导航与页面功能划分设计 |
| 适用系统 | 铁路无人机智能巡检平台 Web 端 |
| 设计目标 | 将当前集中式单页拆分为职责清晰、可独立访问、可跨页联动的业务页面 |
| 导航模式 | 固定左侧导航 + 一级业务 Tab + 页面内二级 Tab |
| 设计范围 | 信息架构、功能归属、页面结构、路由、联动、权限、状态管理和实施顺序 |

## 2. 划分目标

当前页面同时承载全局指标、全链路运行、巡检任务、告警、GIS、工单和模型版本，随着数据量和操作能力增加，会产生以下问题：

- 首屏信息密度过高，用户难以快速定位当前工作。
- 全链路运行过程与日常业务管理混合，运行态和管理态职责不清。
- GIS、告警、工单之间虽然存在关联，但操作区域相互挤压。
- 页面初始化需要同时请求多类数据，加载范围过大。
- 权限难以按岗位隔离，所有用户看到相同内容。
- URL 无法准确保存当前业务页面、筛选条件和实体上下文。

页面拆分后应达到以下效果：

1. 每个一级 Tab 对应一个稳定业务域。
2. 用户进入页面后只加载该业务域所需数据。
3. 全链路运行保留完整的 12 节点工作台，不被拆散到多个页面。
4. 任务、资源、结果、告警、工单和样本可跨页面追溯。
5. GIS 成为独立空间工作台，同时能以嵌入模式服务其他业务页面。
6. 告警处置与工单闭环分别管理，状态和操作边界明确。
7. 左侧导航可按岗位权限显示、隐藏或限制操作。

## 3. 划分原则

### 3.1 按业务对象划分

任务、资源、分析结果、告警、工单、样本和模型分别拥有独立管理页面。一个业务对象只在一个页面承担主数据维护职责，其他页面仅通过摘要、快照或详情抽屉进行关联展示。

### 3.2 按工作流保留运行上下文

全链路运行是一次完整运行实例，不按节点拆成左侧一级菜单。12 个节点继续在“全链路运行”页面内使用阶段导航，保证运行过程、事件顺序和上下文连续。

### 3.3 空间能力统一复用

GIS 采用统一地图组件，通过不同模式加载任务、航线、资源、结果、告警、工单、基线和豁免区图层。独立 GIS 页面负责综合空间分析，业务页面内的 GIS 只显示当前对象相关图层。

### 3.4 管理页面与处置页面分离

- 告警中心负责告警研判、证据确认、抑制与转工单。
- 工单中心负责派发、受理、现场处置、反馈、复核和关闭。
- 样本与模型负责算法数据闭环和模型版本管理。

### 3.5 路由即状态入口

页面、二级 Tab、筛选条件和选中实体应尽量反映在 URL 中，使页面支持刷新恢复、浏览器前进后退和链接分享。

## 4. 左侧导航总体结构

建议设置 10 个一级 Tab，并使用分组标题降低导航认知负担。

```text
铁路无人机智能巡检平台

态势
  工作总览
  GIS 态势

巡检
  全链路运行
  巡检任务
  数据资源

研判
  智能分析
  告警中心

闭环
  工单中心
  样本与模型

系统
  系统运维
```

### 4.1 一级 Tab 清单

| 序号 | 一级 Tab | 路由 | 主要职责 | 默认角标 |
| --- | --- | --- | --- | --- |
| 1 | 工作总览 | `/overview` | 全局指标、待办、运行态势和快捷入口 | 待处理总数 |
| 2 | GIS 态势 | `/gis` | 线路、航线、资源、隐患、告警和工单空间分析 | 高等级告警数 |
| 3 | 全链路运行 | `/runs` | 创建、观察、回放和恢复完整运行实例 | 运行中数量 |
| 4 | 巡检任务 | `/tasks` | 任务计划、任务参数、航线下发和飞行执行 | 待执行任务数 |
| 5 | 数据资源 | `/resources` | 多源数据接入、预处理、质量和资源检索 | 接入异常数 |
| 6 | 智能分析 | `/analysis` | 分析任务、模型推理结果、规则判定和证据 | 失败任务数 |
| 7 | 告警中心 | `/alarms` | 告警研判、证据链、抑制、确认和转工单 | 待研判告警数 |
| 8 | 工单中心 | `/workorders` | 派发、受理、处置、反馈、复核和关闭 | 我的待办数 |
| 9 | 样本与模型 | `/algorithm-assets` | 样本回流、标注队列、数据集和模型版本 | 待标注样本数 |
| 10 | 系统运维 | `/operations` | 服务状态、接口集成、事件、审计和配置 | 系统异常数 |

## 5. 当前单页功能迁移关系

| 当前功能区域 | 新归属页面 | 处理方式 |
| --- | --- | --- |
| 顶部统计卡片 | 工作总览 | 按业务域重组为核心指标、待办和趋势 |
| 全链路运行工作台 | 全链路运行 | 保持 12 节点结构，作为独立主页面 |
| 巡检任务列表 | 巡检任务 | 扩展为列表、详情、航线和执行监控 |
| 告警中心列表 | 告警中心 | 扩展筛选、证据链、确认、抑制和转工单 |
| GIS 与工单闭环区域 | GIS 态势、工单中心 | 地图与工单拆分，通过选中实体双向联动 |
| 模型版本列表 | 样本与模型 | 与样本池、标注任务、数据集版本统一管理 |
| 数据资源统计 | 数据资源 | 增加接入队列、预处理记录和质量结果 |
| 分析任务与 AI 结果统计 | 智能分析 | 增加分析任务、推理工作区、结果证据和规则命中 |
| 服务健康和运行事件 | 系统运维 | 集中展示服务、消息、存储和接口状态 |

## 6. 各一级 Tab 页面设计

### 6.1 工作总览

#### 页面职责

提供全系统的当天态势和岗位待办，不承载复杂业务编辑。用户从总览发现问题后进入对应业务页面处理。

#### 页面组成

1. 核心指标：巡检任务、数据资源、分析任务、AI 结果、有效告警、工单、闭环率和样本回流数。
2. 运行态势：运行中、已完成、失败和取消的全链路实例。
3. 待办中心：待执行任务、接入异常、分析失败、待研判告警、待处置工单和待复核工单。
4. 告警趋势：按时间、线路、专业和等级统计。
5. 工单闭环趋势：派发量、按时完成率、超时量和退回量。
6. 系统健康摘要：后端、视觉服务、点云服务、数据库、Kafka、Redis 和对象存储状态。
7. 快捷入口：新建巡检任务、进入全链路运行、进入 GIS、处理告警、处理工单；总览不直接提供“启动全链路”操作。

#### 页面交互

- 点击指标进入目标页面并自动带入对应筛选条件。
- 点击运行实例进入全链路运行详情。
- 点击告警或工单待办进入实体详情。
- 总览只展示摘要，不在卡片中直接完成高风险处置操作。

### 6.2 GIS 态势

#### 页面职责

提供跨任务、跨运行实例的综合空间态势，是线路空间分析、隐患定位和业务对象联动的统一入口。

#### 页面布局

- 左侧：图层树和业务筛选器。
- 中部：全尺寸 GIS 主视图。
- 右侧：选中对象详情、证据摘要和关联实体。
- 底部：时间轴、里程轴或对象结果列表，可折叠。

#### 图层分类

| 图层组 | 图层内容 |
| --- | --- |
| 线路基础 | 铁路中心线、里程标、桥梁、隧道、站场、接触网 |
| 规则空间 | 防护区、重点防洪点、接触网 ROI、豁免区、基线区域 |
| 巡检执行 | 巡检任务范围、规划航线、实际轨迹、无人机位置 |
| 数据资源 | 可见光、红外、视频关键帧、点云、TIF/DEM 采集点 |
| 智能结果 | 检测框、分割区域、热异常、形变和变化检测结果 |
| 业务处置 | 告警点、工单点、处置范围和闭环状态 |

#### 页面内二级 Tab

- 综合态势
- 任务与航线
- 告警分布
- 工单分布
- 基线与豁免区

#### 关键操作

- 按线路、里程、任务、运行实例、时间和等级筛选。
- 图层显示、隐藏、透明度和聚合级别控制。
- 点击地图对象打开统一实体详情抽屉。
- 从告警点进入告警中心，从工单点进入工单中心。
- 支持按里程范围框选并创建任务筛选条件。

### 6.3 全链路运行

#### 页面职责

管理一次完整巡检处理运行的创建、实时观察、节点操作、失败恢复、历史回放和结果导出。

#### 页面内二级 Tab

- 运行工作台：当前或选定运行实例的 12 节点工作区。
- 运行记录：全部运行实例、状态、耗时、发起人和结果摘要。
- 异常运行：失败、取消、超时和降级运行实例。

#### 运行工作台保留内容

1. 运行控制区：启动、取消、重新运行、导出。
2. 总体进度和当前节点。
3. 12 节点阶段导航。
4. GIS 空间态势。
5. 当前节点专属操作界面。
6. 事件、资源、AI 结果、规则、告警工单和样本证据页签。
7. 节点失败详情和从节点重试。

#### 与其他页面的边界

- 本页面展示运行时快照和本次运行产生的业务实体。
- 任务长期维护在“巡检任务”。
- 资源长期检索和质量复盘在“数据资源”。
- 告警批量研判在“告警中心”。
- 工单日常处置在“工单中心”。
- 页面内“查看详情”跳转到目标页面并保留 `runId`。

### 6.4 巡检任务

#### 页面职责

管理巡检计划、任务参数、线路范围、航线下发、飞行状态和任务结果关联。

#### 页面内二级 Tab

- 任务列表
- 待执行
- 执行中
- 已完成
- 异常任务

#### 任务列表字段

任务编号、任务名称、线路、里程范围、任务类型、优先级、计划时间、无人机、航线、状态、完成率和发起人。

#### 任务详情区域

1. 基本参数：线路、里程、专业、场景集和优先级。
2. 飞行参数：高度、速度、航向、重叠率、RTK/PPK 和返航策略。
3. 采集参数：可见光、视频、红外、点云和 TIF/DEM。
4. 航线任务：航点、总里程、预计时长、下发状态和外部任务编号。
5. 执行轨迹：规划航线与实际轨迹对比。
6. 关联结果：资源、分析任务、告警、工单和运行实例。

#### 关键操作

- 新建、编辑、复制和取消任务。
- 下发或重新下发航线任务。
- 查看无人机状态和任务回执。
- 启动关联全链路运行。
- 在 GIS 中定位任务范围。

### 6.5 数据资源

#### 页面职责

统一管理多源数据接入、校验、预处理、质量评估、资源预览和生命周期。

#### 页面内二级 Tab

- 资源库
- 接入监控
- 预处理记录
- 质量异常

#### 资源库字段

资源编号、资源名称、类型、来源任务、采集设备、采集时间、里程、坐标、大小、校验状态、预处理状态和分析状态。

#### 接入监控

- 按资源显示上传进度、分片数量、速度、剩余时间和断点续传状态。
- 显示元数据校验、时间同步、坐标解析、完整性校验和入库结果。
- 对失败资源提供重传、重新校验和重新解析操作。

#### 预处理记录

- 可见光：畸变校正、去模糊、曝光检查和抽帧。
- 红外：温度标定、坏点修复和辐射校正。
- 点云：去噪、配准、分割和坐标转换。
- TIF/DEM：投影校验、重采样和高程基准转换。
- 显示每个处理器的输入、输出、耗时、参数和日志。

#### 资源预览

使用统一证据查看器承载图像、视频、红外热图、点云和栅格数据。预览器支持元数据、空间定位、关联结果和原始文件下载权限控制。

### 6.6 智能分析

#### 页面职责

管理分析任务、模型执行、推理结果、规则判定和算法证据。

#### 页面内二级 Tab

- 分析任务
- AI 结果
- 规则判定
- 失败与降级

#### 分析任务

展示分析任务编号、来源任务、资源数量、模型组、版本、运行设备、队列时间、执行时间、状态和错误信息。支持重新执行、取消和查看运行日志。

#### AI 结果

展示场景、类别、置信度、模型版本、来源资源、里程、空间坐标和处理时间。结果可打开证据查看器，并与 GIS 同步定位。

#### 规则判定

展示规则版本、输入值、阈值、空间关系、命中结果、抑制原因和产生告警。支持按规则、场景、线路和判定结论筛选。

#### 失败与降级

集中显示模型超时、服务不可用、资源不可解析、推理失败和降级处理记录，明确影响资源、影响场景和是否允许继续运行。

### 6.7 告警中心

#### 页面职责

完成告警的集中研判、证据确认、等级调整、抑制、合并和转工单。

#### 页面内二级 Tab

- 待研判
- 已确认
- 已抑制
- 已转工单
- 已关闭

#### 告警列表字段

告警编号、场景、类别、等级、置信度、线路、里程、发现时间、来源任务、规则、状态、责任专业和关联工单。

#### 告警详情

1. 告警摘要和空间位置。
2. 原始资源、AI 结果和规则命中的完整证据链。
3. 同位置历史告警、基线对象和豁免区关系。
4. 研判记录、状态变化和操作人员。
5. 关联工单和处置结果。

#### 关键操作

- 确认有效告警。
- 调整告警等级和责任专业。
- 抑制误报并填写原因。
- 合并重复告警。
- 创建工单或查看已生成工单。
- 在 GIS 中定位并查看影响范围。

### 6.8 工单中心

#### 页面职责

管理从工单创建到复核关闭的完整处置流程，是现场处置人员和复核人员的主工作页面。

#### 页面内二级 Tab

- 我的待办
- 全部工单
- 待派发
- 处理中
- 待复核
- 已闭环
- 超时工单

#### 视图模式

- 表格视图：适合查询、筛选和批量操作。
- 泳道视图：按待派发、待受理、处理中、待复核、已闭环和已退回展示状态流转。
- 地图视图：按空间分布和处置状态查看工单。

#### 工单详情

1. 工单信息：编号、告警、专业、责任人、班组、优先级和时限。
2. 派发回执：外部工单编号、通道、响应码和回执时间。
3. 处置记录：受理、到场、处理、反馈和附件。
4. 复核信息：通过、退回、复核意见和复核人员。
5. 状态同步：工单状态与告警状态一致性。
6. 操作历史：改派、催办、退回、重开和关闭记录。

#### 关键操作

- 派发、重新派发和人工改派。
- 接单、更新进度和提交处置反馈。
- 上传现场照片和说明。
- 复核通过或退回重办。
- 超时催办和升级。
- 在 GIS 中定位工单。

### 6.9 样本与模型

#### 页面职责

负责告警和处置结果向算法数据资产的回流，以及模型版本的统一管理。

#### 页面内二级 Tab

- 候选样本
- 标注队列
- 数据集版本
- 模型版本
- 发布记录

#### 候选样本

展示样本编号、来源资源、AI 结果、告警、工单、入池原因、目标模型组、优先级和状态。支持入池、排除、调整优先级和指定标签集。

#### 标注队列

展示待标注、标注中、待审核、已通过和已退回样本，记录标注人员、审核人员和质量结果。

#### 模型版本

展示模型组、版本、框架、模型文件、训练数据集、评价指标、状态、发布时间和当前生效环境。支持版本详情、上线审批、回滚和停用。

#### 发布记录

记录模型从开发、验证、灰度到生产的状态变化，展示发布人、审批人、环境、时间和回滚点。

### 6.10 系统运维

#### 页面职责

集中管理系统健康状态、外部接口、事件流、配置和审计，避免运维信息混入业务页面。

#### 页面内二级 Tab

- 服务状态
- 接口集成
- 消息与任务
- 系统配置
- 操作审计

#### 服务状态

展示 Spring Boot、视觉推理、点云分析、PostgreSQL/PostGIS、Kafka、Redis、MinIO、Prometheus 和前端入口的健康状态、响应时间和最近异常。

#### 接口集成

展示无人机 SDK/API、巡检管理平台、工单系统和消息通道的连接配置、最近调用、成功率和失败重试。

#### 消息与任务

展示 Kafka 事件积压、异步任务、失败队列和重试记录。

#### 操作审计

记录任务操作、告警研判、工单流转、样本决策、模型发布和系统配置变更。

## 7. 左侧导航交互规范

### 7.1 导航尺寸

- 展开宽度：`224px`。
- 收起宽度：`64px`。
- 顶部保留系统标识和平台名称。
- 中部为分组导航，超出高度时独立滚动。
- 底部放置当前用户、角色、退出和折叠控制。

### 7.2 导航状态

| 状态 | 表现 |
| --- | --- |
| 默认 | 图标、名称使用中性色 |
| 悬停 | 显示浅色背景和完整功能提示 |
| 当前 | 左侧强调线、强调背景和高对比文字 |
| 有待办 | 右侧显示数量角标，最大显示 `99+` |
| 无权限 | 默认隐藏；需要说明时可禁用并显示权限提示 |
| 收起 | 仅显示图标和角标，悬停显示名称 |

### 7.3 移动端

- 宽度小于 `768px` 时左侧导航改为抽屉。
- 页面顶部保留菜单按钮、页面标题和主要操作。
- 打开页面或完成导航后自动收起抽屉。
- 二级 Tab 支持横向滚动，不压缩文字。

## 8. 页面统一结构

所有业务页面采用一致布局：

```text
页面标题 / 当前上下文                         页面主操作
页面说明 / 面包屑
----------------------------------------------------
二级 Tab
----------------------------------------------------
筛选栏 / 保存视图 / 刷新 / 导出
----------------------------------------------------
主内容区：表格、地图、工作台、泳道或指标
----------------------------------------------------
分页 / 数据时间 / 加载状态
```

### 8.1 页面标题区

- 左侧显示页面名称、面包屑和必要的上下文编号。
- 右侧只保留该页面最主要的 1 至 3 个操作。
- 刷新属于页面级操作，不再作为全站固定按钮。

### 8.2 筛选区

- 常用筛选直接展示，高级筛选放入可展开区域。
- 筛选条件写入 URL 查询参数。
- 支持保存个人筛选视图。
- 切换二级 Tab 时保留各 Tab 独立筛选状态。

### 8.3 详情方式

- 简单查看使用右侧详情抽屉，避免频繁离开列表。
- 复杂编辑或完整证据链使用独立详情路由。
- 所有详情均显示实体编号和关联实体入口。

## 9. 路由设计

```text
/
  /overview
  /gis
  /runs
    /runs/:runId
  /tasks
    /tasks/:taskId
  /resources
    /resources/:resourceId
  /analysis
    /analysis/jobs/:jobId
    /analysis/results/:resultId
  /alarms
    /alarms/:alarmId
  /workorders
    /workorders/:workorderId
  /algorithm-assets
    /algorithm-assets/samples/:sampleId
    /algorithm-assets/models/:modelId
  /operations
```

### 9.1 路由查询参数

| 参数 | 用途 | 参数值 |
| --- | --- | --- |
| `tab` | 页面内二级 Tab | `tab=pending-review` |
| `lineId` | 线路筛选 | `lineId=line-demo` |
| `taskId` | 保留来源任务上下文 | `taskId=task-001` |
| `runId` | 保留来源运行上下文 | `runId=run-001` |
| `step` | 定位全链路节点 | `step=alarm.generating` |
| `entityType` | 选中实体类型 | `entityType=alarm` |
| `entityId` | 选中实体编号 | `entityId=alarm-001` |
| `status` | 状态筛选 | `status=pending` |
| `severity` | 告警等级筛选 | `severity=critical` |
| `from`、`to` | 时间范围 | ISO 8601 时间 |

## 10. 跨页面联动设计

### 10.1 实体关联链

```mermaid
flowchart LR
    T[巡检任务] --> R[数据资源]
    T --> U[全链路运行]
    R --> J[分析任务]
    J --> A[AI 结果]
    A --> G[规则判定]
    G --> L[告警]
    L --> W[工单]
    W --> S[回流样本]
    S --> M[模型版本]
```

### 10.2 典型跳转

| 来源 | 操作 | 目标 |
| --- | --- | --- |
| 工作总览 | 点击待执行任务 | 巡检任务，自动筛选待执行 |
| 工作总览 | 点击高等级告警 | 告警中心，自动筛选严重/高等级 |
| 巡检任务 | 查看本次处理过程 | 全链路运行，定位对应 `runId` |
| 巡检任务 | 查看采集成果 | 数据资源，按 `taskId` 筛选 |
| 数据资源 | 查看识别结果 | 智能分析，按 `resourceId` 筛选 |
| 智能分析 | 查看告警 | 告警中心，打开关联告警详情 |
| 告警中心 | 查看工单 | 工单中心，打开关联工单详情 |
| 工单中心 | 地图定位 | GIS 态势，选中该工单点位 |
| 工单中心 | 查看回流样本 | 样本与模型，按 `workorderId` 筛选 |
| 任意实体详情 | 查看运行上下文 | 全链路运行，定位对应节点和实体 |

### 10.3 返回上下文

跨页跳转时增加 `returnTo` 或由路由状态记录来源。用户关闭详情或点击返回后，应恢复来源页面的二级 Tab、筛选条件、分页和滚动位置。

## 11. 共享组件边界

### 11.1 应复用组件

| 组件 | 使用页面 |
| --- | --- |
| `AppShell` | 全部页面 |
| `SidebarNav` | 全部页面 |
| `PageHeader` | 全部业务页面 |
| `FilterBar` | 任务、资源、分析、告警、工单、样本 |
| `EntityDetailDrawer` | GIS、全链路及全部列表页 |
| `EvidenceViewer` | 资源、智能分析、告警、工单 |
| `RailwayGisMap` | GIS、全链路、任务、告警、工单 |
| `StatusTag` | 全部业务列表 |
| `SeverityTag` | 智能分析、告警、工单、GIS |
| `OperationTimeline` | 全链路、任务、工单、模型发布 |
| `EmptyState`、`ErrorState` | 全部页面 |

### 11.2 全链路组件迁移

现有全链路组件保持业务逻辑不变，迁移到 `views/runs` 页面域：

```text
views/runs/RunListView.vue
views/runs/RunWorkspaceView.vue
components/full-chain-run/FullChainRunConsole.vue
components/full-chain-run/RunStageNavigator.vue
components/full-chain-run/RunGisMap.vue
components/full-chain-run/RunEvidenceTabs.vue
components/full-chain-run/steps/*
```

### 11.3 GIS 组件调整

当前综合 GIS 和全链路 GIS 应抽取为同一地图能力的不同配置模式：

- `mode="global"`：综合 GIS 态势。
- `mode="run"`：全链路运行上下文。
- `mode="task"`：任务与航线。
- `mode="alarm"`：告警证据和影响范围。
- `mode="workorder"`：工单位置和处置状态。

## 12. 前端工程结构建议

```text
frontend/src/
  layouts/
    AppShell.vue
  router/
    index.ts
    routes.ts
  navigation/
    sidebar.ts
  views/
    overview/
    gis/
    runs/
    tasks/
    resources/
    analysis/
    alarms/
    workorders/
    algorithm-assets/
    operations/
  components/
    common/
    gis/
    evidence/
    full-chain-run/
  stores/
    app.ts
    filters.ts
    selection.ts
    run.ts
  services/
    api.ts
    tasks.ts
    resources.ts
    analysis.ts
    alarms.ts
    workorders.ts
    models.ts
```

页面组件采用路由级懒加载。业务 API 按领域拆分，避免所有接口继续集中在单一 `api.ts` 中。

## 13. 状态管理设计

### 13.1 全局状态

- 当前用户、角色和权限。
- 左侧导航展开/收起状态。
- 全局线路和时间上下文。
- 当前运行实例及 SSE 连接状态。
- 跨页面选中实体。

### 13.2 页面状态

- 二级 Tab。
- 筛选条件、排序、分页和列配置。
- 地图图层、视角和选中对象。
- 列表选中行和详情抽屉状态。

### 13.3 数据加载

- 进入路由后按页面懒加载数据。
- 总览只加载聚合接口，不拉取完整业务列表。
- 列表页使用服务端分页和筛选。
- 详情数据在用户选中实体后加载。
- SSE 只在全链路运行页面或存在运行中实例时保持连接。
- 离开页面后取消不再需要的请求和订阅。

## 14. 权限与岗位视图

| 岗位 | 默认页面 | 主要可见 Tab | 主要操作权限 |
| --- | --- | --- | --- |
| 调度人员 | 工作总览 | 总览、GIS、全链路、巡检任务 | 创建任务、下发航线、启动运行 |
| 数据管理员 | 数据资源 | 总览、数据资源、智能分析 | 重传、校验、预处理重跑 |
| 算法人员 | 智能分析 | 数据资源、智能分析、样本与模型 | 推理重跑、样本决策、模型管理 |
| 告警研判人员 | 告警中心 | GIS、智能分析、告警中心 | 告警确认、抑制、转工单 |
| 处置人员 | 工单中心 | GIS、工单中心 | 接单、处置、反馈 |
| 复核人员 | 工单中心 | GIS、告警中心、工单中心 | 复核通过、退回 |
| 管理人员 | 工作总览 | 全部业务 Tab | 查询、统计、导出 |
| 系统管理员 | 系统运维 | 全部 Tab | 配置、审计、系统维护 |

权限不足的一级 Tab 默认隐藏；用户可以查看但不能操作的页面，应保留页面并禁用具体操作，同时说明所需权限。

## 15. 数据接口边界

拆页后接口按页面职责组织：

| 页面 | 主要接口范围 |
| --- | --- |
| 工作总览 | 聚合指标、趋势、待办摘要、健康摘要 |
| GIS 态势 | 空间对象、图层、里程查询、空间聚合 |
| 全链路运行 | 运行实例、节点快照、事件、重试、实体索引、导出 |
| 巡检任务 | 任务 CRUD、航线下发、状态回调、轨迹 |
| 数据资源 | 资源分页、接入状态、预处理记录、质量和预览 |
| 智能分析 | 分析任务、AI 结果、规则命中、证据 |
| 告警中心 | 告警分页、详情、证据链、研判和抑制 |
| 工单中心 | 工单分页、派发、改派、处置、复核和操作记录 |
| 样本与模型 | 样本、标注、数据集、模型版本和发布记录 |
| 系统运维 | 健康、指标、集成状态、事件和审计 |

列表接口统一支持分页、排序、时间范围和业务筛选，避免前端一次性拉取大量数据后再截取显示。

## 16. 实施阶段

### 第一阶段：应用框架与导航

- 引入 Vue Router，建立 `AppShell`、左侧导航和路由出口。
- 将当前统计卡片迁移到“工作总览”。
- 将全链路工作台整体迁移到“全链路运行”。
- 保持现有业务功能和接口行为不变。

### 第二阶段：核心业务拆页

- 建立“巡检任务”“数据资源”“智能分析”页面。
- 将任务、资源、分析结果从全局数据中解耦。
- 补充列表分页、筛选和详情路由。

### 第三阶段：空间与闭环拆页

- 建立独立“GIS 态势”页面并抽取共享地图组件。
- 建立“告警中心”和“工单中心”。
- 完成告警、工单、GIS 的双向定位和上下文跳转。

### 第四阶段：算法资产与运维

- 建立“样本与模型”和“系统运维”。
- 完成样本回流、模型版本、服务健康和审计页面。
- 按岗位配置导航和操作权限。

### 第五阶段：体验与性能验收

- 完成路由懒加载、服务端分页、筛选状态恢复和请求取消。
- 完成桌面、平板和移动端适配。
- 完成权限、异常、空状态和大数据量测试。

## 17. 验收标准

### 17.1 功能验收

- 当前单页功能全部迁移到明确的一级 Tab，不丢失业务操作。
- 10 个一级 Tab 均有独立路由，可刷新并恢复页面。
- 全链路 12 节点、事件、GIS 和证据页签保持完整。
- GIS、告警和工单成为独立页面并可双向跳转。
- 任务、资源、结果、告警、工单和样本可沿实体链追溯。
- 用户返回来源页面后，筛选、分页和滚动位置可恢复。

### 17.2 权限验收

- 不同岗位只显示授权导航。
- 查看权限和操作权限分离。
- 关键业务操作记录人员、时间、参数和结果。

### 17.3 性能验收

- 首屏只加载当前页面所需接口。
- 非当前路由页面不发起业务列表请求。
- 大列表采用服务端分页或虚拟滚动。
- GIS 大量点位启用聚合或分层加载。
- 路由切换过程中无重复 SSE 连接和残留请求。

### 17.4 交互验收

- 左侧导航展开、收起、角标和当前状态清晰。
- 页面标题、筛选、主操作和详情方式保持一致。
- 窄屏使用导航抽屉，页面无全局横向溢出。
- 列表、GIS、详情抽屉和跨页跳转的选中对象一致。

## 18. 最终划分结论

平台采用“总览 + 空间态势 + 运行过程 + 业务对象 + 闭环处置 + 算法资产 + 系统运维”的页面体系。全链路运行继续承载一次运行实例的完整过程，其他一级 Tab 分别承担长期业务对象的查询、管理和处置。该划分能够降低单页复杂度，保持业务链路可追溯，并为后续权限、性能和功能扩展提供稳定边界。
