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

176 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 信息准备与阶段门禁清单
## 一、先看结论
产品文档中的“待确认事项”是完整的长期输入清单,不代表现在必须一次性提供。模亦灵枢采用分阶段准备:
| 时间点 | 必须掌握的信息 | 可以暂时不确定 |
|---|---|---|
| 当前进入 D4 前 | 第一版边界、首个管理员、认证规则、Key 目标、首批真实调用方式 | 供应商最终名单、价格、支付、公开注册、企业认证、正式合规结论 |
| D4 真实供应商联调前 | 至少一个供应商/模型的接口资料、测试 Key、模型能力和限制 | 第二家供应商、复杂路由、最终计费 |
| 测试环境/UAT 前 | 测试部署资源、测试账号、测试模型、测试数据、验收场景、容量假设 | 生产域名、正式支付、最终 SLA |
| 生产开放前 | 运营主体、域名/TLS/备案、供应商授权、数据与合规、计费支付、安全运维和容量 | 后续 MaaS、自托管模型等长期能力 |
## 二、现在必须确认
以下内容是进入 D4 仍需要项目负责人确认的最小集合。没有这些信息,可以继续做 Schema、Mock 和页面;但不能完成真实供应商调用验收。
| 编号 | 需要确认 | 当前状态/默认处理 |
|---|---|---|
| N-01 | 第一版目标用户 | 已确认:先服务模灵科技内部项目,再逐步邀请外部开发者 |
| N-02 | 第一版模型范围 | 已确认:不是只做大语言模型,覆盖文本、图像、音频、视频、Embedding 和生成式 3D |
| N-03 | 第一版准入 | 已确认:邀请码注册;手机号/邮箱公开注册只预留 |
| N-04 | 第一版额度 | 已确认:按人民币 `¥` 计价展示,管理员可发放等值内测额度;充值/套餐入口保留但暂不启用真实支付 |
| 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、工作流和模型评测平台。
- 正式公网域名、品牌营销和大规模容量承诺。
## 七、本轮已确认的 D4 输入
| 项目 | 已确认内容 | 处理方式 |
|---|---|---|
| 开发管理员账号 | `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 后置 |
### 凭证安全说明
本轮提供的管理员密码不会写入文档、代码或 Git。请在本地 `control-plane/.env` 中设置 `ADMIN_PASSWORD`;供应商 API Key、数据库密码和 SDK 凭证同样只通过本地环境变量或服务器密钥管理注入。
## 八、当前待补资料
为了进入真实供应商联调,目前只需要补充下面 3 类资料,暂时不知道的写“待定”即可:
1. 当前需要补充的是首个供应商/模型的 API 文档、测试 Key 和能力限制。
2. 如果优先接 3D,需要补充 VAST/AI SoulMate 的任务接口、回调/轮询、结果文件和计费单位。
3. 如果优先接文本/多模态,需要从智谱、阿里、Kimi 等候选中选出第一个可测试供应商。
其余本轮信息已经足够启动 D4;未确定的供应商和模型可以继续用 Mock 和可替换配置推进。