📊⚙️ MetricForge — Business KPI Analytics Dashboard (NumPy, Matplotlib)

A modular Python project for analyzing and visualizing business KPI data — designed as a foundation for scalable data workflows.

---

✨ Features

• 📥 Load data from CSV files

• 📊 Compute key metrics:

  • Profit
  • Average revenue
  • Growth rates (revenue & costs)
  • Best and worst performing months

• 📈 Static visualizations using Matplotlib

• 📌 Highlight key insights (e.g. peak profit point)

• 💾 Export processed results to CSV

• 🧠 Clean, modular project structure (data / src / outputs)

---

🧱 Project Structure

metricforge/
│
├── data/              # Raw input data
├── src/               # Core logic
│   ├── data_loader.py
│   ├── data_pandas.py
│   ├── analysis.py
│   ├── visualization.py
│
├── outputs/           # Generated files (plots, exports)
├── main.py            # Entry point
├── README.md

---

📸 Example Output

---

⚙️ Tech Stack

• Python 3.14
• NumPy
• Matplotlib
• Pandas (optional data loading)

---

▶️ How to Run

pip install -r requirements.txt
python main.py

---

📊 Example Insights Generated

• Identification of the best and worst performing months
• Profit trends over time
• Revenue and cost growth trends
• Average revenue calculation

---

🎯 Purpose

This project demonstrates:

• Data processing and transformation in Python
• Modular software design and clean code structure
• Basic data visualization techniques using Matplotlib
• Building reproducible data workflows

---

🔮 Future Improvements

• Interactive visualizations (mplcursors / Plotly)
• CLI interface (argparse / Typer)
• Streamlit dashboard
• Automated reporting pipeline

---

📜 License

CC0-1.0