从零搭建适配庆阳档案规范的轻量级开源本地档案管理系统

发布时间: 2026年08月22日 08:50:03 来源: 安答联动浏览量: 0

第一步：准备适配环境与核心工具

本次使用的轻量级工具无需复杂配置服务器，本地Windows/Mac/Linux均可落地，所需组件如下：

XAMPP集成环境：内置Apache、MySQL、PHP，一站式解决Web服务需求，下载地址https://www.apachefriends.org/zh_cn/index.html（选择对应系统的最新稳定版）
Mayan EDMS开源档案系统：内置权限管理、元数据适配、全文检索、档案归档等功能，完全支持自定义庆阳档案规范，下载地址https://github.com/mayan-edms/mayan-edms/releases（选择最新的.zip压缩包）

XAMPP安装与基础配置

双击XAMPP安装包，全程默认安装路径（C:\xampp），仅勾选Apache、MySQL、PHP、phpMyAdmin四个组件
安装完成后打开XAMPP Control Panel，点击Apache和MySQL右侧的「Start」按钮，确保两个服务状态为绿色「Running」
点击MySQL右侧的「Admin」，跳转到phpMyAdmin，创建名为qingyang_archive的数据库，排序规则选择utf8mb4_general_ci（支持特殊字符与汉字）

Mayan EDMS解压与环境准备

将下载的Mayan EDMS压缩包解压到C:\xampp\htdocs目录下，重命名为mayan
打开XAMPP Control Panel，点击Apache右侧的「Config」→「Apache (httpd.conf)」，找到「LoadModule rewrite_module modules/mod_rewrite.so」，删除前面的，保存关闭
再次点击Apache的「Config」→「PHP (php.ini)」，搜索以下参数并修改：
- extension=gd → 删除前面的;
- extension=mbstring → 删除前面的;
- extension=pdo_mysql → 删除前面的;
- upload_max_filesize = 100M → 修改为庆阳档案最大允许的单份文件大小（比如1G则改为1024M）
- post_max_size = 100M → 同步修改为比upload_max_filesize大10M左右
- max_execution_time = 30 → 修改为300（避免大文件上传超时）
重启Apache与MySQL服务

第二步：初始化Mayan EDMS并适配庆阳档案规范

初始化系统

打开浏览器，访问http://localhost/mayan，会自动进入安装向导
选择语言为「简体中文」，点击「下一步」
检查环境，若有红色提示（通常是缺少依赖），点击「自动安装依赖」，等待进度条完成后刷新页面，确保所有项为绿色后点击「下一步」
数据库配置：
- 数据库类型：MySQL
- 数据库主机：localhost
- 数据库端口：3306
- 数据库名称：qingyang_archive
- 数据库用户名：root
- 数据库密码：留空（XAMPP默认root无密码）
点击「测试连接」，提示成功后点击「下一步」
创建管理员账户：
- 用户名：qingyang_admin
- 密码：设置包含大小写字母、数字、符号的强密码（如Qy@2025Archive）
- 确认密码：重复输入
- 邮箱：填写自己的工作邮箱
点击「下一步」
完成安装，点击「进入系统」，用刚才创建的管理员账户登录

适配庆阳档案核心元数据

从零搭建适配庆阳档案规范的轻量级开源本地档案管理系统

庆阳档案规范通常包含档号、保管期限、密级、全宗号、年度、责任者等必填元数据，按以下步骤添加：

登录系统后，点击顶部导航栏「系统管理」→「文档类型」→「创建文档类型」
文档类型名称填写「庆阳文书档案」，描述可选，点击「保存」
在「庆阳文书档案」右侧点击「元数据类型」→「添加元数据类型」
依次添加以下必填且带庆阳规范校验规则的元数据：
- 全宗号：
  - 元数据类型名称：全宗号
  - 数据类型：文本
  - 验证规则：正则表达式^QYZ?-\d{4}$（说明：QYZ开头可选，表示庆阳市直，否则为区县档案，后接4位数字）
  - 必填项：勾选
  - 默认值：可选（比如设置为QYZ-2023）
  - 保存
- 年度：
  - 元数据类型名称：年度
  - 数据类型：数字
  - 最小值：1949
  - 最大值：2100
  - 必填项：勾选
  - 保存
- 保管期限：
  - 元数据类型名称：保管期限
  - 数据类型：选择列表
  - 选择列表项：每行一个，分别输入「永久」「30年」「10年」
  - 必填项：勾选
  - 保存
- 密级：
  - 元数据类型名称：密级
  - 数据类型：选择列表
  - 选择列表项：每行一个，分别输入「公开」「内部」「秘密」「机密」「绝密」
  - 必填项：勾选
  - 默认值：公开
  - 保存
- 档号：
  - 元数据类型名称：档号
  - 数据类型：文本
  - 验证规则：正则表达式^QYZ?-\d{4}-\d{3}-\d{3}-\d{4}$（说明：全宗号-年度-保管期限转换码-件号，其中永久=001，30年=002，10年=003，件号4位）
  - 必填项：勾选
  - 唯一值：勾选
  - 保存
添加完成后，点击「文档类型」→「庆阳文书档案」右侧「权限」，给管理员添加「创建、查看、编辑、删除、下载」全权限，点击「保存」