[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBQH1SPYG3VVYPW4SRFB1S":3,"skill-same:01M6CBQH1SPYG3VVYPW4SRFB1S":44},{"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},"01M6CBQH1SPYG3VVYPW4SRFB1S","10-leaderboard-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\u002F50-leaderboard\u002F10-leaderboard-manager\u002FSKILL.md",[],[18],"10 leaderboard manager","2026-11-10 10:12:30",false,"# 10-leaderboard-manager\n\nStatus: ACTIVE\nAppliesTo: v10\n\nMobilePackage 샘플의 `LeaderboardManager` 설계 문서다.\n\n---\n\n## Implementation Location (3-path mirror)\n\n- UPM (정본):\n  `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FLeaderboard\u002FLeaderboardManager.cs`\n- Packages (sync):\n  `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FLeaderboard\u002FLeaderboardManager.cs`\n- Assets\u002FSamples (import):\n  `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FLeaderboard\u002FLeaderboardManager.cs`\n\n---\n\n## Public API\n\n- `InitializeAsync(ct)` -> `Task\u003CGameResult>`\n- `ReportScoreAsync(leaderboard_id, ct)` -> `Task\u003CGameResult>`\n- `GetPlayerSnapshotAsync(leaderboard_id, ct)` -> `Task\u003CGameResult\u003CLeaderboardPlayerSnapshot>>`\n- `SyncSeasonTransitionRewardsAsync(ct)` -> `Task\u003CGameResult>`\n- `ClearStorage()`\n\n초기화 규약:\n- `LeaderboardManager`는 `MobileApplication.Instance`가 존재하면 Awake\u002FStart에서 `InitializeAsync`를 자체 수행한다.\n- `ReportScoreAsync`, `GetPlayerSnapshotAsync`, `SyncSeasonTransitionRewardsAsync`는 내부에서 초기화를 보장한다.\n- 외부에서 `InitializeAsync`를 명시 호출해도 무방하지만 필수는 아니다.\n\nobsolete:\n- `ReportScoreAsync(leaderboard_id, score, ct)` (deprecated shim)\n\n---\n\n## Internal Adapter Contract\n\n- `InitializeAsync(ct)`\n- `ReportScoreAsync(platformLeaderboardId, score, ct)`\n- `LoadPlayerSnapshotAsync(platformLeaderboardId, internalLeaderboardId, ct)`\n\nAdapter 계약은 `internal\u002Fprivate` 범위로만 사용한다.\n\n---\n\n## Score Resolution Rules\n\n- 상위에서 점수를 직접 전달하지 않는다.\n- `LEADERBOARD.message_id`를 기준으로 score를 내부 계산한다.\n- score 소스:\n  - `GameMessageManager.Storage.stats[message_id]`\n- 허용 saveType:\n  - `TB_GAME_MESSAGE.saveType == TOTAL_SUM || TOTAL_MAX`\n- 허용되지 않는 saveType이면:\n  - 점수 `0` 반환\n  - error log 기록\n- score가 `long.MaxValue` 초과면 clamp 후 전송한다.\n\n## Season Time Gate\n\n- `ReportScoreAsync`는 점수 제출 전 시즌 활성 기간을 확인한다.\n- 시즌 시간 조회: `LEADERBOARD.season_id → TB_SEASON.Get(season_id) → Start_utc_time\u002FEnd_utc_time`\n- 조건: `SEASON.Start_utc_time \u003C= serverNowUtcMs \u003C SEASON.End_utc_time`\n- 시즌 외 기간이면 `GameResult.Failure` 반환.\n- `season_id`가 비어 있으면 시간 제한을 적용하지 않는다.\n\n---\n\n## Snapshot Rules\n\n`LeaderboardPlayerSnapshotStatus`:\n- `Success`\n- `NoScore`\n- `PlatformUnavailable`\n- `NotLoggedIn`\n- `Failed`\n\nseason reward 평가는 위 status를 그대로 사용한다.\n\n---\n\n## Hard Rules\n\n- 외부 API는 내부 `leaderboard_id`만 사용\n- 업적 Unlock\u002FSync 로직 포함 금지 (`AchieveManager` 책임)\n- 시즌 보상 claim 상태 저장\u002F관리 책임은 `LeaderboardManager.Storage(LeaderboardSeasonRewardStorage)`가 가진다.\n- 미지원 플랫폼 안전 실패\n- 시즌 외 점수 기록 금지 (시즌 활성 기간에만 `ReportScoreAsync` 성공)\n\n---\n\n## Related\n\n- [03-ssot](..\u002F03-ssot\u002FSKILL.md)\n- [45-game-message-system\u002F10-game-message-manager](..\u002F..\u002F45-game-message-system\u002F10-game-message-manager\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F50-leaderboard\u002F10-leaderboard-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-leaderboard-manager",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 10-leaderboard-manager",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 10-leaderboard-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F50-leaderboard\u002F10-leaderboard-manager\u002FSKILL.md",true,[],[45,51,59,67,76,83],{"skillNo":46,"name":47,"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":48,"categories":49,"keywords":50,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[47],{"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},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[57,58],"archive","90 project archive",{"skillNo":60,"name":61,"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":62,"categories":63,"keywords":64,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[65,66],"management","30 env management",{"skillNo":68,"name":69,"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":70,"categories":71,"keywords":72,"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",[],[73,74,75],"push","page","19 page push send",{"skillNo":77,"name":78,"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":79,"categories":80,"keywords":81,"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",[],[74,82],"18 page savedata",{"skillNo":84,"name":85,"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":86,"categories":87,"keywords":88,"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",[],[74,89],"17 page deobfuscate"]