===========================================================
        IQC 进料检验工具 v1.0  |  半导体FAB专用
        基于 GB/T 2828.1 / ISO 2859-1 AQL抽样标准
===========================================================

一、软件简介
───────────────────────────────────────────────────
本工具为半导体晶圆厂（FAB）量身打造的进料品质检验（IQC，
Incoming Quality Control）管理软件，集成AQL抽样方案自动
计算、检验记录管理、统计分析、批量导入导出等完整功能，
适用于电子元器件、化学材料、晶圆、芯片等物料的来料检验。

运行环境：Windows（Python 3.8 + Tkinter）
推荐分辨率：1280×800 及以上


二、功能模块
───────────────────────────────────────────────────
【1】检验单管理
  - 新建 / 编辑 / 删除检验单
  - 字段：检验单号、供应商、供应商代码、物料编号、物料名称、
    批号、到货数量、抽样数量、检验日期、检验员
  - 双击列表行即可快速编辑已有记录

【2】AQL抽样方案计算
  - 内置 GB/T 2828.1 抽样标准表（批量 2~500,000+ 件）
  - 支持三种AQL等级：
      AQL 0.65 → 军用/严格等级
      AQL 1.0  → 工业/正常等级
      AQL 2.5  → 消费电子/宽松等级
  - 输入批量大小，自动返回抽样数量、接收数（Ac）、拒收数（Re）
  - 自动显示接收/拒收判定标准说明

【3】检验项目清单
  - 外观检验（表面缺陷、标识、印刷）
  - 尺寸测量（长宽高、公差范围）
  - 电学性能（电气参数、漏电流）
  - 化学成分（成分比例、纯度）
  - RoHS环保（铅Pb、汞Hg、镉Cd、六价铬Cr6+等）
  - 每项支持：PASS / FAIL / N/A 三种状态

【4】检验结果判定
  - 合格（Accept）：所有AQL项目均满足要求
  - 让步接收（Concession）：存在轻微缺陷，特许放行
  - 拒收（Reject）：严重不合格，退货处理

【5】统计分析面板
  - 合格率 / 让步率 / 拒收率 实时统计
  - 供应商质量排名（按合格率排序，含绿黄红配色）
  - 不合格类型分布（各检验项目失败次数统计）

【6】批量导入（CSV）
  - 支持导入外部CSV格式检验记录
  - 自动跳过重复检验单号（去重保护）
  - CSV字段与系统字段一一对应，编码支持UTF-8/GBK

【7】导出检验报告（Excel）
  - Sheet1「检验记录」：全量检验数据，合格=绿/让步=黄/拒收=红
  - Sheet2「统计汇总」：总体合格率、拒收率等KPI
  - Sheet3「供应商质量排名」：各供应商质量评分对比

【8】导出CSV
  - 全量数据导出为标准CSV格式，便于系统对接


三、预置示例数据
───────────────────────────────────────────────────
内置3家供应商、20条真实风格检验记录：

  供应商A【晶合半导体有限公司】
    物料：6寸硅晶圆、DSP芯片、陶瓷电容、PCB光板、光刻掩模版
    AQL等级：0.65（严格）

  供应商B【中芯材料科技有限公司】
    物料：焊锡膏、助焊剂、硝酸、8寸外延晶圆、导电胶、金线、硅烷
    AQL等级：1.0（正常）

  供应商C【华创电子股份有限公司】
    物料：USB-C连接器、OLED屏、温湿度传感器、锂电池、无刷电机等
    AQL等级：2.5（宽松）


四、CSV导入模板
───────────────────────────────────────────────────
请使用以下CSV表头（第一行为表头，数据从第二行开始）：

检验单号,供应商,供应商代码,物料编号,物料名称,批号,到货数量,
抽样数量,检验日期,检验员,AQL等级,外观检验,尺寸测量,电学性能,
化学成分,RoHS环保,不合格数,检验结果

示例行：
IQC-20260301-021,某某供应商,SUP-X01,RES-0402-10K,贴片电阻,
LOT-001,50000,200,2026-03-01,检验员A,1.0,PASS,PASS,PASS,N/A,PASS,0,合格


五、AQL等级参考
───────────────────────────────────────────────────
┌──────────┬──────────────────────────────────────┐
│  AQL 0.65│ 军用/航空航天，质量要求极高           │
│  AQL 1.0 │ 工业级电子、汽车电子，正常检验水平    │
│  AQL 2.5 │ 消费电子、轻工产品，可接受更高缺陷率  │
└──────────┴──────────────────────────────────────┘

抽样数量由批量大小和AQL等级共同决定，详见 GB/T 2828.1 标准表。

六、安装依赖
───────────────────────────────────────────────────
运行主程序（iqc_tool.py）只需 Python 标准库（Tkinter 已内置）。
如需导出 Excel 报告，请安装：

    pip install openpyxl

或一次性安装所有依赖：

    pip install -r requirements.txt


七、快速开始
───────────────────────────────────────────────────
1. 解压本压缩包到任意目录
2. 安装 openpyxl（用于Excel导出，可选）：
      pip install openpyxl
3. 双击运行 iqc_tool.py
4. 程序启动后直接显示20条示例数据
5. 可点击「新建/编辑」卡片输入新检验单
6. 点击「AQL抽样方案计算」计算抽样数量


八、注意事项
───────────────────────────────────────────────────
- 本工具数据保存在内存中，关闭程序后需手动导出CSV/Excel备份
- 推荐定期导出Excel报告作为正式存档
- CSV导入时请确保文件编码为 UTF-8 或 GBK
- 建议使用 Windows 10/11 中文系统以获得最佳显示效果


===========================================================
        祝您检验工作顺利，质量管控无忧！
===========================================================
