[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBQ5NBY28215FAAME8P1N3":3,"skill-same:01M6CBQ5NBY28215FAAME8P1N3":50},{"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},"01M6CBQ5NBY28215FAAME8P1N3","10-reward-manager",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\u002F10-reward-manager\u002FSKILL.md",[],[18],"10 reward manager","2026-11-10 10:12:30",false,"# 10-reward-manager\n\n\nRewardManager는 입력된 `reward_group_id` 또는 **RewardData[]**를 해석하여 InventoryManager의 **타입별 구체 API**를 호출하여 로컬 인벤토리에 **적용(지급 실행)** 한다.\n\nRewardManager는 **단일 concrete 클래스**이다.\n- `reward_group_id -> RewardData[]` 변환은 `TB_REWARD.GetByGroup()` 을 직접 참조하여 구현한다.\n- `RewardData[]` 선검증(type\u002Fid\u002Famount) + 원자성(all-or-nothing)을 보장한다.\n- 멱등\u002F기록\u002F복구는 RewardManager의 책임이 아니다.\n\n\n---\n\n\n## Singleton\n\n```csharp\nCompoSingleton\u003CRewardManager>.Instance\n```\n\n- Registry key: `RewardManager`\n- 다른 매니저에서 접근: `Singleton.Get\u003CRewardManager>()`\n\n\n---\n\n\n## Responsibilities (정본)\n\n- `RewardData[]` 입력을 받아 `REWARD_TYPE`별로 해석하고, InventoryManager의 타입별 구체 API를 호출하여 로컬 인벤토리에 적용\n  - `type=REWARD_TYPE.CURRENCY`: `inv.ApplyCurrency(currency_type, amount)`\n  - `type=REWARD_TYPE.EQUIP`: `inv.ApplyEquip(item_id, amount)`\n  - `type=REWARD_TYPE.CARD`: `inv.ApplyCard(item_id, amount)`\n  - `type=REWARD_TYPE.HERO`: `inv.ApplyHero(item_id, amount)`\n  - `type=REWARD_TYPE.RENTAL`: `inv.ApplyRental(item_id)`\n  - `type=REWARD_TYPE.PASS`: `inv.SetPassOwnership(item_id, true)`\n  - `type=REWARD_TYPE.TREASURE`: `inv.ApplyTreasure(gradeType, amount)`\n- `reward_group_id`를 입력받아 `ResolveRewardDatas(reward_group_id)`로 `TB_REWARD.GetByGroup()` 에서 `RewardData[]`를 만든 뒤 적용\n- `RevokeRewardDatas` \u002F `RevokeRewardDatasPartial`로 RewardData[] 기반 회수 처리\n- `GetAmount(type, id)`로 RewardData 타입 기반 수량 조회\n- `FirstInitAsync()`로 초기 보상 지급 처리 (FirstRewardSettings 로드 + ApplyRewardDatas + 초기 선택 hero 적용)\n- public reward API의 실패는 `GameResult`로 반환한다.\n- `_validateRewardData` 같은 선검증 단계는 all-or-nothing 보장의 일부이며 삭제하지 않는다.\n\n비책임(금지):\n- `grantId` 멱등 처리\n- 지급 기록(ledger) 저장\u002F조회\n- Firebase Functions\u002FFirestore 호출\n- pending queue\u002F복구\n\n\n---\n\n\n## Dependencies (개념)\n\n- InventoryManager — RewardManager는 Inventory의 타입별 구체 API를 호출하여 적용한다.\n- FirstRewardSettings — 초기 보상 지급 데이터 소스 ScriptableObject.\n- SaveDataManager ↔ InventoryManager 직접 결합은 금지(상위 조립에서만 결합).\n\n## Crypto (AES)\n\nAES 암복호화 key\u002Fiv는 **MobileApplication**이 소유한다.\nRewardManager는 `MobileApplication.Instance`에서 key\u002Fiv를 읽어 사용한다.\n\n- key\u002Fiv 소유: `MobileApplication` (`[SerializeField] CString`, Inspector에 노출)\n- key\u002Fiv 생성: `MobileApplicationEditor` — \"Generate key iv\" 버튼\n- Static helper (RewardManager에 유지):\n  - `EncryptInitialRewardsJson(string plainJson, string keyBase64, string ivBase64) -> string` (AES-CBC + base64)\n  - `DecryptInitialRewardsJson(string encryptedBase64, string keyBase64, string ivBase64) -> string`\n- `_parseFirstRewardSettings()`에서 `MobileApplication.Instance.CryptoKey\u002FCryptoIv`를 참조한다.\n\n\n---\n\n\n## Public API\n\n- `ApplyRewardDatas(RewardData[] rewards) -> GameResult`\n  - 입력 전체를 선검증한다 (type\u002Fid\u002Famount).\n  - item reward(`CARD`\u002F`MATERIAL`\u002F`EQUIP`\u002F`HERO`)는 선검증 단계에서 대응 table row 존재 여부까지 확인한다.\n  - 하나라도 invalid면 `GameResult.Failure(error)`를 반환하고 상태를 변경하지 않는다.\n  - 전체 valid이면 `REWARD_TYPE`별 switch로 InventoryManager 구체 API를 호출하고, 하위 `GameResult` 실패를 그대로 propagate한다.\n  - 이 선검증 단계는 원자성 보장을 위해 유지한다. apply 루프의 예외 전파 모델로 대체하지 않는다.\n- `ApplyRewardGroup(reward_group_id, rewardAmountMultiplier) -> GameResult\u003CRewardApplyResult>`\n  - `RewardApplyResult.AppliedRewards`로 이번 호출에서 실제 적용한 `RewardData[]`를 조회할 수 있다.\n  - `reward_group_id`가 비어 있으면 성공 + 빈 배열(`AppliedRewards=[]`) 반환\n- `RevokeRewardDatas(RewardData[] rewards) -> GameResult`\n  - 선검증: 잔고 확인 (부족하면 `INVENTORY_REFUND_INSUFFICIENT`).\n  - 전체 valid이면 Revoke 적용.\n- `RevokeRewardDatasPartial(RewardData[] rewards) -> GameResult`\n  - 보유량과 요청량 중 작은 값만큼 차감한다.\n- `GetAmount(string type, string id) -> long`\n  - `(type,id)`에 대한 현재 수량을 반환한다.\n- `FirstInitAsync(CancellationToken ct) -> Task\u003CGameResult>`\n  - `FirstRewardSettings` 로드 → AES 복호화 → JSON 파싱 → `ApplyRewardDatas`로 적용.\n  - 보상 적용 후 `InventoryManager.LoadSettings()` 호출로 InventorySettings를 로드한다.\n  - `InventoryManager.ApplyCurrency(STAMINA, MaxStamina)`로 초기 스태미나 지급.\n  - `SelectedHeroUnitId`가 해석되면 대응 `ITEM_HERO.item_id`를 hero reward `+1`로 합성한 뒤 적용한다.\n  - 같은 `ITEM_HERO` row의 `initial_item_##`는 `EQUIP +1` reward로 합성하고, apply 후 `initial_slot_##`에 자동 장착한다.\n  - `FirstRewardSettings.SelectedHeroUnitId(UNIT_HERO_ID)`가 설정되어 있으면 `TB_ITEM_HERO.unit_id -> item_id`로 해석한 뒤 `InventoryManager.SelectedHeroId`에 적용한다.\n  - 선택 hero 해석 실패 또는 미보유 상태는 soft-fail로 보고 선택만 비운다.\n  - 리소스\u002F암호화\u002FJSON 실패는 운영 데이터 경계 실패로 보고 `GameResult`를 유지한다.\n\n\n---\n\n\n## Error Model (정본)\n\n- RewardManager의 public API는 `GameResult`를 유지한다.\n- invalid reward, empty id, amount 음수, item table miss, first-init parse 실패는 모두 boundary failure다.\n- recoverable failure를 `throw` 기본 모델로 바꾸지 않는다.\n- private helper에서만 내부 invariant 예외를 제한적으로 허용할 수 있다.\n- helper 예외가 public 경계를 넘어가야 한다면 boundary에서 다시 `GameResult`로 감싸는 쪽을 우선한다.\n\n---\n\n\n## Validation Rules (정본)\n\n- `rewards == null`이면 invalid다.\n- 각 reward에 대해 아래 조건을 모두 만족해야 valid다.\n  - `type`은 `REWARD_TYPE.CURRENCY`, `REWARD_TYPE.EQUIP`, `REWARD_TYPE.CARD`, `REWARD_TYPE.HERO`, `REWARD_TYPE.RENTAL`, `REWARD_TYPE.PASS`, `REWARD_TYPE.TREASURE` 중 하나여야 한다.\n  - `id`는 null\u002Fempty\u002Fwhitespace가 아니어야 한다.\n  - `amount >= 0` 이어야 한다.\n- `rewards.Length == 0`은 valid no-op으로 처리한다(`GameResult.Ok()` 반환).\n- `amount == 0`은 valid no-op delta로 처리한다(에러 아님).\n- `type=REWARD_TYPE.CURRENCY`일 때 `id`는 유효한 `CURRENCY_TYPE` enum name이어야 한다.\n- `type=REWARD_TYPE.TREASURE`일 때 `id`는 유효한 `ITEM_GRADE_TYPE` enum name이어야 하며, `NONE`이면 invalid다.\n\n\n---\n\n\n## Apply Atomicity (정본)\n\n- `ApplyRewardDatas`는 원자적으로 동작한다.\n- 입력 중 invalid가 하나라도 있으면 전체 실패한다.\n- factory\u002Ftable lookup 실패 가능성도 apply 이전 선검증에서 걸러져야 한다.\n- 전체 실패 시 InventoryManager 상태는 호출 전과 동일해야 한다.\n- 따라서 `_validateRewardData`는 optional 최적화가 아니라 계약의 일부다.\n\n\n---\n\n\n## Error Mapping (정본)\n\n- `ApplyRewardDatas` 실패는 `GameError(GAME_ERROR_TYPE, message, details)`를 사용한다.\n- 권장 `GAME_ERROR_TYPE`:\n  - `INVENTORY_DELTAS_NULL`\n  - `INVENTORY_DELTA_TYPE_INVALID`\n  - `INVENTORY_DELTA_ID_EMPTY`\n  - `INVENTORY_DELTA_AMOUNT_NEGATIVE`\n  - `ABILITY_ITEM_TABLE_NOT_FOUND`\n  - `INVENTORY_REFUND_INSUFFICIENT` (RevokeRewardDatas)\n- 새 코드는 `GAME_ERROR_TYPE` append-only 규칙과 prefix taxonomy를 따른다.\n- private helper 예외를 대체하기 위해 `GAME_ERROR_TYPE`을 추가하지 않는다.\n\n\n---\n\n\n## 컨텐츠 테이블 통합 (TB_REWARD 직접 참조)\n\n- `ResolveRewardDatas(reward_group_id) -> RewardData[]`\n  - `TB_REWARD.GetByGroup(reward_group_id)` 로 보상 그룹의 행 리스트를 조회하여 `RewardData[]`를 생성한다.\n  - 각 행의 `{ Type, Id, Amount }` → `RewardData` 변환. empty Id \u002F amount \u003C= 0 행은 skip.\n  - 원격 호출\u002F네트워크 금지. 테이블 조회만 허용.\n\n\n---\n\n\n## Implementation Location (3-path mirror)\n\n> 3-path mirror 정책: [devian-unity\u002F04-package-policy](..\u002F..\u002F..\u002F04-package-policy\u002FSKILL.md), [devian-unity\u002F01-policy](..\u002F..\u002F..\u002F01-policy\u002FSKILL.md) §SSOT 원칙\n\n- RewardManager:\n  - UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardManager.cs`\n  - Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardManager.cs`\n  - Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardManager.cs`\n- RewardData:\n  - UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n  - Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n  - Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n\nasmdef:\n- `Devian.Samples.MobilePackage.asmdef`\n- 참조: `Devian.Domain.Game` (TB_REWARD 테이블), `Devian.Domain.Game` (GameResult)\n\n\n---\n\n\n## Sequence Example\n\n1) 호출자가 `reward_group_id`를 결정한다.\n2) 호출자 → `Singleton.Get\u003CRewardManager>().ApplyRewardGroup(reward_group_id)`\n3) RewardManager: `ResolveRewardDatas(reward_group_id)` → `RewardData[]` → `ApplyRewardDatas(deltas)`\n4) RewardManager.ApplyRewardDatas: 선검증 → type switch → `InventoryManager.ApplyCurrency\u002FApplyEquip\u002F...` 호출\n\n\n---\n\n\n## Related\n\n- [49-reward-system\u002F03-ssot](..\u002F03-ssot\u002FSKILL.md) — RewardData 스키마 정본\n- [11-rewarddata-interpretation](..\u002F11-rewarddata-interpretation\u002FSKILL.md) — RewardData 해석 가이드\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\u002F10-reward-manager","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 10-reward-manager",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 10-reward-manager",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 10-reward-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F49-reward-system\u002F10-reward-manager\u002FSKILL.md",true,[44],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"agents\u002Fopenai.yaml","REFERENCE","参考文档",101,"https:\u002F\u002Fgithub.com\u002Fmalinskibeniamin\u002Fskills\u002Fblob\u002Fmain\u002Fcodex-skills\u002Fgrilling\u002Fagents\u002Fopenai.yaml",[51,57,65,73,82,89],{"skillNo":52,"name":53,"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":54,"categories":55,"keywords":56,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[53],{"skillNo":58,"name":59,"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":60,"categories":61,"keywords":62,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[63,64],"archive","90 project archive",{"skillNo":66,"name":67,"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":68,"categories":69,"keywords":70,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[71,72],"management","30 env management",{"skillNo":74,"name":75,"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":76,"categories":77,"keywords":78,"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",[],[79,80,81],"push","page","19 page push send",{"skillNo":83,"name":84,"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":85,"categories":86,"keywords":87,"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",[],[80,88],"18 page savedata",{"skillNo":90,"name":91,"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":92,"categories":93,"keywords":94,"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",[],[80,95],"17 page deobfuscate"]