[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBQ3PZSM20M0KT8MWQSEHD":3,"skill-same:01M6CBQ3PZSM20M0KT8MWQSEHD":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},"01M6CBQ3PZSM20M0KT8MWQSEHD","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\u002F49-reward-system\u002F03-ssot\u002FSKILL.md",[],[18],"03 ssot","2026-11-10 10:12:30",false,"# 03-ssot — 49-reward-system (통합 SSOT)\n\n\nStatus: ACTIVE\nAppliesTo: v10\n\n\n## 이 문서가 정본이다 (SSOT)\n\nReward 관련 규칙의 단일 SSOT는 이 문서다.\n\n- RewardData(보상 적용 입력) 규약\n- reward_group_id 해석 책임(컨텐츠 레이어)\n- RewardManager의 \"지급 실행기\" 규약\n- REWARD 테이블 스키마(정규화)\n- 초기 보상 지급(FirstInit) 규약\n\n비정본(이 문서에서 다루지 않음):\n- 멱등\u002F기록\u002F복구(ledger\u002Fpending\u002F서버 확정) — 호출자 시스템의 정본을 참조한다.\n\n\n---\n\n\n## A) Core Terms (정본)\n\n- `RewardData`: 보상 적용 입력 단위 (`{ type, id, amount }`)\n- `RewardData[]`: 보상 적용 입력 payload (array)\n- `reward_group_id`: 보상 그룹 키. TB_REWARD 테이블의 `group:true` 컬럼. 여러 행을 하나의 보상 묶음으로 그룹화한다.\n- `reward_num`: 개별 보상 행의 PK (TB_REWARD 테이블 키, int). 직접 사용하지 않고, `reward_group_id`로 그룹 조회하여 사용한다.\n\n\n---\n\n\n## B) RewardData Schema (정본)\n\n`RewardData`는 `{ type, id, amount }` 형태다.\n\n- `type: REWARD_TYPE(enum, Generated)` — `REWARD_TYPE.CARD` | `REWARD_TYPE.CURRENCY` | `REWARD_TYPE.EQUIP` | `REWARD_TYPE.HERO` | `REWARD_TYPE.RENTAL` | `REWARD_TYPE.PASS`\n  - 입력: `input\u002FDomains\u002FGame\u002FENUM_META.json` → 생성: `Devian.Domain.Game.REWARD_TYPE`\n- `id: string`\n- `amount: long` (`>= 0`만 허용)\n\n이 스키마 문단이 `RewardData`의 단일 정본이다.\n`22-inventory-system`에서는 스키마를 재정의하지 않고 본 문서를 참조한다.\n\nNOTE:\n- `type=REWARD_TYPE.EQUIP`의 `id`는 `item_id(pk)`를 의미한다.\n- `type=REWARD_TYPE.CARD`의 `id`는 `item_id(pk)`를 의미한다.\n- `type=REWARD_TYPE.HERO`의 `id`는 `item_id(pk)`를 의미한다(TB_ITEM_HERO 테이블 키).\n- `type=REWARD_TYPE.RENTAL`의 `id`는 `item_id(pk)`를 의미한다 (예: `\"NO_ADS\"`). Amount=1은 \"활성화\" 의미.\n- `type=REWARD_TYPE.PASS`의 `id`는 `item_id(pk)`를 의미한다 (예: `\"S2026_01\"`). Amount=1은 \"소유\" 의미.\n- Reward\u002FPurchase grants에는 `options`가 없다. `options`는 Inventory 내부 속성으로만 관리된다.\n\n정합:\n- 서버 검증 응답 `grants[]`(지급 내역)과 동일 형태를 사용한다.\n- `grants[]`는 inventory 지급 전용이며, 권한\u002F플래그 변화는 별도 경로로 처리한다.\n\nNEEDS CHECK (형준 결정 필요):\n- `id` 네이밍 규칙(예: `gem`, `gold`, `item_sword_01`)\n\n\n---\n\n\n## C) REWARD 테이블 스키마 (정본)\n\nREWARD 테이블은 정규화된 1행=1보상 구조다.\n\n| 필드 | 타입 | Row 3 옵션 | 설명 |\n|------|------|-----------|------|\n| `Reward_num` | int | pk | 행별 고유 PK |\n| `Reward_group_id` | string | group:true | 보상 그룹 키 (여러 행을 묶음) |\n| `Type` | enum:REWARD_TYPE | | CARD \u002F CURRENCY \u002F EQUIP \u002F HERO \u002F RENTAL \u002F PASS |\n| `Id` | string | | 대상 ID (item_id 또는 Currency_type enum name) |\n| `Amount` | int | | 수량 |\n\n- `TB_REWARD.GetByGroup(reward_group_id)` → `IReadOnlyList\u003CREWARD>` (자동 생성)\n- Currency의 `Id`는 `CURRENCY_TYPE` enum name 문자열 (예: `\"GOLD\"`, `\"JEWEL_FREE\"`)\n\n\n---\n\n\n## C-2) Reward_group_id 해석 (정본)\n\nRewardManager가 `TB_REWARD` 테이블을 직접 참조하여 `reward_group_id`를 `RewardData[]`로 변환한다.\n`Devian.Samples.MobilePackage.asmdef`에 `Devian.Domain.Game` 참조가 포함되어 있다.\n\n- lookup key: `reward_group_id` (TB_REWARD group key)\n- API: `TB_REWARD.GetByGroup(reward_group_id)` → 행 리스트\n- 결과: `RewardData[]` (각 행의 `{ Type, Id, Amount }` → `RewardData` 변환)\n\nNOTE:\n- RewardManager는 변환된 `RewardData[]`를 \"적용(지급 실행)\"만 한다(멱등\u002F기록\u002F복구 금지).\n\n\n---\n\n\n## D) RewardManager 적용 규약 (정본)\n\n- RewardManager는 입력 `RewardData[]`를 받아 `REWARD_TYPE`별로 해석하고, InventoryManager의 타입별 구체 API를 호출하여 로컬 인벤토리에 적용한다.\n- RewardManager는 `RewardData` 선검증(type\u002Fid\u002Famount) + 원자성(all-or-nothing)을 보장한다.\n- public reward 적용 API의 실패 모델은 `GameResult`다. invalid reward \u002F table lookup \u002F parse 실패를 `throw` 기본값으로 바꾸지 않는다.\n- RewardManager는 다음을 하지 않는다:\n  - 멱등 처리(`grantId` 사용 금지)\n  - 지급 기록(ledger) 저장\n  - 서버 확정\u002F조회\n\n\n---\n\n\n## D-2) 초기 보상 지급 (FirstInit) 규약 (정본)\n\n- 초기 지급 데이터 소스는 `FirstRewardSettings` ScriptableObject다.\n  - Resources 경로: `Devian\u002FFirstRewardSettings`\n  - 프로젝트 에셋 경로: `Assets\u002FResources\u002FDevian\u002FFirstRewardSettings.asset`\n- `RewardManager.FirstInitAsync()`는 위 에셋의 `InitialRewards(CString)` payload를 읽는다.\n- `FirstRewardSettings`는 `SelectedHeroUnitId(UNIT_HERO_ID)`도 함께 가진다.\n- JSON을 `RewardData[]` 규약으로 파싱\u002F검증한다.\n- 허용 JSON:\n  - `RewardData[]`\n  - `{ \"rewards\": RewardData[] }`\n- 파싱\u002F검증 실패 시 `CommonResult.Failure`를 반환하고 적용하지 않는다.\n- 파싱 성공 시 `RewardManager.ApplyRewardDatas`로 적용한다.\n- `SelectedHeroUnitId`가 설정되어 있으면 대응 `ITEM_HERO.item_id`를 hero reward `+1`로 자동 합성한다.\n- 같은 `ITEM_HERO` row의 `initial_item_##`는 `ITEM_EQUIP +1` reward로 자동 합성한다.\n- apply 후 방금 지급된 equip uid를 `initial_slot_##`에 장착한다.\n- 이후 `SelectedHeroUnitId`를 `TB_ITEM_HERO.unit_id -> item_id`로 해석하여 `InventoryManager.SelectedHeroId`에 적용한다.\n- `SelectedHeroUnitId`가 비어 있거나 매핑\u002F보유 상태가 invalid면 선택 hero만 비운다(soft-fail).\n- `LoginManager`는 `FirstInitAsync`를 직접 호출한다. `LoginInitializeResult.IsInitial`을 확인한 뒤 실행한다.\n- first-init payload는 운영 데이터 경계다. AES\u002FJSON 실패도 결과 코드(`GameResult`)로 올리고 상위 호출자가 처리한다.\n\n정본: [12-first-reward-settings](..\u002F12-first-reward-settings\u002FSKILL.md)\n\n\n---\n\n\n## E) RewardData Runtime Type Location (reference)\n\n- `REWARD_TYPE` enum은 Generated이다 (입력: `input\u002FDomains\u002FGame\u002FENUM_META.json`, 네임스페이스: `Devian.Domain.Game`).\n- `RewardData` struct만 아래 파일에 수동 정의한다 (`using Devian.Domain.Game;` 필요).\n- UPM (정본):\n  `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n- Packages (sync):\n  `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n- Assets\u002FSamples (import):\n  `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FReward\u002FRewardData.cs`\n- 3-path mirror 정책: [devian-unity\u002F04-package-policy](..\u002F..\u002F..\u002F04-package-policy\u002FSKILL.md)\n\n\n---\n\n\n## Related\n\n- [11-rewarddata-interpretation](..\u002F11-rewarddata-interpretation\u002FSKILL.md) — RewardData 해석 절차\u002F타입별 의미\u002F소스별 파싱 가이드\n- [10-reward-manager](..\u002F10-reward-manager\u002FSKILL.md) — reward_group_id 변환과 적용 실행기\n- [12-first-reward-settings](..\u002F12-first-reward-settings\u002FSKILL.md) — FirstRewardSettings ScriptableObject (초기 보상 지급 설정)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F49-reward-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\u002F49-reward-system\u002F03-ssot\u002FSKILL.md",true,[44],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"agents\u002Fopenai.yaml","REFERENCE","参考文档",113,"https:\u002F\u002Fgithub.com\u002Fmalinskibeniamin\u002Fskills\u002Fblob\u002Fmain\u002Fcodex-skills\u002Fgolang\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"]