v7.0.0-beta.2 release

This commit is contained in:
HeuJung committed 2026-04-20 20:37:49 +09:00
1 parent 6595fd0eb5
commit fa8eba7a0d
1165 files changed
+107118 -762127

No files matched your search

@@ -1,176 +0,0 @@
<?php
namespace Modules\Sirsoft\Ecommerce\Http\Controllers\Admin;
use App\Helpers\ResponseHelper;
use App\Http\Controllers\Api\Base\AdminBaseController;
use App\Http\Requests\MailTemplate\MailTemplateIndexRequest;
use App\Http\Requests\MailTemplate\MailTemplatePreviewRequest;
use App\Http\Requests\MailTemplate\UpdateMailTemplateRequest;
use App\Http\Resources\MailTemplateCollection;
use App\Http\Resources\MailTemplateResource;
use Modules\Sirsoft\Ecommerce\Models\EcommerceMailTemplate;
use Modules\Sirsoft\Ecommerce\Services\EcommerceMailTemplateService;
use Illuminate\Http\JsonResponse;
/**
* 이커머스 메일 템플릿 관리 컨트롤러
*/
class EcommerceMailTemplateController extends AdminBaseController
{
/**
* EcommerceMailTemplateController 생성자.
*
* @param EcommerceMailTemplateService $service 메일 템플릿 서비스
*/
public function __construct(
private EcommerceMailTemplateService $service
) {
parent::__construct();
}
/**
* 메일 템플릿 목록을 페이지네이션하여 조회합니다.
*
* @param MailTemplateIndexRequest $request 검증된 목록 조회 요청
* @return JsonResponse 페이지네이션된 템플릿 목록
*/
public function index(MailTemplateIndexRequest $request): JsonResponse
{
try {
$filters = array_filter($request->validated(), fn ($value) => $value !== null);
$perPage = (int) ($request->validated('per_page') ?? 20);
$templates = $this->service->getTemplates($filters, $perPage);
$collection = new MailTemplateCollection($templates);
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
'messages.mail_template_fetch_success',
$collection->toArray($request)
);
} catch (\Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.mail_template_fetch_failed',
500
);
}
}
/**
* 메일 템플릿을 수정합니다.
*
* @param UpdateMailTemplateRequest $request 수정 요청
* @param EcommerceMailTemplate $ecommerceMailTemplate 수정 대상
* @return JsonResponse 수정 결과
*/
public function update(UpdateMailTemplateRequest $request, EcommerceMailTemplate $ecommerceMailTemplate): JsonResponse
{
try {
$userId = $request->user()?->id;
$template = $this->service->updateTemplate(
$ecommerceMailTemplate,
$request->validated(),
$userId
);
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
'messages.mail_template_save_success',
new MailTemplateResource($template)
);
} catch (\Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.mail_template_save_error',
500
);
}
}
/**
* 메일 템플릿의 활성 상태를 토글합니다.
*
* @param EcommerceMailTemplate $ecommerceMailTemplate 토글 대상
* @return JsonResponse 토글 결과
*/
public function toggleActive(EcommerceMailTemplate $ecommerceMailTemplate): JsonResponse
{
try {
$template = $this->service->toggleActive($ecommerceMailTemplate);
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
'messages.mail_template_toggle_success',
new MailTemplateResource($template)
);
} catch (\Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.mail_template_toggle_failed',
500
);
}
}
/**
* 메일 템플릿 미리보기를 반환합니다.
*
* @param MailTemplatePreviewRequest $request 검증된 미리보기 요청
* @return JsonResponse 미리보기 결과
*/
public function preview(MailTemplatePreviewRequest $request): JsonResponse
{
try {
$result = $this->service->getPreview($request->validated());
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
'messages.mail_template_preview_success',
$result
);
} catch (\Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.mail_template_preview_failed',
500
);
}
}
/**
* 메일 템플릿을 시더 기본값으로 복원합니다.
*
* @param EcommerceMailTemplate $ecommerceMailTemplate 복원 대상
* @return JsonResponse 복원 결과
*/
public function reset(EcommerceMailTemplate $ecommerceMailTemplate): JsonResponse
{
try {
$defaultData = $this->service->getDefaultTemplateData($ecommerceMailTemplate->type);
if (! $defaultData) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.mail_template_reset_no_default',
404
);
}
$template = $this->service->resetToDefault($ecommerceMailTemplate, $defaultData);
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
'messages.mail_template_reset_success',
new MailTemplateResource($template)
);
} catch (\Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.mail_template_reset_failed',
500
);
}
}
}
@@ -5,6 +5,7 @@ namespace Modules\Sirsoft\Ecommerce\Http\Controllers\Admin;
use App\Helpers\PermissionHelper;
use App\Helpers\ResponseHelper;
use App\Http\Controllers\Api\Base\AdminBaseController;
use App\Seo\Contracts\SeoCacheManagerInterface;
use Exception;
use Illuminate\Http\JsonResponse;
use Modules\Sirsoft\Ecommerce\Http\Requests\Admin\GetSettingRequest;
@@ -14,6 +15,7 @@ use Modules\Sirsoft\Ecommerce\Http\Requests\Admin\UpdateSettingRequest;
use Modules\Sirsoft\Ecommerce\Services\ClaimReasonService;
use Modules\Sirsoft\Ecommerce\Services\EcommerceSettingsService;
use Modules\Sirsoft\Ecommerce\Services\ShippingCarrierService;
use Modules\Sirsoft\Ecommerce\Services\ShippingTypeService;
/**
* 이커머스 모듈 환경설정 컨트롤러
@@ -25,6 +27,7 @@ class EcommerceSettingsController extends AdminBaseController
public function __construct(
private EcommerceSettingsService $settingsService,
private ShippingCarrierService $carrierService,
private ShippingTypeService $shippingTypeService,
private ClaimReasonService $claimReasonService
) {}
@@ -38,6 +41,7 @@ class EcommerceSettingsController extends AdminBaseController
try {
$settings = $this->settingsService->getAllSettings();
$settings = $this->appendCarriersToSettings($settings);
$settings = $this->appendShippingTypesToSettings($settings);
$settings = $this->appendClaimReasonsToSettings($settings);
$settings['available_pg_providers'] = $this->settingsService->getRegisteredPgProviders();
$settings['abilities'] = [
@@ -107,6 +111,13 @@ class EcommerceSettingsController extends AdminBaseController
unset($settings['shipping']['carriers']);
}
// shipping.types는 DB 관리 대상 — JSON 저장에서 제외
$shippingTypes = null;
if (isset($settings['shipping']['types'])) {
$shippingTypes = $settings['shipping']['types'];
unset($settings['shipping']['types']);
}
// claim.refund_reasons는 DB 관리 대상 — JSON 저장에서 제외
$refundReasons = null;
if (isset($settings['claim']['refund_reasons'])) {
@@ -121,6 +132,11 @@ class EcommerceSettingsController extends AdminBaseController
$this->carrierService->syncCarriers($carriers);
}
// shipping types DB 동기화
if ($result && $shippingTypes !== null) {
$this->shippingTypeService->syncShippingTypes($shippingTypes);
}
// claim reasons DB 동기화
if ($result && $refundReasons !== null) {
$this->claimReasonService->syncReasons('refund', $refundReasons);
@@ -130,6 +146,7 @@ class EcommerceSettingsController extends AdminBaseController
// 저장 후 전체 설정 반환 (관리자 UI 상태 업데이트용)
$updatedSettings = $this->settingsService->getAllSettings();
$updatedSettings = $this->appendCarriersToSettings($updatedSettings);
$updatedSettings = $this->appendShippingTypesToSettings($updatedSettings);
$updatedSettings = $this->appendClaimReasonsToSettings($updatedSettings);
$updatedSettings['available_pg_providers'] = $this->settingsService->getRegisteredPgProviders();
@@ -266,6 +283,7 @@ class EcommerceSettingsController extends AdminBaseController
{
try {
$this->settingsService->clearCache();
app(SeoCacheManagerInterface::class)->clearAll();
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
@@ -281,6 +299,66 @@ class EcommerceSettingsController extends AdminBaseController
}
}
/**
* SEO 캐시 정보를 조회합니다.
*
* @return JsonResponse 캐시 페이지 수 및 용량을 포함한 JSON 응답
*/
public function seoCacheInfo(): JsonResponse
{
try {
$cacheManager = app(SeoCacheManagerInterface::class);
$urls = $cacheManager->getCachedUrls();
$count = count($urls);
// 각 캐시 엔트리의 HTML 크기를 합산하여 총 용량 계산
$totalBytes = 0;
foreach ($urls as $url) {
foreach (config('app.supported_locales', ['ko']) as $locale) {
$html = $cacheManager->get($url, $locale);
if ($html !== null) {
$totalBytes += strlen($html);
}
}
}
return ResponseHelper::moduleSuccess(
'sirsoft-ecommerce',
'messages.settings.fetch_success',
[
'count' => $count,
'size_bytes' => $totalBytes,
'size_formatted' => $this->formatBytes($totalBytes),
]
);
} catch (Exception $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.settings.fetch_failed',
500
);
}
}
/**
* 바이트를 사람이 읽기 쉬운 형태로 변환합니다.
*
* @param int $bytes 바이트 수
* @return string 포맷된 문자열 (예: "1.5 MB")
*/
private function formatBytes(int $bytes): string
{
if ($bytes === 0) {
return '0 B';
}
$units = ['B', 'KB', 'MB', 'GB'];
$i = (int) floor(log($bytes, 1024));
$i = min($i, count($units) - 1);
return round($bytes / (1024 ** $i), 1).' '.$units[$i];
}
/**
* 설정 응답에 배송사 목록을 추가합니다.
*
@@ -306,6 +384,21 @@ class EcommerceSettingsController extends AdminBaseController
return $settings;
}
/**
* 설정 응답에 배송유형 목록을 추가합니다.
*
* DB 관리 대상인 shipping types를 shipping 섹션에 포함시킵니다.
*
* @param array $settings 설정 배열
* @return array shipping types가 추가된 설정 배열
*/
private function appendShippingTypesToSettings(array $settings): array
{
$settings['shipping']['types'] = $this->shippingTypeService->getTypesForSettings();
return $settings;
}
/**
* 설정 응답에 클래임 사유 목록을 추가합니다.
*
@@ -8,6 +8,7 @@ use Exception;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Log;
use Modules\Sirsoft\Ecommerce\Exceptions\DuplicateAddressException;
use Modules\Sirsoft\Ecommerce\Http\Requests\User\StoreUserAddressRequest;
use Modules\Sirsoft\Ecommerce\Http\Requests\User\UpdateUserAddressRequest;
use Modules\Sirsoft\Ecommerce\Http\Resources\UserAddressCollection;
@@ -112,8 +113,13 @@ class UserAddressController extends AuthBaseController
return ResponseHelper::success('sirsoft-ecommerce::messages.address.created', [
'address' => new UserAddressResource($address),
], 201);
} catch (\Illuminate\Http\Exceptions\HttpResponseException $e) {
throw $e;
} catch (DuplicateAddressException $e) {
return ResponseHelper::moduleError(
'sirsoft-ecommerce',
'messages.address.name_duplicate',
409,
['duplicate_address_id' => $e->getDuplicateAddressId()]
);
} catch (Exception $e) {
Log::error('User address creation failed', [
'message' => $e->getMessage(),