salthepal/WashUSimIntelligence
GitHub: salthepal/WashUSimIntelligence
华盛顿大学急诊医学系开发的临床模拟智能管理平台,用于AI辅助报告生成、潜在安全隐患跟踪和机构级学习。
Stars: 1 | Forks: 0
# WashU Sim Intelligence
**WashU Sim Intelligence** 是为**华盛顿大学医学院急诊医学系**开发的模拟改进与潜在安全隐患管理平台。
该平台帮助模拟团队将高保真临床场景转化为可用的安全成果:结构化的会后报告、可靠的 LST 识别、后续跟踪、可搜索的机构级学习,以及可与教育工作者、安全负责人和运营利益相关者共享的文档。
**当前版本:v3.9.0** — 支持灵活选择 Provider 的 AI 报告起草、案例摘要上下文、重新设计的临床工作区、持久化的深色模式,以及强化的 Cloudflare 部署路径。
## 🏛️ 项目概述
WashU Sim Intelligence 专为需要超越书面总结报告的临床模拟项目而设计。它支持**公正文化** 方法,帮助团队记录发生的情况、识别系统漏洞、分配后续工作,并在多次模拟中保留经验教训。
该系统围绕模拟项目的实际工作流而设计:
- 捕获会话期间发生的情况。
- 生成专业的会后报告。
- 识别并分类 LST。
- 跟踪缓解状态和机构后续行动。
- 跨既往会话、场景和安全发现进行搜索。
- 导出包含支持性照片和媒体的整洁文档。
### 核心功能
* **🏥 LST 识别与管理**:对**潜在安全隐患**进行集中跟踪,包含类别、严重程度、状态、缓解记录和机构审计历史。
* **📋 模拟报告生成**:将会话记录转化为基于模拟教育、安全改进和公正文化原则的专业报告。
* **✅ 后续工作流支持**:在会话结束后让安全发现保持可见,以便审查、上报和关闭未解决的隐患。
* **🔍 机构级学习搜索**:跨既往场景、报告和安全发现进行搜索,以识别重复出现的模式和频发的运营风险。
* **📸 会话媒体文档**:附加模拟照片和高分辨率媒体,然后将其作为精美的照片拼图包含在导出的报告中。
* **🤖 Provider 灵活的临床助手**:使用 OpenAI 或 Gemini 进行报告起草和 LST 提取,并基于既往模拟证据进行检索,以支持更快的综合分析。
* **🧾 案例感知起草**:在报告 prompt 中包含简洁的案例文件摘要,使生成的草稿能反映所选场景,同时不会让模型上下文过载。
* **🌗 无障碍临床工作区**:提供响应式临床编辑界面,在整个模拟套件中支持共享且持久化的浅色和深色主题。
## 🏗️ 系统架构
基于 Cloudflare 原生技术栈构建,以实现可靠性、快速访问和安全的临床教育工作流:
- **Frontend**:React (Vite + TypeScript + Tailwind) 部署在 Cloudflare Pages,访问地址为 `https://intel.washuemsim.org`。
- **Backend API**:Cloudflare Workers (Hono) 运行在边缘端。公共的 `workers.dev` 路由已被禁用,Pages Function 代理通过 `WASHU_SIM_INTEL_API` 服务绑定调用 Worker。
- **决策支持**:
- **资料库问答**:基于本地模拟知识库的检索增强回答。
- **报告起草**:通过 **OpenAI Responses API** 或 **Google Gemini** 实现与 Provider 无关的异步流式传输。
- **语义索引**:使用 **Cloudflare Vectorize** 结合 **Workers AI** 实现跨场景、报告和 LST 记录的检索。
- **数据基元**:
- **关系型 SQL**:Cloudflare D1 (`washu_sim_db`)
- **对象存储**:Cloudflare R2 (`washu-sim-intel-storage-2026`)
- **元数据缓存**:Cloudflare KV (`RATELIMIT_V2`)
- **向量索引**:Cloudflare Vectorize (`sim_search`)
## 🛠️ 快速开始
### 前置条件
- **Node.js**:v20 或更高版本。
- **Cloudflare 账号**:需拥有 D1、R2、Vectorize、Workers AI、KV、Pages 和 Workers 的访问权限。
- **密钥**:
- `OPENAI_API_KEY`:用于报告生成、资料库问答和 LST 提取的首选 Provider。
- `GEMINI_API_KEY`:可选的备用 Provider。
- `TURNSTILE_SECRET_KEY`:用于生成端点的垃圾信息防护。
- `ADMIN_TOKEN`:用于受保护的临床数据和管理 API 访问。
### 本地开发
1. **克隆代码库**:
git clone https://github.com/salthepal/WashUSimIntelligence.git
cd WashUSimIntelligence
2. **Frontend 设置**:
npm install
npm run dev
3. **Backend 设置**:
cd worker
npm install
npx wrangler dev
## 🚀 部署
该系统使用 GitHub Actions 进行持续交付:
- **Frontend**:通过 **Cloudflare Pages** 自动部署,并在 `https://intel.washuemsim.org` 上提供服务。
- **Backend**:更新 `worker/wrangler.toml` 中的资源 ID,并在 `worker/` 目录下运行 `npm run deploy`。
- **代理**:生产环境的 `/api/*` 流量通过 Pages Function 服务绑定 `WASHU_SIM_INTEL_API` 传输。仅在本地或紧急测试时使用显式的 `BACKEND_URL`。
- **访问控制**:Cloudflare Access 保护 `intel.washuemsim.org`、`washusimintelligence.pages.dev` 以及 Pages 预览主机名,仅限 `wustl.edu` 用户和已配置的管理员邮箱访问。
有关资源绑定、密钥、迁移和部署检查,请参阅 [DEPLOYMENT.md](./DEPLOYMENT.md)。
## 📦 版本发布
发行说明和版本历史可在 [GitHub Releases](https://github.com/salthepal/WashUSimIntelligence/releases) 和 [CHANGELOG.md](./CHANGELOG.md) 中查看。
## 🔒 安全与治理
- **公正文化**:报告优先考虑成长和系统性修复,而非追究个人责任。
- **数据驻留**:当前生产环境的部署位置为 `ENAM` 的 Cloudflare D1 和 `WNAM` 的 R2。请将此视为仅批准用于非 PHI 模拟安全数据;在接受更严格的驻留要求之前,应迁移到新创建的受司法管辖区限制的资源。
- **管理访问权限**:临床数据的读取和写入需要提供 `X-Admin-Token`。
- **垃圾信息防护**:上传和生成端点受 **Cloudflare Turnstile** 保护。
- **安全响应头**:浏览器保护配置由 `public/_headers` 提供。
- **临床数据处理**:除非您的 Cloudflare 部署已获得相关用途的批准,否则请避免输入患者标识符或受保护的健康信息。
## 📜 许可证
本项目基于 **GNU General Public License v3.0 (GPLv3)** 授权。详情请参阅 [LICENSE.md](./LICENSE.md)。
© 2026 华盛顿大学医学院。急诊医学模拟。
标签:AI报告生成, 临床模拟, 医疗信息化, 医疗质量与安全, 工作流管理, 潜在安全隐患追踪, 程序员工具, 自动化攻击