Skip to content
dongmingzhPublic

About

帮助外科团队进行患者围术期管理,从术前检查、手术安排、术后病理到随访的全流程,医生患者双向同步提醒流程,提高日常工作效率。A perioperative workflow platform for surgical teams, covering pre-op exams, surgery, pathology and follow-up.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ThorFlow

胸外科围术期医患流程协同平台

CI Live Preview MIT License

Live Preview / 在线体验

ThorFlow 是胸外科围术期流程协同平台:医生可以看清每位患者当前进度,患者可以收到下一步提醒,系统将检查、手术、病理和随访连成完整流程。

ThorFlow 社交预览图

项目简介

ThorFlow 想解决一个很具体的问题:胸外科患者从门诊发现、术前检查、安排手术、进入手术室、术后监护、病理结果到随访,过程很长,信息分散在医生、护士、患者、家属、检查单、微信群和医院系统之间。只要一个节点没人提醒,就容易拖慢流程,患者也会焦虑。

ThorFlow 将这些环节整理成一条清晰的数字化流程:医生端像调度台一样查看全局,患者端像小程序一样告知下一步操作,中间由 Workflow Engine 生成任务、通知和随访计划。

当前版本为本地产品原型,不连接真实医院系统、真实微信小程序或生产 AI 服务。所有患者信息都是匿名示例数据,例如“患者A、患者B”。

系统组成

医生端

医生端是 Web / Desktop Workflow OS,重点不是“登记患者”,而是“控制流程”。它展示每个患者在哪个池子里、谁需要处理、哪个节点超时、下一步该由谁动作。

患者端

患者端是手机小程序模拟。它不追求信息密度,而是追求清楚、温和、可执行:今天做什么、还差什么、医生说了什么、什么时候复查。

Workflow Engine

Workflow Engine 是本地 TypeScript 逻辑,负责模拟:

  • 患者状态流转
  • timeline 事件生成
  • 患者端通知生成
  • 检查单识别后生成任务
  • 根据病理和分期生成随访计划

现在它使用本地 mock 数据和浏览器存储,后续可以接 Supabase、医院数据库、PACS、EMR 或真实通知系统。

界面预览

医生端:胸外科流程控制台

医生打开 /dashboard 后,不是看到一张普通患者表,而是看到各个流程池:待报道、待检查、待审核、待安排手术、今日手术、ICU、待病理、待随访、超时异常等。

医生端流程控制台

医生端:患者详情与围术期 Timeline

进入患者详情页后,左侧是基础信息,中间是完整围术期 timeline,右侧是当前待办和关键操作。医生可以标记进入手术室、手术完成、转入 ICU、回病房、录入病理并生成随访计划。

患者详情与围术期 Timeline

患者端:手机小程序模拟

患者看到的是一个更温和、更清楚的小程序界面。它不会把复杂医学流程直接丢给患者,而是告诉患者:现在处于什么阶段、下一步做什么、医生有什么新通知。

患者小程序首页 患者小程序待办

它解决什么问题?

1. 少靠人脑记流程

传统流程里,医生和护士经常要靠微信群、纸质单、口头交接来记患者进度。ThorFlow 把每个患者放进对应流程池,让团队一眼知道谁还没报道、谁检查没做完、谁已经等医生审核、谁今天手术、谁还没录病理。

2. 少漏关键节点

胸外科围术期常见漏点包括:检查做完但医生不知道、手术安排后患者没收到清晰通知、术后 ICU/回病房状态没有同步、病理出来后忘记生成随访计划。ThorFlow 用 timeline、任务和通知把这些节点串起来。

3. 让患者更安心

患者最焦虑的往往不是“流程复杂”,而是不知道自己现在到哪一步、还差什么、什么时候手术、下一次复查什么时候。患者端小程序用简单语言告诉患者下一步行动,减少反复打电话和群里追问。

完整工作流程

  1. 患者扫码报道
  2. 填写基本信息
  3. 上传术前检查单
  4. 系统模拟 AI 识别检查项目
  5. 患者逐项完成增强 CT、肺功能、心电图、血常规、凝血、肝肾功能、麻醉评估等检查
  6. 医生端收到“检查已完成,等待审核”的提醒
  7. 医生安排手术日期
  8. 患者端收到手术通知
  9. 医生标记进入手术室、手术完成、转入 ICU/监护室、转回病房
  10. 患者端同步收到状态通知
  11. 医生录入病理类型、分期和治疗建议
  12. 系统生成随访计划
  13. 患者端看到复查时间表和医生提醒

主要页面

页面 给谁看 说明
/dashboard 医生 / 管理者 胸外科流程控制台,查看所有 workflow pools
/dashboard/preop 医生 查看术前检查完成情况和审核提醒
/dashboard/surgery 医生 查看今日手术排班和手术状态
/dashboard/pathology 医生 录入病理、分期和辅助治疗建议
/dashboard/followup 医生 查看今日随访和 AI 生成的复查提醒
/patient/PT-1004 医生 单个患者详情、timeline、AI 分析、关键操作
/patient-mini 患者 小程序首页,查看当前阶段和下一步
/patient-mini/tasks 患者 上传检查单并完成检查任务
/patient-mini/notifications 患者 查看手术、ICU、病理、随访通知
/patient-mini/followup 患者 查看随访计划和复查安排

推荐体验路径

建议按以下顺序体验完整流程:

  1. 打开 /dashboard:查看医生端全局流程池
  2. 打开 /patient-mini:查看患者当前阶段和医生通知
  3. 打开 /patient-mini/tasks:体验上传检查单和 AI 识别检查项目
  4. 打开 /dashboard/preop:查看医生端收到术前检查完成提醒
  5. 打开 /patient/PT-1004:查看患者详情、timeline 和关键操作
  6. 打开 /dashboard/pathology:体验录入病理和分期
  7. 打开 /patient-mini/followup:查看患者端随访计划

如何体验 ThorFlow

方式一:直接在线体验(最推荐)

如果你只想看看 ThorFlow 能做什么,不需要下载,也不需要安装软件。直接点击:

ThorFlow 在线体验

方式二:用终端快速下载和启动

如果电脑已经安装了 Node.js 和 Git,打开终端,依次复制下面四行命令即可:

git clone https://github.com/dongmingzh/thorflow.git
cd thorflow
npm install
npm run dev

看到 Ready 后,打开浏览器访问:

http://localhost:3000/dashboard

如果不知道自己是否安装过 Node.js 和 Git,或者执行时提示命令不存在,请直接使用下面的方式三。

方式三:从零开始在自己的电脑上运行

下面的操作不需要会编程。终端就像一个用文字控制电脑的窗口,按步骤复制命令即可。

第 1 步:安装 Node.js

打开 Node.js 官方网站,下载并安装标有 LTS 的版本。整个过程和安装普通软件一样,按默认选项继续即可。

安装完成后,关闭并重新打开终端:

  • Mac:按 Command + 空格,搜索“终端”并打开。
  • Windows:打开开始菜单,搜索“终端”或“PowerShell”并打开。

在终端里输入下面的命令,然后按回车:

node -v

如果看到类似 v22.0.0 的版本号,就说明安装成功了。

第 2 步:下载 ThorFlow

  1. 打开 ThorFlow GitHub 页面。
  2. 点击页面上方绿色的 Code 按钮。
  3. 点击 Download ZIP。
  4. 下载完成后,双击 ZIP 文件解压,会得到一个名为 thorflow-main 的文件夹。

第 3 步:让终端进入项目文件夹

在终端输入 cd,再按一次空格键,先不要按回车。

然后用鼠标把刚才解压得到的 thorflow-main 文件夹直接拖进终端窗口,再按回车。这样不用自己输入一长串文件路径。

第 4 步:完成首次安装

复制下面这条命令到终端,按回车,等待安装完成:

npm install

第一次安装可能需要几分钟。只要终端没有出现红色报错,就耐心等待它完成。

第 5 步:启动 ThorFlow

继续在同一个终端窗口输入:

npm run dev

看到 Ready 后,打开浏览器,访问:

http://localhost:3000/dashboard

使用期间请保持终端窗口开着。使用完成后,回到终端按 Control + C 即可停止。

以后再次打开

以后不需要重复安装。只需打开终端,再次用“cd + 拖入文件夹”的方法进入 thorflow-main,然后运行:

npm run dev

常见问题

  • 提示 command not found: npm:Node.js 没有安装成功,重新安装 LTS 版本后再打开终端。
  • 提示 command not found: git:电脑没有安装 Git,直接使用方式三下载 ZIP 文件即可。
  • 提示找不到 package.json:终端没有进入正确文件夹,重新执行“cd + 拖入 thorflow-main 文件夹”。
  • 提示 3000 端口已被占用:ThorFlow 可能已经在运行,先直接打开 http://localhost:3000/dashboard 试试。

常用命令

npm run dev      # 启动本地开发服务
npm run build    # 检查能否正常生产构建
npm run start    # 运行生产构建后的服务
npm run lint     # 运行 ESLint 检查

技术栈

  • Next.js 16 App Router
  • React 19
  • TypeScript
  • Tailwind CSS 4
  • lucide-react
  • framer-motion
  • 本地 mock data + localStorage 模拟工作流状态

目录结构

app/
  dashboard/              医生端流程控制台页面
  patient/[id]/           医生视角的患者详情页
  patient-mini/           患者小程序模拟页面

components/
  dashboard/              医生端看板组件
  patient/                患者详情、timeline、病理、手术操作组件
  patient-mini/           小程序外壳、首页、待办、通知、随访组件
  workflow/               通用工作流页面组件
  providers/              本地 workflow 状态 provider
  ui/                     基础 UI 组件

lib/
  mock-data.ts            匿名示例患者数据
  workflow-engine.ts      状态流转、通知、任务、随访计划逻辑
  workflow.ts             看板与 timeline 辅助逻辑
  followup-templates.ts   随访计划模板
  notification-templates.ts

数据与合规说明

  • 项目中不应提交真实患者信息。
  • 当前患者名称统一使用“患者A、患者B、患者C”等匿名格式。
  • 电话、住院号、检查结果均为模拟数据。
  • 项目不是医疗器械,也不能用于真实临床决策。
  • AI 识别、影像预览、通知推送、随访计划均为本地原型能力,尚未接入真实临床系统。

后续可以继续升级的方向

  • 接入 Supabase 或真实后端数据库
  • 增加医生、护士、麻醉、ICU、随访专员等角色权限
  • 增加真实消息适配层,如短信、企业微信、医院小程序
  • 增加可配置的病理模板和随访规则
  • 增加操作审计日志,记录每次状态变更
  • 增加一键重置,方便测试和重复体验

GitHub

https://github.com/dongmingzh/thorflow

License

MIT License. See LICENSE for details.

About

帮助外科团队进行患者围术期管理,从术前检查、手术安排、术后病理到随访的全流程,医生患者双向同步提醒流程,提高日常工作效率。A perioperative workflow platform for surgical teams, covering pre-op exams, surgery, pathology and follow-up.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages