# 26 物资管理与工具管理 PRD

## 0. Demo开发摘要

- 一句话定位：物资管理与工具管理负责把数据中心备件、耗材、工器具、仪表、库房、出入库、借还、校准、盘点、补货、成本和审计统一治理，支撑维修、EHS、巡检、变更和应急闭环。
- 菜单挂载：运维中心 / 资源保障 / 物资管理与工具管理；与维修管理、EHS、供应商、财务运营、人员、工作流、知识库和报表中心联动。
- Demo主路径：创建备件或工具主数据 -> 入库验收上架 -> 维修/EHS 任务领用或预留 -> 出库 -> 剩余退库 -> 工器具借还 -> 校准维保 -> 盘点差异整改 -> 补货建议 -> 导出审计报表。
- 核心页面：物资工具驾驶舱、备件物资台账、工器具台账、库房库位管理、入库与验收、领用与出库、工器具借还、校准与维保、补货与供应商、库存报表与审计。
- 复用智航能力：CMDB 设备模型、维修工单、EHS 作业许可、供应商、人员权限、工作流、财务成本、报表中心、知识库、dcim-cli。
- 需要 Mock 的 API：主数据、库存、库房、入库、领用、借还、校准、盘点、补货、证据、指标、审计日志。

## 1. 制度依据与行业依据

- 制度原文依据状态：本轮本地制度知识库 healthcheck 未定位到 `DATACENTER_OPS_KB_ROOT`，不能把内部制度条文写成已命中依据。以下内容属于基于仓库白皮书、现状盘点、规划文档和运维物资管理常识的产品化推导。
- 本地白皮书依据：DCOM 运维管理功能群强调维保、供应商、知识库和流程化管理；备件物资与工器具是维修、巡检、EHS 和应急的资源保障基础。
- 本地现状依据：智航已有维修、供应商、流程、知识库和报表基础，物资工具模块应作为这些流程的资源台账、库存流水和成本归集层。
- 本地规划依据：商业化补齐 DCIM/DCOM 缺失模块时，资产、维修、供应商、财务运营需要库存和工具数据作为执行证据与成本依据。
- 产品化推导：模块必须落成主数据、库存余额、库房库位、库存流水、领用申请、工器具借还、校准记录、盘点任务、补货计划、证据和审计日志。

## 2. 现有能力复用分析

| 能力 | 复用对象 | 模块中的使用方式 | 新增边界 |
|---|---|---|---|
| 维修管理 | 维修工单、缺陷、设备、验收 | 领用备件、退库、成本归集和维修证据 | 新增库存预留、领用明细和退库质量 |
| EHS 管理 | 作业许可、风险控制、劳保用品、工具证据 | 高风险作业领用工具和 PPE | 新增作业许可到工具借用关联 |
| CMDB | 设备模型、备件适配、空间、库房 | 建立备件与设备模型、库房空间的关系 | 新增适配件和关键备件等级 |
| 供应商管理 | 供应商、合同、质保、价格 | 入库、补货、退换和质保追踪 | 新增供应商交付与库存周转指标 |
| 财务运营 | 成本中心、费用科目、结算 | 领用成本、库存金额、供应商对账 | 新增成本归集和库存金额快照 |
| 工作流 | 审批、会签、退回、转交 | 领用、调拨、报废、补货、盘点差异审批 | 新增库存审批矩阵 |
| 人员权限 | 员工、班组、供应商人员 | 限定领用、借用、归还、审批和库房访问 | 新增工具责任人和逾期升级 |
| 报表中心 | 导出、订阅、看板 | 输出缺货、周转、借还、校准、成本和审计报告 | 新增库存主题数据集 |

## 3. 用户角色与业务场景

| 角色 | 主要动作 | 关注点 |
|---|---|---|
| 库房负责人 | 配置库房、审批高价值出入库、处理盘点差异和报表 | 缺货、积压、差异、成本、审计 |
| 库管员 | 入库验收、上架、出库、退库、盘点和证据上传 | 数量准确、库位准确、批次和质检 |
| 工具管理员 | 维护工器具台账、借还、校准、禁用和报废 | 逾期、损坏、校准到期、责任人 |
| 维修工程师 | 按维修工单领用备件和归还剩余物资 | 可用库存、适配设备、快速领用 |
| 值班长 | 审批应急领用、监督工器具归还和异常升级 | 应急保障、责任闭环 |
| 采购协同人 | 处理补货建议、供应商交付和到货验收 | 交期、价格、质保、供应商表现 |
| 运营负责人 | 查看库存周转、缺货风险、成本和审计 | 资源保障、成本控制、合规 |

核心业务场景：

1. UPS 电池故障维修工单创建后，系统推荐适配备件，维修工程师发起备件领用并锁定库存。
2. 库管员按审批数量出库，记录批次、序列号、成本中心和现场签收证据。
3. 工程师归还未使用备件，库管员做质量复核并生成退库流水。
4. 高风险 EHS 作业借用绝缘工具和检测仪表，系统校验校准有效期，过期工具禁止借出。
5. 月度盘点发现差异，库房负责人发起差异整改；低于安全库存的关键备件生成补货计划。

## 4. 信息架构与页面清单

| 页面 | 路由 | 角色 | 页面目标 | 核心组件 |
|---|---|---|---|---|
| 物资工具驾驶舱 | `/inventory/overview` | 库房负责人 | 查看备件、耗材、工器具、低库存、借用、校准和成本态势 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 备件物资台账 | `/inventory/spares` | 库管员 | 维护备件、耗材、关键设备备品、批次、库位、保质期和安全库存 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 工器具台账 | `/inventory/tools` | 工具管理员 | 维护工具、仪表、特种工具、校准周期、状态和责任人 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 库房库位管理 | `/inventory/warehouse` | 库房负责人 | 管理库房、货架、库位、温湿度、危险品和客户专属库存 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 入库与验收 | `/inventory/inbound` | 库管员 | 处理采购到货、退库、调拨入库、验收、质检和上架 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 领用与出库 | `/inventory/outbound` | 维修工程师 | 处理维修、巡检、EHS、变更、应急和客户保障领用 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 工器具借还 | `/inventory/borrow` | 值班长 | 管理借用、归还、逾期、损坏、丢失和责任认定 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 校准与维保 | `/inventory/calibration` | 工具管理员 | 管理仪表校准、工具维保、禁用、报废和证书 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 补货与供应商 | `/inventory/replenish` | 采购协同人 | 管理安全库存、补货建议、供应商交付、价格和质保 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |
| 库存报表与审计 | `/inventory/report` | 运营负责人 | 输出周转、缺货、领用、借还、校准、成本和审计报告 | 指标卡、筛选器、表格、详情抽屉、库存流水、审批时间线、证据墙、操作弹窗 |

### 4.1 物资工具驾驶舱

- 页面目标：查看备件、耗材、工器具、低库存、借用、校准和成本态势。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.2 备件物资台账

- 页面目标：维护备件、耗材、关键设备备品、批次、库位、保质期和安全库存。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.3 工器具台账

- 页面目标：维护工具、仪表、特种工具、校准周期、状态和责任人。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.4 库房库位管理

- 页面目标：管理库房、货架、库位、温湿度、危险品和客户专属库存。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.5 入库与验收

- 页面目标：处理采购到货、退库、调拨入库、验收、质检和上架。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.6 领用与出库

- 页面目标：处理维修、巡检、EHS、变更、应急和客户保障领用。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.7 工器具借还

- 页面目标：管理借用、归还、逾期、损坏、丢失和责任认定。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.8 校准与维保

- 页面目标：管理仪表校准、工具维保、禁用、报废和证书。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.9 补货与供应商

- 页面目标：管理安全库存、补货建议、供应商交付、价格和质保。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

### 4.10 库存报表与审计

- 页面目标：输出周转、缺货、领用、借还、校准、成本和审计报告。
- 顶部指标：库存金额、低库存数、缺货数、预留数、借用逾期数、校准到期数、盘点差异数、审计完整率。
- 筛选条件：数据中心、库房、库位、物资类型、分类、关键等级、供应商、库存状态、来源模块、时间范围。
- 表格字段：编码、名称、类型、分类、规格、可用数量、预留数量、库房库位、批次/序列号、状态、责任人。
- 主按钮：新建主数据、入库、领用、出库、退库、借用、归还、校准、盘点、补货、导出报表。
- 行操作：查看详情、库存流水、预留、审批、证据、报废、禁用、供应商对账、审计日志。
- 异常态：库存不足提示替代件；校准过期禁止借出；库位异常要求复核；供应商到货异常进入整改。
- 权限态：库管员操作库存；维修工程师只能申请领用；工具管理员处理校准；运营负责人只读报表。

## 5. 业务流程与状态机

| 状态 | 中文名 | 进入条件 | 可执行动作 | 退出条件 |
|---|---|---|---|---|
| draft | 草稿 | 物资、工具或库存单据创建未提交 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| submitted | 已提交 | 入库、出库、借用、调拨、报废或补货申请提交 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| reviewing | 审批中 | 库房、专业、成本、供应商或运营角色审批 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| approved | 已批准 | 单据审批通过，等待执行 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| pending_check | 待验收/待复核 | 需要质检、数量复核、校准复核或归还检查 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| stocked | 已入库 | 物资上架或工具归库完成 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| reserved | 已预留 | 库存被维修、EHS、变更或应急任务锁定 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| issued | 已出库/借出 | 物资领用或工具借出完成 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| returning | 归还中 | 工具或剩余物资待归还复核 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| calibrating | 校准中 | 工具或仪表进入校准/维保流程 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| rectifying | 整改中 | 盘点差异、损坏、丢失或质检异常待处理 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| closed | 已关闭 | 单据、证据、成本、审计归档完成 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |
| voided | 已作废 | 单据撤销或库存对象失效，保留原因 | 查看、编辑、提交、审批、验收、出库、归还、校准、盘点、关闭 | 满足状态规则并写入审计 |

主流程：草稿 -> 已提交 -> 审批中 -> 已批准 -> 待验收/待复核 -> 已入库/已出库/借出 -> 归还中/校准中 -> 已关闭。

关键业务规则：

1. 库存出库不得超过可用数量，预留数量必须锁定库存。
2. 关键备件必须绑定适配设备模型或专业分类。
3. 工具和仪表借出前必须校验校准有效期和状态。
4. 危险品、客户专属物资和高价值备件必须走审批。
5. 维修/EHS/应急领用必须绑定来源工单或作业许可。
6. 退库必须做数量和质量复核，异常进入整改。
7. 盘点差异未关闭前，不允许直接调整库存余额。
8. 低于安全库存的关键备件必须生成补货建议。
9. 借用逾期必须提醒借用人和值班长，严重逾期升级库房负责人。
10. 所有库存流水必须可追溯到人、单据、来源模块、证据和审计。

状态转换限制：

- draft -> submitted：必填物资、数量、来源、用途和责任人。
- submitted -> reviewing：系统生成审批任务并校验库存/校准/权限。
- reviewing -> approved：审批通过且无库存阻断。
- approved -> pending_check：入库、退库、归还、盘点等需要复核。
- pending_check -> stocked：验收、上架、库位和证据完成。
- approved -> issued：出库或借出完成并生成库存流水。
- issued -> returning：存在剩余退库或工器具归还动作。
- issued -> calibrating：工具到期或归还后需校准维保。
- pending_check -> rectifying：质检异常、盘点差异、损坏或丢失。
- stocked/closed：证据、成本、流水、审计均完整。
- any -> voided：单据撤销或对象失效，必须保留原因。

## 6. 数据库设计摘要

| 表名 | 中文名 | 设计目的 |
|---|---|---|
| inventory_item | 物资工具主数据表 | item_id PK、item_code、item_name、item_type、category 等字段 |
| inventory_stock | 库存余额表 | stock_id PK、item_id FK、site_id、warehouse_id、location_id 等字段 |
| inventory_warehouse | 库房库位表 | warehouse_id PK、site_id、warehouse_name、warehouse_type、location_id 等字段 |
| inventory_transaction | 库存流水表 | txn_id PK、txn_code、txn_type、item_id、stock_id 等字段 |
| inventory_requisition | 领用申请表 | req_id PK、req_code、req_type、site_id、source_module 等字段 |
| inventory_requisition_line | 领用明细表 | line_id PK、req_id FK、item_id、requested_qty、approved_qty 等字段 |
| tool_borrow_order | 工器具借还单表 | borrow_id PK、borrow_code、tool_item_id、serial_no、borrower_id 等字段 |
| tool_calibration_record | 校准维保记录表 | calibration_id PK、tool_item_id、serial_no、calibration_type、certificate_file_id 等字段 |
| inventory_count_task | 盘点任务表 | count_id PK、site_id、warehouse_id、count_type、planned_at 等字段 |
| inventory_replenish_plan | 补货计划表 | plan_id PK、site_id、item_id、min_qty、max_qty 等字段 |
| inventory_evidence | 库存证据表 | evidence_id PK、object_type、object_id、evidence_type、file_id 等字段 |
| inventory_metric_daily | 库存指标快照表 | metric_id PK、site_id、metric_date、stockout_count、low_stock_count 等字段 |
| inventory_audit_log | 库存审计日志表 | audit_id PK、object_type、object_id、actor_id、actor_role 等字段 |

落库原则：主数据、库存余额、库存流水和业务单据分离；库存余额由流水汇总更新；工具按序列号追踪；证据和审计独立建表；指标快照按日汇总。

## 7. 接口契约摘要

| Method | Path | 用途 | 关键入参 | 返回 |
|---|---|---|---|---|
| GET | /api/dcim/inventory/items | 物资工具主数据查询 | siteId,itemType,category,keyword,enabled,page,pageSize | 主数据列表、库存摘要、风险标识 |
| POST | /api/dcim/inventory/items | 创建物资工具主数据 | itemName,itemType,category,modelSpec,unit,supplierId,criticalLevel | itemId,itemCode,auditId |
| GET | /api/dcim/inventory/stocks | 库存余额查询 | siteId,warehouseId,itemId,status,lowStock,expireBefore,page,pageSize | 可用、预留、锁定、批次和库位 |
| POST | /api/dcim/inventory/inbound-orders | 创建入库单 | sourceType,supplierId,lines[],evidenceIds | txnIds,inboundCode,auditId |
| POST | /api/dcim/inventory/inbound-orders/{txnId}/accept | 入库验收 | acceptedQty,qualityResult,locationId,evidenceIds | stockId,txnStatus,auditId |
| POST | /api/dcim/inventory/requisitions | 创建领用申请 | sourceModule,sourceObjectId,lines[],plannedUseAt,reason | reqId,reqCode,workflowTaskId |
| POST | /api/dcim/inventory/requisitions/{reqId}/submit | 提交领用审批 | comment,evidenceIds | nextState,taskId,auditId |
| POST | /api/dcim/inventory/workflow/tasks/{taskId}/decision | 审批决策 | decision,comment,delegateTo,evidenceIds | nextNode,nextState,auditId |
| POST | /api/dcim/inventory/requisitions/{reqId}/issue | 执行出库 | issueLines[],operatorConfirm,evidenceIds | txnIds,stockUpdates,auditId |
| POST | /api/dcim/inventory/requisitions/{reqId}/return | 剩余物资退库 | returnLines[],qualityResult,evidenceIds | txnIds,stockUpdates,auditId |
| POST | /api/dcim/inventory/tools/borrow-orders | 创建工器具借用单 | toolItemId,serialNo,borrowerId,sourceModule,plannedReturnAt | borrowId,borrowCode,auditId |
| PATCH | /api/dcim/inventory/tools/borrow-orders/{borrowId}/return | 归还工器具 | returnResult,damageDesc,evidenceIds | borrowStatus,stockStatus,auditId |
| POST | /api/dcim/inventory/tools/{itemId}/calibrations | 创建校准维保记录 | serialNo,calibrationType,dueAt,certificateFileId | calibrationId,status |
| PATCH | /api/dcim/inventory/calibrations/{calibrationId}/complete | 完成校准 | result,certificateFileId,nextDueAt,evidenceIds | calibrationStatus,auditId |
| POST | /api/dcim/inventory/count-tasks | 创建盘点任务 | siteId,warehouseId,countType,plannedAt,executorId | countId,countStatus |
| PATCH | /api/dcim/inventory/count-tasks/{countId}/close | 关闭盘点任务 | differences[],rectifyResult,evidenceIds | countStatus,auditId |
| GET | /api/dcim/inventory/replenish-plans | 补货计划查询 | siteId,itemId,status,supplierId | 补货建议、当前库存、安全库存、预计到货 |
| POST | /api/dcim/inventory/replenish-plans/{planId}/submit | 提交补货计划 | suggestQty,supplierId,expectedArriveAt,reason | planStatus,workflowTaskId |
| GET | /api/dcim/inventory/reports/operation | 库存运营报表 | siteId,dateRange,itemType,warehouseId | 周转、缺货、领用、借还、校准、成本 |
| GET | /api/dcim/inventory/audit-logs | 库存审计日志查询 | objectType,objectId,actorId,action,dateRange | 审计日志分页 |

接口规则：所有写接口必须写入 `inventory_audit_log`；出库、退库、借还、校准、盘点差异和补货必须校验状态机、权限、库存余额、来源对象和证据完整性。

## 8. 字段、权限、异常与审计

- 字段一致性：页面字段、字段字典、数据库字段、接口入参、Mock 数据和埋点属性必须统一，特别是 item、stock、txn、req、borrow、calibration、count、replenish。
- 权限模型：库管员入库出库，工具管理员借还校准，维修工程师申请领用，采购协同人处理补货，运营负责人只读报表。
- 异常处理：库存不足、校准过期、库位异常、质检不通过、借用逾期、盘点差异、供应商延期、证据缺失都必须可见、可升级、可审计。
- 审计留痕：主数据、入库、出库、退库、借用、归还、校准、盘点、补货、报废、导出都必须记录 actor、object、before_state、after_state、request_id 和时间。

## 9. 埋点、报表与经营指标

| event | 触发时机 | 属性 | 指标用途 |
|---|---|---|---|
| inventory_item_create | 创建物资工具主数据 | item_type/category/critical_level/supplier_id | 统计主数据新增 |
| inventory_stock_view | 查看库存详情 | item_id/site_id/warehouse_id/stock_status | 追踪库存访问 |
| inventory_inbound_submit | 提交入库 | source_type/supplier_id/line_count/amount | 统计入库来源 |
| inventory_inbound_accept | 入库验收 | txn_id/quality_result/accepted_qty/location_id | 统计验收质量 |
| inventory_requisition_create | 创建领用申请 | req_type/source_module/risk_level/line_count | 统计领用需求 |
| inventory_requisition_decision | 领用审批决策 | task_id/decision/approved_amount/sla_status | 分析审批效率 |
| inventory_issue_complete | 出库完成 | req_id/line_count/issued_qty/cost_center | 计算领用与成本 |
| inventory_return_complete | 退库完成 | req_id/return_qty/quality_result/evidence_count | 统计退库质量 |
| inventory_tool_borrow_start | 工器具借出 | borrow_id/tool_item_id/borrower_id/planned_return_at | 统计借用 |
| inventory_tool_return_complete | 工器具归还 | borrow_id/return_result/overdue_flag/damage_flag | 统计逾期和损坏 |
| inventory_calibration_complete | 校准完成 | calibration_id/result/next_due_at/certificate | 统计校准闭环 |
| inventory_count_complete | 盘点完成 | count_id/difference_count/rectify_status | 统计盘点差异 |
| inventory_replenish_submit | 提交补货计划 | plan_id/item_id/suggest_qty/supplier_id | 统计补货需求 |
| inventory_report_export | 导出库存报表 | report_type/date_range/format/watermark | 追踪报表导出 |
| inventory_cli_command | CLI 调用 | command/user/result/trace_id | 审计自动化调用 |
| inventory_agent_suggest | 智能体建议 | intent/source_count/accepted | 评估 AI 建议采纳 |

核心指标：低库存数、缺货数、库存周转天数、预留满足率、领用金额、退库率、借用逾期数、工具损坏数、校准逾期数、盘点差异数、补货及时率、审计完整率。

## 10. CLI/智能体与 Demo 验收

CLI 命令组：

- `zhihang inventory stock --site IDC-A --low-stock`：查询低库存；输出 物资、库房、安全库存、建议补货。
- `zhihang inventory reserve --item BAT-01 --work-order WO-1`：预留备件；输出 预留ID、库存变化、审计ID。
- `zhihang inventory issue REQ-202606-0001`：执行出库；输出 出库流水、成本中心、库存余额。
- `zhihang inventory tool borrow --serial METER-001 --user U001`：借出工器具；输出 借用单、计划归还、责任人。
- `zhihang inventory tool overdue --site IDC-A`：查询逾期工具；输出 借用人、逾期天数、升级建议。
- `zhihang inventory calibration due --days 30`：查询校准到期；输出 工具、证书、到期日。
- `zhihang inventory count diff --warehouse WH-01`：查询盘点差异；输出 盘盈、盘亏、整改状态。
- `zhihang inventory replenish suggest --site IDC-A`：生成补货建议；输出 建议数量、供应商、预计到货。
- `zhihang inventory report operation --month 2026-06`：导出库存运营报告；输出 周转、缺货、领用、成本。
- `zhihang inventory audit INV-0001 --trace`：查询审计链路；输出 主数据、库存、流水、证据。

智能体能力：

- 备件推荐助手：根据设备模型、维修历史、库存和供应商交期推荐备件和替代件。
- 补货建议助手：结合安全库存、消耗趋势、交付周期和关键等级输出补货建议。
- 工具合规助手：检查借用、归还、校准、损坏和逾期风险。
- 成本审计助手：按来源工单、成本中心、供应商和物资分类解释成本变化。

Demo 验收脚本：

1. 打开物资工具驾驶舱，看到库存、低库存、借用逾期、校准到期和成本指标。
2. 新建关键备件主数据，绑定设备模型、供应商和安全库存。
3. 创建采购入库并完成验收上架，生成库存余额和证据。
4. 从维修工单发起领用申请，审批后出库并写入成本中心。
5. 剩余物资退库并做质量复核，异常进入整改。
6. 借出工器具，模拟逾期或损坏并完成归还复核。
7. 创建校准记录并上传证书，过期工具禁止借出。
8. 导出库存运营报告和审计日志，串起主数据、库存、流水、证据和成本。

### 10.1 页面字段与动作深化

| 页面 | 字段/动作 | 数据来源 | 业务规则 | 验收方式 |
|---|---|---|---|---|
| 物资工具驾驶舱 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 物资工具驾驶舱 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 备件物资台账 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具台账 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库房库位管理 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 入库与验收 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 领用与出库 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 工器具借还 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 校准与维保 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 补货与供应商 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 物资类型 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 可用数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 预留数量 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 库房库位 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 批次序列号 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 安全库存 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 来源工单 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 成本中心 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 借用状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 校准状态 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |
| 库存报表与审计 | 证据完整 | 主数据/库存/流水/工作流/证据/成本 | 字段变化必须触发权限校验、库存校验和审计日志 | 页面可见、接口返回、Mock 有值、埋点可追踪 |

### 10.2 风险目录与阻断规则

| 风险场景 | 典型触发条件 | 必填控制措施 | 阻断规则 |
|---|---|---|---|
| 关键备件缺货 | 可用数量低于需求或安全库存 | 替代件、补货计划、应急采购 | 库存不足禁止直接出库 |
| 校准过期 | 工具或仪表 next_due_at 小于当前日期 | 校准记录、证书、禁用状态 | 过期工具禁止借出 |
| 危险品领用 | 物资类型为危险品或高风险耗材 | 审批、用途、责任人、证据 | 无审批禁止出库 |
| 盘点差异 | 实盘与系统余额不一致 | 差异原因、整改、复核 | 未关闭不得直接调账 |
| 借用逾期 | 实际归还时间超过计划归还 | 提醒、升级、责任认定 | 严重逾期限制再次借用 |
| 供应商延期 | 补货计划超过预计到货 | 供应商跟进、替代供应商、风险通知 | 关键备件延期升级运营负责人 |
| 成本异常 | 领用金额超过预算或历史均值 | 成本中心、审批、原因说明 | 超阈值进入成本复核 |
| 证据缺失 | 入库、出库、退库、校准无证据 | 照片、签字、证书或单据 | 证据缺失标记审计不完整 |

### 10.3 审批矩阵

| 条件 | 必经节点 | 可退回原因 | 升级规则 |
|---|---|---|---|
| 关键备件领用 | 维修负责人 -> 库房负责人 | 适配不清、数量不合理、库存不足 | P0 应急可先领后补审计 |
| 高价值或危险品 | 申请人 -> 库房负责人 -> 运营负责人 | 用途不清、证据不足 | 审批超期升级 |
| 工器具借用 | 借用人 -> 值班长/工具管理员 | 校准过期、责任人不清 | 逾期自动升级 |
| 报废或盘亏 | 库管员 -> 库房负责人 -> 财务/运营 | 原因不足、证据缺失 | 高价值差异必须复盘 |
| 补货计划 | 采购协同人 -> 库房负责人 -> 运营负责人 | 数量不合理、供应商不匹配 | 关键备件低库存自动提醒 |

### 10.4 验收清单

| 验收项 | 合格标准 | 证据 |
|---|---|---|
| 库存闭环 | 可从入库、上架、预留、出库、退库、盘点走通 | Demo、API、审计日志 |
| 工具借还 | 可借出、归还、逾期、损坏、禁用和校准 | 借还单和校准记录 |
| 维修联动 | 领用申请能绑定维修工单或 EHS 作业许可 | 来源对象和流水 |
| 低库存补货 | 低于安全库存生成补货建议 | 补货计划表 |
| 盘点差异 | 盘点差异进入整改和复核 | 盘点任务和证据 |
| 成本归集 | 出库流水能绑定成本中心和来源模块 | 库存流水和报表 |
| 证据链 | 入库、出库、退库、校准有附件和 hash | 证据表 |
| 权限隔离 | 库管、维修、工具、采购、运营角色动作不同 | 权限矩阵和按钮状态 |
| 埋点可用 | 关键动作生成 inventory_* 事件 | TRACKING_PLAN |
| CLI 可用 | 可查询、预留、出库、借还、校准、补货、审计 | CLI_AND_AGENT_SPEC |

## 11. 非目标范围

- 不替代财务系统、采购系统或供应商结算系统，本模块负责库存业务、成本归集和对账数据准备。
- 不替代 CMDB 资产生命周期，备件和工具只做库存与使用过程管理。
- 不自动采购或自动付款，补货计划只生成建议和审批单。
- Demo 可使用 Mock 数据，但字段、状态、接口、埋点、库存流水和审计必须映射真实智航底座。