Files
moyi-model-intelligence-hub/docs/03-dual-portal-and-open-source-foundation.md
T

7.1 KiB

双端产品形态与开源技术底座决策

文档信息

  • 产品:模亦灵枢 / MOYI Model Intelligence Hub
  • 阶段:阶段 2,产品原型与技术预研
  • 决策状态:已形成基线,后续评审可迭代
  • 技术底座:Otari + MOYI Vue 3 控制台,按需演进至 AISIX 数据面

一、总体决策

模亦灵枢采用“用户端 + 管理端”的双端产品形态。两端不是同一个菜单中根据权限隐藏几个入口,而是具有不同用户目标、信息架构和导航体系的两个产品界面。

第一阶段采用同一套 Vue 3 前端工程中的两个独立应用入口,共享设计系统、基础组件、认证状态和 API SDK。管理员登录用户端后,可以通过顶部入口进入管理端;普通用户不展示入口,直接访问管理端路由时由权限守卫拒绝。

随着团队规模、安全隔离和部署要求提高,可以将两个入口拆成独立构建产物、独立域名甚至独立前端仓库,而不改变后端 API 和核心页面结构。

统一身份认证与权限中心
          │
     ┌────┴────┐
     │         │
用户端控制台   管理端控制台
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、任务、额度和文档
平台运营 可访问 部分访问 用户、邀请码、额度和内容运营
模型运营 可访问 部分访问 模型、供应商、渠道、路由和容量
财务运营 可访问 部分访问 计费、额度流水和未来订单
平台管理员 可访问 全部访问 平台级配置与角色授权

权限校验必须同时存在于前端路由和后端接口。前端隐藏菜单只改善体验,不能作为安全措施。管理端的额度发放、渠道密钥、路由变更、用户封禁和角色调整等操作必须记录审计日志。

六、前端工程边界

进入正式开发时建议采用以下结构:

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