116 lines
9.7 KiB
TypeScript
116 lines
9.7 KiB
TypeScript
/**
|
||
* 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,
|
||
};
|
||
} |