# create-vue-medical

**Repository Path**: ereddate2017/create-vue-medical

## Basic Information

- **Project Name**: create-vue-medical
- **Description**: Vue 医疗项目脚手架工具，内置 HIPAA 合规性和安全特性，用于快速创建具有内置安全功能和 HIPAA 合规要求的 Vue 3 医疗应用。Vue medical project scaffold with HIPAA compliance.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# create-vue-medical

Vue 医疗项目脚手架工具，内置 HIPAA 合规性和安全特性，用于快速创建具有内置安全功能和 HIPAA 合规要求的 Vue 3 医疗应用。

## 功能特性

### 🏥 医疗应用功能
- ✅ **HIPAA 合规安全头部**（CSP、HSTS、X-Content-Type-Options、X-Frame-Options、X-XSS-Protection）
- ✅ **数据加密** 使用 crypto-js 加密敏感信息
- ✅ **审计日志** 记录用户操作（HIPAA 合规）
- ✅ **基于角色的访问控制** 使用 CASL
- ✅ **安全认证** 带令牌加密
- ✅ **医疗数据验证规则**（患者 ID、SSN、保险号码等）
- ✅ **TypeScript 支持**（可选）
- ✅ **Pinia 状态管理**（可选）
- ✅ **Vitest 测试**（可选）
- ✅ **布局组件**（MainLayout、AuthLayout）
- ✅ **导航系统** 支持认证路由保护
- ✅ **主题支持** 提供明暗主题切换
- ✅ **环境变量** 配置敏感信息
- ✅ **国际化（i18n）支持** 使用 vue-i18n
- ✅ **PWA 支持** 提供离线功能和类应用体验
- ✅ **医疗特定组件**（PatientForm、MedicalDashboard、MedicalChart、MedicalPrescription、MedicalAppointment、MedicalBilling、MedicalRecord、MedicalMedication、MedicalLabResult、MedicalVitalSigns、MedicalImagingViewer）
- ✅ **医疗专科组件**（心内科 ECG 查看器、心率监测器、心输出量计算器、冠心病风险计算器，神经科 MRI 查看器、神经科检查、脑电图查看器、帕金森病评估，眼科视力表、视野检查、眼压测量、视网膜检查，骨科关节活动范围查看器、骨密度检查、骨折评估、关节置换评估与管理）
- ✅ **医疗设备集成**（蓝牙和 USB 设备连接）
- ✅ **性能优化** 带代码分割和包分析
- ✅ **WebAssembly 和 GPU 加速** 用于医学影像处理
- ✅ **语音交互** 用于免手操作
- ✅ **AR/VR 支持** 用于医疗数据可视化
- ✅ **医疗 API 市场** 用于集成各种医疗 API
- ✅ **模板库** 提供预定义的医疗应用模板
- ✅ **零信任架构** 用于增强安全性
- ✅ **区块链集成** 用于不可篡改的医疗数据存储
- ✅ **多地区合规支持**（HIPAA、GDPR 等）
- ✅ **边缘部署** 用于远程医疗场景
- ✅ **混合云支持** 用于增强可靠性

### 🌏 地区合规
- ✅ **HIPAA 合规** 适用于美国医疗运营
- ✅ **GDPR 合规** 适用于欧洲运营
- ✅ **中国合规** 适用于中国医疗法规（网络安全法、数据安全法、个人信息保护法）
- ✅ **多地区合规支持** 适用于全球运营
- ✅ **全部 27 个医疗组件** 完全符合 HIPAA、GDPR 和中国法规要求
- ✅ **访问控制** 所有医疗组件
- ✅ **数据加密** 敏感医疗信息
- ✅ **数据脱敏** 患者隐私保护
- ✅ **审计日志** 所有医疗操作
- ✅ **GDPR 同意管理** 数据处理
- ✅ **GDPR 数据处理记录** 合规跟踪
- ✅ **中国数据本地化** 国内数据存储

### 🔒 安全生态系统
- ✅ **vue-security-scanner** 集成用于静态代码安全分析
- ✅ **vite-plugin-vue-security** 用于构建时安全头部配置
- ✅ **ESLint 安全插件** 用于代码质量和安全检查
- ✅ **安全审计脚本** 过滤误报
- ✅ **.vue-security-ignore** 文件用于自定义安全扫描规则
- ✅ **医疗安全插件** 包含 9 项医疗特定安全规则
- ✅ **安全插件目录** 用于自定义安全扩展

### 🎯 CLI 功能
- ✅ **交互式提示** 用于项目配置
- ✅ **非交互式模式** 带命令行选项
- ✅ **位置参数支持** 用于项目名称
- ✅ **帮助和版本信息**
- ✅ **可定制选项**（TypeScript、Pinia、Vitest）
- ✅ **预设配置**（minimal、standard、full、hipaa、enterprise）用于快速设置
- ✅ **列出可用预设** 用于轻松选择配置

## 安装

### 全局安装（推荐）

```bash
npm install -g create-vue-medical
```

### 本地安装

```bash
npm install create-vue-medical
```

## 使用方法

### 交互式模式

运行命令时不使用选项，进入交互式模式：

```bash
create-vue-medical

# 使用短命令
cvm
```

系统会提示您配置：
- 项目名称
- TypeScript 使用
- Pinia 状态管理
- Vitest 测试

### 非交互式模式

使用 `--yes` 跳过提示并使用默认值：

```bash
create-vue-medical --yes my-medical-app

# 使用短命令
cvm --yes my-medical-app
```

### 自定义配置

直接指定选项：

```bash
# 创建一个没有 TypeScript 的项目
create-vue-medical --yes --no-typescript my-medical-app

# 创建一个最小化项目
create-vue-medical --yes --no-typescript --no-pinia --no-vitest my-minimal-app

# 使用 name 选项而不是位置参数
create-vue-medical --yes --name my-medical-app

# 使用预设配置
create-vue-medical --yes --preset minimal my-minimal-app
create-vue-medical --yes --preset hipaa my-hipaa-app

# 列出可用的预设
create-vue-medical --list-presets

# 使用短命令
cvm --yes --no-typescript my-medical-app
cvm --yes --preset minimal my-minimal-app
cvm --list-presets
```

## 命令选项

```
用法: create-vue-medical|cvm [选项] [项目名称]

创建带有 HIPAA 合规性的 Vue 医疗项目

选项:
  -V, --version           输出版本号
  -y, --yes               跳过提示，使用默认值
  -n, --name <name>       项目名称
  --no-typescript         禁用 TypeScript
  --no-pinia              禁用 Pinia
  --no-vitest             禁用 Vitest
  -p, --preset <name>     使用预设配置（minimal、standard、full、hipaa、enterprise）
  --list-presets          列出所有可用预设
  -h, --help              显示此帮助信息
```

## 项目结构

生成的项目包含：

```
src/
├── router/          # 安全路由配置
├── components/
│   ├── common/      # 公共组件
│   │   └── ThemeToggle.vue
│   ├── layout/      # 布局组件
│   │   ├── MainLayout.vue
│   │   └── AuthLayout.vue
│   └── medical/     # 医疗特定组件
│       ├── PatientForm.vue
│       ├── MedicalDashboard.vue
│       ├── MedicalChart.vue
│       ├── MedicalPrescription.vue
│       ├── MedicalAppointment.vue
│       ├── MedicalBilling.vue
│       ├── MedicalRecord.vue
│       ├── MedicalMedication.vue
│       ├── MedicalLabResult.vue
│       ├── cardiology/     # 心内科专科组件
│       │   └── EcgViewer.vue
│       ├── neurology/      # 神经科专科组件
│       │   └── BrainMriViewer.vue
│       ├── ophthalmology/  # 眼科专科组件
│       │   └── EyeChart.vue
│       ├── orthopedics/    # 骨科专科组件
│       │   └── JointRangeViewer.vue
│       └── devices/        # 医疗设备集成组件
│           └── DeviceConnector.vue
├── i18n/            # 国际化配置
│   ├── index.js
│   └── locales/
│       ├── en.js
│       └── zh.js
├── styles/          # 主题和全局样式
│   └── themes.css
├── utils/
│   ├── audit.js                 # 审计日志工具（HIPAA 合规）
│   ├── crypto.js                # 数据加密工具
│   ├── validators.js            # 医疗数据验证规则
│   ├── hipaa-compliance.js      # HIPAA 合规检查器
│   ├── zero-trust.js            # 零信任架构工具
│   ├── compliance-manager.js    # 多地区合规管理器
│   ├── api-marketplace.js       # 医疗 API 市场工具
│   ├── voice-interaction.js     # 语音交互工具
│   └── wasm/                    # WebAssembly 和 GPU 加速
│       └── medical-image-processor.js
├── views/
│   ├── HomeView.vue
│   ├── LoginView.vue
│   ├── DashboardView.vue
│   └── PatientsView.vue
├── App.vue
└── main.ts

# 安全配置
├── security-plugins/
│   └── medical-security-plugin.js # 医疗特定安全规则
├── vue-security-scanner.config.js
├── vite-plugin-vue-security (在 vite.config.ts 中配置)
├── .vue-security-ignore
└── security-scan-filter.js

# 构建配置
├── vite.config.ts
├── tsconfig.json (如果启用了 TypeScript)
├── tsconfig.node.json
└── package.json

# 环境配置
├── .env.example
└── .env.production.example

# CI/CD 配置
├── .github/workflows/ci.yml
└── .gitlab-ci.yml

# 文档
├── README.md
├── API.md
├── COMPONENTS.md
├── SECURITY.md
└── DEPLOYMENT.md
```

## 安全特性

### 1. 安全头部

在开发和生产环境中自动配置：
- **内容安全策略 (CSP)**
- **严格传输安全 (HSTS)**
- **X-Content-Type-Options**
- **X-Frame-Options**
- **X-XSS-Protection**

### 2. 数据加密

内置工具用于加密敏感数据：
- 患者信息
- 认证令牌
- 医疗记录
- API 密钥和机密

### 3. 审计日志

全面的审计日志用于：
- 用户登录/注销
- 患者记录访问
- 管理操作
- 安全事件
- API 请求和响应
- 医疗设备交互

### 4. 医疗数据验证

预配置的验证规则用于：
- 医疗记录号码
- 患者姓名
- 年龄
- 电子邮件地址
- 电话号码
- 密码
- 保险信息
- 医疗代码（ICD-10、CPT 等）

### 5. 安全扫描

集成的安全工具：
- **vue-security-scanner**：静态代码分析
- **npm audit**：依赖项漏洞扫描
- **安全报告过滤**：减少误报

### 6. 零信任架构

先进的安全架构：
- **持续认证** 对每个请求
- **医疗数据微分段**
- **最小权限访问** 原则
- **实时威胁检测**

### 7. 区块链集成

不可篡改的数据存储：
- **医疗记录哈希** 用于防篡改
- **审计跟踪验证**
- **提供商之间的安全数据共享**
- **患者同意管理**

## 生成项目的使用

### 1. 安装依赖

```bash
cd my-medical-app
npm install
```

### 2. 开发服务器

```bash
npm run dev
```

### 3. 构建生产版本

```bash
npm run build
```

### 4. 运行安全扫描

```bash
# 运行静态安全扫描
npm run security:scan

# 运行依赖项审计
npm run security:audit

# 查看过滤后的安全报告
npm run security:report
```

## 生产部署

对于生产部署，请记住：

1. **设置 HTTPS** 用于安全通信
2. **配置环境变量** 用于敏感信息
3. **实现适当的后端认证**
4. **定期进行安全审计**
5. **维护 HIPAA 合规文档**
6. **设置适当的错误处理** 不暴露敏感信息
7. **配置容器化** 使用 Docker 实现一致的部署
8. **设置 CI/CD 流水线** 用于自动化测试和部署

### 边缘部署

对于远程医疗场景：
- **边缘服务器配置** 用于低延迟访问
- **离线功能** 适用于连接不可靠的地区
- **本地数据缓存** 用于关键医疗信息
- **边缘到云同步** 当连接可用时

### 混合云支持

为了增强可靠性和可扩展性：
- **多云部署** 用于冗余
- **云边缘编排** 用于最佳性能
- **灾难恢复** 跨区域
- **成本优化** 通过战略资源分配

## HIPAA 合规考虑

此工具为 HIPAA 合规提供基础，但您还应该：

- 实现 **适当的后端安全** 措施
- 建立 **数据泄露通知程序**
- 进行 **定期安全风险评估**
- 为员工提供 **安全意识培训**
- 与供应商维护 **业务伙伴协议** (BAA)
- 实现 **访问控制** 和 **审计跟踪**
- 记录 **患者同意** 数据使用
- 建立 **数据保留和销毁** 政策

### 多地区合规支持

对于全球医疗运营：
- **GDPR 合规** 适用于欧洲运营
- **PIPEDA 合规** 适用于加拿大运营
- **My Health Record 合规** 适用于澳大利亚运营
- **NHIS 合规** 适用于英国运营
- **当地医疗法规** 适用于其他地区
- **跨境数据传输** 合规
- **区域数据主权** 考虑

## 贡献

欢迎贡献！请随时提交 Pull Request。

## 文档

- [API 文档](API.md) - 完整的 API 文档
- [组件文档](COMPONENTS.md) - 详细的医疗组件使用指南
- [安全文档](SECURITY.md) - 安全特性和最佳实践
- [部署指南](DEPLOYMENT.md) - 部署说明和最佳实践
- [架构指南](ARCHITECTURE.md) - 系统架构和设计原则
- [性能优化指南](PERFORMANCE.md) - 性能优化策略和最佳实践
- [中国合规指南](CHINA-COMPLIANCE.md) - 中国医疗法规合规指南
- [API 市场文档](API-MARKETPLACE.md) - 医疗 API 市场集成指南
- [语音交互文档](VOICE-INTERACTION.md) - 医疗语音交互使用指南
- [WebAssembly 文档](WEBASSEMBLY.md) - 医疗 WebAssembly 开发指南
- [区块链集成文档](BLOCKCHAIN.md) - 医疗区块链集成指南
- [边缘部署文档](EDGE-DEPLOYMENT.md) - 医疗边缘部署指南
- [多地区合规文档](MULTI-REGION-COMPLIANCE.md) - 医疗多地区合规指南

### 组件文档

有关每个医疗组件的详细文档，请参考 [components-docs](./src/templates/config/components-docs/) 目录：

**核心医疗组件（11个）：**
- [PatientForm](src/templates/config/components-docs/PatientForm.md) - 患者信息表单，包含 GDPR 同意管理
- [MedicalDashboard](src/templates/config/components-docs/MedicalDashboard.md) - 带有患者统计信息的医疗仪表盘
- [MedicalChart](src/templates/config/components-docs/MedicalChart.md) - 医疗数据可视化图表
- [MedicalPrescription](src/templates/config/components-docs/MedicalPrescription.md) - 医疗处方管理
- [MedicalAppointment](src/templates/config/components-docs/MedicalAppointment.md) - 医疗预约安排
- [MedicalBilling](src/templates/config/components-docs/MedicalBilling.md) - 医疗账单和保险处理
- [MedicalRecord](src/templates/config/components-docs/MedicalRecord.md) - 医疗记录管理
- [MedicalMedication](src/templates/config/components-docs/MedicalMedication.md) - 药物管理
- [MedicalLabResult](src/templates/config/components-docs/MedicalLabResult.md) - 实验室结果管理
- [MedicalVitalSigns](src/templates/config/components-docs/MedicalVitalSigns.md) - 生命体征监测
- [MedicalImagingViewer](src/templates/config/components-docs/MedicalImagingViewer.md) - 医学影像查看器

**心内科组件（4个）：**
- [EcgViewer](src/templates/config/components-docs/EcgViewer.md) - ECG 波形查看器
- [HeartRateMonitor](src/templates/config/components-docs/HeartRateMonitor.md) - 实时心率监测
- [CardiacOutputCalculator](src/templates/config/components-docs/CardiacOutputCalculator.md) - 心输出量计算
- [CoronaryRiskCalculator](src/templates/config/components-docs/CoronaryRiskCalculator.md) - 冠心病风险评估

**神经科组件（4个）：**
- [BrainMriViewer](src/templates/config/components-docs/BrainMriViewer.md) - 脑部 MRI 图像查看器
- [NeurologicalExam](src/templates/config/components-docs/NeurologicalExam.md) - 神经科检查表单
- [EegViewer](src/templates/config/components-docs/EegViewer.md) - EEG 波形查看器
- [ParkinsonAssessment](src/templates/config/components-docs/ParkinsonAssessment.md) - 帕金森病评估

**眼科组件（4个）：**
- [EyeChart](src/templates/config/components-docs/EyeChart.md) - 视力表
- [VisualFieldTest](src/templates/config/components-docs/VisualFieldTest.md) - 视野检查
- [Tonometry](src/templates/config/components-docs/Tonometry.md) - 眼压测量
- [RetinalExam](src/templates/config/components-docs/RetinalExam.md) - 视网膜检查

**骨科组件（4个）：**
- [JointRangeViewer](src/templates/config/components-docs/JointRangeViewer.md) - 关节活动范围查看器
- [BoneDensityTest](src/templates/config/components-docs/BoneDensityTest.md) - 骨密度检查
- [FractureAssessment](src/templates/config/components-docs/FractureAssessment.md) - 骨折评估
- [JointReplacement](src/templates/config/components-docs/JointReplacement.md) - 关节置换规划

**设备集成（1个）：**
- [DeviceConnector](src/templates/config/components-docs/DeviceConnector.md) - 医疗设备连接器

**所有组件包含：**
- ✅ 访问控制（基于角色）
- ✅ 数据加密（敏感信息）
- ✅ 数据脱敏（患者隐私）
- ✅ 审计日志（所有操作）
- ✅ GDPR 合规（同意管理、数据处理记录）
- ✅ 中国法规合规（数据本地化、加密、审计）

## 许可证

[MIT](https://opensource.org/licenses/MIT)

## 关键词

vue, medical, hipaa, security, scaffold, cli, healthcare, encryption, audit, compliance