InvenTree 零件详情页深度解析Part 详情字段、功能页签与显隐控制逻辑【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTreeInvenTree 的 Part 详情页Part Detail View是整款库存管理系统的核心工作台它在一个页面内聚合了零件的基础属性、库存、物料清单BOM、分配、订单、定价、测试与附件等全部零件维度数据。本篇技术文章围绕 InvenTree 官方文档 Part Views 逐节展开结合当前仓库中 PartDetail.tsx、PartDetailsPanel.tsx 与后端 part/models.py 的源码实现讲清楚每个页面区块的展示内容、每个功能页签的显隐条件由零件属性与全局设置共同决定以及 IPN、修订、锁定等字段的底层校验机制帮助使用者准确定位数据、帮助开发者理解页面行为背后的判定逻辑。页面整体结构面包屑 头部详情 页签分组从源码结构看Part 详情页由 PartDetail 组件实现其渲染结构分三层类别面包屑Category Breadcrumb List每个零件所归属的类别路径显示在页面顶部导航栏上。源码中breadcrumbs以Parts为起点把part.category_path中的各级类别依次映射为可点击的目录节点最后一项是零件本身见 PartDetail.tsx L540-L548。点击面包屑旁的操作按钮还能打开NavigationTree侧栏直接浏览整个零件类别树。关于类别体系的完整概念参见 Part 类别文档。头部详情区PageDetail显示零件名称、描述、缩略图、锁定图标以及一组库存状态徽章见下文“头部状态徽章”一节右侧挂载星标、打印、条码、库存操作、零件操作等动作按钮。页签分组PanelGroup页面将零件数据组织为若干页签Tab每个页签对应一个功能面板。PartDetail.tsx L287-L527 中的partPanels数组按固定顺序声明了全部页签每个页签对象带有hidden布尔条件——这正是后文“显隐条件”表格的数据来源。Part 详情字段基础属性如何被定义与展示文档指出可以通过 “Show Part Details” 切换按钮在头部面板展开零件详情。InvenTree 中一个 Part 由以下核心参数定义字段说明后端实现IPNInternal Part Number内部零件编号用于对接外部编号体系。非必填字段但若定义了零件编号体系则非常有用IPN字段max_length100可空见 models.py L1164-L1170Name零件名称唯一文本标签name字段参与唯一性约束Description描述零件的长文本description字段Revision可选修订码标识同一主零件的特定版本存在多个修订时使用revision最长 100可空与自引用外键revision_of见 models.py L1172-L1188Keywords若干描述性关键词用于提升检索效率keywords字段External Link外部 URL链接到零件的额外文档页面等link字段InvenTreeURLField最长 2000见 models.py L1190-L1196Creation Date零件创建时间右侧标签显示创建者creation_date/creation_userUnits计量单位UoM默认为 pcsunits字段最长 20带物理单位校验器validate_physical_units见 models.py L1263-L1271前端详情面板 PartDetailsPanel.tsx 将字段组织为四个区块左上区块展示 Name、IPN、Description、Variant of、Revision of、Revision、Category、Default Location、Units、Keywords、Link 等L78-L153右上区块展示 In Stock、Available Stock、On Order、Required for Orders、Allocated to Build/Sales Orders、In Production、Can Build、Minimum/Maximum Stock 等库存派生值左下区块展示 Active、Locked、Template Part、Assembled Part、Component Part、Testable Part、Trackable Part、Purchaseable Part、Saleable Part、Virtual Part、Subscribed 等布尔标志L243-L270右下区块展示 Creation Date、Created By、Responsible、Default Expiry、Price Range 与 Latest Serial Number。这些布尔标志assembly / component / trackable / purchaseable / salable / virtual / testable正是决定各页签是否可见的输入条件定义于 models.py L1273-L1289。IPN 的校验规则源码补充文档仅说明 IPN 是可选编号源码揭示了更严格的约束值得运维配置时注意唯一性零件表上存在UniqueConstraint(fields[name, IPN, revision], nameunique_part)models.py L534即同名同修订下 IPN 不可重复validate_unique中若全局设置PART_ALLOW_DUPLICATE_IPN为 False还会对重复 IPN 直接报错models.py L1030-L1040。正则约束若配置了全局设置PART_IPN_REGEX保存前会用该正则匹配 IPN不匹配则抛出 “IPN must match regex pattern” 校验错误models.py L769-L775。插件校验validate_part_ipn会先调用注册的插件对 IPN 做自定义校验models.py L746-L764。默认存放位置的继承逻辑详情面板中的 “Default Location” 并非仅来自零件自身get_default_location()会先查零件自己的default_location若为空则沿类别树向上逐级查找category.get_ancestors(ascendingTrue, include_selfTrue)返回第一个设置了默认位置的祖先类别的位置models.py L1208-L1226。这解释了为什么面板中 “Category Default Location” 与 “Default Location” 是两个可能同时出现、且前者仅在零件自身未设置时才显示的字段。头部状态徽章part_requirements 驱动的库存速览文档的 Part Details 部分对应前端头部徽章Badges与详情面板的库存区块。PartDetail.tsx L550-L647 基于part_requirements接口汇总了构建订单与销售订单的需求和分配数据计算并渲染如下徽章颜色与显隐均有明确规则徽章数据来源显示条件 / 颜色In Stocktotal_stock非虚拟件且有库存≤minimum_stock时橙色超过maximum_stock时青色否则绿色Availableunallocated_stock非虚拟件且可用库存 ≠ 总库存时显示黄色No Stocktotal_stock 0非虚拟件且无库存时显示橙色Allocated构建 销售订单的已分配量之和大于 0 时显示蓝色Required构建 销售订单需求量之和大于 0 时显示紫色On Orderordering在途采购大于 0 时显示蓝色In Productionscheduled_to_build大于 0 时显示蓝色Deficitmax(需求 - 总库存, 0)存在缺口时显示红色Inactive / Virtual / Consumable零件布尔标志对应标志为真时显示这套徽章体系与minimum_stock/maximum_stock字段models.py L1245-L1261联动使库存水位异常在零件列表未展开任何页签前即可被察觉。修订选择器与零件锁定文档中 Revision 字段链接到 Part Revisions 专题源码中该能力由全局设置PART_ENABLE_REVISION默认 True见 system.py L411-L416控制。当当前零件有revision_count或自身是某个零件的修订revision_of时前端会请求?revision_ofpk拉取同族修订列表并在详情面板中渲染RevisionSelector下拉框选择后导航到对应修订的详情页PartDetail.tsx L209-L284。零件锁定Locking由PART_ENABLE_LOCKING默认 True控制system.py L405-L410。启用后页面标题旁的锁形图标可点击切换locked状态通过 PATCH 零件接口提交锁定状态下后端会在多处拒绝修改如 models.py L576-L592前端则在 Parameters 页签顶部显示 “Part is Locked” 警告并禁用参数编辑PartDetail.tsx L499-L514。相关行为均有测试覆盖例如 test_param.py 验证了禁用PART_ENABLE_LOCKING后锁定约束被解除。功能页签Part Tabs逐项解析Part 视图页将零件数据组织为页签每个页签有独立职责。以下按 partPanels 的声明顺序逐一说明并给出源码中的真实显隐条件。页签显隐条件速查表页签显示条件取反即隐藏源码依据Stock零件非virtual且用户有 stock 查看角色PartDetail.tsx L303-L306Variantsis_template为真L322-L326Allocations(component或salable) 且非virtualL328-L334Bill of Materialsassembly为真且用户有 BOM 查看角色L335-L343Used Incomponent为真L364-L370Part Pricing始终显示L371-L376Supplierspurchaseable且用户有采购订单查看角色L377-L389Purchase Orders同上purchaseable 角色L390-L401Sales Orderssalable且有销售订单查看角色L402-L412Return Orderssalable、有退货单角色、且RETURNORDER_ENABLED开启L413-L422Build Ordersassembly且有构建查看角色L423-L429Transfer Orders非virtual、TRANSFERORDER_ENABLED开启、有调拨角色L430-L443Stock History非virtual、有 stock 角色、STOCKTAKE_ENABLE开启、且用户个人设置DISPLAY_STOCKTAKE_TAB开启L444-L458Test Templatestestable为真L459-L474Test Resultstestable且有 stock 角色L475-L485Related Parts始终显示功能本身受全局零件设置控制L486-L491Parameters始终显示有参数时页签图标带提示点L492-L516Attachments / Notes始终显示计数为 0 时无提示点L517-L526Variants变体若零件是Template Part模板零件则显示Variants页签内容为由PartVariantTable渲染的变体列表。模板与变体机制variant_of 关系、变体继承 BOM/参数详见 Part 模板与变体文档。Stock库存Stock页签列出所选零件的全部库存项帮助用户快速判断库存数量、存放位置与每个Stock Item的状态。页签内提供以下功能Export导出该零件的盘点数据。触发导出选项对话框后下载包含本零件所有库存项数据的文件New Stock Item为所选零件新建一个库存项。对应源码中StockItemTable的allowAdd属性PartDetail.tsx L307-L314Stock Actions当表中选中库存项时启用批量库存操作。在当前 React 前端中这些操作增减、报废、移动、合并、按序列号查找、下单采购等统一收敛在页面操作栏的 “Stock Actions” 下拉中由useStockAdjustActions钩子构建PartDetail.tsx L711-L774其中 “Order” 项在零件active且purchaseable时可用”Search by serial number” 项仅在零件trackable时可用。Allocations分配Allocated页签显示该零件有多少数量已被分配到挂起的构建订单和/或销售订单。显示条件与文档一致零件是component可用于装配或salable可售出源码额外要求零件非virtual虚拟件无实物库存可分配。面板实现见 PartAllocationPanel。Bill of Materials物料清单BOM页签展示物料清单——用于构建该装配体的子件列表每行指定构建装配体所需的另一零件及其数量。仅当零件是assembly时可见。源码中该页签还挂载了BomActions控制按钮组并会在bom_validate接口返回bom_validated false时渲染 “BOM Not Validated” 黄色告警条提示该装配的 BOM 尚未通过验证PartDetail.tsx L335-L363。Build Orders构建订单Build Orders页签列出该零件相关的构建订单展示数量、状态、创建与完成日期等关键构建信息。仅assembly零件且具备构建查看角色的用户可见。Used In被用于Used In页签列出该零件被用于构建的其他零件清单仅component零件可见是 BOM 关系的反向视图UsedInTable。Part Pricing零件定价Part Pricing页签汇总来自多个来源的可用定价信息内部定价、供应商定价、采购历史、BOM 定价、销售定价等。定价面板实现见 PartPricingPanel完整规则参见 零件定价文档。Suppliers供应商Suppliers页签显示所选零件的全部Part Suppliers与Part Manufacturers仅在零件被标记为Purchaseable时可见。Purchase Orders采购订单列出针对所选零件的全部采购订单仅在零件标记为Purchaseable且用户具备采购订单查看权限时显示。Sales Orders销售订单列出该零件的销售订单展示客户、状态、创建与发货日期等关键信息仅salable零件可见。Return Orders退货单列出引用该零件的退货单。仅当零件标记为Salable且退货单功能RETURNORDER_ENABLED定义见 system.py L864启用时可见。Transfer Orders调拨单列出引用该零件的调拨单。当零件标记为Virtual或调拨功能TRANSFERORDER_ENABLED定义见 system.py L934未启用时隐藏。Stock History库存历史提供历史库存水位信息实现见 PartStockHistoryDetail完整规则参见 库存盘点文档。注意它是唯一一个同时受全局设置STOCKTAKE_ENABLE定义见 system.py L1193后端在 part/stocktake.py L49 也以此开关保护盘点记录写入与用户个人设置DISPLAY_STOCKTAKE_TAB双重控制的页签。Test Templates测试模板若零件被标记为testable用户可定义必须对该零件任一库存实例执行的测试。测试体系详见 Part 测试文档。模板表格在零件锁定PART_ENABLE_LOCKING开启且locked为真时禁用编辑。Test Results测试结果Test Results页签聚合展示上传到该零件任意库存项的测试结果数据整合为单一表格。它与Test Templates页签的区别在于前者展示已记录的结果数据后者配置测试本身。仅testable零件且具备 stock 角色的用户可见。Related Parts相关零件Related Part 表示两个零件之间的“关联”关系——当用户希望表明某零件与另一零件用途相关或强调两个零件之间的联系时使用。相关零件可被添加并显示在 Part 视图同名表格中实现见 RelatedPartTable。文档特别说明此功能可以在全局零件设置中启用或禁用。Parameters参数零件可以定义多个参数参数体系概念参见 Parameters 文档。页签图标在有参数时会显示信息提示点在零件锁定状态下显示警告并禁止编辑前文已述。Attachments附件与 Notes备注Part Attachments页签展示与所选零件关联的文件附件每个零件可上传多个附件如数据手册概念参见 Attachments 文档。零件还可以附带一条或多条富文本备注Notes参见 Notes 文档。两者由通用面板AttachmentPanel/NotesPanel渲染页签图标上会显示附件与备注的计数提示。影响页签行为的关键全局设置综合本文涉及的源码以下全局设置均定义于 common/setting/system.py可在 InvenTree 的 Global Settings 中修改直接决定 Part 详情页的行为适用前提均为“当前用户具备相应角色权限”设置项默认值影响PART_ENABLE_REVISIONTrue是否启用零件修订字段与页面上的修订选择器PART_ENABLE_LOCKINGTrue是否允许锁定零件以阻止修改BOM、参数、测试模板等PART_IPN_REGEX空IPN 必须匹配的正则表达式PART_ALLOW_DUPLICATE_IPN—是否允许重复 IPNRETURNORDER_ENABLED—退货单功能开关控制 Return Orders 页签TRANSFERORDER_ENABLED—调拨单功能开关控制 Transfer Orders 页签STOCKTAKE_ENABLE—库存盘点开关控制 Stock History 页签与盘点记录生成小结Part 详情页是 InvenTree 中数据密度最高的单实体页面以Part模型的布尔标志assembly / component / salable / purchaseable / testable / virtual / is_template为骨架、以角色权限与全局设置为闸门前端在 PartDetail.tsx 中集中声明每个页签的hidden条件从而让同一页面在不同零件上呈现完全不同的信息组合。理解上文的显隐条件表与part_requirements徽章计算逻辑后使用者可以精确解释“为什么我看不到某个页签”开发者则可以在不改动文档的前提下通过源码直接验证任何一项页面行为。【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
InvenTree 零件详情页深度解析：Part 详情字段、功能页签与显隐控制逻辑
InvenTree 零件详情页深度解析Part 详情字段、功能页签与显隐控制逻辑【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTreeInvenTree 的 Part 详情页Part Detail View是整款库存管理系统的核心工作台它在一个页面内聚合了零件的基础属性、库存、物料清单BOM、分配、订单、定价、测试与附件等全部零件维度数据。本篇技术文章围绕 InvenTree 官方文档 Part Views 逐节展开结合当前仓库中 PartDetail.tsx、PartDetailsPanel.tsx 与后端 part/models.py 的源码实现讲清楚每个页面区块的展示内容、每个功能页签的显隐条件由零件属性与全局设置共同决定以及 IPN、修订、锁定等字段的底层校验机制帮助使用者准确定位数据、帮助开发者理解页面行为背后的判定逻辑。页面整体结构面包屑 头部详情 页签分组从源码结构看Part 详情页由 PartDetail 组件实现其渲染结构分三层类别面包屑Category Breadcrumb List每个零件所归属的类别路径显示在页面顶部导航栏上。源码中breadcrumbs以Parts为起点把part.category_path中的各级类别依次映射为可点击的目录节点最后一项是零件本身见 PartDetail.tsx L540-L548。点击面包屑旁的操作按钮还能打开NavigationTree侧栏直接浏览整个零件类别树。关于类别体系的完整概念参见 Part 类别文档。头部详情区PageDetail显示零件名称、描述、缩略图、锁定图标以及一组库存状态徽章见下文“头部状态徽章”一节右侧挂载星标、打印、条码、库存操作、零件操作等动作按钮。页签分组PanelGroup页面将零件数据组织为若干页签Tab每个页签对应一个功能面板。PartDetail.tsx L287-L527 中的partPanels数组按固定顺序声明了全部页签每个页签对象带有hidden布尔条件——这正是后文“显隐条件”表格的数据来源。Part 详情字段基础属性如何被定义与展示文档指出可以通过 “Show Part Details” 切换按钮在头部面板展开零件详情。InvenTree 中一个 Part 由以下核心参数定义字段说明后端实现IPNInternal Part Number内部零件编号用于对接外部编号体系。非必填字段但若定义了零件编号体系则非常有用IPN字段max_length100可空见 models.py L1164-L1170Name零件名称唯一文本标签name字段参与唯一性约束Description描述零件的长文本description字段Revision可选修订码标识同一主零件的特定版本存在多个修订时使用revision最长 100可空与自引用外键revision_of见 models.py L1172-L1188Keywords若干描述性关键词用于提升检索效率keywords字段External Link外部 URL链接到零件的额外文档页面等link字段InvenTreeURLField最长 2000见 models.py L1190-L1196Creation Date零件创建时间右侧标签显示创建者creation_date/creation_userUnits计量单位UoM默认为 pcsunits字段最长 20带物理单位校验器validate_physical_units见 models.py L1263-L1271前端详情面板 PartDetailsPanel.tsx 将字段组织为四个区块左上区块展示 Name、IPN、Description、Variant of、Revision of、Revision、Category、Default Location、Units、Keywords、Link 等L78-L153右上区块展示 In Stock、Available Stock、On Order、Required for Orders、Allocated to Build/Sales Orders、In Production、Can Build、Minimum/Maximum Stock 等库存派生值左下区块展示 Active、Locked、Template Part、Assembled Part、Component Part、Testable Part、Trackable Part、Purchaseable Part、Saleable Part、Virtual Part、Subscribed 等布尔标志L243-L270右下区块展示 Creation Date、Created By、Responsible、Default Expiry、Price Range 与 Latest Serial Number。这些布尔标志assembly / component / trackable / purchaseable / salable / virtual / testable正是决定各页签是否可见的输入条件定义于 models.py L1273-L1289。IPN 的校验规则源码补充文档仅说明 IPN 是可选编号源码揭示了更严格的约束值得运维配置时注意唯一性零件表上存在UniqueConstraint(fields[name, IPN, revision], nameunique_part)models.py L534即同名同修订下 IPN 不可重复validate_unique中若全局设置PART_ALLOW_DUPLICATE_IPN为 False还会对重复 IPN 直接报错models.py L1030-L1040。正则约束若配置了全局设置PART_IPN_REGEX保存前会用该正则匹配 IPN不匹配则抛出 “IPN must match regex pattern” 校验错误models.py L769-L775。插件校验validate_part_ipn会先调用注册的插件对 IPN 做自定义校验models.py L746-L764。默认存放位置的继承逻辑详情面板中的 “Default Location” 并非仅来自零件自身get_default_location()会先查零件自己的default_location若为空则沿类别树向上逐级查找category.get_ancestors(ascendingTrue, include_selfTrue)返回第一个设置了默认位置的祖先类别的位置models.py L1208-L1226。这解释了为什么面板中 “Category Default Location” 与 “Default Location” 是两个可能同时出现、且前者仅在零件自身未设置时才显示的字段。头部状态徽章part_requirements 驱动的库存速览文档的 Part Details 部分对应前端头部徽章Badges与详情面板的库存区块。PartDetail.tsx L550-L647 基于part_requirements接口汇总了构建订单与销售订单的需求和分配数据计算并渲染如下徽章颜色与显隐均有明确规则徽章数据来源显示条件 / 颜色In Stocktotal_stock非虚拟件且有库存≤minimum_stock时橙色超过maximum_stock时青色否则绿色Availableunallocated_stock非虚拟件且可用库存 ≠ 总库存时显示黄色No Stocktotal_stock 0非虚拟件且无库存时显示橙色Allocated构建 销售订单的已分配量之和大于 0 时显示蓝色Required构建 销售订单需求量之和大于 0 时显示紫色On Orderordering在途采购大于 0 时显示蓝色In Productionscheduled_to_build大于 0 时显示蓝色Deficitmax(需求 - 总库存, 0)存在缺口时显示红色Inactive / Virtual / Consumable零件布尔标志对应标志为真时显示这套徽章体系与minimum_stock/maximum_stock字段models.py L1245-L1261联动使库存水位异常在零件列表未展开任何页签前即可被察觉。修订选择器与零件锁定文档中 Revision 字段链接到 Part Revisions 专题源码中该能力由全局设置PART_ENABLE_REVISION默认 True见 system.py L411-L416控制。当当前零件有revision_count或自身是某个零件的修订revision_of时前端会请求?revision_ofpk拉取同族修订列表并在详情面板中渲染RevisionSelector下拉框选择后导航到对应修订的详情页PartDetail.tsx L209-L284。零件锁定Locking由PART_ENABLE_LOCKING默认 True控制system.py L405-L410。启用后页面标题旁的锁形图标可点击切换locked状态通过 PATCH 零件接口提交锁定状态下后端会在多处拒绝修改如 models.py L576-L592前端则在 Parameters 页签顶部显示 “Part is Locked” 警告并禁用参数编辑PartDetail.tsx L499-L514。相关行为均有测试覆盖例如 test_param.py 验证了禁用PART_ENABLE_LOCKING后锁定约束被解除。功能页签Part Tabs逐项解析Part 视图页将零件数据组织为页签每个页签有独立职责。以下按 partPanels 的声明顺序逐一说明并给出源码中的真实显隐条件。页签显隐条件速查表页签显示条件取反即隐藏源码依据Stock零件非virtual且用户有 stock 查看角色PartDetail.tsx L303-L306Variantsis_template为真L322-L326Allocations(component或salable) 且非virtualL328-L334Bill of Materialsassembly为真且用户有 BOM 查看角色L335-L343Used Incomponent为真L364-L370Part Pricing始终显示L371-L376Supplierspurchaseable且用户有采购订单查看角色L377-L389Purchase Orders同上purchaseable 角色L390-L401Sales Orderssalable且有销售订单查看角色L402-L412Return Orderssalable、有退货单角色、且RETURNORDER_ENABLED开启L413-L422Build Ordersassembly且有构建查看角色L423-L429Transfer Orders非virtual、TRANSFERORDER_ENABLED开启、有调拨角色L430-L443Stock History非virtual、有 stock 角色、STOCKTAKE_ENABLE开启、且用户个人设置DISPLAY_STOCKTAKE_TAB开启L444-L458Test Templatestestable为真L459-L474Test Resultstestable且有 stock 角色L475-L485Related Parts始终显示功能本身受全局零件设置控制L486-L491Parameters始终显示有参数时页签图标带提示点L492-L516Attachments / Notes始终显示计数为 0 时无提示点L517-L526Variants变体若零件是Template Part模板零件则显示Variants页签内容为由PartVariantTable渲染的变体列表。模板与变体机制variant_of 关系、变体继承 BOM/参数详见 Part 模板与变体文档。Stock库存Stock页签列出所选零件的全部库存项帮助用户快速判断库存数量、存放位置与每个Stock Item的状态。页签内提供以下功能Export导出该零件的盘点数据。触发导出选项对话框后下载包含本零件所有库存项数据的文件New Stock Item为所选零件新建一个库存项。对应源码中StockItemTable的allowAdd属性PartDetail.tsx L307-L314Stock Actions当表中选中库存项时启用批量库存操作。在当前 React 前端中这些操作增减、报废、移动、合并、按序列号查找、下单采购等统一收敛在页面操作栏的 “Stock Actions” 下拉中由useStockAdjustActions钩子构建PartDetail.tsx L711-L774其中 “Order” 项在零件active且purchaseable时可用”Search by serial number” 项仅在零件trackable时可用。Allocations分配Allocated页签显示该零件有多少数量已被分配到挂起的构建订单和/或销售订单。显示条件与文档一致零件是component可用于装配或salable可售出源码额外要求零件非virtual虚拟件无实物库存可分配。面板实现见 PartAllocationPanel。Bill of Materials物料清单BOM页签展示物料清单——用于构建该装配体的子件列表每行指定构建装配体所需的另一零件及其数量。仅当零件是assembly时可见。源码中该页签还挂载了BomActions控制按钮组并会在bom_validate接口返回bom_validated false时渲染 “BOM Not Validated” 黄色告警条提示该装配的 BOM 尚未通过验证PartDetail.tsx L335-L363。Build Orders构建订单Build Orders页签列出该零件相关的构建订单展示数量、状态、创建与完成日期等关键构建信息。仅assembly零件且具备构建查看角色的用户可见。Used In被用于Used In页签列出该零件被用于构建的其他零件清单仅component零件可见是 BOM 关系的反向视图UsedInTable。Part Pricing零件定价Part Pricing页签汇总来自多个来源的可用定价信息内部定价、供应商定价、采购历史、BOM 定价、销售定价等。定价面板实现见 PartPricingPanel完整规则参见 零件定价文档。Suppliers供应商Suppliers页签显示所选零件的全部Part Suppliers与Part Manufacturers仅在零件被标记为Purchaseable时可见。Purchase Orders采购订单列出针对所选零件的全部采购订单仅在零件标记为Purchaseable且用户具备采购订单查看权限时显示。Sales Orders销售订单列出该零件的销售订单展示客户、状态、创建与发货日期等关键信息仅salable零件可见。Return Orders退货单列出引用该零件的退货单。仅当零件标记为Salable且退货单功能RETURNORDER_ENABLED定义见 system.py L864启用时可见。Transfer Orders调拨单列出引用该零件的调拨单。当零件标记为Virtual或调拨功能TRANSFERORDER_ENABLED定义见 system.py L934未启用时隐藏。Stock History库存历史提供历史库存水位信息实现见 PartStockHistoryDetail完整规则参见 库存盘点文档。注意它是唯一一个同时受全局设置STOCKTAKE_ENABLE定义见 system.py L1193后端在 part/stocktake.py L49 也以此开关保护盘点记录写入与用户个人设置DISPLAY_STOCKTAKE_TAB双重控制的页签。Test Templates测试模板若零件被标记为testable用户可定义必须对该零件任一库存实例执行的测试。测试体系详见 Part 测试文档。模板表格在零件锁定PART_ENABLE_LOCKING开启且locked为真时禁用编辑。Test Results测试结果Test Results页签聚合展示上传到该零件任意库存项的测试结果数据整合为单一表格。它与Test Templates页签的区别在于前者展示已记录的结果数据后者配置测试本身。仅testable零件且具备 stock 角色的用户可见。Related Parts相关零件Related Part 表示两个零件之间的“关联”关系——当用户希望表明某零件与另一零件用途相关或强调两个零件之间的联系时使用。相关零件可被添加并显示在 Part 视图同名表格中实现见 RelatedPartTable。文档特别说明此功能可以在全局零件设置中启用或禁用。Parameters参数零件可以定义多个参数参数体系概念参见 Parameters 文档。页签图标在有参数时会显示信息提示点在零件锁定状态下显示警告并禁止编辑前文已述。Attachments附件与 Notes备注Part Attachments页签展示与所选零件关联的文件附件每个零件可上传多个附件如数据手册概念参见 Attachments 文档。零件还可以附带一条或多条富文本备注Notes参见 Notes 文档。两者由通用面板AttachmentPanel/NotesPanel渲染页签图标上会显示附件与备注的计数提示。影响页签行为的关键全局设置综合本文涉及的源码以下全局设置均定义于 common/setting/system.py可在 InvenTree 的 Global Settings 中修改直接决定 Part 详情页的行为适用前提均为“当前用户具备相应角色权限”设置项默认值影响PART_ENABLE_REVISIONTrue是否启用零件修订字段与页面上的修订选择器PART_ENABLE_LOCKINGTrue是否允许锁定零件以阻止修改BOM、参数、测试模板等PART_IPN_REGEX空IPN 必须匹配的正则表达式PART_ALLOW_DUPLICATE_IPN—是否允许重复 IPNRETURNORDER_ENABLED—退货单功能开关控制 Return Orders 页签TRANSFERORDER_ENABLED—调拨单功能开关控制 Transfer Orders 页签STOCKTAKE_ENABLE—库存盘点开关控制 Stock History 页签与盘点记录生成小结Part 详情页是 InvenTree 中数据密度最高的单实体页面以Part模型的布尔标志assembly / component / salable / purchaseable / testable / virtual / is_template为骨架、以角色权限与全局设置为闸门前端在 PartDetail.tsx 中集中声明每个页签的hidden条件从而让同一页面在不同零件上呈现完全不同的信息组合。理解上文的显隐条件表与part_requirements徽章计算逻辑后使用者可以精确解释“为什么我看不到某个页签”开发者则可以在不改动文档的前提下通过源码直接验证任何一项页面行为。【免费下载链接】InvenTreeOpen Source Inventory Management System项目地址: https://gitcode.com/GitHub_Trending/in/InvenTree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
