干部档案软件本地部署、数据录入与权限配置全流程实操指南

一、前置准备

1. 硬件&系统要求

最低配置：CPU 2核4线程、内存8G、100G SSD固态盘；推荐配置：CPU 4核8线程、内存16G、200G SSD固态盘。系统选择Windows Server 2019或CentOS 7.9，不建议用家庭版Windows或CentOS 8以上版本，避免兼容性问题。

2. 依赖&安装包获取

• JDK1.8下载地址：https://adoptium.net/zh-CN/temurin/releases/?version=8，选择对应系统的安装包即可
• MySQL 5.7安装包：Windows端直接从微软应用商店搜索安装，Linux端用命令直接安装
• 干部档案软件稳定版下载地址：https://gitee.com/xxbiji/cadre-archive/releases/tag/v1.2.0，Windows端下载cadre-archive-windows-v1.2.0.zip，Linux端下载cadre-archive-linux-v1.2.0.tar.gz

二、部署实操步骤

1. Windows端部署

• 安装JDK1.8：默认路径安装后，右键此电脑-属性-高级系统设置-环境变量，系统变量新建JAVA_HOME，值填写C:\Program Files\Eclipse Adoptium\jdk-8.0.392.8-hotspot，再编辑Path变量，新增%JAVA_HOME%\bin，保存后打开cmd输入java -version，显示1.8.x版本即配置成功
• 安装MySQL5.7：默认端口3306，设置root账号密码为Archive@2024，安装完成后登录MySQL，执行命令创建数据库：create database cadre_archive character set utf8mb4 collate utf8mb4_general_ci;
• 修改配置文件：把软件压缩包解压到D:\cadre_archive目录，打开config文件夹下的application.yml，替换为以下完整配置： ``` server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/cadre_archive?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: Archive@2024 servlet: multipart: max-file-size: 100MB max-request-size: 100MB file: upload-path: D:/cadre_archive/upload/ ```
• 启动软件：回到根目录，右键以管理员身份运行start.bat，等待30秒后打开浏览器输入http://127.0.0.1:8080，出现登录页即部署成功，默认管理员账号admin，密码Admin@123

2. Linux端部署

• 安装JDK1.8：执行命令yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel，安装完成后输入java -version验证版本
• 安装MySQL5.7：依次执行以下命令 ``` wget https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm rpm -ivh mysql57-community-release-el7-11.noarch.rpm yum install -y mysql-community-server --nogpgcheck systemctl start mysqld systemctl enable mysqld ``` 执行grep 'temporary password' /var/log/mysqld.log获取初始密码，登录MySQL后执行set password for 'root'@'localhost' = password('Archive@2024');修改密码，再执行创建数据库的命令即可
• 修改配置文件：执行tar -zxvf cadre-archive-linux-v1.2.0.tar.gz -C /opt/解压到指定目录，打开/opt/cadre_archive/config/application.yml，把file.upload-path改为/opt/cadre_archive/upload/，其余配置和Windows端一致
• 启动软件：执行mkdir -p /opt/cadre_archive/upload && chmod 755 /opt/cadre_archive/upload创建附件目录，再执行chmod +x /opt/cadre_archive/start.sh && sh /opt/cadre_archive/start.sh启动，开放端口执行firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload，局域网内其他机器输入服务器IP:8080即可访问

三、核心功能实操

1. 档案数据批量录入

• 登录管理员账号，左侧菜单栏选择档案管理-模板下载，获取标准Excel录入模板
• 按照模板填写数据，带的为必填项：干部姓名、身份证号、性别、出生日期、入职时间、所属部门、职务级别，身份证号不能重复，日期必须是YYYY/MM/DD格式，否则会导入失败
• 填写完成后选择档案管理-批量导入，上传Excel文件，系统会自动校验，校验不通过会生成错误报告，按照报告修改内容后重新上传，校验通过后点击确认导入即可完成批量录入
• 单条档案录入直接选择档案管理-新增档案，填写对应字段、上传扫描件后保存即可

2. 权限分级配置

• 左侧菜单栏选择系统管理-角色管理，系统默认有3个角色，也可根据需求新增自定义角色
• 角色权限配置：超级管理员勾选所有权限，包含档案增删改查、权限配置、系统设置；部门管理员仅勾选所属部门档案增改查、本部门查阅申请审批权限；普通查阅员仅勾选档案查阅、查阅申请提交权限，禁止开启修改、删除、导出权限
• 新建用户：选择系统管理-用户管理-新增用户，填写用户姓名、账号、初始密码，绑定对应角色和所属部门，涉密岗位用户必须开启强制首次修改密码选项，要求密码为8位以上包含数字、字母、特殊符号的组合
• 审计溯源：选择系统管理-操作日志，可查看所有用户的档案查阅、修改、下载、导出记录，支持按时间、用户、操作类型筛选，可直接导出审计报表存档

四、常见问题排查

• 启动后访问404：执行命令netstat -ano | findstr 8080（Windows）或netstat -tunlp | grep 8080（Linux）查看端口是否被占用，若被占用修改application.yml中的server.port为8081等未占用端口即可
• 批量导入失败：首先检查身份证号是否重复、日期格式是否符合要求，其次确认Excel格式为.xlsx，不要用.xls格式，文件大小不要超过10MB
• 附件上传失败：检查配置文件中upload-path对应的目录是否存在，不存在手动创建即可，Linux端要确保目录有755权限，Windows端不要用中文路径
• 忘记管理员密码：登录MySQL执行update cadre_archive.sys_user set password = '$2a$10$7JB720yubVSzqm2uT6g4/.tG8dQ3Vv3eQw8eQa7eQa7eQa7eQa7e' where user_name = 'admin';，即可重置密码为Admin@123