⚡ QualityPulse ⚡

A Professional Quality Management System (QMS) for Aluminum Die Casting Operations

---

QualityPulse is a robust, desktop-first application specifically engineered to track, analyze, and elevate manufacturing quality in aluminum die casting. Built with NiceGUI, it delivers real-time, actionable insights through a sleek, reactive user interface.

✨ Key Features

Module	Description
📊 Comprehensive Dashboard	Real-time KPI tracking including Scrap Rate, OEE, Cpk, and CAPA metrics with 30-day trend analysis.
📈 Pareto Analysis	Interactive defect analysis with multi-line filters for prioritizing critical quality issues.
📉 SPC (Statistical Process Control)	Advanced X-bar control charts with automatic Nelson Rules detection and capability analysis (Cp/Cpk).
🔧 CAPA Management	Full lifecycle tracking for Corrective and Preventive Actions with status monitoring and alerts.
⚠️ FMEA Risk Matrix	Risk Priority Number (RPN) driven failure mode analysis with interactive heatmaps.
🖥️ Native Desktop Experience	Standalone Windows application functionality utilizing NiceGUI's native mode.

---

🛠️ Technology Stack

• Frontend UI: NiceGUI (Native Desktop Mode)
• Data Visualization: Plotly
• Data Engine: Pandas & NumPy
• Database: SQLite3 (Auto-seeding included)
• Packaging: PyInstaller

---

🚀 Getting Started

1. Prerequisites

• Python: Version 3.11 or higher.

2. Installation

Clone the repository and install the required dependencies:

# Clone the repo
git clone https://github.com/radikonreturn/QualityPulse.git
cd QualityPulse

# Install dependencies
pip install -r app/requirements.txt

3. Running the Application

The database (quality.db) is automatically initialized and seeded with 90 days of sample data on the first run.

🪟 Native Desktop Mode (Recommended)

Launch in a dedicated desktop window:

python app/main.py

---

📂 Project Architecture

QualityPulse/
├── app/
│   ├── main.py                # Desktop entry point
│   ├── pages/                 # Core application modules (Dashboard, SPC, FMEA, etc.)
│   ├── db/                    # Database schema & seeding logic
│   ├── components/            # Reusable UI elements
│   ├── utils/                 # Analytics & SPC engines
│   ├── assets/                # Static assets & icons
│   ├── requirements.txt       # Python dependencies
│   └── build.spec             # PyInstaller configuration
├── GEMINI.md                  # Development context & rules
└── README.md                  # Project documentation (this file)

---

---

📄 License

Distributed under the MIT License. See LICENSE for details.

---

Developed with ❤️ by Abdullah (radikonreturn)