Files
ai-platform/src/modules/tfamd-oee/data/oee/calibers28.ts
T
2026-11-19 10:09:33 +08:00

116 lines
9.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 28 项口径配置与默认值 —— 逐条转录《OEE智能优化平台改造规划书-2026-10-25.md》附录 E〔方案〕。
*
* 三条落地纪律(建议书 §7.2「未签字时仍可开工」+ 第9章第3项):
* 1. 口径工作坊本次不安排,因此 **signedOff 一律 false**,全站标「待 IE 签字」,不得假装已签字。
* 2. P0 的 16 项在 UI 上标灰(待确认),P1/P2 标「默认值生效中」——灰不等于错,是"还没人签字"。
* 3. 平台按默认值先行落地;参数确认后在配置中心切换并保留旧版本,不影响已采集的历史数据。
*
* ⚠ 两个「优先级」概念不可混为一谈(规划书附录 E 明确澄清):
* - priority P0/P1/P2 = 影响「能不能算」(P0 16 项 / P1 11 项 / P2 1 项)
* - isSensitivityKey = 影响「算出来是多少」(4 项敏感性议题:Plan边界 / Occ判定 / Q定义 / FT的PM是否计入)
* 两者不是同一集合:C04/C10 标 P1,却分别影响 A 约 3.6pp、Q 约 2.08pp;C15 标 P0,却不改变 OEE 数值口径。
*/
import type { CaliberConfig, CaliberItem } from '../../types/oee';
/** 口径版本号:全站唯一来源,四处读数(页面/报表/智能体/导出)都带它。 */
export const CALIBER_VERSION = 'v0.1-demo';
/** 4 项敏感性议题 → 承载它的口径项。一个议题可由多项承载(Q 定义含 C03 与 C10)。 */
export const SENSITIVITY_ISSUES = {
planBoundary: { label: 'Plan 边界', items: ['C09'] },
occRule: { label: 'Occ 判定', items: ['C04'] },
qDefinition: { label: 'Q 定义', items: ['C03', 'C10'] },
ftPmIncluded: { label: 'FT 的 PM 是否计入', items: ['C06'] },
} as const;
const SENSITIVITY_IDS = new Set<string>(
Object.values(SENSITIVITY_ISSUES).flatMap((v) => [...v.items]),
);
/** 原始表的一行。owner 取归口第一顺位中能落进枚举的那个;完整归口原文保留在 note 里。 */
type Row = {
id: `C${string}`;
name: string;
scope: string; // 影响范围(原文)
ownerRaw: string; // 归口(原文)
owner: CaliberItem['owner'];
defaultValue: string | number | boolean;
priority: CaliberItem['priority'];
};
const ROWS: Row[] = [
{ id:'C01', name:'头级 PAUSE 如何折算 Lane 级停机(SRF)', scope:'Down 归因与 A/P 拆分', ownerRaw:'IE + EQ', owner:'IE', defaultValue:'按全头同时暂停判定为 Lane 级停机', priority:'P0' },
{ id:'C02', name:'每日休息时点与是否全线停机', scope:'Cap 口径', ownerRaw:'生产 + IE', owner:'MFG', defaultValue:'按 12:00—13:00 全线停机计入计划损失', priority:'P1' },
{ id:'C03', name:'ASLT 的 Q 采用哪个口径(终测/FPY/UTT)', scope:'OEE 绝对值', ownerRaw:'IE + 质量', owner:'IE', defaultValue:'取终测合格率', priority:'P0' },
{ id:'C04', name:'ASLT 门开换盘是否计为在机', scope:'A 因子约 3.6pp', ownerRaw:'IE + 现场', owner:'IE', defaultValue:'不计入运行时间', priority:'P1' },
{ id:'C05', name:'ASLT 是否有标准节拍/UPH', scope:'P 的计算方式', ownerRaw:'IE + EQ', owner:'IE', defaultValue:'无标准节拍时按理论工时/实际工时计算', priority:'P1' },
{ id:'C06', name:'FT 的 PM 是否计入计划损失', scope:'A 的分母', ownerRaw:'IE', owner:'IE', defaultValue:'计入计划损失并从计划可用时间扣除', priority:'P0' },
{ id:'C07', name:'一级因子标准归属表', scope:'48 事件分类', ownerRaw:'IE', owner:'IE', defaultValue:'按方案映射表执行', priority:'P0' },
{ id:'C08', name:'Down/Jam 的时长阈值与去重主键', scope:'事件分类', ownerRaw:'EQ + IE', owner:'IE', defaultValue:'统一按 300 秒分界', priority:'P0' },
{ id:'C09', name:'计划与非计划待料的判定标志', scope:'因子归属', ownerRaw:'PC + MFG', owner:'PC', defaultValue:'命中 APS plan idle 计计划待料,其余计现场反馈待料', priority:'P0' },
{ id:'C10', name:'工程批是否从 OEE 分母剔除', scope:'Q 值约 2.08pp', ownerRaw:'IE + PE', owner:'IE', defaultValue:'剔除 ENG 开头的工程批次', priority:'P1' },
{ id:'C11', name:'Reflow 能否提供 SMEMA/PLC 过站信号', scope:'PM 结束时点(S-02)', ownerRaw:'IE + 设备', owner:'IE', defaultValue:'以现场确认前三盘进入 Reflow 的时刻为准', priority:'P0' },
{ id:'C12', name:'Xray 图片目录/接口开放范围与哪类图片作为 Setup 完成证据', scope:'Setup 判定点(S-15/16/18)', ownerRaw:'QA + Xray Owner', owner:'QA', defaultValue:'取炉后首张确认图的保存时刻', priority:'P0' },
{ id:'C13', name:'Down 权威时间取 MT2 还是设备日志,差异如何裁决', scope:'Down 时长', ownerRaw:'EQ + IE', owner:'IE', defaultValue:'取最早可信时间,差异超 5 分钟转人工复核', priority:'P0' },
{ id:'C14', name:'Jam 与 Down 的分界按单次事件还是累计时长', scope:'Jam/Down 归类', ownerRaw:'IE', owner:'IE', defaultValue:'按单次连续停机的持续时长判定', priority:'P0' },
{ id:'C15', name:'瓶颈站如何定义与维护,是否随产品变化', scope:'Down/Jam 取数范围', ownerRaw:'IE', owner:'IE', defaultValue:'主数据维护瓶颈站表,按产品路线分别配置', priority:'P0' },
{ id:'C16', name:'FT/ASLT 的 PM、Down、Jam、待料等因子事件定义补充', scope:'12 个因子的可核算性', ownerRaw:'IE + MFG', owner:'IE', defaultValue:'按附录 C 的 F/A 系列事件定义补齐', priority:'P0' },
{ id:'C17', name:'Lot Start Date(ASLT)语义是首颗测试还是 lot 装载', scope:'换 lot 时长口径', ownerRaw:'PE', owner:'PE', defaultValue:'取 lot 装载时间', priority:'P0' },
{ id:'C18', name:'Setup(MFG) 的 ±5 分钟偏移是否对所有产品一致', scope:'S-15/16/18', ownerRaw:'IE', owner:'IE', defaultValue:'先按全局 ±5 分钟,后续按产品可配置', priority:'P1' },
{ id:'C19', name:'换 sub/换电容的额外时长余量由谁维护', scope:'S-08/09', ownerRaw:'IE', owner:'IE', defaultValue:'由 IE 在配置中心按产品维护', priority:'P1' },
{ id:'C20', name:'SMR 借机的跨班顺延规则如何判定', scope:'S-10/11', ownerRaw:'SMR Leader + IE', owner:'IE', defaultValue:'顺延至下一班并按实际交付时刻记录', priority:'P1' },
{ id:'C21', name:'FT 最后一颗测试时间是否必须精确', scope:'F-47 口径', ownerRaw:'PE', owner:'PE', defaultValue:'可用 prod summary 打印时间等效', priority:'P1' },
{ id:'C22', name:'rescreen 按测试颗数 > lot 数还是多份 summary 判定', scope:'F-49/A-57', ownerRaw:'PE', owner:'PE', defaultValue:'以测试颗数 > lot 数为主判据', priority:'P1' },
{ id:'C23', name:'双口径并行的具体差异点与切换权', scope:'计算层设计', ownerRaw:'IE', owner:'IE', defaultValue:'默认口径为主线,切换由 IE 审批', priority:'P1' },
{ id:'C24', name:'跨天班次定义与业务日归属规则', scope:'全部时间切分', ownerRaw:'PC + MFG', owner:'PC', defaultValue:'跨天班次归属到事件开始时刻所在业务日', priority:'P0' },
{ id:'C25', name:'三色灯是否开放接入采集', scope:'Down 实时性', ownerRaw:'IE + 设备', owner:'IE', defaultValue:'不依赖三色灯,以设备日志与按灯信号为主路径', priority:'P1' },
{ id:'C26', name:'是否与现有 OEE 报表并行一段时间', scope:'上线策略', ownerRaw:'IE', owner:'IE', defaultValue:'并行一个自然月,差异超阈值逐日复核', priority:'P2' },
{ id:'C27', name:'三层 OEE 参数(设计良率/计划性能率/目标良率/每日不可避免停机)由谁定版、多久校准', scope:'理论/计划 OEE 可信度', ownerRaw:'IE + PE', owner:'IE', defaultValue:'由 IE 定版,每季度校准一次', priority:'P0' },
{ id:'C28', name:'计划 OEE 的计划损失取 APS 计划待料还是 IE 月度目标', scope:'计划 OEE 口径', ownerRaw:'PC + IE', owner:'PC', defaultValue:'采用 IE 的月度计划停机率目标', priority:'P0' },
];
/** 28 项口径条目。signedOff 全 false —— 本次不安排口径工作坊,默认值生效但无人签字。 */
export const CALIBER_ITEMS: Record<string, CaliberItem> = Object.fromEntries(
ROWS.map((r) => [
r.id,
{
id: r.id,
name: r.name,
defaultValue: r.defaultValue,
priority: r.priority,
owner: r.owner,
isSensitivityKey: SENSITIVITY_IDS.has(r.id),
signedOff: false,
note: `影响范围:${r.scope}|归口:${r.ownerRaw}`,
} satisfies CaliberItem,
]),
);
/** 生效时间窗:原型演示期。切换任一项会生成新版本,旧版本结果保留可回放。 */
export const CALIBER_CONFIG: CaliberConfig = {
version: CALIBER_VERSION,
items: CALIBER_ITEMS,
effectiveFrom: '2026-11-01',
sensitivitySnapshot: {
planBoundary: String(CALIBER_ITEMS.C09.defaultValue),
occRule: String(CALIBER_ITEMS.C04.defaultValue),
// Q 定义同时受 C03(终测/FPY/UTT)与 C10(工程批是否剔除)影响,两者都进快照。
// 唯一推导入口是 lib/oee/caliber.ts 的 sensitivitySnapshotOf,此处字面量由校验脚本比对防漂移。
qDefinition: [String(CALIBER_ITEMS.C03.defaultValue), String(CALIBER_ITEMS.C10.defaultValue)].join('|'),
ftPmIncluded: true, // C06 默认「计入计划损失并从计划可用时间扣除」
},
};
/** 供校验脚本与配置中心用的计数(现算,不写死)。 */
export function caliberStats() {
const items = Object.values(CALIBER_ITEMS);
return {
total: items.length,
p0: items.filter((i) => i.priority === 'P0').length,
p1: items.filter((i) => i.priority === 'P1').length,
p2: items.filter((i) => i.priority === 'P2').length,
signed: items.filter((i) => i.signedOff).length,
sensitivityKeys: items.filter((i) => i.isSensitivityKey).length,
};
}