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

8.7 KiB
Raw Blame History

信息准备与阶段门禁清单

一、先看结论

产品文档中的“待确认事项”是完整的长期输入清单,不代表现在必须一次性提供。模亦灵枢采用分阶段准备:

时间点 必须掌握的信息 可以暂时不确定
当前进入 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,你可以按下面 8 项回复,暂时不知道的写“待定”即可:

  1. 第一个开发环境管理员登录账号。
  2. 首个真实验收方式:HTTP、SDK 或某个 AI 应用接入。
  3. 是否先用 Mock 完成 Key/模型目录,再接真实供应商。
  4. 首个准备接入的模型类型,建议先选一个同步模型和一个异步/3D 模型。
  5. 是否已有可用于测试的供应商或 AI SoulMate 接口。
  6. 测试环境准备在本机、现有服务器,还是另建测试服务器。
  7. 第一轮内部测试预计几个人、几个项目。
  8. 是否接受当前默认规则:邀请码、管理员额度、暂不支付、公开注册后置。

除第 1—3 项外,其余都可以先填“待定”,我们继续用 Mock 和可替换配置推进。