71 lines
1.9 KiB
PHP
71 lines
1.9 KiB
PHP
<?php
|
|
|
|
namespace Modules\ContractorManagement\Models;
|
|
|
|
use App\Traits\HasPublicIdentifier;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
use Modules\ContractorManagement\Enums\InvoiceStatus;
|
|
use Modules\ApprovalWorkflow\Traits\HasApprovable;
|
|
use Modules\ProjectManagement\Models\Project;
|
|
|
|
class ContractorInvoice extends Model
|
|
{
|
|
use HasApprovable, HasPublicIdentifier;
|
|
|
|
protected $fillable = [
|
|
'contractor_id', 'project_id', 'invoice_number',
|
|
'status', 'amount', 'description',
|
|
'invoice_date', 'due_date', 'paid_at',
|
|
];
|
|
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'status' => InvoiceStatus::class,
|
|
'amount' => 'decimal:2',
|
|
'invoice_date' => 'date',
|
|
'due_date' => 'date',
|
|
'paid_at' => 'datetime',
|
|
];
|
|
}
|
|
|
|
public function contractor(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Contractor::class);
|
|
}
|
|
|
|
public function project(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Project::class);
|
|
}
|
|
|
|
public function payments(): HasMany
|
|
{
|
|
return $this->hasMany(ContractorPayment::class);
|
|
}
|
|
|
|
public function transitionTo(InvoiceStatus $newStatus): void
|
|
{
|
|
$allowed = $this->status->allowedTransitions();
|
|
if (!in_array($newStatus, $allowed)) {
|
|
throw new \InvalidArgumentException(
|
|
"Cannot transition invoice from {$this->status->label()} to {$newStatus->label()}"
|
|
);
|
|
}
|
|
|
|
$updates = ['status' => $newStatus];
|
|
if ($newStatus === InvoiceStatus::Paid) {
|
|
$updates['paid_at'] = now();
|
|
}
|
|
|
|
$this->update($updates);
|
|
}
|
|
|
|
public function getTotalPaidAttribute(): float
|
|
{
|
|
return (float) $this->payments()->sum('amount');
|
|
}
|
|
}
|