chore: 初始化医签通前端项目结构与文档

This commit is contained in:
yelan
2026-08-27 10:40:29 +08:00
commit 3f27d4dd3a
47 changed files with 5829 additions and 0 deletions

73
patient-h5/README.md Normal file
View File

@@ -0,0 +1,73 @@
# patient-h5
医签通患者/家属手机签署端,是通过短信或二维码打开的移动 H5 页面。
## 产品定位
patient-h5 只服务于一次或一组知情同意签署,不是完整的移动版电子病历,也不需要患者安装原生 App。
## 用户流程
```text
短信/二维码打开
→ 短信验证码或签署 Token 校验
→ 确认患者和实际签署人
→ 选择与患者的关系
→ 阅读文书
→ 勾选同意/不同意项目
→ 手写签名
→ 提交
→ 显示签署结果
```
## 页面规划
- 签署入口页;
- 身份/手机号验证页;
- 文书阅读页;
- 签署人关系确认页;
- 手写签名页;
- 提交成功页;
- 过期、拒签和异常页。
## 安全要求
- 签署链接使用短时效、不可猜测的 Token
- 后端校验 Token、任务状态和文书版本
- URL 不直接携带身份证号、完整病历等敏感信息;
- 避免在本地长期保存患者信息和签名数据;
- 防止重复提交和重复签署;
- 所有最终状态以服务端结果为准;
- 需要兼容微信、手机浏览器和常见 iOS/Android 浏览器。
## 技术栈规划(不一定全用到)
```text
Vue 3
TypeScript
Vite
Vue Router
Vant
Zod
pdfjs-dist
signature_pad
Vitest
Playwright
```
患者端应采用移动优先设计,按钮、文字和签名区域需要适合老年患者使用。
## 与医护端的关系
医护端创建签署任务patient-h5 完成签署,后端统一保存结果:
```text
clinical-web → 后端签署任务 → patient-h5
patient-h5 → 后端提交签署结果 → clinical-web / 电子病历
```
patient-h5 不直接访问医院完整电子病历。
## 当前状态
当前仅完成目录和说明文档,尚未初始化 Vite。