水利工程档案管理软件本地部署与日常归档管理全实操指南
一、前期准备工作
1.1 环境依赖下载安装
本次实操基于可免费使用的开源水利工程档案管理程序，所有工具提供直链，按步骤下载即可，无付费内容：
- JDK8（软件运行依赖）：Windows64位直链：
https://github.com/adoptium/temurin8-binaries/releases/download/jdk8u382-b05/OpenJDK8U-jdk_x64_windows_hotspot_8u382b05.msi，双击按默认提示安装即可 - MySQL5.7（数据存储）：Windows64位免安装直链：
https://cdn.mysql.com/archives/mysql-5.7/mysql-5.7.42-winx64.zip，下载后解压到D盘根目录 - 水利工程档案管理软件包：直链：
https://gitee.com/huasic/water-archive-management/raw/master/package/water-archive.zip，下载后解压到D盘根目录，所有路径不要包含中文，否则会启动失败
1.2 环境配置验证
Windows环境配置步骤：
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在系统变量点击「新建」，变量名填
JAVA_HOME，变量值填JDK默认安装路径C:\Program Files\AdoptOpenJDK\jdk-8.0.382.5-hotspot，点击确定 - 找到系统变量中的
Path，双击编辑，新建两条内容：%JAVA_HOME%\bin、D:\mysql-5.7.42-winx64\bin，点击确定保存所有设置 - 打开CMD命令提示符，依次输入以下命令验证，输完回车，输出版本信息即为配置成功： ``` java -version mysql -V ```
初始化MySQL：打开CMD，依次执行以下命令，完成后记住设置的新密码：
```
mysqld --initialize --console
mysqld install
net start mysql
```
执行第一条命令后，CMD最后一行会输出root用户的临时密码，复制备用；执行最后一条命令后，输入mysql -u root -p，粘贴临时密码回车，然后输入以下命令修改密码：
```
ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';
```
二、软件部署配置
2.1 初始化数据库
在当前MySQL命令行中，依次执行以下命令，完成数据库创建和初始数据导入： ``` CREATE DATABASE water_archive DEFAULT CHARACTER SET utf8mb4; EXIT; mysql -u root -p123456 water_archive < D:\water-archive\sql\init.sql ```
2.2 修改启动配置
用记事本打开D:\water-archive\application.yml，直接替换为以下完整配置，如果你修改了MySQL密码，把下方password改为你自己的密码即可： ``` server: port: 8080 servlet: context-path: /water spring: datasource: druid: url: jdbc:mysql://localhost:3306/water_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver file: upload-path: D:/water-archive/files ``` 保存后关闭文件即可。
2.3 启动验证
进入D:\water-archive目录，双击start.bat，等待1-2分钟，窗口出现「Started Application」字样即为启动成功；打开浏览器，输入地址http://localhost:8080/water，能看到登录页即为部署成功，默认登录账号：admin，密码：123456
三、核心日常操作步骤
3.1 项目建档
登录系统后，点击左侧菜单栏基础配置→项目信息管理，点击右上角「新增项目」，填写带的必填项：项目名称、项目编号、建设单位、开工时间、竣工时间、所属流域，填写完成点击保存，即完成项目基础建档，后续所有档案都归属到对应项目下。
3.2 档案分类与归档
系统默认已经按照《水利工程建设项目档案管理规定》预设了标准分类，包含工程前期文件、监理文件、施工文件、竣工图、竣工验收文件等8个一级分类，不需要修改可直接使用，如需新增分类点击左侧档案管理→档案分类→「新增」即可。
单份档案归档步骤：
- 点击左侧档案管理→档案归档，点击右上角「新增归档」
- 选择归属项目、对应档案分类，填写档案编号、档案名称、编制单位、编制日期，带为必填项
- 点击「上传附件」，上传档案的扫描件、原图或设计文档，支持PDF、JPG、DWG、DOCX等所有常用格式，批量上传单次最多支持20个文件
- 点击「保存」，即完成归档，档案会自动录入索引库支持检索
3.3 档案检索与借阅
检索：在系统首页搜索框输入档案编号、关键词、项目名称，点击搜索即可调出对应档案，也可以点击左侧「高级搜索」，按分类、时间、编制单位多条件筛选。
借阅：找到需要借阅的档案，点击右侧「申请借阅」，填写借阅时长和用途，提交后由档案管理员审核，审核通过后即可在线查看或下载原文件，系统会自动记录借阅日志。
3.4 定期数据备份
水利工程档案需定期备份，操作步骤：点击左侧系统管理→数据备份，点击「立即备份」，系统会同时备份数据库和所有附件，备份文件默认存储在D:\water-archive\backup目录，建议每周备份一次，可将该目录设置为云盘同步文件夹，自动异地备份。
四、常见卡壳问题排查
- 启动后打不开登录页：首先检查MySQL服务是否正常启动，打开CMD输入
net start mysql提示服务已经启动即为正常；其次检查配置文件中的MySQL密码是否正确，端口8080是否被其他程序占用，如果被占用修改application.yml中的port为其他端口（如8081）后重启即可 - 上传附件失败：检查D:\water-archive\files文件夹是否存在，磁盘空间是否足够，上传的文件名称不要包含特殊字符（如、？、&），修改文件名后重新上传即可
- 管理员密码忘记：打开CMD连接MySQL，执行以下命令即可重置密码为123456： ``` UPDATE water_archive.sys_user SET password='e10adc3949ba59abbe56e057f20f883e' WHERE username='admin'; ```
相关文章
