Troubleshooting

Login & Authentication

"These credentials do not match our records"

• Cek email & password
• Email belum verified? Cek users.email_verified_at
• Account di-soft-delete? users.deleted_at not null

Setelah login redirect ke /portal padahal admin

• Pastikan users.role = owner/admin/doctor/dll bukan patient
• Cek di FortifyServiceProvider::LoginResponse — role check logic

"Page expired" (419)

• CSRF token mismatch — refresh page
• Session expired — login ulang
• SESSION_DRIVER di .env mismatch dengan storage

Layout / Tampilan

Sidebar tidak muncul / styling broken

• Asset belum di-build: npm run build
• Clear view cache: php artisan view:clear
• Browser cache: hard refresh (Ctrl+Shift+R)

"Unable to locate a class or view for component"

• View berada di path yang salah. Component <x-xxx> cari di resources/views/components/xxx.blade.php

Livewire form tidak submit / button tidak respon

• Vite asset belum loaded — cek browser console
• Token CSRF expired
• JS error — buka DevTools console

Database & Migration

Migration error "table already exists"

php artisan migrate:status   # cek status
php artisan migrate:rollback # rollback last batch

"Column not found" setelah pull code

php artisan migrate --force
php artisan config:clear

Seed gagal "Duplicate entry"

• Hapus row yang konflik, atau pakai firstOrCreate di seeder

License (Production)

Wizard /__pair infinite loop

• APP_URL mismatch dengan host browser
• Set APP_URL=https://yourdomain.com (HTTPS exact match)

"Tidak bisa menghubungi server lisensi"

• Outbound firewall block whitelabel.co.id:443 — whitelist

App jalan tapi marketplace bilang revoked

• Cache heartbeat — tunggu 24h atau php artisan cache:clear

Performance

Page load lambat

• Enable Redis: CACHE_DRIVER=redis, SESSION_DRIVER=redis
• Cache config: php artisan config:cache
• Cache routes: php artisan route:cache
• Cache views: php artisan view:cache
• Run queue worker: php artisan queue:work

Database query lambat

• Cek N+1 dengan Telescope
• Add eager loading: with(['relation'])
• Index kolom yang sering di-filter

Email & WhatsApp

Reminder WA tidak terkirim

1. Cek messaging_providers ada provider aktif untuk channel whatsapp
2. Test connection di admin panel
3. Cek queue worker jalan: php artisan queue:work
4. Cek Laravel log: storage/logs/laravel.log

Schedule reminders:dispatch tidak jalan

• Setup cron di server:

* * * * * cd /path && php artisan schedule:run >> /dev/null 2>&1

Common Errors