面向档案信息化人才的数字档案馆系统落地实操入门指南

一、前期准备工具与材料

1.1 必备软件下载与安装

本次使用开源免费的DArchive数字档案馆系统，所有工具均提供可直接下载的地址，按步骤操作即可：

• 源码下载：https://gitee.com/zhuqicn/DArchive
• JDK1.8 Windows 64位：https://repo.huaweicloud.com/java/jdk/8u202-b08/jdk-8u202-windows-x64.exe
• MySQL5.7 Windows 64位：https://cdn.mysql.com/archives/mysql-5.7/mysql-5.7.42-winx64.zip
• Tomcat9 Windows 64位：https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.64/bin/apache-tomcat-9.0.64-windows-x64.zip

安装与环境配置步骤：

1. 安装JDK，一路点击下一步完成后，新增系统变量JAVA_HOME，值为你的JDK安装路径，示例：C:\Program Files\Java\jdk1.8.0_202，在Path变量中新增：%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin，管理员打开cmd输入java -version，输出java version "1.8.0_202"即为配置成功。
2. 解压MySQL压缩包，在根目录新建my.ini文件，粘贴以下完整配置，修改替换路径为你的实际解压路径： ``` [mysqld] port=3306 basedir=C:\\mysql-5.7.42-winx64 datadir=C:\\mysql-5.7.42-winx64\\data character-set-server=utf8mb4 [client] default-character-set=utf8mb4 port=3306 ``` 然后管理员打开cmd进入mysql的bin目录，依次执行以下命令： ``` mysqld --initialize-insecure mysqld install net start mysql mysqladmin -u root password 你的自定义root密码 ``` 执行完成即MySQL安装启动完成。
3. 解压Tomcat压缩包即可，无需额外配置，后续通过bin目录下的startup.bat启动。

1.2 业务材料准备

• 符合GB/T 1396-2009规范的本单位档案分类大纲
• 300DPI分辨率的档案扫描件，格式为PDF或TIF
• 本单位档号编制规则文档

二、系统部署与初始化配置

2.1 项目部署步骤

1. 从gitee下载项目源码，将编译好的DArchive.war复制到Tomcat的webapps目录下，启动Tomcat后自动解压项目。
2. 打开cmd登录MySQL，执行以下命令创建数据库： ``` CREATE DATABASE darchive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ```
3. 导入项目自带的数据库表：进入项目解压后的WEB-INF\classes\sql目录，执行命令source 你的完整文件路径\darchive.sql完成导入。
4. 修改数据库连接配置，打开WEB-INF\classes\jdbc.properties，替换为你的数据库信息，完整配置如下： ``` jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/darchive?useUnicode=true&characterEncoding=utf-8 jdbc.username=root jdbc.password=你设置的MySQL root密码 ```
5. 重启Tomcat，访问http://localhost:8080/DArchive，使用默认账号admin、密码admin登录，部署完成。

2.2 基础信息初始化

• 设置单位全宗信息：进入【系统管理】-【单位信息维护】，填写单位名称、全宗号（按当地档案局要求填写），保存即可。
• 配置档案分类体系：进入【档案管理】-【分类管理】，点击【新增分类】，按照提前准备的分类大纲依次添加一、二级分类，填写分类编号、名称，保存后自动生成分类树。
• 配置用户权限：进入【系统管理】-【用户管理】，点击【新增用户】，填写账号、姓名，按岗位职责分配角色（档案录入员/审核员/管理员），保存完成。

三、档案数字化录入与入库实操

3.1 元数据著录录入

使用档案录入员账号登录，进入【档案录入】-【著录录入】，选择对应档案分类，按要求填写必填元数据：档号、题名、责任者、形成日期、保管期限，所有内容符合《档案著录规则》GB/T 3792.1-2009要求，填写完成后点击【保存】，提交审核。

3.2 电子文件挂接

保存元数据后，在详情页点击【文件挂接】，选择预处理好的扫描件上传，单个文件大小不超过500M，多份文件可依次上传，系统自动管理访问权限，上传完成后点击【确认挂接】即可。

3.3 审核入库

使用审核员账号登录，进入【档案审核】-【待审核列表】，打开档案核对元数据与电子文件一致性，确认无误点击【通过审核】，档案自动正式入库；有误则点击【驳回】，标注修改意见退回录入员调整。

四、日常维护与常见问题排查

4.1 日常数据备份

必须每周执行一次全量备份，操作步骤：

1. 管理员打开cmd，进入MySQL的bin目录
2. 执行备份命令：mysqldump -u root -p darchive > D:\darchive_backup\backup_%date:~0,10%.sql
3. 将备份sql文件和项目中存储上传文件的目录一同复制到离线存储介质保存。

4.2 常见问题排查

• 无法打开登录页：检查Tomcat是否启动，8080端口是否被占用，若被占用修改Tomcat/conf/server.xml中的Connector端口为8081，重启即可。
• 提示数据库连接错误：检查jdbc.properties中的用户名、密码是否正确，MySQL服务是否正常启动。
• 文件上传失败：检查文件大小是否超过限制，Tomcat目录是否有写入权限，调整文件夹权限即可解决。