# 🚀 DEN MOBILE - XAMPP QUICK START

**Digital Engagement Network Mobile**  
*Smart Auto Dialer & Sales Execution Platform*  
**Connect. Engage. Convert.**

---

## ✅ WHAT'S BEEN DONE

### Rebranding Complete
- ✅ All documentation updated to **DEN MOBILE**
- ✅ New tagline: "Smart Auto Dialer & Sales Execution Platform"
- ✅ Motto: "Connect. Engage. Convert."
- ✅ All 12 documentation files branded

### XAMPP Ready
- ✅ **XAMPP_TEST_SETUP.md** - 9-step testing guide
- ✅ **TEST_DATA_AND_COMMANDS.md** - All API curl commands
- ✅ **PROJECT_MANIFEST.md** - Complete file listing

### System Status
- ✅ 60 files total (35 backend, 15 Android, 10 docs)
- ✅ All code ready for deployment
- ✅ All endpoints documented
- ✅ All database migrations prepared

---

## 🎯 3-MINUTE SETUP

### 1. Database Creation
```sql
-- Open: http://localhost/phpmyadmin/
-- Click: SQL tab
-- Paste & Execute:

CREATE DATABASE `den_mobile` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. Laravel Setup
```bash
cd c:\xampp\htdocs\autodial

# Generate key
php artisan key:generate

# Run migrations
php artisan migrate:fresh

# Seed master data
php artisan db:seed --class=TagMasterSeeder
```

### 3. Create Test Data
```bash
# Open: http://localhost/phpmyadmin/
# Click: SQL tab
# Copy SQL from: TEST_DATA_AND_COMMANDS.md
# Section: "SQL: Create Test Customers"
# Execute to create 10 test customers
```

---

## ⚡ TEST IN 5 MINUTES

### Quick API Test
```bash
# 1. Test device registration
curl -X POST http://localhost/autodial/api/device-register \
  -H "Content-Type: application/json" \
  -d '{"device_id":"device-001","device_name":"Test Phone"}' | jq

# 2. Test polling
curl "http://localhost/autodial/api/get-task?device_id=device-001&device_token=your-token" | jq

# 3. Test tag submission
curl -X POST http://localhost/autodial/api/submit-tag \
  -H "Content-Type: application/json" \
  -d '{"device_id":"device-001","device_token":"your-token","queue_id":1,"customer_id":1,"tag_value":"Interested","notes":"Test"}' | jq
```

### Expected Results
✅ Device registers with token  
✅ Task returned with customer data  
✅ Tag submitted successfully

---

## 📊 VIEW WEB DASHBOARD

```
http://localhost/autodial/dashboard
```

Should show:
- Total customers: 10
- Pending tasks: (number of queued items)
- Completed today: (if any completed)
- Dashboard with charts & metrics

---

## 📖 DOCUMENTATION ORDER

### For Testing
1. **XAMPP_TEST_SETUP.md** ← START HERE
2. **TEST_DATA_AND_COMMANDS.md** ← All curl commands
3. **API_DOCUMENTATION.md** ← Reference

### For Understanding
1. **README.md** ← Quick overview
2. **QUICK_REFERENCE.md** ← File locations
3. **ARCHITECTURE.md** ← System design

---

## 🔧 FILE LOCATIONS

All code is in: `c:\xampp\htdocs\autodial\`

```
Backend Code:
├── app/Models/ (8 PHP files)
├── app/Services/ (2 PHP files)
├── app/Http/Controllers/ (8 PHP files)
├── database/migrations/ (8 files)
└── routes/ (2 files)

Android Code:
├── com/smartcall/models/ (Kotlin)
├── com/smartcall/services/ (Kotlin)
├── com/smartcall/activities/ (Kotlin)
├── com/smartcall/viewmodel/ (Kotlin)
└── com/smartcall/utils/ (Kotlin)

Documentation:
├── XAMPP_TEST_SETUP.md ← TESTING GUIDE
├── TEST_DATA_AND_COMMANDS.md ← TEST COMMANDS
├── ARCHITECTURE.md ← SYSTEM DESIGN
├── API_DOCUMENTATION.md ← ENDPOINT REFERENCE
└── ... (9 more docs)
```

---

## ✅ PRE-TEST CHECKLIST

Before running tests, ensure:

- [ ] XAMPP running (Apache + MySQL)
- [ ] PHP 7.4+ installed
- [ ] MySQL 5.7+ running
- [ ] Database created
- [ ] Migrations run
- [ ] Test customers added
- [ ] Postman or curl available

---

## 🧪 TEST FLOW

```
1. Start XAMPP
   ↓
2. Create database
   ↓
3. Run migrations
   ↓
4. Add test data (10 customers)
   ↓
5. Test device registration API
   ↓
6. Test polling (get-task)
   ↓
7. Test complete flow (task → tag → whatsapp)
   ↓
8. Verify web dashboard
   ↓
✅ ALL TESTS PASS → Ready for Android APK
```

---

## 📋 QUICK REFERENCE

### Key Endpoints (9 Total)

| Endpoint | Method | Purpose |
|----------|--------|---------|
| /api/device-register | POST | Register device |
| /api/get-task | GET | Poll for task ⭐ |
| /api/update-call-status | POST | Mark as calling |
| /api/complete-task | POST | Finish call |
| /api/get-tags | GET | Get available tags |
| /api/submit-tag | POST | Submit tag |
| /api/generate-whatsapp-message | POST | Generate message |
| /api/mark-whatsapp-sent | POST | Mark sent |
| /api/pending-whatsapp-messages | GET | Get pending |

### Web Routes (15 Total)

| Route | Purpose |
|-------|---------|
| /dashboard | Dashboard |
| /crm/customers | Customer list |
| /crm/customers/{id} | Customer detail |
| /analytics | Analytics |
| /device-management | Device control |

---

## 🎯 EXPECTED RESULTS

After following XAMPP_TEST_SETUP.md:

### Database
✅ 8 tables created (customers, devices, call_queues, etc.)  
✅ 10 test customers inserted  
✅ 9 tag masters seeded  
✅ 5 call queue items created  

### API
✅ Device registration returns token  
✅ Polling returns task with customer data  
✅ Race condition prevention verified (atomic locking)  
✅ Tag submission works  
✅ WhatsApp message generation works  

### Web
✅ Dashboard displays stats  
✅ CRM list shows customers  
✅ Analytics shows data  
✅ Device management operational  

### System
✅ Complete call flow works end-to-end  
✅ Database transactions consistent  
✅ Error handling proper  

---

## 🚀 AFTER SUCCESSFUL TESTING

Once XAMPP testing complete:

1. **Build Android APK**
   ```
   Android Studio → Build → Build APK
   ```

2. **Update BASE_URL in RetrofitClient.kt**
   ```kotlin
   BASE_URL = "http://your-xampp-ip/autodial/"
   ```

3. **Install on test device**
   ```bash
   adb install app/release/app-release.apk
   ```

4. **Register device in app**
   - Open app
   - Enter device name
   - Click Register
   - Save token

5. **Enable auto-call**
   - Toggle auto-call ON
   - Verify polling starts
   - Check logs

6. **Complete full flow**
   - Wait for task
   - Make call
   - Submit tag
   - Send WhatsApp

---

## 🐛 TROUBLESHOOTING

### API Returns 404
**Fix:** Ensure .htaccess is correct and routes are cached
```bash
php artisan route:cache
php artisan config:cache
```

### Database Connection Error
**Fix:** Check .env file credentials
```
DB_HOST=127.0.0.1
DB_USERNAME=root
DB_PASSWORD=
```

### No Tasks Available
**Fix:** Ensure call_queues table has pending items
```sql
SELECT * FROM call_queues WHERE status='pending';
```

### Atomic Locking Not Working
**Fix:** Verify lockForUpdate() in TaskAssignmentService.php
```php
$task = CallQueue::where('status', 'pending')
    ->lockForUpdate()  // ← Must have this
    ->first();
```

---

## 📞 SUPPORT

### Documentation
- **Setup Issues:** XAMPP_TEST_SETUP.md
- **API Commands:** TEST_DATA_AND_COMMANDS.md
- **System Design:** ARCHITECTURE.md
- **Endpoints:** API_DOCUMENTATION.md
- **Troubleshooting:** QUICK_REFERENCE.md

### Key Files
- **Core Polling:** TaskAssignmentService.php
- **Task Model:** CallQueue.php
- **Android Polling:** PollingService.kt
- **API Routes:** routes/api.php

---

## ✨ PROJECT STATUS

**Status:** READY FOR XAMPP TESTING ✅

- [x] System fully built
- [x] All code ready
- [x] Documentation complete
- [x] Test guides prepared
- [x] Test data scripts ready

**Next Step:** Follow XAMPP_TEST_SETUP.md

---

## 📈 SUCCESS METRICS

Test passes when:

✅ All 9 API endpoints responding  
✅ Database operations working  
✅ Atomic locking preventing duplicates  
✅ Web dashboard displaying data  
✅ Complete call flow works  
✅ All edge cases handled  
✅ Response times <100ms  

---

## 🎓 QUICK FACTS

- **System:** DEN MOBILE (Digital Engagement Network Mobile)
- **Framework:** Laravel 9+ (Backend) + Kotlin (Android)
- **Database:** MySQL 5.7+
- **Hosting:** cPanel compatible (no SSH needed)
- **Devices:** Supports 100+ concurrent devices
- **API:** 9 endpoints (all documented)
- **Database:** 8 tables (all normalized)
- **Code:** 60 files (all complete)
- **Documentation:** 12 files (all complete)

---

## 🚀 START TESTING NOW

**1. Read:** XAMPP_TEST_SETUP.md (9 steps)  
**2. Follow:** Each step carefully  
**3. Test:** All endpoints using curl commands  
**4. Verify:** Web dashboard  
**5. Success:** When all tests pass ✅

---

**Ready?** → Open XAMPP_TEST_SETUP.md

**Version:** 1.0.0  
**Date:** April 25, 2026  
**Status:** READY FOR TESTING ✅