# AI 合同平台 P1 首次价值、Onboarding 与市场入口实施报告

日期：2026-08-23  
范围：起草漏斗与耗时、10 人研究准备、P1-05、P1-08

## 1. 结论

本轮已把“3 分钟首次价值”从界面目标变成可采集、可汇总、可审计验证的产品指标，并完成分角色 3 步新手引导、工作空间主体名称复用、公开首页增强和四个行业解决方案页。

工程 E2E 在超级管理员会话中完成一次货物采购草稿，系统记录耗时 2.7 分钟，漏斗为开始 1、生成 1、失败 0、放弃 0。该结果只证明实现链路有效；真人目标用户研究仍为 0/10，不能据此宣布 KPI 已达成。

## 2. 起草漏斗与隐私设计

新增持久化事件表 `product_experience_events` 和迁移 `20260823_0048`。事件使用租户与用户上下文，采用 `(tenant_id, user_id, idempotency_key)` 唯一约束，避免重试重复计数。平台管理员看板只返回跨租户汇总，不返回租户、用户或合同标识，使分属不同测试工作空间的 10 名参与者仍能进入同一研究统计。

允许的主要事件：

- `draft_guide_started`
- `draft_step_completed`
- `draft_generated`
- `draft_generation_failed`
- `draft_abandoned`
- `onboarding_started`
- `onboarding_goal_selected`
- `onboarding_step_completed`
- `onboarding_completed`
- `onboarding_dismissed`

事件只允许模板编号、步骤、耗时、来源和匿名研究编号。请求模型禁止额外字段；合同正文、表单值、邮箱、客户名称和 AI 输入无法通过该接口写入。

管理员页面 `/admin/product-analytics` 展示：

- 开始/生成、完成率、放弃与失败；
- 中位和 P75 生成耗时；
- 3 分钟达标数量与比例；
- 唯一起草用户；
- 按模板完成率和中位耗时；
- 10 人研究开始与完成人数。

## 3. P1-05 新用户引导

工作台新增可收起、可恢复、可持久化的三步引导。用户先选择“起草首份合同、审查已有合同、建立团队流程”，系统根据角色和工作空间给出推荐目标：

- 业务/个人优先起草；
- 法务/审批人优先审查；
- 组织管理员优先团队流程；
- 个人空间 owner 不被误导进入平台管理任务。

引导完成后展示“查看结果”和“处理下一份”入口，解决首个结果后不知道下一步的问题。

起草页新增“复用工作空间主体”按钮。系统只在模板存在明确甲方/买方/委托方等字段时提供按钮，由用户确认后填入当前工作空间名称，不自动猜测合同角色。

## 4. P1-08 市场化首页与行业解决方案

公开首页增加：

- 四个行业场景入口；
- 货物采购脱敏产品样例；
- 更明确的数据隔离、AI 人工复核和政策入口；
- 产品支持与团队试点 CTA；
- “当前工程证据”和“客户证据待设计伙伴验证”的显著区分。

新增四个公开解决方案页：

- `/solutions/procurement-supply`
- `/solutions/technology-saas`
- `/solutions/labor-service`
- `/solutions/cooperation-investment`

每页包含场景痛点、三步工作流、脱敏输入/输出示例、适用边界，以及指向真实模板或注册页面的 CTA。页面不声明未实施的价格、额度、法律服务结果或客户 ROI。

“申请团队试点”和“获得产品支持”使用已经在正式政策与失败接管流程中出现的 `admin@yuqei.com`。没有建立未经授权的外部 CRM 或自动邮件发送。

## 5. 10 人可用性测试

执行包位于 `project-docs/usability-testing/P1-3MIN-20260823/`，包括：

- 目标和退出标准；
- 4/3/2/1 样本配额；
- `P01` 至 `P10` 匿名任务链接；
- 邀请模板；
- 主持流程、提示规则、任务后问题；
- 参与者状态与结果 CSV。

尚未完成：真实招募、明确同意和 10 人执行。缺少参与者联系人、可外部访问的受控环境地址和被授权的发送渠道，因此本轮没有虚构或擅自发送邀请。

## 6. 验证证据

自动化：

- Contract Web 单元测试全部通过，新增产品事件隐私 allowlist 和角色引导测试；
- TypeScript 类型检查通过；
- Next.js 生产构建通过，共生成 112 个页面；
- Contract API 产品分析、模板、正文质量门和 P0 关键旅程专项 17 项通过；
- 全新 SQLite 数据库从空库升级到 `20260823_0048` 成功。

Chrome 真实回归：

- 超级管理员工作台显示推荐“建立团队流程”的三步引导；
- 公开首页对登录用户仍可访问，并提供工作台入口；
- 四个行业场景入口和采购解决方案页可访问；
- 工作空间主体名称通过显式按钮填入甲方字段；
- 完成 4 步、24 个必填字段并生成合同 `contract-16d01ce91901`；
- 管理员漏斗显示 1/1、完成率 100%、中位 2.7 分钟、3 分钟达标率 100%；
- 模板统计文案由错误的“类型分组 30”修正为“业务领域 6”。

## 7. 下一步与门禁

1. 用户提供或指定 10 名参与者和邀请渠道，并给出可访问测试环境的 `{BASE_URL}`。
2. 由研究负责人逐人取得同意、执行测试并更新 `participants.csv`。
3. 达到 10 人后，以管理员漏斗计算系统耗时，以主持记录判断无指导成功人数。
4. 若未达到 8/10 或中位超过 3 分钟，按模板和步骤定位最高流失点，优先修复 P0/P1 可用性问题后再测。
5. 客户名称、Logo、引用和 ROI 只有在真实设计伙伴完成验证并书面授权后才能加入公开首页。