# mediacal

**Repository Path**: rymaker/mediacal

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-30
- **Last Updated**: 2026-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 医疗报告管理系统

A full-stack medical treatment report management application with student and doctor portals.

## 项目简介

本系统是一个完整的医疗报告管理全栈应用，支持学员上传体检报告，医生审核报告并给出反馈意见。

## 技术栈

### 前端
- **框架**: Nuxt 3 (SPA 模式)
- **状态管理**: Pinia
- **样式**: SCSS
- **HTTP 客户端**: Axios

### 后端
- **框架**: Express.js + TypeScript
- **ORM**: TypeORM
- **数据库**: MySQL
- **缓存**: Redis
- **文件存储**: FTP

## 环境要求

- Node.js >= 18.x
- MySQL >= 8.0
- Redis >= 6.0

## 快速开始

### 后端启动

```bash
cd backend
npm install
cp .env.example .env
# 编辑 .env 配置数据库、Redis、FTP 等
npm run dev
```

服务运行在 `http://localhost:3001`

### 前端启动

```bash
cd frontend
npm install
cp .env.example .env
npm run dev
```

应用运行在 `http://localhost:3000`

## 环境变量

### 后端 (.env)

```env
PORT=3001
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=password
DB_DATABASE=medical_treatment
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
JWT_SECRET=your_secret
JWT_EXPIRES_IN=7d
FTP_HOST=ftp_host
FTP_PORT=21
FTP_USER=ftp_user
FTP_PASSWORD=ftp_password
FTP_BASE_PATH=/uploads/reports
```

### 前端 (.env)

```env
NUXT_PUBLIC_API_BASE=http://localhost:3001/api
```

## 核心功能

### 学员端
- 用户登录/注册
- 上传体检报告
- 查看审核反馈

### 医生端
- 查看待审核报告列表
- 审核报告并提交意见
- 查看审核历史

## API 接口

### 认证接口
| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/auth/register` | 用户注册 |
| POST | `/api/auth/login` | 用户登录 |
| GET | `/api/auth/profile` | 获取用户信息 |

### 报告接口
| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/report/create` | 上传报告 |
| GET | `/api/report/detail` | 获取报告详情 |
| GET | `/api/report/list` | 获取报告列表 |
| GET | `/api/report/pending` | 获取待审核报告 |
| PUT | `/api/report/status` | 更新报告状态 |

### 审核接口
| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/review/create` | 创建审核记录 |
| GET | `/api/review/detail` | 获取审核详情 |
| PUT | `/api/review/submit` | 提交审核结果 |
| GET | `/api/review/feedback` | 获取审核反馈 |

## 项目结构

```
├── frontend/                 # Nuxt 3 前端
│   ├── pages/               # 页面组件
│   ├── components/          # 组件
│   ├── stores/              # Pinia 状态
│   ├── api/                 # API 接口
│   └── assets/scss/         # 样式
│
└── backend/                  # Express 后端
    ├── src/
    │   ├── controllers/     # 控制器
    │   ├── services/        # 业务逻辑
    │   ├── entities/        # 数据实体
    │   ├── middlewares/     # 中间件
    │   └── routes/         # 路由
    └── package.json
```

## 许可证

ISC