档案系统定制从零到一实操指南零基础可上手全流程可直接落地

发布时间: 2026年06月04日 17:10:02 来源: 安答联动浏览量: 0

一、前期环境准备

本次定制基于开源档案管理系统二次开发，无需从零写代码，所有依赖均有明确安装路径。

1.1 基础依赖安装（CentOS 7/8 环境）

依次执行以下命令完成所有基础依赖安装，无需手动下载源码包：

``` 安装JDK1.8 yum install -y java-1.8.0-openjdk-devel 安装MySQL5.7 wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm && rpm -ivh mysql57-community-release-el7-11.noarch.rpm && yum install -y mysql-community-server --nogpgcheck 安装Node.js14.x curl -sL https://rpm.nodesource.com/setup_14.x | bash - && yum install -y nodejs 安装Redis5.x yum install -y redis 启动依赖服务并设置开机自启 systemctl start mysqld redis && systemctl enable mysqld redis ```

二、基础代码拉取与初始化

2.1 代码拉取与数据库初始化

执行以下命令拉取开源基底代码：

``` git clone https://gitee.com/luoyueye/archive-manager.git ```

初始化数据库：

``` 查看MySQL初始密码 grep 'temporary password' /var/log/mysqld.log 登录MySQL，替换为你查到的初始密码 mysql -uroot -p你查到的初始密码执行以下SQL命令 ALTER USER 'root'@'localhost' IDENTIFIED BY 'Archive@2024'; CREATE DATABASE archive_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; use archive_db; source /root/archive-manager/sql/archive.sql; exit; ```

2.2 基础配置修改

修改后端数据库配置，打开/root/archive-manager/ruoyi-admin/src/main/resources/application-druid.yml，全部替换为以下内容：

``` spring: datasource: type: com.alibaba.druid.pool.DruidDataSource driverClassName: com.mysql.cj.jdbc.Driver druid: master: url: jdbc:mysql://localhost:3306/archive_db?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: Archive@2024 ```

档案系统定制从零到一实操指南零基础可上手全流程可直接落地

修改Redis配置，打开application.yml，找到redis配置段替换为以下内容：

``` redis: host: localhost port: 6379 password: database: 0 ```

修改前端接口配置，打开/root/archive-manager/ruoyi-ui/.env.production，替换为你的服务器公网IP：

``` VUE_APP_BASE_API = 'http://你的服务器公网IP:8080' ```

三、核心定制功能实操

3.1 自定义档案分类与字段

登录系统后台，默认账号admin，密码admin123
进入【系统管理】-【字典管理】，找到字典类型archive_type，点击【编辑】，新增你需要的分类（如人事档案、工程档案），状态设为正常
如需新增自定义字段，进入【系统工具】-【代码生成】，点击【导入】选择archive_info表，点击【编辑】
在字段信息栏新增字段，比如“保密等级”，字段类型选int，长度1，是否必填选是，显示类型选下拉框，字典类型选sys_normal_disable
点击【生成代码】，将生成的后端代码覆盖到ruoyi-modules/ruoyi-archive目录，前端代码覆盖到ruoyi-ui/src/views/archive目录

新增字段后必须重启后端服务，否则配置不生效

3.2 自定义档案审批流程

进入【工作流】-【流程定义】，点击【导入】，可直接使用官方模板：https://gitee.com/luoyueye/archive-manager/raw/master/bpmn/archive_approve.bpmn
导入后点击【部署】，进入【系统管理】-【菜单管理】，新增档案审批菜单，路由地址设为/workflow/approve/archive，组件路径设为workflow/approve/archive/index
在archive_info实体类新增approve_status字段，默认值0（0未提交1审批中2已通过3已驳回）
新增审批启动接口，直接复制以下代码即可：

```java @PostMapping("/startApprove") public AjaxResult startApprove(Long archiveId) { ArchiveInfo archiveInfo = archiveInfoService.selectArchiveInfoById(archiveId); Map variables = new HashMap<>(); variables.put("archiveId", archiveId); variables.put("applyUser", SecurityUtils.getUsername()); ProcessInstance instance = runtimeService.startProcessInstanceByKey("archive_approve", variables); archiveInfo.setApproveStatus(1); archiveInfoService.updateArchiveInfo(archiveInfo); return success(instance.getId()); } ```

流程定义的key必须和代码里的archive_approve完全一致，否则无法启动流程

3.3 自定义档案导出模板

后端新增导出接口，直接复制以下代码：

```java @PostMapping("/export") public void export(HttpServletResponse response, ArchiveInfo archiveInfo) throws IOException { List list = archiveInfoService.selectArchiveInfoList(archiveInfo); ExcelUtil util = new ExcelUtil<>(ArchiveInfo.class); // 如需新增导出字段，直接在ArchiveInfo实体类对应字段加@Excel注解即可 util.exportExcel(response, list, "档案数据"); } ```

如需自定义Excel样式，修改ruoyi-common/src/main/java/com/ruoyi/common/utils/poi/ExcelUtil.java里的setStyle方法即可

四、部署上线与验证

后端打包：进入ruoyi根目录，执行mvn clean package -Dmaven.test.skip=true，打包完成后在ruoyi-admin/target目录下得到ruoyi-admin.jar，执行启动命令：nohup java -jar ruoyi-admin.jar > /dev/null 2>&1 &
前端打包：进入ruoyi-ui目录，执行npm install && npm run build:prod，打包完成后得到dist目录
安装nginx：yum install -y nginx，编辑/etc/nginx/nginx.conf，在server块内添加以下配置：

``` location / { root /root/archive-manager/ruoyi-ui/dist; index index.html index.htm; try_files $uri $uri/ /index.html; } location /prod-api/ { proxy_pass http://localhost:8080/; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; } ```