[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBNFJ0XKDJVSZRHWT4CFVP":3,"skill-same:01M6CBNFJ0XKDJVSZRHWT4CFVP":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},"01M6CBNFJ0XKDJVSZRHWT4CFVP","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\u002F46-achieve-system\u002F03-ssot\u002FSKILL.md",[],[18],"03 ssot","2026-11-10 10:12:30",false,"# 03-ssot — 46-achieve-system\n\nStatus: ACTIVE\nAppliesTo: v10\n\n## SSOT 범위\n\n이 문서는 Achieve 시스템의 정본이다.\n\n- 업적 runtime 테이블: `ACHIEVE_SOCIAL`, `ACHIEVE_PASS`\n- 진행 stat 정본: `MESSAGE`\n- 업적 알림 enum: `ACHIEVE_MESSAGE_TYPE`\n- 업적 타입 enum: `ACHIEVE_TYPE` (`NONE`, `SOCIAL`, `PASS`)\n- 플랫폼 업적 매핑: `ACHIEVE_SOCIAL.achieve_id -> (apple_achievement_id, google_achievement_id)`\n- 저장 구조: `AchieveStorage` + `AchieveRuntimeBase`\n\n---\n\n## A. Runtime Source\n\n- 파일: `input\u002FDomains\u002FGame\u002FAchieveTable.xlsx`\n- 시트: `ACHIEVE_SOCIAL`\n- 컨테이너: `TB_ACHIEVE_SOCIAL`\n\n### `ACHIEVE_SOCIAL` schema\n\n| field | type | note |\n|------|------|------|\n| `index` | int (pk) | row pk |\n| `achieve_id` | string | 업적 그룹\u002F내부 업적 ID |\n| `is_active` | bool | 운영 토글 |\n| `level` | int | 단계 |\n| `order_num` | int | 정렬 기준(1-base) |\n| `req_msg_id` | string | runtime 활성화 조건 메시지 (`MESSAGE.message_id` FK) |\n| `req_value` | `class:CBigInt` | runtime 활성화 조건값 |\n| `condition_msg_id` | string | 진행도 계산 메시지 (`MESSAGE.message_id` FK) |\n| `condition_value` | `class:CBigInt` | 목표값 |\n| `reward_group_id` | string | claim 보상 키 |\n| `apple_achievement_id` | string | Game Center ID (`achieve_id` group 공통) |\n| `google_achievement_id` | string | GPGS ID (`achieve_id` group 공통) |\n\n### `ACHIEVE_PASS` schema\n\n- 파일: `input\u002FDomains\u002FGame\u002FAchieveTable.xlsx`\n- 시트: `ACHIEVE_PASS`\n- 컨테이너: `TB_ACHIEVE_PASS`\n\n| field | type | note |\n|------|------|------|\n| `index` | int (pk) | row pk |\n| `achieve_id` | string | 업적 그룹\u002F내부 업적 ID |\n| `is_active` | bool | 운영 토글 |\n| `level` | int | 단계 |\n| `order_num` | int | 정렬 기준(1-base) |\n| `req_pass_id` | string | runtime 활성화 조건 pass ID (`InventoryStorage.Passes` key) |\n| `req_season_id` | string | runtime 활성화 조건 season ID (`SEASON.season_id` FK, 시즌 기간 조건) |\n| `condition_msg_id` | string | 선택 조건 메시지 (`MESSAGE.message_id` FK), 비어있으면 즉시 claim 경로 |\n| `condition_value` | `class:CBigInt` | 선택 목표값 (`condition_msg_id`가 있을 때 사용) |\n| `reward_group_id` | string | claim 보상 키 |\n\n---\n\n## B. Runtime\u002FStorage Rules\n\n`AchieveStorage`:\n- `schemaVersion`\n- `nextAchieveUid`\n- `runtimes: Dictionary\u003Cint, AchieveRuntimeBase>`\n\n`AchieveRuntimeBase` 저장 필드:\n- `achieveType`, `achieve_id`, `achieveUid`, `level`, `index`, `progressValue`, `state`\n\n규칙:\n- period 개념 없음 (`periodKey` 없음)\n- group(`achieve_id`)당 runtime 1개 유지\n- level-up 시 `achieveUid` 유지\n- 초기화 시 `achieve_id` group 기준 runtime을 항상 생성한다.\n- 타입별 req 규칙으로 `WAIT\u002FACTIVE` 시작 상태를 결정한다.\n  - `ACHIEVE_SOCIAL`: `req_msg_id\u002Freq_value`\n  - `ACHIEVE_PASS`: `req_pass_id` \u002F `req_season_id`\n- `WAIT` 상태는 `condition_msg_id` 진행도 반영을 하지 않는다.\n- req 조건을 만족하면 `WAIT -> ACTIVE`로 전이한다.\n  - req message 조건: `GameMessageManager` stat\u002Ftrigger 기반\n  - req pass 조건: `InventoryManager.Instance.Storage.Passes` 보유 체크\n- 진행값은 saveType 규칙을 따른다:\n  - `TOTAL_SUM`, `TOTAL_MAX`: 외부 저장(`GameMessageStorage`) 값을 projection\n  - `SESSION_SUM`, `SESSION_MAX`: runtime 내부 `progressValue`를 직접 누적\u002F갱신\n\n---\n\n## C. Claim \u002F Level-up Rules\n\nclaim 성공 시:\n1. current row reward 적용\n2. next level row가 있으면 runtime 재바인딩\n   - next row의 타입별 req 조건을 다시 평가해 `WAIT` 또는 `ACTIVE`로 전환\n3. next가 없으면 completed\n4. 저장 수행\n5. 플랫폼 unlock best-effort (`ACHIEVE_TYPE.SOCIAL`만 수행)\n\n---\n\n## D. Event\n\n- `OnRuntimeInitialized(AchieveRuntimeBase)`\n- `OnRuntimeActive(AchieveRuntimeBase)` (`WAIT -> ACTIVE` 전이 시 1회)\n- `OnRuntimeProgress(AchieveRuntimeBase)`\n- `OnRuntimeClaimable(AchieveRuntimeBase)`\n- `OnRuntimeLevelUp(AchieveRuntimeBase)`\n- `OnRuntimeRewarded(AchieveRuntimeBase, RewardData[])`\n- `OnAchievementUnlocked(string achievementId)`\n\n`AchieveMessageTrigger` payload 규약:\n- key: `ACHIEVE_MESSAGE_TYPE`\n- `RUNTIME_*`: `args[0] = AchieveRuntimeBase`\n- `RUNTIME_REWARDED`: `args[1] = RewardData[]`\n- `RUNTIME_UNLOCKED`: `args[0] = string achievementId`\n\n---\n\n## Related\n\n- [13-achieve-runtime](..\u002F13-achieve-runtime\u002FSKILL.md)\n- [14-achieve-storage](..\u002F14-achieve-storage\u002FSKILL.md)\n- [15-achieve-message-trigger](..\u002F15-achieve-message-trigger\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F46-achieve-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\u002F46-achieve-system\u002F03-ssot\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"]