臺中城市脈動 展示系統
功能列表與驗收標準
版本 v3.1,2026-09-21。優先級:P0 展示必要、P1 加分、P2
後續。驗收方式:D 演示、T 測試紀錄、I 人工檢查、L 日誌或查詢。
v3.1 變更:2A 頁面依 04
排版與道路地圖改寫(2A-4、2A-10 至 2A-13);新增相機座標 1A-8;新增純
HTML POC 交付 G-7。
v3.0 變更:新增網關逐張取像、節點監控與多節點、.env
設定、2-A 監控後台、2-C 新工具等驗收項;情境摘要預設 Qwen3.8。
平台一:影像資料分析平台(地端
Jetson AGX Thor,可多台)
1A. 相機列表與影像取得
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 1A-1 |
每 10 分鐘 GET {GATEWAY_URL}/cameras
同步相機列表,差異比對,自動新增、移除 |
P0 |
模擬列表新增 3 路、移除 2 路,10
分鐘內分析中相機數同步;網關失敗沿用快照並告警 |
T、L |
| 1A-2 |
依 CAMERA_FILTER 或雲端分派決定本節點負責相機 |
P0 |
兩台節點分派後無重疊、無遺漏 |
T |
| 1A-3 |
GET /image/{cctv_id} 逐張取像,連線池、併發 ≤ 64、逾時
2 秒、退避重試 |
P0 |
356 路 1 張/秒穩定運行 1 小時,成功率 ≥ 98%,p95
延遲記錄於監控 |
L |
| 1A-4 |
取樣率可配置(1/尖峰 2/辨識級 2 張每秒) |
P0 |
變更 60 秒內生效 |
T |
| 1A-5 |
連續失敗標記 offline 並持續重試 |
P0 |
連續 5 次失敗 → offline;恢復後 1 分鐘內回 online |
T |
| 1A-6 |
影像品質判定(dark、blur、frozen、offline) |
P1 |
人工製造異常 2 分鐘內標記 |
T |
| 1A-7 |
欄位補齊(tier、group、roi) |
P0 |
缺漏 ≤ 5% 並標註 |
L |
| 1A-8 |
相機座標:API/TDX 優先,缺座標以路口、路名地理編碼並標
geo_precision,範圍框外回退區中心點 |
P0 |
全數相機有座標且都在臺中範圍框內;exact+intersection+road
合計 ≥ 75%;精度欄隨上傳 |
L、T |
1B. 偵測與追蹤(YOLO26)
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 1B-1 |
YOLO26 INT8 TensorRT 端到端偵測,8 類;YOLO_MODEL 可切
n/s/m |
P0 |
mAP50 ≥ 0.6,夜間 ≥ 0.5;切換模型不需改碼 |
T |
| 1B-2 |
NMS-free 固定延遲 |
P0 |
批次 32 延遲標準差 ≤ 15% |
T |
| 1B-3 |
吞吐與 GPU 負載 |
P0 |
負責路數 1 至 2 張/秒下 GPU ≤ 70%;容量測試 ≥ 2,000 張/秒 |
L |
| 1B-4 |
追蹤與計數(辨識級) |
P0 |
計數誤差 ≤ 15% |
T |
| 1B-5 |
密度與車道佔用率 |
P0 |
誤差 ≤ 10 個百分點 |
T |
| 1B-6 |
城市變化事件產生(聚集、回堵、佔用、停留、品質) |
P0 |
事件規則場景大綱全過;語句模板字串相等 |
T |
| 1B-7 |
信心門檻與低信心排除 |
P0 |
conf <0.35 不輸出;0.35 至 0.5 標 low_conf |
T |
1C. 隱私與治理
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 1C-1 |
不做人臉辨識、車牌
OCR、跨鏡再識別;reid_disabled=true |
P0 |
程式與模型清單審查;健康端點斷言 |
I、L |
| 1C-2 |
原始影像不保存、不上傳;frames_persisted 永為 0 |
P0 |
24 小時斷言;本地磁碟與雲端抽查 |
L、I |
| 1C-3 |
縮圖去識別化 |
P0 |
200 張人檢 0 張可辨識 |
I |
| 1C-4 |
保留期到期自動清理並產生銷毀紀錄 |
P0 |
RETENTION_DAYS 後縮圖刪除,purge_report 產出 |
L |
1D. 指標、基線與情境摘要
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 1D-1 |
每路每分鐘 12 項指標;本地 SQLite + Parquet |
P0 |
缺漏 ≤ 3%;Parquet 每小時產出 |
L |
| 1D-2 |
群組基線與偏離倍數 |
P0 |
基線等於同群組同時段中位數 |
T |
| 1D-3 |
vLLM 服務啟動並載入 VLM_MODEL(預設
Qwen/Qwen3.8-27B) |
P0 |
/v1/models 回傳設定的模型;切換 .env
後重啟載入新模型 |
T |
| 1D-4 |
情境摘要每事件 1 則、每路每小時 1 則;VLM_MODE
live/after_capture |
P1 |
繁體中文 60 至 120 字;抽樣 50 則無個人特徵 |
I |
| 1D-5 |
禁詞過濾與重生 |
P0 |
命中重生一次,再命中捨棄並計數 |
T |
| 1D-6 |
VLM 與偵測共用 GPU 讓位 |
P1 |
GPU ≥ 60% 延後摘要 |
L |
1E. 節點監控與上傳
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 1E-1 |
每 10
秒採集:分析中相機數、總數、已分析時長、幀數、延遲、CPU、GPU、GPU
記憶體、系統記憶體、儲存、溫度、功耗 |
P0 |
與 tegrastats 抽樣比對誤差 ≤ 5% |
T |
| 1E-2 |
心跳上傳至 CLOUD_HOST(.env),每 10
秒一筆 |
P0 |
後台 15 秒內看到更新;改 CLOUD_HOST
重啟後上傳到新主機 |
T |
| 1E-3 |
指標每分鐘、事件即時、治理資訊每小時、縮圖事件觸發上傳 |
P0 |
雲端筆數與本地一致 |
L |
| 1E-4 |
離線緩衝 24 小時重送 |
P0 |
斷線 30 分鐘恢復後全部補齊 |
T |
| 1E-5 |
/health 與 Prometheus;/config
顯示生效設定(遮罩金鑰) |
P0 |
欄位齊全;金鑰顯示為 *** |
L |
| 1E-6 |
多台 Thor 平行 |
P0 |
兩台節點同時上傳,後台合計相機數等於兩者之和且無重複 |
D、L |
2M. 2-A 影像分析監控後台
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 2M-1 |
節點註冊與心跳 API,X-Edge-Token 認證 |
P0 |
未帶 token 401;心跳寫入 node_status |
T |
| 2M-2 |
節點在線判定(60 秒無心跳離線) |
P0 |
停止節點後 60 至 75 秒內標離線 |
T |
| 2M-3 |
多節點總覽:合計相機數、吞吐、各節點狀態 |
P0 |
兩台節點資料同時顯示 |
D |
| 2M-4 |
節點詳情 24 小時曲線:CPU、GPU、GPU
記憶體、系統記憶體、儲存、溫度、功耗、分析時長 |
P0 |
任一時點 hover 讀值 |
D |
| 2M-5 |
相機面板:在線、品質、取樣率、最後取像時間、負責節點 |
P0 |
與節點 /health 一致 |
D、L |
| 2M-6 |
相機分派給節點 |
P1 |
後台改分派,節點下次同步生效 |
T |
| 2M-7 |
告警(GPU、儲存、離線、在線率) |
P1 |
觸發條件模擬後 1 分鐘內顯示;webhook 送出 |
T |
| 2M-8 |
狀態查詢 API
GET /v1/nodes、/v1/nodes/{id}/status |
P0 |
回應 <500 毫秒 |
T |
2P. 2-B
城市儀表:接收、聚合、API
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 2P-1 |
POST /v1/ingest/metric_1m 批次接收,部分拒絕回報 |
P0 |
accepted/rejected 正確 |
T |
| 2P-2 |
POST /v1/ingest/event upsert |
P0 |
同 event_id 一筆 |
T |
| 2P-3 |
POST /v1/ingest/governance
治理資訊(派工、結案、重複、誤報) |
P0 |
寫入並反映於治理績效分項 |
T |
| 2P-4 |
POST /v1/thumbs |
P0 |
回 thumb_uri |
T |
| 2P-5 |
每 5 分鐘聚合;每小時六分項與複合指數,權重可調 |
P0 |
/index 重算 |
T |
| 2P-6 |
persons <5 遮罩 |
P0 |
對外「<5」 |
T |
| 2P-7 |
WebSocket 推送 ≤ 90 秒 |
P0 |
延遲量測 |
T |
| 2P-8 |
對外唯讀端點 |
P0 |
無縮圖、無事件細節 |
T |
| 2P-9 |
稽核日誌 |
P0 |
開縮圖寫 audit |
L |
2A. 2-B 城市儀表:頁面
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 2A-1 |
首頁
KPI:健康指數+趨勢、六分項、路數(即時)與在線率;不出現影像 |
P0 |
載入 <2 秒 |
D |
| 2A-2 |
分項異常標示 |
P0 |
<70 警示色並註明 |
D |
| 2A-3 |
24 小時脈動曲線,hover 讀值,偏離帶 |
P0 |
任一時點兩值與倍數 |
D |
| 2A-4 |
29
區城市道路地圖:每支相機一點、四級顏色與半徑隨擁擠指數;切換擁擠/偏離;區名下鑽、點相機看指標、「全市」復位 |
P0 |
點數等於在線路數;下鑽 1
秒內完成並顯示該區路數、指數、偏離、事件;偏離模式顏色改依倍數 |
D、T |
| 2A-5 |
事件流(語句、縮圖、Qwen3.8 摘要、處置狀態) |
P0 |
新事件 90 秒內出現 |
D |
| 2A-6 |
熱點排行前 10 |
P0 |
三種指標 |
D |
| 2A-7 |
影像牆靜態縮圖 |
P1 |
無 video 或 MJPEG 元素 |
D |
| 2A-8 |
設備健康連到 2-A 節點資料 |
P0 |
與後台一致 |
D |
| 2A-9 |
響應式與來源標示 |
P1 |
375 px 無橫向捲動;≤1100 px 兩欄、≤640 px 單欄 |
D |
| 2A-10 |
版面依 04 儀表原型:12 欄格線與八區塊順序(指數 5、脈動 7、地圖
4、排行 4、事件 4、影像牆 8、健康 4、摘要表 12) |
P0 |
1440 px 下各區塊欄寬與順序與 04 一致(截圖比對) |
D、I |
| 2A-11 |
分區摘要表點列聚焦地圖並捲動到地圖 |
P1 |
任一列點擊後地圖縮放到該區 |
D |
| 2A-12 |
地圖底圖免金鑰且可離線降級 |
P0 |
斷網時地圖點與標籤仍可互動,底圖為純色,無錯誤訊息 |
T |
| 2A-13 |
地圖點依 geo_precision
區分樣式並於說明列註明「座標為近似」 |
P1 |
精度低於 exact 的點有不同樣式 |
I |
2B. 2-C AI 語音答詢
| 編號 |
功能 |
優先 |
驗收標準 |
方式 |
| 2B-1 |
短效金鑰後端;正式金鑰不進瀏覽器 |
P0 |
回應與日誌不含金鑰;503/502 處理 |
T |
| 2B-2 |
WebRTC 連線、oai-events、可打斷 |
P0 |
連線籤與音訊球狀態正確 |
D |
| 2B-3 |
語音辨識逐字稿與助理串流文字;文字輸入送同一會話 |
P0 |
兩種輸入皆得到回答 |
D |
| 2B-4 |
九個工具即時讀 2-A/2-B REST 並切換視圖 |
P0 |
七題腳本+節點與單路問題視圖正確率 100%;工具回傳與 REST 一致 |
D、T |
| 2B-5 |
show_nodes:各 Thor 節點資源環形量表與相機數 |
P0 |
與 2-A 心跳一致 |
D |
| 2B-6 |
show_camera:單路指標與最新去識別化縮圖 |
P1 |
縮圖已模糊 |
D、I |
| 2B-7 |
行政區正規化與錯誤處理 |
P0 |
不存在區回 error,畫面不切換 |
T |
| 2B-8 |
助理行為規範 |
P0 |
抽樣 20 則:繁中口語、≤3 句、無個人描述、數字可對應工具 |
I |
| 2B-9 |
酷炫畫面:音訊球、進場動畫、數字跳動、曲線描繪 |
P0 |
目視與截圖 |
D |
| 2B-10 |
純 HTML 腳本備援 |
P0 |
無金鑰可跑七題循環 |
D |
| 2B-11 |
回應延遲 ≤ 1.5 秒 |
P1 |
10 次平均 |
T |
| 2B-12 |
無障礙 |
P1 |
aria-live、鍵盤、狀態文字 |
I |
交付與驗收流程
| 編號 |
交付物 |
驗收 |
| G-1 |
系統架構書、產品規格書、功能與驗收文件 v3.1(md、docx、html) |
定稿 |
| G-2 |
.env.example(平台一、平台二)與部署腳本 |
依 01 第 6 節欄位齊全 |
| G-3 |
24 小時指標資料集(Parquet)、事件清單、節點監控紀錄 |
可匯出並抽查 |
| G-4 |
監控後台、儀表、語音答詢網址與純 HTML 備援檔 |
6 分鐘演示完成 |
| G-5 |
效能報告(取像 p95、吞吐、GPU)與隱私檢查報告 |
含 1A-3、1B-3、1C-2、1C-3 |
| G-6 |
資料銷毀紀錄 |
展示後 7 日內 |
| G-7 |
純 HTML POC 三頁(poc/POC_01…03.html)與
build_poc.py、README.md |
雙擊離線開啟無 console 錯誤;POC_02 版面通過
2A-10;相機點數等於內嵌清單 |
- 擷取前一週:1A、1C-1、1E-2、2M、2P 以 50 路與兩台節點試跑驗收;2B
以假事件注入驗收。
- 擷取當日:1A-3、1B-3、1D-1、1E、2M-2、2P-7 以日誌自動驗收。
- 擷取後 3 日內:1B-1 至 1B-5、1C-3、1D-4 抽樣人工驗收;2M、2A、2B
現場演示。
- 展示後 7 日內:1C-4、G-6。