Merge pull request #107 from diepxuan/fix/input-khachhang-component

fix: InputKhachhang component và ArDmKh model

Author: caothu159

src/Models/ArDmKh.php

@@ -8,30 +8,93 @@
  * @author     Tran Ngoc Duc <ductn@diepxuan.com>
  * @author     Tran Ngoc Duc <caothu91@gmail.com>
  *
- * @lastupdate 2026-02-27 15:03:13
+ * @lastupdate 2026-03-11 16:15:00
  */
 
 namespace Diepxuan\Simba\Models;
 
-use Diepxuan\Simba\SModel\ArDmKh as Model;
+use Diepxuan\Simba\SModel\ArDmKhModel as Model;
 use Diepxuan\Simba\StoredProcedures\AsGetSoDuKh;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
+/**
+ * Model ArDmKh - Danh mục khách hàng.
+ *
+ * Mở rộng từ ArDmKhModel với các scope và helper methods.
+ */
 class ArDmKh extends Model
 {
-    protected $casts = [
-        'isKh'  => 'boolean',
-        'isNcc' => 'boolean',
-        'isNv'  => 'boolean',
-    ];
+    /**
+     * Boot model và thêm global scopes.
+     */
+    protected static function booted(): void
+    {
+        parent::booted();
+
+        // Global scope: mặc định chỉ lấy các bản ghi đang sử dụng (ksd = true)
+        static::addGlobalScope('ksd', static function (Builder $query): void {
+            $query->where('ksd', true);
+        });
+    }
+
+    /**
+     * Scope: Chỉ lấy khách hàng (isKh = true).
+     */
+    public function scopeLaKhachHang(Builder $query): Builder
+    {
+        return $query->where('isKh', true);
+    }
+
+    /**
+     * Scope: Chỉ lấy nhà cung cấp (isNcc = true).
+     */
+    public function scopeLaNhaCungCap(Builder $query): Builder
+    {
+        return $query->where('isNcc', true);
+    }
+
+    /**
+     * Scope: Chỉ lấy nhân viên (isNv = true).
+     */
+    public function scopeLaNhanVien(Builder $query): Builder
+    {
+        return $query->where('isNv', true);
+    }
+
+    /**
+     * Scope: Tìm kiếm theo mã khách hàng hoặc tên.
+     */
+    public function scopeSearch(Builder $query, string $search): Builder
+    {
+        return $query->where(static function (Builder $q) use ($search): void {
+            $q->where('ma_kh', 'like', "%{$search}%")
+                ->orWhere('ten_kh', 'like', "%{$search}%")
+                ->orWhere('dia_chi', 'like', "%{$search}%")
+                ->orWhere('tel', 'like', "%{$search}%");
+        });
+    }
+
+    /**
+     * Scope: Sắp xếp theo mã khách hàng.
+     */
+    public function scopeOrderByMaKh(Builder $query): Builder
+    {
+        return $query->orderBy('ma_kh');
+    }
 
+    /**
+     * Quan hệ với GlCt (chi tiết sổ cái).
+     */
     public function glCts(): HasMany
     {
         return $this->hasMany(GlCt::class, 'ma_kh', 'ma_kh');
     }
 
     /**
      * Gọi stored procedure AsGetSoDuKh để lấy số dư khách hàng.
+     *
+     * @param array $params Tham số: pMa_Cty, pMa_kh/pMa_Kh, pNgay, pTk
      */
     public static function AsGetSoDuKh(array $params): float
     {
@@ -43,16 +106,25 @@ public static function AsGetSoDuKh(array $params): float
         ]);
     }
 
+    /**
+     * Accessor: Kiểm tra có phải khách hàng không.
+     */
     public function getIsKhachHangAttribute(): bool
     {
         return (bool) $this->isKh;
     }
 
+    /**
+     * Accessor: Kiểm tra có phải nhà cung cấp không.
+     */
     public function getIsNhaCungCapAttribute(): bool
     {
         return (bool) $this->isNcc;
     }
 
+    /**
+     * Accessor: Kiểm tra có phải nhân viên không.
+     */
     public function getIsNhanVienAttribute(): bool
     {
         return (bool) $this->isNv;

src/SModel/ArDmKhModel.php

@@ -1,12 +1,34 @@
 <?php
 
+declare(strict_types=1);
+
+/*
+ * @copyright  © 2019 Dxvn, Inc.
+ *
+ * @author     Tran Ngoc Duc <ductn@diepxuan.com>
+ * @author     Tran Ngoc Duc <caothu91@gmail.com>
+ *
+ * @lastupdate 2026-03-11 16:10:00
+ */
+
 namespace Diepxuan\Simba\SModel;
 
-use Illuminate\Database\Eloquent\Model;
 use Diepxuan\Simba\SModel\SModel;
 
+/**
+ * Model ArDmKh - Danh mục khách hàng.
+ *
+ * Gộp từ ArDmKh.php và ArDmKhModel.php
+ */
 class ArDmKhModel extends SModel
 {
+    /**
+     * Indicates if the IDs are auto-incrementing.
+     *
+     * @var bool
+     */
+    public $incrementing = false;
+
     /**
      * The table associated with the model.
      *
@@ -15,18 +37,26 @@ class ArDmKhModel extends SModel
     protected $table = 'ArDmKh';
 
     /**
-     * The primary key for the model.
+     * The primary key associated with the table.
+     *
+     * @var string
+     */
+    protected $primaryKey = 'ma_kh';
+
+    /**
+     * The "type" of the primary key ID.
      *
      * @var string
      */
-    protected $primaryKey = 'ma_cty';
+    protected $keyType = 'string';
 
     /**
      * Indicates if the model should be timestamped.
      *
      * @var bool
      */
-    public $timestamps = false;
+    public const CREATED_AT = 'cdate';
+    public const UPDATED_AT = 'ldate';
 
     /**
      * The attributes that are mass assignable.
@@ -72,7 +102,7 @@ class ArDmKhModel extends SModel
         'cdate',
         'cuser',
         'ldate',
-        'luser'
+        'luser',
     ];
 
     /**
@@ -81,17 +111,17 @@ class ArDmKhModel extends SModel
      * @var array
      */
     protected $casts = [
-        'gh_no' => 'float',
-        'han_ck' => 'float',
-        'tl_ck' => 'float',
-        'han_tt' => 'float',
-        'ls_qh' => 'float',
+        'gh_no'      => 'float',
+        'han_ck'     => 'float',
+        'tl_ck'      => 'float',
+        'han_tt'     => 'float',
+        'ls_qh'      => 'float',
         'tinh_dt_nb' => 'boolean',
-        'isKh' => 'boolean',
-        'isNcc' => 'boolean',
-        'isNv' => 'boolean',
-        'ksd' => 'boolean',
-        'cdate' => 'datetime',
-        'ldate' => 'datetime',
+        'isKh'       => 'boolean',
+        'isNcc'      => 'boolean',
+        'isNv'       => 'boolean',
+        'ksd'        => 'boolean',
+        'cdate'      => 'datetime',
+        'ldate'      => 'datetime',
     ];
 }