# VPP／IVSD FOV Archify coverage audit

狀態：Complete for migration ticket #25  
稽核日期：2026-08-28  
基準 revision：`3b7b3471af3a349c4bc08a5d7c7eaf37c4e0f08e`

本稽核依 [`archify-migration-spec.md`](./archify-migration-spec.md) 檢查舊頁主題是否已有新圖入口、是否仍有保留價值，以及哪些敘述仍待來源確認。結論是：六張 Archify 圖已覆蓋預定的流程與證據邊界；七個既有 HTML URL 全部保留，不在本次 audit 刪除或重新導向。

## 入口與讀法

- 不知道資料來自哪裡：先看 [`system-evidence-map.html`](./archify/system-evidence-map.html)。
- 要理解 VPP 公式主幹：看 [`vpp-camera-fov-pipeline.html`](./archify/vpp-camera-fov-pipeline.html)，再用 [`vpp-fallback-exceptions.html`](./archify/vpp-fallback-exceptions.html) 查 fallback 與例外。
- 要理解 IVSD 能力或請求：先看 [`ivsd-capability-flow.html`](./archify/ivsd-capability-flow.html)，再看 [`ivsd-server-request.html`](./archify/ivsd-server-request.html)。
- 要判斷 model 清單的責任與時點：看 [`model-evidence-boundary.html`](./archify/model-evidence-boundary.html)，實際搜尋仍用既有 Model Matrix。

## 舊頁 coverage matrix

| 既有 URL | 主要主題 | 新圖覆蓋 | 處置與保留理由 |
|---|---|---|---|
| [`index.html`](./index.html) | VPP／IVSD 高階比較與文件入口 | System evidence map；VPP pipeline；IVSD capability | **保留並新增 Archify 入口。** 舊圖仍適合快速並排比較；新圖補足四方責任與證據等級。 |
| [`vpp-camera-fov-overview.html`](./vpp-camera-fov-overview.html) | VPP input → FOV → ground → DORI → shape 的簡介 | VPP pipeline | **保留。** 作為短篇文字導讀；計算責任與可探索路徑以新圖為準。 |
| [`vpp-camera-fov-detail.html`](./vpp-camera-fov-detail.html) | 參數、公式、resolved input、zoom correction、投影與特殊鏡頭 | VPP pipeline；VPP fallback and exceptions | **保留。** 仍是可搜尋的長篇公式與範例；新圖提供主路徑、fallback decision 與 evidence ledger。 |
| [`ivsd-camera-fov-detail.html`](./ivsd-camera-fov-detail.html) | CameraSimulator 校正／WASM 實驗行為與 Server 呼叫觀察 | IVSD capability；IVSD Server request | **保留。** 詳細欄位與觀察筆記不適合全塞進圖；正式契約仍以 Server 為優先。 |
| [`ivsd-camera-capability-guide.html`](./ivsd-camera-capability-guide.html) | corridor、zoom step、LDC、detection type 與能力 gate | IVSD capability | **保留。** 表格與逐項操作說明仍有使用價值；新圖負責分清 source、observed 與 unknown。 |
| [`vpp-ivsd-model-matrix.html`](./vpp-ivsd-model-matrix.html) | 可搜尋的 model coverage／integration derived index | Model evidence boundary | **保留為資料工具。** 不把 derived matrix 升格為 official support contract，也不強行改成圖。 |
| [`vpp-ivsd-2d-spec-compatibility.html`](./vpp-ivsd-2d-spec-compatibility.html) | 對接差異、native request、共同規格與待決問題 | IVSD Server request；Model evidence boundary；IVSD capability | **保留。** 它是討論與決策清單；新圖只整理已證實的 contract／責任，不取代未決議題。 |

## Archify artifact audit

每張圖均保留 JSON SSOT、standalone HTML、delivery receipt、四尺寸 visual-check sidecars、最小／最大尺寸 light/dark screenshots 與人工 visual review。

| Artifact | 類型 | Showcase | Spec SHA-256 | HTML SHA-256 |
|---|---|---:|---|---|
| [`system-evidence-map.html`](./archify/system-evidence-map.html) | architecture | 9/9 | `b803601b…e8a163` | `f2fcf739…677e89` |
| [`vpp-camera-fov-pipeline.html`](./archify/vpp-camera-fov-pipeline.html) | dataflow | 9/9 | `749a0ba5…15d071` | `b43c98fe…6dbd07` |
| [`vpp-fallback-exceptions.html`](./archify/vpp-fallback-exceptions.html) | workflow | 9/9 | `c12c3d02…224c81` | `cc59c487…8569a5` |
| [`ivsd-capability-flow.html`](./archify/ivsd-capability-flow.html) | dataflow | 9/9 | `e28d1d7d…dff38e` | `9e45c369…af59b1` |
| [`ivsd-server-request.html`](./archify/ivsd-server-request.html) | sequence | 9/9 | `17cc5b7f…18e75ad` | `c72e9e44…65e7d51` |
| [`model-evidence-boundary.html`](./archify/model-evidence-boundary.html) | architecture | 9/9 | `a1e637be…167ca5f` | `f7bb9a13…944f881` |

完整 hash 與 byte count 以各圖同名的 `*.delivery.json` 為準。六張圖的 validation 均為 0 errors、0 warnings；visual-check 均涵蓋 1440×900、1600×1000、1920×1080、2048×1320，並有人工 light/dark 檢查紀錄。

## 資訊處置結果

| 主題 | 處置 |
|---|---|
| 四方角色與證據優先序 | 已由 System evidence map 建立入口；IVSD Server native contract 優先於 CameraSimulator 實驗觀察。 |
| VPP Current 公式、resolved input、ground projection、DORI、2D shape | 已由 VPP pipeline 覆蓋，公式與 symbol 可回溯固定 Portal revision。 |
| 缺值、fixed／varifocal、zoom interpolation、thermal、fisheye、panoramic、near-vertical、未落地 | 已由 fallback workflow 分路覆蓋；不將 Portal policy 推廣成鏡頭物理定律。 |
| IVSD capability 與 request contract | 已分成 capability dataflow 與 request sequence；Server observed、experimental tool observed 與 inference 不互相覆蓋。 |
| Model coverage | 已由 Model evidence boundary 標示 snapshot／derived 性質；Model Matrix 保留為搜尋工具。 |
| 舊頁細節與歷史對照 | 全部保留；新入口不改變舊 URL。 |

## 仍待確認

- IVSD native binaries 未公開的內部公式仍不可由 wrapper 或 CameraSimulator 行為反推。
- `vca.vivotek.com`／Server model、calibration 與 capability 會隨部署更新；目前文件中的 observed snapshot 必須搭配各 evidence ledger 的時間與 revision 解讀。
- CameraSimulator local intrinsics 是歷史子集，不代表 IVSD official coverage；Model Matrix 的 integration status 也不是支援承諾。
- VPP Current 與 IVSD Server 的 golden-model parity、單位／座標共同契約及特殊機種差異，仍需以 Server native contract 與共同測試資料完成對帳。
- Archify Viewer 尚無繁體中文 locale；authored content 使用繁中，固定 viewer controls 仍是英文 fallback。

## 驗證清單

- [x] 七個既有 HTML URL 仍存在。
- [x] `index.html` 可直接進入六張 standalone HTML。
- [x] 六個舊內容頁可回到 `index.html#archify`。
- [x] 每個舊頁主題都有新圖、保留理由或待確認事項。
- [x] 未刪除或重新命名既有 HTML。
- [x] Repository Markdown／HTML 相對連結測試通過後才可合併。

## 本次驗證紀錄

- `npm test -- --runInBand tests/docs/markdownLinks.test.js --silent`：1 suite、53 tests 通過。
- `npm test -- --runInBand --silent`：55 suites、242 tests 通過。
- Browser QA：入口頁 `#archify` 唯一、6 張 cards 全數存在、無 duplicate IDs；實際由入口點開 System evidence map 成功。
- 本機 HTTP probe：`index.html` 與 `archify/system-evidence-map.html` 回應 200；其他舊頁與新圖的檔案存在性／相對連結由 53 項 link tests 覆蓋。