Masalahnya: Codebase Berusia 7 Tahun

Pada tahun 2017, saya membangun sebuah platform e-learning untuk ujian online di sekolah menengah pertama. Dibuat dengan Laravel 5.2 dan PHP 5.6—stack standar pada masa itu.

Maju cepat ke 2026, dan codebase tersebut masih digunakan. Memang berjalan, tapi:

• 🔴 Kerentanan keamanan — Laravel 5.2 sudah tidak mendapat patch keamanan sejak bertahun-tahun lalu
• 🔴 PHP 5.6 sudah mati — Kebanyakan penyedia hosting sudah tidak mendukungnya
• 🔴 Fitur modern hilang — Tidak ada update real-time, pengalaman mobile buruk
• 🔴 Mimpi buruk maintenance — Dependencies outdated, dokumentasi minim

Saatnya untuk rebuild total.

Apa yang Sistem Asli Lakukan

Sebelum masuk ke detail upgrade, saya jelaskan dulu apa yang dilakukan platform e-learning ini:

Untuk Siswa

• 📊 Dashboard — Lihat kursus yang diikuti dan ujian mendatang
• 📝 Ujian Online — Ikuti ujian berjangka waktu dengan soal pilihan ganda
• 📈 Laporan Nilai — Lihat hasil ujian dan progress keseluruhan
• 💬 Forum Diskusi — Berinteraksi dengan guru dan teman sekelas

Untuk Guru

• 📚 Manajemen Ujian — Buat, edit, dan jadwalkan ujian online
• ❓ Bank Soal — Kelola soal dengan tingkat kesulitan berbeda
• 📊 Analitik — Lihat performa siswa dan identifikasi area yang perlu ditingkatkan
• 📋 Penilaian Tugas — Review dan nilai submission siswa

Strategi Upgrade

Saya mempertimbangkan dua pendekatan:

Saya memilih rebuild total. Alasannya:

1. Loncatannya terlalu jauh — Laravel 5.2 ke 11 melewati 9 major version
2. Arsitektur sudah berevolusi — Laravel modern menggunakan pattern berbeda
3. Tools yang lebih baik sudah ada — Filament, Livewire, dan Inertia belum ada di 2017
4. Kesempatan belajar — Membangun dari nol berarti memahami setiap baris kode

Tech Stack Baru

Berikut yang saya gunakan untuk versi rebuild:

Keputusan Arsitektur Utama

1. Filament untuk Admin Panel

Daripada membangun admin CRUD custom dari nol, saya menggunakan Filament 3. Filament menyediakan:

// Ini saja yang dibutuhkan untuk CRUD lengkap
class ExamResource extends Resource
{
    protected static ?string $model = Exam::class;
    
    public static function form(Form $form): Form
    {
        return $form->schema([
            TextInput::make('title')->required(),
            DateTimePicker::make('start_time'),
            DateTimePicker::make('end_time'),
            Select::make('subject_id')
                ->relationship('subject', 'name'),
        ]);
    }
}

Yang dulu butuh 500+ baris kode custom di 2017, sekarang hanya 50 baris dengan Filament.

2. Livewire untuk Ujian Real-Time

Sistem ujian lama menggunakan JavaScript polling untuk cek sisa waktu. Sekarang dengan Livewire:

class TakeExam extends Component
{
    public Exam $exam;
    public int $timeRemaining;
    
    public function mount(Exam $exam)
    {
        $this->exam = $exam;
        $this->timeRemaining = $exam->duration_minutes * 60;
    }
    
    #[Computed]
    public function isTimeUp(): bool
    {
        return $this->timeRemaining <= 0;
    }
}

Update real-time tanpa menulis kode WebSocket custom.

3. Testing Proper dari Hari Pertama

Codebase asli punya nol test. Versi baru menggunakan Pest PHP:

it('prevents students from taking expired exams', function () {
    $exam = Exam::factory()->expired()->create();
    $student = User::factory()->student()->create();
    
    actingAs($student)
        ->get(route('exams.take', $exam))
        ->assertForbidden();
});

Setiap fitur ditest sebelum dianggap "selesai."

Strategi Migrasi

Bagian paling tricky adalah migrasi data dari sistem lama. Berikut pendekatannya:

Step 1: Export Data Lama

-- Export dari database MySQL lama
SELECT * FROM siswa INTO OUTFILE '/tmp/students.csv';
SELECT * FROM guru INTO OUTFILE '/tmp/teachers.csv';
SELECT * FROM ujian INTO OUTFILE '/tmp/exams.csv';

Step 2: Transform ke Skema Baru

// Laravel Seeder untuk migrasi
class MigrateOldDataSeeder extends Seeder
{
    public function run(): void
    {
        $oldStudents = json_decode(
            file_get_contents(database_path('legacy/students.json'))
        );
        
        foreach ($oldStudents as $old) {
            User::create([
                'name' => $old->nama_siswa,
                'email' => $old->email ?? $old->nis . '@school.local',
                'role' => 'student',
                'legacy_id' => $old->id,
            ]);
        }
    }
}

Step 3: Validasi & Test

Jalankan kedua sistem secara paralel, bandingkan output, dan verifikasi integritas data.

Pelajaran yang Dipetik (Sejauh Ini)

1. Jangan Takut Rebuild

Kadang, refactor terbaik adalah rewrite. Codebase lama sudah menjalankan fungsinya, tapi berpegang padanya hanya akan menimbulkan lebih banyak masalah jangka panjang.

2. Laravel Modern Menyenangkan

Developer experience di Laravel 12 luar biasa. Artisan commands, Tinker, Laravel Herd—semuanya just works.

3. Dokumentasi Sambil Membangun

Saya menulis artikel ini sambil membangun. Ini memaksa saya menjelaskan keputusan saya, yang sering mengungkap cacat dalam pemikiran saya.

Series Tutorial Lengkap

Artikel ini adalah Part 1 dari series lengkap yang mendokumentasikan seluruh rebuild:

Repository

Codebase legacy asli tersedia di GitHub:

🔗 mfarim/laravel-elearning — 42 ⭐ | 15 Forks

Versi baru akan dirilis sebagai repository terpisah setelah siap untuk production.

Kesimpulan

Upgrade aplikasi Laravel berusia 7 tahun bukan hanya soal mengganti nomor versi—ini tentang memikirkan ulang arsitektur, mengadopsi tools modern, dan membangun sesuatu yang akan bertahan 7 tahun ke depan.

Kalau kamu menghadapi tantangan upgrade legacy yang serupa, saya harap series ini bisa membantu. Jangan ragu untuk menghubungi saya dengan pertanyaan atau berbagi pengalaman upgrade kamu sendiri!

Punya aplikasi Laravel legacy yang perlu diupgrade? Saya menawarkan layanan konsultasi untuk modernisasi Laravel. Hubungi saya.