HeuJung
1ba67ca7cf
공개 이슈 https://github.com/gnuboard/g7/issues/22 — 본문에 삽입한 이미지가 카드/갤러리 목록 썸네일과 공유 미리보기(og:image)에 반영되지 않던 공백을 코어+3모듈+2템플릿에서 해소. - 코어 7.0.9: HtmlImageExtractor(내부 이미지 한정, origin 정규화 SSoT 재사용) + seo.og_image_default 사이트 기본 공유 이미지 설정 + SeoMetaResolver 폴백 체인 - board 1.1.0 / ecommerce 1.2.0 / page 1.1.0: content_thumbnail_url 캐시 컬럼, saving 추출(html 모드 한정·첨부 우선·비밀글 게이트 유지), filter_content_thumbnail 훅, 기존 데이터 백필 업그레이드 스텝 - ecommerce 카테고리 og:image 생산자 신설, page og:description 死키 정정 - sirsoft-basic 1.1.2 og 바인딩 정정, admin_basic 1.0.7 SEO 탭 업로더(+ja 팩 2종) - 검수 중 발견한 text 모드 오캐시 결함은 실패 테스트 선행 후 수정
269 lines
11 KiB
PHP
269 lines
11 KiB
PHP
<?php
|
|
|
|
namespace Modules\Sirsoft\Ecommerce\Tests\Unit;
|
|
|
|
use App\Extension\ModuleManager;
|
|
use Modules\Sirsoft\Ecommerce\Module;
|
|
use Modules\Sirsoft\Ecommerce\Tests\ModuleTestCase;
|
|
|
|
/**
|
|
* EcommerceModule SEO declaration 회귀 테스트.
|
|
*
|
|
* 회귀: 상품 다국어 컬럼이 MariaDB 환경에서 array 로 전달될 때
|
|
* "Array to string conversion" → SeoMiddleware catch → SPA fallback (모든 봇 미리보기 미출력).
|
|
*/
|
|
class EcommerceModuleSeoTest extends ModuleTestCase
|
|
{
|
|
private Module $module;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
$this->module = app(ModuleManager::class)->getModule('sirsoft-ecommerce')
|
|
?? new Module(base_path('modules/sirsoft-ecommerce'));
|
|
}
|
|
|
|
/**
|
|
* 회귀: 상품 name/description 이 다국어 JSON array 일 때 throw 없이 정상 추출.
|
|
*/
|
|
public function test_product_seo_og_defaults_handles_multilingual_array(): void
|
|
{
|
|
app()->setLocale('ko');
|
|
|
|
$context = [
|
|
'product' => [
|
|
'data' => [
|
|
'name' => ['ko' => '에어맥스', 'en' => 'AirMax'],
|
|
'thumbnail_url' => 'https://example.com/p.jpg',
|
|
'selling_price' => 129000,
|
|
],
|
|
],
|
|
];
|
|
|
|
$og = $this->module->seoOgDefaults('product', $context);
|
|
|
|
$this->assertSame('에어맥스', $og['image_alt']);
|
|
$this->assertSame('https://example.com/p.jpg', $og['image']);
|
|
}
|
|
|
|
/**
|
|
* 회귀: thumbnail_url 이 상대 경로(/api/...) 일 때 og:image 가 절대 URL 로 변환.
|
|
*
|
|
* 슬랙·페이스북·쓰레드 모두 og:image 는 절대 URL 필수. 상대 경로 출력 시 이미지 미표시.
|
|
*/
|
|
public function test_product_seo_og_defaults_image_is_absolute_url(): void
|
|
{
|
|
$context = [
|
|
'product' => [
|
|
'data' => [
|
|
'name' => '가죽 크로스백',
|
|
'thumbnail_url' => '/api/modules/sirsoft-ecommerce/product-image/abc123',
|
|
],
|
|
],
|
|
];
|
|
|
|
$og = $this->module->seoOgDefaults('product', $context);
|
|
|
|
$this->assertArrayHasKey('image', $og);
|
|
$this->assertStringStartsWith('http', $og['image'], 'og:image 는 절대 URL 이어야 페이스북·슬랙·쓰레드가 인식합니다');
|
|
$this->assertStringContainsString('/api/modules/sirsoft-ecommerce/product-image/abc123', $og['image']);
|
|
}
|
|
|
|
/**
|
|
* 카테고리 og:image 출력 레벨 — thumbnail_url 이 있으면 image 가 절대 URL 로 방출된다.
|
|
*
|
|
* @scenario product-content-thumbnail-fallback
|
|
*
|
|
* @effects category_og_image_emitted_from_thumbnail_url
|
|
*/
|
|
public function test_category_seo_og_defaults_emits_image_from_thumbnail_url(): void
|
|
{
|
|
$context = [
|
|
'category' => [
|
|
'data' => [
|
|
'name' => ['ko' => '아우터', 'en' => 'Outer'],
|
|
'thumbnail_url' => '/api/modules/sirsoft-ecommerce/category-image/cat123',
|
|
],
|
|
],
|
|
];
|
|
|
|
$og = $this->module->seoOgDefaults('category', $context);
|
|
|
|
$this->assertArrayHasKey('image', $og);
|
|
$this->assertStringStartsWith('http', $og['image'], 'og:image 는 절대 URL 이어야 공유 카드가 인식합니다');
|
|
$this->assertStringContainsString('/api/modules/sirsoft-ecommerce/category-image/cat123', $og['image']);
|
|
$this->assertSame('아우터', $og['image_alt']);
|
|
}
|
|
|
|
/**
|
|
* 카테고리 og:image 출력 레벨 — 이미지 없는 카테고리는 image 키 자체가 미출력된다
|
|
* (빈 값은 array_filter 로 제거 → 코어 사이트 기본 OG 이미지 폴백에 위임).
|
|
*
|
|
* @scenario product-content-thumbnail-fallback
|
|
*
|
|
* @effects category_og_image_omitted_without_thumbnail
|
|
*/
|
|
public function test_category_seo_og_defaults_omits_image_without_thumbnail(): void
|
|
{
|
|
$context = [
|
|
'category' => [
|
|
'data' => [
|
|
'name' => '아우터',
|
|
'thumbnail_url' => null,
|
|
],
|
|
],
|
|
];
|
|
|
|
$og = $this->module->seoOgDefaults('category', $context);
|
|
|
|
$this->assertArrayNotHasKey('image', $og);
|
|
$this->assertSame('website', $og['type']);
|
|
}
|
|
|
|
/**
|
|
* 회귀: 상품 structured_data 도 다국어 array 안전 처리.
|
|
*/
|
|
public function test_product_structured_data_handles_multilingual_array(): void
|
|
{
|
|
app()->setLocale('ko');
|
|
|
|
$context = [
|
|
'product' => [
|
|
'data' => [
|
|
'name' => ['ko' => '에어맥스', 'en' => 'AirMax'],
|
|
'description' => ['ko' => '한국어 설명', 'en' => 'English description'],
|
|
'thumbnail_url' => 'https://example.com/p.jpg',
|
|
'selling_price' => 129000,
|
|
'sales_status' => 'on_sale',
|
|
],
|
|
],
|
|
];
|
|
|
|
$schema = $this->module->seoStructuredData('product', $context);
|
|
|
|
$this->assertSame('Product', $schema['@type']);
|
|
$this->assertSame('에어맥스', $schema['name']);
|
|
$this->assertSame('한국어 설명', $schema['description']);
|
|
$this->assertSame('129000', $schema['offers']['price']);
|
|
}
|
|
|
|
/**
|
|
* seoOgDefaultMeta 가 데이터 경로(연결 칩) + 다국어 라벨을 선언한다.
|
|
*/
|
|
public function test_product_seo_og_default_meta_declares_data_path_and_label(): void
|
|
{
|
|
$meta = $this->module->seoOgDefaultMeta('product');
|
|
|
|
// label 은 번역 키(언어팩 대응) — __() 로 해석돼 한국어로 표시된다.
|
|
$this->assertSame('{{product.data.thumbnail_url}}', $meta['image']['expr']);
|
|
$this->assertSame('sirsoft-ecommerce::seo.auto_value.product_image', $meta['image']['label']);
|
|
$this->assertSame('상품 대표 이미지', __($meta['image']['label'], [], 'ko'));
|
|
$this->assertSame('Product image', __($meta['image']['label'], [], 'en'));
|
|
$this->assertSame('{{product.data.name}}', $meta['image_alt']['expr']);
|
|
|
|
// category 도 자기 데이터 경로 선언.
|
|
$catMeta = $this->module->seoOgDefaultMeta('category');
|
|
$this->assertSame('{{category.data.thumbnail_url}}', $catMeta['image']['expr']);
|
|
|
|
// 도메인 외 page_type 은 빈 배열(평문 폴백).
|
|
$this->assertSame([], $this->module->seoOgDefaultMeta('shop_index'));
|
|
}
|
|
|
|
/**
|
|
* seoStructuredDataMeta 가 점 경로 키별 데이터 경로를 선언한다.
|
|
*/
|
|
public function test_product_structured_data_meta_declares_dotted_paths(): void
|
|
{
|
|
$meta = $this->module->seoStructuredDataMeta('product');
|
|
|
|
// 제목/설명은 사용자 입력 meta(다국어) 우선 + 상품 필드 폴백 구조다.
|
|
// $localized() 로 현재 로케일 문자열을 뽑으므로 언어별 SEO 분기가 성립한다.
|
|
$this->assertSame(
|
|
'{{$localized(product.data.meta_title) ?? $localized(product.data.name)}}',
|
|
$meta['name']['expr']
|
|
);
|
|
$this->assertSame(
|
|
'{{$localized(product.data.meta_description) ?? $localized(product.data.short_description)}}',
|
|
$meta['description']['expr']
|
|
);
|
|
|
|
// 다국어 대상이 아닌 값은 점 경로를 그대로 선언한다.
|
|
$this->assertSame('{{product.data.selling_price}}', $meta['offers.price']['expr']);
|
|
$this->assertSame('{{product.data.sku}}', $meta['sku']['expr']);
|
|
}
|
|
|
|
/**
|
|
* 정합성: 메타가 선언한 키는 운영 declaration 이 산출 가능한 키여야 한다(키 드리프트 차단).
|
|
* og.image/image_alt 는 declaration 키 집합에 존재해야 하고, structured 점 경로는 평탄화한
|
|
* declaration 키에 존재해야 한다(파생값 제외는 허용 — 메타 ⊆ declaration).
|
|
*/
|
|
public function test_meta_keys_are_subset_of_declaration_keys(): void
|
|
{
|
|
$context = [
|
|
'product' => [
|
|
'data' => [
|
|
'name' => '키정합 상품',
|
|
'short_description' => '설명',
|
|
'thumbnail_url' => 'https://example.com/p.jpg',
|
|
'sku' => 'SKU-1',
|
|
'selling_price' => 1000,
|
|
],
|
|
],
|
|
];
|
|
|
|
$ogKeys = array_keys($this->module->seoOgDefaults('product', $context));
|
|
foreach (array_keys($this->module->seoOgDefaultMeta('product')) as $metaKey) {
|
|
$this->assertContains($metaKey, $ogKeys, "og 메타 키 '{$metaKey}' 는 declaration 키여야 합니다");
|
|
}
|
|
|
|
$flatStructured = $this->flattenKeys($this->module->seoStructuredData('product', $context));
|
|
foreach (array_keys($this->module->seoStructuredDataMeta('product')) as $metaKey) {
|
|
$this->assertContains($metaKey, $flatStructured, "structured 메타 키 '{$metaKey}' 는 declaration 평탄 키여야 합니다");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 결함(라이브 검수 2026-06-14): structured offers.availability 가 존재하지 않는 'in_stock' 키를
|
|
* 참조해 **모든 상품이 OutOfStock** 으로 출력됨. ProductResource 실제 키는 sales_status(enum value)
|
|
* 와 stock_quantity. sales_status='on_sale' → InStock 이어야 한다.
|
|
*/
|
|
public function test_product_structured_availability_uses_sales_status_not_missing_in_stock_key(): void
|
|
{
|
|
$base = [
|
|
'name' => '재고 상품',
|
|
'selling_price' => 1000,
|
|
];
|
|
|
|
// 판매중(on_sale) → InStock.
|
|
$onSale = $this->module->seoStructuredData('product', ['product' => ['data' => $base + ['sales_status' => 'on_sale', 'stock_quantity' => 320]]]);
|
|
$this->assertSame('https://schema.org/InStock', $onSale['offers']['availability'], '판매중 상품은 InStock');
|
|
|
|
// 품절(sold_out) → OutOfStock.
|
|
$soldOut = $this->module->seoStructuredData('product', ['product' => ['data' => $base + ['sales_status' => 'sold_out', 'stock_quantity' => 0]]]);
|
|
$this->assertSame('https://schema.org/OutOfStock', $soldOut['offers']['availability'], '품절 상품은 OutOfStock');
|
|
|
|
// 판매중지(suspended) → OutOfStock.
|
|
$suspended = $this->module->seoStructuredData('product', ['product' => ['data' => $base + ['sales_status' => 'suspended']]]);
|
|
$this->assertSame('https://schema.org/OutOfStock', $suspended['offers']['availability'], '판매중지 상품은 OutOfStock');
|
|
}
|
|
|
|
/** 중첩 배열을 점 경로 키 목록으로 평탄화(@type/@context 제외). */
|
|
private function flattenKeys(array $block, string $prefix = ''): array
|
|
{
|
|
$out = [];
|
|
foreach ($block as $k => $v) {
|
|
if ($k === '@type' || $k === '@context') {
|
|
continue;
|
|
}
|
|
$path = $prefix === '' ? (string) $k : "{$prefix}.{$k}";
|
|
if (is_array($v) && ! array_is_list($v)) {
|
|
$out = array_merge($out, $this->flattenKeys($v, $path));
|
|
} else {
|
|
$out[] = $path;
|
|
}
|
|
}
|
|
|
|
return $out;
|
|
}
|
|
}
|