# mineEvaluationSystem

**Repository Path**: masaikk/mine-evaluation-system

## Basic Information

- **Project Name**: mineEvaluationSystem
- **Description**: 矿山安全评价系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-10-10
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 矿山安全评价系统 - AHP-MIV-BP模型智能矿山安全评价系统

基于AHP-MIV-BP模型的智能矿山安全评价系统，提供安全等级评估、隐患跟踪管理、报告生成等功能。

## 技术栈

### 后端
- **框架**: Django 4.2.11
- **数据库**: MySQL
- **跨域**: django-cors-headers

### 前端
- **框架**: Vue 3 + TypeScript
- **状态管理**: Pinia
- **路由**: Vue Router 4
- **构建工具**: Vite
- **样式**: CSS3 (现代化设计)
- **图标**: Font Awesome 6

## 功能特性

1. **安全评价计算**
   - 基于AHP-MIV-BP模型
   - 15项安全指标评估
   - 自动等级判定 (A/B/C/D级)
2. **隐患跟踪管理**
   - 低分指标自动跟踪
   - 整改任务分配
   - 状态实时更新
   - 支持整改图片上传展示
3. **报告管理**
   - 自动生成评价报告
   - 历史记录查询
   - 报告预览和打印
4. **知识标准库**
   - PDF/文本文件上传和管理
   - 在线预览和下载功能
   - 多维度搜索和筛选
   - 分类管理和统计
   - 浏览次数跟踪
5. **人员信息管理**
   - 三角色管理：管理员、普通员工、安全员
   - 完整的用户生命周期管理
   - 基于角色的权限控制

## 快速开始

### 前提条件
- Python 3.8+
- Node.js 16+
- pip 或 conda
- 本地或远程的MySQL数据库

### 1. 安装后端依赖
```bash
pip install -r requirements.txt
# 如果后期在运行的过程中出现没有找到某个库的报错，就单独使用pip安装这个库。
```

### 2. 初始化数据库

首先需要连接本地已经安装的MySQL数据库。需要修改配置文件连接。

复制**minesys\config.py.example**文件到**minesys\config.py**，并且填上本地MySQL的用户名、密码、数据库名字和端口号。

```python
# 数据库配置文件示例
# 请复制此文件为 config.py 并根据实际情况修改以下配置

DATABASE_CONFIG = {
    'NAME': 'minesys',  # 数据库名称
    'USER': 'your_username',  # MySQL 用户名
    'PASSWORD': 'your_password',  # MySQL 密码
    'HOST':'',
    'PORT':''
}

```

在AHP-MIV-BP_0.93文件夹下面创建saved_models文件夹，放入保存的模型文件，如下所示：

![image-20251101232936497](README.assets/image-20251101232936497.png)

确认MySQL正常连接之后，再在命令行中依次执行下方的命令创建数据库表格（django的数据迁移操作）。

```bash
cd minesys
python manage.py makemigrations
python manage.py migrate
```

### 3. 启动后端

使用刚才安装了依赖库的python环境去使用runserver启动。默认后端运行在8000端口上。

```bash
cd minesys  
python manage.py runserver
```

正常运行的后端会出现如下类似的字样：

> Django version 4.2.11, using settings 'minesys.settings'
> Starting development server at http://127.0.0.1:8000/
> Quit the server with CTRL-BREAK.

### 4. 启动前端

使用nodejs的npm去安装nodejs包，并且使用npm去运行前端。默认运行在3000端口上。

```bash
cd minesys-front
npm install
npm run dev
```

正常运行的前端会显示这样的内容：

>   VITE v7.1.9  ready in 4356 ms
>
> ➜  Local:   http://localhost:3000/
>
> ➜  press h + enter to show help

### 5. 访问系统

- 前端地址: http://localhost:3000
- 在浏览器中打开上述链接，可以进入初始页面。
- 后端API（正常使用系统的话就不需要用到这个地址）: http://127.0.0.1:8000

### 6.文件夹介绍

- AHP-MIV-BP_0.93 存放算法本身，与运行系统无关，但是不要删掉这个文件夹。
- minesys 后端代码，使用python和django库。
- minesys-front 前端代码，使用JavaScript和Vue库。
- sample 静态模板文件。
- minesys-front\public\report-template.html 报告的html模板。
- minesys-front\public\bg1.png 系统的背景图片。

### 7.系统主要功能流程介绍

打开前端的网址：

![image-20251101221201607](README.assets/image-20251101221201607.png)

点击下方的创建管理员按钮，输入用户名和密码创建。随后用这个账号登录。

![image-20251101221313298](README.assets/image-20251101221313298.png)

登录之后展示人员管理页面

![image-20251101221424298](README.assets/image-20251101221424298.png)

可以在此创建人员，也可以点击右上角的图标进入个人页面配置信息。

![image-20251101222750911](README.assets/image-20251101222750911.png)

点击左侧知识库，可以进入知识库模块，在这里支持上传和下载功能。

![image-20251101221519331](README.assets/image-20251101221519331.png)

点击左边的“安全评估计算”进入到安全评估页面

![image-20251101221727532](README.assets/image-20251101221727532.png)

在这里输入相关的信息和数据，点击下方的按钮，进行评估

![image-20251101221804182](README.assets/image-20251101221804182.png)

点击左侧的“隐患跟踪管理”可以进入隐患跟踪管理模块，在这里会自动将刚才输入的安全评估数据中某个指标小于50的创建对应的隐患。支持搜索功能。在这里也可以上传隐患图片。

![image-20251101221905642](README.assets/image-20251101221905642.png)

![image-20251101222133491](README.assets/image-20251101222133491.png)

![image-20251101222145432](README.assets/image-20251101222145432.png)

点击左侧的报告管理页面，可以查看报告主要的内容，以及导出报告。首先查看报告的数据：

![image-20251101222239492](README.assets/image-20251101222239492.png)

显示如下

![image-20251101222305013](README.assets/image-20251101222305013.png)

再点击右边的导出报告，会出现一个新窗口展示报告（如果不展示请检查浏览器是否设置了阻止新窗口）

![image-20251101222422324](README.assets/image-20251101222422324.png)

（由于浏览器兼容的问题，系统自动保存的报告可能会出现显示不全的问题）为了保存完整的报告，要在新窗口里面点鼠标右键，出现菜单下来点击“打印”，即可出现PDF报告进行保存。

![image-20251101222617227](README.assets/image-20251101222617227.png)

即可保存完整报告在电脑上：

![image-20251101222653398](README.assets/image-20251101222653398.png)

![image-20251101222708616](README.assets/image-20251101222708616.png)

## 常见问题

### Q: 启动时出现 "ModuleNotFoundError: No module named 'rest_framework'" 错误
A: 这个系统已经移除了对Django REST Framework的依赖。如果仍出现此错误，请检查：
1. 确保使用了最新的代码
2. 重新安装依赖：`pip install django django-cors-headers`
3. 删除 `__pycache__` 文件夹重试

### Q: 数据库迁移失败
A: 请按顺序执行以下命令：
```bash
cd minesys
python manage.py makemigrations users
python manage.py makemigrations knowledge
python manage.py migrate
```

### Q: 前端无法连接后端
A: 检查：
1. 后端是否在 http://127.0.0.1:8000 正常运行
2. 前端Vite代理配置是否正确
3. CORS配置是否生效

### Q: 知识库文件上传失败
A: 检查：
1. 文件大小不超过50MB
2. 文件格式是否支持（PDF、TXT、DOC、DOCX）
3. Django项目根目录是否有写入权限

### Q:无法加载模型

A:检查模型文件是否放在指定的位置AHP-MIV-BP_0.93\saved_models中