create-entity-server 0.0.26 → 0.0.31

package/template/entities/System/Push/push_log.json

@@ -0,0 +1,86 @@
+{
+    "name": "push_log",
+    "description": "푸시 알림 발송 이력. 발송 결과 추적 및 재시도 관리용. account_seq(JWT) 또는 device_id(HMAC) 중 하나 존재. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "hard_delete": true,
+    "history_ttl": 30,
+    "compress": true,
+    "fields": {
+        "account_seq": {
+            "index": true,
+            "comment": "수신자 account seq (JWT 인증 시. nullable)"
+        },
+        "attempt_time": {
+            "index": true,
+            "comment": "처리 시작(claim) 시각 — 비정상 종료 감지용"
+        },
+        "body": {
+            "comment": "알림 본문"
+        },
+        "device_id": {
+            "index": true,
+            "comment": "대상 디바이스 ID (HMAC 인증 시. nullable)",
+            "type": "varchar(255)"
+        },
+        "device_seq": {
+            "index": true,
+            "comment": "대상 디바이스 seq (account_device.seq)"
+        },
+        "device_token": {
+            "comment": "발송 시점 디바이스 토큰 스냅샷 (FCM registration token 또는 APNs device token)"
+        },
+        "error_message": {
+            "comment": "실패 시 오류 메시지",
+            "type": "varchar(500)"
+        },
+        "platform": {
+            "index": true,
+            "comment": "발송 채널",
+            "type": [
+                "fcm",
+                "apns",
+                "web"
+            ]
+        },
+        "push_data": {
+            "comment": "커스텀 페이로드 JSON 문자열",
+            "type": "varchar(2000)"
+        },
+        "ref_entity": {
+            "index": true,
+            "comment": "트리거 엔티티명"
+        },
+        "ref_seq": {
+            "index": true,
+            "comment": "트리거 레코드 seq"
+        },
+        "retry_count": {
+            "index": true,
+            "comment": "재시도 횟수",
+            "type": "uint",
+            "default": 0
+        },
+        "sent_time": {
+            "index": true,
+            "comment": "발송 완료 시각"
+        },
+        "status": {
+            "index": true,
+            "comment": "발송 상태",
+            "type": [
+                "pending",
+                "processing",
+                "sent",
+                "delivered",
+                "failed",
+                "expired"
+            ],
+            "default": "pending",
+            "required": true
+        },
+        "title": {
+            "index": true,
+            "comment": "알림 제목"
+        }
+    }
+}

package/template/entities/System/Push/push_msg.json

@@ -0,0 +1,56 @@
+{
+    "name": "push_msg",
+    "description": "시스템 푸시 트리거 엔티티. insert 시 push hook로 비동기 발송. account_seq(JWT) 또는 device_id(HMAC) 중 하나 필수. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "account_seq": {
+            "index": true,
+            "comment": "수신자 account seq (JWT 인증 시 필수. HMAC 인증은 device_id 사용)",
+            "required": true
+        },
+        "device_id": {
+            "index": true,
+            "comment": "대상 디바이스 ID (HMAC 인증 시. 기기단위로 account 없이 푸시 발송)",
+            "type": "varchar(255)"
+        },
+        "title": {
+            "index": true,
+            "comment": "푸시 제목",
+            "required": true
+        },
+        "message": {
+            "comment": "푸시 본문",
+            "nullable": true
+        },
+        "ref_entity": {
+            "comment": "참조 엔티티명",
+            "nullable": true
+        },
+        "ref_seq": {
+            "comment": "참조 레코드 seq",
+            "nullable": true
+        },
+        "msg_data": {
+            "comment": "추가 데이터(JSON 문자열)",
+            "type": "varchar(2000)",
+            "nullable": true
+        }
+    },
+    "hooks": {
+        "after_insert": [
+            {
+                "type": "push",
+                "target_account_seq": "account_seq",
+                "target_device_id": "device_id",
+                "comment": "account_seq 있으면 계정 기반 발송, 없으면 device_id 기반 발송",
+                "title": "${new.title}",
+                "push_body": "${new.message}",
+                "push_data": {
+                    "push_msg_seq": "${new.seq}",
+                    "ref_entity": "${new.ref_entity}",
+                    "ref_seq": "${new.ref_seq}",
+                    "msg_data": "${new.msg_data}"
+                }
+            }
+        ]
+    }
+}

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

@@ -0,0 +1,51 @@
+{
+    "name": "file_backup_log",
+    "description": "파일 백업 작업 로그. 스토리지 간 백업 동기화 이력을 기록합니다. 서버 내부 백업 고루틴이 자동 기록. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "history": false,
+    "hard_delete": true,
+    "read_only": true,
+    "compress": true,
+    "fields": {
+        "started_time": {
+            "index": true,
+            "comment": "백업 작업 시작 시각"
+        },
+        "status": {
+            "index": true,
+            "comment": "작업 상태",
+            "type": [
+                "running",
+                "completed",
+                "partial",
+                "failed"
+            ],
+            "default": "running",
+            "required": true
+        },
+        "error_count": {
+            "comment": "실패 파일 수"
+        },
+        "error_message": {
+            "comment": "실패 시 오류 메시지 요약"
+        },
+        "exec_instance": {
+            "comment": "작업을 실행한 서버 인스턴스 식별자 (hostname 등)"
+        },
+        "file_count": {
+            "comment": "처리된 파일 수"
+        },
+        "finished_time": {
+            "comment": "백업 작업 완료 시각"
+        },
+        "source_key": {
+            "comment": "원본 스토리지 키 (storage.json storages 맵의 키)"
+        },
+        "target_key": {
+            "comment": "백업 대상 스토리지 키"
+        },
+        "total_bytes": {
+            "comment": "전송된 총 바이트 수"
+        }
+    }
+}

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

@@ -0,0 +1,43 @@
+{
+    "name": "file_download_log",
+    "description": "파일 다운로드 이력. 누가 어떤 파일을 언제 다운로드했는지 기록합니다. 감사(audit) 및 통계 목적. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "hard_delete": true,
+    "history": false,
+    "compress": true,
+    "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
+        },
+        "ip": {
+            "comment": "요청 IP 주소 (IPv4/IPv6)",
+            "type": "varchar(45)"
+        },
+        "thumb": {
+            "comment": "썸네일 요청 시 사이즈 (sm, md, lg). 원본 다운로드는 NULL",
+            "type": "varchar(10)"
+        },
+        "user_agent": {
+            "comment": "요청 User-Agent 헤더",
+            "type": "varchar(500)"
+        }
+    },
+    "fk": {
+        "account_seq": false,
+        "file_seq": false
+    },
+    "read_only": true
+}

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

@@ -0,0 +1,72 @@
+{
+    "name": "file_meta",
+    "description": "파일 메타데이터. 업로드된 파일의 저장 위치·크기·해시·상태를 관리합니다. 파일 핸들러가 자동 기록하며 API를 통한 직접 수정은 허용되지 않습니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "history": false,
+    "hard_delete": true,
+    "read_only": true,
+    "fields": {
+        "backup_status": {
+            "index": true,
+            "comment": "백업 동기화 상태",
+            "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"
+            ],
+            "default": "pending",
+            "required": true
+        },
+        "uuid": {
+            "index": true,
+            "comment": "파일 고유 식별자 (UUID v4). 저장 경로·다운로드 URL의 키로 사용",
+            "type": "varchar(36)",
+            "required": true,
+            "unique": true
+        },
+        "backup_retries": {
+            "comment": "백업 재시도 횟수"
+        },
+        "content_hash": {
+            "comment": "파일 SHA-256 해시 (중복 탐지·무결성 검증용)"
+        },
+        "entity_name": {
+            "comment": "파일이 첨부된 엔티티 이름"
+        },
+        "entity_seq": {
+            "comment": "파일이 첨부된 엔티티 레코드 seq. 업로드 직후 엔티티 미연결 시 NULL"
+        },
+        "field_name": {
+            "comment": "파일이 첨부된 필드 이름 (file/file[] 타입 필드)"
+        },
+        "mime_type": {
+            "comment": "파일 MIME 타입 (image/jpeg, application/pdf 등)"
+        },
+        "original_name": {
+            "comment": "업로드 시 원본 파일명 (보안 대상 — 암호화 저장)"
+        },
+        "storage_key": {
+            "comment": "스토리지 백엔드 내 상대 경로 (예: 2026/02/27/contact/uuid.jpg)"
+        },
+        "storage_path": {
+            "comment": "라이선스 접두어 포함 전체 경로 (예: 3/2026/02/27/contact/uuid.jpg)"
+        }
+    }
+}

package/template/entities/System/system_audit_log.json

@@ -1,27 +1,18 @@
 {
     "name": "system_audit_log",
-    "description": "시스템 감사 로그. 서버 레벨에서 자동 기록되며 API를 통한 직접 수정은 허용되지 않습니다. JWT 인증 시에만 account_seq 기록",
-    "db_group": "system",
+    "description": "시스템 감사 로그. 서버 레벨에서 자동 기록되며 API를 통한 직접 수정은 허용되지 않습니다. JWT 인증 시에만 account_seq 기록. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
     "hard_delete": true,
     "history_ttl": 0,
     "read_only": true,
-    "license_scope": false,
-    "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
+    "compress": true,
+    "fields": {
+        "account_seq": {
+            "index": true,
+            "comment": "작업을 수행한 계정 seq. JWT 인증 요청은 account.seq, 비인증/HMAC 요청은 NULL"
         },
         "action": {
+            "index": true,
             "comment": "수행된 작업 유형",
             "type": [
                 "INSERT",
@@ -34,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": {
+    "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/{product.json → goods.json}

@@ -1,13 +1,15 @@
 {
-    "name": "product",
-    "description": "product Entity",
-    "index": {
+    "name": "goods",
+    "description": "goods Entity. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
         "name": {
-            "comment": "제품명",
+            "index": true,
+            "comment": "상품명",
             "required": true,
             "unique": true
         },
         "category": {
+            "index": true,
             "comment": "카테고리",
             "type": [
                 "전자제품",
@@ -16,18 +18,19 @@
             ]
         },
         "price": {
+            "index": true,
             "comment": "가격"
         }
     },
     "reset_defaults": [
         {
-            "name": "샘플 제품 A",
+            "name": "샘플 상품 A",
             "category": "전자제품",
             "price": 10000,
             "stock": 50
         },
         {
-            "name": "샘플 제품 B",
+            "name": "샘플 상품 B",
             "category": "가구",
             "price": 50000,
             "stock": 20

package/template/entities/todo.json

@@ -1,11 +1,13 @@
 {
     "name": "todo",
-    "description": "todo Entity",
-    "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"
+        ]
+    ]
 }