⚡ 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)