平台设计

定位

料号智能体是企业运营智能体里的料号专员。它负责把料号从申请单上的一串字符，变成可以解释、可以核对、可以追到损失的主数据。

它回答四类问题：这条料号是什么，一个新编码能不能提交，重复和缺项在哪里，某个指标为什么偏离。它不新建、不合并、不冻结、不批准替代，也不连接 ERP。

对象

一条料号至少有这些事实：

• 编码四段，以及字典里的类别、族、规格
• 名称、规格、单位、负责人、描述、版次
• 状态：草稿、试用、量产、冻结、失效。状态不写进编码
• 关键件的供应商和交期
• 指纹，用来判断是不是同一件东西
• 替代，以及这条替代有没有被批准
• BOM 上的子件和父项。何处使用只从 BOM 读，不从备注读

演示库有 24 条料号和一份小 BOM。供应商名称都带「演示」，不是正式供应商主数据。

编码

编码固定为 类别-族-规格-流水。类别是 RM、SP、MF、FG、PK、TL。族和规格各 4 位，必须在字典里。流水是 3 位数字，只在同一类别、同一族、同一规格下递增。

校验分四档，都还没有写进主数据：

• 形状不合法
• 族或规格不在字典
• 料号已经存在
• 同规格已有别的流水，要先核对实物
• 字典通过，可以提交给人审

指标树

树分三组。父项只数有多少片叶子偏离目标，不把小时、万元和百分比合成一个分数。

主数据健康从料号算出来：完整率、描述规范符合率、关键件替代覆盖率、未关闭的一物多码、草稿条数。

物料损失是演示口径：缺料停线、呆滞库存、错料报废、重复采购价差。页面标明「演示」。

编码流程里，待补属性是算出来的；新建周期和冻结未清理是演示数。

描述合格的标准，是描述同时包含族的中文名和规格记号。完整的标准，是名称、规格、单位、负责人、描述、版次都有内容；关键件还要有供应商和交期。要求有替代的料号，只有已批准的替代才算覆盖。

十场讲解

讲解按上岗顺序写在 content/lectures。每一场有目标、正文和练习，并引用演示库里的真实料号。第 10 场把解释、补齐和损失追溯走成三张单。

智能体

智能体是确定性的核对程序，不调用外部模型。它从问题里识别料号、指标名或场次，然后只引用本库记录。库外问题直接说明范围，不编造料号。

回答附带可以点开的料号、指标或讲解。页面上没有写操作按钮。

页面

• 总览：待处理件数，以及偏离目标的叶子
• 智能体：提问
• 料号：筛选缺项、重复、描述和替代
• 指标树：定义、算法、目标和相关料号
• 十场讲解
• 编码规则：字典和现场校验
• 平台设计：本文

演示和正式数据

损失类数字、新建周期、冻结未清理条数是为了教学放进去的，不是月报。健康类数字每次从 content/parts.json 和 content/bom.json 计算。换正式主数据时，替换这两份数据和字典，不要改页面上的公式。

正式环境还要补三件事：登录和批准岗位、申请单时间戳、库存与停线事实。没有这三件事之前，智能体保持只读。

仓库边界

本仓库是料号智能体的独立项目。原有代码仓库保持不动，这里不回写、不合并那一侧的分支。应用监听 3000 端口，健康检查在 /api/health，方便接到单独配置的域名。隧道凭证和 API 令牌不放进仓库。