> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 管理控制台

平臺檢查、公告與功能標誌。

## 初學者演練

先決條件：閱讀下面的兩個初學者指南，完成 Web 本地設定，並在編輯器的根目錄中開啟此 monorepo。網頁設定屬於`apps/web/.env.local`； Next.js不讀取根`.env`。預設fake模式下的`/dashboard`是無資料庫演示； `/auth` 需要遷移資料庫。

簡而言之：工作區是一個團隊的單獨使用者、資料和設定。伺服器是可信後端；讓提供商金鑰遠離瀏覽器和電話程式碼。遷移是建立或更新表的版本化資料庫更改。人工智慧模型是回答的引擎；型號目錄是伺服器上可用型號 ID 和價格的列表。提供商是一種外部服務，例如人工智慧、電子郵件或計費服務。權利是允許工作區使用某項功能的授權。 Webhook 是一個服務傳送到另一個服務的 URL 的訊息。

1. 在建立本地測試帳戶之前，將您自己的地址新增到僅伺服器 `ADMIN_EMAILS` 列表中並重新啟動應用程式。

2. 註冊遷移後的測試資料庫並開啟`/admin`；檢查可用的使用者和組織頁面。

3. 這授予平臺管理員許可權，而不是工作區所有權。如果訪問被拒絕，請驗證確切的電子郵件和伺服器配置；不要提升任意使用者或針對生產進行測試。

對於自定義程式碼，請從提供的 `prompts/README.md` 開始，然後複製最接近的提示：對於應用程式螢幕為 `prompts/new-app-screen.md`，對於公共頁面為 `prompts/new-landing-page.md`。對於伺服器、資料庫或提供商工作，請為您的編碼代理提供本指南的任務，並要求其讀取 `AGENTS.md`、`.ai/PROJECT_CONTEXT.md` 和匹配的 `.ai/` 映象；檢查此處指定的確切原始檔；列出檔案並在編輯前進行檢查；保留工作區所有權和僅限伺服器的機密；並向您展示差異。告訴它您想要的行為、輸入和輸出欄位、允許的角色、預期的成功和錯誤以及測試帳戶、提供程式或裝置。使用樣本值；永遠不要貼上真正的秘密。

[開始之前](https://supastack.dev/zh-tw/docs/web/before-you-start.md)

[終端基礎知識](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

[網路本地設定](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)

[座席提示和專案記憶體](https://supastack.dev/zh-tw/docs/web/agents.md)


## 建立管理邊界

`ADMIN_EMAILS` 是僅用於伺服器的逗號分隔引導列表。列出的使用者在註冊時將獲得平臺管理員角色。如果沒有它，則通過授權的資料庫/管理路徑授予訪問許可權；不要讓第一個任意訪問者成為管理員。

平臺管理員與工作區所有者/管理員不同。 `/admin`及其使用者、組織、旗幟、公告和候補名單頁面檢查平臺角色。


## 使用已實施的控制元件

預設的Better Auth引擎提供管理員使用者管理、禁止和模擬。該應用程式將平臺檢視與審計跟蹤組合在一起。將模擬限制為經過驗證的管理員訪問許可權，使其狀態可見並在退出時恢復原始管理會話。

Auth.js 不會自動繼承 Better Auth 管理外掛。在切換引擎之前檢查 `admin.ts`、`admin-actions.ts` 和身份驗證提供者的行為。


## 驗證特權操作

測試非管理員拒絕、管理員訪問、禁止使用者會話、模擬啟動/停止以及您啟用的操作。將所有管理路由保留在公共索引之外。

[功能標誌](https://supastack.dev/zh-tw/docs/web/feature-flags.md)

[公告](https://supastack.dev/zh-tw/docs/web/project-structure.md)

[候補名單管理](https://supastack.dev/zh-tw/docs/web/setup-ai.md)


## 安裝與配置

/admin 端面是運營者對工作區、成員和產品狀態的檢查檢視。ADMIN_EMAILS(或消費產品中的 admin 外掛配置)決定誰能進入;每個 admin 路由都會在伺服器上重新檢查授權。

功能標誌(feature-flag-runtime.ts)預設停用一切未配置的內容 —— 缺失的標誌絕不可能悄悄啟用某個端面 —— 按標誌的覆蓋存活在 featureFlagOverride 表中。

```
/admin                    operator dashboard
announcement-actions.ts   broadcast in-app notices
resolveFeatureFlags(...)  bulk flag resolution for a caller context
```


## 實現流程

將 admin 操作用於檢查和支援運營(工作區查詢、成員管理、公告廣播)。保持變更被審計,授權在操作邊界而非導航中檢查。

在標誌後面推出功能:以暗模式交付程式碼,按工作區或全域性啟用,並在端面成為永久功能後移除標誌。除非產品的 PRODUCT.md 明確授權,否則平臺冒充保持凍結。


## 驗證與排障

驗證非管理員被拒絕、停用的標誌端到端隱藏其端面(導航、路由、操作)、覆蓋只對目標解析,以及公告到達預期受眾。admin 測試應首先覆蓋拒絕路徑。


## 下一篇

[測試策略](https://supastack.dev/zh-tw/docs/web/testing.md)