Spec Codes — 全域編碼 registry
跨 vault/repo 的「對外」項目識別碼之單一真相。配發 SPEC_SHORT_NAME、防撞號。 權威格式定義見 product-module-development-workflow.md §可追溯性 →「全域編碼」。
格式
§{SPEC_SHORT_NAME}-{TYPE}-{NUMBER}
- SPEC_SHORT_NAME — 每個 spec／feature 一個短名（下表配發）。
- TYPE — 階段別（下表）。
- NUMBER — 限
[0-9.]+：沿用本地號的數字部分，去掉字母前綴、保留小數階層、不零填補。B6→6、q3→3、§7.3.6→7.3.6。
範例：§RCS-FS-6、§RCS-PC-7.3.6、§DM-OA-1、§CAP-UR-3。
TYPE 對照
| TYPE | 階段 | 哪些「對外」項目要編碼 |
|---|---|---|
UR | User Requirement | 需求收斂結論（每條「已定向」結論） |
FS | Functional Spec | 邊界條件 / 異常情境 |
OA | OOA | 對外契約面：Domain Service / Calculator / Strategy 介面 / Domain Exception 等公開型別 |
PC | Pseudo Code | 公開方法契約 = §-section（code 在 Javadoc 引用的行為單位），保留完整小數階層 |
RC | Real Code | 對外公開類別 / 方法（Stage 5，落在 code repo） |
只有「對外」項目編碼。純內部導航的
§N.M子節點維持本地號、不加全域碼（兩層並存）。
SPEC_SHORT_NAME 對應表
| SHORT | 中文 | spec / feature 目錄 | 範圍 | 狀態 |
|---|---|---|---|---|
RCS | 粗排 | rough-cut-scheduler | 單一 feature | active |
DM | 領域物件 | domain-model | 跨 feature 共用（Published Language） | active |
CAP | 產能模組 | capacity-module | 單一 feature | active |
FGS | 細排 | fine-grain-schedule | 單一 feature | active |
RS | 資源篩選 | resource-selection | 跨 feature 共用（Published Language） | active |
配發紀律
- 短名 append-only、永不重用；改名 = 廢一個短名 + 配一個新短名，舊號保 tombstone。
- 新 feature 開工前，先在本表登記短名，再開始落碼。
- NUMBER 對
(SHORT, TYPE)唯一；永不重編、永不重用；廢棄項目保留號碼 +~~刪除線~~+ 廢棄原因（tombstone）。 - 沿用本地號 ⇒ 全域碼是本地號的「跨界書寫形式」，屬 rename 非 renumber，不違反「§編號永久」不變量。