设备位号

设备位号是设备在整个平台内的唯一身份标识：一台设备从纳入采购计划的那一刻起就登记一个位号，随后关联单位工程、供应商、采购订单，经历到货、安装、调试直至移交生产，全过程都用同一个位号追溯。它贯穿采购管理、项目搭建两个模块，是管理看板「导出移交包」设备台账数据块的直接来源。

功能概述

• 位号（如 P-1201A）项目内唯一，创建后不可修改——它是设备贯穿全过程的唯一身份，允许改号会打乱采购、安装、移交各环节的追溯链条。
• 基本信息：名称、规格、型号，均可后续编辑。
• 三项可选关联，均在同项目内校验：单位工程（经标段穿透到项目）、采购订单（自带项目归属）；供应商为租户级主数据（不区分项目），只校验是否在册。
• 状态机六态：1 计划 → 2 采购中 → 3 到货 → 4 安装 → 5 调试 → 6 移交，允许跳步——现场先有实物、后补台账是常态，新建时可直接指定较后的初始状态，状态推进也不强制经过中间态。
• 状态推进带并发保护：提交时须带上当前所见状态作为前置条件，若与库内实际状态不一致（已被他人改动），推进会被拒绝并提示刷新重试，不会覆盖他人的操作结果。
• 移交完成（状态=6）的设备计入「导出移交包」的设备台账数据块，供运营期平台（智安）导入，衔接建设期到运营期的数据交接。

权限复用项目主数据，未新增权限点

设备位号台账定位为项目结构下的主数据，与项目管理、组织与 WBS、里程碑等同级：查看复用 project.view，新建 / 编辑 / 状态推进 / 删除统一复用 project.manage，没有单独的设备权限点。

打开位置

1. 登录 Web 端，选择项目。
2. 左侧导航「项目搭建」分组进入「设备位号」。
3. 查看需要 project.view；新建、编辑、状态推进、删除需要 project.manage。

界面构成

• 顶部三张统计卡：设备位号总数、已到货（状态 ≥ 到货，现场已可见实物）、已移交，移交卡副行显示移交进度百分比或「设备已全部移交」。
• 设备台账：按状态（全部 / 计划 / 采购中 / 到货 / 安装 / 调试 / 移交）与单位工程筛选，逐行显示位号、设备名称、规格、型号、单位工程、供应商、状态；点击整行进入详情。
• 详情抽屉：
  • 设备信息：位号、规格、型号、单位工程、所属标段、状态。
  • 采购与供应：供应商、供应商联系人及电话、关联采购订单（订单号 + 物资名）、计划到货日期、实际到货日期。
  • 生命周期：六态推进条，已达到的状态点亮，当前状态高亮显示。
  • 底部操作：编辑、推进状态、删除，均需 project.manage。
• 新建 / 编辑弹窗：位号（编辑时禁止修改）、设备名称、规格、型号、单位工程下拉（可留空）、供应商下拉（可留空）、采购订单下拉（可留空），仅新建时另有「初始状态」下拉（默认「计划」）。
• 推进状态弹窗：展示当前状态，下拉选择目标状态（当前状态项禁用），提示现场安装可跳步推进、并发变更由后端保护。

典型流程（操作步骤）

1. 项目搭建阶段登记计划设备：新建位号，填写设备名称 / 规格 / 型号，单位工程 / 供应商 / 采购订单均可先留空，初始状态默认「计划」。
2. 招采完成、生成采购订单后，编辑该设备补上「采购订单」关联；关联后详情的「采购与供应」区自动带出订单号、物资名、计划到货与实际到货日期，无需重复登记。
3. 设备到货：在详情里点「推进状态」，选择目标状态「到货」并确认。现场先有实物、台账滞后补录是常态，可以直接从「计划」跳到「到货」甚至更靠后的状态，不要求逐级推进。
4. 依次推进「安装」「调试」直至「移交」。每一步都需要 project.manage；若推进时提示「当前状态已被他人变更，请刷新后重试」，说明详情已过期，刷新后按最新状态重新推进即可。
5. 全部设备到达「移交」状态后，项目经理可在管理看板顶部「导出移交包」生成的 JSON 包里看到完整设备台账（位号、名称、规格型号、状态、供应商、采购订单号、实际到货日期），供运营期平台导入。

字段与状态说明

设备状态（生命周期）

状态	含义
计划	已纳入设备清单，尚未启动采购
采购中	采购流程进行中
到货	设备已到场，现场可见实物
安装	正在安装
调试	安装完成，正在调试
移交	调试完成并移交，计入统计卡「已移交」与移交包

状态可以跳步，但不能推进到当前状态

新建时可直接指定较后的初始状态（如现场已有实物，直接建为「到货」）；状态推进接口只校验目标状态合法（1–6），不要求经过中间态。目标状态与当前状态相同会被拒绝，避免误操作产生一次空跳转。

关联字段与校验规则

关联	说明	校验规则
单位工程	设备安装所在的单位工程	须存在且与设备属于同一项目（经标段穿透校验），否则拒绝并提示「单位工程与设备不属于同一项目」
采购订单	该设备对应的采购订单	须存在且与设备属于同一项目，否则拒绝并提示「采购订单与设备不属于同一项目」
供应商	设备供应商	供应商为租户级主数据（不带项目归属），只校验是否在册

注意事项与常见问题

• 看不到「设备位号」菜单是缺 project.view 权限；能看但没有「新建设备」及详情内的编辑 / 推进状态 / 删除按钮，是缺 project.manage。
• 位号建成后不可修改（编辑弹窗中位号栏禁用）。它是设备贯穿采购、安装、移交全过程的唯一身份，误建的位号应删除后重新创建，不要期望通过编辑改号。
• 位号在项目内按「项目 + 位号」判重，撞号会提示「位号 XX 在本项目已存在」；删除设备是软删除，同一位号删除后短期内仍可能因判重记录未清理而无法立即复用，如遇到复用失败请联系管理员核实旧记录。
• 三项关联都可以留空，也可以先建设备、后续再逐步补齐——不要求一次性填全，符合「计划阶段先立台账、采购到货阶段再补关联」的现场节奏。
• 状态推进要求提交方带上当前所见状态作为前置条件；两人同时操作同一设备时，后提交的一方会被要求刷新后重试，不会互相覆盖。
• 只有到达「移交」状态的设备才计入统计卡「已移交」和管理看板的移交进度，安装、调试中的设备不计入。