> ## 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/docs/web/before-you-start.md)

[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)

[网络本地设置](https://supastack.dev/zh/docs/web/ship-in-5-minutes.md)

[座席提示和项目内存](https://supastack.dev/zh/docs/web/agents.md)


## 创建管理边界

`ADMIN_EMAILS` 是仅用于服务器的逗号分隔引导列表。列出的用户在注册时将获得平台管理员角色。如果没有它，则通过授权的数据库/管理路径授予访问权限；不要让第一个任意访问者成为管理员。

平台管理员与工作区所有者/管理员不同。 `/admin`及其用户、组织、旗帜、公告和候补名单页面检查平台角色。


## 使用已实施的控件

默认的Better Auth引擎提供管理员用户管理、禁止和模拟。该应用程序将平台视图与审计跟踪组合在一起。将模拟限制为经过验证的管理员访问权限，使其状态可见并在退出时恢复原始管理会话。

Auth.js 不会自动继承 Better Auth 管理插件。在切换引擎之前检查 `admin.ts`、`admin-actions.ts` 和身份验证提供者的行为。


## 验证特权操作

测试非管理员拒绝、管理员访问、禁止用户会话、模拟启动/停止以及您启用的操作。将所有管理路由保留在公共索引之外。

[功能标志](https://supastack.dev/zh/docs/web/feature-flags.md)

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

[候补名单管理](https://supastack.dev/zh/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/docs/web/testing.md)