287 lines
9.3 KiB
PHP
287 lines
9.3 KiB
PHP
<?php
|
|
|
|
namespace Modules\Sirsoft\Ecommerce\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
|
|
/**
|
|
* 배송정책 모델
|
|
*
|
|
* 국가별 설정은 countrySettings 관계를 통해 관리됩니다.
|
|
*/
|
|
class ShippingPolicy extends Model
|
|
{
|
|
use HasFactory;
|
|
|
|
/** @var array<string, array> 활동 로그 추적 필드 */
|
|
public static array $activityLogFields = [
|
|
'is_default' => ['label_key' => 'sirsoft-ecommerce::activity_log.fields.is_default', 'type' => 'boolean'],
|
|
'is_active' => ['label_key' => 'sirsoft-ecommerce::activity_log.fields.is_active', 'type' => 'boolean'],
|
|
'sort_order' => ['label_key' => 'sirsoft-ecommerce::activity_log.fields.sort_order', 'type' => 'number'],
|
|
];
|
|
|
|
protected $table = 'ecommerce_shipping_policies';
|
|
|
|
protected $fillable = [
|
|
'name',
|
|
'is_default',
|
|
'is_active',
|
|
'sort_order',
|
|
'created_by',
|
|
'updated_by',
|
|
];
|
|
|
|
protected $casts = [
|
|
'name' => 'array',
|
|
'is_default' => 'boolean',
|
|
'is_active' => 'boolean',
|
|
'sort_order' => 'integer',
|
|
];
|
|
|
|
/**
|
|
* 이 정책에 연결된 국가별 배송 설정 관계.
|
|
*
|
|
* @return HasMany ShippingPolicyCountrySetting 컬렉션 관계
|
|
*/
|
|
public function countrySettings(): HasMany
|
|
{
|
|
return $this->hasMany(ShippingPolicyCountrySetting::class);
|
|
}
|
|
|
|
/**
|
|
* 현재 로케일의 정책명을 반환합니다 (다국어 fallback chain 적용).
|
|
*
|
|
* @param string|null $locale 반환할 로케일. null 이면 현재 앱 로케일 사용
|
|
* @return string 로케일별 정책명, 누락 시 fallback 로케일/첫 번째 키 순으로 시도
|
|
*/
|
|
public function getLocalizedName(?string $locale = null): string
|
|
{
|
|
$locale = $locale ?? app()->getLocale();
|
|
$name = $this->name;
|
|
|
|
return $name[$locale] ?? $name[config('app.fallback_locale', 'ko')] ?? $name[array_key_first($name)] ?? '';
|
|
}
|
|
|
|
/**
|
|
* 활성 국가별 설정을 종합하여 배송비 요약 텍스트를 생성합니다.
|
|
*
|
|
* 형식: `"KR: 3000원 | US: $20"` 처럼 country_code + 국가별 fee summary 를 ` | ` 로 join.
|
|
*
|
|
* @return string 국가별 배송비 요약 (활성 설정 없으면 빈 문자열)
|
|
*/
|
|
public function getFeeSummary(): string
|
|
{
|
|
$settings = $this->relationLoaded('countrySettings')
|
|
? $this->countrySettings
|
|
: $this->countrySettings()->where('is_active', true)->get();
|
|
|
|
if ($settings->isEmpty()) {
|
|
return '';
|
|
}
|
|
|
|
$summaries = $settings->map(function (ShippingPolicyCountrySetting $setting) {
|
|
return $setting->country_code.': '.$setting->getFeeSummary();
|
|
});
|
|
|
|
return $summaries->implode(' | ');
|
|
}
|
|
|
|
/**
|
|
* 활성 국가별 설정의 상세 배송비 정보를 배열로 반환합니다.
|
|
*
|
|
* 각 항목: `['country_code' => 'KR', ...국가별 상세 fee 필드...]`.
|
|
* Frontend 가 표 형태로 표시할 때 사용.
|
|
*
|
|
* @return array<int, array<string, mixed>> 국가별 상세 배송비 정보 배열
|
|
*/
|
|
public function getDetailedFeeInfo(): array
|
|
{
|
|
$settings = $this->relationLoaded('countrySettings')
|
|
? $this->countrySettings
|
|
: $this->countrySettings()->where('is_active', true)->get();
|
|
|
|
return $settings->map(function (ShippingPolicyCountrySetting $setting) {
|
|
return [
|
|
'country_code' => $setting->country_code,
|
|
...$setting->getDetailedFeeInfo(),
|
|
];
|
|
})->toArray();
|
|
}
|
|
|
|
/**
|
|
* 활성 국가 코드를 국기 이모지로 변환한 표시 문자열을 반환합니다.
|
|
*
|
|
* `$limit` 초과분은 `+N` 형태로 축약 (예: `🇰🇷🇺🇸🇨🇳 +2`).
|
|
*
|
|
* @param int $limit 국기로 표시할 최대 국가 개수 (초과분은 +N 표기)
|
|
* @return string 국기 이모지 + 잔여 카운트 문자열
|
|
*/
|
|
public function getCountriesWithFlags(int $limit = 3): string
|
|
{
|
|
$settings = $this->relationLoaded('countrySettings')
|
|
? $this->countrySettings
|
|
: $this->countrySettings()->where('is_active', true)->get();
|
|
|
|
$countryCodes = $settings->pluck('country_code')->toArray();
|
|
|
|
$flags = [
|
|
'KR' => "\u{1F1F0}\u{1F1F7}",
|
|
'US' => "\u{1F1FA}\u{1F1F8}",
|
|
'CN' => "\u{1F1E8}\u{1F1F3}",
|
|
'JP' => "\u{1F1EF}\u{1F1F5}",
|
|
];
|
|
|
|
$displayed = array_slice($countryCodes, 0, $limit);
|
|
$remaining = count($countryCodes) - $limit;
|
|
|
|
$result = implode('', array_map(fn ($code) => $flags[$code] ?? $code, $displayed));
|
|
|
|
if ($remaining > 0) {
|
|
$result .= " +{$remaining}";
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* 특정 국가의 배송 설정을 조회합니다.
|
|
*
|
|
* @param string $countryCode ISO 국가 코드 (예: 'KR', 'US')
|
|
* @return ShippingPolicyCountrySetting|null 해당 국가 설정 또는 부재 시 null
|
|
*/
|
|
public function getCountrySetting(string $countryCode): ?ShippingPolicyCountrySetting
|
|
{
|
|
$settings = $this->relationLoaded('countrySettings')
|
|
? $this->countrySettings
|
|
: $this->countrySettings()->get();
|
|
|
|
return $settings
|
|
->where('country_code', $countryCode)
|
|
->where('is_active', true)
|
|
->first();
|
|
}
|
|
|
|
/**
|
|
* 우편번호가 도서산간 지역인지 확인하고 추가배송비를 반환합니다.
|
|
* (KR countrySettings에서 조회)
|
|
*
|
|
* @param string|null $zipcode 우편번호
|
|
* @return int 추가배송비 (도서산간 아닌 경우 0)
|
|
*/
|
|
public function getExtraFeeForZipcode(?string $zipcode): int
|
|
{
|
|
$krSetting = $this->getCountrySetting('KR');
|
|
|
|
if (! $krSetting) {
|
|
return 0;
|
|
}
|
|
|
|
return $krSetting->getExtraFeeForZipcode($zipcode);
|
|
}
|
|
|
|
/**
|
|
* 우편번호가 도서산간 지역인지 확인합니다.
|
|
*
|
|
* @param string|null $zipcode 우편번호
|
|
* @return bool 도서산간 지역 여부
|
|
*/
|
|
public function isRemoteArea(?string $zipcode): bool
|
|
{
|
|
return $this->getExtraFeeForZipcode($zipcode) > 0;
|
|
}
|
|
|
|
/**
|
|
* 활성 정책 스코프
|
|
*
|
|
* @param \Illuminate\Database\Eloquent\Builder $query
|
|
* @return \Illuminate\Database\Eloquent\Builder
|
|
*/
|
|
public function scopeActive($query)
|
|
{
|
|
return $query->where('is_active', true);
|
|
}
|
|
|
|
/**
|
|
* countrySettings 의 shipping_method 가 주어진 값 중 하나 이상에 매치되는 정책만 반환하는 스코프.
|
|
*
|
|
* @param \Illuminate\Database\Eloquent\Builder $query
|
|
* @param array<int, string> $methods 필터링할 배송방법 코드 배열
|
|
* @return \Illuminate\Database\Eloquent\Builder
|
|
*/
|
|
public function scopeWithShippingMethods($query, array $methods)
|
|
{
|
|
if (empty($methods)) {
|
|
return $query;
|
|
}
|
|
|
|
return $query->whereHas('countrySettings', function ($sub) use ($methods) {
|
|
$sub->whereIn('shipping_method', $methods);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* countrySettings 의 charge_policy 가 주어진 값 중 하나 이상에 매치되는 정책만 반환하는 스코프.
|
|
*
|
|
* @param \Illuminate\Database\Eloquent\Builder $query
|
|
* @param array<int, string> $policies 필터링할 부과정책 코드 배열
|
|
* @return \Illuminate\Database\Eloquent\Builder
|
|
*/
|
|
public function scopeWithChargePolicies($query, array $policies)
|
|
{
|
|
if (empty($policies)) {
|
|
return $query;
|
|
}
|
|
|
|
return $query->whereHas('countrySettings', function ($sub) use ($policies) {
|
|
$sub->whereIn('charge_policy', $policies);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* 다국어 정책명(name JSON 컬럼) 의 모든 활성 locale 에서 검색어를 LIKE 매칭하는 스코프.
|
|
*
|
|
* @param \Illuminate\Database\Eloquent\Builder $query
|
|
* @param string $search 검색 키워드 (빈 문자열이면 노필터)
|
|
* @return \Illuminate\Database\Eloquent\Builder
|
|
*/
|
|
public function scopeSearchByName($query, string $search)
|
|
{
|
|
if (empty($search)) {
|
|
return $query;
|
|
}
|
|
|
|
return $query->where(function ($q) use ($search) {
|
|
$locales = config('app.translatable_locales', ['ko', 'en']);
|
|
foreach ($locales as $index => $locale) {
|
|
if ($index === 0) {
|
|
$q->where("name->{$locale}", 'like', "%{$search}%");
|
|
} else {
|
|
$q->orWhere("name->{$locale}", 'like', "%{$search}%");
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* 정렬 스코프
|
|
*
|
|
* @param \Illuminate\Database\Eloquent\Builder $query
|
|
* @return \Illuminate\Database\Eloquent\Builder
|
|
*
|
|
* @param string $sortBy sort by
|
|
* @param string $sortOrder sort order
|
|
*/
|
|
public function scopeOrderByField($query, string $sortBy = 'created_at', string $sortOrder = 'desc')
|
|
{
|
|
$allowedFields = ['id', 'name', 'is_active', 'sort_order', 'created_at', 'updated_at'];
|
|
|
|
if (! in_array($sortBy, $allowedFields)) {
|
|
$sortBy = 'created_at';
|
|
}
|
|
|
|
return $query->orderBy($sortBy, $sortOrder);
|
|
}
|
|
}
|