版本、來源與閱讀方式

實作與教材版本

本手冊對應 2026-10-20 的青梭紡織沙盒。使用 Astro 7.3.5、Starlight 0.42.5，部署 Cloudflare Pages。來源是實際部署檔、測試輸出與以下官方文件。

元件	官方來源	本課用途
PostgreSQL	RLS、權限	資料列／欄位／角色約束
Keycloak	MCP authorization server	Client、scope、audience
OpenBao	PostgreSQL secrets engine、AppRole	憑證簽發與服務身分
MCP	Python SDK	Streamable HTTP 工具介面
Codex	MCP	學員本機 Agent 接入
ChatGPT	Secure MCP Tunnel	私有 MCP 傳輸與接入前提
Astro／Starlight	Getting started	文件網站
Cloudflare	Pages Direct Upload	靜態教材發布

延伸工具何時加入

OpenFGA 解決關係型授權，OPA 解決額外條件政策；OpenMetadata 維護資料定義；OpenTelemetry／Jaeger 提供跨服務追蹤。它們都需要應用真正整合與執行，不能只畫進架構圖就當控制已完成。

Presidio、Squid、Promptfoo、Trivy、pgAudit、pgBackRest 也是針對不同缺口的選項。以架構頁的已部署狀態為準，不把工具清單當必裝清單。

書籍與引用的界線

先前課程討論包含 O’Reilly 的 Text-to-SQL、Agent 安全與資料工程閱讀方向。本版以可以直接核對的實作與官方文件為依據，不宣稱某一本書推薦這整套品牌組合，也不把付費書頁截圖打包公開。若要加入書籍章節，需核對書名、作者、版本、章節與平台連結後再補，不能用搜尋摘要代替讀到的內容。