从零搭建符合机关规范的开封本地档案管理系统实操全指南

前期准备：所需工具与环境配置

本次搭建基于开源框架适配开封市机关档案分类标准，普通Windows电脑即可运行，无需云服务器，所有工具均提供直接下载地址，可直接操作：

• JDK1.8 64位：直接下载地址：https://download.oracle.com/java/8/latest/jdk-8u391-windows-x64.exe，双击后一直点下一步默认安装即可
• MySQL8.0 免安装版：直接下载地址：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-8.0.35-winx64.zip，下载后解压到D盘根目录即可
• 开源档案管理源码包：直接访问https://gitee.com/yanue/ext-archive.git，点击页面右上角【下载ZIP】即可获取

JDK环境变量配置步骤

• 右键桌面【此电脑】→【属性】→【高级系统设置】→【环境变量】
• 在系统变量区域点击【新建】，变量名输入JAVA_HOME，变量值填写默认安装路径C:\Program Files\Java\jdk1.8.0_391，点击确定
• 找到系统变量中的Path，双击编辑，点击新建，依次添加两条：%JAVA_HOME%\bin、%JAVA_HOME%\jre\bin，依次点击确定保存所有设置
• 按下Win+R输入cmd回车，输入命令java -version，输出显示java version "1.8.x"说明配置成功

MySQL初始化配置

将下载好的MySQL压缩包解压到D盘根目录，得到路径D:\mysql-8.0.35-winx64，按以下步骤操作：

• 在解压目录新建空白文件，重命名为my.ini，用记事本打开，粘贴以下完整配置，直接保存关闭即可：

``` [mysqld] basedir=D:\\mysql-8.0.35-winx64 datadir=D:\\mysql-8.0.35-winx64\\data port=3306 character-set-server=utf8mb4 default-authentication-plugin=mysql_native_password ```

• 以管理员身份打开cmd，依次输入以下命令，每条输入后回车执行：

``` cd D:\mysql-8.0.35-winx64\bin mysqld --initialize-insecure --user=mysql mysqld install net start mysql ```

输出显示MySQL 服务已经启动成功说明配置完成，初始root账号无密码，不需要额外设置密码。

系统部署与开封档案分类适配

将下载好的源码包解压到D盘根目录，路径为D:\ext-archive，接下来修改配置：

1. 修改数据库配置

打开路径D:\ext-archive\src\main\resources\application.properties，用记事本打开，删除原有内容，替换成以下完整配置，直接保存即可：

``` 数据库配置 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/ext_archive?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai spring.datasource.username=root spring.datasource.password= 服务端口 server.port=8080 档案电子文件存储路径 file.storePath=D:/ext_archive/files ```

2. 启动系统导入开封标准分类

在D盘ext-archive目录下找到已经编译好的ext-archive.jar，打开cmd，输入以下命令启动系统：

``` cd D:\ext-archive java -jar ext-archive.jar ```

等待1-2分钟，控制台输出Started ExtArchiveApplication in x seconds说明启动完成，打开浏览器输入地址http://localhost:8080即可进入系统。

• 默认管理员账号：admin，默认密码：admin123
• 登录后点击左侧菜单【档案管理】→【分类管理】，点击右上角【删除原有分类】，再点击【导入分类】，复制粘贴以下适配开封机关规范的分类JSON，点击确定即可完成导入：

```json [ {"name":"党群类","code":"DQ","children":[{"name":"党员管理","code":"DQ01"},{"name":"组织建设","code":"DQ02"},{"name":"纪检监察","code":"DQ03"},{"name":"群团工作","code":"DQ04"}]}, {"name":"行政类","code":"XZ","children":[{"name":"公文函件","code":"XZ01"},{"name":"会议纪要","code":"XZ02"},{"name":"行政审批","code":"XZ03"},{"name":"劳资人事","code":"XZ04"}]}, {"name":"项目基建类","code":"JJ","children":[{"name":"项目审批","code":"JJ01"},{"name":"工程档案","code":"JJ02"},{"name":"验收材料","code":"JJ03"}]}, {"name":"会计档案类","code":"KJ","children":[{"name":"会计凭证","code":"KJ01"},{"name":"会计账簿","code":"KJ02"},{"name":"财务报表","code":"KJ03"}]}, {"name":"声像实物类","code":"SX","children":[{"name":"照片档案","code":"SX01"},{"name":"音视频档案","code":"SX02"},{"name":"实物档案","code":"SX03"}]} ] ```

日常操作核心步骤

1. 档案录入

点击左侧菜单【档案管理】→【新增档案】，按提示填写信息：选择预设好的开封标准分类，填写档案编号、题名、年度，选择保管期限（永久/30年/10年，符合开封档案管理要求），上传电子扫描件，支持PDF、JPG、PNG格式，点击保存即可完成录入。

2. 档案查询与借阅

在首页搜索框输入档案题名、编号、任意关键词即可快速检索，需要借阅时点击申请借阅，管理员审批后即可下载电子档案，系统自动留存借阅审批记录，满足档案溯源要求。

3. 数据备份

建议每周备份一次档案数据，操作步骤：打开cmd输入以下命令，执行完成后将备份文件拷贝到U盘即可：

``` cd D:\mysql-8.0.35-winx64\bin mysqldump -u root ext_archive > D:\ext-archive\archive_backup.sql ```

同时将D盘D:\ext-archive\files目录的电子文件一起备份即可。

常见问题解决

• 启动提示端口占用：打开application.properties，将server.port=8080修改为server.port=8081，保存后重新启动即可
• 数据库连接失败：右键任务管理器→服务，找到MySQL服务，点击启动即可，若还是失败检查my.ini配置文件的路径是否正确
• 文件上传失败：检查D盘ext-archive目录是否有写入权限，默认Windows系统无需修改，足够容纳100MB以内的单份档案，满足日常需求