create-entity-server 0.0.27 → 0.0.31

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,15 +1,27 @@
 #!/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}
 
@@ -76,10 +88,52 @@ 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 자동 업데이트 (같은 저장소 내에 있는 경우)
+            GW_ENV="$PROJECT_ROOT/packages/entity-app-server/.env"
+            if [ -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: packages/entity-app-server/.env"
+                else
+                    echo "   ✓ 업데이트 완료: packages/entity-app-server/.env"
+                fi
+            fi
         fi
         ;;
     *)

package/template/scripts/run.sh

@@ -62,6 +62,9 @@ is_running() {
         if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
             return 0
         fi
+        if is_port_in_use; then
+            return 0
+        fi
         return 1
     fi
     local pid
@@ -70,6 +73,9 @@ is_running() {
         if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
             return 0
         fi
+        if is_port_in_use; then
+            return 0
+        fi
         return 1
     fi
     if kill -0 "$pid" 2>/dev/null; then
@@ -80,6 +86,10 @@ is_running() {
         return 0
     fi
 
+    if is_port_in_use; then
+        return 0
+    fi
+
     return 1
 }
 
@@ -89,6 +99,26 @@ find_pid_by_port() {
     ss -ltnp 2>/dev/null | grep ":$port " | sed -n 's/.*pid=\([0-9]\+\).*/\1/p' | head -n 1
 }
 
+is_port_in_use() {
+    local port
+    port=$(get_server_value "port" "3400")
+    ss -ltn 2>/dev/null | grep -q ":$port "
+}
+
+show_port_in_use_message() {
+    local port
+    port=$(get_server_value "port" "3400")
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ Port $port is already in use, but the owning PID could not be identified."
+        echo "Check with: ss -ltnp | grep :$port"
+        echo "Or: lsof -iTCP:$port -sTCP:LISTEN -n -P"
+    else
+        echo "❌ 포트 $port 가 이미 사용 중이지만, 점유 PID를 식별할 수 없습니다."
+        echo "확인: ss -ltnp | grep :$port"
+        echo "또는: lsof -iTCP:$port -sTCP:LISTEN -n -P"
+    fi
+}
+
 stop_pid_with_confirm() {
     local pid="$1"
     local reason="$2"
@@ -157,6 +187,10 @@ stop_server() {
             stop_pid_with_confirm "$port_pid" "port fallback"
             return $?
         fi
+        if is_port_in_use; then
+            show_port_in_use_message
+            return 1
+        fi
         if [ "$LANGUAGE" = "en" ]; then
             echo "ℹ️  Server is not running (pid file not found)."
         else
@@ -191,6 +225,10 @@ stop_server() {
             stop_pid_with_confirm "$port_pid" "port fallback"
             return $?
         fi
+        if is_port_in_use; then
+            show_port_in_use_message
+            return 1
+        fi
         if [ "$LANGUAGE" = "en" ]; then
             echo "ℹ️  Stale pid file removed (process not found)."
         else
@@ -305,10 +343,16 @@ fi
 case "$MODE" in
     dev|development)
         if is_running; then
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ Server already running (pid: $(cat "$PID_FILE")). Stop first: ./run.sh stop"
+            local running_pid
+            running_pid=$(find_pid_by_port)
+            if [ -n "$running_pid" ]; then
+                if [ "$LANGUAGE" = "en" ]; then
+                    echo "❌ Server already running (pid: $running_pid). Stop first: ./run.sh stop"
+                else
+                    echo "❌ 이미 서버가 실행 중입니다 (pid: $running_pid). 먼저 중지하세요: ./run.sh stop"
+                fi
             else
-                echo "❌ 이미 서버가 실행 중입니다 (pid: $(cat "$PID_FILE")). 먼저 중지하세요: ./run.sh stop"
+                show_port_in_use_message
             fi
             exit 1
         fi
@@ -329,10 +373,16 @@ case "$MODE" in
         
     start)
         if is_running; then
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ Server already running (pid: $(cat "$PID_FILE")). Stop first: ./run.sh stop"
+            local running_pid
+            running_pid=$(find_pid_by_port)
+            if [ -n "$running_pid" ]; then
+                if [ "$LANGUAGE" = "en" ]; then
+                    echo "❌ Server already running (pid: $running_pid). Stop first: ./run.sh stop"
+                else
+                    echo "❌ 이미 서버가 실행 중입니다 (pid: $running_pid). 먼저 중지하세요: ./run.sh stop"
+                fi
             else
-                echo "❌ 이미 서버가 실행 중입니다 (pid: $(cat "$PID_FILE")). 먼저 중지하세요: ./run.sh stop"
+                show_port_in_use_message
             fi
             exit 1
         fi