03-ssot
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 26
- 参考文档AGENTS.md180.8 KB
- 参考文档rules/_template.md620 B
- 参考文档rules/app-auth-configs.md5.7 KB
- 参考文档rules/app-connected-accounts.md6.3 KB
- 参考文档rules/app-custom-tools.md5.0 KB
- 参考文档rules/app-execute-tools.md5.8 KB
- 参考文档rules/app-fetch-tools.md4.5 KB
- 参考文档rules/app-modifiers.md3.3 KB
- 参考文档rules/app-tool-versions.md9.9 KB
- 参考文档rules/app-toolkits.md5.0 KB
- 参考文档rules/app-user-context.md5.6 KB
- 参考文档rules/tr-auth-auto.md3.0 KB
- 参考文档rules/tr-auth-connections.md5.0 KB
- 参考文档rules/tr-auth-manual.md4.9 KB
- 参考文档rules/tr-building-chat-ui.md9.3 KB
- 参考文档rules/tr-framework-integration.md21.2 KB
- 参考文档rules/tr-mcp-vs-native.md7.5 KB
- 参考文档rules/tr-session-basic.md1.9 KB
- 参考文档rules/tr-session-config.md4.0 KB
- 参考文档rules/tr-session-lifecycle.md10.3 KB
- 参考文档rules/tr-toolkit-query.md4.3 KB
- 参考文档rules/tr-userid-best-practices.md12.5 KB
- 参考文档rules/triggers-create.md5.7 KB
- 参考文档rules/triggers-manage.md6.8 KB
- 参考文档rules/triggers-subscribe.md4.1 KB
- 参考文档rules/triggers-webhook.md5.3 KB
03 SKILL.md 正文
03-ssot — 22-inventory-system (SSOT)
Status: ACTIVE AppliesTo: v10
이 문서가 정본이다 (SSOT)
- RewardData 적용 규칙(Inventory 관점)
- 인벤토리 상태 표현(개념)
- Apply 원자성/에러 처리 규칙
A) RewardData Contract Source (정본)
RewardData스키마의 단일 정본은 아래 문서다:- 본 문서(22-inventory-system)는
RewardData필드 스키마를 재정의하지 않는다. - Inventory는 위 정본 규약을 입력 계약으로 사용한다.
B) Inventory State (개념)
Inventory 상태는 "통화", "아이템(장비/카드/재료)", "영웅", "Treasure"로 분리된다.
B-1) Wallet
- key:
currency_type(=RewardData.idwhentype=REWARD_TYPE.CURRENCY) - value:
amount (long)
B-2) Equips
- key:
itemUid(string, GUID, 인스턴스별 고유 pk) - value:
AbilityItemEquip
AbilityItemEquip 필드 (구현: 12-game-ability):
ItemUid: string(== key, 인스턴스 고유 ID, GUID)ItemId: string(템플릿 ID,mTable.item_id)OwnerUnitId: string(장착된 영웅 ItemId, 미장착 시 empty)OwnerSlotType: EQUIP_SLOT_TYPE(장착 슬롯 enum,NONE= 미장착)IsEquipped: bool(=OwnerSlotType != EQUIP_SLOT_TYPE.NONE)- 능력치:
AbilityItemEquip : AbilityItemBase : AbilityBase→mStats[UNIT_STAT_TYPE.X](UNIT_STAT_TYPE 기반 정규화)- 레벨 =
UNIT_STAT_TYPE.ITEM_LEVEL
- 레벨 =
NOTE:
- 같은
item_id에 여러 인스턴스(각각 고유itemUid)가 존재할 수 있다. RewardData.Id는item_id(템플릿 ID)이다.itemUid는 InventoryManager가 Apply 시 생성한다.ItemData클래스는AbilityItemEquip에 통합되어 삭제되었다.InventoryManager.EquippedItems/UnequippedItems는 이 equip SSOT에서 파생된 runtime view다. 별도 저장 정본이 아니다.InventoryManager.UnownedEquipItems는TB_ITEM_EQUIP.GetAll()과 현재 owned equipitem_id집합을 비교해서 만든 table-row view다. discovery history를 저장하지 않으므로 "현재 미보유" 의미만 가진다.- equip upgrade는
ITEM_EQUIP.upgrade_id를 사용한다. 본체 1개와 같은item_id재료 2개를 모두itemUid로 지정해 source 3개를 파괴하고,upgrade_id장비 1개를 생성한다. 새 장비는 본체의ItemLevel만 상속한다.
B-3) Cards
- key:
item_id(=RewardData.idwhentype=REWARD_TYPE.CARD, pk) - value:
AbilityItemCard
AbilityItemCard 필드 (구현: 12-game-ability):
ItemId: string(== key,mTable.item_id)Amount: int(=this[UNIT_STAT_TYPE.ITEM_AMOUNT])ItemLevel: int(=this[UNIT_STAT_TYPE.ITEM_LEVEL])- 능력치:
AbilityItemCard : AbilityItemBase : AbilityBase→mStats[UNIT_STAT_TYPE.X](UNIT_STAT_TYPE 기반 정규화)- 수량 =
UNIT_STAT_TYPE.ITEM_AMOUNT - 레벨 =
UNIT_STAT_TYPE.ITEM_LEVEL - Reward/Purchase grants에서는
UNIT_STAT_TYPE.ITEM_AMOUNT만 변경된다 - level up은 현재
ITEM_CARD_LEVEL.levelup_count만큼 count(ITEM_AMOUNT)를 먼저 소모한 뒤 현재ITEM_CARD_LEVELrow stat을 제거하고 다음 level row stat을 적용한다
- 수량 =
B-4) Heroes
- key:
item_id(=RewardData.idwhentype=REWARD_TYPE.HERO, pk) - value:
AbilityItemHero
AbilityItemHero 필드 (구현: 12-game-ability):
ItemId: string(== key,mTable.item_id)Amount: int(=this[UNIT_STAT_TYPE.ITEM_AMOUNT])ItemLevel: int(=this[UNIT_STAT_TYPE.ITEM_LEVEL])Equips: Dict<EQUIP_SLOT_TYPE, AbilityItemEquip>(outgame 슬롯별 장착 상태)- 능력치:
AbilityItemHero : AbilityItemBase : AbilityBase→mStats[UNIT_STAT_TYPE.X](UNIT_STAT_TYPE 기반 정규화) - 신규 hero runtime의 시작 레벨 기본값은
1 - level up은 현재
ITEM_HERO_LEVELrow stat을 제거한 뒤 다음 level row stat을 적용한다
- 선택 hero raw state는
SelectedHeroId: string으로 저장하고,SelectedHero: AbilityItemHero는 manager가SelectedHeroId로부터 계산하는 파생 runtime view다.
B-5) Materials
- key:
item_id(=RewardData.idwhentype=REWARD_TYPE.MATERIAL, pk) - value:
AbilityItemMaterial
AbilityItemMaterial 필드 (구현: 12-game-ability):
ItemId: string(== key,mTable.item_id)Amount: int(=this[UNIT_STAT_TYPE.ITEM_AMOUNT])ItemLevel: int(=this[UNIT_STAT_TYPE.ITEM_LEVEL])- 능력치:
AbilityItemMaterial : AbilityItemBase : AbilityBase→mStats[UNIT_STAT_TYPE.X](UNIT_STAT_TYPE 기반 정규화)- 수량 =
UNIT_STAT_TYPE.ITEM_AMOUNT - 레벨 =
UNIT_STAT_TYPE.ITEM_LEVEL - Reward/Purchase grants에서는
UNIT_STAT_TYPE.ITEM_AMOUNT만 변경된다 - 현재
ITEM_MATERIAL_LEVEL테이블이 없으므로 level up 대상이 아니다
- 수량 =
B-6) Treasure
TreasureCurrent—InventoryTreasureCurrent(exp/level 묶음, 단일 인스턴스)Exp: int(현재 treasure exp, 기본값 0)Level: int(현재 treasure reward level, 기본값 1)
TreasureCounts—Dictionary<ITEM_GRADE_TYPE, int>(grade별 보유 chest count)- key:
ITEM_GRADE_TYPE(NONE 제외) - value:
int(보유량, 기본값 0)
- key:
NOTE:
ITEM_GRADE_TYPE.NONE은 저장 대상이 아니다.- chest count와 exp는 음수가 될 수 없다 (0 이하로 clamp).
- current 상태는 grade별로 분리하지 않는다. 단일
TreasureCurrent.Exp/TreasureCurrent.Level만 사용한다. - max level 판단은 storage가 아니라
TREASURE_CHEST테이블을 기준으로 한다 (TreasureManager 담당). RewardData.Id는ITEM_GRADE_TYPEenum name 문자열이다 (예:"COMMON","EPIC").- Treasure 상태의 세부 규칙(max level 판단 등)은 Treasure를 소비하는 상위 시스템이 담당한다.
C) Apply Rules (정본)
C-1) 공통
- InventoryManager는 타입별 Apply/Revoke/Query API를 제공한다 (예:
ApplyCurrency,RevokeCurrency,GetCurrencyAmount). - 각 API의 반환 타입은
GameResult다. - RewardData 해석·검증·원자성 보장은
RewardManager가 담당한다 (49-reward-system/10-reward-manager). - InventoryManager는 RewardData를 직접 참조하지 않는다.
- item ability 생성은
AbilityItemFactory를 통해 수행하며, lookup/input 실패는GameResult.Failure(...)로 surface 한다.
C-2) type == REWARD_TYPE.CURRENCY
_storage.AddCurrency(currency_type, amount)- 없는 키는 생성된다.
C-3) type == REWARD_TYPE.EQUIP
- 매 Apply마다 새
itemUid(GUID)를 생성하여 새 AbilityItemEquip 인스턴스를 추가한다. _storage.AddEquip(itemUid, ability)로 생성된다.- 새 AbilityItemEquip의 모든 stat은 0(기본값)으로 시작한다.
amount는 무시한다 (항상 1개 인스턴스 생성).
C-5) type == REWARD_TYPE.CARD
InventoryManager.AddCardAmount(item_id, delta)가 카드 수량 add-only boundary다.delta < 0는 허용하지 않는다. 회수는InventoryManager.RevokeCard(item_id, amount)만 사용한다.- 내부 적용은
_storage.Cards[item_id].AddAmount(delta)(=AddStat(UNIT_STAT_TYPE.ITEM_AMOUNT, delta)) - 없는 키는
_storage.AddCard(item_id, ability)로 생성된다.- 새 AbilityItemCard의 모든 stat은 0(기본값)으로 시작한다.
- Apply는
UNIT_STAT_TYPE.ITEM_AMOUNT만 변경한다 (다른 stat은 보존). - 수량이 0이 되면 카드 runtime은 storage에서 제거된다.
- 카드 level up은
InventoryManager.LevelUpCard(item_id)가 담당한다. 현재ITEM_CARD_LEVEL.levelup_currency/levelup_price만큼 inventory currency를 먼저 차감하고, 현재ITEM_CARD_LEVEL.levelup_count만큼 card count(ITEM_AMOUNT)를 소모한 뒤 현재 level row stat을 subtract하고 다음 level row stat을 add한다. - card count가 부족하면
GAME_ERROR_TYPE.INVENTORY_CARD_LEVELUP_COUNT_INSUFFICIENT로 실패한다. - level-up currency가 부족하면
GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT로 실패한다. - level up으로 card count가
0이 되더라도 card runtime은 유지되며, save/load도 itemLevel 상태가 있으면 이를 보존해야 한다.
C-4) type == REWARD_TYPE.HERO
InventoryManager.AddHeroAmount(item_id, delta)가 영웅 수량 add-only boundary다.delta < 0는 허용하지 않는다. 회수는InventoryManager.RevokeHero(item_id, amount)만 사용한다.- 내부 적용은
_storage.Heroes[item_id].AddStat(UNIT_STAT_TYPE.ITEM_AMOUNT, delta) - 없는 키는
_storage.AddHero(item_id, ability)로 생성된다.- 새 AbilityItemHero는
AbilityItemFactory.CreateHero(item_id)로 생성되며 시작 레벨 기본값은1이다.
- 새 AbilityItemHero는
- Apply는
UNIT_STAT_TYPE.ITEM_AMOUNT만 변경한다 (다른 stat은 보존). - 수량이 0이 되면 영웅 runtime은 storage에서 제거되고, 장착 중인 equip owner metadata도 함께 정리된다.
- 영웅 level up은
InventoryManager.LevelUpHero(item_id)가 담당한다. 현재ITEM_HERO_LEVEL.levelup_currency/levelup_price만큼 inventory currency를 먼저 차감하고, 현재ITEM_HERO_LEVEL.levelup_count만큼 hero count(ITEM_AMOUNT)를 소모한 뒤 현재 level row stat을 subtract하고 다음 level row stat을 add한다. - hero count가 부족하면
GAME_ERROR_TYPE.INVENTORY_HERO_LEVELUP_COUNT_INSUFFICIENT로 실패한다. - level-up currency가 부족하면
GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT로 실패한다. - level up으로 hero count가
0이 되더라도 hero runtime은 유지되며, save/load도 itemLevel/equip 상태가 있으면 이를 보존해야 한다.
C-4a) type == REWARD_TYPE.MATERIAL
InventoryManager.AddMaterialAmount(item_id, delta)가 재료 수량 add-only boundary다.delta < 0는 허용하지 않는다. 회수는InventoryManager.RevokeMaterial(item_id, amount)만 사용한다.- 내부 적용은
_storage.Materials[item_id].AddAmount(delta)(=AddStat(UNIT_STAT_TYPE.ITEM_AMOUNT, delta)) - 없는 키는
_storage.AddMaterial(item_id, ability)로 생성된다.- 새 AbilityItemMaterial은
TB_ITEM_MATERIAL.Get(item_id)로 Init한다.
- 새 AbilityItemMaterial은
- Apply는
UNIT_STAT_TYPE.ITEM_AMOUNT만 변경한다 (다른 stat은 보존). - 수량이 0이 되면 재료 runtime은 storage에서 제거된다.
- 재료는 현재 level table이 없으므로
LevelUpMaterial을 두지 않는다.
C-4b) Equip Level Up
- 장비 level up은
InventoryManager.LevelUpEquip(item_uid)가 담당한다. - 현재
ITEM_EQUIP_LEVEL.levelup_currency/levelup_price만큼 inventory currency를 먼저 차감하고,ITEM_EQUIP_LEVEL.levelup_material가 가리키는ITEM_MATERIAL을ITEM_EQUIP_LEVEL.levelup_count만큼 소모한 뒤 현재 level row stat을 subtract하고 다음ITEM_EQUIP_LEVELrow stat을 add한다. - 장비 level-up 재료가 부족하면
GAME_ERROR_TYPE.INVENTORY_EQUIP_LEVELUP_MATERIAL_INSUFFICIENT로 실패한다. - level-up currency가 부족하면
GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT로 실패한다. - level up으로 재료 count가
0이 되면 재료 runtime은 storage에서 제거된다. - currency 또는 재료 소모 후 장비 level-up 적용이 실패하면 소모한 currency/material은 원복된다.
C-5) type == REWARD_TYPE.TREASURE
_storage.AddTreasure(gradeType, amount)gradeType는ITEM_GRADE_TYPE으로 파싱한다 (RewardData.Id= enum name 문자열).gradeType == ITEM_GRADE_TYPE.NONE이면 invalid.- 없는 grade key는 0에서 시작하여 amount를 누적한다.
C-5a) RevokeTreasure
- 검증:
_storage.GetTreasureCount(gradeType) >= amount(부족하면INVENTORY_REFUND_INSUFFICIENT). - 적용:
_storage.SetTreasureCount(gradeType, current - amount).
NOTE: RewardManager.RevokeRewardDatas / RevokeRewardDatasPartial가 RewardData 단위의 회수 원자성을 담당한다. InventoryManager의 Revoke API는 단일 타입/단일 건의 storage 변경만 수행한다.
C-5b) Equip Upgrade
- API 정본:
InventoryManager.UpgradeEquipItem(baseItemUid, materialItemUid0, materialItemUid1) -> GameResult<AbilityItemEquip> - 세 source equip은 모두 존재해야 하며
itemUid가 서로 달라야 한다. - 본체/재료2개는 모두 같은
item_id여야 한다. - 본체 row의
upgrade_id가 비어 있으면 업그레이드 불가다. - 본체/재료2개 중 하나라도
IsEquipped == true면 업그레이드 불가다. - 새 장비는
AbilityItemFactory.CreateEquip(upgrade_id, newItemUid, baseEquip.ItemLevel)로 생성한다. - 생성 성공 후 source 3개를 제거하고, 새 장비 1개를 추가한다.
- 성공 반환값은 생성된 upgraded
AbilityItemEquipruntime이다. - notify는
ITEM_EQUIP_LIST_CHANGED(REMOVE x3, ADD x1)만 사용한다. - save schema 변경은 없다. 최종 상태는 기존 equip snapshot(
ItemId,ItemUid,ItemLevel)으로 직렬화된다.
C-6) 장비 장착/해제
장비 장착/해제의 저장 모델은 AbilityItemHero._SetEquip() / AbilityItemHero._RemoveEquip()이다.
이 메서드는 hero loadout metadata와 equip owner metadata만 관리한다.
실제 장비 stat 계산은 AbilityUnitHero._Equip() / AbilityUnitHero._Unequip()이 담당한다.
InventoryStorage는 Equip(heroId, equipSlot, equipUid) / Unequip(heroId, equipSlot) 편의 메서드로 item hero 저장 모델에 위임한다.
- slot rule 정본은
ITEM_EQUIP.equip_type+EQUIP_SLOT.allowed_slots/two_handed다. EQUIP_SLOT_TYPE.NONE은 저장/장착 대상이 아니다.two_handed=true장비를HAND_MAIN에 장착하면 현재HAND_SUB장비는 자동 해제된다.HAND_MAIN에 양손 장비가 있는 상태에서HAND_SUB장착 시도는 실패한다.
D) JSON Persistence Schema (정본)
변경:
InventoryStorage.ToJson()/FromJson()메서드는 삭제되었다. 직렬화 책임은 21-savedata-system/43-savedata-json-codec의 **SaveDataJsonCodec**가 담당한다. 아래 스키마는 SaveData JSON의"inventory"섹션에 해당한다.
Inventory 직렬화 스키마 정본 (SaveData JSON inventory 섹션).
- inventory 저장 raw state에는
selectedHeroItemId가 포함된다. 존재하지 않는 hero를 가리키면 load 시 무시한다.
{
"wallet": { "<currencyId>": <long> },
"equipments": {
"<itemUid>": {
"item_id": "<string>",
"itemUid": "<string>",
"item_level": <int>
}
},
"cards": {
"<item_id>": {
"item_id": "<string>",
"item_level": <int>,
"amount": <int>
}
},
"materials": {
"<item_id>": {
"item_id": "<string>",
"amount": <int>
}
},
"heroes": {
"<item_id>": {
"item_id": "<string>",
"item_level": <int>,
"amount": <int>,
"equips": { "<slotTypeName>": "<equipUid>" }
}
}
}
- Hero equips:
EQUIP_SLOT_TYPEenum name(string key) → equipUid(string value). - hero equip ownership의 저장 SSOT는
heroes[*].equips다. equipments[*]는 owner 정보를 저장하지 않는다. equip owner는 deserialize 시 hero equip 맵으로만 복원한다.- 역직렬화 시 테이블 참조:
TB_ITEM_EQUIP.Get/TB_ITEM_CARD.Get/TB_ITEM_MATERIAL.Get/TB_ITEM_HERO.Get으로mTable복원. - 역직렬화 순서: wallet → equipments(항상 unequipped 생성) → cards → materials → heroes (heroes 마지막: equip 슬롯 참조 필요).
- hero equip 맵에 중복
equipUid가 나오면 load 실패로 처리한다. - 새 save는 enum slot key를 숫자로 저장하지 않는다. legacy 숫자 key는 load 호환용으로만 허용한다.
- legacy save의
CARD_AMOUNT/UNIT_AMOUNT/CARD_LEVEL/UNIT_LEVELkey는 load 시ITEM_AMOUNT/ITEM_LEVEL로 매핑한다. - 역직렬화 실패는
CommonResult.Failure(...)로 즉시 반환하며, 부분 복원 상태를 성공으로 취급하지 않는다. - Treasure 상태는 별도 root key
"treasure"로 직렬화된다 (SaveDataJsonCodecTreasure담당)."treasure"스키마:{ "schemaVersion": 1, "current": { "exp": int, "level": int }, "chestCounts": { "<GRADE_TYPE>": int } }
E) Error Code Source (정본)
- InventoryManager 타입별 API 실패 에러 코드는
GAME_ERROR_TYPE을 사용한다.GAME_ERROR_TYPE.GAME_INVALID_ARGUMENT— null/empty/음수 등 입력 검증 실패GAME_ERROR_TYPE.INVENTORY_REFUND_INSUFFICIENT— 회수 시 잔고/수량 부족GAME_ERROR_TYPE.INVENTORY_CARD_LEVELUP_COUNT_INSUFFICIENT— card level-up 비용(ITEM_CARD_LEVEL.levelup_count) 부족GAME_ERROR_TYPE.INVENTORY_HERO_LEVELUP_COUNT_INSUFFICIENT— hero level-up 비용(ITEM_HERO_LEVEL.levelup_count) 부족GAME_ERROR_TYPE.INVENTORY_EQUIP_LEVELUP_MATERIAL_INSUFFICIENT— equip level-up 재료 비용(ITEM_EQUIP_LEVEL.levelup_material,levelup_count) 부족GAME_ERROR_TYPE.INVENTORY_ITEM_LEVELUP_CURRENCY_INSUFFICIENT— item level-up 재화 비용(ITEM_*_LEVEL.levelup_currency,levelup_price) 부족
F) Inventory Message Trigger (정본)
- Inventory 변경 알림 key는
INVENTORY_MESSAGE_TYPEenum을 사용한다.- 입력 파일:
input/Domains/Game/ENUM_ITEM.json
- 입력 파일:
- Trigger 소유자:
InventoryManager - 외부 노출:
InventoryManagerhelper(Subcribe/UnSubcribe)만 허용 - Trigger 직접 참조 금지
현재 메시지:
PASS_OWNERSHIP_CHANGED- payload:
args[0] = passId(string),args[1] = owned(bool)
- payload:
CURRENCY_CHANGED- payload:
args[0] = currencyType(CURRENCY_TYPE),args[1] = delta(long),args[2] = currentAmount(long)
- payload:
ITEM_EQUIP_CHANGED- payload:
args[0] = itemUid(string),args[1] = itemId(string),args[2] = runtime(AbilityItemEquip)
- payload:
ITEM_CARD_CHANGED- payload:
args[0] = itemId(string),args[1] = runtime(AbilityItemCard)
- payload:
ITEM_MATERIAL_CHANGED- payload:
args[0] = itemId(string),args[1] = runtime(AbilityItemMaterial)
- payload:
ITEM_HERO_CHANGED- payload:
args[0] = itemId(string),args[1] = runtime(AbilityItemHero)
- payload:
ITEM_EQUIP_LIST_CHANGED- payload:
args[0] = action(INVENTORY_LIST_CHANGE_TYPE),args[1] = itemUid(string),args[2] = itemId(string),args[3] = runtimeOrNull(AbilityItemEquip)
- payload:
ITEM_CARD_LIST_CHANGED- payload:
args[0] = action(INVENTORY_LIST_CHANGE_TYPE),args[1] = itemId(string),args[2] = runtimeOrNull(AbilityItemCard)
- payload:
ITEM_MATERIAL_LIST_CHANGED- payload:
args[0] = action(INVENTORY_LIST_CHANGE_TYPE),args[1] = itemId(string),args[2] = runtimeOrNull(AbilityItemMaterial)
- payload:
ITEM_HERO_LIST_CHANGED- payload:
args[0] = action(INVENTORY_LIST_CHANGE_TYPE),args[1] = itemId(string),args[2] = runtimeOrNull(AbilityItemHero)
- payload:
RENTAL_CHANGED- payload:
args[0] = itemId(string),args[1] = expiresAtClientUtcMs(long),args[2] = active(bool)
- payload:
TREASURE_STATE_CHANGED- payload:
args[0] = gradeType(ITEM_GRADE_TYPE),args[1] = deltaCount(int),args[2] = currentCount(int),args[3] = currentLevel(int),args[4] = currentExp(int)
- payload:
INVENTORY_SNAPSHOT_CHANGED- payload:
args[0] = reason(INVENTORY_SNAPSHOT_CHANGE_REASON)
- payload:
사용 목적:
ACHIEVE_PASS.req_pass_id조건이 있는 runtime의WAIT -> ACTIVE전이를 위해 Pass 변동을 구독한다.- wallet/item UI는 타입별
*_CHANGED를 구독하고 payload 또는 현재 storage 재조회로 갱신한다. - item 추가/삭제는
*_LIST_CHANGED로 별도 발행한다. - load/import/clear 같은 bulk inventory 변경은 per-item replay 없이
INVENTORY_SNAPSHOT_CHANGED한 번만 발행한다.