# 双端产品形态与开源技术底座决策 ## 文档信息 - 产品:模亦灵枢 / 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 必须返回无权限页面。 - 两端页面共同使用模亦灵枢品牌与设计语言,但管理端更强调密度、状态、风险和可审计性。