探矿许可证数字档案馆系统本地部署及核心功能实操全指南

一、前置环境准备

所有操作基于CentOS 7.9系统，其他系统可对应调整命令，硬件要求为2核4G内存、50G以上可用存储。

1. 基础依赖安装

依次执行以下命令安装所有依赖，全程无需手动选择参数：

```bash 安装JDK1.8 yum install -y java-1.8.0-openjdk-devel 验证JDK安装，返回版本号即成功 java -version 安装MySQL8.0 rpm -ivh https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm yum install -y mysql-community-server systemctl start mysqld systemctl enable mysqld 安装MinIO（用于存储许可证扫描件） wget https://dl.min.io/server/minio/release/linux-amd64/minio -P /usr/local/bin/ chmod +x /usr/local/bin/minio mkdir -p /data/minio 启动MinIO，设置自定义密钥，请勿修改端口号 nohup minio server /data/minio --address ":9000" --console-address ":9001" --access-key minioadmin --secret-key minioadmin@2024 & 安装Nginx yum install -y nginx systemctl start nginx systemctl enable nginx ```

2. 依赖配置验证

执行`ss -tulnp | grep -E '3306|9000|80'`，返回三个端口的监听信息即环境准备完成。

二、系统部署实操

1. 获取安装包

执行以下命令下载官方稳定版安装包并解压：

```bash wget https://gitee.com/land-resource-tools/prospecting-license-archive/releases/download/v1.0.0/prospecting-archive-v1.0.0.tar.gz -P /opt/ cd /opt && tar -zxvf prospecting-archive-v1.0.0.tar.gz ```

2. 数据库初始化

先获取MySQL初始密码：`grep 'temporary password' /var/log/mysqld.log`，登录MySQL后执行以下语句完成库表初始化：

```sql -- 创建数据库 create database prospecting_archive default character set utf8mb4 collate utf8mb4_general_ci; -- 创建专用账号，可自行修改密码 create user 'archive_user'@'%' identified by 'Archive@2024'; grant all on prospecting_archive. to 'archive_user'@'%'; flush privileges; -- 导入初始数据 use prospecting_archive; source /opt/prospecting-archive/sql/init.sql; ```

3. 系统配置修改

打开`/opt/prospecting-archive/config/application.yml`文件，替换为以下完整配置，仅需修改IP相关参数即可，其他字段无需调整：

```yaml server: port: 8080 servlet: context-path: / spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://你的服务器IP:3306/prospecting_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: archive_user password: Archive@2024 servlet: multipart: max-file-size: 100MB max-request-size: 100MB minio: endpoint: http://你的服务器IP:9000 accessKey: minioadmin secretKey: minioadmin@2024 bucket: prospecting-license ```

4. 启动服务与反向代理配置

首先启动系统服务：

```bash cd /opt/prospecting-archive nohup java -Xms2G -Xmx2G -jar prospecting-archive.jar --spring.profiles.active=prod & 验证启动，返回启动成功日志即正常 tail -f nohup.out ```

然后编辑`/etc/nginx/conf.d/archive.conf`文件，添加以下反向代理配置：

```nginx server { listen 80; server_name 你的服务器公网IP或绑定的域名; client_max_body_size 100M; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } location /minio { proxy_pass http://127.0.0.1:9000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } gzip on; gzip_types image/jpeg image/png application/pdf application/vnd.ms-excel; gzip_min_length 1k; } ```

最后执行以下命令开放端口并重启Nginx：

```bash firewall-cmd --add-port=80/tcp --add-port=3306/tcp --add-port=9000/tcp --permanent firewall-cmd --reload nginx -t && systemctl restart nginx ```

此时访问服务器IP即可打开系统登录页，默认账号为`admin`，默认密码为`Admin@123`，首次登录必须强制修改密码。

三、核心功能实操

1. 存量许可证批量导入

• 步骤1：进入【数据管理】-【批量导入】模块，下载官方Excel模板，不得修改模板列名和顺序
• 步骤2：按模板字段填写信息，必填字段为：许可证编号、探矿权人、勘查面积、有效起始日期、有效结束日期、发证机关、扫描件相对路径
• 步骤3：将所有许可证扫描件上传到MinIO的`prospecting-license`桶中，路径和模板中填写的相对路径完全一致，区分大小写
• 步骤4：上传填写完成的Excel模板，系统自动校验，校验不通过会返回具体错误行和原因，修改后重新上传即可，校验通过后数据自动入库

2. 许可证全生命周期管理

• 新增许可证：进入【许可证管理】-【新增】，填写所有必填字段，上传扫描件后提交，系统自动生成唯一档案编号，支持自动查重
• 变更登记：找到对应许可证点击【变更】，修改变更字段并上传变更证明材料，系统自动留存所有变更历史，支持任意版本回溯
• 过期预警：进入【系统设置】-【预警配置】，设置提前预警天数（默认90天），系统每日自动扫描即将过期的许可证，推送站内通知给对应负责人

3. 查询与权限配置

• 查询操作：支持按许可证编号、探矿权人、发证时间、勘查区域多维度模糊查询，查询结果可导出Excel和PDF，导出操作全程留痕
• 权限配置：进入【系统管理】-【角色管理】，新增角色并配置对应权限（普通用户仅可查询、管理员可编辑删除、审计员仅可查看操作日志），关联对应用户账号即可
• 日志审计：进入【日志管理】模块，可查看所有用户的操作记录，包括查询、修改、导出、删除操作，支持按时间、用户、操作类型筛选

四、常见问题排查

1. 批量导入失败

优先排查三个点：一是检查Excel模板是否为官方最新版本，未修改列名；二是检查扫描件路径和MinIO中的路径完全一致，无空格、大小写错误；三是检查许可证编号是否重复，系统不允许同一编号重复录入。

2. 系统访问卡顿

执行`free -h`查看可用内存，小于1G的话调整启动命令的堆内存参数，将`-Xms2G -Xmx2G`调整为符合服务器内存的数值；扫描件加载慢的话确认Nginx配置中已开启gzip压缩，大文件可提前压缩后上传。

3. 预警通知不触发

检查服务器时间是否为东八区北京时间，执行`timedatectl set-timezone Asia/Shanghai`修正时区，确认预警配置中的预警天数大于0，且对应负责人账号已配置通知权限。