# Construction Dashboards - User Guide

**Version:** 1.0 | **Date:** October 30, 2025

---

## 1. Welder Performance Dashboard

### Year Filter
**Location:** Top right corner  
**How to use:** Select year (2022-2025) → page refreshes automatically

### Columns Explained

| Column | Meaning | Color Guide |
|--------|---------|-------------|
| **Welder** | Welder ID | - |
| **Subcontractor** | Company name | - |
| **Location** | Work location | - |
| **Avg** | Monthly average WDI | Divides by 12 months |
| **Total WDI** | Year total | Sum of all months |
| **W** | Monthly WDI | 🟢↑ Up / 🔴↓ Down / 🟡= Same |
| **RR%** | Repair Rate % | 🔴 High (bad) / 🟢 Low (good) |

**RR% = (Repair WDI / Normal WDI) × 100**  
Lower is better (0% = perfect, no repairs needed)

### Bottom Summary
- Total welders count
- Sum and Average for each month
- RR% Average per month

### Excel Export
**Button:** Top right of table  
**Filename:** `Welder_Performance_2024.xlsx`  
**Features:** Color-coded cells (W = light green, RR% = green/red)

---

## 2. Zone Performance Dashboard

### Columns

| Column | What it shows |
|--------|---------------|
| **Zone** | Project zone name |
| **Area** | Design area code |
| **Total** | Total WDI |
| **Welded** | Completed (Shop/Field) |
| **Backlog** | Pending (Shop/Field) |
| **Process %** | Completion percentage |

### Bottom Summary
- Total Zones: Count
- Total WDI: Sum

### Excel Export
**Filename:** `Zone_Performance_2024.xlsx`

---

## 3. Crew Performance Dashboard

### Two Views

#### Pivot View (Default - Opens First)
**Best for:** Quick overview and analysis

**Layout:**
- **Rows:** Subcontractor → Team Leader
- **Columns:** Months (Jan-Dec)
- **Values:** NPS1 sum + Joint count

**How to use:**
1. Click ▶ to expand subcontractor
2. Use Field Chooser (right) to rearrange
3. Bottom row shows Grand Total

#### Simple View
**Best for:** Detailed month-by-month data  
**Switch:** Click "Simple View" button

**Layout:**
- Each month: 2 columns (NPS1 + Count)
- Total columns at end (yearly sum)
- Gray background on Total columns
- Grand Total footer

### Excel Export
- **Pivot View:** `Crew_Performance_Pivot_2024.xlsx` (headers gray)
- **Simple View:** `Crew_Performance_Simple_2024.xlsx`

---

## Quick Start

1. **Select Year** → Top right dropdown
2. **Review Data** → Check tables for performance metrics
3. **Export** → Click Export button for Excel files

---

## Color Guide

**In Tables:**
- 🟢 Green = Good / Improvement
- 🔴 Red = Issues / Decline
- 🟡 Yellow = No change
- ⬜ Gray = Totals

**In Excel:**
- Same colors preserved
- Easy to analyze offline

---

## Tips

### Welder Performance
- ✅ Lower RR% is better
- ✅ Green arrows = improving
- ✅ Check Total WDI for yearly productivity

### Zone Performance
- ✅ Filter by Area (search box)
- ✅ High Process % = near completion
- ✅ Monitor Backlog

### Crew Performance
- ✅ Pivot View for overview
- ✅ Simple View for detailed analysis
- ✅ Export for reports

---

## FAQ

**Q: Why is AVG different than expected?**  
A: Divides by 12 months (includes months with no activity)

**Q: What is RR%?**  
A: Repair Rate - lower is better (0% = no repairs)

**Q: Can I customize Pivot View?**  
A: Yes - use Field Chooser to drag/drop fields

**Q: How to share data?**  
A: Use Excel Export - colors preserved

---

**Need Help?** Contact system administrator