进度说明：

• 管理后台，请使用 https://gitee.com/yudaocode/yudao-ui-admin-vue3 (opens new window) 仓库的 master 分支
• 后端项目，请使用 https://gitee.com/zhijiantianya/yudao-cloud (opens new window) 仓库的 master（JDK8）、master-jdk17（JDK17/21）或 master-jdk25（JDK25）分支

OA 系统，后端由 yudao-module-oa 模块实现，前端由 yudao-ui-admin-vue3 的 oa 目录实现。

只需要启动 yudao-module-oa 服务，就可以使用 OA 的功能。步骤如下：

• 第一步，导入 OA 系统的 SQL 数据库脚本
• 第二步，启动服务，确认功能是否生效
• 第三步，导入并发布 OA 审批流程

补充说明：

由于 OA 的用品领用、用印、会议室预定、用车、公文、出差报销、请假加班等申请使用到 BPM 的审批功能，所以你需要先看 《工作流》 文档，将工作流开启！工作汇报的提交只改变汇报状态，不经过 BPM 审批。

1. 第一步，导入 SQL

点击 oa.sql.zip (opens new window) 下载附件，解压出 SQL 文件，然后导入到数据库中。如下图所示：

友情提示：↑↑↑ oa.sql 是可以点击下载的！ ↑↑↑

重要说明：该 SQL 仅芋道星球成员可使用和商用，否则视为侵权（索赔 100 万，永久追溯）【下载即视为同意】。

以 oa_ 作为前缀的表，就是 OA 模块当前源码维护的表，一共 48 张，按业务模块分为：

子前缀	模块	表数量
oa_schedule*、oa_task*、oa_plan、oa_work_report	工作协作	7
oa_announcement*、oa_discussion*、oa_vote*、oa_contact*、oa_note*	信息协作	13
oa_mail_*	企业邮箱	4
oa_file_*	企业云盘	3
oa_supply_*、oa_seal*	办公用品与用印	5
oa_meeting_room*、oa_vehicle*	会议室与车辆	5
oa_official_doc_*	公文管理	3
oa_travel_*、oa_reimbursement	出差与报销	3
oa_attendance、oa_leave_apply、oa_overtime_apply、oa_regular_apply、oa_resign_apply	考勤与人事申请	5

2. 第二步，启动服务

① 运行该服务的 OaServerApplication 启动类，看到 "Started OaServerApplication" 日志说明开启成功。

② 然后，访问前端的 OA 菜单，确认功能是否生效。如下图所示：

如果菜单未显示，检查当前角色是否分配了「OA 办公协同」菜单及对应权限，重新登录后查看。

3. 第三步，初始化审批流程

OA 的申请表单由业务模块实现，审批节点、审批人及流程进度由 BPM 提供。

① 在 yudao-module-oa/yudao-module-oa-server/src/main/resources/bpm 目录中，找到对应流程的 JSON 文件。

② 进入 [工作流程 -> 流程管理 -> 流程模型] 菜单，导入 JSON 文件。导入后检查流程管理人、发起权限、审批人和业务表单配置。

③ 点击【发布】，使流程定义生效。仅导入模型但未发布时，业务申请不能正常提交。 已存在的流程先检查其配置及发布状态，避免覆盖已调整的流程。

业务	流程标识
用品领用	oa_supply_apply
用印申请	oa_seal_apply
会议室预定	oa_meeting_room_booking
用车、还车	oa_vehicle_apply、oa_vehicle_return
公文发文、收文	oa_official_doc_send、oa_official_doc_receive
出差、差旅报销	oa_travel_apply、oa_travel_reimbursement
普通费用报销	oa_reimbursement
请假、加班	oa_leave_apply、oa_overtime_apply
转正、离职	oa_regular_apply、oa_resign_apply

项目也提供 OaBpmModelInitTest，用于本地手动导入并发布这些流程。它默认禁用，运行前需按类注释配置本地后端、租户和测试账号。

至此，我们就成功开启了 OA 的功能 🙂