交通營運
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 持續改進。