PRODUCTION
DEVIATION MONITOR

Real-time monitoring of production orders. Auto-detect delays, identify root causes, and get corrective action suggestions instantly.

Active Orders

On Track

Behind Schedule

Critical Delays

Loading production deviations...

🎯 WHAT IS THE DEVIATION MONITOR?

The Production Deviation Monitor is your real-time production tracking system. It continuously monitors ALL active production orders and automatically detects when orders are falling behind schedule. Instead of discovering delays when customers call to complain, you'll know about problems the moment they start and get instant suggestions on how to fix them.

✅ WHAT IT MONITORS

Progress vs Schedule: Compares how much you've produced vs how much you should have produced by now
Time-based Tracking: Monitors if you're on pace to finish on time
Deviation Percentage: Shows exactly how far behind (or ahead) you are
Root Causes: Identifies WHY orders are delayed (materials, machines, labor)
Estimated Completion: Predicts when orders will actually finish based on current pace

📊 UNDERSTANDING THE DASHBOARD

STAT CARDS AT THE TOP

Active Orders: Total number of production orders currently in progress or scheduled
On Track: Orders progressing as planned - no action needed
Behind Schedule: Orders with -10% to -20% deviation - attention needed
Critical Delays: Orders with more than -20% deviation - urgent action required

DEVIATION CARDS (COLOR CODED)

✅ GREEN BORDER - ON TRACK: Order is meeting or exceeding schedule. Deviation is better than -10%. Keep up the good work!

⚠️ YELLOW BORDER - WARNING: Order is falling behind by 10-20%. Not critical yet, but monitor closely and consider corrective actions.

🔴 RED PULSING BORDER - CRITICAL: Order is seriously delayed (more than 20% behind). Immediate action required! The border pulses to grab your attention.

📈 READING THE PROGRESS BARS

Each deviation card shows a progress bar with TWO indicators:

COLORED BAR (Actual Progress):
Shows how much you've actually produced. Green = On track, Yellow = Behind, Red = Critical

DASHED LINE (Planned Progress):
Shows where you SHOULD be based on time elapsed. If the colored bar is behind this line, you're delayed.

Example: Started 5 days ago, due in 2 days (7 days total). Days elapsed: 5 (71% of time). But only produced 40% of quantity. Deviation: 40% - 71% = -31% → CRITICAL!

🔍 ROOT CAUSE ANALYSIS

When a deviation is detected, the system automatically analyzes WHY it's happening:

📦 Material Issues:
Detected when material consumption is slower than expected. Indicates supply chain delays or shortages.

🔧 Machine Downtime:
Shows if production line has maintenance or breakdown scheduled. Displays hours of downtime impact.

👷 Labor Shortage:
Identifies when available operators are less than required. Shows exact number of workers short.

❗ Efficiency Issues:
Generic cause when production is simply slower than planned. May indicate training needs or process issues.

💡 CORRECTIVE ACTIONS

For each delayed order, the system suggests specific actions you can take to get back on schedule:

1. ADD OVERTIME PRODUCTION

What it does: Extends working hours from 8 to 10 hours per day
Time saved: Usually 1-2 days depending on delay
Cost: Overtime labor costs (typically 1.5x normal rate)
Feasibility: High (if operators are available)
When to use: Small to moderate delays where cost is acceptable

2. MOVE TO ALTERNATIVE LINE

What it does: Transfers order to a different production line
Time saved: Can save significant time if alternative line is available
Cost: Setup time (typically 2 hours) but no additional labor cost
Feasibility: Medium (requires line availability)
When to use: When current line has issues or is overloaded

3. RUSH MATERIAL DELIVERY

What it does: Express material procurement from suppliers
Time saved: Reduces material lead time by 1-2 days
Cost: Express shipping fees (typically $150-300)
Feasibility: High (if supplier supports express)
When to use: Delay is caused by material shortage

4. ADJUST SCHEDULE

What it does: Extends deadline and notifies customer of new date
Time saved: None (accepts the delay)
Cost: No monetary cost, but may impact customer satisfaction
Feasibility: Low (last resort)
When to use: When other options aren't viable and customer can accept delay

🎮 HOW TO USE - STEP BY STEP

STEP 1: OPEN THE MONITOR
Navigate to Planning → Deviation Monitor. The page auto-refreshes every 30 seconds.

STEP 2: REVIEW THE DASHBOARD
Check the stat cards at top. If you see numbers in "Behind Schedule" or "Critical Delays", scroll down to see which orders need attention.

STEP 3: ANALYZE DEVIATIONS
Look at each deviation card. Red pulsing borders = urgent. Check the progress bar to see how far behind you are.

STEP 4: UNDERSTAND ROOT CAUSES
Read the "ROOT CAUSES IDENTIFIED" section. This tells you WHY the order is delayed.

STEP 5: REVIEW CORRECTIVE OPTIONS
Look at each suggested action. Note the new completion date, cost, and time saved for each option.

STEP 6: APPLY AN ACTION
Click "APPLY THIS" on your chosen action. Confirm when prompted. The system logs this in the order notes.

STEP 7: MONITOR RESULTS
Check back in a few hours or next day. The deviation should improve if action was effective. Monitor continues tracking in real-time.

💡 BEST PRACTICES

Check the monitor at least twice daily (morning and afternoon)
Address critical delays IMMEDIATELY - don't wait
For warnings, evaluate if action is needed within 24 hours
Always read root causes before choosing corrective action
Consider cost vs benefit - sometimes accepting minor delay is better than expensive overtime
Communicate with customers proactively if delays can't be avoided
Document lessons learned - if same root causes repeat, address systemic issues
Keep production orders updated with actual quantities produced for accurate tracking

⚠️ IMPORTANT NOTES

System calculates progress as: (Quantity Produced / Quantity Ordered) × 100%
Planned progress based on: (Days Elapsed / Total Days) × 100%
Deviation = Actual Progress - Planned Progress
Auto-refresh happens every 30 seconds - no manual refresh needed (but button is available)
Only orders with status "scheduled" or "in_progress" are monitored
Orders without start/end dates are skipped
Applying action logs it but doesn't automatically update production schedule
Corrective action costs are estimates - verify with accounting before approving

❓ TROUBLESHOOTING

Showing "0 Active Orders"?
→ No production orders have status "scheduled" or "in_progress". Create some production orders first.

All orders show "On Track" but you know some are delayed?
→ Make sure production orders have: (1) scheduled_start_date set, (2) scheduled_end_date set, (3) quantity_produced updated regularly

"Failed to load deviation data"?
→ Check that backend API is uploaded to /backend/api/v1/deviation/monitor.php

Deviation percentage seems wrong?
→ Verify dates are correct and quantity_produced is being updated as production progresses

"Error applying action"?
→ Check that apply-action.php is uploaded correctly and production_notes column exists

⚠️ PROACTIVE MONITORING PREVENTS CUSTOMER COMPLAINTS!

Use this tool daily to catch delays before they become customer issues. Prevention is better than apology!

PRODUCTIONDEVIATION MONITOR

📚 DEVIATION MONITOR - USER MANUAL