行政复议档案管理系统本地部署+功能配置全流程实操指南

一、前置环境准备

所有环境版本需严格匹配，避免兼容性问题，可通过对应命令验证版本：

• JDK 11：验证命令 java -version，返回版本号含11即为符合
• MySQL 8.0：验证命令 mysql --version，返回版本号含8.0即为符合
• Redis 6.x：验证命令 redis-cli ping，返回PONG即为正常运行
• Node.js 16.x：验证命令 node -v，返回版本号含v16即为符合
• Maven 3.6+：验证命令 mvn -v，返回版本号≥3.6即为符合

执行以下命令拉取官方适配政务场景的开源源码：

```bash git clone https://gitee.com/openGov/administrative-reconsideration-archive.git ```

二、后端服务部署

2.1 初始化数据库

执行以下命令创建数据库并导入初始化表结构：

```bash mysql -u root -p 输入MySQL密码后执行 create database reconsideration_archive character set utf8mb4; use reconsideration_archive; source 你本地存放源码的路径/sql/reconsideration_archive.sql; exit; ```

2.2 修改配置文件

打开源码目录下的 src/main/resources/application-prod.yml，直接复制以下完整配置，仅需修改对应位置的密码、存储路径即可：

```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/reconsideration_archive?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: 替换为你自己的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 password: 替换为你自己的Redis密码，无密码则留空 database: 0 servlet: multipart: max-file-size: 100MB max-request-size: 100MB file: upload-path: /home/archive/upload Windows系统替换为D:/archive/upload backup: path: /home/archive/backup Windows系统替换为D:/archive/backup ```

2.3 启动后端服务

在源码根目录执行以下命令打包：

```bash mvn clean package -Dmaven.test.skip=true ```

打包完成后执行以下命令启动后台服务：

```bash nohup java -jar target/reconsideration-archive-1.0.0.jar --spring.profiles.active=prod & ```

启动后执行 curl http://localhost:8080/doc.html，返回接口文档HTML内容即为启动成功。

三、前端页面部署

3.1 前端打包

进入前端目录 cd admin-ui，执行以下命令安装依赖（使用国内镜像避免下载失败）：

```bash npm install --registry=https://registry.npmmirror.com ```

打开前端目录下的 .env.prod 文件，修改为 VUE_APP_BASE_API = 'http://你的服务器IP:8080'，保存后执行打包命令：

```bash npm run build:prod ```

打包完成后会生成dist文件夹，将该文件夹上传到服务器的 /usr/share/nginx/html 目录下。

3.2 Nginx配置

打开Nginx配置文件 /etc/nginx/conf.d/archive.conf，复制以下完整配置，仅需修改IP和路径即可：

```nginx server { listen 80; server_name 替换为你的服务器IP或绑定的域名; root /usr/share/nginx/html/dist; index index.html index.htm; 适配前端路由 location / { try_files $uri $uri/ /index.html; } 代理后端接口 location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } 附件访问配置 location /upload/ { alias /home/archive/upload/; 和后端配置的upload-path保持一致 } } ```

执行 nginx -t 验证配置正确后，执行 nginx -s reload 重载配置，此时访问服务器IP即可进入登录页，默认账号：admin，默认密码：123456，首次登录请强制修改密码。

四、核心功能适配配置

4.1 档案类目配置

登录后进入【系统设置-档案类目管理】，点击新增，依次添加6个一级类目：「复议申请材料」「受理通知书」「答复材料」「听证记录」「复议决定书」「送达回执」，每个类目勾选允许上传附件、允许标记密级、自动生成归档编号，保存后批量启用。

4.2 归档流程配置

进入【工作流设置-归档流程】，导入源码根目录下的 reconsideration_archive_flow.bpmn20.xml 流程模板，按实际组织架构配置节点审批人：录入节点绑定复议窗口人员角色，审核节点绑定复议科负责人角色，归档节点绑定档案室管理员角色，每个节点开启逾期3天自动提醒、驳回需填写驳回原因配置。

4.3 权限规则配置

进入【角色管理】，分别配置4个核心角色权限：

• 窗口人员：仅可录入、提交本人对接的复议案件档案
• 办案人员：仅可查看、编辑本人主办案件的所有档案
• 档案管理员：可全量查看、审核、归档所有案件档案
• 公众查询：仅可检索已公开的复议决定书，不可查看其他档案

五、政务合规性配置

进入【系统设置-备份管理】，设置每日凌晨2点全量备份数据库+附件，备份文件保留180天，备份路径配置到非系统盘的专属目录。

进入【系统设置-审计日志】，开启全量操作审计，所有登录、查看、下载、修改、删除档案的操作全部记录日志，日志设置为不可删除，保留周期3年。

进入【系统设置-涉密管理】，开启涉密档案管控，标记为绝密/机密/秘密的档案仅管理员可查看，下载需提交审批，审批通过后下载的文件自动添加经办人姓名+时间的水印。

六、常见问题排查

• 后端启动报错：检查MySQL是否开启远程访问，执行命令 GRANT ALL ON . TO 'root'@'%' IDENTIFIED BY '你的MySQL密码'; FLUSH PRIVILEGES; 即可解决
• 前端跨域报错：检查前端.env.prod里的IP是否和服务器IP一致，Nginx代理配置是否正确
• 附件上传失败：执行 chmod 777 后端配置的upload-path路径 给目录开通读写权限
• 归档编号重复：进入【系统设置-编号规则】，设置编号规则为「复议年份+6位流水号」，开启流水号每年自动清零即可