[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBCF9M1W0P3R0CSCYGM36G":3,"skill-same:01M6CBCF9M1W0P3R0CSCYGM36G":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},"01M6CBCF9M1W0P3R0CSCYGM36G","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\u002F21-game-package\u002F14-red-dot-system\u002F03-ssot\u002FSKILL.md",[],[18],"03 ssot","2026-11-10 10:12:30",false,"# 03-ssot — 14-red-dot-system\n\nStatus: ACTIVE\nAppliesTo: v10\n\n## SSOT Scope\n\n이 문서는 GamePackage red dot 시스템의 정본이다.\n\n- red dot key 표현\n- 내부 노드 상태 모델\n- 부모 집계 규칙\n- public API\n- 변경 이벤트 payload\n\n---\n\n## A) RedDotKey\n\n`RedDotKey`는 red dot 상태를 식별하는 문자열 key다.\n\n예:\n- `group`\n- `group.item001`\n- `mail.reward`\n- `mission.daily.claim`\n\n규칙:\n- `.` 기준 계층 문자열을 사용한다.\n- 빈 key, 선행\u002F후행 `.`, 빈 segment(`..`)는 invalid다.\n- 등록되지 않은 key는 기본적으로 off로 본다.\n\n---\n\n## B) Internal Node Model\n\n각 key는 내부적으로 `RedDotNode` 1개로 관리된다.\n\n정본 필드:\n\n- `Key`\n- `ParentKey`\n- `SelfOn`\n- `ActiveChildCount`\n- `IsOn = SelfOn || ActiveChildCount > 0`\n- `HasActiveChild = ActiveChildCount > 0`\n\n설명:\n- `SelfOn`은 해당 key 자신에게 직접 세팅된 상태다.\n- `ActiveChildCount`는 현재 on 상태인 직계 child 수다.\n- `IsOn`은 최종 집계 결과다.\n\n이 구조가 있기 때문에\n`Set(\"group.item001\", true)` 후 `group.HasActiveChild == true`를 판별할 수 있다.\n\n---\n\n## C) Key Creation Policy\n\n- `Set(key, true)`는 leaf와 필요한 parent key를 동적으로 생성한다.\n- `Set(key, false)` 또는 `Clear(key)`는 기존 key가 없으면 no-op이다.\n- parent key는 child 집계를 위해 자동 생성될 수 있다.\n\n---\n\n## D) Propagation Rules\n\n예:\n\n```text\ngroup\n└ group.item001\n```\n\n흐름:\n\n1. `Set(\"group.item001\", true)`\n2. `group.item001.SelfOn = true`\n3. `group.item001.IsOn = true`\n4. parent `group.ActiveChildCount += 1`\n5. `group.IsOn = true`\n6. `group.HasActiveChild = true`\n\n반대 흐름:\n\n1. `Set(\"group.item001\", false)`\n2. child `IsOn`이 false로 내려가면\n3. parent `group.ActiveChildCount -= 1`\n4. 남은 active child가 없고 `group.SelfOn == false`면 `group.IsOn = false`\n\n---\n\n## E) Public API\n\n```csharp\npublic sealed class RedDotManager : CompoSingleton\u003CRedDotManager>\n{\n    public void Set(string key, bool value);\n    public void Clear(string key);\n    public void ClearAll();\n\n    public bool IsOn(string key);\n    public bool Contains(string key);\n    public bool HasActiveChild(string key);\n    public bool TryGetState(string key, out RedDotStateView state);\n\n    public void Subcribe(EntityId ownerKey, string key, Action\u003CRedDotChanged> handler);\n    public void UnSubcribe(EntityId ownerKey);\n}\n```\n\n정책:\n- 상태 정본 접근은 `RedDotManager.Instance`를 사용한다.\n- 구독 ownerKey는 `UnityEngine.EntityId`를 사용한다.\n- `IsOn`만으로는 self on인지 child 집계 on인지 구분하지 않는다.\n- 원인 구분은 `HasActiveChild` 또는 `TryGetState`를 사용한다.\n- `Clear(key)`는 v1에서 `Set(key, false)`와 동일하다.\n\n---\n\n## F) State Snapshot\n\npublic 조회 정본:\n\n```csharp\npublic readonly struct RedDotStateView\n{\n    public string Key { get; }\n    public bool IsOn { get; }\n    public bool SelfOn { get; }\n    public bool HasActiveChild { get; }\n}\n```\n\n---\n\n## G) Event Model\n\ntrigger key:\n\n```csharp\npublic enum RED_DOT_MESSAGE_TYPE\n{\n    NONE = 0,\n    STATE_CHANGED = 1,\n}\n```\n\npayload 정본:\n\n```csharp\npublic sealed class RedDotChanged\n{\n    public string Key { get; }\n    public bool IsOn { get; }\n    public bool SelfOn { get; }\n    public bool HasActiveChild { get; }\n}\n```\n\n알림 규칙:\n- `RedDotManager`는 내부 상태 스냅샷이 실제로 변한 key만 이벤트를 발행한다.\n- payload에 `Key`, `IsOn`, `SelfOn`, `HasActiveChild`를 포함한다.\n- `BaseTrigger` msg key는 `STATE_CHANGED` 1개만 사용하고, 실제 red dot key 필터는 `RedDotManager.Subcribe(...)` wrapper가 수행한다.\n\n---\n\n## H) Non-goals (v1)\n\nv1에서 지원하지 않는다.\n\n- 숫자 badge\n- 서버 연동\n- 저장\u002F복원\n- batch update 최적화\n- 조건식 자동 평가\n- UI binding\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F21-game-package\u002F14-red-dot-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\u002F21-game-package\u002F14-red-dot-system\u002F03-ssot\u002FSKILL.md",true,[44],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"SKILL.md.AGENTS.md","REFERENCE","参考文档",1627,"https:\u002F\u002Fgithub.com\u002FBlackBeltTechnology\u002Fpi-agent-dashboard\u002Fblob\u002Fdevelop\u002Fpackages\u002Fextension\u002F.pi\u002Fskills\u002Fproject-access\u002FSKILL.md.AGENTS.md",[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"]