範例總覽

這些範例是框架的驗證矩陣：11 個各自獨立的情境，每個用一支 run.sh 證明一個具體行為。下面的子分頁把每個情境的重點與可複製的片段列出來，你可以照著在自己的專案驗證同樣的性質。

共用前提

• 測試 token：打過 auth 的情境都需要 JWT。用專案自帶的 auth 簽一顆，見取得開發用 token。範例集另有一支 tools/mint HS256 minter，secret 依 -secret flag → GORTEXA_AUTH__JWT_SECRET → etc/config.yaml 三層解析。
• port：伺服器情境跑在 :18080 起（各情境用不同 port 避免衝突），啟動後輪詢 /readyz 才開始探測。
• 清理：每個情境用 trap cleanup EXIT 收掉 server 或 docker compose stop，可重複執行。
• 依賴：只有兩個 NATS 系情境（core 與 JetStream）需要 docker，其餘純本機二進位。

子分頁

• 開發流程：scaffold 全程、同一實體跨三協議。
• 安全與邊界：auth 拒絕不洩漏、secret 啟動安全、header allowlist、reflection 閘。
• 契約與韌性：buf breaking gate、SIGTERM 優雅排空。
• AI 與訊息：export tool schema、NATS／JetStream 整合。
• 完整範例：go get 後把公開組件接成一支服務，附完整、逐段註解的 main.go。

建議起手路徑

1. 開發流程先走一遍完整開發迴圈。
2. 看同一份 proto 怎麼同時變成三個協議。
3. 安全與邊界看錯誤模型與攔截器鏈在對抗性輸入下的行為。