[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBTMTFV4Z7YQ1ZCWV9XR5W":3,"skill-same:01M6CBTMTFV4Z7YQ1ZCWV9XR5W":62},{"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":22,"publishedAt":27,"linkOnly":28,"markdownContent":29,"markdownBody":29,"frontMatter":30,"refName":31,"commitSha":32,"skillDirectory":33,"forksCount":13,"repositoryHtmlUrl":34,"repositoryHomepageUrl":6,"ownerHtmlUrl":35,"ownerBlogUrl":6,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M6CBTMTFV4Z7YQ1ZCWV9XR5W","74-network-server",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\u002F10-module\u002F60-net\u002F74-network-server\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",[23,24,25,26],"network server","server","network","74 network server","2026-11-10 10:12:30",false,"# 74-network-server\n\nStatus: ACTIVE  \nAppliesTo: v10  \nSSOT: skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md\n\n## Purpose\n\nTypeScript 기반 네트워크 서버 모듈의 설계 원칙과 책임 분리를 정의한다.\n\n---\n\n## Import 정본 (Hard Rule)\n\n**Server 샘플\u002F런타임 import 정본은 `@devian\u002Fprotocol-game\u002Fserver-runtime` 이다.**\n\n```typescript\n\u002F\u002F ✅ 정본 (MUST)\nimport { createServerRuntime, Game2C } from '@devian\u002Fprotocol-game\u002Fserver-runtime';\n```\n\n**루트 import 금지 (Hard Rule):**\n\n```typescript\n\u002F\u002F ❌ 금지 - 루트에서 server runtime 가져오기\nimport { createServerRuntime } from '@devian\u002Fprotocol-game';  \u002F\u002F FAIL\n```\n\n- `@devian\u002Fprotocol-game` 루트 import로 server runtime을 가져오는 것은 **금지**\n- 루트 re-export가 코드에 남아있더라도, **문서\u002F샘플에서는 사용 금지**\n- 정본은 **반드시** `@devian\u002Fprotocol-game\u002Fserver-runtime` 서브패스 사용\n\n**이유:**\n- Server\u002FClient runtime 분리 명확화\n- 번들 사이즈 최적화 (tree-shaking)\n- 의존성 명시적 표현\n\n---\n\n## 설계 원칙\n\n### 1. 공용 모듈과 그룹별 런타임 분리\n\n- **@devian\u002Fcore**: 공용 코드만 포함\n  - WebSocket transport (세션 관리, binary send)\n  - Frame 파싱 (int32 LE opcode + payload)\n  - Tagged BigInt JSON codec (옵션)\n  - NetworkServer (runtime 주입)\n  - NetworkClient (runtime 주입)\n\n- **@devian\u002Fprotocol-{group}**: 그룹별 런타임 제공\n  - Inbound opcode 이름 조회\n  - Inbound dispatch (stub.dispatch)\n  - Outbound proxy 생성\n  - Protobuf codec (기본)\n  - Devian.Protocol.{Group} namespace 트리\n\n### 2. Codec 정합\n\nTS GameServer의 기본 codec은 Protobuf이다(인자 미주입).  \nJson은 `@devian\u002Fcore`의 `defaultCodec`를 runtime 생성 시 주입해서 선택한다.\n\n```typescript\nimport { defaultCodec as jsonCodec } from '@devian\u002Fcore';\nimport { createServerRuntime } from '@devian\u002Fprotocol-game\u002Fserver-runtime';\n\n\u002F\u002F 기본(Protobuf)\nconst serverA = createServerRuntime();\n\n\u002F\u002F Json 선택\nconst serverB = createServerRuntime(jsonCodec);\n```\n\n### 3. Unknown Opcode 정책\n\nUnknown inbound opcode는:\n- **절대 disconnect\u002Fclose 하지 않는다**\n- `onUnknownInboundOpcode` 훅으로 위임한다\n- 기본 동작은 warn 로그만\n\n---\n\n## 디렉토리 구조\n\n```\nframework-ts\u002Fmodule\u002Fdevian\u002F\n├── src\u002F\n│   ├── index.ts              # 모듈 exports\n│   ├── net\u002F\n│   │   ├── shared\u002F\n│   │   │   ├── frame.ts      # 프레임 파싱\u002F생성\n│   │   │   └── codec.ts      # Tagged BigInt JSON codec\n│   │   ├── transport\u002F\n│   │   │   ├── ITransport.ts # Transport 인터페이스\n│   │   │   └── WsTransport.ts # WebSocket 구현\n│   │   └── protocol\u002F\n│   │       ├── INetworkRuntime.ts   # 런타임 인터페이스\n│   │       ├── NetworkServer.ts     # 서버측 메시지 처리\n│   │       └── NetworkClient.ts     # 클라이언트측 메시지 처리\n```\n\n---\n\n## 책임 분리\n\n| 구성요소 | 책임 | 금지 |\n|----------|------|------|\n| WsTransport | 세션 관리, binary 송수신 | opcode 해석 |\n| NetworkServer | frame 파싱, runtime 호출 | disconnect on unknown |\n| NetworkClient | ws message → runtime dispatch | disconnect on unknown |\n| INetworkRuntime | opcode 조회, dispatch, proxy 생성 | - |\n| GameServer | 조립 + 핸들러 등록 | 비즈니스 로직 확장 |\n\n---\n\n## 예제 앱\n\n위치: `framework-ts\u002Fapps\u002FGameServer\u002F`\n\n예제 앱은 **조립 + 핸들러 등록만** 수행한다.\n\n```typescript\nimport { WsTransport, NetworkServer } from '@devian\u002Fcore';\nimport { createServerRuntime, Game2C } from '@devian\u002Fprotocol-game\u002Fserver-runtime';\n\n\u002F\u002F codec 미주입 = protobuf 기본\nconst runtime = createServerRuntime();\nconst stub = runtime.getStub();\n\n\u002F\u002F 핸들러 등록\nstub.onPing(async (sessionId, msg) => { ... });\nstub.onEcho(async (sessionId, msg) => { ... });\n```\n\n---\n\n## Reference\n\n- **공용 모듈:** `framework-ts\u002Fmodule\u002Fdevian\u002F`\n- **그룹 런타임:** `framework-ts\u002Fmodule\u002Fdevian-protocol-{group}\u002FGenerated\u002FServerRuntime.g.ts`\n- **정책 정본:** `skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F10-module\u002F60-net\u002F74-network-server","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":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add devwinsoft\u002Fdevian --skill 74-network-server",{"tool":44,"command":45},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 74-network-server",{"tool":47,"command":48},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 74-network-server","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F10-module\u002F60-net\u002F74-network-server\u002FSKILL.md",true,[52,58],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"agents\u002Fopenai.yaml","REFERENCE","参考文档",140,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-for-agents\u002Fagents\u002Fopenai.yaml",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"SKILL-MECHANICS.md",2629,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fwriting-for-agents\u002FSKILL-MECHANICS.md",[63,69,77,85,94,101],{"skillNo":64,"name":65,"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":66,"categories":67,"keywords":68,"publishedAt":27},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[65],{"skillNo":70,"name":71,"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":72,"categories":73,"keywords":74,"publishedAt":27},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[75,76],"archive","90 project archive",{"skillNo":78,"name":79,"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":80,"categories":81,"keywords":82,"publishedAt":27},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[83,84],"management","30 env management",{"skillNo":86,"name":87,"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":88,"categories":89,"keywords":90,"publishedAt":27},"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",[],[91,92,93],"push","page","19 page push send",{"skillNo":95,"name":96,"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":97,"categories":98,"keywords":99,"publishedAt":27},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[92,100],"18 page savedata",{"skillNo":102,"name":103,"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":104,"categories":105,"keywords":106,"publishedAt":27},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[92,107],"17 page deobfuscate"]