create-entity-server 0.0.27 → 0.2.2

package/template/entities/System/Storage/file_backup_log.json

@@ -1,23 +1,28 @@
 {
     "name": "file_backup_log",
-    "description": "파일 백업 작업 로그. 스토리지 간 백업 동기화 이력을 기록합니다. 서버 내부 백업 고루틴이 자동 기록. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
+    "description": "파일 백업 작업 로그. 스토리지 간 백업 동기화 이력을 기록합니다. 서버 내부 백업 고루틴이 자동 기록. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
     "license_scope": false,
     "history": false,
     "hard_delete": true,
     "read_only": true,
     "compress": true,
-    "index": {
+    "fields": {
         "started_time": {
+            "index": true,
             "comment": "백업 작업 시작 시각"
         },
         "status": {
+            "index": true,
             "comment": "작업 상태",
-            "type": ["running", "completed", "partial", "failed"],
+            "type": [
+                "running",
+                "completed",
+                "partial",
+                "failed"
+            ],
             "default": "running",
             "required": true
-        }
-    },
-    "fields": {
+        },
         "error_count": {
             "comment": "실패 파일 수"
         },

package/template/entities/System/Storage/file_download_log.json

@@ -1,25 +1,27 @@
 {
     "name": "file_download_log",
-    "description": "파일 다운로드 이력. 누가 어떤 파일을 언제 다운로드했는지 기록합니다. 감사(audit) 및 통계 목적. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
+    "description": "파일 다운로드 이력. 누가 어떤 파일을 언제 다운로드했는지 기록합니다. 감사(audit) 및 통계 목적. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
     "hard_delete": true,
     "history": false,
     "compress": true,
-    "index": {
+    "fields": {
         "account_seq": {
+            "index": true,
             "comment": "다운로드한 계정 seq. JWT 인증 시 기록, 비인증은 NULL"
         },
         "downloaded_time": {
+            "index": true,
             "comment": "다운로드 시각"
         },
         "entity_name": {
+            "index": true,
             "comment": "파일이 속한 엔티티 이름"
         },
         "file_seq": {
+            "index": true,
             "comment": "다운로드한 file_meta seq",
             "required": true
-        }
-    },
-    "fields": {
+        },
         "ip": {
             "comment": "요청 IP 주소 (IPv4/IPv6)",
             "type": "varchar(45)"

package/template/entities/System/Storage/file_meta.json

@@ -1,33 +1,46 @@
 {
     "name": "file_meta",
-    "description": "파일 메타데이터. 업로드된 파일의 저장 위치·크기·해시·상태를 관리합니다. 파일 핸들러가 자동 기록하며 API를 통한 직접 수정은 허용되지 않습니다. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
+    "description": "파일 메타데이터. 업로드된 파일의 저장 위치·크기·해시·상태를 관리합니다. 파일 핸들러가 자동 기록하며 API를 통한 직접 수정은 허용되지 않습니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
     "history": false,
     "hard_delete": true,
     "read_only": true,
-    "index": {
+    "fields": {
         "backup_status": {
+            "index": true,
             "comment": "백업 동기화 상태",
-            "type": ["none", "pending", "synced", "failed", "skipped"],
+            "type": [
+                "none",
+                "pending",
+                "synced",
+                "failed",
+                "skipped"
+            ],
             "default": "none"
         },
         "size": {
+            "index": true,
             "comment": "파일 크기 (bytes)",
             "type": "bigint unsigned"
         },
         "status": {
+            "index": true,
             "comment": "파일 상태",
-            "type": ["active", "pending", "orphan", "deleted"],
+            "type": [
+                "active",
+                "pending",
+                "orphan",
+                "deleted"
+            ],
             "default": "pending",
             "required": true
         },
         "uuid": {
+            "index": true,
             "comment": "파일 고유 식별자 (UUID v4). 저장 경로·다운로드 URL의 키로 사용",
             "type": "varchar(36)",
             "required": true,
             "unique": true
-        }
-    },
-    "fields": {
+        },
         "backup_retries": {
             "comment": "백업 재시도 횟수"
         },

package/template/entities/System/system_audit_log.json

@@ -1,28 +1,18 @@
 {
     "name": "system_audit_log",
-    "description": "시스템 감사 로그. 서버 레벨에서 자동 기록되며 API를 통한 직접 수정은 허용되지 않습니다. JWT 인증 시에만 account_seq 기록. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
-    "db_group": "system",
+    "description": "시스템 감사 로그. 서버 레벨에서 자동 기록되며 API를 통한 직접 수정은 허용되지 않습니다. JWT 인증 시에만 account_seq 기록. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
     "hard_delete": true,
     "history_ttl": 0,
     "read_only": true,
-    "license_scope": false,
     "compress": true,
-    "index": {
-        "transaction_id": {
-            "comment": "요청 트랜잭션 ID. entity_history 테이블과 JOIN 키",
-            "type": "varchar(64)"
-        },
-        "entity_name": {
-            "comment": "대상 엔티티 이름",
-            "type": "varchar(100)",
-            "required": true
-        },
-        "entity_seq": {
-            "comment": "대상 엔티티 레코드 seq. 로그인/로그아웃 등 레코드 없는 경우 NULL",
-            "type": "bigint",
-            "nullable": true
+    "fields": {
+        "account_seq": {
+            "index": true,
+            "comment": "작업을 수행한 계정 seq. JWT 인증 요청은 account.seq, 비인증/HMAC 요청은 NULL"
         },
         "action": {
+            "index": true,
             "comment": "수행된 작업 유형",
             "type": [
                 "INSERT",
@@ -35,38 +25,52 @@
             ],
             "required": true
         },
-        "account_seq": {
-            "comment": "작업을 수행한 계정 seq. JWT 인증 요청은 account.seq, 비인증/HMAC 요청은 NULL",
-            "type": "bigint",
-            "nullable": true
+        "endpoint": {
+            "index": true,
+            "comment": "요청 API 엔드포인트",
+            "type": "varchar(200)"
+        },
+        "entity_name": {
+            "index": true,
+            "comment": "대상 엔티티 이름",
+            "required": true
+        },
+        "entity_seq": {
+            "index": true,
+            "comment": "대상 엔티티 레코드 seq. 로그인/로그아웃 등 레코드 없는 경우 NULL"
+        },
+        "error_message": {
+            "comment": "실패 시 오류 메시지 요약",
+            "type": "varchar(500)"
         },
         "ip_address": {
+            "index": true,
+            "hash": true,
             "comment": "요청 IP 주소 (IPv4/IPv6)",
-            "type": "varchar(45)",
-            "nullable": true
-        },
-        "endpoint": {
-            "comment": "요청 API 엔드포인트",
-            "type": "varchar(200)",
-            "nullable": true
+            "type": "varchar(45)"
         },
         "request_method": {
+            "index": true,
             "comment": "HTTP 메서드 (GET/POST/PUT/DELETE 등)",
             "type": "varchar(10)"
         },
         "request_payload": {
             "comment": "요청 본문 JSON. 민감 필드(password, token 등) 자동 마스킹 후 저장. ServerConfig.AuditLogPayload = true 일 때만 기록",
-            "type": "text",
-            "nullable": true
+            "type": "text"
         },
         "result_code": {
+            "index": true,
             "comment": "HTTP 응답 코드 (200, 400, 401, 403, 500 등)",
             "type": "int"
         },
-        "error_message": {
-            "comment": "실패 시 오류 메시지 요약",
-            "type": "varchar(500)",
-            "nullable": true
+        "transaction_id": {
+            "index": true,
+            "comment": "요청 트랜잭션 ID. entity_history 테이블과 JOIN 키",
+            "type": "varchar(64)"
         }
+    },
+    "fk": {
+        "account_seq": false,
+        "entity_seq": false
     }
 }

package/template/entities/company.json

@@ -1,15 +1,18 @@
 {
     "name": "company",
-    "description": "company Entity. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
-    "index": {
+    "description": "company Entity. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
         "company_name": {
+            "index": true,
             "comment": "회사명",
             "required": true
         },
         "industry": {
+            "index": true,
             "comment": "업종"
         },
         "tax_id": {
+            "index": true,
             "comment": "사업자번호",
             "hash": true
         }

package/template/entities/goods.json

@@ -1,17 +1,24 @@
 {
     "name": "goods",
-    "description": "goods Entity. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
-    "index": {
+    "description": "goods Entity. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
         "name": {
+            "index": true,
             "comment": "상품명",
             "required": true,
             "unique": true
         },
         "category": {
+            "index": true,
             "comment": "카테고리",
-            "type": ["전자제품", "가구", "생활용품"]
+            "type": [
+                "전자제품",
+                "가구",
+                "생활용품"
+            ]
         },
         "price": {
+            "index": true,
             "comment": "가격"
         }
     },

package/template/entities/todo.json

@@ -1,11 +1,13 @@
 {
     "name": "todo",
-    "description": "todo Entity. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
-    "index": {
+    "description": "todo Entity. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
         "title": {
+            "index": true,
             "comment": "할 일 제목"
         },
         "status": {
+            "index": true,
             "comment": "상태",
             "type": [
                 "pending",

package/template/samples/entities/01_basic_fields.json

@@ -1,38 +1,51 @@
 {
     "name": "contact",
     "description": "기본 필드 타입 예제 — 인덱스 필드 자동 추론 패턴 모음",
-    "index": {
+    "fields": {
         "name": {
+            "index": true,
             "comment": "이름 (*_name → VARCHAR(100) 자동 추론)"
         },
         "email": {
+            "index": true,
             "comment": "이메일 (*email* → VARCHAR(255) 자동 추론)",
             "type": "email"
         },
         "phone": {
+            "index": true,
             "comment": "전화번호 (*phone* → VARCHAR(50) 자동 추론)"
         },
         "birth_date": {
+            "index": true,
             "comment": "생년월일 (*_date → DATE 자동 추론)"
         },
         "joined_at": {
+            "index": true,
             "comment": "가입일시 (*_at → DATETIME 자동 추론)"
         },
         "visit_count": {
+            "index": true,
             "comment": "방문 횟수 (*_count → INT 자동 추론)"
         },
         "total_amount": {
+            "index": true,
             "comment": "총 금액 (*_amount → DECIMAL(15,2) 자동 추론)"
         },
         "is_verified": {
+            "index": true,
             "comment": "인증 여부 (is_* → TINYINT(1) 자동 추론)"
         },
         "user_seq": {
+            "index": true,
             "comment": "연결된 사용자 seq (*_seq → BIGINT UNSIGNED 자동 추론)"
         },
         "status": {
+            "index": true,
             "comment": "상태 (enum 배열로 허용값 제한)",
-            "type": ["active", "inactive"],
+            "type": [
+                "active",
+                "inactive"
+            ],
             "default": "active"
         }
     }

package/template/samples/entities/02_types_and_defaults.json

@@ -1,38 +1,48 @@
 {
     "name": "product",
     "description": "명시적 타입 선언 & defaults 예제 — 자동 추론이 안 되는 필드에 types 사용",
-    "index": {
+    "fields": {
         "sku": {
+            "index": true,
             "comment": "상품 코드",
             "required": true,
             "unique": true
         },
         "category": {
+            "index": true,
             "comment": "카테고리",
-            "type": ["electronics", "furniture", "clothing", "food"],
+            "type": [
+                "electronics",
+                "furniture",
+                "clothing",
+                "food"
+            ],
             "default": "electronics"
         },
         "price": {
+            "index": true,
             "comment": "정가 (decimal — 자동추론 불가, 명시 선언)",
             "type": "decimal"
         },
         "stock_qty": {
+            "index": true,
             "comment": "재고 수량 (*_qty → INT 자동 추론)",
             "default": 0
         },
         "weight": {
+            "index": true,
             "comment": "무게(kg) — 자동추론 없음, types에서 decimal 선언",
             "type": "decimal"
         },
         "is_available": {
+            "index": true,
             "comment": "판매 가능 여부 (is_* → TINYINT(1) 자동 추론)",
             "default": true
         },
         "launched_at": {
+            "index": true,
             "comment": "출시일시 (*_at → DATETIME 자동 추론)"
-        }
-    },
-    "fields": {
+        },
         "description": {
             "type": "text",
             "comment": "상품 상세 설명"

package/template/samples/entities/03_hash_and_unique.json

@@ -1,33 +1,48 @@
 {
     "name": "member",
     "description": "hash & unique 예제 — 민감 필드 해시 저장 + 단일/복합 유니크",
-    "index": {
+    "fields": {
         "email": {
+            "index": true,
             "comment": "이메일 (고유 — 중복 불가)",
             "type": "email",
             "required": true,
             "unique": true
         },
         "phone": {
+            "index": true,
             "comment": "전화번호 (해시 저장 — 평문 노출 차단)",
             "hash": true
         },
         "resident_id": {
+            "index": true,
             "comment": "주민등록번호 앞 7자리 (해시 + 유니크 — 중복 가입 방지)",
             "hash": true,
             "unique": true
         },
         "nickname": {
+            "index": true,
             "comment": "닉네임 (unique — 중복 불가)"
         },
         "org_seq": {
+            "index": true,
             "comment": "소속 조직 seq"
         },
         "status": {
+            "index": true,
             "comment": "상태",
-            "type": ["active", "inactive", "withdrawn"],
+            "type": [
+                "active",
+                "inactive",
+                "withdrawn"
+            ],
             "default": "active"
         }
     },
-    "unique": [["org_seq", "nickname"]]
+    "unique": [
+        [
+            "org_seq",
+            "nickname"
+        ]
+    ]
 }

package/template/samples/entities/04_fk_and_composite_unique.json

@@ -1,28 +1,43 @@
 {
     "name": "team_member",
     "description": "외래키(fk) & 복합 유니크 예제 — 팀-사용자 다대다 중간 테이블",
-    "index": {
+    "fields": {
         "team_seq": {
+            "index": true,
             "comment": "팀 seq (fk: team.seq)",
             "required": true
         },
         "user_seq": {
+            "index": true,
             "comment": "사용자 seq (fk: user.seq)",
             "required": true
         },
         "role": {
+            "index": true,
             "comment": "팀 내 역할",
-            "type": ["owner", "admin", "member", "viewer"],
+            "type": [
+                "owner",
+                "admin",
+                "member",
+                "viewer"
+            ],
             "default": "member"
         },
         "invited_by": {
+            "index": true,
             "comment": "초대한 사용자 seq (fk: user.seq, nullable)"
         },
         "joined_at": {
+            "index": true,
             "comment": "참가일시 (*_at → DATETIME 자동 추론)"
         }
     },
-    "unique": [["team_seq", "user_seq"]],
+    "unique": [
+        [
+            "team_seq",
+            "user_seq"
+        ]
+    ],
     "fk": {
         "invited_by": "user.seq"
     }

package/template/samples/entities/05_cache.json

@@ -1,26 +1,28 @@
 {
     "name": "config_item",
     "description": "캐시 예제 — 자주 읽히고 드물게 변경되는 설정값에 엔티티 레벨 캐시 활성화",
-    "index": {
+    "fields": {
         "key": {
+            "index": true,
             "comment": "설정 키 (고유)",
             "required": true,
             "unique": true
         },
         "category": {
+            "index": true,
             "comment": "설정 카테고리",
-            "type": ["system", "ui", "feature_flag", "notification"],
+            "type": [
+                "system",
+                "ui",
+                "feature_flag",
+                "notification"
+            ],
             "default": "system"
         },
         "is_public": {
+            "index": true,
             "comment": "공개 여부 (is_* → TINYINT(1) 자동 추론)"
-        }
-    },
-    "cache": {
-        "enabled": true,
-        "ttl_seconds": 600
-    },
-    "fields": {
+        },
         "value": {
             "comment": "설정 값 (문자열 저장, 타입은 애플리케이션에서 해석)",
             "required": true
@@ -29,6 +31,10 @@
             "comment": "설정 항목 설명"
         }
     },
+    "cache": {
+        "enabled": true,
+        "ttl_seconds": 600
+    },
     "reset_defaults": [
         {
             "key": "site.name",

package/template/samples/entities/06_history_and_hard_delete.json

@@ -1,33 +1,46 @@
 {
     "name": "article",
     "description": "이력 보존(history_ttl) & 완전삭제(hard_delete) 예제 — 게시글 수정 이력 3년 보관",
-    "index": {
+    "fields": {
         "author_seq": {
+            "index": true,
             "comment": "작성자 user seq",
             "required": true
         },
         "title": {
+            "index": true,
             "comment": "제목",
             "required": true
         },
         "category": {
+            "index": true,
             "comment": "카테고리",
-            "type": ["notice", "blog", "faq", "news"],
+            "type": [
+                "notice",
+                "blog",
+                "faq",
+                "news"
+            ],
             "default": "blog"
         },
         "status": {
+            "index": true,
             "comment": "게시 상태",
-            "type": ["draft", "published", "archived"],
+            "type": [
+                "draft",
+                "published",
+                "archived"
+            ],
             "default": "draft"
         },
         "published_at": {
+            "index": true,
             "comment": "게시일시 (*_at → DATETIME 자동 추론)"
         },
         "view_count": {
+            "index": true,
             "comment": "조회 수 (*_count → INT 자동 추론)"
-        }
-    },
-    "fields": {
+        },
         "content": {
             "type": "longtext",
             "comment": "게시글 본문",

package/template/samples/entities/07_license_scope.json

@@ -2,29 +2,38 @@
     "name": "exchange_rate",
     "description": "license_scope: false 예제 — 전 라이선스 공용 기준 데이터 (환율). license_seq 컬럼 없이 모든 테넌트가 동일 데이터 공유",
     "license_scope": false,
-    "index": {
+    "fields": {
         "base_currency": {
+            "index": true,
             "comment": "기준 통화 (ISO 4217)",
             "type": "varchar(3)",
             "required": true
         },
         "quote_currency": {
+            "index": true,
             "comment": "환산 통화 (ISO 4217)",
             "type": "varchar(3)",
             "required": true
         },
         "rate": {
+            "index": true,
             "comment": "환산 비율 (*_rate → 자동추론 없음, decimal 명시)",
             "type": "decimal",
             "required": true
         },
         "effective_date": {
+            "index": true,
             "comment": "적용일 (*_date → DATE 자동 추론)",
             "required": true
         },
         "source": {
+            "index": true,
             "comment": "환율 출처",
-            "type": ["ecb", "openexchangerates", "manual"],
+            "type": [
+                "ecb",
+                "openexchangerates",
+                "manual"
+            ],
             "default": "manual"
         }
     },
@@ -32,7 +41,13 @@
         "enabled": true,
         "ttl_seconds": 3600
     },
-    "unique": [["base_currency", "quote_currency", "effective_date"]],
+    "unique": [
+        [
+            "base_currency",
+            "quote_currency",
+            "effective_date"
+        ]
+    ],
     "reset_defaults": [
         {
             "base_currency": "USD",