zidnyal-hikammawarist / rapidstrat

v1.1.1 2026-10-04 15:02 UTC

Requires

• php: ^8.2
• illuminate/console: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Suggests

• barryvdh/laravel-dompdf: Diperlukan untuk fitur cetak laporan PDF (composer require barryvdh/laravel-dompdf)

MIT

• Zidny Al-Hikam Mawarist

Published on Packagist.org on 2026-10-04 15:04 UTC

README

RapidStrat adalah starter scaffolding package untuk ekosistem Laravel yang dirancang untuk mempercepat perakitan fondasi aplikasi berbasis peran (Multi-Role Auth), tata letak antarmuka modern (Tailwind CSS Admin Panel), laporan siap cetak (PDF Export Engine), kalkulasi logika bisnis (rumus kasir, denda perpustakaan, rental), serta blueprint CRUD yang terdokumentasi rapi untuk kebutuhan sertifikasi kompetensi (UjiKom UKK RPL & Asesmen LSP BNSP).

🌟 Fitur Utama

• 🔐 Multi-Role Authentication: Sistem login & registrasi dengan pemisahan peran bawaan (admin, petugas, user).
• 🛡️ Role Guard Middleware: Middleware CheckRole yang aman dan mudah diterapkan pada rute aplikasi.
• 🖥️ Tailwind CSS Admin Panel: Tampilan dashboard responsif, modern, dan estetik dengan sidebar dinamis, kartu metrik statistik, dan notifikasi SweetAlert2 (termasuk validasi form error).
• 📄 Universal PDF Report Engine: Filter rentang tanggal otomatis dengan kop surat resmi instansi, tanda tangan penanggung jawab, serta fallback cetak langsung browser (window.print).
• 📦 CRUD Blueprint Stubs: Template controller, formulir input, dan tabel manajemen data yang siap disesuaikan untuk berbagai studi kasus (Buku, Mobil, Barang, Pengaduan, dll).
• 🧮 Contekan Rumus Logika Bisnis: Panduan siap pakai untuk kalkulasi kasir (subtotal, diskon, PPN 11%, kembalian), denda keterlambatan buku (Carbon::diffInDays), dan durasi rental mobil.
• 🔗 Panduan Relasi Database Eloquent: Contoh relasi One-to-Many (hasMany, belongsTo) lengkap dengan Eager Loading (with) untuk mencegah masalah performa N+1 query.
• 🏆 Peta Jawaban 8 Unit Kompetensi SKKNI BNSP: Panduan lisan resmi untuk menjawab pertanyaan asesor LSP Tematik Nusantara (Skema Pemrograman Web).
• 📖 Dokumentasi & Komentar Kode Bersih: Setiap baris kode controller, model, dan view dilengkapi komentar terstruktur dan berbobot (clean code) yang menjadi nilai tambah besar saat pengujian.
• 🔌 Kesiapan Mode Offline: Disertai panduan antisipasi jika ujian dilakukan di lab komputer sekolah tanpa koneksi internet.

📥 Panduan Instalasi

1. Pasang Package via Composer

Jalankan perintah berikut di proyek Laravel Anda:

composer require zidnyal-hikammawarist/rapidstrat

2. Jalankan Installer Interaktif

Jalankan artisan command untuk memilih modul yang ingin Anda pasang:

php artisan rapidstrat:install

Pilih modul sesuai kebutuhan atau tekan Enter untuk memasang paket lengkap (Full Package).

3. Migrasi & Seeder Database

php artisan migrate
php artisan db:seed --class=UserRoleSeeder

(Catatan: Pendaftaran middleware role di bootstrap/app.php sudah ditangani secara otomatis oleh installer).

🔑 Akun Demo Pengujian Bawaan

• Admin: [e-mail] (Password: password)
• Petugas: [e-mail] (Password: password)
• User: [e-mail] (Password: password)

🔌 Kesiapan UjiKom Mode Offline (Tanpa Internet)

Jika lab sekolah mematikan koneksi internet saat ujian:

1. Pastikan aset CSS/JS lokal (Tailwind & FontAwesome) tersimpan di folder public/.
2. Jika belum menginstal barryvdh/laravel-dompdf, fitur laporan RapidStrat secara otomatis beralih ke dialog cetak browser (window.print) yang menghasilkan dokumen cetak A4 yang sama rapinya.
3. Panduan lengkap dan contekan jawaban penguji tersedia di file ./PANDUAN_UJIKOM.md.

📄 Lisensi

Package ini dirilis di bawah lisensi MIT License.
Dikembangkan oleh Zidny Al-Hikam Mawarist.