create-entity-server 0.0.27 → 0.2.2

package/template/samples/entities/08_hook_sql.json

@@ -1,22 +1,31 @@
 {
     "name": "user_point",
     "description": "SQL 훅 예제 — INSERT/UPDATE 시 자동 감사 로그 기록 (실행형) + SELECT 결과 주입 (조회형)",
-    "index": {
+    "fields": {
         "user_seq": {
+            "index": true,
             "comment": "사용자 seq",
             "required": true,
             "unique": true
         },
         "point": {
+            "index": true,
             "comment": "보유 포인트",
             "type": "uint"
         },
         "grade": {
+            "index": true,
             "comment": "등급",
-            "type": ["bronze", "silver", "gold", "platinum"],
+            "type": [
+                "bronze",
+                "silver",
+                "gold",
+                "platinum"
+            ],
             "default": "bronze"
         },
         "updated_at": {
+            "index": true,
             "comment": "마지막 포인트 변경일시 (*_at → DATETIME 자동 추론)"
         }
     },
@@ -26,7 +35,11 @@
                 "comment": "포인트 생성 이력 기록 (실행형 SQL 훅)",
                 "type": "sql",
                 "query": "INSERT INTO point_history (user_seq, delta, reason, created_time) VALUES (?, ?, ?, NOW())",
-                "params": ["${new.user_seq}", "${new.point}", "initial_grant"],
+                "params": [
+                    "${new.user_seq}",
+                    "${new.point}",
+                    "initial_grant"
+                ],
                 "async": false
             }
         ],
@@ -35,7 +48,11 @@
                 "comment": "포인트 변경 이력 기록 (실행형 SQL 훅)",
                 "type": "sql",
                 "query": "INSERT INTO point_history (user_seq, delta, reason, created_time) VALUES (?, ?, ?, NOW())",
-                "params": ["${new.user_seq}", "${new.point}", "update"],
+                "params": [
+                    "${new.user_seq}",
+                    "${new.point}",
+                    "update"
+                ],
                 "async": true
             }
         ],
@@ -44,7 +61,9 @@
                 "comment": "최근 포인트 변경 이력 5건 주입 (조회형 SQL 훅)",
                 "type": "sql",
                 "query": "SELECT delta, reason, created_time FROM point_history WHERE user_seq = ? ORDER BY created_time DESC LIMIT 5",
-                "params": ["${new.user_seq}"],
+                "params": [
+                    "${new.user_seq}"
+                ],
                 "assign_to": "recent_history"
             }
         ]

package/template/samples/entities/09_hook_entity.json

@@ -1,27 +1,37 @@
 {
     "name": "post",
     "description": "entity 훅 예제 — after_get/after_list 시 관련 엔티티 데이터를 자동 주입",
-    "index": {
+    "fields": {
         "author_seq": {
+            "index": true,
             "comment": "작성자 user seq",
             "required": true
         },
         "title": {
+            "index": true,
             "comment": "제목",
             "required": true
         },
         "status": {
+            "index": true,
             "comment": "상태",
-            "type": ["draft", "published", "hidden"],
+            "type": [
+                "draft",
+                "published",
+                "hidden"
+            ],
             "default": "draft"
         },
         "comment_count": {
+            "index": true,
             "comment": "댓글 수 (*_count → INT 자동 추론)"
         },
         "like_count": {
+            "index": true,
             "comment": "좋아요 수 (*_count → INT 자동 추론)"
         },
         "published_at": {
+            "index": true,
             "comment": "게시일시 (*_at → DATETIME 자동 추론)"
         }
     },

package/template/samples/entities/10_hook_submit_delete.json

@@ -1,28 +1,37 @@
 {
     "name": "project",
     "description": "submit & delete 훅 예제 — 프로젝트 생성 시 기본 태스크 자동 생성, 삭제 시 연관 데이터 정리",
-    "index": {
+    "fields": {
         "owner_seq": {
+            "index": true,
             "comment": "프로젝트 소유자 user seq",
             "required": true
         },
         "name": {
+            "index": true,
             "comment": "프로젝트명",
             "required": true
         },
         "status": {
+            "index": true,
             "comment": "진행 상태",
-            "type": ["planning", "active", "on_hold", "completed", "cancelled"],
+            "type": [
+                "planning",
+                "active",
+                "on_hold",
+                "completed",
+                "cancelled"
+            ],
             "default": "planning"
         },
         "due_date": {
+            "index": true,
             "comment": "마감일 (*_date → DATE 자동 추론)"
         },
         "task_count": {
+            "index": true,
             "comment": "태스크 수 (*_count → INT 자동 추론)"
-        }
-    },
-    "fields": {
+        },
         "description": {
             "type": "text",
             "comment": "프로젝트 설명"

package/template/samples/entities/11_hook_webhook.json

@@ -1,34 +1,48 @@
 {
     "name": "payment",
     "description": "webhook 훅 예제 — 결제 완료/환불 시 외부 정산 서비스 실시간 통보",
-    "index": {
+    "fields": {
         "order_seq": {
+            "index": true,
             "comment": "주문 seq",
             "required": true
         },
         "user_seq": {
+            "index": true,
             "comment": "결제자 user seq",
             "required": true
         },
         "amount": {
+            "index": true,
             "comment": "결제 금액 (*_amount → DECIMAL(15,2) 자동 추론)",
             "required": true
         },
         "method": {
+            "index": true,
             "comment": "결제 수단",
-            "type": ["card", "bank_transfer", "virtual_account", "point"],
+            "type": [
+                "card",
+                "bank_transfer",
+                "virtual_account",
+                "point"
+            ],
             "required": true
         },
         "status": {
+            "index": true,
             "comment": "결제 상태",
-            "type": ["pending", "paid", "cancelled", "refunded"],
+            "type": [
+                "pending",
+                "paid",
+                "cancelled",
+                "refunded"
+            ],
             "default": "pending"
         },
         "paid_at": {
+            "index": true,
             "comment": "결제 완료일시 (*_at → DATETIME 자동 추론)"
-        }
-    },
-    "fields": {
+        },
         "pg_transaction_id": {
             "type": "varchar(100)",
             "comment": "PG사 거래 ID"

package/template/samples/entities/12_hook_push.json

@@ -1,25 +1,36 @@
 {
     "name": "delivery",
     "description": "push 훅 예제 — 배송 상태 변경 시 고객에게 푸시 알림 전송 (FCM / APNs 공통, 다단계 상태 알림)",
-    "index": {
+    "fields": {
         "order_seq": {
+            "index": true,
             "comment": "주문 seq",
             "required": true
         },
         "customer_seq": {
+            "index": true,
             "comment": "고객 user seq",
             "required": true
         },
         "tracking_number": {
+            "index": true,
             "comment": "운송장 번호",
             "unique": true
         },
         "carrier": {
+            "index": true,
             "comment": "택배사",
-            "type": ["cj", "lotte", "hanjin", "post", "direct"],
+            "type": [
+                "cj",
+                "lotte",
+                "hanjin",
+                "post",
+                "direct"
+            ],
             "default": "cj"
         },
         "status": {
+            "index": true,
             "comment": "배송 상태",
             "type": [
                 "ready",
@@ -32,9 +43,11 @@
             "default": "ready"
         },
         "estimated_date": {
+            "index": true,
             "comment": "예상 도착일 (*_date → DATE 자동 추론)"
         },
         "delivered_at": {
+            "index": true,
             "comment": "배송 완료일시 (*_at → DATETIME 자동 추론)"
         }
     },

package/template/samples/entities/13_read_only.json

@@ -4,18 +4,22 @@
     "read_only": true,
     "hard_delete": true,
     "history_ttl": 0,
-    "index": {
+    "fields": {
         "actor_seq": {
+            "index": true,
             "comment": "행위자 user seq (null = 시스템)"
         },
         "entity_name": {
+            "index": true,
             "comment": "대상 엔티티명",
             "required": true
         },
         "entity_seq": {
+            "index": true,
             "comment": "대상 레코드 seq"
         },
         "action": {
+            "index": true,
             "comment": "수행된 작업",
             "type": [
                 "INSERT",
@@ -29,15 +33,15 @@
             "required": true
         },
         "ip_address": {
+            "index": true,
             "comment": "요청 IP",
             "type": "varchar(45)"
         },
         "result_code": {
+            "index": true,
             "comment": "결과 코드 (HTTP 상태)",
             "type": "int"
-        }
-    },
-    "fields": {
+        },
         "before_snapshot": {
             "type": "json",
             "comment": "변경 전 데이터 스냅샷"

package/template/samples/entities/14_optimistic_lock.json

@@ -2,28 +2,39 @@
     "name": "inventory",
     "description": "optimistic_lock 예제 — 동시 수정 충돌 방지가 필요한 재고 엔티티",
     "optimistic_lock": true,
-    "index": {
+    "fields": {
         "product_seq": {
+            "index": true,
             "comment": "상품 seq",
             "required": true,
             "unique": true
         },
         "warehouse_code": {
+            "index": true,
             "comment": "창고 코드",
             "required": true
         },
         "qty_available": {
+            "index": true,
             "comment": "가용 재고 수량 (*_qty → INT 자동 추론)"
         },
         "qty_reserved": {
+            "index": true,
             "comment": "예약된 재고 수량 (*_qty → INT 자동 추론)"
         },
         "location": {
+            "index": true,
             "comment": "창고 내 위치 (예: A-01-03)"
         },
         "last_stocked_at": {
+            "index": true,
             "comment": "마지막 입고일시 (*_at → DATETIME 자동 추론)"
         }
     },
-    "unique": [["product_seq", "warehouse_code"]]
+    "unique": [
+        [
+            "product_seq",
+            "warehouse_code"
+        ]
+    ]
 }

package/template/samples/entities/15_reset_defaults.json

@@ -1,19 +1,23 @@
 {
     "name": "country",
     "description": "reset_defaults 예제 — reset-all 실행 시 주요 국가 코드 자동 시딩",
-    "index": {
+    "fields": {
         "code": {
+            "index": true,
             "comment": "ISO 3166-1 alpha-2 국가 코드 (예: KR, US)",
             "required": true,
             "unique": true
         },
         "name_ko": {
+            "index": true,
             "comment": "국가명 (한국어)"
         },
         "name_en": {
+            "index": true,
             "comment": "국가명 (영어)"
         },
         "region": {
+            "index": true,
             "comment": "대륙/지역",
             "type": [
                 "asia",
@@ -25,9 +29,11 @@
             ]
         },
         "phone_code": {
+            "index": true,
             "comment": "국가 전화 코드 (예: +82)"
         },
         "is_active": {
+            "index": true,
             "comment": "서비스 지원 여부 (is_* → TINYINT(1) 자동 추론)",
             "default": true
         }

package/template/samples/entities/16_isolated_license.json

@@ -2,34 +2,43 @@
     "name": "organization",
     "description": "isolated: license 예제 — 이 엔티티가 테넌트(라이선스) 경계를 정의하는 루트 엔티티. license_seq FK 없이 license_seq 컬럼을 직접 소유",
     "isolated": "license",
-    "index": {
+    "fields": {
         "name": {
+            "index": true,
             "comment": "조직명",
             "required": true,
             "unique": true
         },
         "plan": {
+            "index": true,
             "comment": "구독 플랜",
-            "type": ["free", "starter", "pro", "enterprise"],
+            "type": [
+                "free",
+                "starter",
+                "pro",
+                "enterprise"
+            ],
             "default": "free"
         },
         "max_members": {
+            "index": true,
             "comment": "최대 팀원 수",
             "type": "uint",
             "default": 5
         },
         "owner_seq": {
+            "index": true,
             "comment": "소유자 account seq"
         },
         "is_active": {
+            "index": true,
             "comment": "활성 여부 (is_* → TINYINT(1) 자동 추론)",
             "default": true
         },
         "expires_at": {
+            "index": true,
             "comment": "구독 만료일시 (*_at → DATETIME 자동 추론)"
-        }
-    },
-    "fields": {
+        },
         "billing_email": {
             "type": "varchar(255)",
             "comment": "청구용 이메일"
@@ -38,7 +47,11 @@
             "comment": "조직 설정 (중첩 fields 그룹)",
             "fields": {
                 "theme": {
-                    "type": ["light", "dark", "system"],
+                    "type": [
+                        "light",
+                        "dark",
+                        "system"
+                    ],
                     "comment": "기본 UI 테마",
                     "default": "system"
                 },

package/template/scripts/reset-all.sh

@@ -1,18 +1,99 @@
 #!/bin/bash
 
+set -e
+set -o pipefail
+
 # Reset all entity tables and seed default data
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+RESET_LOG=""
+
+cleanup() {
+    if [ -n "$RESET_LOG" ] && [ -f "$RESET_LOG" ]; then
+        rm -f "$RESET_LOG"
+    fi
+}
+
+trap cleanup EXIT
 
 cd "$PROJECT_ROOT"
 
 # Load language from .env
 if [ -f .env ]; then
-    LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2)
+    LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2 || true)
 fi
 LANGUAGE=${LANGUAGE:-ko}
 
+get_env_value() {
+    local key="$1"
+    local value="${!key}"
+
+    if [ -n "$value" ]; then
+        echo "$value"
+        return
+    fi
+
+    if [ -f .env ]; then
+        value=$(grep -E "^${key}=" .env | tail -n 1 | cut -d '=' -f2-)
+        echo "$value"
+    fi
+}
+
+get_database_default_group() {
+    grep -E '"default"[[:space:]]*:' "$PROJECT_ROOT/configs/database.json" \
+        | head -n 1 \
+        | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/'
+}
+
+get_database_group_field() {
+    local group="$1"
+    local field="$2"
+
+    awk -v group="$group" -v field="$field" '
+        $0 ~ "^[[:space:]]*\"" group "\"[[:space:]]*:[[:space:]]*\\{" { in_group=1; next }
+        in_group && $0 ~ "^[[:space:]]*}" { exit }
+        in_group && $0 ~ "^[[:space:]]*\"" field "\"[[:space:]]*:" {
+            match($0, /"[^"]+"[[:space:]]*:[[:space:]]*"([^"]+)"/, arr)
+            if (arr[1] != "") {
+                print arr[1]
+            }
+            exit
+        }
+    ' "$PROJECT_ROOT/configs/database.json"
+}
+
+resolve_database_name() {
+    local group="$1"
+    local raw_value
+    raw_value=$(get_database_group_field "$group" "database")
+
+    if [[ "$raw_value" =~ ^\$\{([A-Z0-9_]+)\}$ ]]; then
+        get_env_value "${BASH_REMATCH[1]}"
+        return
+    fi
+
+    echo "$raw_value"
+}
+
+print_target_database() {
+    local group
+    local database_name
+
+    group=$(get_database_default_group)
+    database_name=$(resolve_database_name "$group")
+
+    echo ""
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "Target database group: ${group:-<unknown>}"
+        echo "Target database name : ${database_name:-<unknown>}"
+    else
+        echo "대상 DB 그룹 : ${group:-<unknown>}"
+        echo "대상 DB 이름 : ${database_name:-<unknown>}"
+    fi
+    echo ""
+}
+
 # Show usage if no arguments
 if [ $# -eq 0 ]; then
     if [ "$LANGUAGE" = "en" ]; then
@@ -66,9 +147,11 @@ fi
 # Execute based on flag
 case "$1" in
     --dry-run)
+        print_target_database
         "$PROJECT_ROOT/bin/entity-cli" reset-all
         ;;
     --force|--apply)
+        print_target_database
         # 필수 엔티티 없으면 자동 생성 (api_keys, rbac_roles, account, user)
         if [ "$LANGUAGE" = "en" ]; then
             echo "⚙️  Checking required entities..."
@@ -76,10 +159,54 @@ case "$1" in
             echo "⚙️  필수 엔티티 확인 중..."
         fi
         LANGUAGE="$LANGUAGE" "$SCRIPT_DIR/normalize-entities.sh" --apply
+
+        RESET_LOG=$(mktemp)
         if [ "$1" = "--force" ]; then
-            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply --force
+            set +e
+            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply --force 2>&1 | tee "$RESET_LOG"
+            RESET_STATUS=${PIPESTATUS[0]}
+            set -e
         else
-            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply
+            set +e
+            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply 2>&1 | tee "$RESET_LOG"
+            RESET_STATUS=${PIPESTATUS[0]}
+            set -e
+        fi
+
+        if [ "$RESET_STATUS" -ne 0 ]; then
+            exit "$RESET_STATUS"
+        fi
+
+        if ! grep -q "Reset completed successfully!" "$RESET_LOG"; then
+            exit 0
+        fi
+
+        # 새로 생성된 API 키 조회 후 .env 업데이트
+        NEW_API_KEY=$("$PROJECT_ROOT/bin/entity-cli" api-key show --seq=1 --reveal-secret 2>/dev/null | grep -E '^key_value' | awk '{print $NF}')
+        NEW_HMAC=$("$PROJECT_ROOT/bin/entity-cli" api-key show --seq=1 --reveal-secret 2>/dev/null | grep -E '^hmac_secret' | awk '{print $NF}')
+
+        if [ -n "$NEW_API_KEY" ] && [ -n "$NEW_HMAC" ]; then
+            echo ""
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "🔑 New API Key generated:"
+            else
+                echo "🔑 새 API 키가 생성되었습니다:"
+            fi
+            echo "   ENTITY_API_KEY    = $NEW_API_KEY"
+            echo "   ENTITY_HMAC_SECRET = $NEW_HMAC"
+
+            # 게이트웨이 .env 자동 업데이트 (개발 환경: entity-app-server/ 폴더가 같은 레벨에 있을 때만)
+            GW_DIR="$(dirname "$PROJECT_ROOT")/entity-app-server"
+            GW_ENV="$GW_DIR/.env"
+            if [ -d "$GW_DIR" ] && [ -f "$GW_ENV" ]; then
+                sed -i "s|^ENTITY_API_KEY=.*|ENTITY_API_KEY=$NEW_API_KEY|" "$GW_ENV"
+                sed -i "s|^ENTITY_HMAC_SECRET=.*|ENTITY_HMAC_SECRET=$NEW_HMAC|" "$GW_ENV"
+                if [ "$LANGUAGE" = "en" ]; then
+                    echo "   ✓ Updated: entity-app-server/.env"
+                else
+                    echo "   ✓ 업데이트 완료: entity-app-server/.env"
+                fi
+            fi
         fi
         ;;
     *)