mirror of
https://github.com/InvoiceShelf/InvoiceShelf.git
synced 2026-04-15 09:14:08 +00:00
Complete the type modernization across all models. Adds Builder-typed $query parameters and return types to all scope methods, typed parameters on accessors, and PHPDoc on scopePaginateData/scopeApplyFilters. Models updated: Address, EstimateItem, Expense, ExpenseCategory, InvoiceItem, Item, Note, Tax, TaxType, Unit. 5 models needed no changes (Country, Currency, ImpersonationLog, Module, UserSetting) as they had no untyped public methods.
147 lines
3.8 KiB
PHP
147 lines
3.8 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use Carbon\Carbon;
|
|
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
|
|
class Item extends Model
|
|
{
|
|
use HasFactory;
|
|
|
|
protected $guarded = ['id'];
|
|
|
|
protected $appends = [
|
|
'formattedCreatedAt',
|
|
];
|
|
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'price' => 'integer',
|
|
];
|
|
}
|
|
|
|
public function unit(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Unit::class, 'unit_id');
|
|
}
|
|
|
|
public function company(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Company::class);
|
|
}
|
|
|
|
public function creator(): BelongsTo
|
|
{
|
|
return $this->belongsTo(User::class, 'creator_id');
|
|
}
|
|
|
|
public function currency(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Currency::class);
|
|
}
|
|
|
|
public function scopeWhereSearch(Builder $query, string $search): Builder
|
|
{
|
|
return $query->where('items.name', 'LIKE', '%'.$search.'%');
|
|
}
|
|
|
|
public function scopeWherePrice(Builder $query, int $price): Builder
|
|
{
|
|
return $query->where('items.price', $price);
|
|
}
|
|
|
|
public function scopeWhereUnit(Builder $query, int $unit_id): Builder
|
|
{
|
|
return $query->where('items.unit_id', $unit_id);
|
|
}
|
|
|
|
public function scopeWhereOrder(Builder $query, string $orderByField, string $orderBy): void
|
|
{
|
|
$query->orderBy($orderByField, $orderBy);
|
|
}
|
|
|
|
public function scopeWhereItem(Builder $query, int $item_id): void
|
|
{
|
|
$query->orWhere('id', $item_id);
|
|
}
|
|
|
|
/**
|
|
* Apply multiple filter conditions including search, price, unit, item, and ordering.
|
|
*/
|
|
public function scopeApplyFilters(Builder $query, array $filters): void
|
|
{
|
|
$filters = collect($filters);
|
|
|
|
if ($filters->get('search')) {
|
|
$query->whereSearch($filters->get('search'));
|
|
}
|
|
|
|
if ($filters->get('price')) {
|
|
$query->wherePrice($filters->get('price'));
|
|
}
|
|
|
|
if ($filters->get('unit_id')) {
|
|
$query->whereUnit($filters->get('unit_id'));
|
|
}
|
|
|
|
if ($filters->get('item_id')) {
|
|
$query->whereItem($filters->get('item_id'));
|
|
}
|
|
|
|
if ($filters->get('orderByField') || $filters->get('orderBy')) {
|
|
$field = $filters->get('orderByField') ? $filters->get('orderByField') : 'name';
|
|
$orderBy = $filters->get('orderBy') ? $filters->get('orderBy') : 'asc';
|
|
$query->whereOrder($field, $orderBy);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return LengthAwarePaginator|Collection
|
|
*/
|
|
public function scopePaginateData(Builder $query, string $limit)
|
|
{
|
|
if ($limit == 'all') {
|
|
return $query->get();
|
|
}
|
|
|
|
return $query->paginate($limit);
|
|
}
|
|
|
|
public function getFormattedCreatedAtAttribute(mixed $value): string
|
|
{
|
|
$dateFormat = CompanySetting::getSetting('carbon_date_format', request()->header('company'));
|
|
|
|
return Carbon::parse($this->created_at)->translatedFormat($dateFormat);
|
|
}
|
|
|
|
public function taxes(): HasMany
|
|
{
|
|
return $this->hasMany(Tax::class)
|
|
->where('invoice_item_id', null)
|
|
->where('estimate_item_id', null);
|
|
}
|
|
|
|
public function scopeWhereCompany(Builder $query): void
|
|
{
|
|
$query->where('items.company_id', request()->header('company'));
|
|
}
|
|
|
|
public function invoiceItems(): HasMany
|
|
{
|
|
return $this->hasMany(InvoiceItem::class);
|
|
}
|
|
|
|
public function estimateItems(): HasMany
|
|
{
|
|
return $this->hasMany(EstimateItem::class);
|
|
}
|
|
}
|