#  制造业产品质量风险预防系统

**Repository Path**: rayl618admin/FMEA

## Basic Information

- **Project Name**:  制造业产品质量风险预防系统
- **Description**: 开源制造业产品质量风险预防系统（简称：FMEA）。致力于解决制造企业长期依赖Excel进行FMEA分析导致的效率低、门槛高、协同难等痛点。结合大模型与AI技术，实现智能推荐失效模式、辅助风险评估，助力企业从“事后维修”转向“事前预防”，推动质量关口前移。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-31
- **Last Updated**: 2026-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <p align="center">
    <img src="./docs/FMEA配图/公司logo.png" width="150" height="150" alt="FMEA Logo" />
  </p>
  <h1>制造业产品质量风险预防系统 <sup style="background-color: #2563eb; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.4em; vertical-align: super; margin-left: 5px;">v1.0.0</sup></h1>
  <h3>基于 FastAPI + Vue 3 + TypeScript 的全栈 FMEA 协同分析系统，覆盖 DFMEA / PFMEA 全流程</h3>
  <p>系统属性：行业专业应用 - 制造行业</p>
  <p align="center">
    <img src="https://img.shields.io/badge/Python-≥3.12-blue">
    <img src="https://img.shields.io/badge/Node.js-≥20.0-blue">
    <img src="https://img.shields.io/badge/MySQL-≥8.0-blue">
    <img src="https://img.shields.io/badge/Redis-≥6.0-blue">
    <img src="https://img.shields.io/badge/License-MIT-orange">
  </p>
</div>

## 产品简介

开源制造业产品质量风险预防系统（简称：**FMEA**）。致力于解决制造企业长期依赖 Excel 进行 FMEA 分析导致的**效率低、门槛高、协同难**等痛点。结合大模型与 AI 技术，实现智能推荐失效模式、辅助风险评估，助力企业从"事后维修"转向"事前预防"，推动质量关口前移。

- **目标客群**：
刚需：汽车及新能源供应链、医疗器械、航空航天、军工、轨道交通

高频：、半导体、工控电子、储能光伏、工程机械、油气装备

按需（下游客户要求才用）：精密机械、模具、橡塑、包装设备
其他等等
- **使用场景**：企业仍采用 Excel 表格模式开展 FMEA 分析，在数字化质量管理体系中暴露出系统性局限

## 产品介绍

制造业产品质量风险预防系统（FMEA）是制造业产品全生命周期质量管理的核心方法论，是 IATF 16949、APQP/PPAP 等质量管理体系的强制要求，也是识别潜在风险、落实预防措施、降低缺陷成本的核心工具。

传统表格化 FMEA 在工程实践中，普遍存在**结构化表达不足、因果逻辑追溯困难、知识经验难以沉淀、版本变更缺乏管控、跨职能协同效率低**等固有局限。据行业统计，复杂产品 DFMEA 手工编制平均周期达 3 至 6 周，其中约 60% 时间消耗于格式调整、跨表核对、重复抄写等事务性工作；约 30% 的 FMEA 在客户二方审核中因逻辑断链、术语不统一、追溯性不足被提出整改项。

本系统严格遵循 **AIAG & VDA FMEA Handbook** 标准方法论，以数字化手段落地七步法分析流程，构建结构化失效链路模型，结合工程知识管理与人机协同 AI 辅助，形成标准化、可追溯、可复用的 FMEA 数字化工作平台。

## 核心特性

![核心特色](./docs/FMEA配图/核心特色配图.png)

| 模块 | 能力说明 |
|------|---------|
| 🌳 **结构分析树** | 产品结构逐级分解，支持产品库关联与节点坐标自定义 |
| 🔗 **功能网 / 失效网** | 功能分解链接、失效模式-原因-后果关联网络可视化 |
| 📊 **风险分析** | S / O / D 评分，AP 优先级评定，风险表 PDF 导出 |
| 🎯 **优化管理** | 优化措施跟踪、历史记录、一键转换为现行措施 |
| 📐 **框图设计** | 系统框图、外部对象、连线编辑与布局保存 |
| 📋 **过程流程图** | 工序库、要素库、PFD 过程流程图 |
| 📑 **DVP / 特性清单 / 控制计划** | 设计验证计划、产品特性清单、控制计划（CP）发布与版本管理 |
| 🤖 **AI 助手** | 基于大模型的智能对话，辅助 FMEA 分析与措施建议 |
| 📄 **报告导出** | FMEA 报告一键导出，支持版本快照与水印 |
| ⚙️ **业务规则** | 评分规则、优化规则可配置，适配不同企业标准 |

## 业务架构

![产品架构图](./docs/FMEA配图/产品架构图.png)

## 技术栈

| 层级 | 技术选型 |
|------|---------|
| 后端框架 | FastAPI 0.115 · SQLAlchemy 2.0 · Alembic · Pydantic 2 |
| 前端框架 | Vue 3（Composition API）· Vite 7 · TypeScript · Element Plus |
| 状态管理 | Pinia · pinia-plugin-persistedstate |
| 样式方案 | Tailwind CSS 4 · SCSS |
| 数据库 | MySQL 8.0+ / PostgreSQL 13+ / SQLite |
| 缓存 | Redis 6.x / 7.x |
| 任务调度 | APScheduler |
| AI 集成 | 兼容 OpenAI 协议的大模型（Kimi / Qwen 等） |
| 部署 | Docker Compose · Nginx |

## 快速体验

扫码关注公司公众号，了解更多产品动态：

![宏灿股份公众号二维码](./docs/FMEA配图/宏灿股份公众号二维码.jpg)

## 系统部署

### 环境要求

| 工具 | 版本 |
|------|------|
| Python | ≥ 3.12 |
| Node.js | ≥ 20.0 |
| pnpm | ≥ 8.8（推荐 9.x） |
| MySQL | ≥ 8.0 或 PostgreSQL ≥ 13 |
| Redis | ≥ 6.0 |

### 1. 克隆仓库

```bash
git clone <your-gitee-repo-url>
cd fmea-clean
```

### 2. 配置环境变量

```bash
# 后端
cp backend/env/.env.dev.example backend/env/.env.dev
# 编辑 backend/env/.env.dev，填写数据库、Redis、大模型 API Key 等

# 前端
cp frontend/web/.env.example frontend/web/.env
cp frontend/web/.env.example frontend/web/.env.development
```

### 3. 启动后端

```bash
cd backend
uv sync                    # 或 pip install -r requirements.txt
uv run main.py run --env=dev
```

> 首次启动会自动建表并初始化基础数据。接口文档：`http://127.0.0.1:8002/docs`

### 4. 启动前端

```bash
cd frontend/web
pnpm install
pnpm dev
```

### 5. 访问系统

浏览器打开 `http://fmea.redotsoft.cn/web/`，若需体验请查看服务支持联系

## 服务支持

数字化需求日益增长与企业缺钱缺人缺经验的矛盾日益突出，为此宏灿股份坚持代码开源，持续改善服务性价比，同时倡议：

- 欢迎用户多体验服务，多互动，多反馈真实的需求，助力提升 FMEA 服务品质
- 公司将持续提炼行业业务需求和数字化平台经验，把行业真需求和一线经验沉淀到系统多生态中

如需获取完整商业版授权，请通过以下方式联系：

- 📧 Email：sunhaiming@redotsoft.com
- 💬 电话：18616636293

## 工程结构

```
fmea-clean/
├── backend/                    # FastAPI 后端
│   ├── app/
│   │   ├── api/v1/            # API 接口（系统/监控/平台/AI 模块）
│   │   ├── core/              # 数据库、中间件、安全、权限
│   │   ├── plugin/            # 业务插件
│   │   │   ├── module_fmea/   # ★ FMEA 核心业务模块
│   │   │   ├── module_ai/     # AI 对话模块
│   │   │   └── module_generator/ # 代码生成器
│   │   └── utils/             # 工具类
│   ├── env/                   # 环境配置（仅提交 .example）
│   └── sql/                   # 迁移脚本
├── frontend/
│   └── web/                   # Vue 3 Web 前端
│       └── src/views/module_fmea/  # FMEA 前端页面
├── docker/                    # Docker Compose 部署
├── docs/                      # 项目文档
└── deploy.sh                  # 部署脚本
```

## 闭源组件说明

本仓库遵循 **MIT 协议**开源以下内容：

- ✅ 系统框架与基础能力（RBAC、多租户、监控、代码生成器）
- ✅ FMEA 数据模型与数据库表结构
- ✅ FMEA 前后端基础 CRUD 接口与页面
- ✅ AI 对话模块的接入框架

**以下核心引擎为商业闭源，不包含在本仓库中：**

- ❌ FMEA 风险评分算法与 AP 优先级评定引擎
- ❌ AI 辅助 FMEA 分析推理内核（失效推荐、措施建议）
- ❌ 规则引擎（评分规则校验、优化规则执行）
- ❌ 报告生成内核（PDF 排版、水印、版本快照）
- ❌ 核心算法库与知识库数据


## 截图展示

| 登录页 | 我的空间 |
|--------|---------|
| ![登录页](./docs/FMEA配图/软件截图/1、登录页.png) | ![我的空间](./docs/FMEA配图/软件截图/2、我的空间.png) |

| 分析树 | 关系树 |
|--------|--------|
| ![分析树](./docs/FMEA配图/软件截图/3、详情-分析树.png) | ![关系树](./docs/FMEA配图/软件截图/4、关系树.png) |

| 风险分析 | 优化措施 |
|----------|---------|
| ![风险分析](./docs/FMEA配图/软件截图/5、风险分析.png) | ![优化措施](./docs/FMEA配图/软件截图/6、优化措施.png) |

| 报告 | 特性清单 |
|------|---------|
| ![报告](./docs/FMEA配图/软件截图/7、报告.png) | ![特性清单](./docs/FMEA配图/软件截图/8、特性清单.png) |

| DVP | AI Bot |
|-----|--------|
| ![DVP](./docs/FMEA配图/软件截图/9、DVP.png) | ![AI Bot](./docs/FMEA配图/软件截图/11、AI%20bot.png) |

## 文档

- [后端开发指南](./backend/README.md)
- [前端开发指南](./frontend/web/README.md)
- [Docker 部署](./docker/README.md)
- [系统部署手册](./frontend/docs/系统部署手册/系统部署手册.md)

## 许可证

本项目代码部分采用 [MIT License](./LICENSE) 开源协议。核心商业引擎为闭源组件，未经授权不得使用、复制或分发。

## 贡献

欢迎提交 Issue 与 PR！贡献前请阅读 [贡献指南](./CONTRIBUTING.md)。

---

> 如果本项目对你有帮助，请给一个 ⭐️ Star 支持！