综合档案管理系统配置文物档案管理模块全流程实操指南

前期准备：环境与基础依赖安装

本教程基于开源综合档案管理系统RuoYi-Archive实现，所有依赖与配置均可直接复制执行，无需额外适配。

1.1 基础环境安装

所有操作基于CentOS7/8系统，Windows系统可直接下载对应安装包配置环境变量。

• JDK1.8安装：执行命令 yum install -y java-1.8.0-openjdk-devel，安装完成后执行java -version验证版本
• MySQL5.7安装：执行docker命令 docker run -d -p 3306:3306 --name mysql-archive -e MYSQL_ROOT_PASSWORD=Archive@2024 mysql:5.7 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci，执行完成后用root/Archive@2024登录数据库验证
• Maven3.8安装：执行命令 wget https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.8.8/binaries/apache-maven-3.8.8-bin.tar.gz && tar -zxvf apache-maven-3.8.8-bin.tar.gz -C /opt/，随后在/etc/profile末尾添加export PATH=$PATH:/opt/apache-maven-3.8.8/bin，执行source /etc/profile生效

1.2 基础系统部署

下载系统源码：git clone https://gitee.com/y_project/RuoYi-Archive.git，进入项目根目录执行mvn clean install -DskipTests编译打包，打包完成后进入ruoyi-admin/target目录，执行java -jar ruoyi-admin.jar启动后端服务，默认端口8080，默认账号密码admin/admin123。

文物档案管理模块核心配置

2.1 数据库表结构导入

登录MySQL执行以下SQL，创建文物档案核心表，包含所有必填字段与约束：

```sql CREATE TABLE `biz_cultural_relic_archive` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID', `relic_no` varchar(32) NOT NULL COMMENT '文物编号', `relic_name` varchar(64) NOT NULL COMMENT '文物名称', `relic_level` char(1) NOT NULL COMMENT '文物等级：1一级2二级3三级4一般', `unearthed_time` date DEFAULT NULL COMMENT '出土时间', `material` varchar(32) DEFAULT NULL COMMENT '材质', `size` varchar(64) DEFAULT NULL COMMENT '尺寸', `storage_location` varchar(64) DEFAULT NULL COMMENT '存放位置', `status` char(1) DEFAULT '0' COMMENT '状态：0在库1借出2修复中3展出', `archive_owner` varchar(32) DEFAULT NULL COMMENT '档案责任人', `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` char(1) DEFAULT '0' COMMENT '删除标志', PRIMARY KEY (`id`), UNIQUE KEY `uk_relic_no` (`relic_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文物档案主表'; ```

2.2 后端接口配置

在ruoyi-admin模块下创建com.ruoyi.archive.biz包，新增文物档案Controller、Service、Mapper层代码，核心配置如下：

• 修改application.yml文件中mybatis-plus配置，添加mapper扫描路径：mapper-locations: classpath:mapper//Mapper.xml,classpath:mapper/biz/.xml
• Controller层添加权限注解：@PreAuthorize("@ss.hasPermi('archive:relic:list')")，对应列表、新增、修改、删除、导出权限分别为archive:relic:list、add、edit、remove、export

前端页面配置与功能调试

3.1 系统菜单配置

登录系统后进入【系统管理-菜单管理】，点击新增按钮：

• 新增一级菜单：菜单名称“文物档案管理”，路由地址“relic”，组件路径“biz/relic/index”，权限标识“archive:relic”，菜单类型选择“目录”
• 在一级菜单下新增子菜单：文物列表、新增档案、修改档案、删除档案、导出档案，对应权限标识分别为list、add、edit、remove、export，菜单类型选择“按钮”

3.2 前端页面代码

在前端项目src/views/biz目录下创建relic文件夹，新增index.vue文件，核心代码如下：

```vue ```

3.3 功能调试步骤

• 重启后端服务，访问http://localhost:8080/doc.html查看文物档案接口是否正常返回
• 启动前端服务，用admin账号登录，确认左侧菜单出现「文物档案管理」目录
• 测试新增功能：填写文物编号WW001、名称“商代青铜鼎”、等级1、存放位置“一号库1层01柜”，提交后查看数据库是否生成对应记录
• 测试查询与导出功能：输入文物编号WW001确认可搜到对应数据，点击导出按钮确认可生成带水印的Excel文件

文物档案合规性配置与落地校验

4.1 权限管控配置

必须配置三级权限体系，避免越权操作：进入【系统管理-角色管理】，给普通员工角色仅分配archive:relic:list权限，档案管理员分配list、add、edit权限，系统管理员分配全部权限。涉密文物可额外配置数据权限，仅授权部门可见。

4.2 归档规则配置

在application.yml中添加以下配置，实现文物档案归档预警：

``` archive: relic: archiveDeadline: 7 归档期限7天 warnType: [1,2] 1站内信2短信3邮件 warnReceiver: archive_admin 预警接收人账号 ```

4.3 落地校验清单

完成配置后对照以下清单校验，确保功能可用：

• 文物编号唯一约束生效，重复编号无法提交
• 所有操作日志可追溯，包含查看、新增、修改、删除、导出操作的操作人、时间、IP信息
• 非授权角色无法看到涉密文物档案信息
• 导出的档案文件自动添加操作人+操作时间水印，无法篡改

完成以上所有步骤后，文物档案管理模块即可正式投入使用，无需额外改造。