吴忠档案管理系统从零搭建本地部署全流程实操落地指南

前期环境准备

安装依赖工具

本次部署需要3款基础工具，直接下载对应版本即可：

• JDK 11 64位 Windows版：https://download.oracle.com/java/11/latest/jdk-11_windows-x64_bin.exe
• MySQL 8.0 社区版：https://cdn.mysql.com/Downloads/MySQL-8.0/mysql-installer-community-8.0.35.0.msi
• Maven 3.9.5 压缩包：https://dlcdn.apache.org/maven/maven-3/3.9.5/binaries/apache-maven-3.9.5-bin.zip

安装完成后配置环境变量：新建系统变量JAVA_HOME，值为JDK安装目录；新建系统变量MAVEN_HOME，值为Maven解压目录；将%JAVA_HOME%\bin和%MAVEN_HOME%\bin追加到系统Path变量中。配置完成后打开命令提示符，输入java -version和mvn -version，能正常输出版本号即配置成功。

获取项目源码

本地已安装Git的，执行命令克隆源码： ``` git clone https://gitee.com/wuzhong-open/archive-management-system.git ```

未安装Git的，直接访问上述地址下载源码压缩包，解压到纯英文路径即可，禁止放在含中文、空格的路径中，避免编译报错。

数据库配置操作

打开MySQL命令行或Navicat可视化工具，按以下步骤操作：

1. 执行SQL创建数据库： ``` CREATE DATABASE wuzhong_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ```
2. 导入初始化SQL：项目源码sql目录下有wuzhong_archive_init.sql，命令行导入执行： ``` mysql -u你的MySQL用户名 -p wuzhong_archive < 源码解压路径/sql/wuzhong_archive_init.sql ``` 可视化操作：右键新建的wuzhong_archive数据库，选择运行SQL文件，选中上述文件执行即可。
3. 修改项目连接配置：打开src/main/resources/application.yml，替换为以下可直接复制的配置： ``` spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/wuzhong_archive?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai username: 替换为你的MySQL用户名 password: 替换为你的MySQL密码 ``` 注意：使用MySQL 5.x版本，需要将driver-class-name改为com.mysql.jdbc.Driver

项目打包与启动

编译打包

打开命令提示符，切换到项目源码根目录，执行打包命令跳过测试编译： ``` mvn clean package -DskipTests ``` 打包完成后，根目录会生成target文件夹，文件夹内有可执行文件archive-system-1.0.0.jar。

启动运行

继续在当前窗口执行启动命令： ``` java -jar target/archive-system-1.0.0.jar ```

等待1-2分钟，控制台输出 Started ArchiveSystemApplication 即启动成功，弹出防火墙提示时选择允许内网访问即可。

系统初始化与使用

管理员登录

打开浏览器，访问地址 http://127.0.0.1:8080/wzarchive，输入默认管理员账号：admin，默认密码：admin123456，点击登录进入管理后台。

基础参数配置

首次登录需完成3项符合吴忠市档案管理规范的配置：

• 单位信息配置：左侧菜单选择【系统管理】→【单位信息】，填写单位全称、统一社会信用代码、地址，保存后信息自动同步到档案打印模板。
• 档案分类配置：左侧菜单选择【档案管理】→【分类管理】，系统默认已按要求创建党群类、行政类、业务类、基建类、会计类、特殊载体类6个一级分类，可按需新增二、三级子分类。
• 权限配置：左侧菜单选择【系统管理】→【用户管理】，点击新增用户，为不同岗位分配权限：普通员工仅开放查询权限，档案管理员开放录入、归档权限。

核心功能操作

配置完成即可正常使用，核心操作流程：

• 档案录入：选择【档案管理】→【档案录入】，选中对应分类，填写题名、责任者、文号、形成日期等必填项，上传电子扫描件后保存。
• 档案归档：信息核对无误后，在待归档列表点击【归档】，档案移入正式库，不可随意修改。
• 档案检索：支持按文号、题名、形成年份多条件搜索，搜索结果可直接在线预览、下载电子档。

常见问题排查

• 启动提示数据库连接失败：检查MySQL服务是否启动，数据库名、用户名、密码是否正确，MySQL 8.0可执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';修改加密规则解决兼容问题。
• 8080端口被占用无法启动：打开application.yml，添加配置server.port=8090，保存后重启，访问地址改为http://127.0.0.1:8090/wzarchive即可。
• 打包提示依赖下载超时：打开Maven目录下conf/settings.xml，在节点内添加以下阿里云镜像配置： ``` aliyunmaven https://maven.aliyun.com/repository/public ``` 保存后重新打包即可解决。