# 👥 Agent Panel - Panduan Lengkap

Panduan lengkap penggunaan Agent Panel untuk generate voucher dan transaksi.

---

## 📋 Fitur Agent Panel

### ✅ Dashboard
- Lihat saldo terkini
- Generate voucher
- Riwayat transaksi terakhir
- Statistik agent

### ✅ Generate Voucher
- Pilih profile voucher
- Set jumlah voucher
- Input data customer (optional)
- Auto-deduct saldo
- Kirim via WhatsApp (optional)

### ✅ My Vouchers
- Lihat semua voucher yang di-generate
- Filter by status (active, used, expired)
- Copy username & password
- Track customer

### ✅ Transactions
- Riwayat transaksi lengkap
- Topup history
- Generate history
- Balance tracking

---

## 🚀 Cara Akses Agent Panel

### URL:
```
http://localhost/mikhmon/agent/
```

Atau di hosting:
```
https://yourdomain.com/mikhmon/agent/
```

### Login:
- **Phone:** Nomor WhatsApp agent (08xxx atau 62xxx)
- **Password:** Password yang diset admin

---

## 📖 Cara Penggunaan

### 1. Login ke Agent Panel

#### Step 1: Buka URL
```
http://localhost/mikhmon/agent/
```

#### Step 2: Input Credentials
- Phone: 081234567890
- Password: agent123

#### Step 3: Klik Login
Jika berhasil, akan redirect ke Dashboard

---

### 2. Generate Voucher

#### Step 1: Di Dashboard
Scroll ke bagian "Generate Voucher"

#### Step 2: Pilih Profile
Pilih profile voucher dari dropdown:
- 1JAM
- 3JAM
- 1HARI
- dll (sesuai profile di MikroTik)

#### Step 3: Set Quantity
Input jumlah voucher yang ingin di-generate (1-100)

#### Step 4: Input Customer Data (Optional)
- Customer Phone: 08xxx (untuk kirim via WhatsApp)
- Customer Name: Nama customer

#### Step 5: Klik Generate
Klik tombol "Generate Voucher"

#### Step 6: Voucher Ter-generate! ✅
- Voucher muncul di layar
- Saldo otomatis terpotong
- Tersimpan di database
- Jika ada nomor WA, otomatis terkirim

---

### 3. Lihat Voucher yang Sudah Di-generate

#### Step 1: Klik Menu "My Vouchers"
Di header, klik "My Vouchers"

#### Step 2: Lihat Daftar Voucher
Semua voucher yang pernah di-generate akan muncul:
- Username
- Password
- Profile
- Price
- Status (active/used/expired)
- Date

#### Step 3: Copy Voucher
Klik username atau password untuk copy

---

### 4. Lihat Riwayat Transaksi

#### Step 1: Klik Menu "Transactions"
Di header, klik "Transactions"

#### Step 2: Lihat History
Semua transaksi akan muncul:
- Date & Time
- Type (topup/generate)
- Amount
- Balance Before
- Balance After
- Description

---

## 💰 Sistem Saldo

### Cara Kerja:
1. Admin set harga untuk agent
2. Admin topup saldo agent
3. Agent generate voucher
4. Saldo otomatis terpotong
5. Voucher tersimpan di database

### Contoh:
```
Saldo awal: Rp 100.000
Generate 1 voucher 1JAM (harga: Rp 5.000)
Saldo akhir: Rp 95.000
```

### Cek Saldo:
- Dashboard → Balance Card (atas)
- Transactions → Current Balance

### Topup Saldo:
- Hubungi admin
- Admin akan topup via admin panel
- Saldo otomatis bertambah

---

## 🎯 Tips & Tricks

### 1. Generate Multiple Vouchers
Set quantity > 1 untuk generate banyak voucher sekaligus

### 2. Kirim via WhatsApp
Input nomor customer untuk auto-send voucher

### 3. Track Customer
Input customer name & phone untuk tracking

### 4. Copy Voucher
Klik username/password untuk copy ke clipboard

### 5. Check Balance
Selalu cek saldo sebelum generate

### 6. Print Voucher
Copy voucher ke Word/Excel untuk print

### 7. Backup Data
Download transaction history secara berkala

---

## 🔐 Security

### Password:
- Minimal 6 karakter
- Jangan share ke orang lain
- Ganti password secara berkala

### Session:
- Auto-logout setelah 30 menit inactive
- Logout manual: Klik "Logout" di header

### Data:
- Semua transaksi tercatat
- Tidak bisa dihapus
- Admin bisa monitoring

---

## 🐛 Troubleshooting

### 1. Tidak Bisa Login

**Error:** "Agent tidak ditemukan" atau "Password salah"

**Cek:**
- Nomor phone benar? (08xxx atau 62xxx)
- Password benar?
- Status agent active?

**Solusi:**
- Hubungi admin untuk reset password
- Pastikan agent sudah dibuat di admin panel

---

### 2. Saldo Tidak Cukup

**Error:** "Saldo tidak mencukupi"

**Cek:**
- Saldo terkini di dashboard
- Harga voucher

**Solusi:**
- Hubungi admin untuk topup
- Tunggu admin approve topup

---

### 3. Voucher Tidak Ter-generate

**Error:** "Gagal generate voucher"

**Cek:**
- Koneksi ke MikroTik OK?
- Profile exists di MikroTik?
- Harga sudah diset untuk profile?

**Solusi:**
- Refresh halaman
- Coba lagi
- Hubungi admin jika masih error

---

### 4. WhatsApp Tidak Terkirim

**Error:** Voucher ter-generate tapi WA tidak masuk

**Cek:**
- WhatsApp Gateway running?
- Nomor customer benar?
- Format nomor: 08xxx atau 62xxx

**Solusi:**
- Copy voucher manual
- Kirim via WA manual
- Hubungi admin untuk cek gateway

---

### 5. Halaman Loading Terus

**Error:** Halaman stuck di loading

**Cek:**
- Internet connection OK?
- Server MikroTik running?
- Database connection OK?

**Solusi:**
- Refresh halaman (F5)
- Clear browser cache
- Logout & login lagi
- Hubungi admin

---

## 📊 Dashboard Explained

### Balance Card (Atas)
```
┌─────────────────────────────────┐
│  Your Current Balance           │
│  Rp 100.000                     │
│  Agent Code: AG001              │
└─────────────────────────────────┘
```

### Generate Voucher Card (Kiri)
```
┌─────────────────────────────────┐
│  Generate Voucher               │
│  ┌───────────────────────────┐  │
│  │ Profile: [Select]         │  │
│  │ Quantity: [1]             │  │
│  │ Customer Phone: [08xxx]   │  │
│  │ Customer Name: [Name]     │  │
│  │ [Generate Voucher]        │  │
│  └───────────────────────────┘  │
└─────────────────────────────────┘
```

### Recent Transactions (Kanan)
```
┌─────────────────────────────────┐
│  Recent Transactions            │
│  ┌───────────────────────────┐  │
│  │ Date | Type | Amount      │  │
│  │ 01/11| Topup| +Rp 100.000 │  │
│  │ 01/11| Gen  | -Rp 5.000   │  │
│  └───────────────────────────┘  │
└─────────────────────────────────┘
```

---

## 🎨 Mobile Responsive

Agent Panel fully responsive untuk mobile:
- ✅ Dashboard mobile-friendly
- ✅ Generate voucher di HP
- ✅ Lihat voucher di HP
- ✅ Check transactions di HP

---

## 📱 WhatsApp Integration

### Auto-Send Voucher:
1. Generate voucher
2. Input customer phone
3. Voucher auto-send via WhatsApp
4. Customer langsung terima

### Format Pesan:
```
🎫 VOUCHER WIFI HOTSPOT
━━━━━━━━━━━━━━━━━━━━

Hotspot: NAMA_HOTSPOT
Profile: 1JAM

Username: user123
Password: pass123

Time Limit: 1h
Data Limit: 1GB
Validity: 1d
Harga: Rp 5.000

Login URL:
http://hotspot.com/login

Kode: Agent-AG001-011124

━━━━━━━━━━━━━━━━━━━━
Terima kasih!
```

---

## 📈 Statistik & Reporting

### Dashboard Stats:
- Current Balance
- Total Vouchers Generated
- Total Transactions
- Agent Code

### Transaction Report:
- Daily transactions
- Monthly summary
- Balance tracking
- Profit calculation

### Voucher Report:
- Total vouchers
- Active vouchers
- Used vouchers
- Expired vouchers

---

## 🔄 Workflow

### Generate Voucher Workflow:
```
1. Agent login
   ↓
2. Pilih profile & quantity
   ↓
3. Input customer data (optional)
   ↓
4. Klik Generate
   ↓
5. System cek saldo
   ↓
6. Generate voucher di MikroTik
   ↓
7. Deduct saldo agent
   ↓
8. Save to database
   ↓
9. Send via WhatsApp (optional)
   ↓
10. Show voucher di layar
   ↓
11. Done! ✅
```

### Topup Workflow:
```
1. Agent request topup
   ↓
2. Admin approve
   ↓
3. Saldo bertambah
   ↓
4. Notification ke agent
   ↓
5. Done! ✅
```

---

## 🎯 Best Practices

### 1. Cek Saldo Sebelum Generate
Pastikan saldo cukup sebelum generate voucher

### 2. Input Customer Data
Selalu input customer phone & name untuk tracking

### 3. Backup Voucher
Screenshot atau copy voucher untuk backup

### 4. Track Transactions
Cek transaction history secara berkala

### 5. Logout Setelah Selesai
Jangan lupa logout untuk security

### 6. Update Password
Ganti password secara berkala

### 7. Report Issues
Laporkan masalah ke admin segera

---

## 📞 Support

### Admin Panel:
Admin bisa monitoring semua agent:
- Lihat saldo agent
- Topup saldo
- Set harga
- Lihat transaksi
- Block/unblock agent

### Contact Admin:
- Via WhatsApp
- Via email
- Via phone

### Documentation:
- AGENT_PANEL_GUIDE.md (file ini)
- AGENT_SYSTEM_README.md
- WHATSAPP_INTEGRATION.md

---

## 🎉 Selesai!

Agent Panel siap digunakan untuk generate voucher!

**Next Steps:**
1. ✅ Login ke agent panel
2. ✅ Cek saldo
3. ✅ Generate voucher pertama
4. ✅ Test kirim via WhatsApp
5. ✅ Track transactions
6. ✅ Enjoy! 🚀

---

**Version:** 1.0.0  
**License:** GPL-2.0  
**Author:** MikhMon Team

**Happy Selling! 🚀**
