Files
sam-api/app/Models/CategoryGroup.php
권혁성 189b38c936 feat: Auditable 트레이트 구현 및 97개 모델 적용
- Auditable 트레이트 신규 생성 (bootAuditable 패턴)
  - creating: created_by/updated_by 자동 채우기
  - updating: updated_by 자동 채우기
  - deleting: deleted_by 채우기 + saveQuietly()
  - created/updated/deleted: audit_logs 자동 기록
- 기존 AuditLogger 패턴과 동일한 try/catch 조용한 실패
- 변경된 필드만 before/after 기록 (updated 이벤트)
- auditExclude 프로퍼티로 모델별 제외 필드 설정 가능
- 제외 대상: Attendance, StockTransaction, TodayIssue 등 고빈도/시스템 모델

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:33:54 +09:00

135 lines
3.5 KiB
PHP
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
namespace App\Models;
use App\Models\Tenants\Tenant;
use App\Traits\Auditable;
use App\Traits\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* 카테고리 그룹 모델
*
* 품목 카테고리별 단가 계산 방식(면적/중량/수량 기반) 분류
* MNG 시뮬레이터와 동기화를 위한 핵심 테이블
*/
class CategoryGroup extends Model
{
use Auditable, BelongsToTenant;
protected $table = 'category_groups';
protected $fillable = [
'tenant_id',
'code',
'name',
'multiplier_variable',
'categories',
'description',
'sort_order',
'is_active',
];
protected function casts(): array
{
return [
'categories' => 'array',
'sort_order' => 'integer',
'is_active' => 'boolean',
];
}
/**
* 단가 계산 방식 상수
*/
public const CODE_AREA_BASED = 'area_based'; // 면적 기반 (M)
public const CODE_WEIGHT_BASED = 'weight_based'; // 중량 기반 (K)
public const CODE_QUANTITY_BASED = 'quantity_based'; // 수량 기반 (null)
/**
* 곱셈 변수 상수
*/
public const MULTIPLIER_AREA = 'M'; // 면적 (㎡)
public const MULTIPLIER_WEIGHT = 'K'; // 중량 (kg)
/**
* 테넌트 관계
*/
public function tenant(): BelongsTo
{
return $this->belongsTo(Tenant::class);
}
/**
* 품목 카테고리로 해당 그룹 조회
*
* @param int $tenantId 테넌트 ID
* @param string $itemCategory 품목분류 (원단, 패널, 도장 등)
*/
public static function findByItemCategory(int $tenantId, string $itemCategory): ?self
{
return static::where('tenant_id', $tenantId)
->where('is_active', true)
->whereJsonContains('categories', $itemCategory)
->first();
}
/**
* 곱셈 변수 값 계산
*
* @param array $variables 계산 변수 배열 ['M' => 6.099, 'K' => 25.5, ...]
* @return float 곱셈 값 (없으면 1)
*/
public function getMultiplierValue(array $variables): float
{
if (empty($this->multiplier_variable)) {
return 1.0;
}
return (float) ($variables[$this->multiplier_variable] ?? 1.0);
}
/**
* 단가 계산
*
* @param float $basePrice 기본 단가
* @param array $variables 계산 변수 배열
* @return array ['final_price' => float, 'calculation_note' => string, 'multiplier' => float]
*/
public function calculatePrice(float $basePrice, array $variables): array
{
$multiplier = $this->getMultiplierValue($variables);
if ($multiplier === 1.0) {
return [
'final_price' => $basePrice,
'calculation_note' => '수량단가',
'multiplier' => 1.0,
];
}
$unit = match ($this->multiplier_variable) {
self::MULTIPLIER_AREA => '㎡',
self::MULTIPLIER_WEIGHT => 'kg',
default => '',
};
return [
'final_price' => $basePrice * $multiplier,
'calculation_note' => sprintf(
'%s (%s원/%s × %.3f%s)',
$this->name,
number_format($basePrice),
$unit,
$multiplier,
$unit
),
'multiplier' => $multiplier,
];
}
}