平台概述

平台管理员控制台是位于 /admin 的仅限操作员使用的界面。 在这里您可以管理计划、监控每个工作区的使用情况、重试失败的作业， 以及为了支持而模拟客户。只有具有 role = super_admin 的用户才能看到它 — 其他人会得到 404（不是 403），因此面板甚至不会透露它的存在。

成为超级管理员

标志是 users.role 列，转换为 PlatformRole 枚举， 有两个案例：customer（每个注册的默认值）和 super_admin。 没有 UI 可以授予它 — 通过 tinker 或新部署的一次性迁移手动设置：

php artisan tinker --execute 'User::where("email", "you@company.com")->update(["role" => "super_admin"]);'

降级工作方式相同（role = "customer"）。没有通知 — 下一个页面加载将显示或隐藏管理员导航。

布局

管理员侧边栏列出十个部分：

• Dashboard — 仪表板，所有工作区的 KPI，系统健康摘要。
• Workspaces — 工作区，每个工作区、其计划、所有者、成员数、对话使用情况。
• Users — 用户，平台上的每个用户、他们的工作区、最后出现时间。
• Agents — 智能体，平台上的每个智能体，带有工作区 + 发布状态。
• Conversations — 对话，每个对话。对支持很有用。
• Leads — 潜在客户，每个潜在客户。
• Plans — 计划，Stripe 同步的计划 CRUD。详见 计划和 Stripe 同步。
• Subscriptions — 订阅，每个活动订阅。通过 Stripe 订阅 ID 反向查找工作区。
• Usage — 使用情况，按月统计每个工作区的对话计数。
• Queue Failures — 队列失败，失败的作业，带有重试/忘记控制。

标题操作

管理员标题（每个管理员页面的顶部栏）有：

• Site Health pill — 站点健康药丸，绿色/琥珀色/红色。悬停查看细分 — 失败的作业、Stripe 配置、LLM 提供商、向量存储、邮件驱动程序、Reverb 密钥、缓存。详见 站点健康和失败的作业。
• Notifications dropdown — 通知下拉菜单，未读警报（失败的作业、缺少 Stripe 密钥等）。
• Global search — 全局搜索，一键搜索工作区、用户、智能体、对话、潜在客户。

模拟

从 Workspaces 或 Users 页面，点击 Impersonate（模拟）。 发生几件事：

1. 您的管理员会话被保留。
2. 您在其工作区内成为目标用户。
3. 每个页面顶部都会出现持久的 You're impersonating X（您正在模拟 X）横幅，直到您停止。
4. 在 audit_logs 中记录一行，以便操作可追溯。

点击横幅中的 Stop impersonating（停止模拟）以返回到您的管理员会话。 横幅故意难以错过 — 没有快捷方式可以在不结束模拟的情况下关闭它。

搜索

从管理员面板的任何地方按 /。全局搜索下拉菜单打开，包含部分：

• Workspaces（工作区，按名称）。
• Users（用户，按电子邮件）。
• Agents（智能体，按名称 + 工作区）。
• Conversations（对话，按消息文本）。
• Leads（潜在客户，按名称 + 电子邮件）。

每个结果直接链接到资源。客户表面有相同的搜索，但仅限于当前工作区。

审计日志

每个管理员操作 — 计划创建/更新/删除、模拟开始/停止、工作区更改 — 都会写入 audit_logs 表以进行取证追踪。 v1 中没有用于浏览审计日志的 UI 页面；需要调查时直接查询表。