Files
ai-platform/src/modules/welltrust-qap/data/qap/index.ts
T
2026-10-18 15:27:02 +08:00

276 lines
17 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.
/**
* 和信精密 · 品质异常预防 —— 前端内置的数据集底座(15 张源表 + 2 张拆分表,不落后端库)。
*
* 来源:source-data/品质异常预防工作台Demo.xlsx(16 组数据集 · 4 个场景 · 16 个用例),
* 由 scripts/xlsx-to-qap-json.py 逐页签转出,**数值不做任何改写**。
*
* 两条口径约定(照原表的写法来,不自己另立一套):
* 1. 计算方法列不落盘。原表备注里写明「XX 为计算列」的那几列(理论产能/产能达成率/综合不良率/
* 综合良率/负荷率/滞留天数/偏移率)在转 JSON 时已剔除,统一由本文件的 `calc` 现算,
* 避免"表里是值、代码里是另一套算法"两处口径打架。
* 2. 比率类字段原表存的是小数(如 0.685 = 68.5%、0.124 = 12.4%),单位列写 '%'。
* 展示层要乘 100,别直接当百分数贴。
*
* 四角色 × 四场景是一个整齐的 4×4:PE 拿每场景的第 1 个用例,IE 第 2 个,QE 第 3 个,ME 第 4 个
* (见 ROLE_DATASETS),所以质量流程看板里 PE/IE/QE/ME 四段各自的"数据依据"就是这一行四个数据集。
*/
import ds01 from './ds01_product_process_master.json';
import ds02 from './ds02_station_equipment_tooling.json';
import ds03 from './ds03_defect_code_dict.json';
import ds04 from './ds04_param_collection_points.json';
import ds05 from './ds05_risk_checklist_welding.json';
import ds06a from './ds06a_fixture_acceptance.json';
import ds06b from './ds06b_sop_excerpt.json';
import ds07 from './ds07_inspection_standard.json';
import ds08 from './ds08_recipe_matrix.json';
import ds09 from './ds09_feature_defect_matrix.json';
import ds10 from './ds10_manual_vs_machine.json';
import ds11 from './ds11_8d_knowledge_base.json';
import ds12 from './ds12_laser_doe.json';
import ds13 from './ds13_new_model_yield_prediction.json';
import ds14 from './ds14_line_balance.json';
import ds15 from './ds15_warning_pool_snapshot.json';
import ds16 from './ds16_param_drift.json';
/** 四个质量角色,与 lib/qualityFlow.ts 的 QRoleKey 同值 */
export type QapRole = 'PE' | 'IE' | 'QE' | 'ME';
/* ── DS-01 产品-工艺-特征主数据(特征码维度:材质 × 结构特征 × 工艺方法)── */
export interface ProductProcessMaster {
料号: string; 品名: string; 机型: string; 材质: string; '板厚(mm)': number;
结构特征: string; 工序数: number; 焊接作业方式: string; '年用量(件)': number;
}
/* ── DS-02 工位-设备-工装台账(单班 8h=480min)── */
export interface StationEquipmentTooling {
工位: string; 工序: string; 设备: string; '工装/夹具': string; 人机配比: string;
'标准工时(min/件)': number; '班次产能(件)': number; 瓶颈: string;
}
/* ── DS-03 缺陷代码字典(全链路统一语言)── */
export interface DefectCodeDict {
缺陷码: string; 缺陷名称: string; '历史别名(待归并)': string; 所属工序: string;
检测方式: string; 严重度: string; 特殊特性: string; 近3月占比: number; 历史8D数: number;
}
/* ── DS-04 设备参数采集点台账 ── */
export interface ParamCollectionPoint {
设备编号: string; 设备名称: string; 参数名: string; 单位: string;
标准值: string; 允许区间: string; 采集频率: string; 采集方式: string;
}
/* ── DS-05 风险点检表-焊接工序 ── */
export interface RiskChecklistItem {
序号: number; 工序: string; 风险项: string; 来源引用: string; 历史发生次数: number;
严重度: string; 控制措施: string; '检验方法/频次': string; 责任人: string;
}
/* ── DS-06a 夹具验收标准卡 ── */
export interface FixtureAcceptance {
夹具编号: string; 名称: string; 适用料号: string; 验收项: string;
判定标准: string; '更换/复检阈值': string; 点检频次: string; 责任: string;
}
/* ── DS-06b SOP 节选 ── */
export interface SopStep {
步骤: number; 作业内容: string; 关键参数: string; '工具/工装': string;
自检项: string; '常见错误(来自历史缺陷)': string;
}
/* ── DS-07 检验标准与 AI 遗漏提示 ── */
export interface InspectionStandard {
'特征/项目': string; 检验项目: string; 依据: string; 抽样: string; 量具: string;
频次: string; 'AI 提示': string; 状态: string;
}
/* ── DS-08 参数卡矩阵(Recipe)── */
export interface RecipeMatrix {
工艺: string; '材质/板厚': string; 焊接形式: string;
'激光功率(W)/电流(A)': number; '保护气(L/min)': number; '焊速(mm/s)': number;
'离焦量(mm)': number | null; 关联缺陷提醒: string;
}
/* ── DS-09 结构特征 × 缺陷类型关联矩阵 ── */
export interface FeatureDefectMatrix {
结构特征维度: string; 典型料号: string; 样本数: number;
焊瘤: number; 未焊透: number; 搭接不良: number; 焊接变形: number; 结论: string;
}
/* ── DS-10 手工与设备焊接方式对比 ── */
export interface ManualVsMachine {
对比项: string; 手工氩弧焊: number | null; 机器人弧焊: number | null;
'激光焊(设备)': number | null; 单位: string; 差异结论: string;
}
/* ── DS-11 8D 知识库(结构化)── */
export interface EightDRecord {
'8D编号': string; 客户: string; '机型/料号': string; 缺陷码: string; 根因类别: string;
根因描述: string; 对策: string; 验证结果: string; 相似度: number;
}
/* ── DS-12 激光焊 DOE 试验结果(L9 正交)── */
export interface LaserDoeRun {
试验号: number; '激光功率(W)': number; '保护气(L/min)': number; '焊速(mm/s)': number;
'离焦量(mm)': number; 焊瘤率: number; 未焊透率: number; 标记: string | null;
}
/* ── DS-13 新机型良率预测 ── */
export interface YieldPrediction {
'新机型/料号': string; 相似机型: string; 特征相似度: number;
相似机型实际良率: number | null; 预测良率区间: string; '高概率缺陷(Top3)': string; 建议动作: string;
}
/* ── DS-14 工序负荷与线平衡 ── */
export interface LineBalance {
工序: string; '工位/设备': string; '需求节拍(件/班)': number; '实际产能(件/班)': number;
'在制品(件)': number; 预警: string; 建议: string;
}
/* ── DS-15 三日预警池快照(基准日 2026-10-16)── */
export interface WarningPoolItem {
异常单号: string; 料号: string; 缺陷: string; 缺陷码: string; 严重度: string;
发生日: string; 当前状态: string; 升级级别: string; 责任人: string;
}
/* ── DS-16 关键参数漂移监控记录 ── */
export interface ParamDrift {
日期: string; 设备: string; 参数: string; 单位: string; 标准值: string;
实测均值: number; 允许偏差: string; 同步缺陷率: number; 状态: string; 处理动作: string;
}
/* ── 数据集目录(照 00-数据集总览 页签,含原表首行的口径说明)────────────── */
export interface QapDatasetMeta {
id: string;
name: string;
useCase: string;
role: QapRole;
audit: string;
/** 原表首行那句口径说明,原样保留:算列公式、样本范围都写在这里 */
caliber: string;
sheets: string[];
}
export const CATALOG: QapDatasetMeta[] = [
{ id: 'DS-01', name: '产品-工艺-特征主数据', useCase: 'UC-1.1', role: 'PE', audit: '料号、材质、板厚、结构特征、作业方式', caliber: '特征码维度:材质 × 结构特征 × 工艺方法', sheets: ['DS-01 产品工艺特征主数据'] },
{ id: 'DS-02', name: '工位-设备-工装台账', useCase: 'UC-1.2', role: 'IE', audit: '工位、设备、工装、人机配比、标准工时', caliber: '单班 8h(480min);理论产能 = ROUND(480÷标准工时);达成率 = 班次产能÷理论产能', sheets: ['DS-02 工位设备工装台账'] },
{ id: 'DS-03', name: '缺陷代码字典', useCase: 'UC-1.3', role: 'QE', audit: '缺陷码、别名、工序、严重度、特殊特性', caliber: '全链路统一语言:检验 / 异常 / 8D / 知识库共用同一缺陷码(别名列为待归并的历史叫法)', sheets: ['DS-03 缺陷代码字典'] },
{ id: 'DS-04', name: '设备参数采集点台账', useCase: 'UC-1.4', role: 'ME', audit: '设备、参数、标准值、允许区间、采集方式', caliber: '采集数据强制携带料号 + 批次号 + 时间戳,是 S3 关联分析与 S4 漂移预警的前置条件', sheets: ['DS-04 设备参数采集点台账'] },
{ id: 'DS-05', name: '风险点检表-焊接工序', useCase: 'UC-2.1', role: 'PE', audit: '风险项、来源引用、控制措施、检验频次', caliber: 'SRV2U-FANW-01 风扇墙 · 焊接工序(由历史 8D + PFMEA 自动推导并附来源引用)', sheets: ['DS-05 风险点检表-焊接'] },
{ id: 'DS-06', name: '夹具验收标准卡 + SOP 节选', useCase: 'UC-2.2', role: 'IE', audit: '夹具编号、验收项、判定标准、更换阈值 / 步骤、关键参数、自检项、常见错误', caliber: '补齐「工装夹具无验收标准」缺口;SOP 的「常见错误」栏来自该工序历史缺陷 Top', sheets: ['DS-06a 夹具验收标准卡', 'DS-06b SOP节选'] },
{ id: 'DS-07', name: '检验标准与遗漏提示', useCase: 'UC-2.3', role: 'QE', audit: '检验项目、依据、抽样、AI 提示、状态', caliber: 'SRV2U-BASE-01 机箱底座;状态列由 QE 确认后生效', sheets: ['DS-07 检验标准与遗漏提示'] },
{ id: 'DS-08', name: '参数卡矩阵(Recipe)', useCase: 'UC-2.4', role: 'ME', audit: '材质板厚、焊接形式、功率、气量、焊速', caliber: '激光焊接与机器人弧焊;数值来源于 DOE 试验与最优批次反推', sheets: ['DS-08 参数卡矩阵'] },
{ id: 'DS-09', name: '结构特征 × 缺陷关联矩阵', useCase: 'UC-3.1', role: 'PE', audit: '特征维度、各缺陷率、综合不良率', caliber: '近 3 个月 4,860 批次化焊件;综合不良率 = 四类缺陷率之和(计算列)', sheets: ['DS-09 特征缺陷关联矩阵'] },
{ id: 'DS-10', name: '手工与设备焊接方式对比', useCase: 'UC-3.2', role: 'IE', audit: '对比项、三种作业方式、差异结论', caliber: '同料号 SRV2U-FANW-01、同批次板材对比(回答「手工/设备差异未量化」)', sheets: ['DS-10 手工与设备焊接对比'] },
{ id: 'DS-11', name: '8D 知识库(结构化)', useCase: 'UC-3.3', role: 'QE', audit: '8D 编号、客户、根因、对策、相似度', caliber: '相似度 = 缺陷码 + 特征码 + 现象描述 三重相似度;>0.85 触发重复问题拦截', sheets: ['DS-11 8D知识库'] },
{ id: 'DS-12', name: '激光焊 DOE 试验', useCase: 'UC-3.4', role: 'ME', audit: '四参数、焊瘤率、未焊透率、综合良率', caliber: 'L9 正交,SECC 1.0mm 搭接,每组合 50 件;综合良率 = 1 − 焊瘤率 − 未焊透率(受控试验仅统计两类目标缺陷)', sheets: ['DS-12 激光焊DOE试验'] },
{ id: 'DS-13', name: '新机型良率预测', useCase: 'UC-4.1', role: 'PE', audit: '相似度、实际良率、预测区间、建议', caliber: '新机型 SRV-2U-720 投产前评估(相似度 = 材质+板厚+结构特征+焊接方式 加权)', sheets: ['DS-13 新机型良率预测'] },
{ id: 'DS-14', name: '工序负荷与线平衡', useCase: 'UC-4.2', role: 'IE', audit: '需求节拍、实际产能、负荷率、建议', caliber: '订单 SRV-2U-620 月需求 12,000 件,22 工作日 × 2 班;负荷率 = 需求节拍 ÷ 实际产能(计算列)', sheets: ['DS-14 工序负荷与线平衡'] },
{ id: 'DS-15', name: '三日预警池快照', useCase: 'UC-4.3', role: 'QE', audit: '严重度、滞留天数、状态、升级级别', caliber: '基准日 2026-10-16;滞留天数 = 基准日 − 发生日(计算列,>3 天自动升级至管理层)', sheets: ['DS-15 三日预警池快照'] },
{ id: 'DS-16', name: '参数漂移监控记录', useCase: 'UC-4.4', role: 'ME', audit: '标准值、实测值、偏移率、同步缺陷率', caliber: '偏移率 =(实测均值 − 标准值)÷ 标准值(计算列,标准值非数值时留空);偏移超允差 60% 或呈单调趋势即预警', sheets: ['DS-16 参数漂移监控'] },
];
/** 四角色的数据依据:每场景(UC-1~4)各取一个用例,正好 4 个数据集 */
export const ROLE_DATASETS: Record<QapRole, string[]> = {
PE: ['DS-01', 'DS-05', 'DS-09', 'DS-13'],
IE: ['DS-02', 'DS-06', 'DS-10', 'DS-14'],
QE: ['DS-03', 'DS-07', 'DS-11', 'DS-15'],
ME: ['DS-04', 'DS-08', 'DS-12', 'DS-16'],
};
/** 四个场景(编号由用例号 UC-n.x 推出,原表未给场景名) */
export const SCENARIOS = [
{ id: 'UC-1', label: '场景一 · 主数据与台账底座' },
{ id: 'UC-2', label: '场景二 · 标准与规程补齐' },
{ id: 'UC-3', label: '场景三 · 关联分析与试验验证' },
{ id: 'UC-4', label: '场景四 · 预测与预警' },
] as const;
export const allDatasets = (): QapDatasetMeta[] => CATALOG;
export const datasetsOfRole = (role: QapRole): QapDatasetMeta[] =>
CATALOG.filter(d => d.role === role);
export const datasetById = (id: string): QapDatasetMeta | undefined =>
CATALOG.find(d => d.id === id);
export const scenarioOf = (d: QapDatasetMeta): string => d.useCase.split('.')[0];
/**
* 表名 → 行数据。键取数据集编号,DS-06 的两张表用 'DS-06a'/'DS-06b',
* 供后续要按表整体渲染的场景(数据浏览器、明细下钻)统一取数。
*/
export const TABLES = {
'DS-01': ds01, 'DS-02': ds02, 'DS-03': ds03, 'DS-04': ds04, 'DS-05': ds05,
'DS-06a': ds06a, 'DS-06b': ds06b, 'DS-07': ds07, 'DS-08': ds08, 'DS-09': ds09,
'DS-10': ds10, 'DS-11': ds11, 'DS-12': ds12, 'DS-13': ds13, 'DS-14': ds14,
'DS-15': ds15, 'DS-16': ds16,
} as const;
export type QapTableKey = keyof typeof TABLES;
/** DS-06 一个数据集两张表,目录里只登记一条,取数时两张都要给 */
export const tablesOfDataset = (id: string): { key: QapTableKey; rows: readonly unknown[] }[] =>
id === 'DS-06'
? [{ key: 'DS-06a', rows: ds06a }, { key: 'DS-06b', rows: ds06b }]
: (Object.keys(TABLES).includes(id) ? [{ key: id as QapTableKey, rows: TABLES[id as QapTableKey] }] : []);
export const allTables = () => ds01 && { ds01, ds02, ds03, ds04, ds05, ds06a, ds06b, ds07, ds08, ds09, ds10, ds11, ds12, ds13, ds14, ds15, ds16 };
/* ── 计算方法列:公式照原表首行写的来 ───────────────────────────────────── */
const SINGLE_SHIFT_MIN = 480;
const WARNING_POOL_BASE_DATE = '2026-10-16';
const round = (v: number, digits: number) => {
const f = 10 ** digits;
return Math.round((v + Number.EPSILON) * f) / f;
};
/** 日期差(天):b − a,按自然日算,避免时区把 0 算成 1 */
export const daysBetween = (a: string, b: string): number =>
Math.round((Date.parse(`${b}T00:00:00Z`) - Date.parse(`${a}T00:00:00Z`)) / 86400000);
/** 数值化:'按图'、'—' 这类非数值口径返回 null(DS-04/DS-16 的标准值列就有) */
export const num = (v: string | number | null | undefined): number | null => {
if (typeof v === 'number') return Number.isFinite(v) ? v : null;
if (typeof v !== 'string') return null;
const m = v.match(/-?\d+(\.\d+)?/);
return m ? Number(m[0]) : null;
};
export const calc = {
/** DS-02 理论产能 = ROUND(480 ÷ 标准工时) */
theoryCapacity: (r: StationEquipmentTooling) => Math.round(SINGLE_SHIFT_MIN / r['标准工时(min/件)']),
/** DS-02 产能达成率 = 班次产能 ÷ 理论产能(分母取四舍五入后的值,与原表一致) */
capacityRate: (r: StationEquipmentTooling) => r['班次产能(件)'] / Math.round(SINGLE_SHIFT_MIN / r['标准工时(min/件)']),
/** DS-09 综合不良率 = 四类缺陷率之和 */
defectRate: (r: FeatureDefectMatrix) => round(r.焊瘤 + r.未焊透 + r.搭接不良 + r.焊接变形, 4),
/** DS-12 综合良率 = 1 − 焊瘤率 − 未焊透率 */
yieldRate: (r: LaserDoeRun) => round(1 - r.焊瘤率 - r.未焊透率, 4),
/** DS-14 负荷率 = 需求节拍 ÷ 实际产能 */
loadRate: (r: LineBalance) => r['需求节拍(件/班)'] / r['实际产能(件/班)'],
/** DS-15 滞留天数 = 基准日 − 发生日 */
dwellDays: (r: WarningPoolItem) => daysBetween(r.发生日, WARNING_POOL_BASE_DATE),
/** DS-16 偏移率 =(实测均值 − 标准值)÷ 标准值;标准值非数值(如「按图」)返回 null */
driftRate: (r: ParamDrift): number | null => {
const std = num(r.标准值);
if (std === null || std === 0) return null;
return (r.实测均值 - std) / std;
},
};
/* ── 常用口径常量:原表首行里写死的,视图引用这里,不在组件里再抄一遍 ── */
export const QAP_CALIBER = {
/** 单班可用分钟(DS-02) */
singleShiftMinutes: SINGLE_SHIFT_MIN,
/** 三日预警池的基准日(DS-15) */
warningPoolBaseDate: WARNING_POOL_BASE_DATE,
/** DS-09 样本总量(近 3 个月化焊件批次) */
featureDefectSamples: 4860,
/** DS-14 月需求与班次(22 工作日 × 2 班) */
monthlyDemand: 12000,
workDays: 22,
shifts: 2,
/** DS-11 相似度触发重复问题拦截的阈值 */
duplicateGuardThreshold: 0.85,
} as const;
/** 原始文件出处:改数据请改 source-data 里的 xlsx 再跑 scripts/xlsx-to-qap-json.py 重转 */
export const QAP_SOURCE = 'source-data/品质异常预防工作台Demo.xlsx';