[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBK66ZAYMBJE44RSWESY6C":3,"skill-same:01M6CBK66ZAYMBJE44RSWESY6C":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":21,"linkOnly":22,"markdownContent":23,"markdownBody":24,"frontMatter":25,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M6CBK66ZAYMBJE44RSWESY6C","13-shop-catalog",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F28-shop-system\u002F13-shop-catalog\u002FSKILL.md",[],[18,19,20],"shop","catalog","13 shop catalog","2026-11-10 10:12:30",false,"---\nname: 13-shop-catalog\ndescription: `SHOP_CATALOG` 기반 카탈로그 생성\u002F초기화\u002F잠금 해금과 DAILY snapshot 규칙을 정의할 때 사용한다.\n---\n\n# 13-shop-catalog\n\nStatus: ACTIVE\nAppliesTo: v10\n\nShop Catalog는 상점 상품 소스를 카탈로그 타입으로 분리해서 관리한다.\n\n`catalog initialize\u002Frefresh operation`의 정본은 [03-ssot](..\u002F03-ssot\u002FSKILL.md)다.\n이 문서는 카탈로그 데이터 해석 규칙을 다룬다.\n\n---\n\n## 1. Enum\n\n`ENUM_META.json`\n\n```json\nSHOP_CATALOG_TYPE: [NONE, DAILY, CHEST, PURCHASE, GOLD, EVENT]\nSHOP_DISCOUNT_TYPE: [NONE, PER10, PER20, PER30, PER50]\nSHOP_PRODUCT_TYPE: [NONE, FREE, ADS, CURRENCY, PURCHASE]\n```\n\n---\n\n## 2. Table Mapping\n\n- table file: `input\u002FDomains\u002FGame\u002FShopTable.xlsx`\n- 카탈로그 생성 소스: `SHOP_CATALOG`\n- 카탈로그 클래스 매핑:\n  - `DAILY` -> `ShopCatalogDaily`\n  - `CHEST` -> `ShopCatalogChest`\n  - `PURCHASE` -> `ShopCatalogPurchase`\n  - `GOLD` -> `ShopCatalogGold`\n  - `EVENT` -> `ShopCatalogEvent`\n- 카탈로그 상품 테이블 매핑:\n  - `DAILY` -> `SHOP_ITEM_DAILY`\n  - `CHEST` -> `SHOP_ITEM_CHEST`\n  - `PURCHASE` -> `SHOP_ITEM_PURCHASE`\n  - `GOLD` -> `SHOP_ITEM_GOLD`\n  - `EVENT` -> `SHOP_ITEM_EVENT`\n  - `CHEST` progression source -> `SHOP_CATALOG_CHEST`\n\n카탈로그 초기화 라이프사이클:\n\n- `ShopCatalogBase`는 생성자에서 product를 만들지 않는다.\n- `Initialize()`가 1회 실행되며, `onInitialize()`로 1회 setup 후 `RefreshProducts()`를 호출한다.\n- `CreateRuntimeCatalogs(storage)`는 `TB_SHOP_CATALOG.GetAll()`을 읽어 storage-backed runtime catalog를 생성한다.\n- `CreateRuntimeCatalogs(storage)`는 catalog 인스턴스만 만들고, `ShopManager.Initialize()` 경로에서 registry 등록 후 각 catalog `Initialize()`를 호출한다.\n- `Create(...)`는 standalone catalog 생성을 위해 반환 전에 `Initialize()`를 호출해 product 인덱스를 확정한다.\n- `ShopCatalogBase.onRefresh()` 기본 구현은 `CHEST\u002FPURCHASE\u002FGOLD`의 테이블 전체 row를 상품으로 생성하고, 해당 catalog bucket의 remain state를 적용한다.\n- `ShopCatalogDaily.onRefresh()`는 DAILY snapshot 복원 또는 재생성을 처리한다.\n- `ShopCatalogEvent.onRefresh()`는 `SHOP_ITEM_EVENT.start_time\u002Fend_time` 서버 UTC 구간 안의 row만 상품으로 생성한다.\n- 각 catalog 생성자는 자기 전용 `ShopCatalog*StorageData`를 받는다.\n- row -> `ShopProductBase` 변환은 `ShopProductFactory`(15)에서 처리한다.\n\n---\n\n## 3. Refresh Rule\n\n- 일반 카탈로그의 구매 제한 자동 refresh는 `autoRefreshUtcMs`(다음 refresh 시각) + `auto_refresh_days` 기준으로 처리한다.\n- 일반 카탈로그는 `auto_refresh_days \u003C= 0`이면 자동 refresh를 사용하지 않는다.\n- 일반 카탈로그 refresh 완료 시 다음 refresh 시각은 `serverNow + auto_refresh_days`로 갱신한다.\n- `EVENT`는 `auto_refresh_days` 대신 가장 가까운 미래 `start_time\u002Fend_time` 경계 시각을 다음 refresh 시각으로 사용한다.\n- ADS\u002FFREE 상품 리필은 catalog 저장 버킷의 `adsRefreshUtcMs` 기준으로 별도 처리한다.\n- 카탈로그 초기화\u002Frefresh 시 `adsRefreshUtcMs`가 없거나 만료면 ADS\u002FFREE 제한 상품을 `remainCount=max_count`로 리필한다.\n- ADS\u002FFREE 구매 성공 시 `adsRefreshUtcMs = serverNow + 1day`를 기록한다.\n- `SHOP_ITEM_DAILY` 카탈로그 refresh 시에는 저장된 DAILY snapshot을 새 snapshot으로 교체한다.\n- refresh 조건 탐색은 `ShopManager.evaluateCatalogRefreshState(...)` 한 곳에서 처리한다.\n- 카탈로그별 refresh 남은 시간은 catalog runtime 프로퍼티로 조회한다. 공통 값은 `RemainAutoRefreshTimeMs`, DAILY 전용 값은 `RemainAdsRefreshTimeMs`, `ManualRefreshRemainTimeMs`, `ManualRefreshRemainCount`를 사용한다.\n\n---\n\n## 4. Unlock Rule\n\n- `SHOP_CATALOG.unlock_msg_id`가 비어있으면 잠금 없이 사용한다.\n- `SHOP_CATALOG.unlock_msg_id`가 `IsNullOrWhiteSpace`면 unlock 조건 없음으로 간주하며 `IsLocked=false`다.\n- `unlock_msg_id`가 있으면 `IsLocked=true`로 시작한다.\n- `ShopManager`는 `GameMessageManager`를 구독하고 `unlock_op_type\u002Funlock_value` 조건을 평가해 해금한다.\n- 해금 조건 평가는 누적 stat(`GameMessageManager.GetStat(unlock_msg_id)`)으로 수행한다.\n- 조건 만족 시 `IsLocked=false`로 전환된다.\n- 잠긴 카탈로그의 상품은 `CanBuy\u002FBuyAsync`에서 차단된다.\n\n---\n\n## 5. SHOP_ITEM_DAILY Snapshot Rule\n\n- `SHOP_ITEM_DAILY`는 초기화\u002Frefresh 시 최종 snapshot을 생성한다.\n- `currency_type=FREE\u002FADS` row는 고정 상품으로 항상 포함한다.\n- `currency_type!=FREE\u002FADS` row에서 `5개`를 선택 생성한다.\n- 이 규칙은 `auto_refresh_days` 값과 무관하며 `DAILY`의 고유 생성 규칙이다.\n- `select_rate \u003C 0` row는 무조건 포함한다.\n- `select_rate > 0` row만 합산해 가중치 선택한다.\n- `select_rate == 0` row는 선택 후보에서 제외한다.\n- 동일 `shop_item_id`는 중복 선택하지 않는다.\n- 선택된 비고정 5개 중 무작위 3개를 할인 상품으로 선정한다.\n- 할인 선정된 row는 `discount_rate10_per\u002F20Per\u002F30Per\u002F50Per` 합산 가중치로 `SHOP_DISCOUNT_TYPE(PER10\u002FPER20\u002FPER30\u002FPER50)`를 결정한다.\n- 할인 가중치 합이 0 이하면 `SHOP_DISCOUNT_TYPE.NONE`을 사용한다.\n- 각 snapshot row는 `amount_min\u002Famount_max` 범위에서 runtime `amount`를 1회 선택한다.\n- 생성 결과는 storage의 `dailyCatalogProducts(shopId, discountType, remainCount, amount)`로 저장한다.\n- `dailyCatalogProducts`는 DAILY snapshot 전체를 저장한다. `FREE\u002FADS`도 동일 리스트에 포함한다.\n- 저장된 DAILY snapshot이 있으면 그 상태를 복원한다. legacy save처럼 `FREE\u002FADS`가 빠져 있으면 fixed row를 보강해 정규화한다.\n- 저장된 DAILY snapshot의 만료 여부는 `ShopManager`의 시간 기반 refresh 판정에서 결정한다.\n- `SHOP_ITEM_DAILY.unit_price`는 단가다. `ShopProductDaily.PriceWithoutDiscount`는 `unit_price * snapshot.amount`이며, 할인은 그 결과에 적용한다.\n- daily runtime `amount`는 reward 반복 횟수이면서 가격 배수에도 반영된다.\n- daily manual refresh는 광고 시청 성공으로만 가능하며, rolling 24시간 기준 최대 5회다.\n- daily manual refresh의 상태 판단, 광고 호출, 성공 시 `manualRefreshUtcMs\u002FmanualRefreshRemainCount\u002FautoRefreshUtcMs` 갱신은 `ShopCatalogDaily`가 직접 처리한다.\n- `manualRefreshRemainCount`는 남은 횟수이며, 초기값과 만료 후 reset 값은 5다.\n\n---\n\n## 6. Event Catalog Rule\n\n- `catalog=EVENT` 상품 소스는 `SHOP_ITEM_EVENT`다.\n- `ShopCatalogEvent.onRefresh()`는 서버 UTC 현재 시각이 `start_time \u003C= now \u003C end_time`인 row만 생성한다.\n- 다음 refresh 시각은 가장 가까운 미래 `start_time\u002Fend_time` 경계 시각이다.\n- `EVENT`는 DAILY처럼 별도 동적 상품 payload를 저장하지 않는다.\n\n---\n\n## 7. Purchase Catalog Rule\n\n- `catalog=PURCHASE` 상품은 `internal_product_id`를 통해 `PurchaseManager`로 구매한다.\n- 시즌 종료 임박 차단(`season_id`) 검사는 ShopManager에서 수행한다.\n\n---\n\n## 8. Chest Catalog Rule\n\n- `catalog=CHEST` 상품 소스는 `SHOP_ITEM_CHEST`다.\n- chest progression source는 `SHOP_CATALOG_CHEST`다.\n- chest 구매 reward는 `SHOP_ITEM_CHEST.reward_group_id`가 아니라 현재 chest level row의 `reward_ads\u002Freward_paid01\u002Freward_paid10`에서 결정한다.\n- chest exp는 현재 chest level row의 `ads_exp\u002Fgain_exp01\u002Fgain_exp10`을 사용한다.\n- `SHOP_ITEM_CHEST.amount`는 reward 반복 지급 횟수이며 가격에는 곱하지 않는다.\n- 최대 레벨은 `SHOP_CATALOG_CHEST`의 최대 `Level` 값이며, 최대 레벨에서는 `CurrentExp=0`이고 추가 exp를 획득하지 않는다.\n\n---\n\n## 9. Implementation Location (3-path mirror)\n\n- UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FShop\u002FCatalog\u002F`\n- Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FShop\u002FCatalog\u002F`\n- Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Foundation\u002F0.1.0\u002FMobilePackage\u002FRuntime\u002FShop\u002FCatalog\u002F`\n\n파일 구성:\n\n- `ShopCatalogBase.cs` — abstract base, runtime helpers\n- `ShopCatalogFactory.cs` — catalog instance 생성 factory\n- `ShopCatalogEmpty.cs` — empty placeholder (internal)\n- `ShopCatalogDaily.cs` — `FREE\u002FADS + 비고정 5개` snapshot 생성\u002F할인\u002F저장 복원\n- `ShopCatalogEvent.cs` — 시간 구간 필터링\n- `ShopCatalogChest.cs` — CHEST 카탈로그\n- `ShopCatalogPurchase.cs` — PURCHASE 카탈로그\n- `ShopCatalogGold.cs` — GOLD 카탈로그\n\n---\n\n## 10. Related\n\n- [10-shop-manager](..\u002F10-shop-manager\u002FSKILL.md)\n- [11-shop-product](..\u002F11-shop-product\u002FSKILL.md)\n- [12-shop-storage](..\u002F12-shop-storage\u002FSKILL.md)\n- [14-shop-catalog-factory](..\u002F14-shop-catalog-factory\u002FSKILL.md)\n- [15-shop-product-factory](..\u002F15-shop-product-factory\u002FSKILL.md)\n","# 13-shop-catalog\n\nStatus: ACTIVE\nAppliesTo: v10\n\nShop Catalog는 상점 상품 소스를 카탈로그 타입으로 분리해서 관리한다.\n\n`catalog initialize\u002Frefresh operation`의 정본은 [03-ssot](..\u002F03-ssot\u002FSKILL.md)다.\n이 문서는 카탈로그 데이터 해석 규칙을 다룬다.\n\n---\n\n## 1. Enum\n\n`ENUM_META.json`\n\n```json\nSHOP_CATALOG_TYPE: [NONE, DAILY, CHEST, PURCHASE, GOLD, EVENT]\nSHOP_DISCOUNT_TYPE: [NONE, PER10, PER20, PER30, PER50]\nSHOP_PRODUCT_TYPE: [NONE, FREE, ADS, CURRENCY, PURCHASE]\n```\n\n---\n\n## 2. Table Mapping\n\n- table file: `input\u002FDomains\u002FGame\u002FShopTable.xlsx`\n- 카탈로그 생성 소스: `SHOP_CATALOG`\n- 카탈로그 클래스 매핑:\n  - `DAILY` -> `ShopCatalogDaily`\n  - `CHEST` -> `ShopCatalogChest`\n  - `PURCHASE` -> `ShopCatalogPurchase`\n  - `GOLD` -> `ShopCatalogGold`\n  - `EVENT` -> `ShopCatalogEvent`\n- 카탈로그 상품 테이블 매핑:\n  - `DAILY` -> `SHOP_ITEM_DAILY`\n  - `CHEST` -> `SHOP_ITEM_CHEST`\n  - `PURCHASE` -> `SHOP_ITEM_PURCHASE`\n  - `GOLD` -> `SHOP_ITEM_GOLD`\n  - `EVENT` -> `SHOP_ITEM_EVENT`\n  - `CHEST` progression source -> `SHOP_CATALOG_CHEST`\n\n카탈로그 초기화 라이프사이클:\n\n- `ShopCatalogBase`는 생성자에서 product를 만들지 않는다.\n- `Initialize()`가 1회 실행되며, `onInitialize()`로 1회 setup 후 `RefreshProducts()`를 호출한다.\n- `CreateRuntimeCatalogs(storage)`는 `TB_SHOP_CATALOG.GetAll()`을 읽어 storage-backed runtime catalog를 생성한다.\n- `CreateRuntimeCatalogs(storage)`는 catalog 인스턴스만 만들고, `ShopManager.Initialize()` 경로에서 registry 등록 후 각 catalog `Initialize()`를 호출한다.\n- `Create(...)`는 standalone catalog 생성을 위해 반환 전에 `Initialize()`를 호출해 product 인덱스를 확정한다.\n- `ShopCatalogBase.onRefresh()` 기본 구현은 `CHEST\u002FPURCHASE\u002FGOLD`의 테이블 전체 row를 상품으로 생성하고, 해당 catalog bucket의 remain state를 적용한다.\n- `ShopCatalogDaily.onRefresh()`는 DAILY snapshot 복원 또는 재생성을 처리한다.\n- `ShopCatalogEvent.onRefresh()`는 `SHOP_ITEM_EVENT.start_time\u002Fend_time` 서버 UTC 구간 안의 row만 상품으로 생성한다.\n- 각 catalog 생성자는 자기 전용 `ShopCatalog*StorageData`를 받는다.\n- row -> `ShopProductBase` 변환은 `ShopProductFactory`(15)에서 처리한다.\n\n---\n\n## 3. Refresh Rule\n\n- 일반 카탈로그의 구매 제한 자동 refresh는 `autoRefreshUtcMs`(다음 refresh 시각) + `auto_refresh_days` 기준으로 처리한다.\n- 일반 카탈로그는 `auto_refresh_days \u003C= 0`이면 자동 refresh를 사용하지 않는다.\n- 일반 카탈로그 refresh 완료 시 다음 refresh 시각은 `serverNow + auto_refresh_days`로 갱신한다.\n- `EVENT`는 `auto_refresh_days` 대신 가장 가까운 미래 `start_time\u002Fend_time` 경계 시각을 다음 refresh 시각으로 사용한다.\n- ADS\u002FFREE 상품 리필은 catalog 저장 버킷의 `adsRefreshUtcMs` 기준으로 별도 처리한다.\n- 카탈로그 초기화\u002Frefresh 시 `adsRefreshUtcMs`가 없거나 만료면 ADS\u002FFREE 제한 상품을 `remainCount=max_count`로 리필한다.\n- ADS\u002FFREE 구매 성공 시 `adsRefreshUtcMs = serverNow + 1day`를 기록한다.\n- `SHOP_ITEM_DAILY` 카탈로그 refresh 시에는 저장된 DAILY snapshot을 새 snapshot으로 교체한다.\n- refresh 조건 탐색은 `ShopManager.evaluateCatalogRefreshState(...)` 한 곳에서 처리한다.\n- 카탈로그별 refresh 남은 시간은 catalog runtime 프로퍼티로 조회한다. 공통 값은 `RemainAutoRefreshTimeMs`, DAILY 전용 값은 `RemainAdsRefreshTimeMs`, `ManualRefreshRemainTimeMs`, `ManualRefreshRemainCount`를 사용한다.\n\n---\n\n## 4. Unlock Rule\n\n- `SHOP_CATALOG.unlock_msg_id`가 비어있으면 잠금 없이 사용한다.\n- `SHOP_CATALOG.unlock_msg_id`가 `IsNullOrWhiteSpace`면 unlock 조건 없음으로 간주하며 `IsLocked=false`다.\n- `unlock_msg_id`가 있으면 `IsLocked=true`로 시작한다.\n- `ShopManager`는 `GameMessageManager`를 구독하고 `unlock_op_type\u002Funlock_value` 조건을 평가해 해금한다.\n- 해금 조건 평가는 누적 stat(`GameMessageManager.GetStat(unlock_msg_id)`)으로 수행한다.\n- 조건 만족 시 `IsLocked=false`로 전환된다.\n- 잠긴 카탈로그의 상품은 `CanBuy\u002FBuyAsync`에서 차단된다.\n\n---\n\n## 5. SHOP_ITEM_DAILY Snapshot Rule\n\n- `SHOP_ITEM_DAILY`는 초기화\u002Frefresh 시 최종 snapshot을 생성한다.\n- `currency_type=FREE\u002FADS` row는 고정 상품으로 항상 포함한다.\n- `currency_type!=FREE\u002FADS` row에서 `5개`를 선택 생성한다.\n- 이 규칙은 `auto_refresh_days` 값과 무관하며 `DAILY`의 고유 생성 규칙이다.\n- `select_rate \u003C 0` row는 무조건 포함한다.\n- `select_rate > 0` row만 합산해 가중치 선택한다.\n- `select_rate == 0` row는 선택 후보에서 제외한다.\n- 동일 `shop_item_id`는 중복 선택하지 않는다.\n- 선택된 비고정 5개 중 무작위 3개를 할인 상품으로 선정한다.\n- 할인 선정된 row는 `discount_rate10_per\u002F20Per\u002F30Per\u002F50Per` 합산 가중치로 `SHOP_DISCOUNT_TYPE(PER10\u002FPER20\u002FPER30\u002FPER50)`를 결정한다.\n- 할인 가중치 합이 0 이하면 `SHOP_DISCOUNT_TYPE.NONE`을 사용한다.\n- 각 snapshot row는 `amount_min\u002Famount_max` 범위에서 runtime `amount`를 1회 선택한다.\n- 생성 결과는 storage의 `dailyCatalogProducts(shopId, discountType, remainCount, amount)`로 저장한다.\n- `dailyCatalogProducts`는 DAILY snapshot 전체를 저장한다. `FREE\u002FADS`도 동일 리스트에 포함한다.\n- 저장된 DAILY snapshot이 있으면 그 상태를 복원한다. legacy save처럼 `FREE\u002FADS`가 빠져 있으면 fixed row를 보강해 정규화한다.\n- 저장된 DAILY snapshot의 만료 여부는 `ShopManager`의 시간 기반 refresh 판정에서 결정한다.\n- `SHOP_ITEM_DAILY.unit_price`는 단가다. `ShopProductDaily.PriceWithoutDiscount`는 `unit_price * snapshot.amount`이며, 할인은 그 결과에 적용한다.\n- daily runtime `amount`는 reward 반복 횟수이면서 가격 배수에도 반영된다.\n- daily manual refresh는 광고 시청 성공으로만 가능하며, rolling 24시간 기준 최대 5회다.\n- daily manual refresh의 상태 판단, 광고 호출, 성공 시 `manualRefreshUtcMs\u002FmanualRefreshRemainCount\u002FautoRefreshUtcMs` 갱신은 `ShopCatalogDaily`가 직접 처리한다.\n- `manualRefreshRemainCount`는 남은 횟수이며, 초기값과 만료 후 reset 값은 5다.\n\n---\n\n## 6. Event Catalog Rule\n\n- `catalog=EVENT` 상품 소스는 `SHOP_ITEM_EVENT`다.\n- `ShopCatalogEvent.onRefresh()`는 서버 UTC 현재 시각이 `start_time \u003C= now \u003C end_time`인 row만 생성한다.\n- 다음 refresh 시각은 가장 가까운 미래 `start_time\u002Fend_time` 경계 시각이다.\n- `EVENT`는 DAILY처럼 별도 동적 상품 payload를 저장하지 않는다.\n\n---\n\n## 7. Purchase Catalog Rule\n\n- `catalog=PURCHASE` 상품은 `internal_product_id`를 통해 `PurchaseManager`로 구매한다.\n- 시즌 종료 임박 차단(`season_id`) 검사는 ShopManager에서 수행한다.\n\n---\n\n## 8. Chest Catalog Rule\n\n- `catalog=CHEST` 상품 소스는 `SHOP_ITEM_CHEST`다.\n- chest progression source는 `SHOP_CATALOG_CHEST`다.\n- chest 구매 reward는 `SHOP_ITEM_CHEST.reward_group_id`가 아니라 현재 chest level row의 `reward_ads\u002Freward_paid01\u002Freward_paid10`에서 결정한다.\n- chest exp는 현재 chest level row의 `ads_exp\u002Fgain_exp01\u002Fgain_exp10`을 사용한다.\n- `SHOP_ITEM_CHEST.amount`는 reward 반복 지급 횟수이며 가격에는 곱하지 않는다.\n- 최대 레벨은 `SHOP_CATALOG_CHEST`의 최대 `Level` 값이며, 최대 레벨에서는 `CurrentExp=0`이고 추가 exp를 획득하지 않는다.\n\n---\n\n## 9. Implementation Location (3-path mirror)\n\n- UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FShop\u002FCatalog\u002F`\n- Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FShop\u002FCatalog\u002F`\n- Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Foundation\u002F0.1.0\u002FMobilePackage\u002FRuntime\u002FShop\u002FCatalog\u002F`\n\n파일 구성:\n\n- `ShopCatalogBase.cs` — abstract base, runtime helpers\n- `ShopCatalogFactory.cs` — catalog instance 생성 factory\n- `ShopCatalogEmpty.cs` — empty placeholder (internal)\n- `ShopCatalogDaily.cs` — `FREE\u002FADS + 비고정 5개` snapshot 생성\u002F할인\u002F저장 복원\n- `ShopCatalogEvent.cs` — 시간 구간 필터링\n- `ShopCatalogChest.cs` — CHEST 카탈로그\n- `ShopCatalogPurchase.cs` — PURCHASE 카탈로그\n- `ShopCatalogGold.cs` — GOLD 카탈로그\n\n---\n\n## 10. Related\n\n- [10-shop-manager](..\u002F10-shop-manager\u002FSKILL.md)\n- [11-shop-product](..\u002F11-shop-product\u002FSKILL.md)\n- [12-shop-storage](..\u002F12-shop-storage\u002FSKILL.md)\n- [14-shop-catalog-factory](..\u002F14-shop-catalog-factory\u002FSKILL.md)\n- [15-shop-product-factory](..\u002F15-shop-product-factory\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F28-shop-system\u002F13-shop-catalog","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add devwinsoft\u002Fdevian --skill 13-shop-catalog",{"tool":39,"command":40},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 13-shop-catalog",{"tool":42,"command":43},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 13-shop-catalog","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F28-shop-system\u002F13-shop-catalog\u002FSKILL.md",true,[],[48,54,62,70,79,86],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[50],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":21},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[60,61],"archive","90 project archive",{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[68,69],"management","30 env management",{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":21},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[76,77,78],"push","page","19 page push send",{"skillNo":80,"name":81,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":21},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[77,85],"18 page savedata",{"skillNo":87,"name":88,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":21},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[77,92],"17 page deobfuscate"]