资产功能设计
这篇解决什么
资产怎么分层:分类 / 位置是配置,卡片是台账,入库建卡、领用 / 借用 / 归还、调拨维修报废、盘点差异各走自己的单。读完先对模块边界和表,再进台账、领用等功能篇。
默认端口 48080,前缀 /admin-api。工程启动见 快速开始。审批接入见 业务表单开发。
业务流程及架构
资产自己不算流程引擎。卡片和单据在 yudao-module-asset;入库、领用、调拨等实现 FlowBillService,通过后回调回写。盘点任务没有流程 key,差异处理才有。
示意图:左客户端。中间资产读部门和用户,单据提交走 Flowable。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 台账 | asset_card,状态不在列表硬改 | 资产台账 |
| 入库 / 领用 | 英文 receive 是入库;领用人走 allocate | 资产领用 |
| 调拨 / 维修 | 改归属或状态,不复制新卡 | 调拨、维修 |
| 盘点 | 任务无 key;差异 asset_stocktake_adjust | 资产盘点 |
不要用目录名当流程 key
入库是 asset_receive,领用是 asset_allocate_receive。全部 key 以 AssetBillTypeEnum 为准。
数据表 ER
主干表按 DO 画出。折旧批次、巡检、标签模板不进这张图。
示意图:入库通过后才有闲置卡。盘点任务不挂流程实例,差异单才挂。
前后端代码
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 模块 | api 枚举 + server 实现 | ruoyi-office/yudao-module-asset/ |
| 单体引入 | yudao-module-asset-server | ruoyi-office/yudao-server/pom.xml |
| 单据枚举 | 类型码 + processDefinitionKey | yudao-module-asset-api/.../AssetBillTypeEnum.java |
| 管理端 | 资产目录 | ruoyi-office-vben/apps/web-antd/src/views/asset/ |
| 移动端 | 业务在 pages-asset | ruoyi-office-uniapp/src/pages-asset/ |
官方菜单:资产管理(/asset)。卡片详情 /asset/card-info,入库详情 /asset/receive-info。看不到菜单先查角色。
「OA 商业版」裁剪整模块 yudao-module-asset。本指南按全功能 ALL 写。OA 用品转固在 ALL 才接得上卡片,见 办公用品。

本系统截图:资产 → 资产台账。模块和菜单已经在跑。

本系统截图:入库 info。通过后 AssetReceiveCardGenerator 建卡,默认闲置。
功能开启
单体 -P boot 时已经依赖资产实现,没有单独的「资产开关」页。启动 YudaoServerApplication 即可。
客户默认包 ruoyi-office-db/dump/latest/:先 schema_*.sql 再 static_data_*.sql,带 asset_* 表、菜单、字典和已发布入库 / 领用等模型。以后改表走 ruoyi-office-db/update/。
角色要勾资产菜单和权限字,例如 asset:receive:submit、asset:allocate:submit。先建分类 /asset/category 和位置 /asset/location,再建卡或入库。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
701 入库 | asset_receive | /asset/receive-info |
702 领用 | asset_allocate_receive | /asset/allocate 的 info |
703 借用 | asset_allocate_borrow | 同上,allocateType=2 |
309 归还 | asset_allocate_return | /asset/return |
704 调拨 | asset_transfer | /asset/transfer |
705 维修 | asset_repair | /asset/repair |
706 报废 | asset_dispose | /asset/dispose |
707 盘点差异 | asset_stocktake_adjust | /asset/stocktake-adjust |
708 折旧 | asset_depreciation | 折旧批次 |
入库不是领用
/asset/receive 是入库建卡。领用人走 /asset/allocate,allocateType = 1。不要把两张单绑同一个模型。
ASSET_RECEIVE("701", "资产入库审批", "asset_receive"),
ASSET_ALLOCATE_RECEIVE("702", "资产领用审批", "asset_allocate_receive"),摘自 AssetBillTypeEnum。第三段才是 Flowable 的 KEY_。归还号段 309 是历史对齐,不要改成 709。
示意图:先库和菜单,再对 key,最后配主数据。
旧文 资产功能开启 已并入本页,请收藏本篇。
