开源档案社保系统本地部署+核心业务配置全流程实操指南

一、部署前环境准备

所有环境均提供官方下载地址，安装完成后必须执行校验命令确认版本符合要求，避免后续启动报错。

1. 必备环境清单与安装

• JDK11：下载地址 https://adoptium.net/zh-CN/temurin/releases/?version=11，安装后执行java -version，返回openjdk version "11.x"即为正常
• MySQL8.0：下载地址 https://dev.mysql.com/downloads/mysql/8.0.html，安装后执行mysql --version，返回8.0.x即为正常
• Redis6.x：下载地址 https://redis.io/download/，Windows用户可下载微软编译版，启动后执行redis-cli ping，返回PONG即为正常
• Maven3.8+：下载地址 https://maven.apache.org/download.cgi，配置国内镜像后执行mvn -v，返回3.8.x及以上版本即为正常
• Node16.x：下载地址 https://nodejs.org/dist/latest-v16.x/，安装后执行node -v，返回v16.x即为正常

二、源码获取与基础配置

1. 源码下载

执行以下git命令直接拉取稳定版源码，无需额外注册账号：

```bash git clone https://gitee.com/lanmi2020/archive-social-security-system.git ```

2. 数据库初始化

登录本地MySQL，执行以下命令创建库并导入初始数据：

```sql create database archive_ss default character set utf8mb4 collate utf8mb4_general_ci; use archive_ss; source 你本地源码存放路径/archive-social-security-system/sql/archive_ss.sql; ```

3. 后端配置修改

进入源码根目录的ruoyi-admin/src/main/resources目录，修改两个配置文件，以下为可直接复制修改的完整片段：

修改application-druid.yml数据库配置：

```yaml spring: datasource: druid: master: url: jdbc:mysql://localhost:3306/archive_ss?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 替换为你自己的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver ```

修改application.yml Redis与文件上传配置：

```yaml redis: host: localhost port: 6379 password: 替换为你自己的Redis密码，无密码则留空 database: 0 文件存储路径，Windows改为D:/archiveUpload/，Linux改为/opt/archiveUpload/ ruoyi: profile: D:/archiveUpload/ ```

三、前后端启动操作

1. 后端启动

打开终端进入源码根目录，执行以下命令打包并启动：

```bash mvn clean install -DskipTests java -jar ruoyi-admin/target/ruoyi-admin.jar ```

启动完成后访问http://localhost:8080/doc.html，能正常打开Swagger接口文档即为后端启动成功。若8080端口被占用，可在application.yml中修改server.port为其他可用端口。

2. 前端启动

打开终端进入源码根目录的ruoyi-ui文件夹，执行以下命令：

```bash 切换国内镜像源，避免安装依赖失败 npm config set registry https://registry.npmmirror.com/ npm install npm run dev ```

启动完成后自动打开浏览器登录页，默认超级管理员账号密码为admin/123456，登录成功即可进入系统主界面。

四、核心业务功能实操配置

1. 档案管理配置

• 第一步：新增档案分类：进入系统管理-字典管理，搜索字典类型sys_archive_type，点击新增可添加分类，例如“人事档案”“社保缴费档案”“退休人员档案”，排序可自定义
• 第二步：上传档案导入模板：进入档案管理-模板管理，点击新增，上传你自定义的Excel模板，模板必填列为：姓名、身份证号、档案编号、分类、存放位置，系统会自动校验身份证号格式与唯一性
• 第三步：批量导入档案：进入档案管理-档案列表，点击导入按钮，选择填好内容的模板文件，上传后系统自动校验，错误数据会导出错误清单，修改后可重新上传

2. 社保业务配置

• 第一步：配置社保缴费参数：进入社保管理-参数配置，按当地社保政策填写各险种缴纳比例，注意比例需填写小数，例如养老单位缴纳16%则填0.16，个人缴纳8%则填0.08，保存后全局生效
• 第二步：关联人员社保账户：进入社保管理-人员账户，点击批量导入，上传包含人员身份证号、社保编号、缴费基数的Excel文件，系统会自动匹配已录入的档案信息，无需重复填写人员基础信息
• 第三步：生成月度缴费单：进入社保管理-缴费管理，选择需要生成的缴费月份，点击批量生成，系统会自动按配置的比例计算每个人员的单位缴纳额、个人缴纳额、总金额，支持直接导出Excel提交给社保局，也可在线打印缴费通知单

五、常见问题排查

1. 启动类问题

• 后端启动报数据库连接失败：检查MySQL服务是否启动，3306端口是否被占用，配置文件中的账号密码是否正确，url参数是否添加了useSSL=false与serverTimezone=Asia/Shanghai
• 前端npm install报错：检查Node版本是否为16.x，是否切换了国内镜像源，可删除node_modules文件夹与package-lock.json文件后重新执行npm install

2. 业务操作类问题

• 导入档案提示身份证号重复：进入档案列表搜索该身份证号，确认是否已存在重复录入的档案，若确认是误报可检查Excel文件中是否存在重复行
• 生成缴费单金额计算错误：检查社保参数配置中的比例是否为小数格式，例如16%不能填16必须填0.16，人员缴费基数是否填写为数字格式
• 档案文件上传失败：检查配置文件中的文件存储路径是否存在，是否有写入权限，Windows系统路径需用/分隔，不要用\