设备管理系统
本子应用用于企业设备资产的全过程管理，覆盖生产设备、车辆、办公设备、测量设备、试验设备五类设备的台账建档、进退场与使用登记、加油与用油管理、维修保养与检验保险、报废移交等业务，并提供设备总览、维保费用、设备利用率与到期预警的统计分析能力。
- 设备台账：生产设备、车辆、办公设备、测量设备、试验设备五类设备档案的建立与维护
- 设备类别：设备类别树维护，以及自有、租赁、队伍自带三种来源信息与设备履历管理
- 日常管理：进出场记录（含使用明细）、用车记录、加油记录
- 维保管理：维修记录（含维修明细）、保养记录（含保养明细）、检验记录、保险记录、违章/事故记录
- 处置管理：报废、移交
- 基础设置：设备类别、计量单位、油卡、油卡充值记录、加油单次金额/量阈值
- 统计分析：设备总览、维保费用统计、设备利用率、到期预警
- 暂不实现：保养计划与检验计划（周期计划编制、到期自动派工）
- 暂不实现：设备采购与折旧核算
- 暂不实现：备件管理与点检、定检管理
- 暂不实现：报废、保险的线上审批流程（沿用审批状态字段，暂不接工作流）
- 集合继承台账：设备通用字段集中在设备主表
tabMachineLibrary，生产设备、车辆、办公设备、测量设备、试验设备五张表继承主表并只扩展类型专属字段；维修、保养、检验等业务记录统一引用设备主表，无需按设备类型重复建模。 - 状态联动回写：进出场、维修、保养、报废、移交等业务动作自动回写设备的设备状态、技术状态、下次检验日期、当前里程、保管人与所属机构等主表字段。
- 统一类别树：设备类别树同时决定新建设备归属哪类台账、默认计量单位与适用的加油阈值，类别编码按层级自动拼接。
- 阈值与到期双预警：加油单次金额/油量按设备类别配置阈值并实时触发提醒；检验日期、保险到期、预计取回时间按提前量触发到期预警。
- 明细汇总：使用明细、维修明细、保养明细逐项登记，台班工时、工程量、能耗与费用金额自动汇总回主记录。
解决方案： EIM 应用域： 设备资产管理 - EAM 应用名称： 设备管理系统 - Machine 估算定价： 4800 元/年
| 名词 | 释义 |
|---|---|
| 设备台账 | 按设备类别建立的设备档案集合，本应用划分为生产设备、车辆、办公设备、测量设备、试验设备五类 |
| 设备类别 | 设备的树形分类，决定设备归属哪类台账、默认计量单位与适用的加油阈值 |
| 设备来源 | 设备的取得方式，含自有、租赁、队伍自带三类 |
| 技术状态 | 设备当前的技术完好程度，含完好、良好、尚好 |
| 进出场记录 | 设备进入或离开使用机构的登记单据，一台设备在一个使用机构的一个在场周期对应一条记录 |
| 使用明细 | 进出场记录下按工程部位与时间段登记的台班工时、工程量与能耗 |
| 台班 | 设备在一个工作班次内的使用量，以工时或工程量计量 |
| 用车记录 | 车辆一次出车至回车的全过程登记，含起止里程与过路、停车、油料等费用 |
| 油卡 | 用于设备、车辆加油的储值卡，按卡号建档并记录初始金额与当前余额 |
| 加油阈值 | 单次加油金额或油量的上限判定值，可按设备类别配置 |
| 维修记录 | 设备故障后送修的登记单据，含维修单位、维修原因、预计取回时间与维修费用明细 |
| 保养记录 | 设备按周期保养的登记单据，含保养内容、验收结果与保养费用明细 |
| 检验记录 | 特种设备、测量设备与试验设备送检的登记单据，含检验机构、证书编号与下次检验日期 |
| 保险记录 | 车辆或设备的投保登记单据，含各险种保费与保险生效、到期日期 |
| 违章/事故记录 | 车辆违章或设备事故的登记单据，含扣分、罚款金额与处理情况 |
| 报废 | 设备达到报废条件后的处置登记，保存后回写设备状态与报废日期 |
| 移交 | 设备在人员或机构之间交接的登记单据 |
| 设备履历 | 设备在各机构、项目使用的历史记录，含起止日期、技术状况与保管人 |
| 特种设备 | 国家对安全性有特殊要求、需定期检验并办理使用登记的设备，如起重机械、压力容器等 |
| 大型设备 | 购置单价或规格达到企业规定标准、需重点管理的设备 |
1. 功能设计
Section titled “1. 功能设计”treeView-beta
设备资产管理/
设备管理系统
设备台账
生产设备 ##五类设备台账通用字段与生产设备属性维护
车辆 ##车辆属性维护（识别代号、发动机号、排量、油耗、里程）
办公设备 ##办公设备属性维护（购置信息、保修、使用年限、存放地点）
测量设备 ##测量设备属性维护（测量范围、量程、分度值、准确度等级）
试验设备 ##试验设备属性维护（量程、精度等级、分辨率、灵敏度、使用方向）
日常管理
进出场记录 ##设备入场、离场登记与在场周期管理
使用记录__使用明细 ##按工程部位的台班工时、工程量与能耗登记
用车记录 ##出车、回车登记与里程、费用记录
加油记录 ##加油登记与油卡余额联动
维修记录__维修明细 ##送修登记与维修费用明细
保养记录__保养明细 ##保养执行、验收与费用明细
检验记录 ##送检登记与检验证书、下次检验日期
保险记录 ##投保登记与保险期间跟踪
违章/事故记录 ##违章、事故登记与处理
报废 ##报废登记与设备状态回写
移交 ##设备移交与接管登记
基础设置
设备类别 ##树形设备分类维护
计量单位 ##计量单位维护
油卡 ##油卡档案与余额维护
油卡充值记录 ##油卡充值登记与余额更新
加油单次金额/量阈值 ##按设备类别配置加油阈值
统计分析
设备总览 ##设备状态、来源、类别分布
维保费用统计 ##维修、保养、保险、加油费用统计
设备利用率 ##台班工时与工程量统计
到期预警 ##检验、保险到期清单
保养计划:::postpone icon(ph:empty) ##暂不实现
检验计划:::postpone icon(ph:empty) ##暂不实现
设备采购与折旧:::postpone icon(ph:empty) ##暂不实现
备件与点检:::postpone icon(ph:empty) ##暂不实现
2. 业务流程
Section titled “2. 业务流程”设备全生命周期流程
flowchart LR;
A(设备类别) -.-> B(设备台账) --> C(进出场记录) --> D(使用记录) --> E(保养记录) --> G(报废)
D --> F(维修记录) --> G
D -.-> H(用车记录) -.-> I(加油记录) -.-> J(油卡)
C -.-> K(检验记录)
C -.-> L(保险记录)
C -.-> M(违章/事故记录)
B -.-> N(设备履历)
classDef key fill:#fef9c3,stroke:#ca8a04,color:#111
classDef branch fill:#E5F6DA,stroke:#569230,color:#111;
class B key;
class H,I,J,K,L,M,N branch;
设备进退场流程（线下执行）
swimlane-beta
subgraph 设备管理员
A(建立设备台账)
E(核对进出场信息)
H(生成设备履历)
end
subgraph 现场设备员
B(登记设备入场)
F(登记使用明细)
D(登记设备离场)
end
subgraph 保管人
C(确认接收设备)
G(确认离场状态)
end
A --> B --> C --> F --> E --> D --> G --> H
classDef branch fill:#E5F6DA,stroke:#569230,color:#111;
class E branch;
设备维保流程（线下执行）
swimlane-beta
subgraph 保管人
A(发现设备故障或到达保养、检验期)
B(线下送修、送保、送检)
end
subgraph 外部单位
C(维修、保养、检验作业)
end
subgraph 设备管理员
D(登记维修、保养、检验记录)
E(登记费用明细与验收结果)
F(回写设备状态、技术状态与下次检验日期)
end
A --> B --> C --> D --> E --> F
classDef branch fill:#E5F6DA,stroke:#569230,color:#111;
class B,C branch;
3. 业务逻辑及设计
Section titled “3. 业务逻辑及设计”需求编号
RQ-Machine-{MMNN}：{MM} 为模块序号（按「功能设计」菜单树顺序，两位补零），{NN} 为模块内需求序号（两位补零）。编号一经分配即锁定，不复用、不回收。
01. 生产设备
Section titled “01. 生产设备”设备台账的通用规则在模块 01 内定义，模块 02 ~ 05 只定义各类型设备的专属字段与专属规则。
| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0101 | 新建设备时，设备名称、设备编号、设备类别、设备来源为必填 | P0 | 四项任一为空时「提交」不可用并逐项提示缺失字段 | tabMachineLibrary.name tabMachineLibrary.code tabMachineLibrary.catalognew tabMachineLibrary.source |
| RQ-Machine-0102 | 设备编号按「设备类别编码-流水号」自动生成，且全表唯一 | P0 | 保存后 code 按规则生成；提交重复编号时保存被拒绝并提示编号已存在 | tabMachineLibrary.code |
| RQ-Machine-0103 | 设备状态默认「未入场」，可选未入场、使用中、闲置、保养、维修、离场、报废 | P0 | 新增时 status 默认取「未入场」；下拉选项与「设备状态」字典取值一致 | tabMachineLibrary.status |
| RQ-Machine-0104 | 技术状态默认「完好」，可选完好、良好、尚好 | P1 | 新增时 technicalStatus 默认取「完好」 | tabMachineLibrary.technicalStatus |
| RQ-Machine-0105 | 设备来源为「自有」时，展示自有信息页签，净值与入账日期为必填 | P0 | source=「自有」时「自有」页签可见；净值或入账日期为空时不可保存 | tabMachineOwner.netWorth tabMachineOwner.groupDate |
| RQ-Machine-0106 | 设备来源为「租赁」时，展示租赁信息页签，租赁类型、计价类型、供应商为必填 | P0 | source=「租赁」时「租赁」页签可见；三项任一为空时不可保存 | tabMachineLease.leaseType tabMachineLease.pricingType tabMachineLease.supplier |
| RQ-Machine-0107 | 设备来源为「队伍自带」时，展示队伍自带页签，计价类型、供应商为必填 | P1 | source=「队伍自带」时「队伍自带」页签可见；两项任一为空时不可保存 | tabMachineTeamsOwner.pricingType tabMachineTeamsOwner.supplier |
| RQ-Machine-0108 | 标记为特种设备或大型设备时，检验周期与下次检验日期为必填 | P0 | 「是否特种设备」或「是否大型设备」为真且检验周期为空时不可保存 | tabMachineLibrary.special tabMachineLibrary.large tabMachineLibrary.examinePeriod tabMachineLibrary.nextExamineDate |
| RQ-Machine-0109 | 设备列表默认只展示当前用户所属机构及其下级机构的设备 | P0 | 不同机构用户登录后，列表条数等于其机构可见范围内的设备数 | tabMachineLibrary.organise |
| RQ-Machine-0110 | 设备类别只能选择设备类别树的叶子节点 | P1 | 选择带子节点的类别时保存被拒绝并提示需选择末级类别 | tabMachineLibrary.catalognew tabMachineCatalog.children |
| RQ-Machine-0111 | 设备保存成功后自动生成一条设备履历，起始日期取设备创建日期 | P1 | 新增设备成功后 tabMachineResume 新增一条记录，且 startDate 等于设备创建日期 | tabMachineResume.startDate tabMachineResume.library |
| RQ-Machine-0112 | 设备状态为「报废」的设备不可再被新增进出场、用车、加油、维修、保养记录引用 | P1 | 新增上述记录时，设备选择器中不出现 status=「报废」的设备 | tabMachineLibrary.status |
| RQ-Machine-0113 | 设备可上传设备照片与随机资料附件 | P2 | 单条设备记录的附件数量不超过 10 个，格式与大小遵循底座文件管理约定 | tabMachineLibrary.files |
02. 车辆
Section titled “02. 车辆”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0201 | 车辆档案记录车辆识别代号、发动机号、排量与购置价格 | P1 | 四项在车辆档案详情中可查看，且可被车辆台账列表检索 | tabMachineCar.identificationNumber tabMachineCar.engineNumber tabMachineCar.displacement tabMachineCar.purchasePrice |
| RQ-Machine-0202 | 车辆登记初始里程与当前里程，累计里程自动等于当前里程减初始里程 | P0 | 两项里程均填写后 totalMileage 自动等于差值，且不可手工编辑 | tabMachineCar.initialMileage tabMachineCar.currentMileage tabMachineCar.totalMileage |
| RQ-Machine-0203 | 车辆档案记录百公里油耗与油品类型 | P1 | 两项可填写并展示于车辆档案详情 | tabMachineCar.fuelConsumption tabMachineCar.oilType |
| RQ-Machine-0204 | 车辆档案记录车龄，可手工填写或按购置日期自动推算 | P2 | 填写购置日期后 carAge 自动带出，且允许手工覆盖 | tabMachineCar.carAge tabMachineCar.purchaseDate |
| RQ-Machine-0205 | 车辆档案可上传行驶证、登记证等附件 | P2 | 单条车辆记录的附件数量不超过 10 个 | tabMachineCar.files |
03. 办公设备
Section titled “03. 办公设备”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0301 | 办公设备记录购置日期、购置价格、供应商、合同编号与资金来源 | P1 | 五项可填写并展示于办公设备档案详情 | tabMachineOffice.purchaseDate tabMachineOffice.purchasePrice tabMachineOffice.supplierName tabMachineOffice.contractNumber tabMachineOffice.fundsSource |
| RQ-Machine-0302 | 办公设备记录使用年限与残值率，作为资产盘点与处置参考 | P2 | 两项可填写并展示于档案详情，取值范围为正值 | tabMachineOffice.usingYears tabMachineOffice.salvageRate |
| RQ-Machine-0303 | 办公设备记录保修期与存放地点 | P2 | 两项可填写并展示于档案详情 | tabMachineOffice.warrantyPeriod tabMachineOffice.storePlace |
| RQ-Machine-0304 | 办公设备记录配置说明，支持富文本录入 | P2 | 配置说明按富文本保存与展示，换行与列表格式不丢失 | tabMachineOffice.config |
04. 测量设备
Section titled “04. 测量设备”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0401 | 测量设备记录测量范围、量程、分度值与不确定度 | P1 | 四项可填写并展示于测量设备档案详情 | tabMachineMeasure.measureRange tabMachineMeasure.range tabMachineMeasure.divisionValue tabMachineMeasure.uncertainty |
| RQ-Machine-0402 | 测量设备准确度等级从「精度等级」字典中选取 | P1 | 下拉选项与「精度等级」字典启用项一致，不可手工录入字典外的值 | tabMachineMeasure.accuracyLevel |
| RQ-Machine-0403 | 测量设备记录购置日期、购置价格、供应商、启用日期、有效日期与存放地点 | P2 | 六项可填写并展示于档案详情 | tabMachineMeasure.purchaseDate tabMachineMeasure.purchasePrice tabMachineMeasure.supplierName tabMachineMeasure.enableDate tabMachineMeasure.validDate tabMachineMeasure.storePlace |
| RQ-Machine-0404 | 测量设备有效日期到期前 30 天与 7 天提醒设备管理人 | P1 | 距有效日期 30 天与 7 天时，各生成一条提醒发送至设备管理人 | tabMachineMeasure.validDate |
05. 试验设备
Section titled “05. 试验设备”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0501 | 试验设备记录量程、分辨率、灵敏度与存放地点 | P1 | 四项可填写并展示于试验设备档案详情 | tabMachineInspectionEquipment.range tabMachineInspectionEquipment.resolution tabMachineInspectionEquipment.sensitivity tabMachineInspectionEquipment.storePlace |
| RQ-Machine-0502 | 试验设备精度等级从「精度等级」字典中选取 | P1 | 下拉选项与「精度等级」字典启用项一致 | tabMachineInspectionEquipment.precision |
| RQ-Machine-0503 | 试验设备记录使用方向，取值来自「使用方向」字典 | P2 | 下拉选项与「使用方向」字典取值一致 | tabMachineInspectionEquipment.usingDirection |
| RQ-Machine-0504 | 试验设备记录购置日期、购置价格、供应商、启用日期与有效日期 | P2 | 五项可填写并展示于档案详情 | tabMachineInspectionEquipment.purchaseDate tabMachineInspectionEquipment.purchasePrice tabMachineInspectionEquipment.supplierName tabMachineInspectionEquipment.enableDate tabMachineInspectionEquipment.validDate |
06. 进出场记录
Section titled “06. 进出场记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0601 | 进出场记录必须关联一台设备，且同一设备不允许同时存在两条状态为「使用中」的进出场记录 | P0 | 为已有「使用中」记录的设备再次登记入场时，保存被拒绝并提示该设备在场 | tabMachineUsing.library tabMachineUsing.status |
| RQ-Machine-0602 | 登记入场时入场日期为必填，保存后设备状态自动置为「使用中」 | P0 | 保存入场记录后 tabMachineLibrary.status 变为「使用中」 | tabMachineUsing.entryDate tabMachineLibrary.status |
| RQ-Machine-0603 | 登记离场时实际离场日期为必填，保存后设备状态自动置为「离场」 | P0 | 保存离场记录后 tabMachineLibrary.status 变为「离场」 | tabMachineUsing.exitDate tabMachineLibrary.status |
| RQ-Machine-0604 | 实际离场日期与计划离场日期均不得早于入场日期 | P0 | 填写的离场日期早于入场日期时保存被拒绝并提示 | tabMachineUsing.exitDate tabMachineUsing.planExitDate tabMachineUsing.entryDate |
| RQ-Machine-0605 | 进出场记录登记能源供应方式，取值来自「能源供应类型」字典 | P1 | 下拉选项与「能源供应类型」字典取值一致 | tabMachineUsing.energySupply |
| RQ-Machine-0606 | 设备来源为「租赁」或「队伍自带」时，进出场记录可登记指导价、计价类型、进出场费、租赁期与租金 | P1 | 上述字段在租赁、队伍自带设备上可编辑，自有设备上置灰不可编辑 | tabMachineUsing.guidePrice tabMachineUsing.pricingType tabMachineUsing.entryExitFee tabMachineUsing.leasePeriod tabMachineUsing.rent |
| RQ-Machine-0607 | 租赁设备的累计租金按「租赁单价 × 租赁期」计算 | P0 | 填写租赁单价与租赁期后 totalRent 自动等于两者乘积 | tabMachineUsing.leasePrice tabMachineUsing.leasePeriod tabMachineUsing.totalRent |
| RQ-Machine-0608 | 进出场记录登记技术状态，取值来自「技术状况」字典 | P1 | 下拉选项与「技术状况」字典取值一致 | tabMachineUsing.technicalStatus |
| RQ-Machine-0609 | 设备离场时回写设备履历的结束日期为该次离场日期 | P1 | 保存离场后，对应履历记录的 endDate 等于本次离场日期 | tabMachineResume.endDate tabMachineUsing.exitDate |
| RQ-Machine-0610 | 进出场记录可上传进场验收单、离场确认单等附件 | P2 | 单条记录的附件数量不超过 10 个 | tabMachineUsing.files |
07. 使用记录
Section titled “07. 使用记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0701 | 使用明细必须关联一条进出场记录与一个工程部位 | P0 | 两项任一为空时「提交」不可用并提示缺失字段 | tabMachineUsingDetail.usingRecord tabMachineUsingDetail.projectItem |
| RQ-Machine-0702 | 使用明细记录开始时间与结束时间，结束时间不得早于开始时间 | P0 | 结束时间早于开始时间时保存被拒绝并提示 | tabMachineUsingDetail.startTime tabMachineUsingDetail.endTime |
| RQ-Machine-0703 | 台班工时按开始时间与结束时间的差值（小时）自动带出，允许手工修正 | P1 | 填写起止时间后 operateHours 自动等于时间差小时数，且可手工覆盖 | tabMachineUsingDetail.operateHours |
| RQ-Machine-0704 | 使用明细登记工程量，工作量单位取设备档案上的工作量单位 | P1 | 提交后 workload 的计量单位与设备 unit 一致 | tabMachineUsingDetail.workload tabMachineLibrary.unit |
| RQ-Machine-0705 | 使用明细支持登记两种能源的消耗量及各自的能源类型与能源单位 | P1 | 类型与单位下拉项分别与「能源类型」「能源单位」字典取值一致 | tabMachineUsingDetail.energyConsumption tabMachineUsingDetail.energyType1 tabMachineUsingDetail.energyUnit1 tabMachineUsingDetail.energyType2 tabMachineUsingDetail.energyUnit2 |
| RQ-Machine-0706 | 使用明细保存后自动汇总回写进出场记录的累计台班工时、累计工程量与累计能耗 | P0 | 新增、修改、删除明细后，对应进出场记录的 totalOperateHours、totalWorkload、totalEnergyConsumption 等于其全部明细的合计值 | tabMachineUsing.totalOperateHours tabMachineUsing.totalWorkload tabMachineUsing.totalEnergyConsumption |
| RQ-Machine-0707 | 同一进出场记录下的使用明细时间段不允许重叠 | P1 | 提交与已有明细时间段重叠的记录时保存被拒绝并提示 | tabMachineUsingDetail.startTime tabMachineUsingDetail.endTime |
08. 用车记录
Section titled “08. 用车记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0801 | 用车记录必须关联一台车辆并指定驾驶员 | P0 | 车辆或驾驶员为空时「提交」不可用并提示 | tabMachineVehicleUsage.library tabMachineVehicleUsage.driver |
| RQ-Machine-0802 | 用车记录必填用车事由与目的地 | P1 | 两项任一为空时「提交」不可用并提示 | tabMachineVehicleUsage.purpose tabMachineVehicleUsage.destination |
| RQ-Machine-0803 | 回车时间不得早于出车时间，回车里程不得小于出车里程 | P0 | 填写值违规时保存被拒绝并逐项提示 | tabMachineVehicleUsage.returnTime tabMachineVehicleUsage.departureTime tabMachineVehicleUsage.returnMileage tabMachineVehicleUsage.departureMileage |
| RQ-Machine-0804 | 行驶里程自动等于回车里程减出车里程 | P0 | 填写出车与回车里程后 mileage 自动等于差值 | tabMachineVehicleUsage.departureMileage tabMachineVehicleUsage.returnMileage tabMachineVehicleUsage.mileage |
| RQ-Machine-0805 | 用车时长自动等于回车时间减出车时间（小时） | P2 | 填写起止时间后 duration 自动等于时间差小时数 | tabMachineVehicleUsage.duration |
| RQ-Machine-0806 | 用车记录分别登记过路费、停车费、油费与其他费用 | P1 | 四项可填写，均不允许负值 | tabMachineVehicleUsage.tollFee tabMachineVehicleUsage.parkingFee tabMachineVehicleUsage.fuelFee tabMachineVehicleUsage.otherFee |
| RQ-Machine-0807 | 车辆回车后，车辆档案的当前里程自动更新为本次回车里程 | P1 | 保存回车信息后 tabMachineCar.currentMileage 等于本次 returnMileage | tabMachineCar.currentMileage tabMachineVehicleUsage.returnMileage |
| RQ-Machine-0808 | 用车记录可关联当次使用的油卡 | P2 | 记录可关联一张状态为「可用」的油卡 | tabMachineFuelCard.status |
09. 加油记录
Section titled “09. 加油记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-0901 | 加油记录必须关联设备，可关联用车记录、进出场记录与油卡 | P0 | 设备为空时「提交」不可用；关联的用车记录或进出场记录必须属于同一台设备，否则保存被拒绝 | tabMachineRefueling.library tabMachineRefueling.vehicleUsage tabMachineRefueling.usingRecord |
| RQ-Machine-0902 | 加油金额自动等于单价乘数量 | P0 | 填写单价与数量后 amount 自动等于乘积，且可手工覆盖 | tabMachineRefueling.unitPrice tabMachineRefueling.volume tabMachineRefueling.amount |
| RQ-Machine-0903 | 付款方式为「油卡」时必须选择油卡，为「现金」时油卡字段不可选 | P0 | 付款方式选择「油卡」且油卡为空时保存被拒绝；选择「现金」时油卡字段置灰 | tabMachineRefueling.paymentMethod tabMachineRefueling.fuelCard |
| RQ-Machine-0904 | 使用油卡付款的加油记录保存后，自动扣减该油卡余额 | P0 | 保存后油卡 balance 等于原余额减本次加油金额 | tabMachineFuelCard.balance tabMachineRefueling.amount |
| RQ-Machine-0905 | 油品类型从「油品类型」字典中选取 | P1 | 下拉选项与「油品类型」字典取值一致 | tabMachineRefueling.oilType |
| RQ-Machine-0906 | 加油记录登记保管人，默认带出设备档案上的保管人 | P2 | 新增记录时 superintendent 默认等于设备 custodian，且可修改 | tabMachineRefueling.superintendent tabMachineLibrary.custodian |
| RQ-Machine-0907 | 加油流水号按编码规则自动生成且唯一 | P2 | 保存后 serialNumber 按规则生成，重复时自动续号 | tabMachineRefueling.serialNumber |
10. 维修记录
Section titled “10. 维修记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1001 | 维修记录必须关联设备，必填维修日期、维修单位与维修原因 | P0 | 四项任一为空时「提交」不可用并逐项提示 | tabMachineRepair.library tabMachineRepair.date tabMachineRepair.repairUnit tabMachineRepair.reason |
| RQ-Machine-1002 | 维修明细逐项登记项目名称与金额，维修总金额自动等于全部明细金额之和 | P0 | 新增、修改、删除明细后 totalAmount 等于明细 amount 合计值 | tabMachineRepair.totalAmount tabMachineRepairDetail.itemName tabMachineRepairDetail.amount |
| RQ-Machine-1003 | 新建维修记录后设备状态自动置为「维修」 | P0 | 保存维修记录后 tabMachineLibrary.status 变为「维修」 | tabMachineLibrary.status |
| RQ-Machine-1004 | 维修完成后可将设备状态置回「使用中」或「闲置」，并登记技术状态 | P1 | 维修明细录入完成且回填取回信息后，允许选择置回状态；保存后设备状态随之更新 | tabMachineLibrary.status tabMachineLibrary.technicalStatus |
| RQ-Machine-1005 | 维修记录登记送修人与记录人，默认带出当前登录用户与设备保管人 | P2 | 新增时 recorder 默认等于当前登录用户，sender 默认等于设备保管人，均可修改 | tabMachineRepair.recorder tabMachineRepair.sender tabMachineLibrary.custodian |
| RQ-Machine-1006 | 维修预计取回时间到期前 1 天提醒送修人 | P1 | 距 expectedPickupTime 1 天时生成一条提醒发送至送修人 | tabMachineRepair.expectedPickupTime tabMachineRepair.sender |
11. 保养记录
Section titled “11. 保养记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1101 | 保养记录必须关联设备，必填保养日期、保养单位、保养人与保养内容 | P0 | 五项任一为空时「提交」不可用并逐项提示 | tabMachineMaintenance.library tabMachineMaintenance.maintenanceDate tabMachineMaintenance.maintenanceUnit tabMachineMaintenance.maintainer tabMachineMaintenance.content |
| RQ-Machine-1102 | 保养明细逐项登记项目名称与金额，保养总金额自动等于全部明细金额之和 | P0 | 新增、修改、删除明细后 totalAmount 等于明细 amount 合计值 | tabMachineMaintenance.totalAmount tabMachineMaintenanceDetail.itemName tabMachineMaintenanceDetail.amount |
| RQ-Machine-1103 | 新建保养记录后设备状态自动置为「保养」 | P0 | 保存保养记录后 tabMachineLibrary.status 变为「保养」 | tabMachineLibrary.status |
| RQ-Machine-1104 | 保养完成后登记验收人、验收日期与验收结果，保存后设备状态置回「使用中」或「闲置」 | P1 | 三项验收信息填写后允许置回状态；保存后设备状态随之更新 | tabMachineMaintenance.verifier tabMachineMaintenance.verifyDate tabMachineMaintenance.verifyResult tabMachineLibrary.status |
| RQ-Machine-1105 | 车辆保养时登记保养时里程，保存后回写车辆档案的当前里程 | P2 | 关联设备为车辆且填写 mileage 时，tabMachineCar.currentMileage 更新为本次里程 | tabMachineMaintenance.mileage tabMachineCar.currentMileage |
| RQ-Machine-1106 | 保养记录登记保养人、记录人与完成日期 | P2 | 三项可填写，记录人默认等于当前登录用户 | tabMachineMaintenance.maintainer tabMachineMaintenance.recorder tabMachineMaintenance.completionDate |
12. 检验记录
Section titled “12. 检验记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1201 | 检验记录必须关联设备，必填检验日期与检验机构 | P0 | 三项任一为空时「提交」不可用并逐项提示 | tabMachineInspection.library tabMachineInspection.inspectionDate tabMachineInspection.inspectionUnit |
| RQ-Machine-1202 | 检验记录保存后自动回写设备的检验日期与下次检验日期 | P0 | 保存后 tabMachineLibrary.examineDate 等于本次检验日期，nextExamineDate 等于本次下次检验日期 | tabMachineLibrary.examineDate tabMachineLibrary.nextExamineDate |
| RQ-Machine-1203 | 下次检验日期默认等于检验日期加设备检验周期（月），允许手工覆盖 | P0 | 检验周期为 8、检验日期为 2026-03-01 时，nextExamineDate 默认带出 2026-11-01 | tabMachineInspection.inspectionDate tabMachineLibrary.examinePeriod tabMachineLibrary.nextExamineDate |
| RQ-Machine-1204 | 检验记录登记送检单位、证书编号与送检人 | P1 | 三项可填写，送检人默认等于设备保管人 | tabMachineInspection.sendUnit tabMachineInspection.certificateNumber tabMachineInspection.sender |
| RQ-Machine-1205 | 检验不合格时，设备状态自动置为「维修」或「闲置」，且不允许继续置为「使用中」 | P1 | 检验结果保存为不合格并选择处置方式后，设备状态随之更新 | tabMachineInspection.result tabMachineLibrary.status |
| RQ-Machine-1206 | 检验记录可上传检验证书附件 | P2 | 单条记录的附件数量不超过 10 个 | tabMachineInspection.files |
13. 保险记录
Section titled “13. 保险记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1301 | 保险记录必须关联设备，必填投保日期、保险公司、生效日期与到期日期 | P0 | 五项任一为空时「提交」不可用并逐项提示 | tabMachineInsurance.library tabMachineInsurance.insureDate tabMachineInsurance.insuranceCompany tabMachineInsurance.effectiveDate tabMachineInsurance.expiryDate |
| RQ-Machine-1302 | 到期日期不得早于生效日期 | P0 | 到期日期早于生效日期时保存被拒绝并提示 | tabMachineInsurance.expiryDate tabMachineInsurance.effectiveDate |
| RQ-Machine-1303 | 保费合计自动等于商业险、交强险、车船税与其他保费之和 | P0 | 四项保费填写后 totalInsuranceFee 自动等于合计值 | tabMachineInsurance.commercialInsuranceFee tabMachineInsurance.compulsoryInsuranceFee tabMachineInsurance.vehicleTaxFee tabMachineInsurance.otherInsuranceFee tabMachineInsurance.totalInsuranceFee |
| RQ-Machine-1304 | 同一设备在相同保险期间内不允许存在两条有效保险记录 | P1 | 保险期间存在重叠时保存被拒绝并提示 | tabMachineInsurance.effectiveDate tabMachineInsurance.expiryDate |
| RQ-Machine-1305 | 保单号按编码规则自动生成，允许手工覆盖为保险公司出具的保单号 | P2 | 保存后 policyNumber 按规则生成；手工填写时以填写值为准 | tabMachineInsurance.policyNumber |
| RQ-Machine-1306 | 保险记录可上传保单附件 | P2 | 单条记录的附件数量不超过 10 个 | tabMachineInsurance.files |
14. 违章/事故记录
Section titled “14. 违章/事故记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1401 | 违章/事故记录必须关联设备，必填发生时间与情况描述 | P0 | 三项任一为空时「提交」不可用并逐项提示 | tabMachineViolation.library tabMachineViolation.violationTime tabMachineViolation.description |
| RQ-Machine-1402 | 车辆违章登记扣分与罚款金额，处理完成后登记处理时间 | P1 | deductPoints 与 fine 均不允许负值；处理时间不得早于发生时间 | tabMachineViolation.deductPoints tabMachineViolation.fine tabMachineViolation.handleTime |
| RQ-Machine-1403 | 登记违章人与登记人，违章人默认等于当次用车记录的驾驶员 | P1 | 选择用车记录后 violator 自动带出该记录的 driver，且可修改 | tabMachineViolation.violator tabMachineViolation.vehicleUsage tabMachineVehicleUsage.driver |
| RQ-Machine-1404 | 违章/事故记录登记发生地点与备注 | P2 | 两项可填写并展示于记录详情 | tabMachineViolation.violationLocation tabMachineViolation.remark |
| RQ-Machine-1405 | 违章编号按编码规则自动生成且唯一 | P2 | 保存后 violationNumber 按规则生成，重复时自动续号 | tabMachineViolation.violationNumber |
15. 报废
Section titled “15. 报废”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1501 | 报废记录必须关联设备，必填报废时间、报废原因与经办人 | P0 | 四项任一为空时「提交」不可用并逐项提示 | tabMachineScrap.library tabMachineScrap.time tabMachineScrap.reason tabMachineScrap.handler |
| RQ-Machine-1502 | 报废记录保存后设备状态自动置为「报废」，并回写设备的报废日期 | P0 | 保存后 tabMachineLibrary.status 变为「报废」，tabMachineLibrary.scrapDate 等于本次报废时间 | tabMachineLibrary.status tabMachineLibrary.scrapDate |
| RQ-Machine-1503 | 状态已为「报废」的设备不允许再次登记报废 | P0 | 为已报废设备登记报废时保存被拒绝并提示设备已报废 | tabMachineScrap.library tabMachineLibrary.status |
| RQ-Machine-1504 | 报废记录保存后自动结束该设备未关闭的设备履历 | P1 | 保存后该设备 endDate 为空的履历记录被回填为本次报废时间 | tabMachineResume.endDate |
| RQ-Machine-1505 | 报废记录登记处理结果 | P2 | 处理结果可填写并展示于记录详情 | tabMachineScrap.result |
16. 移交
Section titled “16. 移交”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1601 | 移交记录必须关联设备，必填移交人、接管人及其各自所属部门 | P0 | 五项任一为空时「提交」不可用并逐项提示 | tabMachineTransfer.library tabMachineTransfer.transferor tabMachineTransfer.transferorDept tabMachineTransfer.preserver tabMachineTransfer.preserverDept |
| RQ-Machine-1602 | 移交保存后自动更新设备的保管人与所属机构为接管人及其所属部门 | P0 | 保存后 tabMachineLibrary.custodian 等于接管人，organise 等于接管人所属部门对应机构 | tabMachineLibrary.custodian tabMachineLibrary.organise |
| RQ-Machine-1603 | 移交记录登记移交工具、其他事项与遗留问题 | P1 | 三项可填写并展示于记录详情 | tabMachineTransfer.tools tabMachineTransfer.others tabMachineTransfer.issues |
| RQ-Machine-1604 | 移交记录可上传移交单及其附件 | P2 | 单条记录的附件数量不超过 10 个 | tabMachineTransfer.files |
17. 设备类别
Section titled “17. 设备类别”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1701 | 设备类别为树形结构，层级不超过 3 层，同一父级下类别名称不允许重复 | P0 | 在同一父级下新增同名类别时保存被拒绝并提示名称重复 | tabMachineCatalog.name tabMachineCatalog.parent tabMachineCatalog.children |
| RQ-Machine-1702 | 设备类别编码按层级自动拼接生成，同一父级下唯一 | P0 | 新增子类别后 code 等于父级编码加同级序号，重复时自动续号 | tabMachineCatalog.code |
| RQ-Machine-1703 | 设备类别必须指定设备类型，决定新建设备进入哪类设备台账 | P0 | 设备类型的选项与「设备类型」字典一致；按类别新建设备时自动进入对应类型表 | tabMachineCatalog.equipmentType tabMachineProduction tabMachineCar tabMachineOffice tabMachineMeasure tabMachineInspectionEquipment |
| RQ-Machine-1704 | 设备类别可指定默认计量单位，按该类别新建设备时自动带出 | P1 | 设备档案的 unit 默认等于类别的 unit，且可修改 | tabMachineCatalog.unit tabMachineLibrary.unit |
| RQ-Machine-1705 | 设备类别记录规格标准与备注 | P2 | 两项可填写并展示于类别详情 | tabMachineCatalog.standard tabMachineCatalog.note |
| RQ-Machine-1706 | 已被设备引用或含下级类别的类别不允许删除 | P0 | 删除时校验引用与子节点，存在引用或子节点时删除被拒绝并提示 | tabMachineCatalog.children tabMachineLibrary.catalognew |
18. 计量单位
Section titled “18. 计量单位”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1801 | 计量单位直接引用系统级「单位」字典，本应用不重复定义字典项 | P1 | 新增单位项后，设备档案「工作量单位」下拉同步可见 | tabMachineLibrary.unit |
| RQ-Machine-1802 | 计量单位页面可维护单位项的启用状态与显示排序 | P2 | 调整排序后下拉选项顺序与页面一致；停用项不出现在下拉中 | tabMachineLibrary.unit |
| RQ-Machine-1803 | 系统级「单位」字典为全局共享数据，不按机构隔离 | P1 | 任意机构用户看到的计量单位列表与系统字典一致 | tabMachineLibrary.unit |
19. 油卡
Section titled “19. 油卡”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-1901 | 油卡必填卡号、开卡日期与油卡类型，卡号全局唯一 | P0 | 三项任一为空时「提交」不可用；卡号重复时保存被拒绝并提示 | tabMachineFuelCard.cardNumber tabMachineFuelCard.cardDate tabMachineFuelCard.type |
| RQ-Machine-1902 | 油卡状态为「作废」时，不允许再被加油记录引用 | P0 | 新增加油记录时，油卡选择器中不出现 status=「作废」的油卡 | tabMachineFuelCard.status tabMachineRefueling.fuelCard |
| RQ-Machine-1903 | 油卡余额等于初始金额加累计充值金额减累计加油金额 | P0 | 新增充值或油卡付款加油后，balance 等于「初始金额 + Σ充值 − Σ加油」 | tabMachineFuelCard.initialAmount tabMachineFuelCard.balance tabMachineRechargeDetail.amount tabMachineRefueling.amount |
| RQ-Machine-1904 | 油卡登记所属项目与备注 | P2 | 两项可填写并展示于油卡详情 | tabMachineFuelCard.projectOrganise tabMachineFuelCard.remark |
| RQ-Machine-1905 | 油卡余额低于初始金额的 10% 时提醒设备管理员 | P1 | 余额触发阈值时生成一条提醒发送至设备管理员 | tabMachineFuelCard.balance tabMachineFuelCard.initialAmount |
20. 油卡充值记录
Section titled “20. 油卡充值记录”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-2001 | 充值记录必须关联油卡，必填充值日期与充值金额 | P0 | 三项任一为空时「提交」不可用；充值金额大于 0 | tabMachineRechargeDetail.fuelCard tabMachineRechargeDetail.rechargeDate tabMachineRechargeDetail.amount |
| RQ-Machine-2002 | 充值记录保存后油卡余额自动增加相应金额 | P0 | 保存后油卡 balance 等于原余额加本次充值金额 | tabMachineFuelCard.balance tabMachineRechargeDetail.amount |
| RQ-Machine-2003 | 充值记录登记经办人，默认带出当前登录用户 | P2 | 新增时 rechargePerson 默认等于当前登录用户，且可修改 | tabMachineRechargeDetail.rechargePerson |
| RQ-Machine-2004 | 充值流水号按编码规则自动生成且唯一 | P2 | 保存后 transactionNumber 按规则生成，重复时自动续号 | tabMachineRechargeDetail.transactionNumber |
21. 加油单次金额/量阈值
Section titled “21. 加油单次金额/量阈值”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-2101 | 阈值可配置类型与阈值数值，类型取「加油阈值类型」字典（单次金额、单次油量） | P0 | 类型或阈值为空时「提交」不可用；阈值数值大于 0 | tabMachineRefuelThreshold.type tabMachineRefuelThreshold.thresholdValue |
| RQ-Machine-2102 | 同一阈值类型下，同一设备类别只允许存在一条启用中的阈值 | P0 | 重复配置时保存被拒绝并提示已存在启用阈值 | tabMachineRefuelThreshold.type tabMachineRefuelThreshold.machineCatalog tabMachineRefuelThreshold.isValid |
| RQ-Machine-2103 | 阈值可关联一个或多个设备类别，未关联任何类别时对所有设备生效 | P1 | 未选择类别时，任意设备加油均参与判定；已选择类别时仅该类别设备参与判定 | tabMachineRefuelThreshold.machineCatalog tabMachineCatalog.children |
| RQ-Machine-2104 | 阈值支持启用与停用，停用后不参与提醒判定 | P0 | isValid 为假时，加油记录不再触发该阈值提醒 | tabMachineRefuelThreshold.isValid |
| RQ-Machine-2105 | 阈值记录备注说明 | P2 | 备注可填写并展示于阈值详情 | tabMachineRefuelThreshold.note |
22. 设备总览
Section titled “22. 设备总览”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-2201 | 按设备状态统计设备台数并以饼图展示 | P1 | 饼图各扇区台数之和等于统计范围内设备总数；无数据的状态不显示图例 | tabMachineLibrary.status |
| RQ-Machine-2202 | 按设备来源统计设备台数并以柱图展示 | P1 | 柱图各类目台数之和等于统计范围内设备总数 | tabMachineLibrary.source |
| RQ-Machine-2203 | 按设备类别统计设备台数，并支持下钻至该类别下的设备列表 | P1 | 点击类别后跳转的设备列表条数等于该类别台数 | tabMachineLibrary.catalognew |
| RQ-Machine-2204 | 设备总览数据仅统计当前用户可见机构范围内的设备 | P0 | 不同机构用户看到的总台数等于其可见范围内的设备数 | tabMachineLibrary.organise |
| RQ-Machine-2205 | 设备总览展示特种设备与大型设备的台数占比 | P2 | 两类台数之和不超过设备总数 | tabMachineLibrary.special tabMachineLibrary.large |
23. 维保费用统计
Section titled “23. 维保费用统计”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-2301 | 按月份统计维修费用与保养费用并以折线图展示 | P1 | 折线图各月金额之和等于所选区间内维修总金额与保养总金额 | tabMachineRepair.totalAmount tabMachineMaintenance.totalAmount |
| RQ-Machine-2302 | 按月份统计保险费用与加油费用 | P1 | 各月金额之和等于所选区间内保险保费合计与加油金额合计 | tabMachineInsurance.totalInsuranceFee tabMachineRefueling.amount |
| RQ-Machine-2303 | 按设备统计维修与保养费用合计，支持按费用降序排列 | P1 | 列表按费用降序时，首行费用为统计范围内的最大合计值 | tabMachineRepair.library tabMachineMaintenance.library |
| RQ-Machine-2304 | 统计结果支持按时间区间与所属机构筛选 | P1 | 调整筛选条件后图表与列表同步刷新，且数据仅覆盖筛选范围 | tabMachineRepair.date tabMachineMaintenance.maintenanceDate |
24. 设备利用率
Section titled “24. 设备利用率”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-2401 | 按设备统计台班工时与工程量并以柱图展示 | P1 | 柱图数值等于所选区间内该设备全部使用明细的台班工时、工程量合计 | tabMachineUsingDetail.operateHours tabMachineUsingDetail.workload |
| RQ-Machine-2402 | 统计所选区间内设备的在场天数与离场天数 | P2 | 在场天数等于进场日期至离场日期（或统计截止日）的天数 | tabMachineUsing.entryDate tabMachineUsing.exitDate |
| RQ-Machine-2403 | 按设备类别汇总台班工时并给出利用率排名 | P2 | 排名按类别台班工时合计降序，合计等于明细汇总值 | tabMachineUsingDetail.operateHours tabMachineCatalog.children |
| RQ-Machine-2404 | 统计结果支持按时间区间与设备类别筛选 | P1 | 调整筛选条件后图表同步刷新，且数据仅覆盖筛选范围 | tabMachineUsingDetail.startTime |
25. 到期预警
Section titled “25. 到期预警”| 编号 | 需求描述 | 优先级 | 验收标准 | 关联对象 |
|---|---|---|---|---|
| RQ-Machine-2501 | 列出下次检验日期在 30 天内的设备清单 | P0 | 清单条数等于 nextExamineDate 在今日至今日加 30 天区间内的设备数 | tabMachineLibrary.nextExamineDate |
| RQ-Machine-2502 | 列出保险到期日期在 30 天内的设备清单 | P0 | 清单条数等于 expiryDate 在今日至今日加 30 天区间内的保险记录数 | tabMachineInsurance.expiryDate |
| RQ-Machine-2503 | 到期预警清单按剩余天数升序排列，已超期项置顶并高亮 | P1 | 列表首行为剩余天数最小的记录；剩余天数为负时以醒目样式展示 | tabMachineLibrary.nextExamineDate tabMachineInsurance.expiryDate |
| RQ-Machine-2504 | 预警清单支持跳转至对应设备的检验记录或保险记录新增页 | P2 | 点击跳转后打开的页面预置该设备，且新增表单可直接提交 | tabMachineInspection.library tabMachineInsurance.library |
4. 实体关系
Section titled “4. 实体关系”erDiagram
direction LR
subgraph **设备资产管理**
subgraph **设备台账**
L[tabMachineLibrary设备] {
long id "ID"
string code "设备编号"
string name "设备名称"
string specification "规格型号"
string model "型号"
string power "功率"
decimal originalValue "设备原值"
string manufacturer "生产厂商"
string factoryNumber "出厂编号"
date factoryDate "出厂日期"
string registrationNumber "登记号/车牌号"
string brand "品牌"
string country "产地"
kv supplyType "能源供应类型"
kv energyType1 "能源类型1"
kv energyUnit1 "能源单位1"
kv energyType2 "能源类型2"
kv energyUnit2 "能源单位2"
kv status "设备状态"
kv unit "工作量单位"
int examinePeriod "检验周期(月)"
date examineDate "检验日期"
date nextExamineDate "下次检验日期"
bool special "是否特种设备"
bool large "是否大型设备"
kv technicalStatus "技术状态"
int seatNumber "载客数"
date scrapDate "报废日期"
kv source "设备来源"
file files "附件:设备照片、随机资料"
ref organise "所属机构"
ref projectOrganise "使用项目"
ref custodian "保管人"
ref catalognew "设备类别"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
P[tabMachineProduction生产设备] {
long id "ID"
kv managerCategory "管理类别"
}
C[tabMachineCar车辆] {
long id "ID"
string identificationNumber "车辆识别代号"
string engineNumber "发动机号"
decimal displacement "排量"
date purchaseDate "购置日期"
decimal purchasePrice "购置价格"
decimal fuelConsumption "百公里油耗"
kv oilType "油品类型"
string carAge "车龄"
decimal initialMileage "初始里程"
decimal currentMileage "当前里程"
decimal totalMileage "累计里程"
file files "附件:行驶证、登记证"
}
O[tabMachineOffice办公设备] {
long id "ID"
date purchaseDate "购置日期"
decimal purchasePrice "购置价格"
string supplierName "供应商"
string contractNumber "合同编号"
kv fundsSource "资金来源"
int usingYears "使用年限"
int salvageRate "残值率"
string warrantyPeriod "保修期"
string storePlace "存放地点"
md config "配置说明"
}
M[tabMachineMeasure测量设备] {
long id "ID"
string measureRange "测量范围"
string range "量程"
kv accuracyLevel "准确度等级"
string divisionValue "分度值"
string uncertainty "不确定度"
date purchaseDate "购置日期"
decimal purchasePrice "购置价格"
string supplierName "供应商"
date enableDate "启用日期"
date validDate "有效日期"
string storePlace "存放地点"
}
IE[tabMachineInspectionEquipment试验设备] {
long id "ID"
string range "量程"
kv precision "精度等级"
string resolution "分辨率"
string sensitivity "灵敏度"
kv usingDirection "使用方向"
string storePlace "存放地点"
date purchaseDate "购置日期"
decimal purchasePrice "购置价格"
string supplierName "供应商"
date enableDate "启用日期"
date validDate "有效日期"
}
CT[tabMachineCatalog设备类别] {
long id "ID"
string code "类别编码"
string name "类别名称"
string standard "规格标准"
kv unit "默认计量单位"
kv equipmentType "设备类型"
md note "备注"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
}
OW[tabMachineOwner自有] {
long id "ID"
decimal netWorth "净值"
date groupDate "入账日期"
kv source "资金来源"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
}
LS[tabMachineLease租赁] {
long id "ID"
kv leaseType "租赁类型"
kv leaseCategory "租赁类别"
decimal guidePrice "指导价"
kv pricingType "计价类型"
decimal entryExitFee "进出场费"
decimal priceExclTax "不含税价"
decimal leasePrice "租赁单价"
int leasePeriod "租赁期"
date feeStartDate "计费开始日期"
decimal rent "租金"
kv taxRate "税率"
ref supplier "供应商"
file files "附件:租赁合同"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
}
TOW[tabMachineTeamsOwner队伍自带] {
long id "ID"
decimal guidePrice "指导价"
kv pricingType "计价类型"
decimal entryExitFee "进出场费"
decimal contractFee "合同费"
ref supplier "供应商"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
}
RS[tabMachineResume设备履历] {
long id "ID"
ref library "设备"
ref projectOrganise "使用项目"
string projectOrganiseName "项目名称"
date startDate "开始日期"
date endDate "结束日期"
kv technicalCondition "技术状况"
ref custodian "保管人"
md note "备注"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
end
subgraph **运行管理**
US[tabMachineUsing进出场记录] {
long id "ID"
string title "标题"
ref library "设备"
kv status "设备状态"
date entryDate "入场日期"
date planExitDate "计划离场日期"
date exitDate "实际离场日期"
kv energySupply "能源供应方式"
kv leaseType "租赁类型"
kv leaseCatagory "租赁类别"
decimal guidePrice "指导价"
kv pricingType "计价类型"
decimal entryExitFee "进出场费"
decimal priceExclTax "不含税价"
decimal leasePrice "租赁单价"
int leasePeriod "租赁期"
date feeStartDate "计费开始日期"
decimal rent "租金"
decimal contractFee "合同费"
kv taxRate "税率"
decimal netWorth "净值"
decimal totalRent "累计租金"
decimal totalOperateHours "累计台班工时"
decimal totalWorkload "累计工程量"
decimal totalEnergyConsumption "累计能耗"
kv technicalStatus "技术状态"
md currentSituation "现状说明"
md note "备注"
file files "附件:进出场验收单"
ref projectOrganise "使用项目"
ref operator "操作人"
ref preserver "保管人"
ref supplier "供应商"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
UD[tabMachineUsingDetail使用明细] {
long id "ID"
ref usingRecord "进出场记录"
ref projectItem "工程部位"
date startTime "开始时间"
date endTime "结束时间"
decimal operateHours "台班工时"
decimal workload "工程量"
decimal energyConsumption "能耗1"
kv energyType1 "能源类型1"
kv energyUnit1 "能源单位1"
decimal energyConsumption2 "能耗2"
kv energyType2 "能源类型2"
kv energyUnit2 "能源单位2"
md note "备注"
}
VU[tabMachineVehicleUsage用车记录] {
long id "ID"
string title "标题"
ref library "车辆"
ref driver "驾驶员"
md purpose "用车事由"
string destination "目的地"
date departureTime "出车时间"
decimal departureMileage "出车里程"
date returnTime "回车时间"
decimal returnMileage "回车里程"
decimal duration "用车时长"
decimal mileage "行驶里程"
decimal tollFee "过路费"
decimal parkingFee "停车费"
decimal fuelFee "油费"
decimal otherFee "其他费用"
kv approvalStatus "审批状态"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
RF[tabMachineRefueling加油记录] {
long id "ID"
string serialNumber "流水号"
ref library "设备"
date refuelDate "加油日期"
kv paymentMethod "付款方式"
ref fuelCard "油卡"
kv oilType "油品类型"
decimal unitPrice "单价"
decimal volume "数量"
decimal amount "金额"
ref vehicleUsage "用车记录"
ref usingRecord "进出场记录"
ref superintendent "保管人"
md remark "备注"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
FC[tabMachineFuelCard油卡] {
long id "ID"
string cardNumber "卡号"
date cardDate "开卡日期"
kv type "油卡类型"
kv status "油卡状态"
decimal initialAmount "初始金额"
decimal balance "余额"
ref projectOrganise "所属项目"
md remark "备注"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
RC[tabMachineRechargeDetail油卡充值记录] {
long id "ID"
string transactionNumber "流水号"
ref fuelCard "油卡"
date rechargeDate "充值日期"
decimal amount "充值金额"
ref rechargePerson "经办人"
md remark "备注"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
RT[tabMachineRefuelThreshold加油阈值] {
long id "ID"
kv type "阈值类型"
decimal thresholdValue "阈值"
bool isValid "是否启用"
md note "备注"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
end
subgraph **维保管理**
RP[tabMachineRepair维修记录] {
long id "ID"
ref library "设备"
date date "维修日期"
string repairUnit "维修单位"
decimal totalAmount "维修总金额"
md reason "维修原因"
date expectedPickupTime "预计取回时间"
ref sender "送修人"
ref recorder "记录人"
ref projectOrganise "使用项目"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
RPD[tabMachineRepairDetail维修明细] {
long id "ID"
ref repair "维修记录"
string itemName "项目名称"
decimal amount "金额"
md remark "备注"
}
MT[tabMachineMaintenance保养记录] {
long id "ID"
ref library "设备"
date maintenanceDate "保养日期"
string maintenanceUnit "保养单位"
ref maintainer "保养人"
ref recorder "记录人"
md content "保养内容"
date completionDate "完成日期"
string verifier "验收人"
date verifyDate "验收日期"
md verifyResult "验收结果"
decimal totalAmount "保养总金额"
decimal mileage "保养时里程"
ref projectOrganise "使用项目"
ref custodian "保管人"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
MTD[tabMachineMaintenanceDetail保养明细] {
long id "ID"
ref maintenance "保养记录"
string itemName "项目名称"
decimal amount "金额"
md remark "备注"
}
IN[tabMachineInspection检验记录] {
long id "ID"
ref library "设备"
string sendUnit "送检单位"
date inspectionDate "检验日期"
string inspectionUnit "检验机构"
string certificateNumber "证书编号"
md result "检验结果"
date nextExamineDate "下次检验日期"
ref sender "送检人"
md remark "备注"
file files "附件:检验证书"
ref projectOrganise "使用项目"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
IS[tabMachineInsurance保险记录] {
long id "ID"
ref library "设备"
string policyNumber "保单号"
date insureDate "投保日期"
string insuranceCompany "保险公司"
decimal commercialInsuranceFee "商业险保费"
decimal compulsoryInsuranceFee "交强险保费"
decimal vehicleTaxFee "车船税"
decimal otherInsuranceFee "其他保费"
decimal totalInsuranceFee "保费合计"
date effectiveDate "生效日期"
date expiryDate "到期日期"
kv approvalStatus "审批状态"
md remark "备注"
file files "附件:保单"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
VI[tabMachineViolation违章事故记录] {
long id "ID"
string violationNumber "编号"
ref library "设备"
date violationTime "发生时间"
string violationLocation "发生地点"
md description "情况描述"
int deductPoints "扣分"
decimal fine "罚款金额"
date handleTime "处理时间"
ref violator "违章人"
ref registrar "登记人"
ref vehicleUsage "用车记录"
ref usingRecord "进出场记录"
md remark "备注"
ref projectOrganise "使用项目"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
end
subgraph **处置管理**
SC[tabMachineScrap报废] {
long id "ID"
ref library "设备"
date time "报废时间"
md reason "报废原因"
md result "处理结果"
string handler "经办人"
kv approvalStatus "审批状态"
ref projectOrganise "使用项目"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
TR[tabMachineTransfer移交] {
long id "ID"
ref library "设备"
ref transferor "移交人"
ref transferorDept "移交部门"
ref preserver "接管人"
ref preserverDept "接管部门"
md tools "移交工具"
md others "其他事项"
md issues "遗留问题"
md note "注意事项"
file files "附件:移交单"
date createdAt "创建日期"
ref createdBy "创建人"
date updatedAt "最后修改日期"
ref updatedBy "最后修改人"
ref createdOrg "所属机构"
ref createdDept "所属部门"
}
end
end
SUP[tabSRMSupplier供应商] {
refs teamsOwners "队伍自带"
refs leases "租赁"
}
PJ[tabProjectInfo项目信息] {
refs machines "设备"
refs usingRecords "进出场记录"
}
OG[organizations组织机构] {
refs machines "设备"
refs fuelCards "油卡"
}
L ||--|| P : "生产设备"
L ||--|| C : "车辆"
L ||--|| O : "办公设备"
L ||--|| M : "测量设备"
L ||--|| IE : "试验设备"
L ||--|| OW : "自有"
L ||--|| LS : "租赁"
L ||--|| TOW : "队伍自带"
L ||--o{ RS : "履历"
CT ||--o{ L : "设备类别"
L ||--o{ US : "进出场"
US ||--|{ UD : "使用明细"
L ||--o{ VU : "用车"
L ||--o{ RF : "加油"
VU ||--o{ RF : "加油"
US ||--o{ RF : "加油"
FC ||--o{ RF : "加油"
FC ||--o{ RC : "充值"
CT }o--o{ RT : "适用设备类别"
L ||--o{ RP : "维修"
RP ||--|{ RPD : "维修明细"
L ||--o{ MT : "保养"
MT ||--|{ MTD : "保养明细"
L ||--o{ IN : "检验"
L ||--o{ IS : "保险"
L ||--o{ VI : "违章事故"
L ||--o{ SC : "报废"
L ||--o{ TR : "移交"
SUP ||--o{ LS : "供应商"
SUP ||--o{ TOW : "供应商"
PJ ||--o{ L : "使用项目"
OG ||--o{ L : "所属机构"
5. 角色定义与权限矩阵
Section titled “5. 角色定义与权限矩阵”- 设备管理员（
machine）为角色，由本业务维护 - 管理人员（
member）为角色，由脚手架维护 - 管理员（
admin）为系统角色，由脚手架维护 - 设备管理群 为群组，由本业务维护
| 功能 | 设备管理员 | 管理人员 | 管理员 | 设备管理群 |
|---|---|---|---|---|
| 设备台账 | ✓ | 查看、编辑（限所在机构） | ✓ | 查看 |
| 日常管理 - 进出场记录 | ✓ | 查看、添加、编辑（限所在机构） | ✓ | — |
| 日常管理 - 使用记录 | ✓ | 查看、添加、编辑（限所在机构） | ✓ | — |
| 日常管理 - 用车记录 | 查看、管理 | 查看、添加、编辑（限本人） | ✓ | — |
| 日常管理 - 加油记录 | ✓ | 查看、添加（限所在机构） | ✓ | — |
| 维保管理 - 维修记录 | ✓ | 查看、添加、编辑（限所在机构） | ✓ | — |
| 维保管理 - 保养记录 | ✓ | 查看、添加、编辑（限所在机构） | ✓ | — |
| 维保管理 - 检验记录 | ✓ | 查看（限所在机构） | ✓ | 查看 |
| 维保管理 - 保险记录 | ✓ | 查看（限所在机构） | ✓ | — |
| 维保管理 - 违章/事故记录 | ✓ | 查看、添加（限所在机构） | ✓ | — |
| 处置管理 - 报废 | ✓ | — | ✓ | — |
| 处置管理 - 移交 | ✓ | 查看、添加（限所在机构） | ✓ | — |
| 基础设置 | ✓ | — | ✓ | — |
| 统计分析 | ✓ | 查看（限所在机构） | ✓ | 查看 |
6. 审批流程
Section titled “6. 审批流程”无
报废记录、保险记录、用车记录保留「审批状态」字段用于线下留痕，本设计不接入线上审批工作流；如需线上审批另行提出。
7. 提醒/通知规则
Section titled “7. 提醒/通知规则”- 通用约定：
- 区分两类动作：提醒 = 发送至指定个人的系统消息；通知 = 发送至群聊的消息
- 事件触发（实时）：
- 设备入场登记后，提醒设备保管人：设备已入场，请确认接收
- 单次加油金额或油量超过适用阈值时，提醒设备管理员：本次加油已超阈值
- 维修记录登记后，提醒送修人：设备已送修，预计取回时间
- 油卡余额低于初始金额 10% 时，提醒设备管理员：油卡余额不足，请及时充值
- 报废记录保存后，通知设备管理群：设备已报废
- 到期预警（按提前量触发）：
- 设备下次检验日期前 30d/7d/1d，提醒设备保管人与设备管理员
- 保险到期日期前 30d/7d，提醒设备管理员
- 测量设备有效日期前 30d/7d，提醒设备管理员
- 维修预计取回时间前 1d，提醒送修人
- 周期报表（定时发送）：
- 每月 1 日 9:00，发送通知到设备管理群：上月设备维保费用汇总与本月到期预警清单
- 每周一 9:00，发送通知到设备管理群：上周新增进出场、维修、保养记录汇总
8. 编码规则
Section titled “8. 编码规则”- 设备： tabMachineLibrary.code :
{catalognew.code}-{seq} - 设备类别： tabMachineCatalog.code :
{parent.code}{seq} - 加油记录： tabMachineRefueling.serialNumber :
RF-{refuelDate(yyyyMMdd)}-{seq} - 油卡充值记录： tabMachineRechargeDetail.transactionNumber :
RC-{rechargeDate(yyyyMMdd)}-{seq} - 保险记录： tabMachineInsurance.policyNumber :
IN-{insureDate(yyyyMM)}-{seq} - 违章/事故记录： tabMachineViolation.violationNumber :
VI-{violationTime(yyyyMM)}-{seq}
9. 文件存储目录
Section titled “9. 文件存储目录”- 车辆： tabMachineCar.files :
设备管理/车辆/{code} - 租赁： tabMachineLease.files :
设备管理/租赁/{library.code} - 进出场记录： tabMachineUsing.files :
设备管理/进出场/{library.code}/{entryDate(yyyy)} - 检验记录： tabMachineInspection.files :
设备管理/检验/{library.code} - 保险记录： tabMachineInsurance.files :
设备管理/保险/{library.code} - 移交： tabMachineTransfer.files :
设备管理/移交/{library.code}
- 应用：
- 强依赖：有巢脚手架(v0.5.2.20260825)
- 弱依赖：项目管理、供应链管理（供应商）
- 插件：
2.可提炼插件
Section titled “2.可提炼插件”- 到期预警引擎：按「业务表 + 日期字段 + 提前量 + 接收人」配置到期提醒，可复用于设备检验、保险、测量设备有效期、合同到期等场景
3. 数据字典
Section titled “3. 数据字典”设备状态 #MachineStatus ｜ 分类：设备资产管理/EAM 设备类型 #MachineType ｜ 分类：设备资产管理/EAM 设备来源 #MachineSource ｜ 分类：设备资产管理/EAM 技术状况 #TechnicalStatus ｜ 分类：设备资产管理/EAM 使用方向 #DirectionUse ｜ 分类：设备资产管理/EAM 资金来源 #FundsSource ｜ 分类：设备资产管理/EAM 车辆品牌 #MachineBrand ｜ 分类：设备资产管理/EAM
租赁类别 #LeaseCategory ｜ 分类：设备资产管理/EAM 租赁类型 #LeaseType ｜ 分类：设备资产管理/EAM 计价类型 #PricingType ｜ 分类：设备资产管理/EAM
能源类型 #EnergyType ｜ 分类：设备资产管理/EAM 能源单位 #EnergyUnit ｜ 分类：设备资产管理/EAM 能源供应类型 #EnergySupplyType ｜ 分类：设备资产管理/EAM 油卡类型 #FuelCardType ｜ 分类：设备资产管理/EAM 油卡状态 #FuelCardStatus ｜ 分类：设备资产管理/EAM 加油付款方式 #FuelPayMethod ｜ 分类：设备资产管理/EAM 加油阈值类型 #RefuelThreshold ｜ 分类：设备资产管理/EAM
单位 #Unit ｜ 分类：系统/System 税率 #TaxRate ｜ 分类：营销管理/CRM 付款方式 #PaymentMethod ｜ 分类：供应链管理/SCM
本应用新增字典与平台内置字典
Section titled “本应用新增字典与平台内置字典”审批状态 #ApprovalStatus ｜ 分类：系统/System
| 名称 | 编码 | 启用 | 颜色 | 图标 | 父级编码 | 说明 |
|---|---|---|---|---|---|---|
| 草稿 | 0 | 1 | #5cdbd3 | 系统 | ||
| 已退回 | 1 | 1 | #36cfc9 | 系统 | ||
| 已提交 | 2 | 1 | #13c2c2 | 系统 | ||
| 处理中 | 3 | 1 | #08979c | 系统 | ||
| 已通过 | 4 | 1 | #006d75 | 系统 | ||
| 已驳回 | -1 | 1 | #00474f | 系统 |
文件版本记录
Section titled “文件版本记录”20261010-V1.0.0
Section titled “20261010-V1.0.0”初始版本