交通运营
TrafficOps 是面向交通枢纽、检查站、客流、车流、货检和口岸类运营场景的 FactVerse 模块。它把实时队列、等待时间、吞吐量、通道与检查站状态、事件、人员规划、设备健康、场景仿真和审阅证据组织在同一个运营工作流中。
当运营团队需要监控航站楼、口岸或检查站环境，判断拥堵形成位置，对比人员或通道方案，并用可追溯证据准备行动计划时，可以使用本指南。
AI 辅助分析能力见 交通运营 AI 工具。
当前服务边界
TrafficOps 由多个运行面共同组成：
| 运行面 | 当前作用 |
|---|---|
| FactVerse 前端 | 提供 TrafficOps 首页、场景编辑、客流、检查站总览、旅客通关、车辆运营、货检运营、多区域视图、数据接入、设备配置、仿真、Commander 视图、容量规划、SLA 监控、事件、能源看板、密度热力图、培训、预测性维护和旅客分析等页面。 |
| TrafficOps 后端服务 | 提供 /api/v1/trafficops 下的仪表盘、KPI、队列、通道快照、客流、车流、货检、WCP、事件、运营事件、规范模型、设备、密度、能源、优化、多区域、培训、决策、报表、规则、工作流和仿真接口。 |
| AI Engine | 在项目启用时提供 TrafficOps 预测、主动预警、监控状态、what-if 对比、优化、校准、DES/DAG 仿真，以及基于场景包的场景或道路网络服务。 |
| 平台工具框架 | 为经过授权的 Agent 工作流提供 TrafficOps 工具，例如交通流分析和等待时间预测。 |
| DFS | 在仪表盘、工具和仿真使用数据前，准备到达、队列、事件、设备、人员、排班、布局和运营数据集。 |
| Inspector 与工单 | 当 TrafficOps 行动转化为现场任务时，提供行动跟踪、事件跟进、维护反馈和现场执行上下文。 |
TrafficOps 支持运营审阅、场景规划和行动准备。变更人员、通道配置或现场流程前，应确认源数据、本地运营规则和负责人审批。
运营工作流
当前可用工作流
| 工作流 | 用户可以审阅或执行的内容 |
|---|---|
| 运营总览 | 审阅吞吐量、等待时间、队列状态、利用率、活动事件、SLA 风险和运营事件。 |
| 客流 | 审阅当前流量、时间线、等待时间分布、检查站热力图、旅客分析和预测需求。 |
| 检查站总览 | 审阅通道或检查站状态、队列长度、利用率、当前配置、近期快照和场景状态。 |
| 车辆运营 | 审阅车辆到达、通道配置、潮汐通道场景、事件影响，以及汽车或摩托车通关视图。 |
| 货检运营 | 审阅货检队列、检查流程、人员影响、抽检率场景、滞留货物和吞吐 KPI。 |
| WCP 与处理流程 | 审阅巴士排班、高峰仿真、拥堵规则、仪表盘状态和检查站处理规则评估结果。 |
| 事件与密度 | 审阅活动事件、事件统计、密度网格、红黄绿密度单元、拥挤预警和可用的回放证据。 |
| 资源规划 | 审阅当前优化状态、人员排班、建议、班次规划、容量规划、SLA 监控和决策日志。 |
| 仿真 | 运行或审阅 DES/DAG 仿真，对比场景，查看结果，并在可用时导出或回放仿真输出。 |
| 设备与能源 | 审阅设备配置、灵敏度分析、健康报告、维护排班，以及运营范围内的能源 KPI。 |
| 多区域运营 | 审阅区域 KPI、时间线、韧性和跨区域仿真结果。 |
| 培训 | 审阅培训看板和演练状态，用于操作学习或事件演练。 |
开始前
在依赖 TrafficOps 输出前，准备运营范围和源数据：
| 要求 | 说明 |
|---|---|
| 租户与运营范围 | 明确站点、航站楼、检查站、区域、方向、路线和时间窗口。 |
| 权限 | 将用户角色匹配到 TrafficOps 模块访问、决策审阅、仿真、报表和写入动作。 |
| 稳定对象 | 为设施、区域、检查站、通道、设备、人员角色、事件、排班和车辆或旅客类别使用稳定 ID。 |
| 源数据 | 准备到达、吞吐、等待时间、快照、排班、事件、设备状态、人员和规则数据。 |
| 审阅负责人 | 定义谁接受建议、批准人员或通道调整、开启事件任务并记录反馈。 |
| 场景假设 | 记录需求窗口、服务时间假设、人员成本、容量限制、故障假设和 SLA 目标。 |
| 数据质量 | 检查时间戳对齐、缺失快照、过期排班、重复事件和单位一致性。 |
当源系统需要连接器配置、源到目标映射、同步监控、数据质量审阅和受治理数据集准备时，请使用 DFS。
打开 TrafficOps
打开 FactVerse 应用并进入 TrafficOps 工作区。当前前端页面包括：
| 页面 | 路由 |
|---|---|
| 首页 | /trafficops |
| 场景编辑 | /trafficops/scenes |
| 客流 | /trafficops/flow |
| 资源优化 | /trafficops/optimization |
| FactVerse 3D 视图 | /trafficops/3d-view |
| 旅客通关 | /trafficops/passenger |
| WCP 仪表盘 | /trafficops/cp |
| 检查站总览 | /trafficops/checkpoint-overview |
| 车辆运营 | /trafficops/vehicles |
| 货检运营 | /trafficops/cargo |
| 多区域 | /trafficops/multi-region |
| 数据接入 | /trafficops/data-ingestion |
| 设备配置 | /trafficops/equipment-config |
| 仿真 | /trafficops/sim |
| Commander 旅客与车辆视图 | /trafficops/commander-pax, /trafficops/commander-vehicle |
| What-if 与优化 | /trafficops/whatif, /trafficops/optimize |
| 容量与 SLA | /trafficops/capacity-planning, /trafficops/sla-monitor |
| 事件与密度 | /trafficops/incidents, /trafficops/density-surge |
| 能源与培训 | /trafficops/energy-dashboard, /trafficops/training |
| 预测性维护与旅客分析 | /trafficops/predictive-maintenance, /trafficops/passenger-analytics |
| 车辆通关与巴士大厅 | /trafficops/car-mc-clearance, /trafficops/departure-bus-hall |
模块可用性取决于租户配置和已启用路由。
准备运营数据
TrafficOps 依赖一致的运营数据包：
| 数据区域 | 常见准备工作 |
|---|---|
| 设施与检查站模型 | 将设施、区域、检查站、通道、设备、人员角色和方向映射到稳定 ID。 |
| 到达与队列数据 | 准备旅客、车辆、货物和巴士到达记录，包含时间戳、类别、来源和通道或检查站上下文。 |
| 通道快照 | 准备最新、近期和历史快照，用于队列长度、状态、容量和场景审阅。 |
| 事件 | 映射事件严重度、类型、状态、受影响区域、回放证据和响应状态。 |
| 人员与排班 | 准备人员名册、班次计划、人员角色和排班约束，用于资源规划。 |
| 设备与维护 | 准备设备状态、服务时间分布、灵敏度参数、健康记录和维护排班。 |
| 仿真输入 | 准备基线场景、what-if 覆盖参数、故障假设、路线图和对比指标。 |
审阅实时运营
从运营看板开始，再进入具体运营区域：
- 选择要审阅的设施、检查站、方向或区域。
- 审阅吞吐量、平均等待时间、P95 等待时间、队列长度、利用率、事件和 SLA 状态。
- 根据受影响队列打开客流、车辆、货检或 WCP 页面。
- 检查通道快照和检查站状态，确认瓶颈是局部问题还是跨区域问题。
- 批准行动前，记录时间窗口、数据来源和运营假设。
仪表盘是审阅界面。变更通道、人员或事件流程前，应由现场负责人确认本地约束。
分析客流、车流和货检
TrafficOps 将不同运营流分开，帮助团队审阅对应证据：
| 流程 | 审阅重点 |
|---|---|
| 客流 | 当前客流量、流量时间线、等待分布、检查站热度和预测需求。 |
| 车流 | 当前车流、到达、活跃通道、通道配置、潮汐通道仿真和事件影响。 |
| 货检 | 货车队列、检查流程、抽检率、滞留货物、人员配置、吞吐和系统内耗时。 |
| 人员绩效 | 处理效率、工作量分布和检查站人员审阅。 |
| 旅客分析 | 用于规划和报表的旅客趋势与行为审阅。 |
规划资源与场景
当当前状态需要人员、通道或容量决策时，使用资源规划能力：
| 页面 | 用途 |
|---|---|
| 资源优化 | 审阅当前人员、排班和建议。 |
| 班次规划 | 准备人员排班并检查覆盖情况。 |
| 容量规划 | 审阅更长周期的需求和容量假设。 |
| What-if 分析 | 对比基线和变化参数，例如人员数、通道容量、服务时间或故障假设。 |
| 仿真运行 | 运行、对比和导出 DES/DAG 场景，用于队列和服务流程分析。 |
| 决策日志 | 保存已接受、已驳回和已审阅建议的上下文。 |
场景输出应与输入一起阅读。请把需求假设、服务时间假设和约束说明保存在审阅记录中。
审阅事件、密度与培训
事件和密度页面支持运营响应：
- 审阅活动事件和事件统计。
- 检查所选窗口的密度网格单元和阈值状态。
- 当事件需要操作培训或事后复盘时，打开回放证据。
- 由责任人准备或批准响应方案。
- 使用培训演练在应用到实时运营前练习流程。
密度、事件和培训输出用于辅助人工审阅和训练，现场安全规程和本地指挥规则仍是执行依据。
审阅设备与能源
TrafficOps 为运营团队提供设备与能源页面：
| 区域 | 检查内容 |
|---|---|
| 设备配置 | 检查站画像、服务时间设置、灵敏度参数和区域级批量更新。 |
| 设备健康 | 健康报告、维护排班、受影响设施和关联运营风险。 |
| 预测性维护 | 当 TrafficOps 资产需要可靠性审阅时，检查设备风险和维护规划。 |
| 能源看板 | 当源读数已映射并验证后，审阅运营范围内的能源 KPI。 |
更深入的资产可靠性工作流请查看 预测性维护运营。
API 范围
TrafficOps API 统一在 /api/v1/trafficops 下：
| 分组 | 示例 endpoint |
|---|---|
| 总览与 KPI | /overview, /queues, /events, /kpis, /info |
| 通道快照 | /lane-snapshots/latest, /lane-snapshots/recent, /lane-snapshots/history, /lane-snapshots/scenes, /lane-snapshots/overview, /lane-snapshots/reconfig |
| 客流、车流和货检 | /passenger-flow/current, /passenger-flow/timeline, /passenger-flow/wait-distribution, /passenger-flow/heatmap, /vehicle-flow/current, /vehicle-ops/overview, /cargo-flow/kpis, /cargo-ops/overview |
| WCP 与检查站处理 | /wcp/bus-schedule, /wcp/evaluate-rules, /wcp/peak-simulation, /wcp/congestion-rules, /wcp/dashboard |
| 事件与运营事件 | /incidents/active, /incidents/stats, /ops/dashboard, /ops/events, /ops/events/{id}/ack, /ops/events/{id}/resolve |
| 规范模型 | /canonical/facilities, /canonical/facilities/{code}, /canonical/checkpoints/{id}/config, /canonical/zones/{id}/staff-schedule, /canonical/facilities/{code}/capacity |
| 设备与维护 | /equipment-config, /equipment-config/{checkpointId}/profile, /equipment-config/{checkpointId}/sensitivity-analysis, /equipment-config/facilities/{facilityCode}/health-report, /equipment-health, /equipment-health/schedule |
| 密度与能源 | /density/grid, /energy/kpis |
| 规划与报表 | /resource-optimization/current, /resource-optimization/staff-schedule, /resource-optimization/recommendations, /reports, /reports/generate, /rules |
| 多区域、培训与决策 | /multi-region/regions, /multi-region/timeline, /multi-region/simulate, /multi-region/resilience, /training/dashboard, /decisions |
| 工作流 | /workflow/action-plan/submit, /workflow/action-plan/dismiss, /workflow/tasks/pending, /workflow/ecm/incident-report, /workflow/ecm/what-if |
| 仿真与 AI endpoint | /simulations, /simulations/runs, /forecast, /simulate, /recommend, /ai/* |
AI Engine 页面在启用时包括 /ai/trafficops/forecast、/ai/trafficops/proactive-alerts、/ai/trafficops/monitor、/ai/trafficops/what-if、/ai/trafficops/optimize、/ai/trafficops/calibration/*、/ai/whatif/*、/ai/des/*、/ai/optimize/trafficops 和 /ai/packages/{package_key}/*。
验证清单
在运营会议或现场行动中使用 TrafficOps 输出前，确认：
- 租户、站点、检查站、方向、区域和时间窗口与审阅范围一致；
- 到达、队列、通道、事件、设备、排班和人员数据共享稳定 ID；
- 所选窗口内的源时间戳和单位已经对齐；
- 仿真和 what-if 假设随输出一起记录；
- 建议明确由谁接受或驳回；
- 通道、人员、事件和维护变更遵循本地审批路径；
- 决策日志、事件说明、报表或导出文件随审阅包保存；
- 行动反馈已记录，以便后续预测、场景和运营 playbook 持续改进。