🚀 Zivar Laravel Starter Kit (zivar/laravel-starter)

Zivar Laravel Starter Kit is an enterprise-ready starter package for modern Laravel applications (Laravel 11, 12, & 13) powered by Livewire 3 SPA (wire:navigate), Tailwind CSS, and Zivar UI Kit.

Designed out of the box with multi-language localization (EN/ID), granular Role-Based Access Control (RBAC), immutable audit logging with visual diff viewer, polymorphic media management with chunked uploads, and real-time system telemetry.

✨ Fitur Utama (Core Features)

📋 Persyaratan Sistem (Requirements)

• PHP: >= 8.3
• Laravel Framework: ^11.0 | ^12.0 | ^13.0
• Livewire: ^3.5 | ^4.0
• Database: MySQL 8.0+ / PostgreSQL 14+ / SQLite 3
• PHP Extensions: pdo, mbstring, openssl, fileinfo, curl

⚡ Panduan Instalasi (Installation)

1. Pasang Package via Composer

Jalankan perintah berikut pada root project Laravel Anda:

composer require zivar/laravel-starter

2. Jalankan Installer Otomatis Zivar

Eksekusi artisan command bawaan Zivar untuk mempublikasikan konfigurasi, asset UI, migrasi database, dan seeder master data:

php artisan zivar:install

Perintah php artisan zivar:install otomatis menjalankan:

1. php artisan vendor:publish --tag=zivar-config --force (Konfigurasi config/zivar.php)
2. php artisan vendor:publish --tag=zivar-assets --force (Aset UI ke public/assets)
3. php artisan vendor:publish --tag=zivar-views --force (Blade views ke resources/views)
4. php artisan vendor:publish --tag=zivar-user-model --force (Model User dengan integrasi RBAC & HasMedia)
5. php artisan storage:link (Symlink storage publik)
6. php artisan migrate (Menjalankan seluruh tabel database)
7. php artisan db:seed --class=Database\Seeders\ZivarDatabaseSeeder (Inisialisasi akun & peranan default)

🔑 Akun & Kredensial Default (Default Logins)

Setelah instalasi selesai, buka browser ke /login:

🧭 Daftar Rute Bawaan (Built-in Routes)

💡 Panduan Penggunaan & Integrasi Kode

1. Pengecekan Hak Akses RBAC pada Controller / Livewire

Gunakan helper method hasPermission() pada model User:

// Mengecek apakah user memiliki izin create pada modul user
if (auth()->user()->hasPermission('user', 'create')) {
    // Jalankan aksi pembuatan user
}

// Mengecek izin delete pada modul role
if (auth()->user()->hasPermission('role', 'delete')) {
    // Jalankan aksi hapus role
}

2. Perekaman Audit Logging Otomatis (Auditable Trait)

Pasang trait Auditable pada Model Eloquent untuk mencatat seluruh perubahan data secara otomatis:

namespace App\Models;

use App\Traits\Auditable;
use Illuminate\Database\Eloquent\Model;

class Article extends Model
{
    use Auditable;

    protected $fillable = ['title', 'slug', 'content', 'status'];
}

3. Pengelolaan Berkas Media Polimorfik (HasMedia Trait)

Pasang trait HasMedia pada Model untuk mengaktifkan lampiran berkas multimedia:

namespace App\Models;

use App\Traits\HasMedia;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use HasMedia;
}

// Melampirkan file yang diunggah ke user (collection: 'avatar', disk: 'public')
$user->attachMedia($uploadedFile, 'avatar', 'public', true);

// Mengambil URL berkas media aktif
$avatarUrl = $user->getMediaUrl('avatar');

🧪 Testing Suite

Jalankan pengujian unit dan integrasi otomatis dengan PHPUnit:

php artisan test

Semua 28 skenario pengujian (RBAC, Audit Log, Media Center, Soft Delete, System Telemetry, dan Language Switcher) terverifikasi 100% lulus.

⚙️ Konfigurasi Kustom (config/zivar.php)

return [
    'name' => 'Zivar System Starter Kit',

    /* Durasi cache hak akses RBAC (Detik) */
    'permissions_cache_ttl' => 3600,

    /* Durasi cache telemetri sistem (Detik) */
    'telemetry_cache_ttl' => 30,

    /* Model yang diizinkan untuk upload berkas */
    'allowed_upload_models' => [
        App\Models\User::class,
        App\Models\Media::class,
    ],
];

📬 Kontak & Pengembang (Author)

• Author: Ravi Zulfikar
• GitHub: github.com/ravizulfikar/zivar-laravel-basic
• Packagist: packagist.org/packages/zivar/laravel-starter
• LinkedIn: linkedin.com/in/ravizulfikar
• WhatsApp: +62 838-9899-9501

📜 Lisensi (License)

Diterbitkan di bawah lisensi MIT License. Bebas digunakan untuk proyek komersial maupun personal.