资源
资源代表可追踪库存或在现场作业中消耗的工作项、材料、设备或劳动力类型。
资源类型
材料与耗材 - 按体积/数量追踪的实物物品 - 示例：电缆（米），导管（英尺），安装支架（件） - 通过现场消耗而耗尽 - 通过收货单补充
设备 - 可重复使用且数量有限的物品 - 例如：梯子、叉车、测试设备 - 在不同站点间转移，不消耗 - 使用后归还
劳动力 - 按工时或任务追踪的工作投入 - 示例：电工工时、安装任务 - 用于任务资源需求 - 在报告中追踪但不计入实物库存
资源字段
基本信息 - 名称 - 描述性名称（例如"Cat6网络线缆"） - 类别 - 分组用于筛选（例如"布线系统"、"硬件设备"）
- 默认计量单位 - 标准计量单位（例如"米"、"件"、"小时"）- 描述 - 详细规格或备注
库存控制 - 消耗品 - 适用于使用后耗尽的物品（材料） - 需保护 - 适用于受限库存（需扫描二维码领取） - 最低库存量 - 库存不足时的预警阈值 - 标准成本 - 单位默认价格（用于预算编制）
转换 - 用于单位转换和复合分解的嵌入式数组
资源转换
单位换算 组合分解 ↓ ↓ 相同资源 不同资源 1 ft → 0.3048 m 1 套件 → 多个物品 资源: null 资源: [IDs...] ↓ ↓ 电缆（英尺） 门套件 → 门 ↓ ↓ 螺丝
电缆（米） ↓ 粘合剂 └────→ 卷尺 ```
 *资源详情页面展示单位转换与复合分解配置*
转换在统一结构中处理两种情况：
### 单位转换（同一资源）在同一资源的测量单位之间进行转换。
**示例：** 线缆长度转换```Resource: "Cat6 网络线缆"Conversion: { sourceVolume: 1, sourceUom: "英尺", outputs: [{ resource: null, // null = 相同资源 volume: 0.3048, uom: "米" }]}```
### 复合材料分解（多资源）将组装套件分解为组成材料。
**示例：** 安装套件明细表```Resource: "门安装套件"Conversion: { sourceVolume: 1, sourceUom: "单位", outputs: [ { resource: 卷尺ID, volume: 1, uom: "单位" }, { resource: 胶水ID, volume: 0.5, uom: "升" } }}
{ resource: 固定螺丝_id, 数量: 12, 单位: "单位" }, { resource: 粘合剂_id, 数量: 0.5, 单位: "升" } ] }
**关键点：**- `resource: null` 表示同资源单位转换- 非空 `resource` 表示复合材料分解为不同材料- 支持多输出（单一来源→多个目标）- 嵌入资源以提升性能（无需单独查找）
## 受保护资源
资源设有**开放领取**标志，用于控制二维码扫描的授权模式：
- **关闭（默认——受保护模式）：** 二维码与用户绑定。只有代码签发对象（或拥有 `canFacilitatePickups` 权限的员工）才能扫描。每次扫描均需验证身份。
- **开启（开放领取）：** 二维码为可转让凭证。Mike可收到代码后转交给John，John扫描后，交易记录中John即为实际领取人。无需身份验证——任何有效扫描均会扣减库存。
开放领取适用于低价值耗材，或在操作上无需关注具体领取人的场景。受保护领取适用于高价值或需问责的物料，即保管链记录至关重要的情况。
**启用保护时，扫描将验证：**
1. 授权码及其有效期
2. 扫描者是否为授权接收方（受保护模式），或代码是否为有效凭证（开放模式）
3. 扫描者是否拥有 `canFacilitatePickups` 权限（员工覆盖，仅限受保护模式）
4. 源站点的库存可用性
**受保护模式的适用场景：**
- 高价值设备
- 受控材料（需追溯责任）
- 受监管要求的物品
## 创建资源
**所需权限：** `resourcesCreate` 管理员权限
 *资源页面展示已定义资源列表，包含分类及默认计量单位*
**常规工作流程：**1. 导航至管理 → 资源2. 点击"添加资源"3. 填写基本信息（名称、类别、默认计量单位）4. 设置库存控制标记（消耗品、受保护）5. 如有需要添加转换（单位转换或套件拆分）6. 保存
**最佳实践：**- 采用统一的命名规范（例如使用"Cat6 线缆"而非"网络线 cat 6"）- 为耗材设定合理的最低库存量- 尽早添加转换功能（待库存商品存在后再改造会更困难）- 通过分类字段将相关资源归组
## 需求与供应可视化
资源页面可在每条目录条目旁显示两列聚合数据：
- **需求** — 所有有效任务 `resources[]` 条目中声明的该资源总量。反映计划现场作业所需的数量。
- **供应** — 该资源所有有效库存物品的总量。反映各站点当前实际可用的数量。
如需填充这两列，请点击筛选栏中的**获取需求/供应**。系统将读取表格中当前可见的所有资源，并并行查询任务集合与库存物品集合。请求处理期间，按钮上会显示加载动画。
**为何按需获取而非始终显示？**
在每次页面加载时对全量任务和库存物品集进行聚合计算，在数据量较大时开销较高。按需获取意味着您可以在需要时查看数据——容量规划、项目前期核查、采购洽谈——而不会使日常浏览变慢。
**库存物品详情：**
库存物品详情页会自动显示该库存物品所属资源的**总需求**和**总供应**，无需手动获取。由于您已在查看特定物品，查询开销较小（仅一个资源ID）。
**解读差距：**
若需求超过供应，采购部门需在现场团队开始领取材料前采取行动。若供应超过需求，则表明存在缓冲——或可转移至其他地点的过剩库存。两列数据均不考虑已预留或在途物料；请将差距视为调查信号，而非硬性限制。
## 资源使用情况
资源出现在：- **任务** - 工作所需的材料/人力（支持多资源）- **库存项目** - 现场资源的实物库存- **交易** - 资源的流动与消耗记录- **报告** - 实地作业中的实际消耗量- **分配** - 资源目标（目标而非预留）
资源不会占用库存——它们仅定义可追踪的对象。库存商品代表实际的物理库存。