Files
ai-contract-platform/project-docs/V2-core-product-launch-closeout-2026-08-25.md
T
yuqei 1d85329a6a
Build and Test Quality Gate / Contract Web typecheck and build (pull_request) Successful in 9m12s
Build and Test Quality Gate / Isolated Alibaba and Tencent KMS gateway (pull_request) Failing after 4m53s
Build and Test Quality Gate / Python tests and Contract API migration (pull_request) Failing after 24m55s
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 8m42s
feat: deliver governed contract platform and async AI tasks
2026-08-26 12:53:47 +08:00

7.3 KiB
Raw Blame History

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.json
  • project-docs/qa-artifacts/core-launch-readiness/2026-08-25T22-31-37/core-journeys-junit.xml
  • project-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 和完整日志。检查项按三类分组:

  1. engineering:服务健康、公共页面、运行配置、核心合同旅程;
  2. external_material:真实模型披露、Provider 验收、正式政策;
  3. 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:

  1. controlled-pilot 门禁整体 status=pass;
  2. 真实模型公开披露为 ready;
  3. Provider 验收证据已验证;
  4. 四份非 draft 正式政策已生效,注册同意证据可追踪;
  5. 固定主旅程回归无失败;
  6. 试点租户、数据边界、支持负责人和退出方案已具名确认。

真实双云 UAT 不在上述清单中;只有付费企业客户、外部审计或跨云灾备明确要求时,才重新进入 P1-07.7。