基于地方标准适配的珠海通用档案管理软件从零搭建实操指南

本文以完全符合GB/T 18894-2016《电子文件归档与电子档案管理规范》、珠海档案馆2023年发布的《珠海市电子档案单套制归档移交实施细则》的开源奥工档案管理系统社区版V3.2.1为工具，覆盖环境准备、系统安装、珠海地方规范配置、基础档案录入四个核心可落地环节。

一、环境准备

所有步骤均在Windows 10/11专业版64位下验证，macOS/Linux可参考对应文档调整，但珠海档案馆仅对Windows单套制移交介质（移动硬盘）做过兼容性校验，建议优先使用Windows。

1. 硬件环境

• CPU：酷睿i5-8400及以上
• 内存：8G（推荐16G，录入20万条以上档案时不卡顿）
• 硬盘：系统盘预留20G，数据盘预留50G及以上
• 网络：仅在下载系统依赖时需要，之后可离线使用

2. 软件环境

需提前安装以下三个基础软件，按顺序操作：

（1）JDK 11 LTS（系统必须，不能用JDK8/17）

• 下载地址：https://mirrors.tuna.tsinghua.edu.cn/Adoptium/11/jdk/x64/windows/OpenJDK11U-jdk_x64_windows_hotspot_11.0.22_7.msi
• 安装步骤：双击msi，默认路径安装，勾选“Add to PATH”选项

（2）MySQL 8.0.36（档案数据存储）

• 下载地址：https://mirrors.tuna.tsinghua.edu.cn/mysql/downloads/MySQL-8.0/mysql-8.0.36-winx64.zip
• 安装配置（压缩包版无需安装，配置步骤）：
  • 解压到D:\mysql-8.0.36-winx64（路径不要有中文）
  • 在解压根目录新建my.ini文件，复制以下内容： ``` [mysqld] 设置3306端口 port=3306 设置mysql的安装目录 basedir=D:\\mysql-8.0.36-winx64 设置mysql数据库的数据的存放目录 datadir=D:\\mysql-8.0.36-winx64\\data 允许最大连接数 max_connections=200 允许连接失败的次数 max_connect_errors=10 服务端使用的字符集默认为utf8mb4 character-set-server=utf8mb4 创建新表时将使用的默认存储引擎 default-storage-engine=INNODB 默认使用“mysql_native_password”插件认证 default_authentication_plugin=mysql_native_password [mysql] 设置mysql客户端默认字符集 default-character-set=utf8mb4 [client] 设置mysql客户端连接服务端时默认使用的端口 port=3306 default-character-set=utf8mb4 ```
  • 以管理员身份打开CMD，进入D:\mysql-8.0.36-winx64\bin目录
  • 执行初始化命令：`mysqld --initialize --console`，记录最后一行生成的临时root密码（如：r12345678?）
  • 执行安装服务命令：`mysqld --install mysql8`
  • 执行启动服务命令：`net start mysql8`
  • 执行修改root密码命令：`mysql -u root -p`，输入临时密码后，再输入`ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'Zhuhai123!';`（密码包含大小写字母、数字、特殊符号，符合珠海档案系统安全要求）

（3）Redis 5.0.14（缓存系统数据，提升速度）

• 下载地址：https://github.com/microsoftarchive/redis/releases/download/win-3.2.100/Redis-x64-3.2.100.msi
• 安装步骤：双击msi，默认路径安装，勾选“Add to PATH”和“Start the Redis Service”选项

二、系统安装

1. 下载社区版

下载地址：https://github.com/aogangsoft/aogang-archives/releases/download/v3.2.1/aogang-archives-v3.2.1.zip

2. 解压并配置

• 解压到D:\aogang-archives-v3.2.1（路径不要有中文）
• 打开解压目录下的config文件夹，找到application-prod.yml，复制以下完整内容覆盖原文件： ``` server: port: 8080 servlet: context-path: /aogang spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/aogang_archives?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&nullCatalogMeansCurrent=true username: root password: Zhuhai123! hikari: minimum-idle: 5 maximum-pool-size: 20 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 redis: host: 127.0.0.1 port: 6379 password: database: 0 lettuce: pool: max-active: 8 max-wait: -1 max-idle: 8 min-idle: 0 servlet: multipart: max-file-size: 1024MB max-request-size: 2048MB jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 mybatis-plus: mapper-locations: classpath:mapper//Mapper.xml global-config: db-config: id-type: auto logic-delete-field: delFlag logic-delete-value: 1 logic-not-delete-value: 0 configuration: map-underscore-to-camel-case: true aogang: 上传文件存储路径，建议修改为非系统盘的大空间目录 upload-path: D:/aogang-archives-upload/ 是否开启珠海档案馆地方规范适配 zhuhai-standard-enabled: true 珠海单套制移交临时目录 zhuhai-transfer-temp-path: D:/aogang-archives-transfer-temp/ ```
• 创建上传和移交临时目录：D:/aogang-archives-upload/、D:/aogang-archives-transfer-temp/

3. 初始化数据库并启动

• 打开Navicat Premium（或DBeaver免费版），连接MySQL8，新建名为aogang_archives的数据库，字符集选utf8mb4 -- UTF-8 Unicode，排序规则选utf8mb4_general_ci
• 解压目录下的db文件夹里的aogang_archives_v3.2.1_zhuhai.sql导入到新建的数据库（Navicat步骤：右键aogang_archives→运行SQL文件→选择该sql→开始→关闭）
• 以管理员身份打开CMD，进入D:\aogang-archives-v3.2.1\bin目录
• 执行启动命令：`start.bat`，等待30-60秒，出现“Started AogangArchivesApplication in X seconds”即启动成功
• 打开浏览器（建议Chrome/Edge），访问：http://localhost:8080/aogang
• 默认登录账号：admin，默认密码：admin123，首次登录后强制修改密码（需包含大小写字母、数字、特殊符号，长度≥8位）

三、珠海地方规范核心配置

登录后点击左侧菜单“系统管理→参数设置→珠海规范配置”，完成以下必填项：

• 全宗号：输入单位在珠海市档案馆备案的全宗号（如：10010-01）
• 保管期限表：点击下拉框选择“珠海市机关文书档案保管期限表（2023版）”
• 电子文件格式要求：系统已默认按珠海单套制细则设置（文书PDF/A-2u，照片JPEG2000/JPG，视频MP4/H.264，音频MP3），无需修改
• 元数据映射：系统已默认按珠海细则完成国标元数据到珠海地方元数据的映射，点击“保存映射”即可

四、基础档案录入（文书档案为例）

以2024年发的一份《关于开展2024年度珠海档案培训的通知》为例，步骤如下：

1. 新建案卷

• 点击左侧菜单“档案管理→文书档案→年度-机构-保管期限→案卷管理”
• 点击右上角“新增”，填写必填项：
  • 年度：2024
  • 机构：办公室（需提前在“系统管理→组织架构”添加对应机构）
  • 保管期限：永久（按珠海2023版保管期限表，培训通知永久）
  • 案卷号：按单位编号规则填写（如：2024-WS-BGS-YJ-001）
• 点击“保存”

2. 新增文件并挂接电子文件

• 点击刚才新建的案卷，进入“文件管理”页面
• 点击右上角“新增”，填写必填项（系统已根据珠海规范自动填充部分国标元数据）：
  • 文号：珠档办〔2024〕1号
  • 文件题名：关于开展2024年度珠海档案培训的通知
  • 责任者：珠海市档案学会办公室
  • 成文日期：2024-05-20
  • 页号：1-5
  • 备注：（可选）
• 点击“电子文件”标签页，点击“上传”，选择提前转换好的PDF/A-2u格式文件，上传后点击“自动识别页数”，确认与页号一致
• 点击“保存并返回”

五、验证珠海规范适配

点击左侧菜单“档案管理→移交管理→珠海单套制移交”，选择刚才录入的文件，点击“生成移交包”，等待10-20秒，移交包会自动保存到配置的D:/aogang-archives-transfer-temp/目录，解压后可查看是否符合珠海档案馆2023版单套制移交介质格式要求（目录结构、元数据XML、电子文件命名）。