Files
moyi-model-intelligence-hub/docs/05-information-readiness-checklist.md
T

175 lines
10 KiB
Markdown
Raw Normal View History

2026-08-21 18:22:35 +08:00
# 信息准备与阶段门禁清单
## 一、先看结论
产品文档中的“待确认事项”是完整的长期输入清单,不代表现在必须一次性提供。模亦灵枢采用分阶段准备:
| 时间点 | 必须掌握的信息 | 可以暂时不确定 |
|---|---|---|
| 当前进入 D4 前 | 第一版边界、首个管理员、认证规则、Key 目标、首批真实调用方式 | 供应商最终名单、价格、支付、公开注册、企业认证、正式合规结论 |
| D4 真实供应商联调前 | 至少一个供应商/模型的接口资料、测试 Key、模型能力和限制 | 第二家供应商、复杂路由、最终计费 |
| 测试环境/UAT 前 | 测试部署资源、测试账号、测试模型、测试数据、验收场景、容量假设 | 生产域名、正式支付、最终 SLA |
| 生产开放前 | 运营主体、域名/TLS/备案、供应商授权、数据与合规、计费支付、安全运维和容量 | 后续 MaaS、自托管模型等长期能力 |
## 二、现在必须确认
以下内容是进入 D4 仍需要项目负责人确认的最小集合。没有这些信息,可以继续做 Schema、Mock 和页面;但不能完成真实供应商调用验收。
| 编号 | 需要确认 | 当前状态/默认处理 |
|---|---|---|
| N-01 | 第一版目标用户 | 已确认:先服务模灵科技内部项目,再逐步邀请外部开发者 |
| N-02 | 第一版模型范围 | 已确认:不是只做大语言模型,覆盖文本、图像、音频、视频、Embedding 和生成式 3D |
| N-03 | 第一版准入 | 已确认:邀请码注册;手机号/邮箱公开注册只预留 |
| N-04 | 第一版额度 | 已确认:按人民币 `¥` 计价展示,管理员可发放等值内测额度;充值/套餐入口保留但暂不启用真实支付 |
2026-08-21 18:22:35 +08:00
| N-05 | 登录与权限 | 已确认:用户端和管理端分权限;企业认证可后置 |
| N-06 | 首个管理员账号 | 需要提供一个开发环境管理员账号,密码由你本地设置,不提交 Git |
| N-07 | 首个接入验收方式 | 需要选择一种实际调用方式作为验收,例如标准 HTTP/SDK 接入;不绑定某个客户端品牌 |
| N-08 | D4 是否先使用 Mock | 可以先确认“先 Mock 后真实供应商”;供应商未定时默认这样推进 |
### 现在不需要提供密钥
真实供应商 Key、服务器密码、数据库密码、短信/邮件密钥都不应发到聊天或写入仓库。需要联调时,只在你本地 .env 或服务器密钥管理中配置。
## 三、开发过程中逐步确认
这些信息不是今天必须全部确定,而是在对应节点开始前补齐。
### D4:Key 与模型目录
真实供应商联调前必须有:
- 供应商名称、API 文档、Base URL、认证方式和测试环境。
- 至少一个可调用的测试 Key,或由供应商提供的测试账号。
- 模型名称/版本、模型类型、输入输出格式、同步/流式/异步模式。
- 输入大小、输出大小、超时、速率、并发、额度和内容限制。
- 3D 模型的任务提交、进度查询、回调/轮询、结果文件格式和下载方式。
- 统一模型名是否由 MOYI 自定义,以及供应商模型 ID 如何映射。
可以继续留空:
- 第二家及更多供应商。
- 最终价格、套餐、充值和退款。
- 复杂路由、自动降级和跨区域部署。
- 自托管模型和企业 BYOK。
### D5:调用与计量
开始真实计量前必须有:
- 各模型的计量单位,例如 Token、请求、图片张数、任务次数、文件大小或时长。
- 成功、失败、超时、取消、重试和供应商切换的计量处理。
- 额度预占、结算、释放和幂等规则。
- API 错误格式、请求 ID、流式断开和异步任务状态。
如果暂时不收费,可以先使用“管理员额度 + 记录用量、不做支付”的测试规则。
### D6:异步任务与 3D
开始 3D/图像/视频真实任务前必须有:
- 一个可测试的任务型模型或 AI SoulMate 测试接口。
- 测试输入文件、输出文件格式、文件大小限制和保存周期。
- 任务状态定义、回调签名或轮询频率、超时和重试规则。
- 失败、取消、重复提交和结果下载的验收样例。
## 四、测试环境/UAT 前必须确认
测试环境重点是“能不能稳定验证”,不要求已经具备生产规模。
### 环境资源
| 资源 | 测试环境最低要求 | 生产前再升级 |
|---|---|---|
| 应用服务器 | 一台可运行 Docker 的开发/测试服务器,或本机 | 高可用、扩容、备份和故障切换 |
| PostgreSQL | 独立测试数据库,能重建和清理 | 高可用、加密、备份、恢复演练 |
| Redis/队列 | D6 之前准备测试实例;D4/D5 可暂用同步或内存方案 | 持久化、容量和故障恢复 |
| 对象存储 | D6 之前准备 MinIO 或测试 OSS | 地区、生命周期、跨域和下载授权 |
| 域名/TLS | UAT 可使用内网域名或测试域名 | 正式域名、证书、备案和网关策略 |
| 供应商 | 至少一个测试账号和测试 Key | 商业授权、正式额度、SLA 和账务 |
### UAT 资料
- 测试用户:管理员、普通用户、停用用户各至少一个。
- 测试邀请码:单次、多人次、过期、停用各一个。
- 测试模型:至少一个同步/流式模型和一个异步模型;暂时没有真实 3D 时可用 Mock。
- 测试数据:文本、图片、音频、视频、3D 示例及禁止上传的敏感数据样例。
- 验收场景:注册、登录、创建 Key、模型发现、调用、排队、失败、用量、额度和管理审计。
- 容量假设:预计测试用户数、并发请求数、异步任务数和可接受等待时间。
UAT 通过的标准不是“所有模型都接入”,而是首批约定模型的核心闭环可重复完成。
## 五、生产开放前必须确认
生产信息分为业务、供应商、合规、安全和运维五类。没有这些信息,系统可以在内网或封闭测试环境运行,但不建议面向公众开放。
### 业务与运营
- 运营主体、客服/故障联系人、用户支持方式和账号封禁流程。
- 外部开放对象、邀请范围、开放地区和服务时间。
- 额度发放、价格、计费单位、失败退款、充值、发票和对账规则。
- 用户协议、隐私政策、服务条款、模型使用限制和申诉机制。
### 供应商与模型
- 供应商是否允许 API 转售、共享额度、二次封装和商业化。
- 正式供应商账户、额度、限流、并发、区域、SLA 和账单。
- 模型版本锁定、上下线流程、价格变更和故障切换策略。
- 生成式 3D 的素材授权、结果使用权和第三方许可证。
### 地区与合规
- 服务地区、服务器和数据库所在地区、是否跨境传输。
- 域名、备案、TLS、支付主体和开票主体。
- 注册信息、Prompt、上传文件、结果文件和日志的保存期限与删除方式。
- 内容安全审核、违规处置、审计留存、个人信息保护和生成内容标识要求。
以上内容是上线准备清单,不构成法律意见;正式上线前需要由运营主体和法务确认。
### 安全与运维
- 生产密钥管理、最小权限、轮换、撤销和泄露应急流程。
- 数据库、对象存储和日志备份,恢复目标和恢复演练。
- 监控、告警、请求追踪、供应商故障处理和发布回滚。
- 平台总并发、用户/项目/API Key 限制、队列长度、超时和扩容阈值。
- 生产镜像、依赖许可证、漏洞扫描和变更审批记录。
## 六、可以后置的信息
以下内容不应阻塞当前 D3/D4:
- 手机号/邮箱公开注册和真实短信/邮件验证码。
- 企业认证、组织、团队和复杂审批。
- 充值、套餐、支付、退款、发票和财务对账。
- 多供应商智能路由、复杂降级和跨区域容灾。
- BYOK、专属模型、自托管模型和 GPU 调度。
- 知识库、RAG、Agent、工作流和模型评测平台。
- 正式公网域名、品牌营销和大规模容量承诺。
2026-08-23 18:12:21 +08:00
## 七、本轮已确认的 D4 输入
2026-08-21 18:22:35 +08:00
2026-08-23 18:12:21 +08:00
| 项目 | 已确认内容 | 处理方式 |
|---|---|---|
| 开发管理员账号 | `adimin` | 已写入配置模板;密码只由本地 `.env` 设置,不进入 Git |
| 首个真实接入方向 | 先评估智谱、阿里、Kimi 等国内文本/多模态模型;VAST 合作方向重点评估 3D | 先做可替换 Provider Adapter,不绑定单一厂商 |
| VAST/3D 接入方式 | 先采用开发者 API Key + HTTP API;后续可增加 SDK 适配 | Key 只存本地密钥环境,用户侧只使用 MOYI Key |
| Mock 策略 | 接受先用 Mock 完成 Key/模型目录,再接真实供应商 | D4 先保证目录、权限和映射闭环 |
| 首批模型类型 | 文本/编码/多模态模型,或生成式 3D | 建议同步模型 + 异步 3D 各选一个验收 |
| 已有接口资源 | 已有 3D API 接入方式,后续可能使用 SDK | 真实接口资料在联调前补齐 |
| 测试环境 | 使用现有服务器 | 先确认 Docker、端口、磁盘、数据库和备份条件 |
| 首轮规模 | 4—5 人,3—4 个项目 | 作为测试容量假设,不作为生产承诺 |
| 业务规则 | 邀请码、管理员额度、暂不支付、公开注册后置;支持用量/金额分配 | D4/D5 先做额度分配和用量记录,支付后置 |
| Key 归属 | 同时支持个人 Key 与工作区/项目 Key | 第一版项目 Key 先由项目所有者创建,成员协作和细粒度 RBAC 后置 |
2026-08-21 18:22:35 +08:00
2026-08-23 18:12:21 +08:00
### 凭证安全说明
2026-08-21 18:22:35 +08:00
2026-08-23 18:12:21 +08:00
本轮提供的管理员密码不会写入文档、代码或 Git。请在本地 `control-plane/.env` 中设置 `ADMIN_PASSWORD`;供应商 API Key、数据库密码和 SDK 凭证同样只通过本地环境变量或服务器密钥管理注入。
## 八、当前待补资料
为了进入真实供应商联调,目前只需要补充下面 3 类资料,暂时不知道的写“待定”即可:
1. 当前需要补充的是首个供应商/模型的 API 文档、测试 Key 和能力限制。
2. 如果优先接 3D,需要补充 VAST/AI SoulMate 的任务接口、回调/轮询、结果文件和计费单位。
3. 如果优先接文本/多模态,需要从智谱、阿里、Kimi 等候选中选出第一个可测试供应商。
其余本轮信息已经足够启动 D4;未确定的供应商和模型可以继续用 Mock 和可替换配置推进。