Panduan Alur Sistem AgenUmroh

🔄 Alur Sistem (Overview)

▼

👑 Owner Travel
PPIU/PIHK

→

📋 Distribusi Paket
Admin → Owner

→

🤝 Agen Travel
Ketua Agen

→

🧳 Jamaah
Daftar Umroh

💡 Arsitektur Multi-Tenant

Sistem menggunakan HasAgen trait untuk isolasi data per owner/agen. Owner hanya melihat agen dan jamaah miliknya. Agen hanya melihat jamaah sendiri. Admin pusat melihat semua data.

Role	Access	Caption
admin	Full access semua modul	Admin Pusat
owner_travel	CRUD paket, manage agen, lihat jamaah ownernya	Pemilik Travel (PPIU/PIHK)
staff_kantor	Sama seperti owner_travel (lihat semua data travel)	Staff Kantor
ketua	Lihat paket dari owner, manage jamaah sendiri	Ketua Agen / Mitra
user	Akses dasar	User biasa

📋 Prasyarat WAJIB

▼

Akses internet dan browser modern (Chrome/Firefox/Safari)
Akun email aktif untuk registrasi
Untuk Owner Travel: Nomor izin PPIU/PIHK yang valid
Untuk Agen: Link referral dari Owner Travel yang sudah disetujui
Untuk Jamaah: Data diri lengkap + nomor WhatsApp aktif

👑 Registrasi Owner Travel (PPIU/PIHK)

▼

Owner Travel adalah pemilik travel resmi yang memiliki izin PPIU/PIHK. Mereka mendaftar langsung dari homepage dan perlu disetujui admin sebelum bisa menggunakan sistem.

1 Buka Halaman Registrasi

Dari homepage agenumroh.my.id, klik tombol "Daftar sebagai Pemilik Travel" atau langsung akses:

https://agenumroh.my.id/register-owner

2 Isi Formulir Registrasi

Isi data travel Anda:

Field	Keterangan	Wajib?
Nama Travel	Nama lengkap perusahaan travel	✅
No. Izin PPIU/PIHK	Nomor izin resmi dari Kementerian Agama	✅
Email	Email aktif untuk login	✅
Password	Minimal 6 karakter	✅
Kota	Kota domisili travel	Opsional
Alamat	Alamat lengkap kantor	Opsional

3 Submit & Menunggu Persetujuan

Setelah submit, akun Anda dalam status PENDING. Admin pusat akan memverifikasi dan menyetujui akun Anda.

⚠️ Catatan Penting

Owner Travel TIDAK bisa login sampai admin menyetujui. Setelah approved, Anda bisa membuat paket mitra dan mengundang agen di bawah Anda.

4 Setelah Disetujui — Dashboard Owner

Login dan akses dashboard di:

https://agenumroh.my.id/owner/dashboard

Dari dashboard, Anda bisa:

✅ Fitur Owner Travel

• Lihat & kelola agen di bawah Anda
• Terima paket distribusi dari admin pusat
• Ambil paket dengan pricing sendiri
• Approve/reject agen yang mendaftar

🤝 Registrasi Agen Travel

▼

Agen (Ketua Agen) mendaftar melalui link referral dari Owner Travel. Owner harus menyetujui agen sebelum bisa login.

1 Dapatkan Link Referral dari Owner

Owner Travel membagikan link referral dengan format:

https://agenumroh.my.id/register-agen?ref=SLUG-OWNER

Contoh: /register-agen?ref=pt-azma-travel

💡 Info

Jika link tidak valid atau owner belum aktif, Anda akan mendaftar sebagai agen mandiri (tanpa ikatan travel).

2 Isi Formulir Pendaftaran

Form akan menampilkan banner konfirmasi owner tujuan Anda. Isi data:

Field	Keterangan	Wajib?
Nama	Nama lengkap / nama agen	✅
Email	Email aktif untuk login	✅
Password	Minimal 6 karakter + konfirmasi	✅
Kota	Kota domisili	Opsional
Alamat	Alamat lengkap	Opsional

3 Owner Travel Menyetujui

Owner login ke dashboard → bagian "Agen Saya" → melihat daftar agen dengan status:

Status	Badge	Aksi
PENDING	⏳ Kuning	✅ Setujui / ❌ Tolak
APPROVED	✅ Hijau	— (sudah aktif)
REJECTED	❌ Merah	↩️ Aktifkan ulang

⚠️ Isolasi Data

Owner hanya bisa approve agen yang mendaftar di bawahnya. Jika owner mencoba approve agen owner lain → HTTP 403 Forbidden.

4 Agen Bisa Login & Menjual Paket

Setelah disetujui, agen bisa login di:

https://agenumroh.my.id/login

Agen hanya melihat paket dari owner travel mereka. Agen bisa share paket ke jamaah via link WhatsApp.

📋 Distribusi Paket Mitra

▼

Admin pusat mendistribusikan paket ke Owner Travel. Owner "mengambil" paket dengan pricing sendiri lalu menjual melalui agen.

1 Admin Distribusi Paket

Admin pusat memilih paket + target owner travel → distribusi:

https://agenumroh.my.id/admin/distribusi-paket

Status distribusi: pending → active (owner sudah melihat) → taken (owner sudah mengambil)

2 Owner Travel Mengambil Paket

Owner login → lihat paket tersedia → klik "Ambil Paket":

https://agenumroh.my.id/owner/paket-tersedia

Owner mengatur harga jual sendiri. Sistem akan meng-cloned paket dengan owner_travel_id dan original_package_id.

✅ Yang Terjadi

Paket baru dibuat di tabel partner_packages dengan data: harga jual override, komisi, dan link ke paket asli. Paket ini hanya terlihat oleh agen di bawah owner tersebut.

3 Agen Melihat & Share ke Jamaah

Agen login → lihat paket di dashboard → klik paket → share via WhatsApp ke jamaah:

https://agenumroh.my.id/paket-mitra/{id}

Form pendaftaran jamaah akan otomatis terisi referral agen.

🧳 Pendaftaran Jamaah

▼

Jamaah bisa mendaftar melalui agen (via link referral) atau langsung dari website tanpa agen.

1 Cara 1: Daftar via Agen (Recommended)

Agen share link paket ke jamaah via WhatsApp. Link otomatis menyertakan referral agen:

https://agenumroh.my.id/daftar-umroh/{paket}?ref=KODE-AGEN

Form pendaftaran akan menampilkan nama agen sebagai referensi. Data jamaah otomatis terhubung ke agen tersebut.

2 Cara 2: Daftar Langsung (Tanpa Agen)

Jamaah bisa mendaftar langsung dari:

https://agenumroh.my.id/daftar-umroh/{paket}

Tanpa parameter ?ref=, jamaah terdaftar tanpa agen. Lead ini hanya terlihat oleh admin pusat.

⚠️ Visibility

Jamaah tanpa referral TIDAK terlihat oleh agen manapun. Admin pusat bisa menugaskan ke agen secara manual atau menangani langsung.

3 Form Pendaftaran Jamaah

Data yang diisi jamaah:

Field	Keterangan	Wajib?
Nama Lengkap	Sesuai paspor	✅
Email	Email aktif	✅
No. WhatsApp	Nomor aktif untuk komunikasi	✅
Paket	Paket umroh yang dipilih (otomatis terisi)	✅
Agen Referral	Kode agen (otomatis dari link)	Opsional

Setelah submit, jamaah terdaftar dengan status baru dan masuk ke inbox admin/agen.

💰 Setoran & Pembayaran

▼

Sistem tracking cicilan jamaah. Agen bisa mencatat setoran, admin bisa melihat laporan lengkap.

1 Agen Mencatat Setoran

Dari dashboard agen → pilih jamaah → klik "Tambah Setoran":

Field	Keterangan
Jumlah	Nominal setoran (Rp)
Tanggal	Tanggal pembayaran
Metode	Transfer bank, tunai, dll
Bukti	Foto bukti transfer (opsional)
Catatan	Keterangan tambahan

2 Tracking Cicilan

Dashboard jamaah menampilkan:

✅ Info Setoran

• Total harga paket
• Total sudah dibayar
• Sisa yang harus dibayar
• Riwayat setoran per tanggal
• Status: Lunas / Cicilan / Belum Bayar

🔐 Admin Pusat

▼

Admin pusat memiliki akses penuh ke semua modul. Bisa melihat semua owner, agen, jamaah, dan paket.

1 Dashboard Admin

https://agenumroh.my.id/admin

Menu admin meliputi:

✅ Menu Admin Pusat

• 👥 Kelola User (owner, agen, staff)
• 📦 Paket Mitra & Distribusi
• 🧳 Jamaah & Pendaftaran
• 💰 Setoran & Pembayaran
• 📄 Scan Paspor OCR
• 🧳 Itinerary & Template
• 📊 Laporan & Monitoring

2 Menyetujui Owner Travel

Admin bisa approve/reject owner travel yang mendaftar:

https://agenumroh.my.id/admin/owner-travel/{id}/approve

Setelah approved, owner bisa login dan mulai menggunakan sistem.

3 Menugaskan Jamaah ke Agen

Jamaah yang mendaftar tanpa agen bisa ditugaskan manual:

💡 Tips

Di inbox admin, jamaah tanpa referral ditandai khusus. Admin bisa assign ke agen yang sesuai berdasarkan kota atau kriteria lain.

🔧 Troubleshooting

▼

Masalah	Solusi
Owner Travel tidak bisa login	Admin belum approve. Hubungi admin pusat untuk menyetujui akun Anda.
Agen tidak melihat paket	Paket belum didistribusikan ke owner travel agen. Hubungi owner atau admin.
Jamaah tidak terlihat di agen	Jamaah mendaftar tanpa referral. Admin perlu assign manual ke agen.
Link referral tidak valid	Periksa slug owner travel. Pastikan owner sudah approved dan referral aktif.
403 Forbidden saat approve	Isolasi data aktif. Owner hanya bisa approve agen di bawahnya sendiri.
Error 500 di halaman tertentu	Clear cache: `php artisan config:clear && php artisan view:clear`

📘 Panduan Alur Sistem AgenUmroh