海西蒙古族藏族自治州档案软件本地部署及基础使用实操指南

部署前准备

1.1 硬件环境要求

仅需满足以下基础条件即可运行：CPU≥2核，内存≥4GB，磁盘可用空间≥10GB，操作系统为Windows 10 64位或更高版本。

1.2 依赖软件安装

必须安装Java 11运行环境，执行以下命令一键完成安装：

``` winget install Oracle.JDK.11 ```

等待安装完成后，打开命令提示符执行`java -version`，显示对应版本信息即为安装成功。

软件部署实操步骤

2.1 下载官方安装包

点击以下官方地址下载完整安装包：http://daqing.haixi.gov.cn/software/haixi-archive-system-v1.2.0.zip，安装包大小约800MB，无第三方捆绑插件。

2.2 解压安装包

将下载的zip包解压到C:\ArchiveSoftware目录（若目录不存在则自动创建），解压后目录包含5个核心文件/文件夹：主程序jar包、核心配置文件、SQLite数据库目录、运行日志目录、临时文件目录。

2.3 配置核心参数

用Windows记事本打开C:\ArchiveSoftware\application.properties，必须修改以下3项关键配置（其余项保持默认即可）：

``` 数据库路径配置（确保data目录已生成） spring.datasource.url=jdbc:sqlite:./data/archive.db 系统管理员初始密码（建议设置为8位以上字母+数字组合，避免与示例重复） system.admin.password=Haixi2024@ArchiveSys 档案文件上传存储路径 file.upload.path=./uploadfiles ```

修改完成后直接保存文件，无需额外编译或调整权限。

2.4 启动系统服务

以管理员身份打开命令提示符，依次执行以下命令启动服务：

``` cd C:\ArchiveSoftware java -jar haixi-archive-system-v1.2.0.jar --server.port=8080 ```

等待30秒左右，命令提示符显示“Started ArchiveApplication in X seconds”（X为实际耗时），即为系统启动成功。

基础功能实操

3.1 系统登录与首次密码修改

打开任意浏览器输入http://localhost:8080，使用初始管理员账号admin，密码为你在application.properties中设置的system.admin.password值。首次登录必须立即修改密码，否则系统将限制后续操作权限。

3.2 档案批量导入（CSV格式）

准备符合要求的档案CSV文件，必须包含以下列名（列顺序可调整）：id（档案唯一编号）、archivetitle（档案标题）、archivecode（档案分类编码）、createTime（档案创建时间，格式为YYYY-MM-DD）。示例文件内容：

``` id,archivetitle,archivecode,createTime 2024001,海西蒙古族藏族自治州2023年度档案汇总,HAXI-2023-001,2024-01-15 2024002,德令哈市基层单位人事档案目录,HAXI-2023-002,2024-01-20 2024003,乌兰县项目审批档案汇编,HAXI-2023-003,2024-01-25 ```

登录系统后点击左侧菜单栏“档案管理”→“批量导入”，选择已准备好的CSV文件，点击“确认导入”，系统会自动校验数据格式，错误项会弹出具体提示（如列名缺失、日期格式错误），无需手动排查。

3.3 档案查询与导出

在“档案查询”页面，输入档案编号或标题关键词，点击“搜索”即可获取匹配结果；选择需要导出的档案条目后点击“导出Excel”，系统会自动生成并下载对应档案的Excel文件，无需额外设置导出格式。

常见问题解决

1. 启动失败：检查命令提示符是否以管理员身份运行，执行`java --version`确认Java版本为11，若版本不符需重新安装对应版本。

2. 导入失败：核对CSV文件列名是否完全匹配要求，删除空行或含特殊符号的条目后重试。

3. 无法访问系统：关闭Windows防火墙，执行`netstat -ano | findstr :8080`查看端口占用情况，若端口被其他程序占用，停止对应程序后重启系统即可。