feat(webstatement): tambah migration dan model ProvinceCore
Perubahan yang dilakukan: - Membuat migration untuk tabel province_core dengan field code dan name. - Menambahkan model ProvinceCore dengan beberapa scope dan method helper. - Mengimplementasikan logging untuk semua operasi database yang berkaitan. - Menambahkan dukungan transaction rollback untuk menjaga integritas data. - Membuat seeder untuk data provinsi seluruh Indonesia. - Menambahkan validasi dan method utility untuk keperluan dropdown. - Menggunakan PostgreSQL ILIKE untuk pencarian yang bersifat case-insensitive. - Menambahkan index pada kolom tertentu untuk optimasi performa query. - Mengimplementasikan event model untuk memantau operasi CRUD. - Menyesuaikan struktur file agar sesuai dengan arsitektur Laravel modules. Tujuan perubahan: - Menyediakan data master provinsi yang dapat digunakan secara global. - Memastikan efisiensi dan keamanan data pada proses insert/update. - Mendukung pengembangan fitur yang membutuhkan referensi data provinsi.
This commit is contained in:
Daeng Deni Mardaeni
161
app/Models/ProvinceCore.php
Normal file
161
app/Models/ProvinceCore.php
Normal file
@@ -0,0 +1,161 @@
|
||||
<?php
|
||||
|
||||
namespace Modules\Webstatement\Models;
|
||||
|
||||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
|
||||
class ProvinceCore extends Model
|
||||
{
|
||||
use HasFactory;
|
||||
|
||||
/**
|
||||
* Nama tabel yang digunakan oleh model
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $table = 'province_core';
|
||||
|
||||
/**
|
||||
* Field yang dapat diisi secara mass assignment
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $fillable = [
|
||||
'code',
|
||||
'name',
|
||||
];
|
||||
|
||||
/**
|
||||
* Field yang di-cast ke tipe data tertentu
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected $casts = [
|
||||
'created_at' => 'datetime',
|
||||
'updated_at' => 'datetime',
|
||||
];
|
||||
|
||||
/**
|
||||
* Scope untuk mencari berdasarkan kode provinsi
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query
|
||||
* @param string $code
|
||||
* @return \Illuminate\Database\Eloquent\Builder
|
||||
*/
|
||||
public function scopeByCode($query, $code)
|
||||
{
|
||||
Log::info('ProvinceCore: Mencari provinsi dengan kode: ' . $code);
|
||||
return $query->where('code', $code);
|
||||
}
|
||||
|
||||
/**
|
||||
* Scope untuk mencari berdasarkan nama provinsi
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query
|
||||
* @param string $name
|
||||
* @return \Illuminate\Database\Eloquent\Builder
|
||||
*/
|
||||
public function scopeByName($query, $name)
|
||||
{
|
||||
Log::info('ProvinceCore: Mencari provinsi dengan nama: ' . $name);
|
||||
return $query->where('name', 'ILIKE', '%' . $name . '%');
|
||||
}
|
||||
|
||||
/**
|
||||
* Scope untuk mendapatkan semua provinsi yang aktif
|
||||
*
|
||||
* @param \Illuminate\Database\Eloquent\Builder $query
|
||||
* @return \Illuminate\Database\Eloquent\Builder
|
||||
*/
|
||||
public function scopeActive($query)
|
||||
{
|
||||
Log::info('ProvinceCore: Mengambil semua provinsi aktif');
|
||||
return $query->orderBy('name', 'asc');
|
||||
}
|
||||
|
||||
/**
|
||||
* Mendapatkan provinsi berdasarkan kode
|
||||
*
|
||||
* @param string $code
|
||||
* @return ProvinceCore|null
|
||||
*/
|
||||
public static function getByCode($code)
|
||||
{
|
||||
try {
|
||||
Log::info('ProvinceCore: Mengambil provinsi dengan kode: ' . $code);
|
||||
return self::byCode($code)->first();
|
||||
} catch (\Exception $e) {
|
||||
Log::error('ProvinceCore: Error mengambil provinsi dengan kode ' . $code . ': ' . $e->getMessage());
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Mendapatkan semua provinsi untuk dropdown/select
|
||||
*
|
||||
* @return \Illuminate\Database\Eloquent\Collection
|
||||
*/
|
||||
public static function getForDropdown()
|
||||
{
|
||||
try {
|
||||
Log::info('ProvinceCore: Mengambil data provinsi untuk dropdown');
|
||||
return self::active()->pluck('name', 'code');
|
||||
} catch (\Exception $e) {
|
||||
Log::error('ProvinceCore: Error mengambil data dropdown provinsi: ' . $e->getMessage());
|
||||
return collect();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Validasi kode provinsi
|
||||
*
|
||||
* @param string $code
|
||||
* @return bool
|
||||
*/
|
||||
public static function isValidCode($code)
|
||||
{
|
||||
try {
|
||||
Log::info('ProvinceCore: Validasi kode provinsi: ' . $code);
|
||||
return self::byCode($code)->exists();
|
||||
} catch (\Exception $e) {
|
||||
Log::error('ProvinceCore: Error validasi kode provinsi ' . $code . ': ' . $e->getMessage());
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Boot method untuk model events
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
protected static function boot()
|
||||
{
|
||||
parent::boot();
|
||||
|
||||
static::creating(function ($model) {
|
||||
Log::info('ProvinceCore: Membuat data provinsi baru dengan kode: ' . $model->code);
|
||||
});
|
||||
|
||||
static::created(function ($model) {
|
||||
Log::info('ProvinceCore: Data provinsi berhasil dibuat dengan ID: ' . $model->id);
|
||||
});
|
||||
|
||||
static::updating(function ($model) {
|
||||
Log::info('ProvinceCore: Mengupdate data provinsi dengan ID: ' . $model->id);
|
||||
});
|
||||
|
||||
static::updated(function ($model) {
|
||||
Log::info('ProvinceCore: Data provinsi berhasil diupdate dengan ID: ' . $model->id);
|
||||
});
|
||||
|
||||
static::deleting(function ($model) {
|
||||
Log::info('ProvinceCore: Menghapus data provinsi dengan ID: ' . $model->id);
|
||||
});
|
||||
|
||||
static::deleted(function ($model) {
|
||||
Log::info('ProvinceCore: Data provinsi berhasil dihapus dengan ID: ' . $model->id);
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,64 @@
|
||||
<?php
|
||||
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Illuminate\Support\Facades\Log;
|
||||
use Illuminate\Support\Facades\Schema;
|
||||
use Illuminate\Database\Schema\Blueprint;
|
||||
use Illuminate\Database\Migrations\Migration;
|
||||
|
||||
return new class extends Migration
|
||||
{
|
||||
/**
|
||||
* Menjalankan migrasi untuk membuat tabel province_core
|
||||
* Tabel ini menyimpan data master provinsi dengan kode dan nama
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function up(): void
|
||||
{
|
||||
DB::beginTransaction();
|
||||
|
||||
try {
|
||||
Schema::create('province_core', function (Blueprint $table) {
|
||||
$table->id();
|
||||
$table->string('code', 10)->unique()->comment('Kode provinsi unik');
|
||||
$table->string('name', 255)->comment('Nama provinsi');
|
||||
$table->timestamps();
|
||||
|
||||
// Index untuk performa pencarian
|
||||
$table->index(['code']);
|
||||
$table->index(['name']);
|
||||
});
|
||||
|
||||
DB::commit();
|
||||
Log::info('Migration province_core table berhasil dibuat');
|
||||
|
||||
} catch (\Exception $e) {
|
||||
DB::rollback();
|
||||
Log::error('Migration province_core table gagal: ' . $e->getMessage());
|
||||
throw $e;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Membalikkan migrasi dengan menghapus tabel province_core
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
public function down(): void
|
||||
{
|
||||
DB::beginTransaction();
|
||||
|
||||
try {
|
||||
Schema::dropIfExists('province_core');
|
||||
|
||||
DB::commit();
|
||||
Log::info('Migration rollback province_core table berhasil');
|
||||
|
||||
} catch (\Exception $e) {
|
||||
DB::rollback();
|
||||
Log::error('Migration rollback province_core table gagal: ' . $e->getMessage());
|
||||
throw $e;
|
||||
}
|
||||
}
|
||||
};
|
||||
Reference in New Issue
Block a user