From a3273ca58157b3a938c6d414e7b2ed123b0fd268 Mon Sep 17 00:00:00 2001 From: iven Date: Sat, 9 May 2026 01:35:53 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20V1=20=E5=AE=A2=E6=88=B7=E6=BC=94?= =?UTF-8?q?=E7=A4=BA=E6=96=B9=E6=A1=88=E8=AF=84=E5=AE=A1=E4=BF=AE=E8=AE=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 根据规格评审反馈补充： - 硬件/网络要求 + 角色切换指引 - Q&A 异议处理话术（6 个常见问题） - DRY RUN 计划（D-7 到 D-Day） - 扩展风险预案（告警权限码、SSE、Ollama、登录冲突） - 场景 2 AI 触发入口操作说明 - 场景 7 背景数据要求 - 统一 CRITICAL 数量和完成度口径 --- ...2026-05-09-v1-customer-demo-plan-design.md | 74 ++++++++++++++++++- 1 file changed, 71 insertions(+), 3 deletions(-) diff --git a/docs/superpowers/specs/2026-05-09-v1-customer-demo-plan-design.md b/docs/superpowers/specs/2026-05-09-v1-customer-demo-plan-design.md index 58b34f9..57f803a 100644 --- a/docs/superpowers/specs/2026-05-09-v1-customer-demo-plan-design.md +++ b/docs/superpowers/specs/2026-05-09-v1-customer-demo-plan-design.md @@ -1,12 +1,12 @@ # V1 客户演示方案设计规格 -> 日期: 2026-05-09 | 状态: Draft | 类型: 演示方案 +> 日期: 2026-05-09 | 状态: Draft v2 | 类型: 演示方案 ## 1. 背景与目标 ### 1.1 为什么做这次演示 -HMS 健康管理平台已完成核心功能开发（697 次提交，85% 完成度），进入 V1 发布阶段。需要面向潜在客户（体检中心/血透中心）进行产品演示，目标是： +HMS 健康管理平台已完成核心功能开发（700+ 次提交，V2 审计 85% 完成度），进入 V1 发布阶段。需要面向潜在客户（体检中心/血透中心）进行产品演示，目标是： - **打动决策者签约** — 展示业务价值，而非功能清单 - **收集真实反馈** — 了解客户实际工作流中的痛点，指导 V2 迭代 @@ -17,7 +17,7 @@ HMS 健康管理平台已完成核心功能开发（697 次提交，85% 完成 | 指标 | 状态 | |------|------| | 核心链路 | 11 条端到端链路已验证通过 | -| 已知 CRITICAL | 1 个未修复（Token 刷新竞态） | +| 已知 CRITICAL | 1 个未修复（Token 刷新竞态）；其余 CRITICAL（告警权限码拼写、晚间血压丢失、仪表盘 500）均已修复 | | 角色测试通过率 | 84.6%（R01-R05） | | Web 前端 | 55 路由，283 文件，最完整的端 | | 小程序 | 59 页面，118 文件，代码完整 | @@ -80,6 +80,34 @@ HMS 健康管理平台已完成核心功能开发（697 次提交，85% 完成 | 小程序真机扫码失败 | 准备 15 秒录屏视频展示关键页面 | | 后端服务崩溃 | 演示前重启一次确保干净状态 | | 数据库连接断开 | 提前验证 Docker PostgreSQL 健康状态 | +| 告警权限码 bug | 演示前验证 AlertDashboard.tsx 权限码已修复（`health.alerts.manage`） | +| SSE 长连接断开 | 录制 30 秒 AI 分析过程视频备用 | +| Ollama 模型未加载 | 环境检查清单加入 `ollama list` 确认 qwen3:4b 已就绪 | +| 多角色登录冲突 | 使用多个 Chrome Profile，每个角色一个独立 Profile | +| 演示超时 | 标注可跳过场景（场景 6 可一句话带过） | + +### 3.5 硬件与网络要求 + +| 项 | 要求 | +|------|------| +| 投影仪/大屏 | 分辨率 ≥ 1920x1080 | +| 网络 | 演示机器与服务器在同一局域网，延迟 < 10ms | +| 浏览器 | Chrome ×2 个 Profile（Web 端两个角色并行），或双屏方案 | +| 手机 | 安装微信，可扫小程序码（备用：开发者工具投屏） | +| 服务器 | 后端 + PostgreSQL + Ollama 运行在同一台机器，避免网络依赖 | + +### 3.6 角色切换指引 + +| 切换点 | 操作 | 预计耗时 | +|--------|------|----------| +| 场景 1→2 | nurse1 退出 → admin 登录 | 15 秒 | +| 场景 2→3 | admin 退出 → doctor1 登录 | 15 秒 | +| 场景 3→4 | Web → 微信开发者工具/手机 | 10 秒 | +| 场景 4→5 | 小程序录入 → Web nurse1 告警 | 10 秒 | +| 场景 5→6 | nurse1 退出 → health_mgr 登录 | 15 秒 | +| 场景 6→7 | health_mgr 退出 → admin 登录 | 15 秒 | + +**建议：** 准备 2 个 Chrome Profile（Profile A: nurse1/admin，Profile B: doctor1/health_mgr），减少登录切换。场景 4/5 用独立手机或开发者工具。总切换时间约 1-1.5 分钟。 ## 4. 演示脚本 @@ -126,6 +154,11 @@ HMS 健康管理平台已完成核心功能开发（697 次提交，85% 完成 **突出能力：** AI 自动分析、趋势发现、主动建议生成 +**重要说明：** 当前 Web 端 AI 分析触发入口有限（审计报告指出"仅历史查看有 UI，分析触发无入口"）。演示前**必须**执行以下操作之一： +- 方案 A：演示前通过 API 手动触发一次分析（`POST /api/v1/ai/analysis/...`），演示时展示已生成的结果 +- 方案 B：为演示临时添加一个「触发分析」按钮到患者详情页 +- 推荐方案 A，配合话术调整："这是系统刚才自动生成的分析结果" + **预案：** AI 分析慢或失败 → 展示预置截图，口头说明"接入云端大模型后速度更快" --- @@ -233,6 +266,8 @@ HMS 健康管理平台已完成核心功能开发（697 次提交，85% 完成 **突出能力：** 运营数据可视化、管理质量量化、内容运营 +**重要说明：** 单个患者（张大爷）的数据不足以支撑仪表盘的说服力。演示前**必须**预置 20-30 个背景患者数据 + 若干随访/告警记录，让仪表盘显示有意义的统计数字。在数据预置脚本中一并处理。 + --- ### 收尾（5 分钟） @@ -276,3 +311,36 @@ HMS 健康管理平台已完成核心功能开发（697 次提交，85% 完成 | 多科室支持 | 客户反馈 | 当前以肾病/体检为主，其他科室扩展 | | 微信服务号推送 | 场景 4 | 小程序消息触达有限，服务号更灵活 | | 设备直连 | 场景 5 | 血压计/血糖仪 BLE 直连小程序 | + +## 7. Q&A 异议处理 + +### 客户可能提出的问题及建议回答 + +**Q: 能不能对接我们现有的 HIS/EMR 系统？** +> HMS 提供标准 FHIR R4 接口和 RESTful API，支持 HL7 标准数据交换。具体集成方案需要了解贵院 HIS 的品牌和版本，我们可以安排技术团队做接口评估。通常 2-4 周可以完成基础对接。 + +**Q: 患者数据安全如何保障？** +> 数据存储采用 PII 加密（姓名/身份证/手机号等敏感字段加密存储），多租户隔离确保不同机构数据完全独立。系统支持私有化部署，数据不出院。后端使用 Rust 语言开发，天然免疫内存安全漏洞。 + +**Q: AI 分析的准确率如何？** +> 当前 AI 模块定位是「辅助筛查」，发现异常趋势后由医生做最终决策。不是替代医生诊断，而是帮医生从海量数据中找到需要关注的患者。所有 AI 建议都需要医生审批才生效。 + +**Q: 部署方式有哪些？** +> 支持 SaaS（按年付费，我们运维）和私有化部署（一次性 + 年维护费，部署在客户服务器）。SaaS 适合快速上线，私有化适合数据合规要求高的机构。 + +**Q: 价格怎么算？** +> 根据机构规模（管理患者数、医护账号数）定制方案。演示后我们可以根据贵院的具体需求出一份详细报价。 + +**Q: 医护人员需要培训多久？** +> 系统设计遵循「零培训」理念——医生工作台只展示待办，护士录入界面跟纸质表单一样直观。通常 30 分钟上手，1 天熟练。我们提供远程培训和操作手册。 + +## 8. DRY RUN 计划 + +| 阶段 | 时间 | 内容 | +|------|------|------| +| D-7 | 演示前 7 天 | 修完 P0 问题（Token 刷新、AI 触发入口验证） | +| D-5 | 演示前 5 天 | 编写数据预置脚本，预置张大爷完整数据 | +| D-3 | 演示前 3 天 | 第一次 DRY RUN：完整走 7 个场景，记录阻塞点 | +| D-2 | 演示前 2 天 | 修复 DRY RUN 发现的问题，预置 20-30 个背景患者数据 | +| D-1 | 演示前 1 天 | 第二次 DRY RUN（带投影/网络），确认全链路无阻塞 | +| D-Day | 演示当天 | 提前 1 小时启动环境，30 分钟前最终冒烟 |