# IMS

**Repository Path**: dilenlee/ims

## Basic Information

- **Project Name**: IMS
- **Description**: 这是一个物资和资产管理系统，涉及资产，采购，库存，维修管理，财务管理和数据分析
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-06
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 医院物资管理系统 (IMS)

基于 Spring Boot 3.2.x + Vue 3 的医院物资管理系统，支持 Windows/Linux/macOS 多平台部署，可离线运行。

## 功能特性

- ✅ 资产管理：资产登记、分类、状态跟踪
- ✅ 物资管理：库存管理、入库出库、库存预警
- ✅ 用户管理：角色权限、部门管理
- ✅ 跨平台支持：Windows / Linux / macOS / Docker
- ✅ 离线部署：所有依赖本地化，无需外网

## 支持平台

| 平台 | 部署方式 | 状态 |
|------|---------|------|
| Windows Server/10/11 | 直接部署 / Docker Desktop | ✅ 支持 |
| Linux (Ubuntu/CentOS/Debian) | 直接部署 / Docker | ✅ 支持 |
| macOS | 直接部署 / Docker | ✅ 支持 |
| Docker/Kubernetes | 容器化部署 | ✅ 支持 |

## 技术栈

### 后端
- Spring Boot 3.2.5
- OpenJDK 21
- Spring Security + JWT
- H2 Database（开发/离线）/ MySQL 8.0（生产）
- JPA/Hibernate

### 前端
- Vue 3.4.21
- Element Plus 2.6.3
- Vue Router 4
- Pinia
- Vite 5

## 快速开始

### 环境要求
- OpenJDK 21+
- Node.js 18+ (前端开发)
- Maven 3.9+ (可选，可用 wrapper)

### 1. 克隆项目

```bash
git clone https://gitee.com/dilenlee/ims.git
cd ims
```

### 2. 启动后端

**Windows:**
```bash
cd backend
start-backend.bat
```

**Linux/macOS:**
```bash
cd backend
chmod +x ../start-backend.sh
../start-backend.sh
```

**或手动启动:**
```bash
mvnw spring-boot:run -Dspring-boot.run.profiles=local
```

后端服务启动后访问：
- API: http://localhost:8080
- H2控制台: http://localhost:8080/h2-console
  - JDBC URL: `jdbc:h2:file:./data/ims_db`
  - 用户名: `sa`
  - 密码: （留空）

### 3. 启动前端

**Windows:**
```bash
cd frontend
start-frontend.bat
```

**Linux/macOS:**
```bash
cd frontend
chmod +x ../start-frontend.sh
../start-frontend.sh
```

**或手动:**
```bash
npm install
npm run dev
```

前端访问：http://localhost:3000

### 4. 登录系统

- 管理员: `admin` / `admin123`
- 部门管理员: `manager` / `manager123`
- 普通用户: `user` / `user123`

## 离线部署

### 下载依赖

```bash
# 后端依赖
cd backend
download-dependencies.bat

# 前端依赖
cd frontend
download-dependencies.bat
```

### 构建部署包

```bash
# 在项目根目录执行
build.bat
```

构建完成后，`dist/` 目录包含：
- `ims-backend.jar` - 后端可执行包
- `static/` - 前端静态资源
- `application.yml` - 配置文件
- `start.bat` - 启动脚本

### 离线环境部署

**Windows:**
1. 将 `dist/` 目录复制到目标服务器
2. 确保已安装 OpenJDK 21
3. 双击运行 `start.bat`
4. 访问 http://localhost:8080

**Linux/macOS:**
1. 将 `dist/` 目录复制到目标服务器
2. 确保已安装 OpenJDK 21
3. 执行 `./start-backend.sh`
4. 访问 http://localhost:8080

**Docker (推荐生产环境):**
```bash
docker-compose up -d
```

## 项目结构

```
ims/
├── backend/                 # 后端项目
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/hospital/ims/
│   │   │   │   ├── controller/    # 控制器
│   │   │   │   ├── service/      # 服务层
│   │   │   │   ├── repository/    # 数据访问
│   │   │   │   ├── entity/       # 实体类
│   │   │   │   ├── security/      # 安全配置
│   │   │   │   └── config/       # 配置类
│   │   │   └── resources/
│   │   │       ├── db/            # 数据库脚本
│   │   │       └── application*.yml # 配置文件
│   │   └── test/                   # 测试代码
│   ├── pom.xml
│   └── download-dependencies.bat
├── frontend/                # 前端项目
│   ├── src/
│   │   ├── api/           # API 接口
│   │   ├── components/      # 公共组件
│   │   ├── router/          # 路由配置
│   │   ├── store/            # 状态管理
│   │   ├── utils/           # 工具函数
│   │   ├── views/           # 页面组件
│   │   ├── App.vue
│   │   └── main.js
│   ├── package.json
│   └── vite.config.js
├── start-backend.bat        # Windows 后端启动
├── start-backend.sh         # Linux/macOS 后端启动
├── start-frontend.bat       # Windows 前端启动
├── start-frontend.sh        # Linux/macOS 前端启动
├── build.bat                # Windows 构建脚本
├── build.sh                 # Linux/macOS 构建脚本
├── Dockerfile               # Docker 构建文件
├── docker-compose.yml       # Docker Compose 配置
├── nginx.conf               # Nginx 配置
├── DEPLOY.md                # 详细部署文档
└── README.md
```

## API 文档

启动后端后访问 Swagger UI：
http://localhost:8080/swagger-ui.html

### 主要接口

| 接口 | 方法 | 描述 |
|------|------|------|
| /auth/login | POST | 用户登录 |
| /auth/refresh | POST | 刷新 Token |
| /auth/logout | POST | 退出登录 |
| /assets | GET | 资产列表 |
| /materials | GET | 物资列表 |
| /users | GET | 用户列表 |

## 开发计划

- [x] 基础架构搭建
- [x] 用户认证（JWT）
- [x] 资产/物资管理
- [x] 前端界面
- [x] 离线部署支持
- [x] 跨平台支持 (Windows/Linux/macOS)
- [x] Docker 容器化
- [ ] 报表统计
- [ ] 条码/二维码支持
- [ ] 移动端适配

## 部署文档

详细部署指南请查看 [DEPLOY.md](DEPLOY.md)，包含：
- Windows Server 部署
- Linux (Ubuntu/CentOS) 部署
- Docker/Docker Compose 部署
- Kubernetes 部署
- 数据库配置
- 性能优化
- 备份恢复

## 许可证

MIT License

## 联系方式

如有问题，请提交 Issue 或联系项目维护者。