Rina
/
MIF_E31232103
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
MIF_E31232103/TAHAP_11_DOKUMENTASI.md

19 KiB
Raw Blame History

TAHAP 11 - MODUL LAPORAN (REPORTING MODULE)

Versi: 1.0
Status: ✅ Selesai
Tanggal: April 2026

RINGKASAN TAHAP 11

TAHAP 11 fokus pada pengembangan Modul Laporan yang komprehensif untuk memberikan visibilitas dan monitoring terhadap operasional platform dan masing-masing rental. Laporan dirancang untuk mendukung decision making, tracking KPI, dan analisis bisnis tanpa menambah modul bisnis baru.

Tujuan Tahap 11

  1. Super Admin dapat melihat laporan platform-wide untuk monitoring, verifikasi, dan pelaporan bisnis
  2. Admin Rental dapat melihat laporan milik rental mereka sendiri untuk monitoring operasional dan revenue
  3. Semua laporan berbasis data nyata dengan query yang efisien
  4. Filter date range dan filter tambahan (rental, booking status, payment status) sesuai konteks
  5. Tampilan laporan sederhana, clean, dan fokus pada data readability

JENIS LAPORAN

A. UNTUK SUPER ADMIN (7 Laporan)

1. Dashboard Laporan (Index)

  • Route: GET /super-admin/reports
  • Nama Route: super-admin.reports.index
  • Akses: Super Admin
  • Deskripsi: Ringkasan metrik lintas platform

Menampilkan:

  • Total Booking (semua rental)
  • Total Payment Verified
  • Total Kendaraan
  • Total Revenue (verified)
  • Total Komisi (10% dari revenue)
  • Total Customer Aktif
  • Quick links ke laporan detail

Filter: Date range (start_date, end_date)

2. Laporan Booking per Rental

  • Route: GET /super-admin/reports/bookings
  • Nama Route: super-admin.reports.bookings
  • Deskripsi: Data booking dari semua rental di platform

Data yang ditampilkan:

  • Booking code, Rental, Customer, Kendaraan
  • Pickup date, Return date, Duration
  • Total Amount, Booking Status, Payment Status
  • Created date

Summary Statistik:

  • Total Booking
  • Total Completed
  • Total Cancelled
  • Total Ongoing

Filter Tersedia:

  • start_date (nullable|date)
  • end_date (nullable|date|after_or_equal:start_date)
  • rental_id (nullable|exists:rental_companies,id)
  • booking_status (nullable|in:waiting_payment,waiting_verification,confirmed,ongoing,completed,cancelled)

Pagination: 15 items per page

3. Laporan Pembayaran Platform

  • Route: GET /super-admin/reports/payments
  • Nama Route: super-admin.reports.payments
  • Deskripsi: Data pembayaran dari semua rental di platform

Data yang ditampilkan:

  • Booking code, Rental, Customer
  • Payment method, Amount
  • Payment Status, Verified Date, Verified By
  • Rejection Note (jika rejected)

Summary Statistik:

  • Total Payment Verified
  • Total Payment Uploaded
  • Total Payment Rejected
  • Total Nominal Verified (jumlah uang yang terverifikasi)

Filter Tersedia:

  • start_date
  • end_date
  • rental_id
  • payment_status (nullable|in:unpaid,uploaded,verified,rejected)

Pagination: 15 items per page

4. Laporan Kendaraan Terlaris Platform

  • Route: GET /super-admin/reports/top-vehicles
  • Nama Route: super-admin.reports.top-vehicles
  • Deskripsi: Ranking kendaraan berdasarkan jumlah booking verified

Data yang ditampilkan:

  • Rank (#)
  • Nama Kendaraan, Brand, Category
  • Rental (milik siapa)
  • Total Booking (verified)
  • Total Revenue (dari booking verified)

Logika Perhitungan:

Ranking = COUNT(bookings) WHERE vehicle_id = X AND payment_status = 'verified'
Revenue = SUM(total_amount) WHERE vehicle_id = X AND payment_status = 'verified'

Filter Tersedia:

  • start_date
  • end_date
  • limit (default: 20, max: 100)

5. Laporan Customer Aktif Platform

  • Route: GET /super-admin/reports/active-customers
  • Nama Route: super-admin.reports.active-customers
  • Deskripsi: Ranking customer berdasarkan jumlah booking completed

Data yang ditampilkan:

  • Rank (#)
  • Nama Customer, Email, Phone
  • Total Booking, Completed Booking
  • Total Transaksi (verified)
  • Last Booking Date
  • Status Loyal (🏅 jika >= 3 completed bookings)

Logika Perhitungan:

Total Booking = COUNT(bookings) WHERE customer_id = X
Completed = COUNT(bookings) WHERE customer_id = X AND booking_status = 'completed'
Total Transaksi = SUM(total_amount) WHERE customer_id = X AND payment_status = 'verified'
Loyal = IF(completed >= 3) THEN 'Loyal' ELSE 'Regular'

Filter Tersedia:

  • start_date
  • end_date
  • limit (default: 20, max: 100)

6. Laporan Pendapatan Rental

  • Route: GET /super-admin/reports/revenue
  • Nama Route: super-admin.reports.revenue
  • Deskripsi: Revenue breakdown per rental dan kalkulasi komisi platform

Data yang ditampilkan:

  • Nama Rental, Admin Rental
  • Booking Verified Count
  • Pendapatan Gross (total dari verified payment)
  • Komisi (10%)
  • Pendapatan Net (Gross - Komisi)

Logika Perhitungan:

Booking Verified = COUNT(bookings) WHERE rental_id = X AND payment_status = 'verified'
Gross Revenue = SUM(total_amount) WHERE rental_id = X AND payment_status = 'verified'
Commission = Gross Revenue × 10%
Net Revenue = Gross Revenue - Commission

Summary di halaman:

  • Total Gross Revenue (semua rental)
  • Total Commission (semua rental)
  • Total Net Revenue (semua rental)

Filter Tersedia:

  • start_date
  • end_date

7. Laporan Komisi Platform

  • Route: GET /super-admin/reports/commissions
  • Nama Route: super-admin.reports.commissions
  • Deskripsi: Detail komisi platform dari setiap transaksi verified

Data yang ditampilkan:

  • Booking Code, Rental, Customer
  • Amount (booking total)
  • Komisi (10% dari amount)
  • Payment Status, Booking Status
  • Tanggal

Summary Statistik:

  • Total Transactions (verified)
  • Total Gross Revenue
  • Total Commission
  • Avg Commission per Booking

Logika Perhitungan:

Total Transactions = COUNT(bookings) WHERE payment_status = 'verified'
Gross Revenue = SUM(total_amount) WHERE payment_status = 'verified'
Commission per Booking = amount × 10%
Total Commission = SUM(commission_per_booking)
Avg Commission = Total Commission / Total Transactions

Filter Tersedia:

  • start_date
  • end_date
  • rental_id

Pagination: 20 items per page

B. UNTUK ADMIN RENTAL (6 Laporan)

1. Dashboard Laporan Rental (Index)

  • Route: GET /admin-rental/reports
  • Nama Route: admin-rental.reports.index
  • Akses: Admin Rental
  • Deskripsi: Ringkasan metrik untuk rental mereka sendiri

Menampilkan:

  • Total Booking (milik rental)
  • Total Payment Verified (milik rental)
  • Total Kendaraan (milik rental)
  • Total Revenue (verified, milik rental)
  • Total Komisi (10%, dari revenue rental)
  • Total Customer Aktif (yang booking ke rental ini)
  • Quick links ke laporan detail

Filter: Date range (start_date, end_date)

2. Laporan Booking Rental

  • Route: GET /admin-rental/reports/bookings
  • Nama Route: admin-rental.reports.bookings
  • Deskripsi: Data booking untuk rental ini saja

Data yang ditampilkan: Sama dengan super admin, tapi hanya untuk rental yang login

Summary Statistik: Sama dengan super admin

Filter Tersedia:

  • start_date
  • end_date
  • booking_status (TIDAK ada rental_id karena auto-filtered ke rental mereka)

Pagination: 15 items per page

3. Laporan Pembayaran Rental

  • Route: GET /admin-rental/reports/payments
  • Nama Route: admin-rental.reports.payments
  • Deskripsi: Data pembayaran untuk rental ini saja

Data yang ditampilkan: Sama dengan super admin, tapi hanya untuk rental yang login

Summary Statistik: Sama dengan super admin

Filter Tersedia:

  • start_date
  • end_date
  • payment_status

Pagination: 15 items per page

4. Laporan Kendaraan Terlaris Rental

  • Route: GET /admin-rental/reports/top-vehicles
  • Nama Route: admin-rental.reports.top-vehicles
  • Deskripsi: Ranking kendaraan milik rental mereka berdasarkan booking verified

Data yang ditampilkan: Sama dengan super admin, tapi hanya kendaraan milik rental

Filter Tersedia:

  • start_date
  • end_date
  • limit

5. Laporan Customer Aktif Rental

  • Route: GET /admin-rental/reports/active-customers
  • Nama Route: admin-rental.reports.active-customers
  • Deskripsi: Ranking customer yang pernah booking ke rental mereka

Data yang ditampilkan: Sama dengan super admin, tapi hanya customer yang booking ke rental ini

Filter Tersedia:

  • start_date
  • end_date
  • limit

6. Laporan Pendapatan Rental

  • Route: GET /admin-rental/reports/revenue
  • Nama Route: admin-rental.reports.revenue
  • Deskripsi: Detail revenue untuk rental mereka sendiri

Data yang ditampilkan:

  • Informasi rental (nama, admin)
  • Booking Verified Count
  • Pendapatan Gross
  • Komisi (10%)
  • Pendapatan Net
  • Detail breakdown dengan penjelasan lengkap

Logika Perhitungan: Sama dengan super admin tapi untuk 1 rental saja

Filter Tersedia:

  • start_date
  • end_date

STRUKTUR FILE

Controllers

app/Http/Controllers/
├── SuperAdmin/
│   └── ReportController.php (7 methods: index, bookings, payments, topVehicles, activeCustomers, revenue, commissions)
└── AdminRental/
    └── ReportController.php (6 methods: index, bookings, payments, topVehicles, activeCustomers, revenue)

Views

resources/views/
├── super-admin/reports/
│   ├── index.blade.php
│   ├── bookings.blade.php
│   ├── payments.blade.php
│   ├── top-vehicles.blade.php
│   ├── active-customers.blade.php
│   ├── revenue.blade.php
│   └── commissions.blade.php
└── admin-rental/reports/
    ├── index.blade.php
    ├── bookings.blade.php
    ├── payments.blade.php
    ├── top-vehicles.blade.php
    ├── active-customers.blade.php
    └── revenue.blade.php

Routes (dalam routes/web.php)

// Super Admin Reports (7 routes)
Route::get('/reports', [SuperAdminReportController::class, 'index'])->name('reports.index');
Route::get('/reports/bookings', [SuperAdminReportController::class, 'bookings'])->name('reports.bookings');
Route::get('/reports/payments', [SuperAdminReportController::class, 'payments'])->name('reports.payments');
Route::get('/reports/top-vehicles', [SuperAdminReportController::class, 'topVehicles'])->name('reports.top-vehicles');
Route::get('/reports/active-customers', [SuperAdminReportController::class, 'activeCustomers'])->name('reports.active-customers');
Route::get('/reports/revenue', [SuperAdminReportController::class, 'revenue'])->name('reports.revenue');
Route::get('/reports/commissions', [SuperAdminReportController::class, 'commissions'])->name('reports.commissions');

// Admin Rental Reports (6 routes)
Route::get('/reports', [AdminRentalReportController::class, 'index'])->name('reports.index');
Route::get('/reports/bookings', [AdminRentalReportController::class, 'bookings'])->name('reports.bookings');
Route::get('/reports/payments', [AdminRentalReportController::class, 'payments'])->name('reports.payments');
Route::get('/reports/top-vehicles', [AdminRentalReportController::class, 'topVehicles'])->name('reports.top-vehicles');
Route::get('/reports/active-customers', [AdminRentalReportController::class, 'activeCustomers'])->name('reports.active-customers');
Route::get('/reports/revenue', [AdminRentalReportController::class, 'revenue'])->name('reports.revenue');

ATURAN BISNIS UNTUK PERHITUNGAN

1. Revenue & Commission

Gross Revenue = SUM(Booking.total_amount) WHERE payment_status = 'verified'
Commission = Gross Revenue × 10%
Net Revenue = Gross Revenue - Commission
  • Hanya transaksi verified yang dihitung
  • Komisi tetap 10% (tidak berubah)
  • Tidak ada diskon atau bonus di level laporan

2. Booking Status untuk Statistik

Valid Status untuk statistik: 'completed', 'ongoing', 'confirmed'
Calculation: COUNT(bookings) WHERE booking_status IN (...)

3. Payment Status untuk Perhitungan Uang

Hanya 'verified' yang dihitung untuk revenue/komisi
'uploaded' = belum verified
'rejected' = tidak dihitung
'unpaid' = tidak ada pembayaran

4. Customer Aktif & Loyal

Total Booking = COUNT(bookings) WHERE customer_id = X
Completed = COUNT(bookings) WHERE customer_id = X AND booking_status = 'completed'
Loyal Status = IF(completed >= 3) THEN 'Loyal' ELSE 'Regular'

5. Top Vehicles Ranking

Ranking = ORDER BY COUNT(bookings) DESC WHERE payment_status = 'verified'
Revenue per Vehicle = SUM(total_amount) WHERE payment_status = 'verified'

FITUR KEAMANAN & VALIDASI

Authorization

  1. Super Admin - Full access ke semua laporan platform-wide
  2. Admin Rental - Access HANYA laporan milik rental mereka sendiri
    • Automatic filter: WHERE rental_company_id = Auth::user()->rentalCompany->id
    • Tidak bisa akses laporan rental lain

Validation

$request->validate([
    'start_date' => ['nullable', 'date'],
    'end_date' => ['nullable', 'date', 'after_or_equal:start_date'],
    'rental_id' => ['nullable', 'exists:rental_companies,id'], // Super Admin only
    'booking_status' => ['nullable', 'in:waiting_payment,...'],
    'payment_status' => ['nullable', 'in:unpaid,uploaded,verified,rejected'],
    'limit' => ['nullable', 'integer', 'min:5', 'max:100'],
]);

Query Efficiency

  1. Eager Loading: with(['customer', 'vehicle.rentalCompany', 'payment'])
  2. Aggregate Queries: withCount(), withSum(), withMax() untuk statistik
  3. No N+1: Semua relasi di-load dengan 1 query
  4. Pagination: Default 15-20 items per page untuk performa

FITUR FILTER

Filter Universal (di semua laporan)

  • start_date: Dari tanggal berapa (Booking.created_at >=)
  • end_date: Sampai tanggal berapa (Booking.created_at <=)

Filter Tambahan Per Laporan

Laporan Filter Tambahan Keterangan
Booking rental_id, booking_status Super Admin bisa filter per rental
Payment rental_id, payment_status Super Admin bisa filter per rental
Top Vehicles limit Default 20, max 100
Active Customers limit Default 20, max 100
Revenue None Auto-per rental
Commissions rental_id Filter transaksi komisi per rental

Filter Behavior

  • Semua filter nullable - Tidak ada yang required
  • Query string preserved - Pagination mempertahankan filter
  • Reset button - Kembalikan ke filter default

CARA MENGAKSES LAPORAN

Super Admin

  1. Login sebagai Super Admin
  2. Buka menu "Laporan" di sidebar (atau /super-admin/reports)
  3. Pilih laporan yang ingin dilihat dari dashboard
  4. Gunakan filter untuk narrow down data
  5. Lihat statistik ringkas di atas tabel
  6. Scroll untuk melihat detail data

Admin Rental

  1. Login sebagai Admin Rental
  2. Buka menu "Laporan" di sidebar (atau /admin-rental/reports)
  3. Pilih laporan dari dashboard
  4. Filter sesuai kebutuhan
  5. Data otomatis terbatas ke rental mereka sendiri

TESTING LAPORAN

Data Test yang Direkomendasikan

  1. Booking dengan payment_status = verified: Untuk revenue calculation
  2. Booking dengan status completed: Untuk active customer calculation
  3. Multiple rental: Untuk test super admin vs admin rental filtering
  4. Multiple customers: Untuk test customer active ranking
  5. Date range variation: Untuk test filter tanggal

Test Cases Minimal

✓ Super Admin dapat melihat semua laporan
✓ Admin Rental hanya melihat laporan milik rental-nya
✓ Filter date range bekerja sesuai
✓ Filter rental_id bekerja (super admin)
✓ Statistik ringkas terhitung akurat
✓ Pagination working
✓ Revenue & Commission calculated correctly (10%)
✓ Customer Loyalty status correct (>= 3)

PERTIMBANGAN PERFORMA

Query Optimization

  1. withCount() vs COUNT() subquery - Lebih efisien
  2. withSum() vs SUM() subquery - Lebih readable
  3. with() untuk eager loading - Hindari N+1
  4. Index recommendation: 
    CREATE INDEX idx_bookings_rental_payment ON bookings(rental_company_id, payment_status, created_at);
CREATE INDEX idx_bookings_customer_status ON bookings(customer_id, booking_status, created_at);
CREATE INDEX idx_bookings_vehicle_payment ON bookings(vehicle_id, payment_status, created_at);

Caching (Future Enhancement)

  • Cache revenue summary untuk 1 jam
  • Cache top vehicles/customers untuk 6 jam
  • Invalidate cache saat ada transaksi baru

LANGKAH BERIKUTNYA (TAHAP 12+)

Tahap 12: Export & Format

  • Export laporan ke PDF
  • Export laporan ke Excel (.xlsx)
  • Email laporan periodic (daily/weekly/monthly)
  • Print-friendly version

Tahap 13: Advanced Analytics

  • Chart & visualization (Chart.js)
  • Trend analysis (month-over-month growth)
  • Predictive analytics (forecast revenue)
  • Comparison tools (rental A vs rental B)

Tahap 14: Performance & Scalability

  • Database indexing optimization
  • Query caching strategy
  • Materialized views untuk laporan heavy
  • Background jobs untuk laporan besar
  • Report scheduling & automation

Tahap 15: User-Defined Reports

  • Custom report builder (drag-drop columns)
  • Save custom report templates
  • Shared reports & dashboards
  • Report access control

NOTES & CATATAN PENTING

  1. Komisi Platform = 10% - Bisa menjadi configurable di config/app.php jika perlu fleksibilitas
  2. Payment Status - Hanya 'verified' yang masuk perhitungan revenue untuk akurasi keuangan
  3. Date Filter - Menggunakan created_at booking, bukan verified_at atau completed_at
  4. Admin Rental Filter - Automatic via Auth::user()->rentalCompany->id, bukan dari request
  5. Pagination State - withQueryString() memastikan filter persist saat pindah halaman
  6. Empty States - Semua laporan punya pesan "Belum ada data..." saat kosong
  7. Number Formatting - Rupiah dengan number_format($value, 0, ',', '.')
  8. DateTime Display - Format d M Y untuk tanggal (01 Jan 2024)

CHECKLIST DEPLOYMENT

  • Controllers created & tested
  • Routes configured
  • Views created with proper layout
  • Filters validated
  • Authorization working (super admin vs admin rental)
  • Date range filtering working
  • Statistics calculation correct
  • Pagination implemented
  • Empty state messages
  • Query optimization (eager loading, aggregates)
  • Number formatting for currency
  • Quick links in dashboard
  • Testing with real data
  • Performance testing on large datasets
  • User acceptance testing

KESIMPULAN

TAHAP 11 berhasil mengimplementasikan modul laporan komprehensif yang:

  • ✅ Memberikan visibility platform-wide untuk super admin
  • ✅ Memberikan visibility rental-specific untuk admin rental
  • ✅ Semua laporan berbasis data real-time
  • ✅ Query efficient dengan aggregate functions
  • ✅ Proper authorization & data filtering
  • ✅ Clean, simple, readable UI
  • ✅ Siap untuk monitoring, analysis, dan decision making

Sistem sekarang cukup matang untuk production use dengan monitoring capability yang solid untuk semua stakeholder.