AGENT SKILL
14-leaderboard-season-reward-storage
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
14-leaderboard-season-reward-storage
Status: ACTIVE AppliesTo: v10 Type: Design / Storage SSOT
LeaderboardSeasonRewardStorage 저장 모델과 SaveData codec 정본이다.
Implementation Location (3-path mirror)
- UPM (정본):
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/Leaderboard/LeaderboardSeasonRewardStorage.csframework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodecLeaderboardReward.cs
- Packages (sync):
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/Leaderboard/LeaderboardSeasonRewardStorage.csframework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodecLeaderboardReward.cs
- Assets/Samples (import):
framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Leaderboard/LeaderboardSeasonRewardStorage.csframework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodecLeaderboardReward.cs
- SaveData 통합:
.../Runtime/SaveData/JsonCodec/SaveDataJsonCodec.cs.../Runtime/SaveData/SaveDataManager.cs
Ownership
LeaderboardManager가 storage를 소유한다.- 정본 접근 경계:
LeaderboardManager.Storage
Storage Model
LeaderboardSeasonRewardStorage 필드:
schemaVersionprocessedClaims: Dictionary<string, LeaderboardSeasonRewardClaimRecord>
LeaderboardSeasonRewardClaimRecord 필드:
resultType: LeaderboardSeasonRewardResultTyperank: longscore: longreward_group_id: stringevaluatedAtServerUtcMs: long
LeaderboardSeasonRewardResultType:
NONECLAIMEDNO_PARTICIPATIONRANK_OUT_OF_REWARD
Key Format
- claim key:
{leaderboard_id} - 예:
leaderboard_001
SaveData Payload
- payload key:
leaderboardReward - version:
v14+
{
"version": 14,
"leaderboardReward": {
"schemaVersion": 1,
"processedClaims": {
"leaderboard_001": {
"resultType": 1,
"rank": 77,
"score": 123456,
"reward_group_id": "lb_s2026_q1_normal_51_100",
"evaluatedAtServerUtcMs": 1760000000000
}
}
}
}
Deserialize Rules
storage.Clear()후 복원- invalid/unknown
resultType는NONE으로 보정 version < 14면leaderboardReward는 clear 상태 유지
Hard Rules
- 지급 여부 dedupe는
processedClaims존재 여부로만 판정 - claim payload에 보상 상세(
RewardData[])를 저장하지 않는다 - 보상 실행 입력은
reward_group_id만 보존한다