从零搭建开源认证认可档案管理软件 完整可落地实操指南

一、前期环境准备

1.1 所需工具下载安装

所有工具均为免费开源，直接访问对应地址下载对应系统版本安装即可，步骤清晰无门槛：

• JDK 11 64位：下载地址：https://adoptium.net/temurin/releases/?version=11，安装时勾选添加到系统环境变量PATH即可，无需手动额外配置
• MySQL 8.0：下载地址：https://dev.mysql.com/downloads/mysql/8.0.html，安装过程中记住设置的root账号密码，后续项目配置需要用到
• Maven 3.8.6：下载地址：https://archive.apache.org/dist/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.zip，解压后将根目录下的bin文件夹路径添加到系统环境变量PATH即可

安装完成后打开cmd命令提示符，分别输入java -version、mysql -V、mvn -v，三个命令都正常输出版本号说明环境配置成功，否则重新检查环境变量配置。

二、获取项目源码并初始化数据库

2.1 拉取项目源码

如果已安装Git，直接在目标存储文件夹打开命令行，执行以下命令拉取源码：

``` git clone https://gitee.com/opensource4gov/ccaa-archive-management.git cd ccaa-archive-management ```

未安装Git可直接访问上述地址，点击页面的【下载ZIP】按钮下载源码压缩包，解压后进入项目根文件夹即可。

2.2 初始化数据库

打开MySQL命令行或Navicat等可视化工具，按顺序执行以下操作：

1. 新建认证认可档案专属数据库，执行以下SQL命令： ```sql CREATE DATABASE IF NOT EXISTS ccaa_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; ```
2. 导入项目自带的初始化SQL脚本，脚本路径为项目根目录下db/init.sql，命令行执行命令： ``` source 你的项目完整存储路径/db/init.sql; ``` 使用可视化工具的话直接导入该文件即可完成初始化。

三、修改项目配置，可直接复制完整配置

打开项目目录下src/main/resources/application.yml文件，删除原有内容，复制以下完整配置，仅需要修改其中MySQL的账号密码为你自己安装时设置的内容即可：

```yaml server: port: 8080 servlet: context-path: / spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/ccaa_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root 改成你的MySQL用户名 password: 123456 改成你的MySQL密码 servlet: multipart: max-file-size: 100MB max-request-size: 100MB mybatis-plus: configuration: map-underscore-to-camel-case: true mapper-locations: classpath:mapper/.xml ```

如果8080端口被其他程序占用，直接修改配置中server.port的值为其他未占用端口，比如8081即可解决。

四、启动项目并访问系统

在项目根目录打开命令行，依次执行以下命令即可启动项目：

``` mvn clean package java -jar target/ccaa-archive-management-1.0.0.jar ```

等待命令行输出Started CcaaArchiveManagementApplication说明启动成功，打开浏览器访问：本地访问输入http://localhost:8080，部署在服务器则替换为服务器IP加端口即可。

默认登录账号：admin，默认密码：123456，登录后第一时间建议在个人中心修改默认密码，保证系统安全。

五、核心功能实操步骤，看完直接上手

5.1 新增认证认可档案

登录后点击左侧菜单档案管理 > 新增档案，按要求填写核心字段即可：

• 档案编号：系统自动生成规则编号，无需手动填写
• 认证项目名称：填写对应认证认可业务名称，比如“ISO9001质量管理体系认证”
• 机构信息：选择对应获证组织或认证机构名称，未收录的可以先在基础数据模块新增
• 证书有效期：选择证书的起止生效日期，系统会自动提前30天推送到期提醒
• 附件上传：直接上传证书扫描件、原始佐证材料等附件，支持批量上传，单文件最大支持100MB

填写完成后点击保存按钮，即可完成档案录入。

5.2 档案检索与借阅管理

点击左侧菜单档案管理 > 档案列表，可以通过档案编号、机构名称、认证项目、有效期等多个维度检索，支持一键导出Excel统计报表；需要借阅档案时，点击对应档案操作列的申请借阅，填写借阅原因后提交管理员审批，审批通过后即可下载电子版档案，系统会自动记录全流程借阅日志，符合认证认可溯源要求。

5.3 常见卡壳问题解决

• 启动报错连接数据库失败：检查application.yml中的用户名、密码、数据库名称是否正确，检查MySQL服务是否正常启动，若MySQL不是默认3306端口，需要修改url中的端口号
• 忘记管理员密码：直接执行SQL更新密码，123456加密后的MD5值为e10adc3949ba59abbe56e057f20f883e，执行命令：UPDATE sys_user SET password='e10adc3949ba59abbe56e057f20f883e' WHERE username='admin';，刷新页面后即可用123456登录