feat: expand dual-portal interactive prototype

This commit is contained in:
wlx committed 2026-08-19 16:11:01 +08:00
1 parent 663faee95a
commit 78339580a5
5 files changed
+580 -18

No files matched your search

@@ -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 必须返回无权限页面。
- 两端页面共同使用模亦灵枢品牌与设计语言,但管理端更强调密度、状态、风险和可审计性。