7.3 KiB
V2 核心产品上线收口实施与验收报告
日期:2026-08-25
范围:首发合同主旅程、真实模型与合规配置、核心发布门禁、受控试点准备
决策:P1-07.7 双云基础设施扩展暂缓,不作为核心上线门禁
1. 阶段结论
当前结论必须分两层表达:
- 核心工程链路通过:19 项固定主旅程回归和 31 项合同产品 golden 技术用例全部通过,Web、Contract API、AI Platform API 健康,首页和四个政策入口可访问;
- 真实用户受控试点尚未放行:真实模型披露、Provider 质量/法务验收和四份正式政策尚未形成有效证据;
- 双云不阻断:外部可信模式为
disabled,门禁记录为skip / required=false / dual_cloud_required=false; - 不得误报:当前 mock 模型、开发签名和模拟电子签署仅用于本地验证,不得表述为真实生成式 AI 服务、可靠电子签名或第三方存证。
最近一次受控试点门禁证据:
project-docs/qa-artifacts/core-launch-readiness/2026-08-25T22-31-37/core-launch-readiness-summary.jsonproject-docs/qa-artifacts/core-launch-readiness/2026-08-25T22-31-37/core-journeys-junit.xmlproject-docs/qa-artifacts/core-launch-readiness/2026-08-25T22-31-37/contract-product-golden/contract-product-golden-summary.json
门禁结果为 blocked_external,同时 core_engineering_ready=true、external_pilot_ready=false。
2. 新增核心发布门禁
新增 yuqei-infra/scripts/run-core-launch-readiness.py,提供三种检查档位:
| 档位 | 用途 | 外部材料缺失行为 |
|---|---|---|
development |
本地开发、持续回归 | warning,不阻断工程开发 |
controlled-pilot |
准备邀请真实试点用户 | fail closed,禁止开放 |
production |
正式生产发布 | 所有核心运行警告与外部材料均严格检查 |
每次执行统一输出 JSON、Markdown、JUnit XML 和完整日志。检查项按三类分组:
engineering:服务健康、公共页面、运行配置、核心合同旅程;external_material:真实模型披露、Provider 验收、正式政策;optional_enterprise:双云 KMS 探针、不可变见证与外部锚定。
工程错误与外部材料缺失不再混成一个“发布失败”。若工程通过而外部材料不足,状态固定为 blocked_external,可以继续开发,但不能开放真实用户流量。
3. 首发主旅程回归范围
固定主旅程回归运行 19 项测试,另执行 31 项确定性合同产品 golden 技术用例,覆盖:
- 30 个已发布模板的最少必填和全字段正文编译;
- 占位符、内部规则编号和护栏话术净化;
- 不合格正文禁止下载和提交审批;
- 审批绑定合同版本和正文哈希,正文变化使旧审批失效;
- 提交人和审批人职责分离;
- 合同跨租户隔离及个人租户 review worker 显式上下文;
- 文件上传后直接发起审查,审查结果正确回写;
- Provider 调用链和 AI Trace 持久化;
- 审查失败重试、人工接管、correlation ID 与通知留痕;
- 国内电子签署连接器的幂等、脱敏、租户隔离和模拟证据哈希;
- mock 模型必须阻断对外披露,真实模型只有材料齐备才显示 ready。
本次结果:主旅程 19 passed / 0 failed / 0 errors;合同产品 golden 31 technical passed / 0 failed / 0 unresolved placeholders。31 项 golden 仍全部标记 needs_legal_review,技术通过不代表法务批准。
4. 运行态漂移修复
首次门禁发现 AI Platform 源码已注册公开披露接口,但运行进程加载了旧临时工作树中的可编辑安装,导致接口返回 404。
已完成:
- AI API 改为使用
uvicorn ... --app-dir src从当前工作区启动; - 核心回归执行器显式把 Contract API、AI Platform API 和 Python SDK 当前
src目录加入PYTHONPATH; - 公开披露接口缺失或返回错误契约时,门禁归类为必需的工程失败,不再降级成普通合规提醒。
该调整防止旧安装路径造成“测试通过但实际代码未部署”的假阳性。
5. 当前四组真实试点阻断项
5.1 试点环境身份与反滥用保障
当前身份邮件仍使用 development 投递行为,身份限流使用开发兜底密钥,反滥用控制为 disabled。三项不会阻断本地开发,但在 controlled-pilot 和 production 档位合并为 pilot_operational_safeguards 阻断项。
5.2 真实模型与生成式 AI 披露
当前公开披露显示 provider=mock、model=legal-qa-mvp,真实 Provider 调用未启用,备案/上线登记号、隐式标识服务提供者编码和生产标识链路尚未配置。
5.3 Provider 质量与法务验收
AI readiness 当前为 needs_review,虽无代码级阻断,但 provider_acceptance_verified=false。必须在共享预发布环境用真实模型跑黄金集,并由具名法务完成验收和签名收据。
5.4 四份正式政策
当前没有生效的 user_terms、privacy_policy、service_agreement、ai_use_notice。注册继续 fail closed,不能使用 draft 文本或伪造律师审批绕过。
6. 一页式受控试点材料清单
产品负责人只需准备下表,不需要配置阿里云或腾讯云:
| 材料 | 需要提供的内容 | 负责人 | 当前状态 |
|---|---|---|---|
| 真实模型 | Provider、模型名称、API 接入负责人 | 产品/技术 | 待提供 |
| 模型合规编号 | 备案号或上线登记号;没有时由法务确认适用路径 | 法务 | 待确认 |
| 隐式标识编码 | 服务提供者编码及文件标识验收结论 | 技术/法务 | 待提供 |
| 质量验收 | 真实模型黄金集结果、风险项、法务签字 | AI/法务 | 待执行 |
| 用户协议 | 最终正文、版本、发布时间、生效时间、律师审批 | 法务 | 待批准 |
| 隐私政策 | 同上,并明确模型/云供应商、保存期和用户权利 | 法务 | 待批准 |
| 服务协议 | 最终正文和服务边界 | 法务/产品 | 待批准 |
| AI 使用说明 | AI 辅助边界、人工复核、标识和投诉方式 | 法务/产品 | 待批准 |
| 身份邮件 | 企业发信邮箱、发件人和验证码/重置邮件实发验收 | 运维 | 待配置 |
| 限流与反滥用 | 独立随机密钥、Redis 可用性和试点配额 | 运维/安全 | 待配置 |
| 试点名单 | 租户名称、业务负责人、合同场景、人数 | 销售/产品 | 待选择 |
| 数据边界 | 是否允许真实合同、脱敏要求、保留期限、退出删除 | 安全/客户 | 待确认 |
技术人员取得这些材料后再写入现有生产/预发布配置和受控发布流程;业务负责人无需填写复杂云厂商模板。
7. 受控试点放行标准
只有同时满足以下条件,才能把 external_pilot_ready 改为 true:
controlled-pilot门禁整体status=pass;- 真实模型公开披露为
ready; - Provider 验收证据已验证;
- 四份非 draft 正式政策已生效,注册同意证据可追踪;
- 固定主旅程回归无失败;
- 试点租户、数据边界、支持负责人和退出方案已具名确认。
真实双云 UAT 不在上述清单中;只有付费企业客户、外部审计或跨云灾备明确要求时,才重新进入 P1-07.7。