Files
Gnuboard7/modules/_bundled/sirsoft-ecommerce/src/Http/Resources/MileageTransactionResource.php
T
HeuJung 52ee8c855a chore(release): 공개 소스 본문 내부 단서(· 호칭) 정리
공개 release 발행 시 파일 본문 누출 검사(check-public-release-leakage)에
걸리던 내부 단서를 정리해 발행을 차단하지 않도록 함.

- 코드/테스트 주석·문서 본문의 "" 규정 인용을 "코어 규정/규칙" 등
 중립 표현으로 치환 (코어·이커머스·board·kginicis·gdpr·pay·템플릿 전 영역)
- 내부 역할 호칭 ""/""를 문맥에 맞는 중립 표현으로 일반화
- config/app.php 의 보호경로 목록(G7_UPDATE_PROTECTED_PATHS) 내 파일명은
 기능 코드이므로 삭제 대신 검사기 화이트리스트에 등록

주석/설명 문자열/문서 본문만 변경 — 로직·데이터·동작 무변경.
검증: 누출 재검사 error 0 / warn 0, 영향 테스트 TS 140/140·PHP 113/113 통과.
2026-07-02 17:58:33 +09:00

137 lines
6.9 KiB
PHP

<?php
namespace Modules\Sirsoft\Ecommerce\Http\Resources;
use App\Http\Resources\BaseApiResource;
use Illuminate\Http\Request;
use Modules\Sirsoft\Ecommerce\Enums\MileageTransactionTypeEnum;
use Modules\Sirsoft\Ecommerce\Http\Resources\Traits\HasMultiCurrencyPrices;
use Modules\Sirsoft\Ecommerce\Models\MileageTransaction;
/**
* 마일리지 거래 리소스
*
* @property MileageTransaction $resource
*/
class MileageTransactionResource extends BaseApiResource
{
use HasMultiCurrencyPrices;
/**
* 행 레벨 능력(can_*) 매핑을 반환합니다.
*
* DataGrid 행 액션('수동 조정')의 disabledField('abilities.can_manage')가
* 각 행 데이터의 abilities.can_manage 를 참조하므로, 컬렉션 레벨과 동일한
* 능력을 행 단위로도 노출합니다.
*
* @return array<string, string> 능력 매핑
*/
protected function abilityMap(): array
{
return [
'can_manage' => 'sirsoft-ecommerce.mileage.manage',
];
}
/**
* 리소스를 배열로 변환합니다.
*
* @param Request $request 요청
* @return array 변환된 배열
*/
public function toArray(Request $request): array
{
$type = $this->resource->type instanceof MileageTransactionTypeEnum
? $this->resource->type
: MileageTransactionTypeEnum::tryFrom((string) $this->resource->type);
$isEarning = $type?->isEarning() ?? false;
$earnAmount = (float) $this->resource->amount;
// 마일리지 금액 표기 통화 — 거래에 기록된 통화(없으면 기본 통화)의 소수 자릿수를 따른다.
$mileageCurrency = $this->resource->currency ?: $this->getDefaultCurrencyCode();
// 소멸액(이 적립 lot 을 source 로 한 expired 거래 합 — paginateWithFilters 에서 eager 집계).
// 단건 조회(연결 거래 등 집계 미주입) 시에는 0 으로 폴백.
$expiredAmount = $this->resource->expired_amount !== null ? (float) $this->resource->expired_amount : 0.0;
// 소멸 상태: 적립계만 의미가 있다. fully(전액 소멸) / partial(일부 소멸) / active(미소멸)
$expiryState = 'active';
if ($isEarning && $expiredAmount > 0) {
$expiryState = ($expiredAmount + 0.001) >= $earnAmount ? 'fully_expired' : 'partial_expired';
}
// 기간 변경 가능: 적립계 + 미소멸 + 잔여 > 0 (소멸/전액사용 lot 은 만료일 변경 불가, memo 만 편집)
$canEditExpiry = $isEarning
&& $this->resource->expired_at === null
&& (float) $this->resource->remaining_amount > 0;
return [
'id' => $this->resource->id,
'user_id' => $this->resource->user_id,
'currency' => $this->resource->currency,
'type' => $type?->value,
'type_label' => $type?->label(),
'admin_badge_group' => $type?->adminBadgeGroup(),
'user_display_category' => $type?->userDisplayCategory(),
'amount' => $this->roundToCurrency($this->resource->amount, $mileageCurrency),
'amount_formatted' => $this->formatCurrencyPrice((float) $this->resource->amount, $mileageCurrency),
'remaining_amount' => $this->roundToCurrency($this->resource->remaining_amount, $mileageCurrency),
'remaining_amount_formatted' => $this->formatCurrencyPrice((float) $this->resource->remaining_amount, $mileageCurrency),
'balance_after' => $this->roundToCurrency($this->resource->balance_after, $mileageCurrency),
'order_id' => $this->resource->order_id,
'order_option_id' => $this->resource->order_option_id,
'order_cancel_id' => $this->resource->order_cancel_id,
'source_transaction_id' => $this->resource->source_transaction_id,
'granted_by' => $this->resource->granted_by,
'granted_by_name' => $this->whenLoaded('grantedByUser', fn () => $this->resource->grantedByUser?->name),
'granted_by_uuid' => $this->whenLoaded('grantedByUser', fn () => $this->resource->grantedByUser?->uuid),
'user_name' => $this->whenLoaded('user', fn () => $this->resource->user?->name),
'user_uuid' => $this->whenLoaded('user', fn () => $this->resource->user?->uuid),
'order_number' => $this->whenLoaded('order', fn () => $this->resource->order?->order_number),
'description' => $this->resource->description,
'memo' => $this->resource->memo,
'expires_at' => $this->resource->expires_at?->toIso8601String(), // audit:allow datetime-display-user-timezone reason: paired with *_formatted user-tz field
'expires_at_formatted' => $this->formatDateTimeStringForUser($this->resource->expires_at),
'expires_at_date' => $this->formatDateStringForSite($this->resource->expires_at),
'expired_at' => $this->resource->expired_at?->toIso8601String(), // audit:allow datetime-display-user-timezone reason: paired with *_formatted user-tz field
'expired_at_formatted' => $this->formatDateTimeStringForUser($this->resource->expired_at),
'created_at' => $this->resource->created_at?->toIso8601String(), // audit:allow datetime-display-user-timezone reason: paired with *_formatted user-tz field
'created_at_formatted' => $this->formatDateTimeStringForUser($this->resource->created_at),
'created_at_date' => $this->formatDateStringForSite($this->resource->created_at),
// 적립계 여부 + 소멸 집계 (행 편집 게이팅 + 일부/전체 소멸 표시 — B-3)
'is_earning' => $isEarning,
'can_edit_expiry' => $canEditExpiry,
'expired_amount' => $this->roundToCurrency($expiredAmount, $mileageCurrency),
'expired_amount_formatted' => $this->formatCurrencyPrice($expiredAmount, $mileageCurrency),
'expiry_state' => $expiryState,
// 행 레벨 권한 메타 (abilities.can_manage + can_edit) — DataGrid 행 액션 disabled 제어
...$this->resourceMeta($request),
];
}
/**
* 행 레벨 능력을 계산합니다.
*
* 표준 can_manage 에 더해, 행 편집 메뉴('사유·기간 변경') 게이팅용 can_edit 를 노출합니다.
* can_edit = manage 권한 보유 && 적립계 거래 (비적립계 행은 메뉴 비활성 — 합의 C-2).
*
* @param Request $request HTTP 요청
* @return array<string, bool> 능력 불리언 맵
*/
protected function resolveAbilities(Request $request): array
{
$abilities = parent::resolveAbilities($request);
$type = $this->resource->type instanceof MileageTransactionTypeEnum
? $this->resource->type
: MileageTransactionTypeEnum::tryFrom((string) $this->resource->type);
$abilities['can_edit'] = (bool) ($abilities['can_manage'] ?? false) && ($type?->isEarning() ?? false);
return $abilities;
}
}