================================================================================
  PCMonitor Agent - Data Not Showing in Dashboard
  DIAGNOSTIC & TROUBLESHOOTING TOOLKIT
================================================================================

🎯 WHAT TO DO NOW:
================================================================================

STEP 1: Open Command Prompt (cmd.exe) as Administrator
   - Right-click on Command Prompt
   - Select "Run as Administrator"
   - Click "Yes" on UAC popup

STEP 2: Navigate to Agent Directory
   cd E:\xampp\htdocs\tracker\agent-csharp

STEP 3: Run Diagnostic Script
   DIAGNOSTIC-CMD.bat

   This will check:
   ✓ Service status
   ✓ Configuration file
   ✓ Log files
   ✓ Network connectivity
   ✓ Executable location

STEP 4: Read the Output
   The script will tell you exactly what's wrong:
   - [OK] means working
   - [ERROR] means needs fixing
   - [WARNING] means check manually

STEP 5: Open Debug Dashboard
   Browser: http://localhost/tracker/debug.php
   This shows database status and recent data

================================================================================
📖 DOCUMENTATION AVAILABLE:
================================================================================

1. QUICK_REFERENCE.md (⭐ BEST FOR FAST LOOKUP)
   - Common commands
   - Troubleshooting flowchart
   - Quick problem/solution table

2. DATA_NOT_SHOWING_DIAGNOSIS.md (📋 COMPLETE GUIDE)
   - Step-by-step diagnosis
   - Both cmd and PowerShell commands
   - Network testing
   - Database verification

3. TOOLKIT_SUMMARY.md (🎯 OVERVIEW)
   - All tools explained
   - When to use each tool
   - File locations
   - Checklist

4. TROUBLESHOOTING.md (🔍 DETAILED SOLUTIONS)
   - In-depth problem analysis
   - PowerShell examples
   - SQL queries
   - Network diagnostics

================================================================================
🛠️ AVAILABLE SCRIPTS:
================================================================================

DIAGNOSTIC-CMD.bat
   What: Quick diagnostic check (no PowerShell needed)
   Use: DIAGNOSTIC-CMD.bat
   Time: 1-2 minutes

BUILD_CLEAN.bat
   What: Rebuild the agent executable
   Use: BUILD_CLEAN.bat
   Time: 3-5 minutes
   When: After code changes or build issues

INSTALL_SIMPLE.bat
   What: Install/reinstall as Windows Service
   Use: INSTALL_SIMPLE.bat (as Administrator)
   Time: 1 minute
   When: First time setup or reinstall needed

QUICK_REFERENCE.md
   What: Cheat sheet with commands
   Use: Open in text editor or markdown viewer
   When: Need quick command reference

================================================================================
🔧 MOST COMMON ISSUES & QUICK FIXES:
================================================================================

Issue 1: "Service not found"
Fix: Run INSTALL_SIMPLE.bat

Issue 2: "Cannot reach API"
Fix: Check config.json at C:\ProgramData\PCMonitor\config.json
     Must be: http://tracker.lppmunud.id/tracker/api (exact)

Issue 3: "Service not running"
Command Prompt:
   sc query PCMonitorAgent         (check status)
   net start PCMonitorAgent        (start it)

Issue 4: "No log files"
Fix: Check C:\ProgramData\PCMonitor\Logs\
     If empty: Service may have crashed, check config

Issue 5: "Cannot ping tracker.lppmunud.id"
Fix: Check network connection, firewall, or DNS

================================================================================
✅ SUCCESS INDICATORS:
================================================================================

After running DIAGNOSTIC-CMD.bat, you should see:

✓ [OK] Service PCMonitorAgent found
✓ [OK] PCMonitorAgent.exe is running
✓ [OK] config.json found
✓ [OK] Log directory found
✓ [OK] Can reach tracker.lppmunud.id
✓ [OK] PCMonitorAgent.exe found

If all are [OK], then:
1. Go to http://localhost/tracker/debug.php
2. Check if "Agents Registered" > 0
3. Check if "Activities Logged" > 0
4. If both > 0, data is flowing to database ✓
5. Refresh http://localhost/tracker/dashboard

================================================================================
📞 NEXT STEPS:
================================================================================

1. ➡ Right now: Run DIAGNOSTIC-CMD.bat
2. ➡ Then: Check http://localhost/tracker/debug.php
3. ➡ If Issue: Find in QUICK_REFERENCE.md or DATA_NOT_SHOWING_DIAGNOSIS.md
4. ➡ If Still Stuck: Collect all output and contact support

================================================================================
📁 ALL FILES IN THIS FOLDER:
================================================================================

BUILD_CLEAN.bat              - Rebuild executable
DIAGNOSTIC-CMD.bat           - Quick diagnostic (no PowerShell)
DIAGNOSTIC.bat              - Full diagnostic (needs PowerShell)
INSTALL_SIMPLE.bat          - Install as service
QUICK_REFERENCE.md          - Quick command cheat sheet ⭐
DATA_NOT_SHOWING_DIAGNOSIS.md - Complete diagnosis guide 📋
TOOLKIT_SUMMARY.md          - This toolkit overview 🎯
TROUBLESHOOTING.md          - Detailed troubleshooting 🔍
BUILD_SUCCESS.md            - Build documentation
DOTNET_INSTALL.md           - .NET installation guide
... and source code files

================================================================================
🎓 LEARNING PATH:
================================================================================

1st Reading: TOOLKIT_SUMMARY.md (this overview)
2nd: Run DIAGNOSTIC-CMD.bat
3rd: Check http://localhost/tracker/debug.php
4th: If issue → QUICK_REFERENCE.md (find your problem)
5th: If still stuck → DATA_NOT_SHOWING_DIAGNOSIS.md (detailed guide)

================================================================================
⏱️ ESTIMATED TIME:
================================================================================

Quick diagnostic: 2-3 minutes
Find issue: 5-10 minutes
Fix simple issue: 2-5 minutes
Fix complex issue: 15-30 minutes

Total (first time): 20-30 minutes

================================================================================
🚀 READY? START HERE:
================================================================================

1. Open Command Prompt as Administrator
2. cd E:\xampp\htdocs\tracker\agent-csharp
3. DIAGNOSTIC-CMD.bat
4. Read the output - it will guide you!

Questions? Check QUICK_REFERENCE.md or DATA_NOT_SHOWING_DIAGNOSIS.md

================================================================================
Need Help? Collect This Information:
================================================================================

- Output from DIAGNOSTIC-CMD.bat (copy/paste)
- Content of C:\ProgramData\PCMonitor\config.json
- Content of C:\ProgramData\PCMonitor\Logs\Agent_*.log (last 50 lines)
- Screenshot of http://localhost/tracker/debug.php
- Error message (if any)

Then email or submit with description of the issue.

================================================================================
Version: 1.0 | Last Updated: 2026-03-27 | Status: Ready to Use ✅
================================================================================