文书档案系统可定制性落地实操指南 全步骤适配个性化业务需求

前期准备工作

基础环境部署

本次实操基于开源MyArchives v1.2.0基础框架，下载地址：https://gitee.com/oschina/MyArchives/releases/tag/v1.2.0，下载后直接解压到服务器任意目录即可。环境依赖安装可直接执行以下命令：

• JDK11安装：执行命令 sudo apt install openjdk-11-jdk，安装完成后执行 java -version 验证，显示版本号为11.x即为成功
• MySQL8.0安装：执行命令 sudo apt install mysql-server-8.0，安装完成后执行 mysql -V 验证
• Node16.x安装：执行命令 curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - && sudo apt install -y nodejs，安装完成后执行 node -v 验证版本为16.x

依赖安装完成后，进入解压后的sql目录，执行 mysql -u root -p < init.sql，输入数据库root密码完成基础库初始化。

系统启动

修改application.yml配置文件中的数据库连接信息，完整可复制配置如下：

```yaml spring: datasource: url: jdbc:mysql://127.0.0.1:3306/myarchives?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你的数据库root密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080 ```

配置完成后执行 nohup java -jar MyArchives.jar > run.log 2>&1 & 启动系统，访问http://服务器IP:8080，默认管理员账号admin、密码123456。

核心可定制模块实操步骤

档案分类字段定制

该模块用于自定义不同类型档案的录入、展示字段，适配不同行业的档案管理规则，操作步骤如下：

• 配置自定义字段规则：在系统./config/custom目录下新建custom_field.json文件，完整可复制配置示例如下，可根据需求修改字段名、类型、关联分类等参数： ```json { "field_id": "secret_level", "field_name": "涉密等级", "field_type": "enum", "enum_options": ["非密", "秘密", "机密", "绝密"], "required": true, "searchable": true, "bind_catalog": ["A01行政公文", "A02工程档案"], "show_rule": { "list": true, "detail": true, "input": true, "sort": 15 } } ```
• 生效配置：执行 sudo systemctl restart myarchives.service 重启系统，新字段自动生效

如需新增多个自定义字段，只需在json数组中追加配置即可，字段ID不可重复。

归档工作流定制

该模块用于自定义档案归档、借阅、销毁的审批流程，操作步骤如下：

• 导出默认模板：登录后台→工作流管理→模板管理→导出默认归档流程，得到flow_default.bpmn20.xml文件
• 编辑流程节点：打开在线BPMN编辑器https://bpmn.aliyun.com/ 上传模板文件，新增、修改审批节点，设置对应审批人规则，示例节点配置如下： ```xml ```
• 导入生效：在工作流管理页面上传修改后的xml文件，选择绑定对应的档案分类，点击启用即可，无需重启系统

前端样式定制

该模块用于自定义系统的logo、配色、页脚等视觉元素，操作步骤如下：

• 替换静态资源：将自定义的logo.png、favicon.ico文件放到./public/static/images/目录下，覆盖原文件
• 修改全局配色：编辑./frontend/src/style/global.less文件，完整可复制配置如下，可根据需求修改色值： ```less @primary-color: 165DFF; // 全局主色 @success-color: 00B42A; // 成功色 @warning-color: FF7D00; // 警告色 @error-color: F53F3F; // 错误色 @font-size-base: 14px; // 主字号 @border-radius-base: 4px; // 组件圆角 ```
• 打包生效：进入frontend目录，依次执行 npm install、npm run build，将生成的dist目录下所有文件拷贝到./public/目录下，清理浏览器缓存后刷新页面即可生效

验证与异常排查

定制效果验证

• 字段验证：登录普通用户账号，进入对应档案分类的录入页，检查自定义字段是否显示、必填项是否有提示，录入数据后查看列表页、详情页的字段排序、显示是否符合配置
• 流程验证：提交一条归档申请，查看流程节点是否按照自定义规则流转，审批人是否匹配对应的部门负责人、档案管理员角色
• 样式验证：检查全局配色、logo、页脚是否符合预期，所有按钮、表格的样式是否统一

常见异常排查

• 自定义字段不显示：执行 jsonlint ./config/custom/custom_field.json 验证json格式是否合法，修正格式错误后重启系统即可
• 工作流导入失败：检查bpmn文件的节点ID是否唯一，导入时系统会自动提示重复ID，修改后重新导入即可
• 样式修改不生效：确认npm run build执行无报错，dist目录文件完整拷贝到public目录，清理浏览器缓存或用无痕模式访问验证

定制内容备份与迁移

如需将定制内容迁移到新环境，可直接执行以下操作，无需重新配置：

• 备份：执行命令 tar -zcvf myarchives_custom_$(date +%Y%m%d).tar.gz ./config/custom ./public/static ./workflow/custom，生成的压缩包即为所有定制内容的备份
• 迁移：新环境部署完基础系统后，将压缩包上传到根目录，执行 tar -zxvf 压缩包名称 解压覆盖对应目录，重启系统即可完成迁移