Files
citrus-cms/resources/views/guide/CONSTRUCTION_DASHBOARDS_USER_GUIDE.md
T
2026-04-28 21:15:09 +03:00

154 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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