# UCare

**Repository Path**: xiaodeme/ucare

## Basic Information

- **Project Name**: UCare
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-09
- **Last Updated**: 2025-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DICOM 医学影像查看器

一个基于 Vue.js 和 Cornerstone.js 构建的 Web 端 DICOM 医学影像查看器，支持 DICOM 文件的上传、浏览和交互式查看。

![DICOM 查看器截图](./screenshots/viewer.png)

## 功能特点

- 🏥 患者列表管理：查看和管理所有上传的患者影像
- 📤 DICOM 文件上传：支持批量上传 DICOM 文件
- 🔍 高性能图像查看：流畅的图像浏览和交互体验
- 🛠 图像操作工具：平移、缩放、窗宽窗位调整、堆栈滚动等
- 📊 图像信息显示：查看 DICOM 标签和图像元数据
- 🚀 高性能加载：智能预加载和并发请求控制
- 📱 响应式设计：适配不同屏幕尺寸

## 技术栈

- **前端框架**：Vue.js 2.x
- **UI 组件**：Element UI
- **DICOM 处理**：Cornerstone.js 系列库
- **HTTP 请求**：Axios
- **构建工具**：Vue CLI 4

## 安装与运行

### 前提条件

- Node.js (v12.x 或更高版本)
- npm 或 yarn
- Orthanc DICOM 服务器 (用于后端存储)

### 安装步骤

1. 克隆仓库

```bash
git clone git@gitee.com:xiaodeme/dicom-viewer.git
cd dicom-viewer
```

2. 安装依赖

```bash
npm install
# 或
yarn install
```

3. 配置后端服务

编辑 `vue.config.js` 文件，配置 Orthanc 服务器的代理：

```javascript
module.exports = {
  devServer: {
    proxy: {
      '/api': {
        target: 'http://your-orthanc-server:8042/',
        changeOrigin: true,
        pathRewrite: {
          '^/api': ''
        }
      }
    }
  }
}
```

4. 启动开发服务器

```bash
npm run serve
# 或
yarn serve
```

5. 构建生产版本

```bash
npm run build
# 或
yarn build
```

构建后的文件将位于 `dist` 目录中。

## 使用指南

### 上传 DICOM 文件

1. 导航到"上传影像"页面
2. 拖拽 DICOM 文件到上传区域或点击选择文件
3. 等待上传完成，系统会自动处理 DICOM 文件

### 浏览患者列表

1. 导航到"患者影像列表"页面
2. 查看所有已上传的患者影像
3. 点击"查看"按钮打开影像查看器

### 使用影像查看器

- **平移图像**：选择平移工具，然后拖动图像
- **缩放图像**：选择缩放工具，然后上下拖动鼠标
- **调整窗宽窗位**：选择窗宽窗位工具，然后拖动鼠标
- **浏览图像堆栈**：使用鼠标滚轮或选择堆栈滚动工具
- **重置视图**：点击重置按钮
- **反转图像**：点击反转按钮
- **全屏显示**：点击全屏按钮

## 部署指南

### 使用 Nginx 部署

1. 构建项目

```bash
npm run build
```

2. 配置 Nginx

```nginx
server {
    listen 80;
    server_name your-domain.com;

    root /path/to/dicom-viewer/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://your-orthanc-server:8042/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

3. 重启 Nginx

```bash
sudo systemctl restart nginx
```

## 贡献指南

1. Fork 仓库
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 创建 Pull Request

## 许可证

本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件

## 联系方式

如有问题或建议，请通过 Issues 或 Pull Requests 与我们联系。