B/S版档案管理软件评优功能部署配置及落地实操全指南

一、前期环境准备

1.1 服务器及依赖要求

最低配置：2核4G云服务器，系统支持CentOS7.9+/Ubuntu22.04+，预装软件版本固定如下：

• JDK1.8
• MySQL5.7
• Nginx1.20+

依赖安装命令（CentOS为例，Ubuntu替换yum为apt即可）：

``` 安装JDK1.8 yum install -y java-1.8.0-openjdk 安装MySQL5.7 yum install -y mysql-community-server systemctl start mysqld && systemctl enable mysqld 安装Nginx yum install -y nginx systemctl start nginx && systemctl enable nginx ```

1.2 数据库初始化

登录MySQL执行以下语句，直接复制即可使用：

``` create database archives default character set utf8mb4 collate utf8mb4_general_ci; grant all on archives. to 'archives_user'@'%' identified by 'Archives@2024'; flush privileges; ```

二、B/S版档案软件部署步骤

2.1 后端服务部署

执行以下命令下载开源B/S版档案系统后端包：

``` wget https://mirror.ghproxy.com/https://github.com/lanTaiOrg/archives/releases/download/v2.5.0/archives-admin.jar ```

在同目录下创建application.yml配置文件，完整内容如下，可直接复制：

``` server: port: 8080 spring: datasource: url: jdbc:mysql://你的服务器IP:3306/archives?useUnicode=true&characterEncoding=utf8&useSSL=false username: archives_user password: Archives@2024 driver-class-name: com.mysql.jdbc.Driver 评优模块专属配置 assessment: enable: true upload-path: /data/archives/assessment/ score-offset-limit: 20 ```

注意：将配置中“你的服务器IP”替换为实际服务器公网IP，提前创建/data/archives/assessment/目录，执行命令mkdir -p /data/archives/assessment/

启动后端服务命令：

``` nohup java -jar archives-admin.jar --spring.config.location=./application.yml > app.log 2>&1 & ```

验证启动成功：执行curl http://localhost:8080/actuator/health，返回{"status":"UP"}即为成功。

2.2 前端页面部署

执行以下命令下载前端包并解压：

``` wget https://mirror.ghproxy.com/https://github.com/lanTaiOrg/archives/releases/download/v2.5.0/archives-ui.tar.gz tar -zxvf archives-ui.tar.gz -C /usr/share/nginx/html/ ```

修改Nginx配置文件/etc/nginx/nginx.conf，在http块内新增以下server配置，直接复制即可：

``` server { listen 80; server_name 你的服务器IP; root /usr/share/nginx/html/archives-ui; index index.html; 解决单页面刷新404问题 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; } } ```

注意替换配置中“你的服务器IP”为实际公网IP，执行nginx -t检查配置无误后，执行systemctl restart nginx重启Nginx

部署完成后访问http://你的服务器IP，默认管理员账号：admin，默认密码：Admin@1234。

三、评优功能核心配置实操

3.1 模块启用配置

登录后台后进入【系统管理】-【模块管理】，找到【评优管理】模块，勾选启用状态，保存后刷新页面，左侧菜单栏即可看到评优管理入口。

3.2 评优指标库配置

进入【评优管理】-【指标库】，点击下载模板，模板固定字段为：序号、指标名称、分值、考核维度（个人/集体）、是否必填、备注。

填写模板时需注意：所有指标分值总和必须为100，否则导入失败；考核维度只能填“个人”或“集体”两个选项。填好后点击导入按钮上传即可。

3.3 评优审批流程配置

进入【系统管理】-【工作流管理】，点击导入流程，流程模板下载地址：https://mirror.ghproxy.com/https://raw.githubusercontent.com/lanTaiOrg/archives/main/docs/assessment-flow.bpmn20.xml

导入后编辑流程节点，给三个节点分别配置对应角色：

• 初审节点：配置部门管理员角色，权限勾选查看、审批、驳回
• 复核节点：配置档案管理岗角色，权限勾选查看、审批、驳回、修改分数
• 终审节点：配置分管领导角色，权限勾选查看、审批、驳回

所有节点必须配置对应角色，否则流程无法正常流转。

四、评优功能实操流程

1. 创建评优项目：管理员进入【评优管理】-【项目列表】，点击新增，填写项目名称、评选范围、起止时间，关联已导入的指标库，务必勾选“关联档案数据校验”，系统自动比对参评人档案的任职年限、奖惩记录等硬条件，不符合要求的自动剔除，无需人工筛查。
2. 参评人提交材料：参评人登录前端账号，进入【我的评优】，选择对应项目，上传佐证材料，系统自动将材料同步归档到个人/集体档案目录，无需重复提交。
3. 评审打分：评审岗登录账号，进入【待办任务】，对参评人逐项打分，如果单评审打分偏离同批次参评人平均分20%以上，系统自动弹出二次确认提示，避免误判，打分完成后系统自动计算总分。
4. 结果公示：终审完成后，管理员进入【项目列表】，点击生成公示公告，系统自动生成带防伪二维码的公示页，公示期可自定义，异议可在线提交，公示结果自动归档到单位荣誉档案库，永久留存不可篡改。

五、常见问题排查

5.1 部署类问题

• 后端启动提示数据库连接失败：检查application.yml中数据库IP、账号、密码是否正确，确认服务器3306端口已开放，数据库账号已授权远程访问权限。
• 前端访问404：检查Nginx配置中root路径是否正确，try_files配置是否添加，确认/usr/share/nginx/html/archives-ui目录存在index.html文件。

5.2 功能类问题

• 菜单栏看不到评优模块：检查模块是否启用，当前登录账号是否分配了评优模块的访问权限。
• 指标导入失败：检查Excel格式是否为xlsx，分值总和是否为100，考核维度是否为指定选项，无空行空列。
• 流程无法提交：检查工作流节点是否配置了对应角色，当前账号是否属于对应节点的角色范围内。