面向冶金档案管理的综合档案管理系统搭建实操落地指南

一、前期准备与环境安装

1.1 必备环境安装

以下所有资源均为直接可用地址，无需额外搜索，根据你的操作系统选择对应安装方式：

• Ubuntu系统直接执行以下命令完成所有环境安装：

  ```
  sudo apt update && sudo apt install openjdk-11-jdk maven mysql-server -y
  ```
  

• Windows用户直接下载对应安装包，按引导下一步完成安装：
  • JDK11：https://cdn.azul.com/zulu/bin/zulu11.66+19-ca-jdk11.0.19-win_x64.msi
  • Maven3.8.8：https://archive.apache.org/dist/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.zip
  • Mysql8.0：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.33-winx64.zip

1.2 基础源码获取

使用开源基础框架快速搭建，省去从零开发的工作量，执行以下命令拉取源码：

```
git clone https://gitee.com/y_project/RuoYi.git
cd RuoYi
```

没有安装git的用户，可以直接打开上述地址，点击下载源码压缩包解压即可。

二、冶金档案管理专属模块配置

2.1 创建冶金档案专属数据表

登录你的Mysql数据库，选中RuoYi项目对应的业务库，执行以下完整建表语句，直接复制即可：

```
CREATE TABLE `metallurgy_archive` (
`archive_id` bigint NOT NULL AUTO_INCREMENT COMMENT '档案ID',
`archive_code` varchar(64) NOT NULL COMMENT '档案编号',
`archive_name` varchar(100) NOT NULL COMMENT '档案名称',
`archive_type` varchar(20) NOT NULL COMMENT '档案类型：工艺/设备/矿料/环保',
`smelting_batch` varchar(64) DEFAULT NULL COMMENT '冶炼批次号',
`equipment_no` varchar(64) DEFAULT NULL COMMENT '关联设备编号',
`ore_source` varchar(100) DEFAULT NULL COMMENT '矿料来源',
`detection_result` text DEFAULT NULL COMMENT '检测结果',
`emission_data` varchar(255) DEFAULT NULL COMMENT '排放数据',
`archive_year` int NOT NULL COMMENT '归档年份',
`file_url` varchar(255) DEFAULT NULL COMMENT '原文件地址',
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人',
`update_time` datetime DEFAULT NULL COMMENT '更新时间',
PRIMARY KEY (`archive_id`),
UNIQUE KEY `uk_archive_code` (`archive_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='冶金档案管理表';
```

2.2 生成后端业务代码

启动项目一次进入系统，打开系统工具->代码生成，按以下要求配置：

• 选中刚才创建的metallurgy_archive表
• 包名填写：com.ruoyi.metallurgy
• 模块名填写：metallurgy
• 业务名填写：archive
• 功能描述填写：冶金档案管理

点击生成代码，将下载的压缩包解压后，把对应的文件分别复制到项目对应目录，Java代码放到src/main/java/com/ruoyi，前端模板放到src/main/resources/templates/views/metallurgy，直接覆盖默认文件即可，无需修改路径。

2.3 适配前端冶金字段联动

打开src/main/resources/templates/views/metallurgy/archive.html，找到表单区域，替换原有表单部分为以下代码，直接复制即可：

```

档案类型


请选择档案类型
冶金工艺档案
冶炼设备档案
矿料检测档案
排放环保档案






冶炼批次号





关联设备编号





矿料来源





排放数据




```

然后在文件末尾的script标签中添加以下联动逻辑，实现切换类型自动显示对应字段：

```
$("archiveType").change(function(){
const type = $(this).val();
$("batchDiv,equipDiv,oreDiv,emissionDiv").hide();
type === '工艺' && $("batchDiv").show();
type === '设备' && $("batchDiv,equipDiv").show();
type === '矿料' && $("batchDiv,oreDiv").show();
type === '环保' && $("batchDiv,emissionDiv").show();
});
```

三、项目启动与权限配置

回到项目根目录，执行打包启动命令：

```
mvn clean package
java -jar target/ruoyi.jar
```

启动完成后，在浏览器访问http://你的服务器IP:8080，默认登录账号为admin，密码为admin123。

登录后配置菜单权限，步骤如下：

1. 进入系统管理->菜单管理，点击新增，填写：菜单名称「冶金档案管理」，父菜单选择「档案管理」，访问地址填写metallurgy/archive，保存
2. 进入系统管理->角色管理，编辑档案管理员角色，勾选「冶金档案管理」菜单权限，保存即可

四、日常操作与常见问题解决

配置完成后即可正常使用，核心操作流程：

• 新增档案：打开左侧菜单「冶金档案管理」，点击新增，选择档案类型，填写对应业务字段，上传原始档案文件，点击保存即可
• 查询档案：支持按档案编号、冶炼批次、档案类型、归档年份多条件筛选，直接输入条件点击搜索即可
• 导出档案：勾选需要导出的档案，点击导出按钮，即可生成包含所有冶金专属字段的Excel报表，满足复盘、审计需求

常见问题快速解决：

• 启动提示表不存在：确认建表语句已经在当前项目使用的Mysql库中执行，检查表名拼写是否正确
• 菜单不显示：确认角色权限已经勾选，清理浏览器缓存后重新登录即可
• 文件上传失败：打开项目resources/application.yml，修改文件上传路径为你系统的可写绝对路径，示例：

  ```
  profile:
  upload-path: D:/ruoyi/uploadPath
  ```
  

  修改后重启项目即可。