[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBW0ZKQ4WQKFZFTSAX509C":3,"skill-same:01M6CBW0ZKQ4WQKFZFTSAX509C":59},{"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},"01M6CBW0ZKQ4WQKFZFTSAX509C","32-table-authoring",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\u002F32-table-authoring\u002FSKILL.md",[],[18,19],"table","32 table authoring","2026-11-10 10:12:30",false,"# 32-table-authoring\n\nStatus: ACTIVE  \nAppliesTo: v10  \nSSOT: skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md\n\n## Purpose\n\nDATA(DomainType=DATA)에서 사용하는 XLSX 테이블 작성 규칙을 정의한다.\n\n이 문서는 **XLSX 헤더\u002F옵션\u002F중단 규칙**만을 정본으로 가진다.\n지원 타입의 상세 매핑과 생성 코드 구조는 **런타임\u002F제너레이터 코드**를 정답으로 본다.\n\n---\n\n## Inputs\n\n입력은 `{buildInputJson}`의 `domains` 섹션이 정본이다.\n\n- `domains[{DomainKey}].tableDir`\n- `domains[{DomainKey}].tableFiles` (예: `['*.xlsx']`)\n\n---\n\n## XLSX Sheet → Table\n\n- XLSX의 각 sheet는 하나의 table로 해석한다.\n- table 이름은 sheet 이름에서 파생되며, 정확한 정규화 규칙은 Reference를 따른다.\n\n---\n\n## Sheet Name 규칙 (Hard Rule)\n\nSheet 이름은 다음 형식을 지원한다:\n\n| 형식 | 예시 | CodeTableName |\n|------|------|---------------|\n| `{TableName}` | `TestSheet` | `TestSheet` |\n| `{TableName}@{Description}` | `Monsters@몬스터테이블` | `Monsters` |\n\n### 파싱 규칙\n\n- `@` 문자가 있으면 앞쪽 문자열이 **CodeTableName**\n- `@` 뒤 문자열은 설명용 (Description)\n- 코드 생성\u002F런타임에서 사용되는 이름은 **CodeTableName**만\n\n### 런타임 동작\n\n- `{TableName}@{Description}` 형식의 에셋이 로드되면 `TB_{CodeTableName}`에 자동 insert\n- TableManager가 `ExtractBaseName(fileName)`으로 CodeTableName 추출\n\n### 금지 규칙\n\n- `@` 뒤 문자열을 코드 테이블명으로 사용 금지\n- 같은 CodeTableName을 가진 여러 Sheet 금지 (충돌)\n\n---\n\n## Header Layout (4 rows)\n\n모든 sheet는 최소 4행 헤더를 가진다.\n\n| Row | 의미 | 규칙 |\n|---:|---|---|\n| 1 | Field Names | 빈 셀을 만나면 그 뒤 컬럼은 무시(Header Stop Rule) |\n| 2 | Types | Row1에서 유효한 컬럼 범위 내에서만 읽음 |\n| 3 | Options | Row1에서 유효한 컬럼 범위 내에서만 읽음 |\n| 4 | Comments | 현재 빌드 도구는 해석하지 않음 |\n\nRow 5부터 데이터다.\n\n---\n\n## Options\n\n옵션은 `,`로 구분된 토큰 목록이다.\n\n### 토큰 형식\n\n| 형식 | 예시 | 해석 |\n|------|------|------|\n| `flag` | `pk` | PrimaryKey 지정 (= `pk:true`) |\n| `key:value` | `optional:true` | key-value 쌍 |\n| `prefix:value` | `gen:COMPLEX_POLICY_TYPE` | prefix별 특수 해석 |\n\n**주의:** `key:true`, `key` 옵션은 **미지원**이며 사용 시 빌드가 실패한다.\n\n### 지원 옵션\n\n| 옵션 | 의미 | 비고 |\n|------|------|------|\n| `pk` | PrimaryKey | 유일한 PK 지정 방식 (flag) |\n| `optional:true` | nullable\u002Foptional 힌트 | |\n| `gen:\u003CEnumName>` | Enum 자동 생성 | TableGen이 해석 |\n\n### PrimaryKey 규칙\n\n- **오직 `pk`만** PrimaryKey로 해석한다.\n- `key:true`, `key` 옵션은 빌드 실패한다.\n- PrimaryKey는 0개 또는 1개만 허용한다.\n- 2개 이상이면 빌드 실패한다.\n\n### gen: 옵션 규칙\n\n`gen:\u003CEnumName>` 옵션 사용 시 다음 조건을 만족해야 한다:\n\n1. **gen 컬럼 = PK 컬럼 (필수)**\n   - `gen:\u003CEnumName>`이 선언된 컬럼은 **반드시 `pk`여야 한다**.\n   - 즉, gen 컬럼이 곧 PrimaryKey 컬럼이다.\n   - gen 컬럼은 테이블당 1개만 허용한다 (2개 이상 FAIL).\n\n2. **gen 컬럼의 타입 (권장)**\n   - gen 컬럼의 type은 `enum:\u003CEnumName>`을 권장한다.\n   - (예: `gen:COMPLEX_POLICY_TYPE` → type은 `enum:COMPLEX_POLICY_TYPE`)\n\n3. **EnumName은 유효한 식별자**여야 한다 (`^[A-Za-z_][A-Za-z0-9_]*$`).\n   - enum 타입명은 **대문자 SNAKE_CASE**를 사용한다.\n\n4. **Enum 멤버**\n   - gen\u002FPK 컬럼의 각 row 값이 enum 멤버 이름이 된다.\n   - enum 멤버 이름도 **대문자 SNAKE_CASE**를 사용한다.\n   - enum 멤버 값은 **결정적 자동 할당**: 멤버 이름을 오름차순 정렬 후 0부터 순차 할당.\n\n조건 불만족 시 빌드가 실패한다.\n\n### gen: 예시\n\n```\nRow 1 (Header):    key                      | fallbackValue | minValue | maxValue\nRow 2 (Type):      enum:COMPLEX_POLICY_TYPE   | variant       | variant  | variant\nRow 3 (Options):   pk, gen:COMPLEX_POLICY_TYPE |              |          |\nRow 4 (Comment):   (ignored)\nRow 5+ (Data):     ATTACK_POWER             | i:0           | i:0      | i:10000\n                   CRI_RATE                 | f:0           | f:0      | f:3.5\n```\n\n여기서:\n- `key` 컬럼이 PK이자 gen 컬럼 (같은 컬럼, 옵션: `pk, gen:COMPLEX_POLICY_TYPE`)\n- `key` 컬럼의 값(`ATTACK_POWER`, `CRI_RATE`)이 enum 멤버 이름\n- enum 값은 자동 할당: `ATTACK_POWER=0`, `CRI_RATE=1` (이름 정렬 순)\n\n상세 규칙은 `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F52-table-enumgen\u002FSKILL.md` 참조.\n\n### Reserved 옵션\n\n- `parser:*` 등 위에 명시되지 않은 키는 Reserved다.\n- 존재해도 의미를 부여하지 않는다 (강제\u002F필수 해석 금지).\n\n---\n\n## Data Rules\n\n### Header Stop Rule\n\n- Row1(Field Names)에서 빈 셀을 만나면 **그 뒤 컬럼은 무시**한다.\n\n### Data Stop Rule\n\n- PrimaryKey 컬럼이 빈 값이면 **즉시 중단**한다.\n- 이후 행은 읽지 않는다.\n\n---\n\n## Type Strings\n\n타입 문자열은 Row2에서 지정한다.\n\n- 스칼라 타입(예: `int`, `string` 등)\n- 배열 타입(예: `int[]`)\n- 참조 타입(예: `enum:...`, `class:...`)\n\n지원 타입 문자열과 C#\u002FTS 매핑은 Reference가 정답이다.\n\n참조 타입 셀 값의 텍스트 규약(DFF)은 `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F30-table-cell-format\u002FSKILL.md`를 따른다.\n\n---\n\n## class: 타입 셀 입력 규칙\n\n`class:` 타입 필드의 셀은 다음 두 가지 형식을 지원한다:\n\n### 입력 형식\n\n| 형식 | 예시 | 동작 |\n|------|------|------|\n| Raw JSON | `{\"save1\":123,\"save2\":456}` | 그대로 NDJSON에 저장 |\n| Plain Value | `100` (숫자), `hello` (문자열) | 클래스 전용 파서가 결정적으로 변환 |\n\nPlain Value 입력은 등록된 클래스 파서가 있을 때만 동작하며, 파서가 없으면 Raw JSON 형식만 허용한다.\n\n### Complex 타입 입력 규칙\n\n다음 세 가지 Complex 타입은 빌드 시 평문(Plain Value) 입력을 결정적으로 변환한다.\n\n| 타입 | 평문 예시 | 변환 결과 |\n|------|-----------|-----------|\n| `class:Devian.CInt` | `100` | `{save1,save2}` object |\n| `class:Devian.CFloat` | `1.25` | `{save1,save2}` object |\n| `class:Devian.CString` | `hello` | `{data}` object (ComplexUtil 마스킹 후 base64 인코딩) |\n| `class:CBigInt` | `{5.5, 6}` | `rankKey` long 값 |\n| `class:CDateTime` | `2024-03-08 15:30:45` | `utcTimeMs` long 값 |\n\n빈 셀은 `null`로 처리된다.\n\n### `class:CBigInt` 전용 shorthand\n\n`class:CBigInt`는 일반 object 문법 외에 아래 plain shorthand를 지원한다.\n\n| 셀 값 | 의미 |\n|------|------|\n| `{5.5, 6}` | `5.5 * 10^6` |\n| `{2, 3}` | `2 * 10^3` |\n| `{-7.25, 12}` | `-7.25 * 10^12` |\n| `1000` | `1 * 10^3` (plain long) |\n| `-500` | `-5 * 10^2` (plain long) |\n\n규칙:\n- `{base, pow}`: `base`는 float, `pow`는 int. 공백은 무시한다.\n- plain long: `{}`가 없는 long 범위 정수 문자열. 빌드 시 정규화(`abs(base) \u003C 10`)하여 변환한다.\n- builder는 이를 rankKey (long) 값으로 변환하여 NDJSON\u002Fpb64에 저장한다.\n\n### 결정성 규약\n\nComplex 타입의 `save2` 값(마스크)은 다음 규칙에 따라 결정적으로 생성된다:\n\n1. seed 문자열: 시트키, PK값, 컬럼명, 평문값, 타입명을 조합\n2. SHA-256 해시의 첫 4바이트를 int32로 사용\n3. 동일한 입력은 항상 동일한 출력을 보장 (빌드 diff 안정성)\n\n이 변환은 보안 목적이 아니며, 빌드마다 동일한 결과를 보장하기 위한 것이다.\n\n---\n\n## Outputs\n\n경로 규약은 SSOT를 따른다.\n\n- staging: `{tempDir}\u002F{DomainKey}\u002Fcs\u002FGenerated\u002F**`, `{tempDir}\u002F{DomainKey}\u002Fts\u002FGenerated\u002F**`, `{tempDir}\u002F{DomainKey}\u002Fdata\u002Fndjson\u002F{TableName}.json` (내용은 NDJSON), `{tempDir}\u002F{DomainKey}\u002Fdata\u002Fpb64\u002F{TableName}.asset` (pk 옵션 있는 테이블만)\n- final (각 `{tableDir}` 요소에 대해): `{csConfig.generateDir}\u002FDevian.Domain.{DomainKey}\u002FGenerated\u002F**`, `{tsConfig.generateDir}\u002Fdevian-domain-{domainkey}\u002FGenerated\u002F**`, `{tableDir}\u002Fndjson\u002F{TableName}.json` (내용은 NDJSON), `{tableDir}\u002Fpb64\u002F{TableName}.asset` (pk 옵션 있는 테이블만)\n\n> **NDJSON 저장 규약:** 파일 확장자는 `.json`이지만, `ndjson\u002F` 폴더의 파일 내용은 NDJSON(라인 단위 JSON)이다. 정본: `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---\n\n## Reference\n\n- Policy SSOT: `skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md`\n- DFF 규약: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F30-table-cell-format\u002FSKILL.md`\n- Enum Generation: `skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F52-table-enumgen\u002FSKILL.md`\n- 동작 정본: 런타임\u002F제너레이터 코드\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F80-tools\u002F11-builder\u002F32-table-authoring","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 32-table-authoring",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 32-table-authoring",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 32-table-authoring","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F11-builder\u002F32-table-authoring\u002FSKILL.md",true,[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",105,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002FEntro\u002Fentro-connect\u002F.agents\u002Fskills\u002Fgherkin-authoring\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fbest-practices.md",12042,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002FEntro\u002Fentro-connect\u002F.agents\u002Fskills\u002Fgherkin-authoring\u002Freferences\u002Fbest-practices.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fsyntax-reference.md",8625,"https:\u002F\u002Fgithub.com\u002Ffernando-delosrios-sp\u002Fsailpoint-utils\u002Fblob\u002Fmain\u002FEntro\u002Fentro-connect\u002F.agents\u002Fskills\u002Fgherkin-authoring\u002Freferences\u002Fsyntax-reference.md",[60,66,74,82,91,98],{"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},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[62],{"skillNo":67,"name":68,"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":69,"categories":70,"keywords":71,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[72,73],"archive","90 project archive",{"skillNo":75,"name":76,"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":77,"categories":78,"keywords":79,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[80,81],"management","30 env management",{"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":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",[],[88,89,90],"push","page","19 page push send",{"skillNo":92,"name":93,"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":94,"categories":95,"keywords":96,"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",[],[89,97],"18 page savedata",{"skillNo":99,"name":100,"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":101,"categories":102,"keywords":103,"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",[],[89,104],"17 page deobfuscate"]