[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBQ7PJ3X4E2FHNRKZ2ZRAQ":3,"skill-same:01M6CBQ7PJ3X4E2FHNRKZ2ZRAQ":55},{"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":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBQ7PJ3X4E2FHNRKZ2ZRAQ","11-rewarddata-interpretation",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\u002F49-reward-system\u002F11-rewarddata-interpretation\u002FSKILL.md",[],[18,19],"interpretation","11 rewarddata interpretation","2026-11-10 10:12:30",false,"# 11-rewarddata-interpretation\n\n\nStatus: ACTIVE\nAppliesTo: v10\n\n\n## Purpose\n\n`RewardData`를 어디서 받아도 동일하게 해석하기 위한 실무 가이드다.\n\n- 대상: `TB_REWARD` 그룹 해석, `FirstRewardSettings.InitialRewards` 설정값\n- 목표: `type\u002Fid\u002Famount`를 인벤토리 적용 의미로 일관되게 해석\n\n\n---\n\n\n## Canonical Shape\n\n런타임 타입(`RewardData.cs`) 기준:\n\n- `Type: REWARD_TYPE`\n- `Id: string`\n- `Amount: int`\n\n정본 스키마\u002F용어는 [03-ssot](..\u002F03-ssot\u002FSKILL.md)를 따른다.\n\n\n---\n\n\n## Interpretation Order (정본)\n\n1. 입력을 `{ type, id, amount }` 형태로 정규화한다.\n2. 공통 검증을 수행한다.\n3. `type`별 의미로 해석한다.\n4. 적용 호출(`RewardManager.ApplyRewardDatas`)로 전달한다.\n\n\n---\n\n\n## Common Validation\n\n- `type`은 허용 enum 값이어야 한다:\n  - `CARD`, `CURRENCY`, `EQUIP`, `HERO`, `MATERIAL`, `RENTAL`, `PASS`, `TREASURE`\n- `id`는 공백이 아니어야 한다.\n- `amount`는 정수여야 한다.\n- 적용 경로 기준으로 `amount \u003C= 0`은 지급 대상에서 제외(no-op 또는 skip)한다.\n- 이 검증 실패는 public reward 경계에서 `GameResult` 실패로 표현한다. 해석 경로를 `throw` 중심으로 바꾸지 않는다.\n\n\n---\n\n\n## Type Semantics\n\n| `type` | `id` 의미 | `amount` 의미 | 적용 결과 |\n|---|---|---|---|\n| `CURRENCY` | `CURRENCY_TYPE` enum name | 증가 수량 | 잔고 누적 |\n| `EQUIP` | `item_id` | 생성 개수 | 개수만큼 `itemUid` 인스턴스 생성 |\n| `CARD` | `item_id` | 증가 수량 | 카드 보유량 누적 |\n| `MATERIAL` | `item_id` | 증가 수량 | 재료 보유량(`ITEM_AMOUNT`) 누적 |\n| `HERO` | `item_id` | 증가 수량 | 영웅 수량(`ITEM_AMOUNT`) 누적 |\n| `RENTAL` | `item_id` | 활성화 플래그(양수) | 활성 상태 설정 (`SetRental`) |\n| `PASS` | `item_id` | 소유 플래그(양수) | 소유 상태 설정 (`SetPassOwnership`) |\n| `TREASURE` | `ITEM_GRADE_TYPE` enum name | chest 수량 | treasure chest count 누적 |\n\n주의:\n- `RENTAL`\u002F`PASS`는 양수 여부만 의미가 있다(값의 크기 자체는 의미 없음).\n- `EQUIP`은 `amount`를 무시하지 않는다. `amount`만큼 인스턴스를 생성한다.\n\n\n---\n\n\n## Source-specific Parse Rules\n\n### A) RewardGroup (`TB_REWARD.GetByGroup`)\n\n구현: `RewardManager.ResolveRewardDeltas`\n\n- 행의 `Id`가 비어 있거나 `Amount \u003C= 0`이면 skip\n- 나머지는 `new RewardData(row.Type, row.Id, row.Amount)`로 변환\n\n\n### B) FirstRewardSettings Initial Rewards\n\n구현: `RewardManager.FirstInitAsync` -> `parseFirstRewardSettings`\n\n- 입력 소스: `Assets\u002FResources\u002FDevian\u002FFirstRewardSettings.asset` -> `FirstRewardSettings.InitialRewards` (`CString`)\n- 허용 JSON 형태:\n  - `RewardData[]`\n  - `{ \"rewards\": RewardData[] }`\n- `SEASON_PASS`는 legacy 호환으로 `PASS`로 변환\n- `amount`는 정수이며 `1..int.MaxValue` 범위만 허용\n- 검증 실패 시 `GameResult` 실패로 중단한다\n- first-init payload는 운영 데이터 경계다. parse 실패는 호출자에게 결과 코드로 보고한다.\n\n\n---\n\n\n## Apply Contract (Reward)\n\n`RewardManager.ApplyRewardDatas` 기준:\n\n- `rewards == null`은 실패\n- 각 row에서\n  - invalid `type` 실패\n  - empty `id` 실패\n  - `amount \u003C 0` 실패\n  - `amount == 0` no-op\n- 검증 통과 후 type별 InventoryManager 구체 API 호출\n- RewardManager의 two-phase 검증은 원자성 보장의 일부이므로 유지한다.\n\n\n---\n\n\n## Quick Examples\n\n```json\n[\n  { \"type\": \"CURRENCY\", \"id\": \"GOLD\", \"amount\": 1000 },\n  { \"type\": \"EQUIP\", \"id\": \"equip_sword_001\", \"amount\": 2 },\n  { \"type\": \"MATERIAL\", \"id\": \"material_stone_001\", \"amount\": 10 },\n  { \"type\": \"RENTAL\", \"id\": \"NO_ADS\", \"amount\": 1 }\n]\n```\n\n해석 결과:\n- GOLD +1000\n- `equip_sword_001` 인스턴스 2개 생성\n- `material_stone_001` 수량 +10\n- NO_ADS rental 활성화\n\n\n---\n\n\n## Code References\n\n- RewardData: `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F0.1.0\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n- RewardGroup 해석: `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F0.1.0\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardManager.cs`\n- 실제 적용(type switch): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F0.1.0\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardManager.cs`\n- InventoryManager(타입별 구체 API): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F0.1.0\u002FMobilePackage\u002FRuntime\u002FInventory\u002FInventoryManager.cs`\n\n\n---\n\n\n## Related\n\n- [03-ssot](..\u002F03-ssot\u002FSKILL.md) — RewardData 스키마\u002F용어 정본\n- [10-reward-manager](..\u002F10-reward-manager\u002FSKILL.md) — reward_group_id -> RewardData[] 변환\u002F적용\n- [12-first-reward-settings](..\u002F12-first-reward-settings\u002FSKILL.md) — FirstRewardSettings ScriptableObject\n- [22-inventory-system\u002F10-inventory-manager](..\u002F..\u002F22-inventory-system\u002F10-inventory-manager\u002FSKILL.md) — InventoryManager (타입별 구체 API)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F49-reward-system\u002F11-rewarddata-interpretation","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":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 11-rewarddata-interpretation",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 11-rewarddata-interpretation",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 11-rewarddata-interpretation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F49-reward-system\u002F11-rewarddata-interpretation\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"SOURCE.md","REFERENCE","参考文档",187,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Faerodrome-finance\u002FSOURCE.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"TRUST.auto.yaml",2217,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fdefi\u002Faerodrome-finance\u002FTRUST.auto.yaml",[56,62,70,78,87,94],{"skillNo":57,"name":58,"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":59,"categories":60,"keywords":61,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[58],{"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":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[68,69],"archive","90 project archive",{"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":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[76,77],"management","30 env management",{"skillNo":79,"name":80,"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":81,"categories":82,"keywords":83,"publishedAt":20},"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",[],[84,85,86],"push","page","19 page push send",{"skillNo":88,"name":89,"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":90,"categories":91,"keywords":92,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[85,93],"18 page savedata",{"skillNo":95,"name":96,"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":97,"categories":98,"keywords":99,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[85,100],"17 page deobfuscate"]