ruoyi-vue-pro 开发指南 ruoyi-vue-pro 开发指南
  • 萌新必读
  • 后端手册
  • 中间件手册
  • 工作流手册
  • 大屏手册
  • 支付手册
  • 会员手册
  • 商城手册
  • ERP 手册
  • CRM 手册
  • MES 手册
  • WMS 手册
  • HRM 手册
  • FMS 手册
  • PMS 手册
  • OA 手册
  • IM 即时通讯手册
  • AI 大模型手册
  • IoT 物联网手册
  • 公众号手册
  • 系统手册
  • 运维手册
  • 前端手册 Vue 3.x
  • 前端手册 Vben 5.x
  • 前端手册 Vue 2.x
  • 前端手册 Admin Uniapp
  • 工作流手册
  • 大屏手册
  • 支付手册
  • 会员手册
  • 商城手册
  • ERP 手册
  • CRM 手册
  • MES 手册
  • WMS 手册
  • HRM 手册
  • FMS 手册
  • PMS 手册
  • OA 手册
  • IM 即时通讯手册
  • AI 大模型手册
  • IoT 物联网手册
  • 公众号手册
  • 系统手册
视频教程
  • Vue3 + element-plus (opens new window)
  • Vue3 + vben5(ant-design-vue、element-plus) (opens new window)
  • Vue2 + element-ui (opens new window)
微服务版 (opens new window)
作者博客 (opens new window)
GitHub (opens new window)
  • 萌新必读
  • 后端手册
  • 中间件手册
  • 工作流手册
  • 大屏手册
  • 支付手册
  • 会员手册
  • 商城手册
  • ERP 手册
  • CRM 手册
  • MES 手册
  • WMS 手册
  • HRM 手册
  • FMS 手册
  • PMS 手册
  • OA 手册
  • IM 即时通讯手册
  • AI 大模型手册
  • IoT 物联网手册
  • 公众号手册
  • 系统手册
  • 运维手册
  • 前端手册 Vue 3.x
  • 前端手册 Vben 5.x
  • 前端手册 Vue 2.x
  • 前端手册 Admin Uniapp
  • 工作流手册
  • 大屏手册
  • 支付手册
  • 会员手册
  • 商城手册
  • ERP 手册
  • CRM 手册
  • MES 手册
  • WMS 手册
  • HRM 手册
  • FMS 手册
  • PMS 手册
  • OA 手册
  • IM 即时通讯手册
  • AI 大模型手册
  • IoT 物联网手册
  • 公众号手册
  • 系统手册
视频教程
  • Vue3 + element-plus (opens new window)
  • Vue3 + vben5(ant-design-vue、element-plus) (opens new window)
  • Vue2 + element-ui (opens new window)
微服务版 (opens new window)
作者博客 (opens new window)
GitHub (opens new window)
  • 萌新必读

    • 简介
    • 交流群
    • 视频教程
    • 功能列表
    • 快速启动(后端项目)
    • 快速启动(前端项目)
    • 接口文档
    • 技术选型
    • 项目结构
    • 代码热加载
    • 一键改包
    • 迁移模块(适合新项目)
    • 删除功能(以租户为例)
    • 表结构变更(版本升级)
    • 国产信创数据库(DM 达梦、大金、OpenGauss、瀚高)
    • 如何去除 Redis 缓存
    • 内网穿透
    • 面试题、简历模版、简历优化
    • 项目外包
  • 后端手册

    • 新建模块
    • 代码生成【单表】(新增功能)
    • 代码生成【主子表】
    • 代码生成(树表)
    • 代码生成(移动端)
    • 功能权限
    • 数据权限
    • 用户体系
    • 三方登录
    • OAuth 2.0(SSO 单点登录)
    • SaaS 多租户【字段隔离】
    • SaaS 多租户【数据库隔离】
    • WebSocket 实时通信
    • 异常处理(错误码)
    • 参数校验、时间传参
    • 分页实现
    • VO 对象转换、数据翻译
    • 文件存储(上传下载)
    • Excel 导入导出
    • 操作日志、访问日志、异常日志
    • MyBatis 数据库
    • MyBatis 联表&分页查询
    • 多数据源(读写分离)、事务
    • Redis 缓存
    • 本地缓存
    • 异步任务
    • 分布式锁
    • 幂等性(防重复提交)
    • 请求限流(RateLimiter)
    • HTTP 接口签名(防篡改)
    • HTTP 接口加解密
    • 单元测试
    • 验证码
    • 工具类 Util
    • 配置管理
    • 数据库文档
  • 中间件手册

    • 定时任务
    • 消息队列(内存)
    • 消息队列(Redis)
    • 消息队列(RocketMQ)
    • 消息队列(RabbitMQ)
    • 消息队列(Kafka)
    • 限流熔断
  • 工作流手册

    • 工作流演示
    • 功能开启
    • 工作流(达梦适配)
    • 审批接入(流程表单)
    • 审批接入(业务表单)
    • 流程设计器(BPMN)
    • 流程设计器(钉钉、飞书)
    • 选择审批人、发起人自选
    • 会签、或签、依次审批
    • 流程发起、取消、重新发起
    • 审批通过、不通过、驳回
    • 审批加签、减签
    • 审批转办、委派、抄送
    • 执行监听器、任务监听器
    • 流程表达式
    • 流程审批通知
    • 移动端审批
  • 大屏手册

    • 报表设计器
    • 大屏设计器
  • 支付手册

    • 功能开启
    • 支付宝支付接入
    • 微信公众号支付接入
    • 微信小程序支付接入
    • 支付宝、微信退款接入
    • 支付宝转账接入
    • 微信转账接入
    • 钱包充值、支付、退款
    • 模拟支付、退款
    • 移动端支付管理
  • 会员手册

    • 功能开启
    • 微信公众号登录
    • 微信小程序登录
    • 微信小程序订阅消息
    • 微信小程序码
    • 会员用户、标签、分组
    • 会员等级、积分、签到
    • 移动端会员管理
  • 商城手册

    • 商城演示
    • 功能开启
    • 商城装修
    • 在线客服
    • 【商品】商品分类
    • 【商品】商品属性
    • 【商品】商品 SPU 与 SKU
    • 【商品】商品评价
    • 【交易】购物车
    • 【交易】交易订单
    • 【交易】售后退款
    • 【交易】快递发货
    • 【交易】门店自提
    • 【交易】分销返佣
    • 【营销】优惠劵
    • 【营销】积分商城
    • 【营销】拼团活动
    • 【营销】秒杀活动
    • 【营销】砍价活动
    • 【营销】满减送活动
    • 【营销】限时折扣
    • 【营销】内容管理
    • 【统计】会员、商品、交易统计
    • 移动端商城管理
  • ERP手册

    • ERP 演示
    • 功能开启
    • 【产品】产品信息、分类、单位
    • 【库存】产品库存、库存明细
    • 【库存】其它入库、其它出库
    • 【库存】库存调拨、库存盘点
    • 【采购】采购订单、入库、退货
    • 【销售】销售订单、出库、退货
    • 【财务】采购付款、销售收款
    • 移动端 ERP
  • CRM手册

    • CRM 演示
    • 功能开启
    • 【线索】线索管理
    • 【客户】客户管理、公海客户
    • 【商机】商机管理、商机状态
    • 【合同】合同管理、合同提醒
    • 【回款】回款管理、回款计划
    • 【产品】产品管理、产品分类
    • 【通用】数据权限
    • 【通用】跟进记录、待办事项
    • 移动端 CRM
  • AI大模型手册

    • AI 大模型演示
    • 功能开启
    • AI 聊天对话
    • AI 绘画创作
    • AI 知识库(RAG)
    • AI 音乐创作
    • AI 写作助手
    • AI 思维导图
    • AI 工具(function calling)
    • AI 工作流
    • Dify 工作流
    • FastGPT 工作流
    • Coze 智能体
    • 推理模式(thinking)
    • 联网搜索
    • MCP Client 客户端
    • MCP Server 服务端
    • 【模型接入】Claude
    • 【模型接入】OpenAI
    • 【模型接入】通义千问
    • 【模型接入】DeepSeek
    • 【模型接入】字节豆包
    • 【模型接入】腾讯混元
    • 【模型接入】硅基流动
    • 【模型接入】MiniMax
    • 【模型接入】月之暗面
    • 【模型接入】百川智能
    • 【模型接入】文心一言
    • 【模型接入】LLAMA
    • 【模型接入】智谱 GLM
    • 【模型接入】讯飞星火
    • 【模型接入】微软 OpenAI
    • 【模型接入】谷歌 Gemini
    • 【模型接入】Stable Diffusion
    • 【模型接入】Midjourney
    • 【模型接入】Suno
    • 【模型接入】Grok
    • 【模型接入】阶跃星辰
    • 移动端 AI 大模型
  • IoT物联网手册

    • 功能开启
    • 产品管理
    • 设备管理
    • 物模型配置
    • 设备网关与子设备
    • 设备动态注册
    • 设备接入(概述)
    • 设备接入(HTTP 协议)
    • 设备接入(MQTT 协议)
    • 设备接入(EMQX 协议)
    • 设备接入(TCP 协议)
    • 设备接入(UDP 协议)
    • 设备接入(WebSocket 协议)
    • 设备接入(CoAP 协议)
    • 设备接入(Modbus Client 模式)
    • 设备接入(Modbus Server 模式)
    • 设备接入(自定义协议)
    • 场景联动
    • 数据流转
    • 告警配置
    • OTA 固件升级
    • 移动端 IoT 物联网
  • MES手册

    • MES 演示
    • 功能开启
    • 【基础】物料产品、分类、计量单位
    • 【基础】客户管理、供应商管理
    • 【基础】车间设置、工作站设置
    • 【基础】编码规则
    • 【生产】工序设置、工艺流程
    • 【生产】生产工单
    • 【生产】生产排产、工序流转卡
    • 【生产】生产报工
    • 【生产】安灯配置、安灯呼叫
    • 【生产】工作记录
    • 【仓库】仓库与库区库位、条码赋码、SN码
    • 【仓库】批次管理、库存现有量、库存事务
    • 【仓库】到货通知、采购入库、采购退货
    • 【仓库】生产领料、生产退料、物料消耗
    • 【仓库】产品产出、产品入库
    • 【仓库】发货通知、销售出库、销售退货
    • 【仓库】外协发料、外协入库
    • 【仓库】其他入库、其他出库
    • 【仓库】调拨单、装箱管理
    • 【仓库】库存盘点
    • 【质量】检测项设置、常见缺陷
    • 【质量】质检方案
    • 【质量】来料检验(IQC)
    • 【质量】过程检验(IPQC)
    • 【质量】出货检验(OQC)
    • 【质量】退货检验(RQC)
    • 【质量】待检任务、检验结果、缺陷记录
    • 【设备】设备类型、设备台账
    • 【设备】点检保养项目、点检保养方案
    • 【设备】点检记录、保养记录、维修单
    • 【工具】工具类型、工装夹具台账
    • 【排班】班组设置、节假日设置
    • 【排班】排班计划、排班日历
    • 移动端 MES
  • WMS手册

    • WMS 演示
    • 功能开启
    • 【基础】仓库
    • 【基础】商品、SKU、分类、品牌
    • 【基础】往来企业(供应商、客户)
    • 【库存】库存记录、流水、统计
    • 【单据】入库
    • 【单据】出库
    • 【单据】移库
    • 【单据】盘库
    • 【其它】WMS、MES、ERP 对比
    • 移动端 WMS
  • HRM人力资源

    • HRM 演示
    • 功能开启
    • 【组织】工作台、组织架构
    • 【员工】员工管理
    • 【招聘】招聘管理
    • 【考勤】考勤管理
    • 【社保】社保管理
    • 【薪资】计薪设置、薪资档案
    • 【薪资】月度工资、工资条
    • 【绩效】绩效模板、绩效计划
    • 【绩效】绩效考核、绩效档案
    • 移动端 HRM
  • FMS财务管理

    • FMS 演示
    • 功能开启
    • 【设置】账套管理、财务参数、财务指标
    • 【设置】币别、科目、辅助核算、初始余额
    • 【设置】凭证字、常用摘要、凭证模板
    • 【凭证】凭证管理
    • 【账簿】账簿管理
    • 【报表】财务报表
    • 【结账】期末结账
    • 移动端 FMS
  • PMS项目管理

    • PMS 演示
    • 功能开启
    • 【项目中心】工作台与项目管理
    • 【项目中心】项目详情与迭代
    • 【项目中心】工作项与协作
    • 【知识中心】知识库管理
    • 【知识中心】文档与协作
    • 移动端 PMS
  • OA协同办公

    • OA 演示
    • 功能开启
    • 【协作】日程、任务、计划与汇报
    • 【协作】公告、讨论、通讯录与笔记
    • 【办公】企业邮箱
    • 【办公】企业云盘
    • 【行政】办公用品、用印管理
    • 【行政】会议室、车辆管理
      • 1. 会议室信息
        • 1.1 表结构
        • 1.2 管理后台
      • 2. 会议室预定
        • 2.1 表结构
        • 2.2 状态流转
        • 2.3 管理后台
      • 3. 车辆信息
        • 3.1 表结构
        • 3.2 管理后台
      • 4. 用车申请
        • 4.1 表结构
        • 4.2 状态流转
        • 4.3 管理后台
      • 5. 还车申请
        • 5.1 表结构
        • 5.2 状态流转
        • 5.3 管理后台
    • 【流程】公文管理
    • 【流程】出差、费用报销
    • 【流程】考勤、请假、加班、转正与离职
    • 移动端 OA
  • IM即时通讯手册

    • IM 演示
    • 功能开启
    • 【好友】好友关系、好友申请
    • 【群聊】群组、群成员、入群申请
    • 【消息】私聊、群聊、频道消息
    • 【频道】频道、频道素材
    • 【内容】表情、敏感词
    • 【通话】语音通话、视频通话、共享屏幕
    • 【WebSocket】实时推送与离线消息
    • 移动端 IM 即时通讯
  • 公众号手册

    • 功能开启
    • 公众号接入
    • 公众号粉丝
    • 公众号标签
    • 公众号消息
    • 模版消息
    • 自动回复
    • 公众号菜单
    • 公众号素材
    • 公众号图文
    • 公众号统计
    • 移动端公众号管理
  • 系统手册

    • 短信配置
    • 邮件配置
    • 站内信配置
    • Webhook(钉钉、飞书、企微)
    • 数据脱敏、字段权限
    • 敏感词
    • 地区 & IP 库
  • 运维手册

    • 开发环境
    • Linux 部署
    • Docker 部署
    • Jenkins 部署
    • 宝塔部署
    • 1Panel 部署
    • HTTPS 证书
    • 服务监控
    • Tomcat WAR 部署
  • 前端手册 Vue 3.x

    • 开发规范
    • 菜单路由
    • Icon 图标
    • 字典数据
    • 系统组件
    • 通用方法
    • 配置读取
    • CRUD 组件
    • 国际化
    • IDE 调试
    • 代码格式化
  • 前端手册 Vben 5.x

    • 开发规范
    • 菜单路由
    • 图标、主题、国际化
    • 字典数据
    • 系统组件
    • 通用方法
    • 配置读取
    • IDE 调试
    • 代码格式化
  • 前端手册 Vue 2.x

    • 开发规范
    • 菜单路由
    • Icon 图标
    • 字典数据
    • 系统组件
    • 通用方法
    • 配置读取
  • 前端手册 Admin Uniapp

    • 开发规范
    • 菜单路由
    • 图标、主题、国际化
    • 字典数据
    • 系统组件
    • 通用方法
    • IDE 调试
    • 代码格式化
    • 运行发布
  • 更新日志

    • 【v2026-09】
    • 【v2026-08】
    • 【v2026-07】
    • 【v2026-06】
    • 【v2026-05】
    • 【v2026-04】
    • 【v2026-03】
    • 【v2026-01】
    • 【v2025-12】
    • 【v2025-11】
    • 【v2025-10】
    • 【v2025-09】
    • 【v2025-08】
  • 开发指南
  • OA协同办公
芋道源码
2026-09-17
目录

【行政】会议室、车辆管理

会议室、车辆管理,由 yudao-module-oa 后端模块的 meetingroom、vehicle 包实现,前端实现在 @/views/oa/meetingroom/room、@/views/oa/meetingroom/booking、@/views/oa/vehicle、@/views/oa/vehicle/apply、@/views/oa/vehicle/return 目录。

会议室和车辆都先维护资源资料,再提交使用申请。会议室按预定时段安排使用,车辆通过用车、还车两张单据完成闭环;审批状态与实际使用 / 还车状态分别保存。

本文涉及表如下图所示:

会议室与车辆表关系

# 1. 会议室信息

会议室信息,由 OaMeetingRoomController 提供接口(/oa/meeting-room)。

# 1.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

会议室表 oa_meeting_room,保存会议室的位置、坐席数、设备和可预定范围:

CREATE TABLE `oa_meeting_room` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `name` varchar(100) NOT NULL COMMENT '会议室名称',
  `location` varchar(255) NOT NULL COMMENT '会议室位置',
  `type` tinyint NOT NULL COMMENT '会议室类型',
  `manager_user_id` bigint NOT NULL COMMENT '负责人用户编号',

  `status` tinyint NOT NULL COMMENT '可用状态',
  `pic_url` varchar(1024) COMMENT '会议室图片 URL',
  `seat_count` int COMMENT '坐席数',
  `equipments` json COMMENT '设备列表',

  `allow_booking` bit NOT NULL COMMENT '是否允许预定',
  `need_approval` bit NOT NULL COMMENT '预定是否需要审批',
  `booking_scope` tinyint NOT NULL COMMENT '可预定范围',
  `booking_user_ids` json COMMENT '可预定用户编号列表',

  `sort` int NOT NULL COMMENT '显示顺序',
  `remark` varchar(200) COMMENT '备注',
  `file_urls` json COMMENT '附件地址列表',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='会议室';

① manager_user_id 关联 system_users 表的 id 字段,表示会议室负责人。

② 枚举 type 会议室类型(OaMeetingRoomTypeEnum),对应字典 oa_meeting_room_type:

值 枚举 说明
1 INTERNAL 内部会议室
2 EXTERNAL 外部会议室
3 TRAINING 培训室
4 MULTIFUNCTION 多功能厅

③ 枚举 status 可用状态(OaMeetingRoomStatusEnum),对应字典 oa_meeting_room_status:

值 枚举 说明
0 NORMAL 正常
1 MAINTENANCE 维修中
2 DISABLED 不可用

提交预定时要求房间 status = 正常(0) 且 allow_booking = true,否则抛出 MEETING_ROOM_NOT_AVAILABLE。

④ 枚举 booking_scope 可预定范围(OaMeetingRoomBookingScopeEnum),对应字典 oa_meeting_room_booking_scope:

值 枚举 说明
0 ALL 全部成员
1 SPECIFIED 指定成员

指定成员时,booking_user_ids 保存可预定用户编号列表;提交时校验当前用户是否在列表中。

⑤ need_approval 控制预定是否需要走 BPM:为 false 时提交直接审批通过且不创建流程实例。详见 §2.2 状态流转。

⑥ equipments、booking_user_ids、file_urls 均为 JSON,结构如下:

equipments / booking_user_ids / file_urls

equipments 是设备字典值数组,对应字典 oa_meeting_room_equipment:

[1, 2, 4]
值 说明(字典)
1 电视
2 电脑
3 遥控器
4 投影仪
5 饮水机
6 置物柜

booking_user_ids 是用户编号数组,关联 system_users.id:

[1, 1024, 2048]

file_urls 是附件地址数组:

["http://xxx/room-plan.pdf"]

# 1.2 管理后台

对应 [OA 办公协同 -> 会议室管理 -> 会议室信息] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/oa/meetingroom/room 目录。

# 列表

管理后台 - 会议室信息

# 新增与修改

点击【新增】打开 OaMeetingRoomForm.vue,填写名称、位置、类型、负责人、坐席数和设备,设置允许预定、预定需审批及可用范围。

管理后台 - 会议室表单

# 查看预定信息

在会议室列表点击【预定信息】,查看房间已安排的会议,由 GET /oa/meeting-room-booking/schedule 提供数据。选择房间时也可以先查看预定信息。

# 2. 会议室预定

会议室预定,由 OaMeetingRoomBookingController 提供接口(/oa/meeting-room-booking)。

# 2.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

会议室预定表 oa_meeting_room_booking,保存会议主题、时段、参会人以及审批与使用状态:

CREATE TABLE `oa_meeting_room_booking` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `no` varchar(64) NOT NULL COMMENT '预定申请单号',
  `room_id` bigint NOT NULL COMMENT '会议室编号',
  `title` varchar(200) NOT NULL COMMENT '会议主题',

  `start_time` datetime NOT NULL COMMENT '会议开始时间',
  `end_time` datetime NOT NULL COMMENT '会议结束时间',

  `moderator_user_id` bigint NOT NULL COMMENT '主持人用户编号',
  `attendee_user_ids` json COMMENT '参会用户编号列表',

  `reminder_type` tinyint NOT NULL COMMENT '会议提醒类型',
  `reminded` bit NOT NULL DEFAULT b'0' COMMENT '是否已发送会议开始提醒',
  `description` varchar(500) COMMENT '会议说明',
  `dept_id` bigint COMMENT '申请部门编号',

  `status` tinyint NOT NULL COMMENT '审批状态',
  `process_instance_id` varchar(64) COMMENT 'BPM 流程实例编号',
  `need_approval` bit COMMENT '提交时是否需要审批',
  `use_status` tinyint NOT NULL COMMENT '使用状态',

  `remark` varchar(500) COMMENT '申请备注',
  `file_urls` json COMMENT '附件地址列表',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_meeting_booking_no` (`tenant_id`, `no`),
  KEY `idx_meeting_booking_room_time` (`tenant_id`, `room_id`, `start_time`, `end_time`),
  KEY `idx_meeting_booking_creator` (`tenant_id`, `creator`, `deleted`),
  KEY `idx_meeting_booking_reminder` (`tenant_id`, `reminded`, `status`, `use_status`, `start_time`)
) ENGINE=InnoDB COMMENT='会议室预定';

① no 预定单号由 OaNoRedisDAO 以 HY 为前缀生成,uk_meeting_booking_no 唯一索引保证租户内唯一,创建时再查 selectByNo,重复则抛出 MEETING_ROOM_BOOKING_NO_DUPLICATE。通用字段 creator 即申请人。

② room_id 关联 oa_meeting_room 表的 id 字段;moderator_user_id 关联 system_users 表的 id 字段;dept_id 关联 system_dept 表的 id 字段,创建时冗余申请人部门。idx_meeting_booking_room_time 支撑时段冲突与日程查询。

③ need_approval 保存提交当时房间是否需要审批的快照,后续房间配置变更不影响已提交单据。

④ 枚举 reminder_type 提醒方式(OaMeetingRoomReminderTypeEnum),对应字典 oa_meeting_room_reminder_type:

值 枚举 说明 提前分钟
1 NONE 不提醒 —
2 BEFORE_FIVE_MINUTES 提前 5 分钟 5
3 BEFORE_TEN_MINUTES 提前 10 分钟 10
4 BEFORE_FIFTEEN_MINUTES 提前 15 分钟 15
5 BEFORE_THIRTY_MINUTES 提前 30 分钟 30

reminded 由提醒 Job 回写,避免重复发送。idx_meeting_booking_reminder 支撑定时扫描。

⑤ attendee_user_ids、file_urls 为 JSON:

attendee_user_ids / file_urls
[1, 2, 3]
["http://xxx/agenda.pdf"]

⑥ 提交时检查成员范围、房间状态和预约冲突。时段采用左闭右开区间,相邻会议可以首尾衔接。流程 key 为 oa_meeting_room_booking。

# 2.2 状态流转

会议室预定由 OaMeetingRoomBookingServiceImpl 控制,同时维护 BPM 审批状态与本地使用状态。

审批状态(BpmProcessInstanceStatusEnum,字典 bpm_process_instance_status):

状态值 枚举 说明 可执行操作
-1 NOT_START 未开始(草稿) 编辑、删除、提交
1 RUNNING 审批中 取消、查看进度
2 APPROVE 审批通过 开始、完成、取消使用
3 REJECT 审批不通过 —
4 CANCEL 已取消 —

使用状态(OaMeetingRoomUseStatusEnum,字典 oa_meeting_room_use_status):

状态值 枚举 说明 可执行操作
0 PENDING 待使用 开始、取消
1 IN_USE 使用中 完成
2 COMPLETED 已完成 —
3 CANCELLED 已取消 —

状态流转说明

【提交可短路】
草稿(status=-1) ──提交──┬── needApproval=true  ──→ 审批中(1) ──通过──→ 通过(2)+待使用(0)
                       └── needApproval=false ──→ 直接通过(2)+待使用(0)(不启 BPM,process_instance_id 为空)

【使用状态】(仅 status=审批通过(2))
待使用(0) ──开始──→ 使用中(1) ──完成──→ 已完成(2)
   │
   └──取消使用──→ 已取消(3)(保留审批通过结果)

审批驳回/取消 ──→ use_status=已取消(3),释放时段
  • 创建预定(createMeetingRoomBooking):status = 未开始(-1),use_status = 待使用(0),reminded = false,生成 HY 单号。
  • 编辑 / 删除(updateMeetingRoomBooking / deleteMeetingRoomBooking):仅草稿。
  • 提交(submitMeetingRoomBooking):校验房间可预定、成员范围、开始时间未过期、时段不冲突;写入 need_approval 快照。若 needApproval = false,直接 status = 审批通过(2)、use_status = 待使用(0) 并返回 null(不创建流程);否则进入 审批中(1) 并启动 oa_meeting_room_booking。
  • 取消(cancelMeetingRoomBooking):审批中则取消 BPM;已通过且待使用则只把 use_status 改为 已取消(3),保留审批通过。
  • 开始 / 完成(startMeetingRoomBooking / finishMeetingRoomBooking):申请人或主持人可操作。开始要求当前时间落在会议时段内:待使用(0) → 使用中(1);完成:使用中(1) → 已完成(2)。
  • 审批回写(updateMeetingRoomBookingStatus):仅处理仍处于 审批中(1) 的单据;通过则 use_status = 待使用(0),驳回/取消则 use_status = 已取消(3)。
  • 会议提醒(OaMeetingRoomBookingReminderJob → sendMeetingRoomBookingReminders / sendMeetingRoomBookingReminder):扫描未提醒、已通过、待使用且到达提前提醒窗口的预定,发送站内信模板 oa_meeting_room_booking_reminder,成功后回写 reminded = 1。

# 2.3 管理后台

对应 [OA 办公协同 -> 会议室管理 -> 会议室预定] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/oa/meetingroom/booking 目录。

# 列表

管理后台 - 会议室预定

# 新增与修改

点击【新增】打开 OaMeetingRoomBookingForm.vue,选择会议室,填写主题、起止时间、主持人、参会人员、提醒方式和会议说明,保存为草稿。

管理后台 - 会议室预定表单

# 提交

在列表点击【提交】,调用 PUT /oa/meeting-room-booking/submit。需要审批时发起 oa_meeting_room_booking 流程,不需要审批时直接进入审批通过、待使用状态。

# 开始、完成与取消

审批通过的预定按页面状态点击【开始】【完成】,分别调用 /start、/finish 更新使用状态。点击【取消】调用 /cancel,按当前审批与使用状态处理。仅未提交草稿可修改、删除。

# 3. 车辆信息

车辆信息,由 OaVehicleController 提供接口(/oa/vehicle)。

# 3.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

车辆表 oa_vehicle,保存车辆台账的车牌号、车型、座位数和保险年检信息:

CREATE TABLE `oa_vehicle` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `no` varchar(32) NOT NULL COMMENT '车牌号',
  `name` varchar(128) NOT NULL COMMENT '车辆名称',
  `dept_id` bigint DEFAULT NULL COMMENT '所属部门编号',

  `type` varchar(64) NOT NULL COMMENT '车型',
  `category` varchar(64) DEFAULT NULL COMMENT '车辆分类',
  `brand_model` varchar(128) DEFAULT NULL COMMENT '品牌型号',
  `seat_count` int NOT NULL COMMENT '座位数',
  `bare_price` decimal(18,2) NOT NULL DEFAULT 0 COMMENT '裸车价格(元)',

  `compulsory_insurance_expire_time` datetime DEFAULT NULL COMMENT '交强险到期时间',
  `commercial_insurance_expire_time` datetime DEFAULT NULL COMMENT '商业险到期时间',
  `inspection_expire_time` datetime DEFAULT NULL COMMENT '年检到期时间',

  `pic_url` varchar(2048) DEFAULT NULL COMMENT '车辆照片 URL',
  `status` tinyint NOT NULL DEFAULT 0 COMMENT '车辆状态',
  `sort` int NOT NULL DEFAULT 0 COMMENT '显示顺序',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_no` (`tenant_id`, `no`)
) ENGINE=InnoDB COMMENT='车辆';

① no 是车牌号,uk_no 唯一索引保证租户内车牌唯一。dept_id 关联 system_dept 表的 id 字段。

② category 车辆分类对应字典 oa_vehicle_category。

③ 枚举 status 台账状态(OaVehicleStatusEnum),对应字典 oa_vehicle_status:

值 枚举 说明
0 IDLE 空闲
1 DISABLED 停用
2 IN_USE 使用中

车辆台账状态为手工维护

用车、还车审批不会自动改写 oa_vehicle.status。提交用车申请时只校验车辆当前为 空闲(0);是否占用预约时段由用车申请的审批状态与 return_status 控制。

# 3.2 管理后台

对应 [OA 办公协同 -> 车辆管理 -> 车辆信息] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/oa/vehicle 目录。

# 列表

管理后台 - 车辆信息

# 新增与修改

点击【新增】打开 OaVehicleForm.vue,维护车牌号、名称、车型、分类、品牌、座位数、价格和保险年检信息。车牌号由后端校验唯一。

管理后台 - 车辆表单

# 查询与删除

按部门、车牌号、车型、状态和保险年检时间筛选车辆。删除台账时不把历史用车单据当作同一对象删除。

# 4. 用车申请

用车申请,由 OaVehicleApplyController 提供接口(/oa/vehicle-apply)。

# 4.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

用车申请表 oa_vehicle_apply,保存预计出车回车时间、用车事由和审批状态:

CREATE TABLE `oa_vehicle_apply` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `no` varchar(64) NOT NULL COMMENT '用车申请单号',
  `vehicle_id` bigint DEFAULT NULL COMMENT '车辆编号',
  `vehicle_no` varchar(32) DEFAULT NULL COMMENT '车牌号快照',

  `user_id` bigint NOT NULL COMMENT '申请人用户编号',
  `dept_id` bigint DEFAULT NULL COMMENT '申请部门编号',

  `start_time` datetime DEFAULT NULL COMMENT '预计出车时间',
  `end_time` datetime DEFAULT NULL COMMENT '预计回车时间',
  `start_location` varchar(255) DEFAULT NULL COMMENT '出车地点',
  `end_location` varchar(255) DEFAULT NULL COMMENT '预计回车地点',
  `reason` varchar(500) DEFAULT NULL COMMENT '用车事由',
  `passenger` varchar(500) DEFAULT NULL COMMENT '随行人',

  `status` tinyint NOT NULL DEFAULT -1 COMMENT '审批状态',
  `return_status` tinyint NOT NULL DEFAULT 0 COMMENT '还车业务状态',
  `process_instance_id` varchar(64) DEFAULT NULL COMMENT 'BPM 流程实例编号',

  `file_urls` json DEFAULT NULL COMMENT '附件地址列表',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_no` (`tenant_id`, `no`),
  UNIQUE KEY `uk_process_instance` (`tenant_id`, `process_instance_id`),
  KEY `idx_user_id` (`tenant_id`, `user_id`),
  KEY `idx_vehicle_id` (`tenant_id`, `vehicle_id`)
) ENGINE=InnoDB COMMENT='用车申请';

① no 用车单号由 OaNoRedisDAO 以 YC 为前缀生成,uk_no 唯一索引 + validateVehicleApplyNoUnique 二次校验。user_id 关联 system_users,dept_id 关联 system_dept,创建时取自当前登录人。

② vehicle_id 关联 oa_vehicle 表的 id 字段,vehicle_no 保存车牌快照。idx_vehicle_id 支撑冲突检查与按车查询。

③ status 是 BPM 审批状态,流程 key 为 oa_vehicle_apply。return_status 是还车业务状态(OaVehicleReturnStatusEnum),对应字典 oa_vehicle_return_status。

④ 草稿不占用预约;提交时校验车辆空闲及时间冲突,审批中的申请也参与冲突检查。用车时间采用左闭右开区间。

⑤ file_urls 是 JSON 数组,保存附件地址列表。

# 4.2 状态流转

用车申请由 OaVehicleApplyServiceImpl 控制。

审批状态(BpmProcessInstanceStatusEnum,字典 bpm_process_instance_status):

状态值 枚举 说明 可执行操作
-1 NOT_START 未开始(草稿) 编辑、删除、提交
1 RUNNING 审批中 取消、查看进度
2 APPROVE 审批通过 发起还车
3 REJECT 审批不通过 —
4 CANCEL 已取消 —

还车业务状态(OaVehicleReturnStatusEnum,字典 oa_vehicle_return_status):

状态值 枚举 说明 可执行操作
0 NOT_EFFECTIVE 未生效 —
1 PENDING_RETURN 待还车 新建/提交还车单
2 RETURNING 还车中 —(等待还车审批)
3 RETURNED 已还车 —

状态流转说明

【BPM】
草稿(-1) ──提交──→ 审批中(1) ──┬──通过──→ 通过(2) 且 return_status=待还车(1)
                              ├──不通过/取消──→ return_status 保持/回到 未生效(0)

【还车业务】
未生效(0) ──用车审批通过──→ 待还车(1) ──提交还车──→ 还车中(2) ──┬──还车通过──→ 已还车(3)
                                                              └──还车拒绝/取消──→ 待还车(1)
  • 创建申请(createVehicleApply):status = 未开始(-1),return_status = 未生效(0),生成 YC 单号。
  • 编辑 / 删除(updateVehicleApply / deleteVehicleApply):仅草稿(validateVehicleApplyDraft)。
  • 提交(submitVehicleApply):校验车辆 空闲(0) 与时段冲突后进入 审批中(1),发起 oa_vehicle_apply。
  • 取消(cancelVehicleApply):仅审批中,取消 BPM 后释放预约。
  • 审批回写(updateVehicleApplyStatus):通过 → return_status = 待还车(1);拒绝/取消 → return_status = 未生效(0)。
  • 还车状态 CAS(updateVehicleApplyReturnStatus):按「期望原状态 → 新状态」条件更新(updateReturnStatusByIdAndReturnStatus),更新行数为 0 则抛出 VEHICLE_RETURN_STATUS_INVALID,保证同时只允许一份还车中。

# 4.3 管理后台

对应 [OA 办公协同 -> 车辆管理 -> 用车申请] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/oa/vehicle/apply 目录。

# 列表

管理后台 - 用车申请

# 新增与修改

点击【新增】打开 OaVehicleApplyForm.vue,选择车辆,填写预计出车和回车时间、地点、随行人、用车事由及附件。保存生成草稿和申请单号。

管理后台 - 用车申请表单

# 提交与取消

在列表点击【提交】,调用 PUT /oa/vehicle-apply/submit 发起 oa_vehicle_apply 流程。审批中可点击【取消】;未提交草稿允许修改、删除,已提交单据保留历史。

# 发起还车

用车审批通过后,在列表点击【还车】,关联当前用车申请进入还车表单。还车情况由下一节的还车申请处理。

# 5. 还车申请

还车申请,由 OaVehicleReturnController 提供接口(/oa/vehicle-return)。还车是独立 BPM 单据,与用车申请一对多(历史上可多次发起,但同一时刻最多一份「还车中」)。

# 5.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

还车申请表 oa_vehicle_return,关联用车申请,保存实际回车时间、地点和还车说明:

CREATE TABLE `oa_vehicle_return` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `no` varchar(64) NOT NULL COMMENT '还车申请单号',
  `apply_id` bigint NOT NULL COMMENT '用车申请编号',
  `vehicle_id` bigint NOT NULL COMMENT '车辆编号',

  `user_id` bigint NOT NULL COMMENT '申请人用户编号',
  `dept_id` bigint DEFAULT NULL COMMENT '申请部门编号',

  `actual_return_time` datetime DEFAULT NULL COMMENT '实际回车时间',
  `return_location` varchar(255) DEFAULT NULL COMMENT '实际回车地点',

  `status` tinyint NOT NULL DEFAULT -1 COMMENT '审批状态',
  `process_instance_id` varchar(64) DEFAULT NULL COMMENT 'BPM 流程实例编号',

  `file_urls` json DEFAULT NULL COMMENT '附件地址列表',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_no` (`tenant_id`, `no`),
  UNIQUE KEY `uk_process_instance` (`tenant_id`, `process_instance_id`),
  KEY `idx_apply_id` (`tenant_id`, `apply_id`),
  KEY `idx_user_id` (`tenant_id`, `user_id`),
  KEY `idx_vehicle_id` (`tenant_id`, `vehicle_id`)
) ENGINE=InnoDB COMMENT='还车申请';

① no 还车单号由 OaNoRedisDAO 以 HC 为前缀生成,uk_no 唯一。apply_id 关联 oa_vehicle_apply 表的 id 字段;vehicle_id 从用车申请带出,关联 oa_vehicle。idx_apply_id 支撑按原单反查还车历史。

② user_id、dept_id 与用车申请一致,随关联申请确定。实际回车时间须满足原用车申请的时间约束(validateVehicleReturn)。

③ status 是独立的 BPM 审批状态,流程 key 为 oa_vehicle_return。保存还车草稿不改变原用车单的 return_status。

④ file_urls 是 JSON 数组,保存附件地址列表。

# 5.2 状态流转

还车申请由 OaVehicleReturnServiceImpl 控制,并回写原用车单的 return_status。

还车单审批状态(BpmProcessInstanceStatusEnum,字典 bpm_process_instance_status):

状态值 枚举 说明 可执行操作
-1 NOT_START 未开始(草稿) 编辑、删除、提交
1 RUNNING 审批中 取消、查看进度
2 APPROVE 审批通过 —(原单已还车)
3 REJECT 审批不通过 —(原单回到待还车)
4 CANCEL 已取消 —(原单回到待还车)

状态流转说明

还车草稿(-1) ──提交──→ 还车审批中(1)
                         │
                         ├──通过──→ 还车通过(2),原单 return_status:还车中(2) → 已还车(3)
                         └──拒绝/取消──→ 原单 return_status:还车中(2) → 待还车(1),可再次发起
  • 创建还车(createVehicleReturn):校验原单属于本人且 return_status = 待还车(1);生成 HC 单号,还车单 status = 未开始(-1)。此时原单仍为待还车。
  • 编辑 / 删除(updateVehicleReturn / deleteVehicleReturn):仅还车草稿;删除草稿不代表已还车。
  • 提交(submitVehicleReturn):CAS 将原单 待还车(1) → 还车中(2),再把还车单改为 审批中(1) 并启动 oa_vehicle_return。若已有其它还车单处于还车中,CAS 失败。
  • 取消(cancelVehicleReturn):取消还车 BPM,结果事件把原单从 还车中(2) 恢复为 待还车(1)。
  • 审批回写(updateVehicleReturnStatus):通过 → 原单 还车中(2) → 已还车(3);拒绝或取消 → 原单回到 待还车(1),允许再次发起还车。

# 5.3 管理后台

对应 [OA 办公协同 -> 车辆管理 -> 还车申请] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/oa/vehicle/return 目录。

# 列表

管理后台 - 还车申请

# 新增与修改

点击【新增】打开 OaVehicleReturnForm.vue,选择本人待还车的用车申请,填写实际回车时间、地点、还车说明和附件。

管理后台 - 还车申请表单

# 提交与审批

在列表点击【提交】,调用 PUT /oa/vehicle-return/submit 发起 oa_vehicle_return 流程。实际回车时间必须满足原用车申请的时间约束。点击【进度】查看审批,审批中可取消。

# 删除

只有未提交的还车草稿可以修改、删除。删除草稿不代表已经还车,原用车单仍保持待还车状态。

【行政】办公用品、用印管理
【流程】公文管理

← 【行政】办公用品、用印管理 【流程】公文管理→

Theme by Vdoing | Copyright © 2019-2026 芋道源码 | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式
×