档案软件C/S版环境下评优功能的实操配置落地全指南

前置准备（必须完成，无省略）

1. 服务端要求：已部署C/S版档案软件v2.5及以上，拉取官方镜像命令：docker pull archive-cs:2.5.0；服务端默认端口1521，已启动，确认状态命令：docker ps | grep archive-cs；提前备份服务端PostgreSQL数据库，备份命令：pg_dump -U postgres archive_db > /backup/archive_db_$(date +%Y%m%d).sql（备份文件自动按日期命名，无需手动修改）。

2. 客户端要求：Windows客户端安装路径为C:\ArchiveClient，Linux客户端路径为/opt/archive-client；客户端版本需与服务端一致，不一致则卸载重装：Windows执行安装包ArchiveClient_v2.5.0.exe，Linux执行sudo dpkg -i archive-client_2.5.0_amd64.deb。

核心实操步骤（零门槛可直接操作）

1. 服务端评优规则配置（2种方式二选一，推荐后台操作）

• 后台操作：浏览器输入服务端地址http://192.168.1.100:8080/admin（替换为实际服务端IP），默认登录账号admin，密码Archive@2024（无修改则使用此密码）。
• 左侧菜单点击【评优管理】→【规则配置】，点击【新增规则】按钮。
• 规则名称填“2024年度档案评优”，评优周期选“自然年”，参评范围勾选“所有部门正式员工”，必须设置参评时间范围为2024-01-01至2024-12-31，不可留空或修改。
• 配置评优指标：基础分（档案数量≥100得30分）、质量分（档案准确率≥95%得50分）、附加分（年度归档及时率100%得20分），点击【保存】完成规则创建。
• 命令行替代操作（后台无法访问时用）：登录服务端服务器，编辑配置文件/etc/archive/server/config.yaml，添加以下完整内容： ``` evaluation: rules: - id: 2024001 name: 2024年度档案评优 cycle: annual period: start: 2024-01-01 end: 2024-12-31 indicators: - name: 档案数量基础分 type: count threshold: 100 score: 30 - name: 档案质量分 type: accuracy threshold: 0.95 score: 50 - name: 归档及时率附加分 type: timeliness threshold: 1.0 score: 20 ``` 保存后重启服务端：systemctl restart archive-server，执行后等待10秒确认服务启动成功：systemctl status archive-server，显示“active (running)”即为正常。

2. 客户端评优数据同步

打开客户端，点击左上角【同步】按钮，输入服务端IP和端口（如192.168.1.100:1521），必须勾选“同步评优相关档案数据”复选框，点击【确认同步】。

同步进度条完成后弹出提示：“同步成功，共更新档案数据124条”，若同步失败，执行以下排查命令：

• 检查服务端防火墙：firewall-cmd --add-port=1521/tcp --permanent && firewall-cmd --reload（开放1521端口）。
• 检查数据库连接：服务端执行psql -U postgres -d archive_db -c "SELECT count() FROM evaluation_rules;"，返回结果≥1即为规则创建成功。

3. 评优结果导出与发布

• 后台操作：返回服务端【评优管理】→【结果查询】，选择“2024年度档案评优”规则，点击【导出Excel】按钮，保存到本地桌面，文件名自动命名为“评优结果_2024.xlsx”。
• 结果校验：打开Excel文件，确认每一行员工的总分保留2位小数，若出现总分≥100或≤0的异常值，需重新核对档案数据（后台【档案管理】→【档案详情】，检查异常员工的档案数量、准确率）。
• 结果发布：确认无误后，点击后台【发布结果】按钮，发布完成后客户端无需手动同步，10秒后自动显示最新评优结果。

常见问题快速排查

1. 规则保存失败

查看服务端日志：cat /var/log/archive/server.log | grep -i "evaluation error"，若显示“数据库连接拒绝”，重启PostgreSQL服务：systemctl restart postgresql；若显示“指标配置错误”，检查配置文件或后台指标填写是否有非数字内容。

2. 客户端同步评优数据为空

确认服务端规则的参评范围是否包含当前用户所属部门，若未包含，重新编辑规则，在参评范围中添加对应部门，再次同步即可；若仍为空，检查客户端是否有2024年度的归档档案，若无则需先导入对应档案数据。

3. 发布结果后客户端不显示

手动触发客户端同步：点击客户端【设置】→【强制同步】，勾选“评优结果同步”，点击【确认】，等待10秒即可显示。