先讀這裡
這一頁回答什麼?
機器介面集中提供資料格式、完整範例與受控詞彙表,讓實作者能用同一套規則交換與驗證資料。
故事關係:這篇故事正文直接使用 ISO-Taste,可用來把感官標準與實際故事情境對照。 〈柏拉圖的雞與感官暴政〉
權威入口:本標準總覽 · Sensory JSON Schema · C-772 Example
正式規格
若只想理解世界觀,到這裡已足夠;以下內容提供正式定義、欄位、治理與實作細節,可以依需要再深入閱讀。
Developer / Machine Specification
這一頁以下是給實作者使用的契約層。一般讀者只要知道:Schema 定義資料能長什麼樣子,Example 示範完整 mapped-profile,Registry 則管理可以交換的受控詞彙與代碼。
| 資源/規則 | 正式內容 |
|---|---|
| Schema | Draft 2020-12 Sensory Family JSON Schema |
| Example | C-772 mapped-profile example |
| Registry | Sensory Registry 1.0 |
| Registry 治理 | unit、time_context、descriptor_ref namespace、structural code、code lifecycle、migration records |
| Schema enforce | role-specific blocks、Reference Profile、Calibration Profile、Rights Matrix、mapping pair、三層 conformance |
Executable Validation
CI 會用固定版本的 Ajv CLI 執行驗證。正式 example 與 valid fixtures 必須通過,而故意破壞契約的 fixtures 必須被拒絕。
| 測試類型 | 預期結果 | 案例 |
|---|---|---|
| 正式 example | 接受 | C-772 mapped-profile |
| valid fixtures | 接受 | 符合 role-specific contract |
| invalid fixture | 拒絕 | 缺少 role-specific block |
| invalid fixture | 拒絕 | 非法 measurement_status |
| invalid fixture | 拒絕 | 缺少 standard_version |
| invalid fixture | 拒絕 | 空 mapping |
| invalid fixture | 拒絕 | 不完整 Rights Matrix |