# 人力资源 - 资产管理 / 办公用品管理 - 前端联调方案 ## 涉及页面 - 人力资源 → 资产管理 → 资产台账(`hrm/asset/index`) - 人力资源 → 资产管理 → 资产交接(领用 / 归还 / 调拨) - 人力资源 → 资产管理 → 资产盘点 - 人力资源 → 办公用品 → 用品档案(含库存预警) - 人力资源 → 办公用品 → 采购入库 - 人力资源 → 办公用品 → 领用申请(申请 → 审批 → 发放) ## 业务流程与数据带入 1. 资产台账建账(资产编码/名称/类别/数量/购置时间/金额/使用部门/使用人/存放位置/状态)。 2. 资产交接:选择资产 → 选交接类型(领用/归还/调拨)→ 带出资产当前使用人与部门 → 填接收人/接收部门 → 提交后资产台账的使用人、部门、状态自动变更。 3. 资产盘点:选择资产 → 带出账面数量 → 填实盘数量 → 后端自动计算盘点结果(相符/盘盈/盘亏),不修改资产状态,仅留档。 4. 办公用品采购入库:选择用品 → 填数量/单价 → 提交后用品库存自动累加,总额 = 数量 × 单价(后端计算)。 5. 办公用品领用:员工提交领用申请(用品/数量/事由)→ 主管审批(通过/驳回)→ 管理员发放,发放时校验并扣减库存。 ## API ### 资产台账 | 方法 | 路径 | 说明 | |------|------|------| | POST | /hrm/asset/create | 新增资产(`hrm:asset:create`) | | PUT | /hrm/asset/update | 修改资产(`hrm:asset:update`) | | DELETE | /hrm/asset/delete?id= | 删除资产(`hrm:asset:delete`) | | GET | /hrm/asset/get?id= | 资产详情(`hrm:asset:query`) | | GET | /hrm/asset/page | 资产分页(`hrm:asset:query`) | | GET | /hrm/asset/simple-list | 资产精简列表(下拉用) | 保存参数:`id`(修改必填)、`code`(必填)、`name`(必填)、`model`、`specification`、`category`(必填,1 办公设备/2 生产工具/3 电子设备/4 家具/5 其他)、`quantity`(必填)、`unit`、`purchaseDate`、`purchasePrice`、`supplierName`、`deptId`、`userId`、`location`、`status`(必填,1 在用/2 闲置/3 报废)、`remark`。 响应在保存字段基础上增加 `deptName`、`userName`(后端解析名称)与 `createTime`。 ### 资产交接 | 方法 | 路径 | 说明 | |------|------|------| | POST | /hrm/asset/handover/create | 新增交接记录(`hrm:asset-handover:create`) | | GET | /hrm/asset/handover/page | 交接记录分页(`hrm:asset-handover:query`) | 保存参数:`assetId`(必填)、`handoverType`(必填,1 领用/2 归还/3 调拨)、`toUserId`(领用/调拨必填)、`toDeptId`(领用/调拨必填)、`handoverTime`(不填取当前时间)、`quantity`(不填取资产台账数量)、`remark`。 响应:`assetCode`、`assetName`、`fromUserId/fromUserName`、`fromDeptId/fromDeptName`、`toUserId/toUserName`、`toDeptId/toDeptName`、`handoverTime`、`quantity`、`remark`、`createTime`。 ### 资产盘点 | 方法 | 路径 | 说明 | |------|------|------| | POST | /hrm/asset/stocktaking/create | 新增盘点(`hrm:asset-stocktaking:create`) | | GET | /hrm/asset/stocktaking/page | 盘点分页(`hrm:asset-stocktaking:query`) | 保存参数:`assetId`(必填)、`stocktakingDate`(必填)、`bookQuantity`(不填取台账数量)、`actualQuantity`(必填)、`remark`。 响应:`assetCode`、`assetName`、`stocktakingDate`、`bookQuantity`、`actualQuantity`、`result`(1 相符/2 盘盈/3 盘亏)、`remark`、`createTime`。 ### 办公用品档案 | 方法 | 路径 | 说明 | |------|------|------| | POST | /hrm/supply/create | 新增用品(`hrm:supply:create`) | | PUT | /hrm/supply/update | 修改用品(`hrm:supply:update`) | | DELETE | /hrm/supply/delete?id= | 删除用品(`hrm:supply:delete`) | | GET | /hrm/supply/get?id= | 详情(`hrm:supply:query`) | | GET | /hrm/supply/page | 分页(`hrm:supply:query`) | | GET | /hrm/supply/simple-list | 精简列表(只返回启用用品,下拉用) | | GET | /hrm/supply/alert-list | 库存预警列表(低于下限或高于上限的启用用品) | 保存参数:`id`(修改必填)、`code`(必填)、`name`(必填)、`category`(必填,1 文具用品/2 打印耗材/3 清洁用品/4 劳保用品/5 其他)、`unit`、`specification`、`stockQuantity`(仅新增时作为初始库存)、`minQuantity`、`maxQuantity`、`price`、`status`(必填,0 启用/1 停用)、`remark`。 ### 办公用品采购入库 | 方法 | 路径 | 说明 | |------|------|------| | POST | /hrm/supply-purchase/create | 新增采购记录并累加库存(`hrm:supply-purchase:create`) | | GET | /hrm/supply-purchase/page | 采购记录分页(`hrm:supply-purchase:query`) | 保存参数:`supplyId`(必填)、`quantity`(必填)、`price`、`purchaseTime`(不填取当前时间)、`supplierName`、`remark`。 响应:`supplyCode`、`supplyName`、`unit`、`quantity`、`price`、`totalPrice`、`purchaseTime`、`supplierName`、`remark`、`createTime`。 ### 办公用品领用 | 方法 | 路径 | 说明 | |------|------|------| | POST | /hrm/supply-issue/create | 发起领用申请(`hrm:supply-issue:create`) | | GET | /hrm/supply-issue/page | 领用申请分页(`hrm:supply-issue:query`) | | PUT | /hrm/supply-issue/approve | 审批(`hrm:supply-issue:approve`),参数 `id`、`approve`(true 通过 / false 驳回)、`remark` | | PUT | /hrm/supply-issue/issue | 发放(`hrm:supply-issue:issue`),参数 `id`,发放时扣减库存 | 保存参数:`supplyId`(必填)、`userId`(必填)、`deptId`、`quantity`(必填)、`useReason`、`remark`。 响应:`supplyCode`、`supplyName`、`unit`、`userId/userName`、`deptId/deptName`、`quantity`、`useReason`、`status`(1 待审批/2 已通过/3 已驳回/4 已发放)、`approveUserId/approveUserName`、`approveTime`、`approveRemark`、`issueTime`、`remark`、`createTime`。 ## 字段展示规则 | 字段 | 展示位置 | 说明 | |------|----------|------| | 资产编码 / 名称 | 资产列表、交接与盘点列表 | 后端解析,直接展示 | | 使用人 / 使用部门 | 资产列表、交接记录 | 展示名称,不展示 ID | | 资产状态 | 资产列表 | 字典 `hrm_asset_status`(1 在用/2 闲置/3 报废) | | 资产类别 | 资产表单、列表 | 字典 `hrm_asset_category` | | 交接类型 | 交接列表、表单 | 字典 `hrm_asset_handover_type`(1 领用/2 归还/3 调拨) | | 盘点结果 | 盘点列表 | 字典 `hrm_asset_stocktaking_result`(1 相符/2 盘盈/3 盘亏) | | 当前库存 / 上下限 | 用品列表 | 低于下限或高于上限的行建议高亮 | | 领用状态 | 领用列表 | 字典 `hrm_supply_issue_status`(1 待审批/2 已通过/3 已驳回/4 已发放) | | 采购总额 totalPrice | 采购记录 | 后端按数量 × 单价计算,前端只展示 | ## 业务规则说明 | 场景 | 规则 | |------|------| | 领用 | 资产状态变为在用、使用人与部门变为接收方 | | 归还 | 资产状态变为闲置,使用人清空 | | 调拨 | 只变更使用人与部门,状态不变 | | 盘点 | 同一资产同一天只能盘点一次;结果由账面数量与实盘数量自动计算,不修改资产台账 | | 采购入库 | 新增记录即累加库存;修改用品档案时库存不再由表单直接改写 | | 领用状态机 | 只有待审批可审批;只有已通过可发放;发放时库存不足会拒绝并给出用品名称、领用数量与实际库存 | | 库存预警 | 低于下限或高于上限(启用状态)均视为预警,包含在 `/hrm/supply/alert-list` | ## 注意事项 - 表单下拉与列表名称解析全部走后端返回的名称字段,前端不自行按 ID 查询名称。 - 库存数量为系统维护值:用品表单只在新增时允许填初始库存,编辑时该字段应只读。 - 发放失败提示必须原样展示(含用品名、单位、实际库存),不要改写成「操作失败」。 - 资产交接与盘点列表只提供新增与查询,不提供修改/删除。