All Classes and Interfaces
Class
Description
HTTP 訊息解析器的抽象基類
OAuth2 存取令牌（Access Token）的資料模型
Request-level 代行稽核 capability（ADR-013 稽核章節）。
代理／模擬的 JWT claim wire 契約（見 ADR-013）。
當前請求的代理／模擬脈絡（見 ADR-013）。
台灣地址（縣市 / 鄉鎮市區 / 村里）服務
水平對齊
儲存格水平對齊方式
段落水平對齊方式
almanac 服務入口
Almanac 建構器almanac 服務的低階 HTTP 客戶端
Almanac 認證策略
存取 almanac 服務時發生的錯誤
RSQL AND 邏輯節點
API key 認證 filter（ADR-025 決策五）
以 API Key 認證 almanac
API key 的雜湊（ADR-025 決策五）
API key 的主體查找 SPI（ADR-025 決策五）
以 ServiceLoader 向 Hibernate 註冊框架提供的基本型別映射。
應用程式異常基類
AppFuse 自定義異常映射器
有界、可遺失的事件入口。呼叫者只做快照與 tryLock admission，不執行 I/O 或 logger。
關閉與 batch-start 共用短 gate；已標記 in-flight 的 batch 可以完成。
單一帳號的登入失敗記錄（不可變，供
LoginLockout 存入快取）一次持久化 changeset 的身份與關聯脈絡。
可接收
AuditChangeContext 的應用端 revision／changeset metadata entity。提供目前持久化 changeset 的身份脈絡。
與目標 DataSource／pool 相符的連線處置接點。
正常返回必須表示 lease 已從 pool 淘汰，不能以普通 close 歸還；無法確認時必須拋錯。
實例級稽核開關。FAILED、STOPPING、CLOSED 無法透過 enable 復原。
稽核事件表 Repository 基底。
search 對映 Actuator AuditEventRepository.find
（principal / after / type 三參數皆可為 null，null 即不篩該條件）。稽核事件持久列的欄位基類——Spring Boot Actuator
AuditEvent 的通用持久落點（框架 opt-in 服務）。入列前固定的純值快照；不保留可變 payload、Entity 或執行緒 context。
應用擁有的表／欄位映射。只接受簡單 SQL identifier；事件值永遠以參數綁定。
Entity 歷程變更的主體種類。
Entity 歷程變更的執行來源。
安全維運狀態；不含事件、SQL、連線資訊或原始例外。
應用選用的儲存 adapter；writeBatch 只由非同步工作者呼叫，不得歸還不安全連線。
只攜帶固定分類，不保留 SQL、原始 throwable 或事件資料。
非同步稽核的有界資源設定；不修改應用擁有的連線池。
資源伺服器的認證模式（雙模式，二擇一）
Authority 名稱的貢獻點
登入引擎對「可登入主體」的最小契約（ADR-023）
已驗證 AuthPrincipal 的 Authentication adapter。
登入引擎的主體查找 SPI（ADR-023）
資源伺服器認證設定
Azure Blob Storage 檔案儲存實作
Azure Blob Storage 例外
AzureBlobFileStorage 的建構器
Azure Blob 的
FileJournal 實作Azure Blob 暫存區清理任務
AzureStagingCleanupTask 的建構器
錯誤請求異常（HTTP 400）
在範本渲染後於內文前置橫幅的
NotificationTemplateResolver decorator並排長條圖：同一類別內的系列並排，負值往下長
BarChart 的 builderBaseUrl 替換工具
Basic Auth 認證 Filter
SMTP 固定密碼認證器
BigDecimal 類型轉換器
BigInteger 類型轉換器
區塊節點
內容容器（共用編輯面）
Boolean 類型轉換器
儲存格框線樣式
頁面上定位完成的繪製單位；座標以 pt 為單位、原點在頁面左上
儲存格任意方向框線，原點在頁面左上。
Figure 的向量內容；繪製時以框裁切
點陣圖片
矩形；
fill、stroke 皆可為 null水平線
一段文字；
baseline 為基線的 y區塊框樣式覆寫值；每個欄位為
null 時繼承 DocumentStyles.box()營業行事曆——日期可選性的單一事實來源（ADR-012）
具名
BusinessCalendar 的查找與安全範圍解算 capability。Byte 類型轉換器
byte[] 類型轉換器
byte[] JSON 反序列化器
快取介面
Cache 建構器
Ehcache 快取建構器
以具 TTI/TTL 的整數 Cache 實作 M2M token 端點限流。
快取配置
快取管理器介面
CacheManager 建構器
Ehcache CacheManager 建構器
快取監控器
同一連線 IP＋trim/lowercase(ROOT) username 的滾動視窗限流。
cache 值是有界的不可變接受時間快照，不含 IP、username 或憑證。
Ehcache 快取效能分析器
快取儲存實作
快取統計資訊
快取狀態資訊
容量使用資訊
健康狀態枚舉
快取儲存實作
必要的 cache state store 無法服務。
行政機關辦公日曆中的一天
BusinessCalendar 的組合工廠（ADR-012）BusinessCalendar 建構器行政機關辦公日曆相關服務
圖像畫布類別，提供繪圖操作的封裝。
表格儲存格
儲存格
儲存格四邊框線覆寫；null 繼承上一層，零線寬明確不畫。
線條位於儲存格外緣，不增加內距或列高；跨欄只畫合併後的外緣。
每個跨頁實體片段重複指定的四邊，相鄰邊各自繪製。一般格依列由上到下、格由左到右；
跨列格於整筆其他列之後，依起始列及欄位順序繪製。
不提供 CSS border-collapse；共用邊需一致外觀時指定相同樣式或僅保留其中一邊。
儲存格樣式
通知遞送通道型別
字元轉換器，將各種類型的值轉換為
Character。長條圖與折線圖共用的 builder
一組資料序列；數值與類別一一對應
圖表規格；以
ChartSpec.toFigure(FigureFrame) 轉成 Figure中文數字翻譯器，將阿拉伯數字轉換為中文數字。
縣市
M2M 憑證產生器（ADR-025）
token 端點的速率限制接點（ADR-025 決策四）
client_credentials 的請求參數（RFC 6749 §4.4.2）
M2M 憑證發放 capability——登入引擎的第四操作（ADR-025）
發放結果（引擎級——wire 回應由
ClientCredentialsTokenResponse.bearer(String, long) 組裝）client_credentials 的成功回應（RFC 6749 §4.4.3）
客戶端錯誤異常（HTTP 4xx）
表格欄定義
RSQL 比較節點，表示一個欄位與預期值之間的比較條件。
RSQL 比較運算子列舉。
組合多個 TenantIdResolver 的複合解析器
系統組態的安全診斷能力。
設定屬性值的遮蔽規則——「什麼算敏感」的單一事實來源。
衝突例外，表示操作因資源狀態衝突而無法完成。
約束違規例外，表示輸入資料未通過驗證約束。
內容類型檢測器，用於自動偵測檔案的 MIME 類型。
內容處理例外
已認證的持久化憑證攜帶其發行環境；入口 gate 在認證之後驗證，不取代 principal 的授權。
轉換例外
Converts a value from any type to the target type T.
型別轉換器註冊表
國家（ISO 3166-1）
JPA Criteria 查詢建構器
CSV 讀取器
CSV 讀取器建構器
CSV 讀取器配置類別
CSV 資料記錄
CSV 寫入器
CSV 寫入器建構器
CSV 寫入器配置類別
DAO 帳密認證鏈的 builder。
Spring Data 異常映射器
常用儲存格資料格式
日期轉換器，將各種類型的值轉換為
Date。日期不可選異常
營業行事曆中一天的可選性狀態
DB-backed 通知偏好過濾（Phase 2 預設,opt-out 模型）
DB 範本解析器（Phase 2）：查一張範本表，指定語系 → 不分語系（wildcard）兩層，查無委派 fallback
自帶對外代碼的列舉。
AuthPrincipal 的預設實作——UserDetailsService 把自家帳號攤平成引擎主體的便利類DefaultAuthPrincipal 的建構器單則通道遞送的結果
翻譯字典
綁定單一 JavaMailSender 的具體 Mailer
政策於建構時套用
外寄安全政策（防火牆／白名單／debug／改寄／特殊訊息）是建構參數——
不給 MailOutboundPolicy 就建不出來，「所有 Mailer 走同一段政策碼」由建構子擔保，
不依賴呼叫端記得套用。政策內容見 MailOutboundPolicy。
郵件發送器資訊
郵件發送測試結果
Hard-disabled 的 No-Op CacheManager。
Word 文件（
.docx）Word 文件處理例外
文件層級的完整樣式，是所有覆寫值的合併基底
以覆寫值修改
DocumentStyles 的建構器；各方法只覆寫非 null 欄位雙精度浮點數轉換器，將各種類型的值轉換為
Double。將已知下游錯誤契約轉譯為應用程式安全例外的擴充點。
下游 HTTP 回應失敗的診斷脈絡。
雙層快取建構器
雙層快取
重複值例外
持久快取（Ehcache 實作）
持久快取建構器（Ehcache 實作）
Duration JSON 反序列化器
Duration JSON 序列化器
Ehcache 快取適配器
Ehcache 快取管理器
Ehcache 配置映射器
EMAIL 通道交給應用層寄送的單封郵件信封。
EMAIL 通道的框架預設實作
表示空的搜尋節點，用於處理空查詢或作為預設節點。
JPA Entity 欄位型別規範中可機械判定的單一政策實作。
enum 常數的 wire 值（純量形式）
把中立的
AuditChangeContext 寫入應用端 Envers revision entity。環境配置工具類，提供應用程式環境屬性的存取與管理功能。
目錄建立失敗時拋出的例外。
在已渲染主旨前置部署環境前綴（env marker）的
NotificationTemplateResolver decorator決定完整錯誤診斷如何投影成 HTTP response 的最後一道政策接點。
異常映射策略接口
異常映射器註冊中心
異常回應映射器
標示實驗性公開 API
過期配置
過期策略類型
有界的局部座標圖形，例如統計圖表
Figure 的內容；在自身的局部座標系中描述圖形點陣圖（
image/png、image/jpeg），在 Figure 的框內等比置中；供外部圖表函式庫的輸出使用
受限 SVG
圖表產生的 Figure 的識別、尺寸、替代文字與圖說
Figure 的繪圖清單；座標為 Figure 空間（pt，原點在 Figure 左上、y 向下），文字已量測
路徑；
fill／stroke 為 null 表示不填或不畫線一段文字；
x、baseline 為使用者座標；fill／stroke 為 null 表示不填或不描邊檔案描述符（值物件）
檔案 ID 生成器
檔案交易日誌 SPI（append-only，best-effort）
孤兒檔案對帳 sweep（後端無關）
模糊項紀錄（策略 A 報告用）
Sweep 結果摘要
檔案參照解析 SPI（選用，升級 sweep 為策略 B）
檔案下載 Response 建構器
統一檔案儲存介面
檔案 Metadata
暫存上傳資訊
檔案儲存例外基類
檔案過大例外
查詢篩選器，用於建構結構化的查詢條件。
RSQL 查詢字串解析器，將 RSQL 語法轉換為
Filter 物件。固定版面文件；幾何為 mm（左上原點，x 向右、y 向下），文字、字距、線寬與虛線長度為 pt。
頁面、明細容量及續頁由模板明確建立，不自動流動或分頁；元素依清單順序繪製。
黑白向量條碼。moduleMm 不縮放；一維碼 heightMm 為條高，QR 高度由模組數決定。
quietModules 為每側靜區，QR 至少 4、一維碼至少 10。payload 的業務檢查碼由應用提供。
不自動加入人眼可讀文字，需另建 Text。
橢圓外接框，可用於蓋章區；填色可省略。
固定文字框／圖像框；座標為外框左上角。
PNG／JPEG 於框中等比置中，不拉伸；位元組防禦複製。
STATIC 為框線／底圖等預印內容；VARIABLE 為每份資料。套印只輸出 VARIABLE。
建立者判定的幾何問題，例如區塊重疊；不可用此接點表示權限、資料或版本錯誤。
自訂 code 應使用應用自己的穩定命名空間。嚴格政策拒絕，警示政策完整繪製。
任意方向線段，可用於撕線、點線或虛線分隔。
dashPatternPt 為交替的線段與空白長度（pt，與線寬同單位）；空清單為實線，奇數個元素由 PDF 重複兩次形成週期。
dashPhasePt 為週期起點偏移，實線必須為 0。整條線以單一路徑繪製，不需拆段。
固定頁；同頁 ID 不得重複。嚴格政策要求框線筆畫也位於紙張內。
PDF 頁面外觀底稿，固定為 STATIC 層。頁碼從 1 起，不匯入註解、AcroForm 或動作。
來源頁面須無旋轉、CropBox 原點為 0、UserUnit 為 1，尺寸與目標頁相同；不自動縮放。
fillRgb 為 null 表示不填色；線寬必須大於 0。
CRLF／CR 正規化為 LF，Tab 展開成四個空格（非 tab stop）；其他控制字元拒絕。
lineHeightPt 為基線間距；使用整個文字框所用字型的最大 ascent／descent 檢查上下界，不以裁切掩蓋超框。
letterSpacingPt 為同一行相鄰 code point 之間額外加的距離（非負，預設 0）；行尾不加，
對齊、換行與超框檢查都以含字距的寬度計算。不做字距微調（kerning）。
超框依 LayoutPolicy 回報警示或拒絕；不靜默縮字或截斷。
固定版面無法依契約輸出；建構期 location 為元件 ID，render 期為頁碼／元件。
code／location 供持有例外的呼叫端診斷，不包含業務資料值。
ReportStatus.Failed 對外只保留通用 report.invalid，不傳送內部定位資訊。
公開量測器的實作；與 FixedRenderer 共用 PdfTextMeasurer 與 FixedTextMetrics。
固定版面 PDF 公開入口，與流式 ReportDocument／ReportArtifact 無關。
共用已驗證的字型登錄與 PDFBox runtime；renderer 可跨執行緒重用。
只處理幾何排版異常；字型、資產、容量與生成錯誤仍拒絕。
預設 OUTPUT_WITH_WARNINGS；只有明確選用 STRICT 才拒絕幾何異常。
平移校準以 mm，作用於全部輸出元素；不更改紙張尺寸。overlayOnly 略過 STATIC 層。
與流式排版分離；只共用 PDF runtime、字型量測及圖片嵌入。
以與
FixedPdfRenderer 相同的字型登錄、fallback 鏈與字距規則量測單行文字，
供應用在建立 FixedDocument 前自行計算座標（例如逐字定位、置中或拉伸標籤）。
同一份 ReportFonts 下，量得的寬度等於 renderer 對齊與超框檢查使用的寬度。固定寬度文本讀取器
固定寬度讀取器建構器
固定寬度文本讀取器設定
固定寬度文本寫入器
固定寬度寫入器建構器
固定寬度文本寫入器設定
對齊方式
將各種類型轉換為 Float 的轉換器。
字體建構器，提供流暢的 API 來建立和配置字體。
標準字體家族枚舉。
ReportFonts.Builder#build() 的字型檢查字型檔的來源；登錄時只記錄來源，render 時才讀取
由應用提供位元組；每次讀取都呼叫 supplier
classpath 上的字型資源
檔案系統上的字型檔
字重
禁止存取異常（HTTP 403）
Gateway 轉發器
把已排序的領域資料串流轉成帶群組角色的
TableRow 串流彙總結果的 handle；只能用於建立它的
GroupedRows結束中的群組
一個群組或總計的彙總結果
標題；預設與後續內容保持同頁
HTTP 客戶端建構器
HTTP 連線管理器建構器。
HTTP 客戶端異常基礎類別
HTTP 客戶端攔截器介面
HTTP 異常映射器
HTTP 日誌處理器介面
HTTP 訊息轉換異常映射器
HTTP 請求日誌模型
HTTP 請求解析器
HTTP 回應日誌模型
HTTP 回應解析器
Internationalization (I18n) utility class for handling translations and
locale-specific formatting.
內嵌圖片
點陣圖片；與圖說保持同頁
不可變的點陣圖資料
圖片尺寸；排版引擎只透過此介面取得圖片資訊
圖片格式不支援或無法解碼
圖片處理器
圖片讀取工具
圖片下載 Response 建構器（支援伺服端縮圖 + 條件式下載）
圖片縮放工具類
圖片寫入工具
站內信通知的欄位 / 行為基類（Phase 3 IN_APP 通道的遞送載體）
IN_APP 通道（Phase 3）:遞送即寫一列站內信
站內信資料存取基底（讀取面供 app REST API 使用）
行內節點
HTML 子集的行內格式狀態
攔截器上下文
內部伺服器錯誤異常（HTTP 500）
儲存識別碼不合法例外
應用提供資料表映射與連線池；寫入直接擁有 lease，永不加入呼叫者交易。
不安全的 lease 必須先移出池；無法確認時保留隔離，禁止一般 close。
檔案交易日誌的單筆事件（不可變值物件）
檔案交易日誌的單行 TSV 編解碼
檔案交易日誌的操作類型
檔案交易事件的狀態
認證入口點，回傳 RFC 7807 格式的 JSON 錯誤回應
從 OAuth2 JWT 的 claims 中解析租戶 ID
盡量不跨頁的區塊；高於整頁時 renderer 回報 WARNING 後照常跨頁
排版、字型、圖片與資源的 diagnostic 代碼（REP-03 契約）
一次 render 的 diagnostic 收集器
排版引擎：把 ReportDocument 排成逐頁的定位 box，交給 PageSink
只依賴 TextMeasurer 與 ImageInspector，不依賴 PDF 實作。規則見 REP-03 契約設計：
孤行寡行的四個步驟、keepWithNext、KeepTogether、表格（TablePlacer）、圖形（GraphicLayout）、
頁首頁尾（RegionLayout），以及「自動換頁後同一內容仍放不下即停止」的前進保證。
線性退避重試策略
強制換行
折線圖：每個系列一條折線與資料點，
null 使線段中斷LineChart 的 builderLINE 推播遞送 SPI（LINE 通道的應用層接縫）
LINE 通道（Phase 3）:委派應用層
LineDelivery 推播框線或分隔線；線型不占排版空間。
簽章連結的贖回政策
將各種類型轉換為 LocalDate 的轉換器
本地檔案系統的
FileJournal 實作（自訂 TSV 格式，append-only）本地檔案儲存實作
LocalFileStorage 的 staging 清理任務。
LocalStagingCleanupTask 建構器。
清理結果。
國家 / 行政區劃代碼服務
帳號鎖定異常
登入鎖定異常映射器
日誌攔截器
日誌攔截器建構器
登入時的代行（acting）貢獻點
代行登入的結果。身份仍是登入者本人（
sub 不變），只是多了授權人的權限。登入保護專用的 cache 邊界；不得包住密碼、帳號政策或 SQL 操作。
登入失敗鎖定
source 只由引擎在驗證 opaque Refresh Credential 後填入，不能由 wire model 提供。
登入政策拒絕的具體診斷通道（ADR-023 修訂）
登入引擎 capability（ADR-023）
登入結果（引擎級——wire DTO 由消費端殼自 principal／acting 組裝）
Refresh 成功後的引擎結果；replacement credential 由 HTTP 殼寫入 Cookie，不放入 wire body。
讓 HTTP 層的 enum wire 值一律小寫
郵件因防火牆政策被全部封鎖時拋出
郵件遞送 SPI(EMAIL 通道的應用層接縫)
郵件服務的消費端介面
連接測試結果
建立一個
DirectMailer 所需的最小資料OAuth2 認證（client_credentials）
SMTP 連線
傳輸／認證方式
MailerSpec 的來源（消費端的接點）外寄郵件的安全政策——環境層、對所有 Mailer 一律生效
政策建構器；
MailOutboundPolicy.Builder.build() 驗證組合並回傳不可變政策無可用的郵件服務——
RoutingMailer 解析不到任何郵件設定（provider 給不出 spec、
亦無系統預設 Mailer）時，於寄信／組信當下拋出。可管理的快取
頁面邊界
框架預設的最大揭露政策。
媒體類型解析工具
CacheManager 層已解析的記憶體預算
記憶體預算解析器
只輸出呼叫端採取行動所需之穩定錯誤投影的應用政策範例。
Vite／Host 共用的 Mock Access Session 護欄；不是產品營運政策。
Native HTTP adapter for process-scoped MSW authentication sessions.
HTTP 查詢參數工具類
預設範本解析器:Spring
MessageSource 訊息束 + ${...} 具名插值不做任何事的 FileJournal
用於兩種情境：
- 交易對齊的後端（Database）：本身隨交易 rollback 復原，不會產生孤兒，無需日誌。
- 關閉日誌：在
TransactionAwareFileStorage上只要交易補償／延後刪除、不要稽核軌跡時。
不可接受異常（HTTP 406）
方法不允許異常（HTTP 405）
未授權異常（HTTP 401）
資源不存在異常（HTTP 404）
通知內文橫幅 SPI（標記 / 裝飾通知內文）
遞送通道 SPI
深連結提供者 SPI(選用;每收件人產生深連結)
遞送嘗試回呼 hook（選用;Phase 2 稽核）
逐次遞送嘗試稽核 log 的欄位基類（Phase 2;由
PersistentNotificationDeliveryListener 寫入）遞送稽核 log 資料存取基底
通知事件(事件驅動的接縫)
NotificationEvent → NotificationService 的交易後接縫通知遞送 Outbox 列的欄位基類（每收件人 × 每通道一列）
Outbox 遞送器:fast-path 非同步遞送 + 輪詢重試/補送
通知 Outbox 的資料存取基底
使用者通知偏好的欄位基類（Phase 2 opt-out）
通知偏好過濾 SPI（選用;Phase 2 opt-out）
通知偏好資料存取基底
一則通知請求(描述「發生了什麼」,不描述「怎麼遞送」)
通知子系統的門面
可客製通知範本的欄位基類（per-locale 覆寫某通知型別×通道的主旨 / 內文）
通知範本資料存取基底
範本解析 SPI(渲染通知內容)
OAuth 2 認證服務
負責處理 OAuth 2 Client Credentials Flow 的核心邏輯
OAuth 2 配置
Token 資訊
OAuth 2 郵件認證器 - 專注於 JavaMail 認證橋接
使用 OAuth2Authenticator 進行實際的 OAuth 2 認證邏輯
token 端點的錯誤（RFC 6749 §5.2）
ObjectCopier
ObjectsCopier
記憶體預算超額時的處置策略
樂觀鎖衝突映射器
頁面方向
交付給通道遞送的單則訊息
Outbox 列的遞送狀態
Outbox 列的唯讀視圖（SPI 契約）
硬性換頁
總頁數；只能用在固定頁首頁尾或文件的每頁摘要，完成排版後由 renderer 回填
目前頁碼；只能用在固定頁首頁尾或文件的每頁摘要
頁首或頁尾；左、中、右三格，v1 全部頁面共用同一組
頁首頁尾建構器
頁面尺寸與邊界
接收排版完成的頁面；PDF 實作繪製後即可釋放 box
每頁內容末端的左右摘要；可以使用頁碼及總頁數，不改變固定
PageRegion 頁尾。
位於頂層 pageBreakBefore=true Section 的頁面另可使用
SectionPageNumber／SectionPageCount，
解析為該分節的頁碼與排版完成後的實際總頁數。
左右內容不自動換行，超寬時失敗而非截斷；同字級單行內容使用相同基線。
左右內距只縮排文字，摘要上線仍畫滿內容區寬度。
最後頁採 lastPage，其他頁採 everyPage；分節最後頁可逐側優先採 PageSummaryOverride。
無摘要文字時仍保留設定的線及空間。摘要建構器；最後頁未覆寫的側沿用一般頁內容
分節最後內容頁的摘要覆寫；各側獨立繼承文件摘要。
分節摘要建構器；未設定的側繼承，空參數明確清空。
段落
段落；可跨頁
段落樣式覆寫值
密碼登入請求配額；成功與失敗的認證請求都計數，與 LoginLockout 的失敗鎖定分開。
resetAt 是下一個名額可用時間；retryAfterSeconds 是向上取整的等待秒數。
degraded=true 時配額未知（remaining=-1、resetAt=null），仍需執行所有認證與 SQL 檢查。
使用者座標中的路徑，只含移動、直線、三次貝茲與封閉；其他 SVG 指令在解析時轉換
diagnostic 的節點路徑，例如
body/2[table:orders]/row/1523；驗證器與 renderer 共用同一格式與 authoring model 無關的完成 PDF；呼叫端擁有並負責 close。
關閉後不可再開串流；已開串流可讀完，最後一個串流關閉時刪除暫存檔。
close 可重複呼叫，清理失敗只記 WARN，不取代產生或保存結果。
固定 PDF 的幾何排版診斷；頁碼為原始 PDF 的實體頁碼（從 1 起）。
識別與訊息由建立者提供，對外傳送前應用須確認不含私密資料。
PDFBox 實作的 ReportRenderer
兩階段輸出（REP-03 契約「輸出語意」）：產生階段排版、繪製並把完整 PDF 序列化到暫存檔；最後一次取消檢查通過後，
寫出階段才把暫存檔複製到 out。產生階段的任何失敗或取消都不寫出任何位元組。
PDF renderer 的建立入口
從已保存的 PDF 擷取選取的頁面（REP-08）
從已保存的 PDF 擷取選取的頁面（REP-08）
選用的 PDFBox 相依：確認存在後才載入
internal.pdf 的類別應用持久化資料的 purpose-scoped 可逆加密能力。
Actuator
AuditEventRepository 的持久實作：把稽核事件寫入應用宣告的稽核表，取代消費端
可選的 in-memory ring buffer（易失）。領域無關的框架 opt-in 服務（見 ADR-013「界線修訂 R1」）。
本類保留原同步 JPA 契約；新版 audit feature 改用 AsyncAuditEventRepository 與 storage provider，
不會以本類作非同步寫入失敗時的 fallback。DB-backed 遞送稽核 listener（Phase 2 預設）:每次嘗試寫一列遞送稽核 log
代表具有物理單位的矩形區域
圖片或文字的定位位置
主體目錄 SPI（ADR-024 決策三）
主體目錄視圖（唯讀）——feature 對「他人」的全部合法認知
（ADR-024 決策三）
受保護資源授權不足（403）處理器
受保護資源認證失敗（401）入口點
RFC 7807/9457 ProblemDetail 工廠類別
維運受控入口。scopeId 為消費端的 opaque 識別，null 表示平台；不賦予 scope 權限。
應用即時裁決具名 scope 是否可提供入口；不假定租戶 entity 或 repository。
協定／credential 保存的不可變入口快照；消費時仍須核對 current entry 與身分。
HTTP protocol 的已驗證入口接點；沒有 bean 或停用時維持單一入口行為。
實作只能讀取受信任 ingress 所綁定的 request attribute，不得據此授權或建立租戶 context。
不可變入口目錄；origin 唯一，path 不作識別。沒有 DB、Entity 或自動組態。
只保存 request attribute，不使用 ThreadLocal、不解析 Host、不改認證 scope。
canonical HTTP(S) origin；與 public path 分離，不提供認證或代理信任判斷。
已驗證的 Server 對外基底；不依 Servlet context、request 或應用設定推算。
應用已確認可信的 scope，非原始 Host 或其他未驗證的 request header。
無 scope（含登入前或固定部署的背景工作）明示使用 unspecified()。
依顯式可信業務脈絡選擇對外位址；實作由應用組裝，不負責認證／授權。
FileStorage 能否只讀取物件的一個區段HTTP Range 請求處理工具
位元組範圍
Range header 的評估結果
沒有 Range，或語法不合法、多個 range：回完整內容
可滿足的單一 range：回 206
語法合法但落在檔案範圍外：回 416
DayStatus.reasonCode() 的框架常用代碼通知收件人
收件人解析 SPI(業務語意注入點)
資料記錄介面
Opaque Refresh Credential 的產生與單向摘要 primitive。
Refresh Session 被拒絕時保留具體技術原因的認證例外。
Refresh Credential 的使用協定。
Refresh Session persistence SPI。
供 identity switch 等會立即替換或撤銷 family 的流程，原子驗證 credential 並滑動 idle window。
同一 credential 的並行使用可依序成功；logout／expiry／rotation 與本操作以相同 row lock 排序。
compare-and-rotate command。
expectedGeneration 與 currentCredentialHash 必須同時吻合。渲染後的通知內容(主旨 + 內文)
單次 render 的選項
render 成功的結果
render 完成的報表產物（REP-05）；以 renderer 的暫存檔承載，關閉後刪除
RGB 顏色值
產生報表時的環境
驗證或排版時回報的訊息
嚴重度
與 renderer 無關的報表文件：資料已套入、尚未分頁
ReportDocument 建構器；不可重複使用於多份文件以外的用途，但 ReportDocument.Builder.build() 可呼叫多次Section 建構器；摘要的線、間距及文字預設沿用文件 PageSummary。Table 建構器renderer 使用的字型登錄；不可變，可在多執行緒共用
ReportFonts 建構器字型家族；每個字面是一條 fallback 鏈，
regular 必填家族的字面設定；每個方法依序列出 fallback 字型
文件 metadata；除
keywords 外皆為選填metadata 建構器
建構時驗證；
ReportDocument.Builder#build() 呼叫選取的 PDF physical pages（REP-08）
連續頁的區間（
1 <= from <= to <= MAX_PAGE）選頁不合法（REP-08）；經
StandardRestExceptionHandler 轉為 400render 在產生階段被取消；已開啟的列來源與暫存資源都已釋放，
out 未被寫入把
ReportDocument 輸出成特定格式直接把
ReportArtifact 寫入 HTTP 回應（REP-05）報表產生的狀態值型別；
status() 對齊前端 ReportViewer 的 generating／ready／failed／expired已過期（應用依保存期限刪除後）
失敗
產生中
已保存、可下載
把應用資料轉成報表文件
報表模型不合法；建構時由
ReportDocument.Builder#build() 丟出，讀取延遲列時由 renderer 丟出雙模式資源伺服器的組裝核心（ADR-009 點 1、機制上框架）
Stateless JWT resource server 的固定安全組裝機制。
單一通知型別的重試政策
依通知型別解析
RetryPolicy 的 SPI重試策略介面
重試回調介面，用於追蹤重試狀態
寄信當下解析目標的
Mailer（比照 Spring 的 routing DataSource 模式）列
單次、只能往前讀的列游標
表格列在群組結構中的角色；renderer 依此產生續接列與避免群組標題孤立於頁尾
表格列的來源
表格列的驗證規則；建構時檢查記憶體中的列，讀取時檢查延遲來源的列，兩者共用本類別
RSA key pair 的建立與標準 wire encoding 解析。
文字段（run）
S3 的
FileJournal 實作S3/MinIO 檔案儲存實作
S3 檔案儲存例外
S3 暫存區清理任務
scaling can be set with one of these five values:
FEDERATED 模式的 JWT → Authentication 轉換器
邏輯分節；本身不產生可見內容
目前分節實際總頁數，排版完成後回填；可用於分節每頁頁首尾，及頂層 pageBreakBefore 分節內頁面的 PageSummary。
目前分節頁碼，從 1 開始；可用於分節每頁頁首尾，及頂層 pageBreakBefore 分節內頁面的 PageSummary。
分節每頁頁首尾；全寬區塊或左中右行內內容自動換行，保留實際高度與指定最小高度的較大值。
未設定的分節頁首／頁尾各自沿用文件區域；設定者取代該文件區域。
左中右內容及樣式配置。
從 Spring Security、
ActingContext 與當前 HTTP request 建立 Entity audit changeset 脈絡。Feature 自有授權規則的貢獻點
敏感資訊遮罩工具
序號生成上下文
Builder 類別
序號生成器介面
伺服器錯誤異常（HTTP 5xx）
服務不可用異常（HTTP 503）
有效 credential 與已知 family 不符；HTTP 殼須回 409 session-changed 且保留 Cookie。
不透明的憑證使用環境綁定；框架不解讀 domain／tenant／入口目錄。
activationExpiresAt 非空的 family 只能經一次性 activation 後使用。
應用提供憑證使用環境政策。只有登入引擎驗過目前 family 後，才提供切換來源。
Refresh Session 的應用政策重新驗證 hook。
由可信組裝共用的固定期限政策；不依 browser app 字串選擇。
僅由 HTTP 殼讀取實際 Cookie；缺 Cookie 時仍明示傳入 null。
驗簽並與 authoritative family 對照後的 wire 組裝資料。
互動式 Session 的簽發政策。
綁定於 Refresh Session family 的應用政策識別。
應用明示每個 principal type 的 immutable application account ID 契約；不能由反射推定資料不變性。
bounded Session profile 需要的 authoritative store 能力。
SFTP 的
FileJournal 實作SFTP 檔案儲存實作
SFTP 檔案儲存例外
建立供檔案儲存、交易 journal 與暫存清理共用的 SSH client。
SFTP 暫存區清理任務
簽章連結原語
簽發簽章連結的輸入參數
單次連結的 jti 儲存介面
已解析的簽章連結 token
Slf4j 日誌處理器
日誌等級
簡訊遞送 SPI（SMS 通道的應用層接縫）
SMS 通道（Phase 3）:委派應用層
SmsDelivery 寄出垂直間距
工具類別用於從 Filter 建構 Spring JPA Specification
Staging 暫存物件清理任務。
標準 HTTP 客戶端實作
標準 REST API 異常處理器基類 (RFC 7807)
狀態感知介面
Docusaurus 靜態網站工具類
狀態流轉工具類
儲存識別碼驗證
已保存的 PDF 中性描述；保存期限以 storedAt 起算。
把 PdfArtifact 保存到 FileStorage
StoredPdf stored = StoredPdfs.save(fileStorage, partition, renderer.render(document, options, "form.pdf"));
partition 必須是經應用驗證的可信分區識別，不可直接接受外部輸入或路徑片段（如 ..）。
partition 由應用決定：tenant 模組傳目前 tenant ID，tenantless 模組傳應用常數或依資料範圍設計的值。
保存期限由應用以 StoredPdf.storedAt() 計算並自行刪除；框架不排程刪除。
已保存到
FileStorage 的報表把 ReportArtifact 保存到 FileStorage
StoredReport stored = StoredReports.save(fileStorage, partition, renderer.render(document, options));
partition 由應用決定：tenant 模組傳目前 tenant ID，tenantless 模組傳應用常數或依資料範圍設計的值。
保存期限由應用以 StoredReport.storedAt() 計算並自行刪除；框架不排程刪除。
字串 → enum 的大小寫不敏感轉換（查詢參數／路徑變數）
把覆寫值依合併順序解析成完整樣式；renderer 使用
完整段落樣式
完整表格樣式
完整文字樣式
行政區劃（ISO 3166-2）
解析並通過政策檢查的 SVG：viewBox 與依文件順序排列的繪圖項目（使用者座標）
preserveAspectRatio 的九種對齊；數值為水平、垂直的比例位置繪圖項目；
transform 為祖先與自身 transform 的累積（不含 viewBox 映射）一段同樣式的文字；
x／y 為 null 表示接續前一段的位置一個
text 元素；runs 為其文字與 tspan 依序展開SVG 不符合受限子集；由模型驗證轉成
report.model.figure.svg-* diagnostic違反的類別與對應的 diagnostic 代碼
解析受限 SVG 子集（REP-04 契約）：白名單元素與屬性、禁止 DOCTYPE 與外部資源、複雜度上限
計算後的樣式；依 SVG 規則由祖先繼承（
opacity 除外，另以累乘的群組不透明度處理）應用建置與部署識別資訊。
表格
可跨頁表格
表格儲存格
表格列
表格列
單列樣式；
null 內距／下線繼承表格，上線 null 表示不畫。
線寬為零明確表示不畫線；與 null 的繼承不同。線畫在列邊緣，不增加列高。
可拆列的每個實體片段都使用相同線條與內距。表格樣式覆寫值；每個欄位為
null 時繼承上一層範本
${name} 具名插值（供各 NotificationTemplateResolver 共用）renderer 的暫存檔：序列化完成的 PDF 與 PDFBox 的頁面內容暫存（scratch）
租戶感知介面
租戶感知實體基類
具備租戶感知能力的 UserDetails 介面
租戶上下文工具類
租戶上下文清理 Filter
把
TenantContext 接到 Hibernate 原生 discriminator 多租戶的 resolverDeprecated, for removal: This API element is subject to removal in a future version.
租戶 ID 解析策略介面
文字
可逆文字保護邊界。
明確啟用的文字流配置；未在 ParagraphStyle 設定時，原有排版及 bytes 不變。
字寬量測；排版引擎只透過此介面取得字型資訊，因此不相依 PDF 實作
字型的不透明識別；繪製時由對應的 PDF 實作解讀
量測結果
同一字型的連續文字
文字樣式覆寫值
儲存層配置
Token 黑名單過濾器
Token 黑名單儲存介面
鄉鎮市區
交易感知的
FileStorage 裝飾器Spring Transaction 異常映射器
二維仿射轉換：
x' = a·x + c·y + e、y' = b·x + d·y + f（與 SVG matrix(a b c d e f) 相同）A translation container that stores key-value pairs for internationalization.
URL 替換工具
從 UserDetails 中解析租戶 ID
讀取延遲列時逐列驗證的游標；renderer 以它包裝
RowSource#open() 的結果Jakarta Validation 異常映射器
數值軸設定
儲存格內容的垂直對齊
表格儲存格垂直對齊方式
儲存格垂直對齊方式
村里
Bean Validation 驗證違規
Excel 活頁簿（
.xlsx / .xls）活頁簿檔案格式
工作表讀取器
工作表資料記錄
工作表寫入器
工作表
ZIP 檔案下載 Response 建構器（支援 Range Request）
ZIP 串流下載 Response 建構器
TenantContextIdentifierResolver與 ADR-016）。 本類別的手動 enable/disable 模式正是 ADR-016 所修正的缺陷根源：它要求有人在「Session 已綁定」的時機呼叫，實際只有 OSIV 綁定時成立，且失敗被自身 catch 吞掉。 跨租戶存取請改走 root session，而非關閉 filter。預計於 4.2.0 移除。