[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBHKHP766EM7FD83EBE1ZG":3,"skill-same:01M6CBHKHP766EM7FD83EBE1ZG":150},{"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":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBHKHP766EM7FD83EBE1ZG","03-ssot",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\u002F22-inventory-system\u002F03-ssot\u002FSKILL.md",[],[18],"03 ssot","2026-11-10 10:12:30",false,"# 03-ssot — 22-inventory-system (SSOT)\n\n\nStatus: ACTIVE\nAppliesTo: v10\n\n\n## 이 문서가 정본이다 (SSOT)\n\n- RewardData 적용 규칙(Inventory 관점)\n- 인벤토리 상태 표현(개념)\n- Apply 원자성\u002F에러 처리 규칙\n\n\n---\n\n\n## A) RewardData Contract Source (정본)\n\n- `RewardData` 스키마의 단일 정본은 아래 문서다:\n  - [49-reward-system\u002F03-ssot](..\u002F..\u002F49-reward-system\u002F03-ssot\u002FSKILL.md)\n- 본 문서(22-inventory-system)는 `RewardData` 필드 스키마를 재정의하지 않는다.\n- Inventory는 위 정본 규약을 입력 계약으로 사용한다.\n\n\n---\n\n\n## B) Inventory State (개념)\n\nInventory 상태는 \"통화\", \"아이템(장비\u002F카드\u002F재료)\", \"영웅\", \"Treasure\"로 분리된다.\n\n### B-1) Wallet\n\n- key: `currency_type` (=`RewardData.id` when `type=REWARD_TYPE.CURRENCY`)\n- value: `amount (long)`\n\n### B-2) Equips\n\n- key: `itemUid` (string, GUID, 인스턴스별 고유 pk)\n- value: `AbilityItemEquip`\n\n`AbilityItemEquip` 필드 (구현: [12-game-ability](..\u002F..\u002F..\u002F21-game-package\u002F12-game-ability\u002FSKILL.md)):\n- `ItemUid: string` (== key, 인스턴스 고유 ID, GUID)\n- `ItemId: string` (템플릿 ID, `mTable.item_id`)\n- `OwnerUnitId: string` (장착된 영웅 ItemId, 미장착 시 empty)\n- `OwnerSlotType: EQUIP_SLOT_TYPE` (장착 슬롯 enum, `NONE` = 미장착)\n- `IsEquipped: bool` (= `OwnerSlotType != EQUIP_SLOT_TYPE.NONE`)\n- 능력치: `AbilityItemEquip : AbilityItemBase : AbilityBase` → `mStats[UNIT_STAT_TYPE.X]` (UNIT_STAT_TYPE 기반 정규화)\n  - 레벨 = `UNIT_STAT_TYPE.ITEM_LEVEL`\n\nNOTE:\n- 같은 `item_id`에 여러 인스턴스(각각 고유 `itemUid`)가 존재할 수 있다.\n- `RewardData.Id`는 `item_id`(템플릿 ID)이다. `itemUid`는 InventoryManager가 Apply 시 생성한다.\n- `ItemData` 클래스는 `AbilityItemEquip`에 통합되어 삭제되었다.\n- `InventoryManager.EquippedItems` \u002F `UnequippedItems`는 이 equip SSOT에서 파생된 runtime view다. 별도 저장 정본이 아니다.\n- `InventoryManager.UnownedEquipItems`는 `TB_ITEM_EQUIP.GetAll()`과 현재 owned equip `item_id` 집합을 비교해서 만든 table-row view다. discovery history를 저장하지 않으므로 \"현재 미보유\" 의미만 가진다.\n- equip upgrade는 `ITEM_EQUIP.upgrade_id`를 사용한다. 본체 1개와 같은 `item_id` 재료 2개를 모두 `itemUid`로 지정해 source 3개를 파괴하고, `upgrade_id` 장비 1개를 생성한다. 새 장비는 본체의 `ItemLevel`만 상속한다.\n\n### B-3) Cards\n\n- key: `item_id` (=`RewardData.id` when `type=REWARD_TYPE.CARD`, pk)\n- value: `AbilityItemCard`\n\n`AbilityItemCard` 필드 (구현: [12-game-ability](..\u002F..\u002F..\u002F21-game-package\u002F12-game-ability\u002FSKILL.md)):\n- `ItemId: string` (== key, `mTable.item_id`)\n- `Amount: int` (= `this[UNIT_STAT_TYPE.ITEM_AMOUNT]`)\n- `ItemLevel: int` (= `this[UNIT_STAT_TYPE.ITEM_LEVEL]`)\n- 능력치: `AbilityItemCard : AbilityItemBase : AbilityBase` → `mStats[UNIT_STAT_TYPE.X]` (UNIT_STAT_TYPE 기반 정규화)\n  - 수량 = `UNIT_STAT_TYPE.ITEM_AMOUNT`\n  - 레벨 = `UNIT_STAT_TYPE.ITEM_LEVEL`\n  - Reward\u002FPurchase grants에서는 `UNIT_STAT_TYPE.ITEM_AMOUNT`만 변경된다\n  - level up은 현재 `ITEM_CARD_LEVEL.levelup_count`만큼 count(`ITEM_AMOUNT`)를 먼저 소모한 뒤 현재 `ITEM_CARD_LEVEL` row stat을 제거하고 다음 level row stat을 적용한다\n\n### B-4) Heroes\n\n- key: `item_id` (=`RewardData.id` when `type=REWARD_TYPE.HERO`, pk)\n- value: `AbilityItemHero`\n\n`AbilityItemHero` 필드 (구현: [12-game-ability](..\u002F..\u002F..\u002F21-game-package\u002F12-game-ability\u002FSKILL.md)):\n- `ItemId: string` (== key, `mTable.item_id`)\n- `Amount: int` (= `this[UNIT_STAT_TYPE.ITEM_AMOUNT]`)\n  - `ItemLevel: int` (= `this[UNIT_STAT_TYPE.ITEM_LEVEL]`)\n  - `Equips: Dict\u003CEQUIP_SLOT_TYPE, AbilityItemEquip>` (outgame 슬롯별 장착 상태)\n  - 능력치: `AbilityItemHero : AbilityItemBase : AbilityBase` → `mStats[UNIT_STAT_TYPE.X]` (UNIT_STAT_TYPE 기반 정규화)\n  - 신규 hero runtime의 시작 레벨 기본값은 `1`\n  - level up은 현재 `ITEM_HERO_LEVEL` row stat을 제거한 뒤 다음 level row stat을 적용한다\n- 선택 hero raw state는 `SelectedHeroId: string`으로 저장하고, `SelectedHero: AbilityItemHero`는 manager가 `SelectedHeroId`로부터 계산하는 파생 runtime view다.\n\n### B-5) Materials\n\n- key: `item_id` (=`RewardData.id` when `type=REWARD_TYPE.MATERIAL`, pk)\n- value: `AbilityItemMaterial`\n\n`AbilityItemMaterial` 필드 (구현: [12-game-ability](..\u002F..\u002F..\u002F21-game-package\u002F12-game-ability\u002FSKILL.md)):\n- `ItemId: string` (== key, `mTable.item_id`)\n- `Amount: int` (= `this[UNIT_STAT_TYPE.ITEM_AMOUNT]`)\n- `ItemLevel: int` (= `this[UNIT_STAT_TYPE.ITEM_LEVEL]`)\n- 능력치: `AbilityItemMaterial : AbilityItemBase : AbilityBase` → `mStats[UNIT_STAT_TYPE.X]` (UNIT_STAT_TYPE 기반 정규화)\n  - 수량 = `UNIT_STAT_TYPE.ITEM_AMOUNT`\n  - 레벨 = `UNIT_STAT_TYPE.ITEM_LEVEL`\n  - Reward\u002FPurchase grants에서는 `UNIT_STAT_TYPE.ITEM_AMOUNT`만 변경된다\n  - 현재 `ITEM_MATERIAL_LEVEL` 테이블이 없으므로 level up 대상이 아니다\n\n\n### B-6) Treasure\n\n- `TreasureCurrent` — `InventoryTreasureCurrent` (exp\u002Flevel 묶음, 단일 인스턴스)\n  - `Exp: int` (현재 treasure exp, 기본값 0)\n  - `Level: int` (현재 treasure reward level, 기본값 1)\n- `TreasureCounts` — `Dictionary\u003CITEM_GRADE_TYPE, int>` (grade별 보유 chest count)\n  - key: `ITEM_GRADE_TYPE` (NONE 제외)\n  - value: `int` (보유량, 기본값 0)\n\nNOTE:\n- `ITEM_GRADE_TYPE.NONE`은 저장 대상이 아니다.\n- chest count와 exp는 음수가 될 수 없다 (0 이하로 clamp).\n- current 상태는 grade별로 분리하지 않는다. 단일 `TreasureCurrent.Exp` \u002F `TreasureCurrent.Level`만 사용한다.\n- max level 판단은 storage가 아니라 `TREASURE_CHEST` 테이블을 기준으로 한다 (TreasureManager 담당).\n- `RewardData.Id`는 `ITEM_GRADE_TYPE` enum name 문자열이다 (예: `\"COMMON\"`, `\"EPIC\"`).\n- Treasure 상태의 세부 규칙(max level 판단 등)은 Treasure를 소비하는 상위 시스템이 담당한다.\n\n\n---\n\n\n## C) Apply Rules (정본)\n\n### C-1) 공통\n\n- InventoryManager는 타입별 Apply\u002FRevoke\u002FQuery API를 제공한다 (예: `ApplyCurrency`, `RevokeCurrency`, `GetCurrencyAmount`).\n- 각 API의 반환 타입은 `GameResult`다.\n- RewardData 해석·검증·원자성 보장은 `RewardManager`가 담당한다 ([49-reward-system\u002F10-reward-manager](..\u002F..\u002F49-reward-system\u002F10-reward-manager\u002FSKILL.md)).\n- InventoryManager는 RewardData를 직접 참조하지 않는다.\n- item ability 생성은 `AbilityItemFactory`를 통해 수행하며, lookup\u002Finput 실패는 `GameResult.Failure(...)`로 surface 한다.\n\n### C-2) `type == REWARD_TYPE.CURRENCY`\n\n- `_storage.AddCurrency(currency_type, amount)`\n- 없는 키는 생성된다.\n\n### C-3) `type == REWARD_TYPE.EQUIP`\n\n- 매 Apply마다 새 `itemUid`(GUID)를 생성하여 새 AbilityItemEquip 인스턴스를 추가한다.\n- `_storage.AddEquip(itemUid, ability)`로 생성된다.\n  - 새 AbilityItemEquip의 모든 stat은 0(기본값)으로 시작한다.\n- `amount`는 무시한다 (항상 1개 인스턴스 생성).\n\n### C-5) `type == REWARD_TYPE.CARD`\n\n- `InventoryManager.AddCardAmount(item_id, delta)`가 카드 수량 add-only boundary다.\n- `delta \u003C 0`는 허용하지 않는다. 회수는 `InventoryManager.RevokeCard(item_id, amount)`만 사용한다.\n- 내부 적용은 `_storage.Cards[item_id].AddAmount(delta)` (= `AddStat(UNIT_STAT_TYPE.ITEM_AMOUNT, delta)`)\n- 없는 키는 `_storage.AddCard(item_id, ability)`로 생성된다.\n  - 새 AbilityItemCard의 모든 stat은 0(기본값)으로 시작한다.\n- Apply는 `UNIT_STAT_TYPE.ITEM_AMOUNT`만 변경한다 (다른 stat은 보존).\n- 수량이 0이 되면 카드 runtime은 storage에서 제거된다.\n- 카드 level up은 `InventoryManager.LevelUpCard(item_id)`가 담당한다. 현재 `ITEM_CARD_LEVEL.levelup_currency`\u002F`levelup_price`만큼 inventory currency를 먼저 차감하고, 현재 `ITEM_CARD_LEVEL.levelup_count`만큼 card count(`ITEM_AMOUNT`)를 소모한 뒤 현재 level row stat을 subtract하고 다음 level row stat을 add한다.\n- card count가 부족하면 `GAME_ERROR_TYPE.INVENTORY_CARD_LEVELUP_COUNT_INSUFFICIENT`로 실패한다.\n- level-up currency가 부족하면 `GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT`로 실패한다.\n- level up으로 card count가 `0`이 되더라도 card runtime은 유지되며, save\u002Fload도 itemLevel 상태가 있으면 이를 보존해야 한다.\n\n### C-4) `type == REWARD_TYPE.HERO`\n\n- `InventoryManager.AddHeroAmount(item_id, delta)`가 영웅 수량 add-only boundary다.\n- `delta \u003C 0`는 허용하지 않는다. 회수는 `InventoryManager.RevokeHero(item_id, amount)`만 사용한다.\n- 내부 적용은 `_storage.Heroes[item_id].AddStat(UNIT_STAT_TYPE.ITEM_AMOUNT, delta)`\n- 없는 키는 `_storage.AddHero(item_id, ability)`로 생성된다.\n  - 새 AbilityItemHero는 `AbilityItemFactory.CreateHero(item_id)`로 생성되며 시작 레벨 기본값은 `1`이다.\n- Apply는 `UNIT_STAT_TYPE.ITEM_AMOUNT`만 변경한다 (다른 stat은 보존).\n- 수량이 0이 되면 영웅 runtime은 storage에서 제거되고, 장착 중인 equip owner metadata도 함께 정리된다.\n- 영웅 level up은 `InventoryManager.LevelUpHero(item_id)`가 담당한다. 현재 `ITEM_HERO_LEVEL.levelup_currency`\u002F`levelup_price`만큼 inventory currency를 먼저 차감하고, 현재 `ITEM_HERO_LEVEL.levelup_count`만큼 hero count(`ITEM_AMOUNT`)를 소모한 뒤 현재 level row stat을 subtract하고 다음 level row stat을 add한다.\n- hero count가 부족하면 `GAME_ERROR_TYPE.INVENTORY_HERO_LEVELUP_COUNT_INSUFFICIENT`로 실패한다.\n- level-up currency가 부족하면 `GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT`로 실패한다.\n- level up으로 hero count가 `0`이 되더라도 hero runtime은 유지되며, save\u002Fload도 itemLevel\u002Fequip 상태가 있으면 이를 보존해야 한다.\n\n### C-4a) `type == REWARD_TYPE.MATERIAL`\n\n- `InventoryManager.AddMaterialAmount(item_id, delta)`가 재료 수량 add-only boundary다.\n- `delta \u003C 0`는 허용하지 않는다. 회수는 `InventoryManager.RevokeMaterial(item_id, amount)`만 사용한다.\n- 내부 적용은 `_storage.Materials[item_id].AddAmount(delta)` (= `AddStat(UNIT_STAT_TYPE.ITEM_AMOUNT, delta)`)\n- 없는 키는 `_storage.AddMaterial(item_id, ability)`로 생성된다.\n  - 새 AbilityItemMaterial은 `TB_ITEM_MATERIAL.Get(item_id)`로 Init한다.\n- Apply는 `UNIT_STAT_TYPE.ITEM_AMOUNT`만 변경한다 (다른 stat은 보존).\n- 수량이 0이 되면 재료 runtime은 storage에서 제거된다.\n- 재료는 현재 level table이 없으므로 `LevelUpMaterial`을 두지 않는다.\n\n### C-4b) Equip Level Up\n\n- 장비 level up은 `InventoryManager.LevelUpEquip(item_uid)`가 담당한다.\n- 현재 `ITEM_EQUIP_LEVEL.levelup_currency`\u002F`levelup_price`만큼 inventory currency를 먼저 차감하고, `ITEM_EQUIP_LEVEL.levelup_material`가 가리키는 `ITEM_MATERIAL`을 `ITEM_EQUIP_LEVEL.levelup_count`만큼 소모한 뒤 현재 level row stat을 subtract하고 다음 `ITEM_EQUIP_LEVEL` row stat을 add한다.\n- 장비 level-up 재료가 부족하면 `GAME_ERROR_TYPE.INVENTORY_EQUIP_LEVELUP_MATERIAL_INSUFFICIENT`로 실패한다.\n- level-up currency가 부족하면 `GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT`로 실패한다.\n- level up으로 재료 count가 `0`이 되면 재료 runtime은 storage에서 제거된다.\n- currency 또는 재료 소모 후 장비 level-up 적용이 실패하면 소모한 currency\u002Fmaterial은 원복된다.\n\n\n### C-5) `type == REWARD_TYPE.TREASURE`\n\n- `_storage.AddTreasure(gradeType, amount)`\n- `gradeType`는 `ITEM_GRADE_TYPE`으로 파싱한다 (`RewardData.Id` = enum name 문자열).\n- `gradeType == ITEM_GRADE_TYPE.NONE`이면 invalid.\n- 없는 grade key는 0에서 시작하여 amount를 누적한다.\n\n### C-5a) `RevokeTreasure`\n\n- 검증: `_storage.GetTreasureCount(gradeType) >= amount` (부족하면 `INVENTORY_REFUND_INSUFFICIENT`).\n- 적용: `_storage.SetTreasureCount(gradeType, current - amount)`.\n\nNOTE: `RewardManager.RevokeRewardDatas` \u002F `RevokeRewardDatasPartial`가 RewardData 단위의 회수 원자성을 담당한다. InventoryManager의 Revoke API는 단일 타입\u002F단일 건의 storage 변경만 수행한다.\n\n\n---\n\n\n## C-5b) Equip Upgrade\n\n- API 정본: `InventoryManager.UpgradeEquipItem(baseItemUid, materialItemUid0, materialItemUid1) -> GameResult\u003CAbilityItemEquip>`\n- 세 source equip은 모두 존재해야 하며 `itemUid`가 서로 달라야 한다.\n- 본체\u002F재료2개는 모두 같은 `item_id`여야 한다.\n- 본체 row의 `upgrade_id`가 비어 있으면 업그레이드 불가다.\n- 본체\u002F재료2개 중 하나라도 `IsEquipped == true`면 업그레이드 불가다.\n- 새 장비는 `AbilityItemFactory.CreateEquip(upgrade_id, newItemUid, baseEquip.ItemLevel)`로 생성한다.\n- 생성 성공 후 source 3개를 제거하고, 새 장비 1개를 추가한다.\n- 성공 반환값은 생성된 upgraded `AbilityItemEquip` runtime이다.\n- notify는 `ITEM_EQUIP_LIST_CHANGED(REMOVE x3, ADD x1)`만 사용한다.\n- save schema 변경은 없다. 최종 상태는 기존 equip snapshot(`ItemId`, `ItemUid`, `ItemLevel`)으로 직렬화된다.\n\n\n---\n\n\n## C-6) 장비 장착\u002F해제\n\n장비 장착\u002F해제의 저장 모델은 `AbilityItemHero._SetEquip()` \u002F `AbilityItemHero._RemoveEquip()`이다.\n이 메서드는 hero loadout metadata와 equip owner metadata만 관리한다.\n실제 장비 stat 계산은 `AbilityUnitHero._Equip()` \u002F `AbilityUnitHero._Unequip()`이 담당한다.\nInventoryStorage는 `Equip(heroId, equipSlot, equipUid)` \u002F `Unequip(heroId, equipSlot)` 편의 메서드로 item hero 저장 모델에 위임한다.\n\n- slot rule 정본은 `ITEM_EQUIP.equip_type` + `EQUIP_SLOT.allowed_slots\u002Ftwo_handed`다.\n- `EQUIP_SLOT_TYPE.NONE`은 저장\u002F장착 대상이 아니다.\n- `two_handed=true` 장비를 `HAND_MAIN`에 장착하면 현재 `HAND_SUB` 장비는 자동 해제된다.\n- `HAND_MAIN`에 양손 장비가 있는 상태에서 `HAND_SUB` 장착 시도는 실패한다.\n\n---\n\n\n## D) JSON Persistence Schema (정본)\n\n> **변경**: `InventoryStorage.ToJson()`\u002F`FromJson()` 메서드는 **삭제**되었다.\n> 직렬화 책임은 [21-savedata-system\u002F43-savedata-json-codec](..\u002F..\u002F21-savedata-system\u002F43-savedata-json-codec\u002FSKILL.md)의 **`SaveDataJsonCodec`**가 담당한다.\n> 아래 스키마는 SaveData JSON의 `\"inventory\"` 섹션에 해당한다.\n\nInventory 직렬화 스키마 정본 (SaveData JSON inventory 섹션).\n- inventory 저장 raw state에는 `selectedHeroItemId`가 포함된다. 존재하지 않는 hero를 가리키면 load 시 무시한다.\n\n```json\n{\n  \"wallet\": { \"\u003CcurrencyId>\": \u003Clong> },\n  \"equipments\": {\n    \"\u003CitemUid>\": {\n      \"item_id\": \"\u003Cstring>\",\n      \"itemUid\": \"\u003Cstring>\",\n      \"item_level\": \u003Cint>\n    }\n  },\n  \"cards\": {\n    \"\u003Citem_id>\": {\n      \"item_id\": \"\u003Cstring>\",\n      \"item_level\": \u003Cint>,\n      \"amount\": \u003Cint>\n    }\n  },\n  \"materials\": {\n    \"\u003Citem_id>\": {\n      \"item_id\": \"\u003Cstring>\",\n      \"amount\": \u003Cint>\n    }\n  },\n  \"heroes\": {\n    \"\u003Citem_id>\": {\n      \"item_id\": \"\u003Cstring>\",\n      \"item_level\": \u003Cint>,\n      \"amount\": \u003Cint>,\n      \"equips\": { \"\u003CslotTypeName>\": \"\u003CequipUid>\" }\n    }\n  }\n}\n```\n\n- Hero equips: `EQUIP_SLOT_TYPE` enum name(string key) → equipUid(string value).\n- hero equip ownership의 저장 SSOT는 `heroes[*].equips`다.\n- `equipments[*]`는 owner 정보를 저장하지 않는다. equip owner는 deserialize 시 hero equip 맵으로만 복원한다.\n- 역직렬화 시 테이블 참조: `TB_ITEM_EQUIP.Get`\u002F`TB_ITEM_CARD.Get`\u002F`TB_ITEM_MATERIAL.Get`\u002F`TB_ITEM_HERO.Get`으로 `mTable` 복원.\n- 역직렬화 순서: wallet → equipments(항상 unequipped 생성) → cards → materials → heroes (heroes 마지막: equip 슬롯 참조 필요).\n- hero equip 맵에 중복 `equipUid`가 나오면 load 실패로 처리한다.\n- 새 save는 enum slot key를 숫자로 저장하지 않는다. legacy 숫자 key는 load 호환용으로만 허용한다.\n- legacy save의 `CARD_AMOUNT`\u002F`UNIT_AMOUNT`\u002F`CARD_LEVEL`\u002F`UNIT_LEVEL` key는 load 시 `ITEM_AMOUNT`\u002F`ITEM_LEVEL`로 매핑한다.\n- 역직렬화 실패는 `CommonResult.Failure(...)`로 즉시 반환하며, 부분 복원 상태를 성공으로 취급하지 않는다.\n- Treasure 상태는 별도 root key `\"treasure\"`로 직렬화된다 (`SaveDataJsonCodecTreasure` 담당).\n  - `\"treasure\"` 스키마: `{ \"schemaVersion\": 1, \"current\": { \"exp\": int, \"level\": int }, \"chestCounts\": { \"\u003CGRADE_TYPE>\": int } }`\n\n\n---\n\n\n## E) Error Code Source (정본)\n\n- InventoryManager 타입별 API 실패 에러 코드는 `GAME_ERROR_TYPE`을 사용한다.\n  - `GAME_ERROR_TYPE.GAME_INVALID_ARGUMENT` — null\u002Fempty\u002F음수 등 입력 검증 실패\n  - `GAME_ERROR_TYPE.INVENTORY_REFUND_INSUFFICIENT` — 회수 시 잔고\u002F수량 부족\n  - `GAME_ERROR_TYPE.INVENTORY_CARD_LEVELUP_COUNT_INSUFFICIENT` — card level-up 비용(`ITEM_CARD_LEVEL.levelup_count`) 부족\n  - `GAME_ERROR_TYPE.INVENTORY_HERO_LEVELUP_COUNT_INSUFFICIENT` — hero level-up 비용(`ITEM_HERO_LEVEL.levelup_count`) 부족\n  - `GAME_ERROR_TYPE.INVENTORY_EQUIP_LEVELUP_MATERIAL_INSUFFICIENT` — equip level-up 재료 비용(`ITEM_EQUIP_LEVEL.levelup_material`, `levelup_count`) 부족\n  - `GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT` — item level-up 재화 비용(`ITEM_*_LEVEL.levelup_currency`, `levelup_price`) 부족\n\n\n---\n\n\n## F) Inventory Message Trigger (정본)\n\n- Inventory 변경 알림 key는 `INVENTORY_MESSAGE_TYPE` enum을 사용한다.\n  - 입력 파일: `input\u002FDomains\u002FGame\u002FENUM_ITEM.json`\n- Trigger 소유자: `InventoryManager`\n- 외부 노출: `InventoryManager` helper(`Subcribe\u002FUnSubcribe`)만 허용\n- Trigger 직접 참조 금지\n\n현재 메시지:\n\n- `PASS_OWNERSHIP_CHANGED`\n  - payload: `args[0] = passId(string)`, `args[1] = owned(bool)`\n- `CURRENCY_CHANGED`\n  - payload: `args[0] = currencyType(CURRENCY_TYPE)`, `args[1] = delta(long)`, `args[2] = currentAmount(long)`\n- `ITEM_EQUIP_CHANGED`\n  - payload: `args[0] = itemUid(string)`, `args[1] = itemId(string)`, `args[2] = runtime(AbilityItemEquip)`\n- `ITEM_CARD_CHANGED`\n  - payload: `args[0] = itemId(string)`, `args[1] = runtime(AbilityItemCard)`\n- `ITEM_MATERIAL_CHANGED`\n  - payload: `args[0] = itemId(string)`, `args[1] = runtime(AbilityItemMaterial)`\n- `ITEM_HERO_CHANGED`\n  - payload: `args[0] = itemId(string)`, `args[1] = runtime(AbilityItemHero)`\n- `ITEM_EQUIP_LIST_CHANGED`\n  - payload: `args[0] = action(INVENTORY_LIST_CHANGE_TYPE)`, `args[1] = itemUid(string)`, `args[2] = itemId(string)`, `args[3] = runtimeOrNull(AbilityItemEquip)`\n- `ITEM_CARD_LIST_CHANGED`\n  - payload: `args[0] = action(INVENTORY_LIST_CHANGE_TYPE)`, `args[1] = itemId(string)`, `args[2] = runtimeOrNull(AbilityItemCard)`\n- `ITEM_MATERIAL_LIST_CHANGED`\n  - payload: `args[0] = action(INVENTORY_LIST_CHANGE_TYPE)`, `args[1] = itemId(string)`, `args[2] = runtimeOrNull(AbilityItemMaterial)`\n- `ITEM_HERO_LIST_CHANGED`\n  - payload: `args[0] = action(INVENTORY_LIST_CHANGE_TYPE)`, `args[1] = itemId(string)`, `args[2] = runtimeOrNull(AbilityItemHero)`\n- `RENTAL_CHANGED`\n  - payload: `args[0] = itemId(string)`, `args[1] = expiresAtClientUtcMs(long)`, `args[2] = active(bool)`\n- `TREASURE_STATE_CHANGED`\n  - payload: `args[0] = gradeType(ITEM_GRADE_TYPE)`, `args[1] = deltaCount(int)`, `args[2] = currentCount(int)`, `args[3] = currentLevel(int)`, `args[4] = currentExp(int)`\n- `INVENTORY_SNAPSHOT_CHANGED`\n  - payload: `args[0] = reason(INVENTORY_SNAPSHOT_CHANGE_REASON)`\n\n사용 목적:\n\n- `ACHIEVE_PASS.req_pass_id` 조건이 있는 runtime의 `WAIT -> ACTIVE` 전이를 위해 Pass 변동을 구독한다.\n- wallet\u002Fitem UI는 타입별 `*_CHANGED`를 구독하고 payload 또는 현재 storage 재조회로 갱신한다.\n- item 추가\u002F삭제는 `*_LIST_CHANGED`로 별도 발행한다.\n- load\u002Fimport\u002Fclear 같은 bulk inventory 변경은 per-item replay 없이 `INVENTORY_SNAPSHOT_CHANGED` 한 번만 발행한다.\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F22-inventory-system\u002F03-ssot","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":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 03-ssot",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 03-ssot",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 03-ssot","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F22-inventory-system\u002F03-ssot\u002FSKILL.md",true,[44,50,54,58,62,66,70,74,78,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138,142,146],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"AGENTS.md","REFERENCE","参考文档",185112,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002FAGENTS.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"rules\u002F_template.md",620,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002F_template.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"rules\u002Fapp-auth-configs.md",5797,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-auth-configs.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"rules\u002Fapp-connected-accounts.md",6462,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-connected-accounts.md",{"path":63,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":64,"sourceHtmlUrl":65},"rules\u002Fapp-custom-tools.md",5163,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-custom-tools.md",{"path":67,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":68,"sourceHtmlUrl":69},"rules\u002Fapp-execute-tools.md",5987,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-execute-tools.md",{"path":71,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":72,"sourceHtmlUrl":73},"rules\u002Fapp-fetch-tools.md",4642,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-fetch-tools.md",{"path":75,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":76,"sourceHtmlUrl":77},"rules\u002Fapp-modifiers.md",3335,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-modifiers.md",{"path":79,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":80,"sourceHtmlUrl":81},"rules\u002Fapp-tool-versions.md",10097,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-tool-versions.md",{"path":83,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":84,"sourceHtmlUrl":85},"rules\u002Fapp-toolkits.md",5071,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-toolkits.md",{"path":87,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":88,"sourceHtmlUrl":89},"rules\u002Fapp-user-context.md",5768,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Fapp-user-context.md",{"path":91,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":92,"sourceHtmlUrl":93},"rules\u002Ftr-auth-auto.md",3039,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-auth-auto.md",{"path":95,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":96,"sourceHtmlUrl":97},"rules\u002Ftr-auth-connections.md",5171,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-auth-connections.md",{"path":99,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":100,"sourceHtmlUrl":101},"rules\u002Ftr-auth-manual.md",4967,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-auth-manual.md",{"path":103,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":104,"sourceHtmlUrl":105},"rules\u002Ftr-building-chat-ui.md",9556,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-building-chat-ui.md",{"path":107,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":108,"sourceHtmlUrl":109},"rules\u002Ftr-framework-integration.md",21676,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-framework-integration.md",{"path":111,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":112,"sourceHtmlUrl":113},"rules\u002Ftr-mcp-vs-native.md",7706,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-mcp-vs-native.md",{"path":115,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":116,"sourceHtmlUrl":117},"rules\u002Ftr-session-basic.md",1974,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-session-basic.md",{"path":119,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":120,"sourceHtmlUrl":121},"rules\u002Ftr-session-config.md",4126,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-session-config.md",{"path":123,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":124,"sourceHtmlUrl":125},"rules\u002Ftr-session-lifecycle.md",10516,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-session-lifecycle.md",{"path":127,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":128,"sourceHtmlUrl":129},"rules\u002Ftr-toolkit-query.md",4399,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-toolkit-query.md",{"path":131,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":132,"sourceHtmlUrl":133},"rules\u002Ftr-userid-best-practices.md",12793,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftr-userid-best-practices.md",{"path":135,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":136,"sourceHtmlUrl":137},"rules\u002Ftriggers-create.md",5802,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftriggers-create.md",{"path":139,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":140,"sourceHtmlUrl":141},"rules\u002Ftriggers-manage.md",6948,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftriggers-manage.md",{"path":143,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":144,"sourceHtmlUrl":145},"rules\u002Ftriggers-subscribe.md",4178,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftriggers-subscribe.md",{"path":147,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":148,"sourceHtmlUrl":149},"rules\u002Ftriggers-webhook.md",5404,"https:\u002F\u002Fgithub.com\u002Fboisenoise\u002Fskills-collections\u002Fblob\u002Fmain\u002Fskills\u002Fcomposio-composio-sdk\u002Frules\u002Ftriggers-webhook.md",[151,157,165,173,182,189],{"skillNo":152,"name":153,"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":154,"categories":155,"keywords":156,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[153],{"skillNo":158,"name":159,"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":160,"categories":161,"keywords":162,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[163,164],"archive","90 project archive",{"skillNo":166,"name":167,"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":168,"categories":169,"keywords":170,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[171,172],"management","30 env management",{"skillNo":174,"name":175,"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":176,"categories":177,"keywords":178,"publishedAt":19},"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",[],[179,180,181],"push","page","19 page push send",{"skillNo":183,"name":184,"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":185,"categories":186,"keywords":187,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[180,188],"18 page savedata",{"skillNo":190,"name":191,"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":192,"categories":193,"keywords":194,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[180,195],"17 page deobfuscate"]