# OpenFAI

**Repository Path**: magicxie/OpenFAI

## Basic Information

- **Project Name**: OpenFAI
- **Description**: OpenFAI-免费开源智能的首件检验系统，内置PaddleOCR等4大引擎和云端4大视觉模型。支持图纸智能识别、检验计划管理、SOP生成、测量数据采集、CPK统计分析、报告生成、审批工作流等功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenFAI — 首件检验（FAI）智能质量评审系统

<p align="center">
  <img src="docs/images/poster.jpg" alt="OpenFAI Banner" width="100%">
</p>

<p align="center">
  <b>开源 · 国产化 · 符合航空航天标准</b><br>
  基于 Django 5 的 FAI（First Article Inspection）全流程管理系统<br>
  支持 AI 图纸识别、检验计划、Cp/Cpk 分析、AS9102 / PPAP 报告
</p>

<p align="center">
  <img src="https://img.shields.io/badge/版本-v2026.08.02-blue" alt="version">
  <img src="https://img.shields.io/badge/Python-3.12+-green" alt="python">
  <img src="https://img.shields.io/badge/Django-5.2-green" alt="django">
  <img src="https://img.shields.io/badge/标准-AS9102%20%7C%20PPAP%20%7C%20ISO9001-orange" alt="standards">
  <img src="https://img.shields.io/badge/许可证-PolyForm%20Noncommercial-lightgrey" alt="license">
</p>

---

## 界面预览

<p align="center">
  <img src="docs/images/FAI.png" alt="系统界面预览" width="100%">
</p>

---

## 系统简介

**OpenFAI** 是一套专为制造业设计的首件检验自动化质量评审系统，覆盖从图纸识别到报告发布的完整 FAI 流程：

- **AI 图纸识别**：调用 AI 视觉大模型（豆包 / Kimi / GLM / 百度OCR / PaddleOCR）自动识别 PDF 或图片图纸中的尺寸标注、公差信息，生成气泡图标注
- **检验计划管理**：从 OCR 结果一键生成检验计划，支持手动创建与模板复用
- **测量数据采集**：支持批次数据录入与测量设备集成，自动判定合格状态
- **统计过程控制**：自动计算 Cp / Cpk，输出直方图、控制图、趋势图
- **标准化报告**：生成符合 AS9102 / PPAP 标准的 PDF 检验报告
- **多级审批工作流**：电子签名、多角色流程管理

---

## 技术栈

| 组件 | 技术 |
|------|------|
| 后端框架 | Django 5.2 + Django REST Framework 3.15 |
| 数据库 | PostgreSQL（生产）/ SQLite（开发） |
| 前端 | Bootstrap 5 + Bootstrap Icons |
| OCR 引擎 | PaddleOCR（本地）+ 豆包/Kimi/GLM/百度OCR（云端） |
| PDF 处理 | PyMuPDF |
| 文件存储 | 本地 / S3 兼容对象存储 |
| 统计计算 | NumPy + Matplotlib |
| 生产部署 | Gunicorn + Nginx |

---

## 快速开始

### 环境要求

- Python 3.12+
- PostgreSQL 14+（生产环境，开发可用 SQLite）

### 安装

```bash
git clone https://github.com/OpenQuality/OpenFAI.git
cd OpenFAI
pip install -r requirements.txt
bash build.sh
python manage.py migrate
python manage.py collectstatic --noinput
python manage.py createsuperuser
python manage.py runserver 0.0.0.0:5000
```

| 地址 | 说明 |
|------|------|
| http://localhost:5000 | 系统主页 |
| http://localhost:5000/admin/ | 管理后台 |

---

## 功能模块

| 模块 | 功能描述 |
|------|----------|
| 仪表盘 | 系统概览、关键统计、待办提醒 |
| 零件管理 | 零件信息、图纸/PDF 上传、版本管理 |
| **OCR 气泡图** | AI 图纸识别、尺寸提取、气泡标注、人工校验 |
| 检验计划 | 检验项目定义、公差设置、模板管理 |
| SOP 管理 | 标准作业程序、检验指导书、控制计划 |
| 测量批次 | 批次数据录入、合格判定、Cp/Cpk 自动计算 |
| 统计分析 | 直方图、控制图（Xbar-R）、过程能力趋势 |
| 检验报告 | PDF 报告生成、AS9102/PPAP 格式 |
| 项目管理 | FAI 项目跟踪、步骤进度、里程碑 |
| 审批流程 | 多级审批、电子签名、状态追踪 |
| 设备管理 | 测量设备台账、校准记录 |

---

## 典型工作流程

```
零件管理 → OCR识别 → 检验计划 → 测量批次 → 统计分析 → 检验报告 → 审批发布
```

### Cp/Cpk 判定标准

| Cpk 范围 | 判定 | 说明 |
|----------|------|------|
| Cpk ≥ 1.67 | 优秀 | 过程能力充足 |
| 1.33 ≤ Cpk < 1.67 | 良好 | 满足要求 |
| 1.00 ≤ Cpk < 1.33 | 合格 | 需持续改进 |
| Cpk < 1.00 | 不合格 | 需采取纠正措施 |

---

## OCR 引擎配置

在「系统设置 → OCR 引擎配置」中切换：

| 引擎 | 类型 | 适用场景 |
|------|------|----------|
| PaddleOCR | 本地 | 快速、离线 |
| 豆包（火山引擎方舟）| 云端 AI 视觉 | 复杂图纸，推荐 |
| Kimi（月之暗面）| 云端 AI 视觉 | 复杂图纸 |
| GLM（智谱 AI）| 云端 AI 视觉 | 复杂图纸 |
| 百度 OCR | 云端 REST | 通用文字识别 |

---

## 项目结构

```
OpenFAI/
├── fai_system/     # Django 配置
├── accounts/       # 用户认证与角色权限
├── core/           # 核心功能、AI 视觉
├── parts/          # 零件管理、OCR 识别
├── inspections/    # 检验计划与 SOP
├── measurements/   # 测量数据与 Cp/Cpk
├── reports/        # 报告生成
├── workflows/      # 审批工作流
├── equipment/      # 设备管理
├── templates/      # HTML 模板
├── static/         # 静态资源
├── docs/           # 技术文档
├── requirements.txt
├── build.sh
└── manage.py
```

---

## 许可证

本项目采用 **PolyForm Noncommercial License 1.0.0** 非商业许可协议。

- ✅ 个人、研究、教育、非营利组织免费使用
- ❌ 商业用途须购买商业授权

详见 [LICENSE](LICENSE) | 商业授权咨询：**021-58108606**

---

<p align="center">Made with ❤️ for the manufacturing quality community</p>