行政调解档案管理系统从零部署到功能落地全流程实操指南

发布时间: 2026年08月22日 12:25:03 来源: 安答联动浏览量: 0

一、前期环境准备

本系统基于Java生态开发，所有依赖均提供官方安装命令，无需自行找资源下载，服务器最低配置要求为2核4G内存、50G云硬盘、CentOS7.9及以上操作系统。

1.1 基础依赖安装

安装JDK1.8：运行命令 yum install -y java-1.8.0-openjdk-devel，安装完成后执行java -version，返回版本号为1.8.x即为成功

安装MySQL5.7：依次运行以下命令

行政调解档案管理系统从零部署到功能落地全流程实操指南


rpm -ivh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2022
yum install -y mysql-community-server
systemctl start mysqld
systemctl enable mysqld

获取初始密码：grep 'temporary password' /var/log/mysqld.log，登录MySQL后执行以下命令修改密码并开启远程访问：


ALTER USER 'root'@'localhost' IDENTIFIED BY 'Admin@2024';
GRANT ALL PRIVILEGES ON . TO 'root'@'%' IDENTIFIED BY 'Admin@2024' WITH GRANT OPTION;
FLUSH PRIVILEGES;

安装Nginx：运行命令 yum install -y nginx，执行systemctl start nginx && systemctl enable nginx启动服务
安装解压工具：运行yum install -y unzip，避免后续解压安装包失败

二、系统部署实操

2.1 后端服务部署

下载系统安装包与初始化脚本：依次运行


mkdir -p /opt/mediation/
cd /opt/mediation/
wget https://gitee.com/public-admin/mediation-archive/releases/download/v1.0/mediation-admin.jar
wget https://gitee.com/public-admin/mediation-archive/releases/download/v1.0/init.sql

创建数据库并导入初始数据：登录MySQL执行create database mediation_archive default charset utf8mb4;，退出后运行mysql -uroot -pAdmin@2024 mediation_archive < init.sql

创建配置文件：在/opt/mediation/目录下新建application.yml，完整内容如下，可直接复制使用：

```yaml
server:
port: 8080
spring:
datasource:
url: jdbc:mysql://localhost:3306/mediation_archive?useUnicode=true&characterEncoding=utf8&useSSL=false
username: root
password: Admin@2024
driver-class-name: com.mysql.jdbc.Driver
servlet:
multipart:
max-file-size: 100MB
max-request-size: 100MB
file:
upload-path: /opt/mediation/upload/
```

启动后端服务：先创建上传目录mkdir -p /opt/mediation/upload/ && mkdir -p /opt/mediation/logs/，再运行启动命令nohup java -jar mediation-admin.jar > /opt/mediation/logs/admin.log 2>&1 &，执行curl http://localhost:8080/health返回{"code":200,"msg":"success"}即为部署成功

2.2 前端页面部署

下载前端包：运行wget https://gitee.com/public-admin/mediation-archive/releases/download/v1.0/dist.zip
解压到Nginx目录：unzip dist.zip -d /usr/share/nginx/html/mediation/

配置Nginx反向代理：新建/etc/nginx/conf.d/mediation.conf文件，完整内容如下，将server_name替换为你的服务器公网IP：

```nginx
server {
listen 80;
server_name 你的服务器公网IP;
location / {
root /usr/share/nginx/html/mediation/dist;
index index.html index.htm;
try_files $uri $uri/ /index.html;
}
location /prod-api/ {
proxy_pass http://localhost:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```

重载Nginx配置：执行nginx -t验证配置无错误后，运行nginx -s reload生效
注意：云服务器需要在安全组规则中放行80端口，否则外部无法访问，访问服务器IP即可进入系统，默认账号admin，密码123456

三、核心功能落地配置

3.1 基础配置操作

新增调解类别：登录系统后进入【系统管理】-【字典管理】，找到“mediation_type”字典项，新增你单位需要的调解类别，比如邻里纠纷、劳务纠纷、消费纠纷等，排序号可自行调整
配置档案模板：进入【档案管理】-【模板配置】，上传你单位的调解协议书Word模板，模板中需要动态填充的内容用{{变量名}}标注，支持的变量包括：调解申请人、被申请人、调解时间、调解事由、调解结果，上传后点击【测试生成】，验证模板可正常导出PDF即可
权限分配：进入【系统管理】-【角色管理】，新增“调解专员”角色，勾选“档案录入、档案查询、模板查看”权限，新增“档案管理员”角色勾选全部权限，之后在【用户管理】中给对应工作人员分配角色即可

3.2 日常操作流程

档案录入：调解专员进入【档案管理】-【新增档案】，填写纠纷基本信息、上传调解过程佐证材料，提交后自动生成电子档案，支持一键导出PDF版调解协议书
档案查询：在【档案管理】-【档案列表】中，可通过调解时间、当事人姓名、纠纷类型多维度筛选，点击档案编号可查看完整档案内容，操作日志永久留存
跨部门调取：需要调取其他部门调解档案的，进入【档案管理】-【调取申请】，填写调取事由、调取期限，提交后对方管理员审核通过即可查看对应档案

四、运维与问题排查

4.1 自动备份配置

为避免数据丢失，需配置每日自动备份，创建/opt/mediation/backup.sh脚本，完整内容如下：

```bash
!/bin/bash
back_time=`date +%Y%m%d%H%M`
mkdir -p /opt/mediation/backup/
mysqldump -uroot -pAdmin@2024 mediation_archive > /opt/mediation/backup/mediation_$back_time.sql
保留最近30天的备份文件
find /opt/mediation/backup/ -mtime +30 -name ".sql" -exec rm -rf {} \;
```

给脚本加权限：chmod +x /opt/mediation/backup.sh，执行crontab -e添加定时任务，新增一行0 1 /opt/mediation/backup.sh，保存后即可实现每天凌晨1点自动备份数据库。

4.2 常见问题排查

访问系统提示502错误：先运行ps -ef|grep java查看后端服务是否启动，未启动则重新执行后端启动命令；若服务正常运行，执行nginx -t检查Nginx配置是否正确
档案上传失败：先执行chmod 777 /opt/mediation/upload给上传目录赋权，若仍失败可调整application.yml中的max-file-size参数，扩大单文件上传上限
忘记管理员密码：登录MySQL执行更新语句UPDATE sys_user SET password = '$2a$10$7JB720yubVSzh2WtV9QK/.U3g7a9c76Kf96X2dG8c9a72f59e6a7a' WHERE user_name = 'admin';，执行后密码重置为123456