feat: expand dual-portal interactive prototype
This commit is contained in:
1 parent
663faee95a
commit
78339580a5
5 files changed
+580
-18
No files matched your search
@@ -63,7 +63,7 @@ prototype/
|
||||
| 任务中心 | 排队、执行、完成、失败、进度条和详情抽屉 | 任务查询、取消、重试、结果文件和回调 |
|
||||
| 用量与账单 | 调用趋势、额度卡片、流水、充值占位 | 用量明细、额度流水、计费规则、订单和支付 |
|
||||
| 接入文档 | Base URL、Key、模型名、同步/流式/异步说明和代码示例 | 版本化 API 文档、SDK、错误码、模型能力文档 |
|
||||
| 运营后台 | 用户额度发放、模型健康、队列和审计事件 | 用户、供应商、模型、策略、容量和审计管理 |
|
||||
| 管理端 | 独立入口与导航;用户额度、模型供应商、渠道路由、并发队列、计费、审计和平台设置 | 用户、供应商、模型、策略、容量、计费和审计管理 |
|
||||
|
||||
## 四、核心交互流程
|
||||
|
||||
@@ -112,12 +112,15 @@ API Keys → 创建 API Key → 填写名称和权限范围
|
||||
- 状态始终可见:服务健康、调用模式、任务进度、额度、Key 状态和操作结果均有视觉反馈。
|
||||
- 桌面端优先,同时在 860px 和 560px 断点下压缩导航、卡片和表格,保证原型可用于移动端评审。
|
||||
- 不绑定具体第三方客户端品牌;接入文档面向 AI 应用、业务系统、开发工具和 SDK/HTTP 的通用方式。
|
||||
- 用户端和管理端使用独立导航与产品语境;第一阶段共享前端工程和设计系统,管理员可在两端切换。
|
||||
|
||||
## 六、阶段验收标准
|
||||
|
||||
- `pnpm install` 后可以启动 `pnpm dev`,并访问 `http://localhost:4173`。
|
||||
- `vue-tsc --noEmit` 通过,`vite build` 通过。
|
||||
- 用户可以在总览、模型广场、Playground、Key、任务、用量、文档和运营后台之间切换。
|
||||
- 用户可以在总览、模型广场、Playground、Key、任务、用量和文档之间切换。
|
||||
- 管理员可以从用户端进入独立管理端,并在管理总览、用户、模型、路由、队列、计费、审计和设置模块间切换。
|
||||
- 管理端核心列表具备搜索、筛选、开关、抽屉、弹窗、额度发放、邀请创建和设置保存等可演示交互。
|
||||
- 用户可以从模型卡进入 Playground,完成一次演示调用并看到成功反馈。
|
||||
- 用户可以创建 Key、看到一次性展示弹窗、复制 Key,并在列表中禁用/启用。
|
||||
- 用户可以筛选模型和任务,打开任务详情抽屉,看到排队/执行/完成/失败状态。
|
||||
|
||||
@@ -0,0 +1,137 @@
|
||||
# 双端产品形态与开源技术底座决策
|
||||
|
||||
## 文档信息
|
||||
|
||||
- 产品:模亦灵枢 / MOYI Model Intelligence Hub
|
||||
- 阶段:阶段 2,产品原型与技术预研
|
||||
- 决策状态:已形成基线,后续评审可迭代
|
||||
- 技术底座:Otari + MOYI Vue 3 控制台,按需演进至 AISIX 数据面
|
||||
|
||||
## 一、总体决策
|
||||
|
||||
模亦灵枢采用“用户端 + 管理端”的双端产品形态。两端不是同一个菜单中根据权限隐藏几个入口,而是具有不同用户目标、信息架构和导航体系的两个产品界面。
|
||||
|
||||
第一阶段采用同一套 Vue 3 前端工程中的两个独立应用入口,共享设计系统、基础组件、认证状态和 API SDK。管理员登录用户端后,可以通过顶部入口进入管理端;普通用户不展示入口,直接访问管理端路由时由权限守卫拒绝。
|
||||
|
||||
随着团队规模、安全隔离和部署要求提高,可以将两个入口拆成独立构建产物、独立域名甚至独立前端仓库,而不改变后端 API 和核心页面结构。
|
||||
|
||||
```text
|
||||
统一身份认证与权限中心
|
||||
│
|
||||
┌────┴────┐
|
||||
│ │
|
||||
用户端控制台 管理端控制台
|
||||
console.* admin.*
|
||||
│ │
|
||||
└────┬────┘
|
||||
│
|
||||
MOYI Control Plane API
|
||||
│
|
||||
Otari Gateway / Usage Core
|
||||
│
|
||||
模型供应商与自托管模型
|
||||
```
|
||||
|
||||
## 二、为什么采用这种方式
|
||||
|
||||
### 2.1 不采用完全混合菜单
|
||||
|
||||
用户端围绕“发现模型、获得 Key、调用模型、查看任务和用量”组织;管理端围绕“用户运营、模型供给、路由策略、容量、计费和审计”组织。两者混在一套导航中会导致普通用户界面复杂,也会弱化高风险管理操作的边界。
|
||||
|
||||
### 2.2 第一阶段不创建两个完全独立前端项目
|
||||
|
||||
第一版团队和产品规则仍在快速迭代。立即建立两个仓库会重复建设登录、设计令牌、通用表格、表单、权限组件和 API 客户端,增加维护成本。采用一个前端工程、两个路由根和两个布局,可以同时获得产品边界与代码复用。
|
||||
|
||||
### 2.3 保留未来物理拆分能力
|
||||
|
||||
代码按 `user`、`admin`、`shared` 划分,禁止管理端页面直接依赖用户端页面。未来可以通过不同构建入口分别输出用户端和管理端,也可以部署到不同域名并增加网络访问限制。
|
||||
|
||||
## 三、用户端信息架构
|
||||
|
||||
| 模块 | 第一阶段内容 |
|
||||
|---|---|
|
||||
| 总览 | 额度、调用情况、服务状态、最近活动、快速开始 |
|
||||
| 模型广场 | 文本、图像、视频、音频、Embedding、3D 等模型发现与筛选 |
|
||||
| Playground | 同步、流式和异步模型试用 |
|
||||
| API Keys | 创建、一次性展示、禁用、权限范围和最近使用 |
|
||||
| 任务中心 | 3D、图像、视频等异步任务的排队、进度、结果和失败状态 |
|
||||
| 用量与账单 | 用量、额度、流水和充值/套餐预留入口 |
|
||||
| 接入文档 | Base URL、认证、模型名、接口示例、错误码和任务接口 |
|
||||
| 账户与安全 | 邀请码账户、个人信息和安全设置;公开注册能力预留 |
|
||||
|
||||
## 四、管理端信息架构
|
||||
|
||||
| 模块 | 第一阶段内容 |
|
||||
|---|---|
|
||||
| 管理总览 | 用户、调用、收入/额度、平台健康、队列和风险摘要 |
|
||||
| 用户与额度 | 邀请码、用户状态、角色、额度发放、封禁和用户用量 |
|
||||
| 模型与供应商 | 模型目录、能力 Schema、供应商、渠道、价格和上下线 |
|
||||
| 渠道与路由 | 权重、优先级、模型映射、故障转移、重试和熔断 |
|
||||
| 并发与队列 | 用户/Key/模型/渠道并发、速率限制、排队和任务容量 |
|
||||
| 计费与订单 | 计费单位、倍率、额度流水;充值、订单和退款暂留扩展位 |
|
||||
| 日志与审计 | 调用日志、错误日志、管理员操作记录和敏感变更审计 |
|
||||
| 平台设置 | 注册方式、邀请码规则、品牌信息、公告和系统参数 |
|
||||
|
||||
企业认证、组织工作空间、自托管模型和复杂支付闭环可以在数据结构与权限点中预留,但不作为第一版完整交付范围。
|
||||
|
||||
## 五、身份、角色与访问规则
|
||||
|
||||
第一版至少定义以下角色:
|
||||
|
||||
| 角色 | 用户端 | 管理端 | 说明 |
|
||||
|---|---|---|---|
|
||||
| 普通用户 | 可访问 | 不可访问 | 使用模型、Key、任务、额度和文档 |
|
||||
| 平台运营 | 可访问 | 部分访问 | 用户、邀请码、额度和内容运营 |
|
||||
| 模型运营 | 可访问 | 部分访问 | 模型、供应商、渠道、路由和容量 |
|
||||
| 财务运营 | 可访问 | 部分访问 | 计费、额度流水和未来订单 |
|
||||
| 平台管理员 | 可访问 | 全部访问 | 平台级配置与角色授权 |
|
||||
|
||||
权限校验必须同时存在于前端路由和后端接口。前端隐藏菜单只改善体验,不能作为安全措施。管理端的额度发放、渠道密钥、路由变更、用户封禁和角色调整等操作必须记录审计日志。
|
||||
|
||||
## 六、前端工程边界
|
||||
|
||||
进入正式开发时建议采用以下结构:
|
||||
|
||||
```text
|
||||
apps/
|
||||
├── user-console/ # 用户端路由、布局与页面
|
||||
└── admin-console/ # 管理端路由、布局与页面
|
||||
packages/
|
||||
├── design-system/ # 品牌令牌和基础组件
|
||||
├── api-client/ # Control Plane API SDK
|
||||
├── auth/ # 登录状态、角色和权限守卫
|
||||
├── model-schema/ # 多类型模型能力定义
|
||||
└── shared/ # 通用工具与类型
|
||||
```
|
||||
|
||||
原型阶段可以继续保留一个 Vite 应用,以两个布局模拟双端;正式开发开始时再按上述边界拆分,避免把演示状态带入生产结构。
|
||||
|
||||
## 七、开源底座与系统边界
|
||||
|
||||
### 7.1 Otari
|
||||
|
||||
Otari 作为第一阶段网关和用量基础,优先复用多供应商接入、虚拟 Key、预算/用量、模型价格和协议兼容能力。使用前仍需对目标版本、依赖许可证和实际缺口完成一次代码级审计。
|
||||
|
||||
### 7.2 MOYI 自研控制面
|
||||
|
||||
以下能力由 MOYI 自主实现,不耦合到单个网关项目:
|
||||
|
||||
- 邀请码、用户、角色和双端权限。
|
||||
- C 端模型广场、额度与运营体系。
|
||||
- 多类型模型能力 Schema。
|
||||
- 3D、图像、视频等异步任务、结果文件和对象存储。
|
||||
- 计费台账、审计和未来企业工作空间。
|
||||
- 面向 Otari、未来 AISIX 和自托管模型的统一控制面适配层。
|
||||
|
||||
### 7.3 AISIX
|
||||
|
||||
AISIX 不进入第一版关键路径。当 Otari 单实例或现有数据面无法满足吞吐、路由治理、缓存、限流和可观测性要求时,再通过压测结果决定是否引入。业务系统只依赖 MOYI 控制面契约,不直接绑定 AISIX。
|
||||
|
||||
## 八、原型验收补充
|
||||
|
||||
- 用户端不直接展示运营菜单。
|
||||
- 管理员可以从用户端明显但不过度突出的入口进入管理端。
|
||||
- 管理端使用独立导航和页面标题,能够清晰识别当前所在端。
|
||||
- 管理端可以返回用户端,切换后不混用两端页面状态。
|
||||
- 普通用户无管理入口;正式开发中直接访问管理端 URL 必须返回无权限页面。
|
||||
- 两端页面共同使用模亦灵枢品牌与设计语言,但管理端更强调密度、状态、风险和可审计性。
|
||||
Reference in new issue
Block a user