[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBV0MAD64MHD7ZYPGVXGDT":3,"skill-same:01M6CBV0MAD64MHD7ZYPGVXGDT":45},{"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":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBV0MAD64MHD7ZYPGVXGDT","16-common-error",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\u002F20-domain-common\u002F16-common-error\u002FSKILL.md",[],[18,19],"common","16 common error","2026-11-10 10:12:30",false,"# 16-common-error\n\nStatus: ACTIVE\nAppliesTo: v10\n\n## SSOT\n\n이 문서는 **CommonError \u002F COMMON_ERROR_TYPE \u002F COMMON_ERROR 테이블 규약**의 정본이다.\n\n---\n\n## 목적\u002F범위\n\nCommon 레이어의 에러 표현을 표준화한다.\n\n- 런타임 에러 객체: `CommonError`\n- 에러 코드 enum: `COMMON_ERROR_TYPE`\n- 에러 코드 마스터: `CommonTable.xlsx`의 `COMMON_ERROR` 시트\n- 주 용도: public\u002Fboundary API가 호출자에게 돌려줄 실패 식별자\n\n중요:\n- `COMMON_ERROR`는 boundary failure 식별 체계다.\n- private helper 내부 invariant 예외를 모두 `COMMON_ERROR_TYPE`로 승격시키는 용도로 쓰지 않는다.\n- Game table lookup \u002F Ability factory 같은 Game 도메인 규칙 실패는 [21-domain-game\u002F14-game-error](..\u002F..\u002F21-domain-game\u002F14-game-error\u002FSKILL.md)의 `GAME_ERROR`로 분리한다.\n\n---\n\n## Canonical Source (Hard Rule)\n\n### COMMON_ERROR (XLSX)\n\n`COMMON_ERROR_TYPE`의 정본은 아래 테이블이다.\n\n- 파일: `input\u002FDomains\u002FCommon\u002FCommonTable.xlsx`\n- 시트: `COMMON_ERROR`\n- 컬럼(최소): `id`, `msg_key`, `msg`\n\nHard Rule:\n- `COMMON_ERROR`는 **append(맨 아래 행 추가)만 허용**한다.\n- 중간 삽입\u002F정렬\u002F행 재배치 금지 (기존 enum 값이 변동될 수 있음)\n- 새 코드가 필요하면 `COMMON_ERROR`에 추가한 뒤 **생성 파이프라인을 실행**해 `COMMON_ERROR_TYPE`을 갱신한다.\n- 예: config parse 실패는 `COMMON_CONFIG_PARSE_FAILED`처럼 전용 코드를 추가해 구분한다.\n\n### Prefix Taxonomy (Hard)\n\n새 코드는 prefix 기준으로 분류한다.\n\n- `COMMON_*` — 범용 인프라\u002F공통 입력\u002F네트워크\u002F서버\u002Funknown\n- `SAVEDATA_*` — save\u002Fload\u002Fsync 실패\n- `LOGIN_*` — 로그인\u002F인증 실패\n- `PUSH_*` — push 알림 관련 실패\n- `VERSION_CHECK_*` — 버전 체크 관련 실패\n\nGame 도메인 prefix (`INVENTORY_*`, `SHOP_*`, `TREASURE_*`, `PURCHASE_*`, `MISSION_*`, `ACHIEVE_*`, `LEADERBOARD_*`, `ATTEND_*`, `ADS_*`, `IAP_*`)는 [21-domain-game\u002F14-game-error](..\u002F..\u002F21-domain-game\u002F14-game-error\u002FSKILL.md)로 이관되었다.\n\n### When To Add A New Code\n\n새 `COMMON_ERROR_TYPE`은 아래 조건을 만족할 때만 추가한다.\n\n- 호출자가 코드별 분기를 해야 한다.\n- 운영\u002F로그 분석에서 독립 식별자가 필요하다.\n- `COMMON_INVALID_ARGUMENT` 또는 `COMMON_UNKNOWN`으로는 의미가 흐려진다.\n\n추가하지 않는 경우:\n\n- private helper 내부 예외\n- 호출자가 동일하게 처리할 실패\n- 메시지만 다르고 정책은 같은 실패\n\n### Numeric Value Rule (Hard)\n\n- `COMMON_ERROR_TYPE.SUCCESS`는 **예약된 센티넬 코드**이며, 값은 **반드시 `0`** 이어야 한다.\n- `COMMON_ERROR_TYPE`의 **실패 코드들은 모두 `> 0`** 이어야 한다.\n- `COMMON_ERROR`의 첫 항목(값 `0`)은 `SUCCESS`여야 한다. (예: `id=SUCCESS`, `msg=Success`)\n- `SUCCESS`는 주로 기본값\u002F외부 연동\u002F테이블 정합성 용도이며, 정상 경로 자체는 `CommonResult`의 성공 상태(`Error == null`)로 표현한다.\n- 초기 정렬(부트스트랩) 이후에는 append-only 규칙을 계속 유지한다. (`SUCCESS=0` 고정, 실패 코드는 뒤에만 추가)\n\n---\n\n## Runtime Type: CommonError\n\n### 정의\n\n- `CommonError.Code`의 타입은 **반드시 `COMMON_ERROR_TYPE`** 이다.\n- 문자열 코드(string) 기반 에러 코드는 정식 경로로 사용하지 않는다.\n\n필드(개념):\n- `Code: COMMON_ERROR_TYPE`\n- `Message: string`\n- `Details: string?`\n\n### 생성 규칙\n\n- 정상 경로: `new CommonError(COMMON_ERROR_TYPE.X, message, details?)`\n- 금지: `new CommonError(COMMON_ERROR_TYPE.SUCCESS, ...)` (정상 경로는 `CommonResult` 성공으로 표현)\n- 레거시 문자열 코드가 들어오는 경로가 남아있다면:\n  - `COMMON_ERROR_TYPE.COMMON_UNKNOWN`으로 매핑하고\n  - 레거시 코드는 `Details`에 `legacyCode=...` 형태로 보존한다.\n\nBoundary Rule:\n- validation \u002F Common table lookup \u002F restore \u002F config parse 같은 public 경계 실패는 `CommonError`로 표준화한다.\n- internal invariant 위반은 `CommonError`를 새로 추가하기보다 예외로 남길 수 있다.\n\n---\n\n## 소비 규칙\n\n- 비교는 enum 비교로만 한다.\n  - `err.Code == COMMON_ERROR_TYPE.X`\n- 외부 출력\u002F로그에서 문자열이 필요하면:\n  - `err.Code.ToString()`을 사용한다.\n\n---\n\n## DoD\n\nHard\n- `COMMON_ERROR`에 새 항목 추가 시 **append만** 수행되었음\n- 런타임 에러의 `Code`는 `COMMON_ERROR_TYPE`으로 유지됨\n- `COMMON_ERROR_TYPE.SUCCESS == 0` 이고, 실패 코드는 `> 0` 임\n- 새 코드가 taxonomy\u002Fpolicy 기준에 맞게 추가되었음\n\nSoft\n- 없음\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F20-domain-common\u002F16-common-error","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":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 16-common-error",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 16-common-error",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 16-common-error","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F20-domain-common\u002F16-common-error\u002FSKILL.md",true,[],[46,52,60,68,77,84],{"skillNo":47,"name":48,"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":49,"categories":50,"keywords":51,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[48],{"skillNo":53,"name":54,"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":55,"categories":56,"keywords":57,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[58,59],"archive","90 project archive",{"skillNo":61,"name":62,"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":63,"categories":64,"keywords":65,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[66,67],"management","30 env management",{"skillNo":69,"name":70,"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":71,"categories":72,"keywords":73,"publishedAt":20},"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",[],[74,75,76],"push","page","19 page push send",{"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":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[75,83],"18 page savedata",{"skillNo":85,"name":86,"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":87,"categories":88,"keywords":89,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[75,90],"17 page deobfuscate"]