从零搭建电子档案移交接收系统：全流程可直接落地实操指南

一、前置环境准备

提前安装以下3个基础依赖，所有安装包均给出直接下载地址，可直接下载使用：

1. 安装JDK11

• Windows版下载地址：https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_windows-x64_bin.zip
• Linux版下载地址：https://download.java.net/java/GA/jdk11/9/GPL/openjdk-11.0.2_linux-x64_bin.tar.gz

环境变量配置步骤：

• Windows：新增系统变量JAVA_HOME，值为JDK解压后的根目录，在Path变量中追加%JAVA_HOME%\bin， cmd执行java -version输出版本号即成功
• Linux：在/etc/profile文件末尾添加以下内容，执行source /etc/profile生效： ``` export JAVA_HOME=/opt/jdk11 export PATH=$JAVA_HOME/bin:$PATH ```

2. 安装MySQL5.7

• Windows版下载地址：https://cdn.mysql.com/Downloads/MySQL-5.7/mysql-5.7.42-winx64.zip
• CentOS安装命令：yum install -y mysql-community-server-5.7.42
• Ubuntu安装命令：apt install -y mysql-server=5.7.42

安装完成后启动MySQL服务，设置root账号开机自启即可。

3. 安装Git

直接下载对应系统安装包：https://git-scm.com/download，一路默认安装即可。

二、源码拉取与数据库初始化

1. 拉取项目源码

打开终端，执行以下命令拉取可直接运行的开源源码： ``` git clone https://gitee.com/archives-dev/deposit-reception-system.git ```

拉取完成后源码根目录为deposit-reception-system。

2. 初始化数据库

登录MySQL，执行以下SQL创建数据库和专用账号，可直接复制完整运行： ```sql CREATE DATABASE IF NOT EXISTS er_archives DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER 'er_user'@'%' IDENTIFIED BY 'Er@Archives123'; GRANT ALL ON er_archives. TO 'er_user'@'%'; FLUSH PRIVILEGES; ```

导入项目内置的初始化表结构和默认数据：找到源码目录下的src/main/resources/init.sql，使用Navicat或命令行导入到刚创建的er_archives数据库即可。

3. 修改项目配置

打开源码目录下的src/main/resources/application.yml，替换为以下完整可运行配置，无需修改即可使用（需要自定义存储路径可自行调整）： ```yaml server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/er_archives?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: er_user password: Er@Archives123 servlet: multipart: max-file-size: 100MB max-request-size: 100MB archives: storage: path: ./file-storage ```

注意：Windows系统如果修改存储路径，需要将斜杠转义，例如D盘路径要写为D:\\er-archive\\file-storage

三、项目启动运行

1. 本地开发启动

用IDEA打开项目，等待Maven自动导入依赖，如果拉取依赖速度慢，打开Maven的settings.xml，添加阿里云镜像加速： ```xml aliyunmaven https://maven.aliyun.com/repository/public ```

找到启动类com.archives.er.Application，点击运行按钮，等待控制台输出启动成功即可。

2. 服务器部署启动

在源码根目录执行打包命令：mvn clean package，打包完成后，将target目录下生成的er-archives-1.0.jar上传到服务器，执行以下命令后台启动： ```bash nohup java -jar er-archives-1.0.jar > er.log 2>&1 & ```

开放服务器8080端口：CentOS执行firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload，Ubuntu执行ufw allow 8080/tcp。

四、初始化配置与流程测试

启动完成后，访问http://你的IP:8080即可进入系统，按以下步骤完成初始化：

1. 使用默认管理员账号登录：用户名admin，密码admin123，首次登录必须修改密码，避免安全风险
2. 进入系统管理 > 规则配置，点击新增移交规则，按实际需求填写：移交单位编码（填写9位组织机构代码即可）、允许上传格式（勾选PDF、JPG、TIFF，符合档案管理国标要求）、单档最大大小（设置100MB即可），保存规则
3. 进入存储管理 > 存储校验，点击校验，若提示路径可用则完成，若提示权限不足：Linux执行chmod -R 755 ./file-storage，Windows右键文件夹属性，给Users组开放读写权限即可

五、完整移交接收流程操作

• 移交端发起：移交单位账号登录后，点击发起移交上传整理好的电子档案，填写元信息（档号、题名、年度、保管期限），提交移交申请
• 接收端审核入库：管理员登录进入接收审核 > 待审核，在线预览档案、核对元信息无误后，点击接收入库，系统自动生成档案条目、存储到指定路径，完成整个移交接收流程

常见问题排查

• 启动报错提示连接数据库失败：检查MySQL服务是否启动，配置文件中的IP、端口、账号密码是否正确，MySQL是否允许远程连接
• 上传档案提示大小超限：检查application.yml中的max-file-size参数，调整为需要的大小即可
• 存储档案失败：检查存储目录读写权限、服务器剩余磁盘空间是否充足