# 範例總覽

Source: https://gortexa.sheng.page/examples/

這些範例出自框架的驗證矩陣：11 個各自獨立的情境，每個證明一個具體行為。情境腳本沒有隨框架發佈，所以下面的子分頁列出每個情境的重點檢查與可複製的片段，讓你在自己的專案重現同樣的性質。

## 共用前提

- **測試 token**：打過 auth 的情境都需要 JWT。用專案自帶的 `auth` 簽一顆，見[取得開發用 token](https://gortexa.sheng.page/quickstart/#取得開發用-token)。
- **port**：片段打的是 `:18080`（以 `GORTEXA_SERVER__ADDR=:18080` 啟動伺服器，或自行改片段裡的 port）；啟動後輪詢 `/readyz` 才開始探測。
- **清理**：自己啟動的 server 都要收掉（`trap cleanup EXIT`，NATS 則用 `docker compose stop`），每項檢查才能重複執行。
- **依賴**：只有兩個 NATS 系情境（core 與 JetStream）需要 docker，其餘純本機二進位。

## 子分頁

- [開發流程](https://gortexa.sheng.page/examples/workflow/)：scaffold 全程、同一實體跨三協定。
- [安全與邊界](https://gortexa.sheng.page/examples/security/)：auth 拒絕不洩漏、secret 啟動安全、header allowlist、reflection 閘。
- [契約與韌性](https://gortexa.sheng.page/examples/resilience/)：buf breaking gate、SIGTERM 優雅排空。
- [AI 與訊息](https://gortexa.sheng.page/examples/messaging/)：export tool schema、NATS／JetStream 整合。
- [完整範例](https://gortexa.sheng.page/examples/full-example/)：`go get` 後把公開元件接成一支服務，附完整、逐段註解的 `main.go`。

## 建議起手路徑

1. [開發流程](https://gortexa.sheng.page/examples/workflow/)先走一遍完整開發迴圈。
2. 看同一份 proto 怎麼同時變成三個協定。
3. [安全與邊界](https://gortexa.sheng.page/examples/security/)看錯誤模型與攔截器鏈在對抗性輸入下的行為。