[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBVZ8FF3GPMVARKWETSRW8":3,"skill-same:01M6CBVZ8FF3GPMVARKWETSRW8":46},{"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":21,"linkOnly":22,"markdownContent":23,"markdownBody":23,"frontMatter":24,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":13,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M6CBVZ8FF3GPMVARKWETSRW8","31-table-row-format",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\u002F80-tools\u002F11-builder\u002F31-table-row-format\u002FSKILL.md",[],[18,19,20],"format","table","31 table row format","2026-11-10 10:12:30",false,"# 31-table-row-format\n\nStatus: ACTIVE  \nAppliesTo: v10  \nSSOT: skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md\n\n## Purpose\n\nXLSX 테이블에서 추출된 데이터를 JSON object로 내보낼 때의 규칙(필드 순서, 64-bit int string 처리, PK export 필터)을 정의한다.\n\n이 문서는 \"row → JSON 변환 규칙\"만 정의한다.\n\n- **NDJSON 저장 규약**: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F53-data-ndjson\u002FSKILL.md` 참조\n- **pb64 저장 규약**: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F54-data-pb64\u002FSKILL.md` 참조\n\n생성되는 로더\u002F컨테이너 API는 **런타임\u002F제너레이터 코드**가 정답이다.\n\n---\n\n## Row → JSON 변환 규칙\n\n### 필드 순서\n\n**각 row의 필드 순서는 Excel 컬럼 순서를 따른다.**\n\n### 64-bit Integer 처리\n\n**64-bit integers(`long`, `ulong`)는 JSON string으로 변환한다.**\n\n이유: JavaScript의 Number 타입은 53비트 정밀도까지만 안전하므로, 64비트 정수는 문자열로 변환하여 정밀도 손실을 방지한다.\n\n### Null Enum 처리\n\n**`enum:*` 필드의 값이 null이면 JSON에서 해당 프로퍼티를 생략한다.**\n\n- XLSX 셀이 빈 문자열(\"\")이면 파서가 null을 반환한다\n- null enum 프로퍼티를 JSON에 포함시키면 C#(Newtonsoft.Json)에서 non-nullable enum에 null을 할당하려 해 `JsonSerializationException`이 발생한다\n- 프로퍼티를 생략하면 C#이 `default(T)` (보통 `NONE = 0`)를 유지한다\n- nullable enum(`T?`)에서도 동일하게 정확하다 (생략 시 `null` 유지)\n\n### JSON Serialization\n\n- 컴팩트 포맷 (들여쓰기 없음)\n- 결정성: 같은 입력이면 같은 출력\n\n---\n\n## Data Export 생성 조건\n\n**PrimaryKey(`pk`)가 없는 sheet는 NDJSON\u002Fpb64을 생성하지 않는다.**\n\n- PrimaryKey가 있는 sheet → `ndjson\u002F{SheetName}.json` + `pb64\u002F{SheetName}.asset` 생성\n- PrimaryKey가 없는 sheet → Data export 안함 (Entity\u002FContainer 코드만 생성)\n\n이 규칙은 \"데이터 없이 스키마만 정의하는 sheet\"를 허용하기 위함이다.\n\n---\n\n## PK Validation (Export 필터링 규칙)\n\n**DATA export는 PK 유효 row만 포함하며, 유효 row가 없으면 파일을 생성하지 않는다.**\n\n### NDJSON 규칙\n\n1. `primaryKey`(`pk` 옵션)가 정의되지 않은 테이블은 ndjson 파일을 **생성하지 않는다**\n2. `primaryKey` 값이 빈 row(null, undefined, \"\")는 export 대상에서 **제외된다**\n3. export 가능한 row가 0개면 파일을 **생성하지 않는다**\n\n### pb64 규칙 (테이블 단위 스킵)\n\n1. `primaryKey`(`pk` 옵션)가 정의되지 않은 테이블은 pb64 파일을 **생성하지 않는다**\n2. row 중 `primaryKey` 값이 빈 것이 **하나라도** 있으면 **테이블 전체를 스킵**한다\n3. 로그: `[Skip] Asset export skipped (empty PK row): \u003CTableName>`\n\n> pb64은 테이블 단위 1개 파일이므로, row 일부만 빼면 데이터 불일치가 생긴다. 따라서 \"테이블 전체 스킵\"으로 고정.\n\n### 로그\n\n- PK 미정의: `[Skip] Table export skipped (no primaryKey defined): \u003CSheetName>`\n- 유효 row 없음: `[Skip] Table export skipped (no valid PK rows): \u003CSheetName>`\n- 빈 PK row 존재 (pb64): `[Skip] Asset export skipped (empty PK row): \u003CTableName>`\n\n### 주의\n\n- **빌드 실패(throw)가 아니라 스킵**이다. 다른 테이블은 정상 처리된다.\n\n---\n\n## Output Paths\n\nSSOT 경로 규약을 따른다. (`{tableConfig.tableDirs}`는 배열이므로 각 요소에 대해 복사)\n\n- staging:\n  - `{tempDir}\u002F{DomainKey}\u002Fdata\u002Fndjson\u002F{TableName}.json` (내용은 NDJSON)\n  - `{tempDir}\u002F{DomainKey}\u002Fdata\u002Fpb64\u002F{TableName}.asset` (pk 옵션 있는 테이블만)\n- final (각 `{tableDir}` 요소에 대해):\n  - `{tableDir}\u002Fndjson\u002F{TableName}.json` (내용은 NDJSON)\n  - `{tableDir}\u002Fpb64\u002F{TableName}.asset` (pk 옵션 있는 테이블만)\n\n---\n\n## 금지 행동\n\n- pk 옵션이 없는 테이블을 export하도록 완화하는 행위 금지\n- 특정 테이블명(ASSET 등)에 의존하는 행위 금지\n- 필드 순서 규칙 변경 금지\n\n---\n\n## Notes\n\n- `enum:*` \u002F `class:*` 컬럼의 셀 값은 DFF 원문 문자열로 보존될 수 있다.\n- DFF 문법은 `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F30-table-cell-format\u002FSKILL.md`를 따른다.\n\n---\n\n## Reference\n\n- Policy SSOT: `skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md`\n- NDJSON 저장: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F53-data-ndjson\u002FSKILL.md`\n- pb64 저장: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F54-data-pb64\u002FSKILL.md`\n- DFF 규약: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F30-table-cell-format\u002FSKILL.md`\n- 동작 정본: 런타임\u002F제너레이터 코드\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F31-table-row-format","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":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add devwinsoft\u002Fdevian --skill 31-table-row-format",{"tool":38,"command":39},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 31-table-row-format",{"tool":41,"command":42},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 31-table-row-format","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F11-builder\u002F31-table-row-format\u002FSKILL.md",true,[],[47,53,61,69,78,85],{"skillNo":48,"name":49,"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":50,"categories":51,"keywords":52,"publishedAt":21},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[49],{"skillNo":54,"name":55,"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":56,"categories":57,"keywords":58,"publishedAt":21},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[59,60],"archive","90 project archive",{"skillNo":62,"name":63,"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":64,"categories":65,"keywords":66,"publishedAt":21},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[67,68],"management","30 env management",{"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":21},"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",[],[75,76,77],"push","page","19 page push send",{"skillNo":79,"name":80,"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":81,"categories":82,"keywords":83,"publishedAt":21},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[76,84],"18 page savedata",{"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":21},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[76,91],"17 page deobfuscate"]