Ringkasan Proyek

dewakoding-project-management adalah aplikasi manajemen proyek di atas Laravel 12 dan Filament 4. Satu panel Filament ber-id admin menjadi tempat kerja tim internal, sedangkan klien luar memakai rute external/{token} yang berdiri di luar panel itu. README menyebut aplikasi ini sebagai "A Laravel Filament 4 application for managing projects with ticket management and status tracking" (README.md:10¹).

Peta modul

Panel admin mendaftarkan seluruh komponennya lewat discoverResources, discoverPages, dan discoverWidgets, lalu menambahkan Dashboard bawaan serta plugin FilamentShieldPlugin. Panel juga mengaktifkan ->spa(), ->databaseTransactions(), dan tema Vite resources/css/filament/admin/theme.css (app/Providers/Filament/AdminPanelProvider.php:25-68²).

graph TD
  App["dewakoding-project-management"] --> Panel["Panel admin (id: admin, path: admin)"]
  Panel --> Resources["Resources: Projects, Tickets, TicketPriorities, TicketComments, Users, Roles, Notifications"]
  Panel --> Pages["Pages: ProjectBoard, ProjectTimeline, TicketTimeline, EpicsOverview, Leaderboard, UserContributions, SystemSettings"]
  Panel --> Widgets["Widgets: StatsOverview, MonthlyTicketTrendChart, TicketsPerProjectChart"]
  Panel --> Shield["FilamentShieldPlugin"]
  Resources --> Models["Eloquent models"]
  Pages --> Models
  Widgets --> Models
  Models --> DB[("database")]
  Routes["routes/web.php"] --> External["ExternalLogin dan ExternalDashboard"]
  External --> Models
  style DB fill:#336791,color:#fff
  style Models fill:#336791,color:#fff
  style Panel fill:#f59e0b,color:#000
  style Shield fill:#f59e0b,color:#000
  style Widgets fill:#8b5cf6,color:#fff
  style External fill:#2d7d46,color:#fff
  style Routes fill:#2d7d46,color:#fff
%% fig: Peta modul aplikasi
%% desc: Panel admin Filament memuat Resources, Pages, dan Widgets di atas model Eloquent, sementara portal eksternal masuk lewat rute terpisah ke model yang sama.

Navigasi panel dikelompokkan menjadi tiga grup. Project Management memuat papan Kanban dan halaman linimasa, Analytics memuat leaderboard dan kontribusi pengguna, sedangkan Settings memuat pengaturan sistem dan prioritas ticket.

ProjectBoard memakai slug project-board/{project_id?} dan mendefinisikan subjudul "Kanban board for ticket management". Pengguna dengan peran super_admin melihat seluruh project, pengguna lain hanya melihat project yang ia ikuti lewat relasi projects() (app/Filament/Pages/ProjectBoard.php:22-41³). Halaman Leaderboard menyimpan rentang waktu default 7days dan jumlah kontributor teratas 10 (app/Filament/Pages/Leaderboard.php:29-30⁶).

Fitur utama

README mendaftar lima belas fitur (README.md:12-28⁷). Tabel berikut memetakan tiap fitur ke identifier yang benar-benar ada di kode.

Dua fitur README, yaitu export ticket ke CSV dan grafik kontribusi pengguna, tidak punya berkas yang saya periksa langsung; detail export dibahas di Import dan Export Ticket, sedangkan grafik kontribusi di Dashboard, Analitik, dan Leaderboard.

Tumpukan teknologi

Dependensi runtime dideklarasikan di composer.json: PHP ^8.2, filament/filament ^4.0, bezhansalleh/filament-shield ^4.0, laravel/framework ^12.0, laravel/octane ^2.9, laravel/socialite ^5.23, maatwebsite/excel ^3.1, dan solution-forest/tab-layout-plugin ^3.2.3 (composer.json:8-18¹⁷).

⚠️ README menulis syarat PHP sebagai "> 8.2+" (README.md:30-35²⁰), sedangkan composer.json menulis ^8.2 (composer.json:8-18¹⁷). Constraint composer yang berlaku, jadi PHP 8.2 sendiri masih diterima. Langkah shield:setup, shield:install, dan shield:super-admin wajib berurutan agar peran dan permission terbentuk; urutan lengkapnya ada di Instalasi, Konfigurasi, dan Docker.

Portal eksternal

Rute external/{token} dan external/{token}/dashboard memakai komponen Livewire ExternalLogin dan ExternalDashboard (routes/web.php:16-20¹⁶). ExternalDashboard memakai layout layouts.external dan menyimpan konstanta SESSION_LIFETIME_MINUTES = 720 (app/Livewire/ExternalDashboard.php:17-22²¹). Token dan password dibuat oleh ExternalAccess::generateForProject().

⚠️ access_token menjadi bagian path URL, sehingga token ikut tercatat di log akses web server dan riwayat peramban. Password awalnya hanya 8 karakter acak. Rotasi token dan pengaturan aksesnya dibahas di Portal Eksternal Klien.

Perilaku request di dalam panel, termasuk urutan middleware dan authMiddleware, dijelaskan di Arsitektur Aplikasi. Bentuk tabel dan relasi antar model ada di Model Data dan Migration, sedangkan aturan peran di Kontrol Akses dan Peran.