代碼

本頁定義 AIMO 代碼系統格式、命名慣例和生命週期管理。

代碼格式

所有 AIMO 代碼遵循格式：<PREFIX>-<TOKEN>

元件	說明	格式	範例
`<PREFIX>`	維度識別碼	2 個大寫字母	FS、UC、DT
`-`	分隔符	連字號	-
`<TOKEN>`	維度內的唯一代碼	3 位數（零填充）	001、002、003

範例

FS-001 - 功能範圍：終端使用者生產力
UC-005 - 使用案例類別：程式碼產生
DT-004 - 資料類型：個人資料
CH-003 - 通道：IDE 外掛程式
IM-002 - 整合模式：SaaS 整合
RS-001 - 風險面：資料洩漏
OB-001 - 成果/效益：效率
LG-001 - 日誌/記錄類型：請求記錄

命名空間

AIMO 分類法使用 8 個維度命名空間：

ID	名稱	前綴	代碼數量
FS	功能範圍	`FS-`	6
UC	使用案例類別	`UC-`	30
DT	資料類型	`DT-`	10
CH	通道	`CH-`	8
IM	整合模式	`IM-`	7
RS	風險面	`RS-`	8
OB	成果 / 效益	`OB-`	7
LG	日誌/記錄類型	`LG-`	15

總計：8 個維度中的 91 個代碼

命名空間規則

前綴是固定的：兩字母維度前綴（FS、UC 等）是永久的，永遠不會變更。
零填充：代碼始終是 3 位數，零填充（例如 001 而非 1）。
順序分配：新代碼在維度內分配下一個可用號碼。
不重複使用：已移除的代碼永遠不會重新分配給不同的含義。

穩定性規則

代碼穩定性是稽核可追溯性的關鍵原則。

ID 不可變性

代碼 ID 是不可變的 — 一旦分配，代碼 ID 永遠不會變更含義
像 UC-001 這樣的代碼在其整個生命週期中將始終表示「一般問答」
如果需要變更含義，則建立新代碼

不重複使用政策

已棄用或移除的代碼永遠不會重新分配給不同的含義
這確保歷史證據保持有效和可追溯
範例：如果 UC-010 被棄用，新的使用案例獲得 UC-031（而非 UC-010）

移除前先棄用

代碼必須在移除前至少標記為 deprecated 一個 MINOR 版本
移除僅在 MAJOR 版本增量時發生
請參閱生命週期章節了解詳情

使用

必要維度

對於每個 AI 系統或使用案例，您必須從每個必要維度指定至少一個代碼：

維度	選擇	備註
FS	正好 1	主要業務功能
UC	1 或更多	執行的任務類型
DT	1 或更多	資料分類
CH	1 或更多	存取通道
IM	正好 1	整合模式
RS	1 或更多	風險類別
LG	1 或更多	日誌/記錄類型

選用維度

維度	選擇	備註
OB	0 或更多	預期效益（選用）

代碼組合

記錄 AI 系統時，會組合來自多個維度的代碼。組合優先順序決定列出代碼時的順序：

FS（功能範圍）
UC（使用案例類別）
DT（資料類型）
CH（通道）
IM（整合模式）
RS（風險面）
OB（成果 / 效益）
LG（日誌/記錄類型）

範例組合：

FS: FS-001
UC: UC-001, UC-002
DT: DT-002, DT-004
CH: CH-001
IM: IM-002
RS: RS-001, RS-003
OB: OB-001
LG: LG-001, LG-002

生命週期

狀態值

狀態	說明	驗證器行為
`active`	目前有效且使用中	接受
`deprecated`	仍然有效但計劃移除	接受並顯示警告
`removed`	不再有效；請勿使用	拒絕

生命週期中繼資料欄位

字典使用這些欄位追蹤生命週期：

欄位	必要	說明	範例
`status`	是	目前狀態	`active`
`introduced_in`	是	新增代碼的版本	`0.1.0`
`deprecated_in`	否	標記為棄用的版本	`1.2.0`
`removed_in`	否	移除的版本	`2.0.0`
`replaced_by`	否	替代代碼	`UC-015`
`backward_compatible`	是	變更是否破壞現有使用	`true`

棄用規則

代碼在移除前必須至少標記為 deprecated 一個 MINOR 版本
已棄用的代碼包含 deprecated_in 版本和 replaced_by（如適用）
移除僅在 MAJOR 版本增量時發生
已棄用的代碼在棄用期間仍然有效以保持向後相容性

範例時間線：

版本	狀態	動作
0.1.0	`active`	引入代碼 `UC-010`
1.2.0	`deprecated`	標記為棄用，`replaced_by: UC-031`
2.0.0	`removed`	驗證器不再接受

版本控制

代碼變更遵循語意化版本控制：

MAJOR：代碼移除或破壞性變更
MINOR：新增代碼、代碼棄用
PATCH：僅定義澄清（無結構變更）

向後相容性

backward_compatible 欄位指示變更是否破壞現有使用：

值	含義
`true`	使用此代碼的現有證據仍然有效
`false`	現有證據可能需要更新（MAJOR 版本變更）

驗證

驗證器檢查：

所有必要維度至少有一個代碼
單選維度正好有一個代碼
所有代碼存在於目前分類字典中
代碼格式符合 <PREFIX>-<TOKEN> 模式（例如 UC-001）
已棄用的代碼標記警告

請參閱驗證器了解實作詳情。

SSOT 參照

!!! info "事實來源" 權威定義是 source_pack/03_taxonomy/taxonomy_dictionary_v0.1.csv。本頁是解釋性的。請參閱在地化指南了解更新工作流程。

代碼