Skip to content

feat(console-web): 前端产品重构 — AI Teams + Studio #146

@loning

Description

@loning

背景

Console Web 当前有 14 个菜单项,全部使用工程术语(GAgents, Primitives, Topology, Mission Control),没有产品逻辑。CEO 判断:"完全没逻辑,东西都挤在一起。"

经过 Office Hours → CEO Review → Eng Review,产出了完整的产品设计方案。

产品设计文档

核心方案

Console Web — "你的 AI 团队"

Scope = Team。 一个 Scope 下所有 GAgent 组成一个 AI 团队。

双层架构(SaaS + Cloud Platform):

```
Teams(SaaS 风格): 我的团队 | 组建团队
──────────────────────────────────────────
Platform(云平台风格): Governance | Services | Topology | Deployments
```

  • Teams 层面向业务用户,SaaS 产品体验
  • Platform 层面向管理员,云平台管理后台体验

路由重组:

新路由 对应当前
/teams (首页) /scopes/overview
/teams/:scopeId (详情) 新建,组合 topology + events + members
Governance / Services / Topology / Deployments 保留在 Platform 层
其他 12 个路由 hideInMenu + redirect

团队详情页 Tabs: 概览 | 事件拓扑(XYFlow) | 事件流(EventEnvelope) | 成员 | 连接器 | 高级编辑(→Studio)

Studio — 团队构建器

Studio 针对 Scope 工作,是团队的构建/编辑工具:

  • 从一级导航移除,改为从团队详情"高级编辑"进入
  • 术语重映射:Workflows → 行为定义, Roles → Agent 角色, Connectors → 集成, Executions → 测试运行
  • 保留全部现有能力(XYFlow/Monaco/SSE 执行)

关键认知

  1. Agent 通信 = EventEnvelope 事件协议(树状传播),不是文本群聊
  2. Governance = 平台级服务发现与治理层,不是团队规则。归入 Platform 层
  3. Chat = 辅助工具(创建辅助 + 测试对话),不是一级导航
  4. 零后端变更:所有需要的 API 已存在(scopesApi, runtimeGAgentApi, runtimeActorsApi, scopeRuntimeApi)

数据源映射

前端需求 现有 API
团队列表 scopesApi.listScopes()
团队成员 runtimeGAgentApi.listActors(scopeId)
事件拓扑 runtimeActorsApi.getActorGraphEnriched()
事件流 scopeRuntimeApi.getServiceRunAudit()

实施文件清单

  1. config/routes.ts — 路由重组 + hideInMenu + redirect
  2. src/app.tsx — postMenuData 菜单分组改为 Teams + Platform
  3. src/pages/scopes/overview/ — 标签改为"我的团队"
  4. src/pages/teams/ (新建) — 团队详情页,组合 topology + events + members Tab
  5. src/layouts/MainLayout.tsx — 导航分组调整
  6. 各页面组件 — UI 标签术语替换

分工

角色 人员 职责
前端实施 @potter-sun 路由重组、页面重构、术语替换、团队详情页开发
后端支持 @eanzhao API 确认、数据源对接、Scope/GAgent 层级查询支持
架构验收 @louis-li 确保符合 CLAUDE.md 架构约束、读写分离、投影链路正确性

验收标准

  • 菜单可见项从 14 降到 2 用户层 + 4 平台层
  • 零工程术语出现在用户层界面
  • 团队详情页展示事件拓扑(XYFlow)和事件流(EventEnvelope 瀑布流)
  • 每个团队成员可见对应的 Governance Service ID
  • Studio 从一级导航移除,改为从团队详情进入
  • 所有旧路由有 redirect,不出现 404

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions