Iceyma02/Proton-Bakery-Intelligence-System
Record type:
software
Creator:
Ice
Host:
ProtonIQ — A 6-module business intelligence dashboard built for Proton Bakers (Pvt) Ltd, Zimbabwe's #1 bakery since 1961. Covers production output, depot fill rates, retailer performance, SKU margins, and fleet OTD. Built with Plotly Dash & deployed on Render. Developed by MA TechHub.
# ProtonIQ — Business Intelligence System
### Built by MA TechHub for Proton Bakers (Pvt) Ltd
> *"The Best of The Best" — Since 1961*
---
## 📁 Project Structure
```
protoniq/
├── app.py ← Main Dash application (entry point)
├── requirements.txt ← Python dependencies
├── Procfile ← Gunicorn production server config
├── runtime.txt ← Python version pin (3.11.9)
│
├── data/
│ ├── __init__.py
│ └── datasets.py ← All simulated data + KPI calculations
│
├── assets/
│ ├── __init__.py
│ ├── custom.css ← Proton brand dark theme (forest green + gold)
│ └── theme.py ← Plotly chart brand colours & layout helpers
│
└── modules/
├── __init__.py
├── executive.py ← Module 1: CEO Command Centre
├── production.py ← Module 2: Production Output Tracker
├── depot.py ← Module 3: Depot Intelligence
├── retailer.py ← Module 4: Retailer Performance
├── sku.py ← Module 5: SKU Intelligence
└── fleet.py ← Module 6: Fleet Performance
```
---
## 🚀 Local Development
### Prerequisites
- Python 3.11+
- pip
### Setup
```bash
# 1. Clone or extract the project
cd protoniq
# 2. Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate # macOS / Linux
# venv\Scripts\activate # Windows
# 3. Install dependencies
pip install -r requirements.txt
# 4. Run the app
python app.py
```
Visit: **http://localhost:8050**
---
## 🌐 Deploy to Render (Free Tier)
### Step 1 — Push to GitHub
```bash
# In the protoniq/ folder:
git init
git add .
git commit -m "ProtonIQ MVP — MA TechHub"
# Create a new repo on github.com (e.g. protoniq)
git remote add origin github.com
git branch -M main
git push -u origin main
```
### Step 2 — Create Render Web Service
1. Go to **render.com** → Sign up / Log in
2. Click **"New +"** → **"Web Service"**
3. Connect your …