AP Guideline Conformance Checklist (P0 對標)¶
本 checklist 對標三個 P0 國際 AP 範例與規格：
- Linked Art — GLAM use-case 導向敘事風格
- Singapore Framework for Dublin Core — AP 五層架構
- DCTAP — registry CSV 格式
其他（DCAT-AP / PROV-O / SKOS / OA / DQV / Profiles Vocabulary）作為背景參考、不強制對齊。
用法：作為 metadata reviewer 在收稿 / 改版時的逐項檢查表。每節給出對齊指標、目前狀態、與本對外網站對應的指向。
1. Singapore Framework 五層架構對齊¶
Singapore Framework 主張 AP 應由五層 artifacts 組成。逐項對應如下：
1.1 Functional Requirements¶
AP 應明示 functional requirements（使用者要回答什麼問題、要做什麼事）。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 1.1.1 明示 use cases / 對誰寫 / 解什麼問題 | ✅ | Home → 為誰寫 / Introduction → 為什麼需要 Prov-AI AP |
| 1.1.2 列出 competency questions（CQs） | ✅ | Conformance → CQs Coverage（18 道 CQs） |
| 1.1.3 CQs 標明 L1 vs L2 切分 | ✅ | Introduction → L1 Core / L2 Modules 分層 |
1.2 Domain Model¶
AP 應提供 domain model（class、relationship、structure）。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 1.2.1 列出核心 classes | ✅ | Model → L1 Core 結構樹 |
| 1.2.2 列出主要 properties 與其 domain/range | ✅ | Profile → L1 Object Properties |
| 1.2.3 描述 class 之間的 triple paths | ✅ | Model → 主要 Triple Paths |
| 1.2.4 提供 PROV-DM crosswalk | ✅ | Model → PROV-DM 相容性 |
1.3 Description Set Profile (DSP)¶
AP 應提供 Description Set Profile：每個 statement template 的 property、value type、cardinality、constraints。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 1.3.1 全部元素含 declared_type | ✅ | Profile（六欄含 declared_type） |
| 1.3.2 全部元素含 requirement（MUST / SHOULD / OPTIONAL / conditional） | ✅ | Profile |
| 1.3.3 全部元素含 domain → range | ✅ | Profile → L1 Object Properties |
| 1.3.4 控制詞彙以 SKOS ConceptScheme 治理 | ✅ | Concept Schemes（5 個必用） |
| 1.3.5 提供 DCTAP CSV | ⏳ v0.2 | (待補) |
1.4 Usage Guidelines¶
AP 應提供 usage guidelines：如何把實際 metadata 對應到 AP 結構。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 1.4.1 提供 IRI / Identifier 規約 | ✅ | Usage → IRI / Identifier 規約 |
| 1.4.2 提供 prefix 與 namespace 宣告 | ✅ | Usage → Prefix 與命名空間 |
| 1.4.3 多條取值路徑（如本 AP 的 Share / API 雙路徑）說明 | ✅ | Usage → 兩條取值路徑 |
| 1.4.4 case mapping 6 步驟示範 | ✅ | Usage → 案例 mapping 流程 |
1.5 Encoding Syntax Guidelines¶
AP 應提供 encoding syntax guidelines：實際 RDF 序列化的範例。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 1.5.1 提供 Turtle 範例 | 🟡 | Examples → C02 Motifs（v0.1.1 第一個 worked example） |
| 1.5.2 提供 JSON-LD 範例 | ⏳ v0.3 | (待補) |
| 1.5.3 至少有兩條取值路徑（Chat UI + API）的範例 | ⏳ v0.3 | (Chat UI 為 C02；API 待補) |
2. DCTAP 格式對齊¶
DCTAP 提供表格化 statement templates（CSV）。
| 對齊指標 | 狀態 | 預定版本 |
|---|---|---|
2.1 shapeID 欄位齊備 |
⏳ | v0.2 |
2.2 propertyID 欄位齊備 |
⏳ | v0.2 |
2.3 valueNodeType / valueDataType 標註 |
⏳ | v0.2 |
2.4 mandatory / repeatable 旗標 |
⏳ | v0.2 |
2.5 valueShape 連動 SHACL |
⏳ | v0.3（隨 SHACL shapes 一起做） |
| 2.6 CSV 可被 DCTAP 工具鏈 直接讀取 | ⏳ | v0.2 |
DCTAP CSV 將於 v0.2 從工作層 02_schema/element_registry.csv + AP_SCHEMA.md 重整為標準格式。
3. Linked Art 敘事風格借鏡¶
Linked Art 的 AP 文件特色是以 GLAM use-case 開頭、worked example 為核心、內含 "how to read this AP" 入門段。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 3.1 GLAM use-case 導向開頭（不是規格表開頭） | ✅ | Home（landing page 開頭為 use case） |
| 3.2 "How to read this AP" 入門段 | ✅ | Introduction |
| 3.3 Worked Example 章節 | ✅ | Examples → C02 Motifs（M1 第一個；L13/L08 v0.2） |
| 3.4 Crosswalk 表（PROV-DM ↔ Prov-AI） | ✅ | Model → PROV-DM 相容性 |
| 3.5 提供「為誰寫」分類（GLAM / 研究者 / metadata 社群） | ✅ | Home → 為誰寫 |
| 3.6 對齊既有 vocabulary 表（DataCite / MARC / CRediT / schema.org / FOAF） | ✅ | Model → 設計四原則 |
4. PROV-DM 相容性自檢（背景參考）¶
本節不是 P0 強制對標，而是確保 PROV-DM 推理能在 Prov-AI 元素上運作。
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
4.1 prov:Entity / prov:Activity / prov:Agent 三元映射 |
✅ | Model → PROV-DM 相容性 |
4.2 prov:wasGeneratedBy / prov:used / prov:wasAssociatedWith 保留 |
✅ | Model → 主要 Triple Paths |
4.3 自定義屬性 rdfs:subPropertyOf 對應 PROV-O 屬性 |
🟡 | (Prov-AI 自定屬性已標 subPropertyOf；SHACL 驗證待 v0.3) |
| 4.4 Time / Agent / Role 三段式對齊 PROV-O entity-vs-activity 語意 | ✅ | Model → Time / Agent / Role 三段式 |
| 4.5 Activity 邊界事件與 Entity 生成時點分離 | ✅ | Model → Time（凍結為 RDF parser contract） |
5. 治理元件¶
| 對齊指標 | 狀態 | 指向 |
|---|---|---|
| 5.1 VERSION 檔 | ✅ | VERSION |
| 5.2 CHANGELOG | ✅ | Changelog |
| 5.3 Release Notes | ✅ | Release Notes v0.1.1 |
| 5.4 Namespace 與 versionIRI 策略 | ⏳ v0.2 | (M1 例子用 urn:prov-ai: 暫時前綴) |
| 5.5 Licence 宣告 | ⏳ v0.1.1 拍板 | (候選：CC-BY 4.0 / CC0) |
| 5.6 Conformance classes 定義 | ✅ | Conformance |
| 5.7 與 living registry 雙軌維護的 source-of-truth 規則 | ✅ | Home → 與工作層的關係（本對外網站為手工 curated；工作層為 canonical source） |
完整度摘要（v0.1.1）¶
| 對標範圍 | 完整度 | 備註 |
|---|---|---|
| Singapore Framework Functional Requirements | 100% (3/3) | 全部齊備 |
| Singapore Framework Domain Model | 100% (4/4) | 全部齊備 |
| Singapore Framework DSP | 80% (4/5) | DCTAP CSV 延後 v0.2 |
| Singapore Framework Usage Guidelines | 100% (4/4) | 全部齊備 |
| Singapore Framework Encoding Syntax | 33% (1/3) | JSON-LD 與 API path 範例延後 v0.3 |
| DCTAP | 0% (0/6) | 全部延後 v0.2/v0.3 |
| Linked Art 敘事風格 | 100% (6/6) | 全部齊備（L13/L08 worked example 延後 v0.2） |
| PROV-DM 相容性 | 80% (4/5) | SHACL 驗證 subPropertyOf 延後 v0.3 |
| 治理元件 | 71% (5/7) | License / Namespace 待拍板 |
| 總計 | 70% | v0.1.1 為 "skeleton + 第一 pilot" 階段，符合預期 |
接下來¶
- v0.2 補齊 DCTAP CSV、namespace policy 拍板、L13 example
- v0.3 補齊 SHACL shapes、JSON-LD 範例、API path example
- 持續維護與 Linked Art / Singapore Framework / DCTAP 的對齊
完整 roadmap 見 Changelog。