create-entity-server 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-entity-server",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Create a new entity-server project in one command — like create-react-app or create-vite.",
   "keywords": [
     "entity-server",

package/template/configs/backup.json

@@ -0,0 +1,44 @@
+{
+    "_comment": "백업 설정 파일입니다. 데이터베이스, 파일, 스키마 백업 옵션과 알림 설정을 포함합니다. 백업을 활성화하려면 'enabled'를 true로 변경하세요. storage 옵션은 백업 파일의 저장 위치를 지정합니다. 데이터베이스 백업은 스케줄에 따라 자동으로 수행되며, 포함/제외할 엔티티를 세밀하게 설정할 수 있습니다. 파일 백업은 실시간 또는 예약 모드로 설정할 수 있으며, 실패 시 재시도 옵션도 제공합니다. 스키마 백업은 엔티티 정의의 버전 관리를 위해 유용합니다. 알림 설정을 통해 백업 성공 또는 실패 시 로그 기록이나 이메일 알림을 받을 수 있습니다.",
+    "enabled": false,
+    "storage": "local-backup",
+    "prefix": "backups",
+
+    "database": {
+        "enabled": true,
+        "schedule": "0 2 * * *",
+        "db_group": ["default"],
+        "entities": {
+            "include": ["account_login_log"],
+            "exclude": [],
+            "exclude_patterns": ["*_log"]
+        },
+        "include_history": false,
+        "format": "jsonl",
+        "compress": true,
+        "encrypt_passphrase": "${BACKUP_ENCRYPT_KEY}",
+        "batch_size": 500,
+        "max_concurrent_entities": 3,
+        "retention": {
+            "keep_count": 7,
+            "keep_days": 30
+        }
+    },
+
+    "files": {
+        "enabled": true,
+        "mode": "realtime",
+        "max_retries": 3,
+        "retry_interval_sec": 60
+    },
+
+    "schema": {
+        "enabled": true
+    },
+
+    "notification": {
+        "on_success": false,
+        "on_failure": true,
+        "channels": ["log", "smtp"]
+    }
+}

package/template/configs/storage.json

@@ -0,0 +1,45 @@
+{
+    "_comment": "파일 저장 설정 파일입니다. 여러 스토리지 드라이버를 지원하며, 각 드라이버에 대한 설정을 포함합니다. 파일 업로드 기능을 활성화하려면 'enabled'를 true로 변경하세요. 'default'는 기본 스토리지 드라이버를 지정하며, 'max_file_size_mb'는 업로드 가능한 최대 파일 크기를 메가바이트 단위로 설정합니다. 'storages' 섹션에서는 각 스토리지 드라이버의 구체적인 설정을 정의할 수 있습니다. 썸네일 생성 옵션도 포함되어 있어, 자동 회전과 다양한 크기의 썸네일을 생성할 수 있습니다. 저장 공간이 부족할 때 알림을 받을 수 있도록 쿼터 설정도 제공하며, 가비지 컬렉션 기능을 통해 고아 파일을 정기적으로 청소할 수 있습니다.",
+    "enabled": true,
+    "default": "local-main",
+    "max_file_size_mb": 20,
+    "storages": {
+        "local-main": {
+            "driver": "local",
+            "root": "./uploads"
+        },
+        "local-backup": {
+            "driver": "local",
+            "root": "./backup"
+        }
+    },
+    "thumbnail": {
+        "enabled": true,
+        "auto_orient": true,
+        "sizes": {
+            "sm": {
+                "width": 160,
+                "height": 160
+            },
+            "md": {
+                "width": 480,
+                "height": 480
+            },
+            "lg": {
+                "width": 1024,
+                "height": 1024
+            }
+        },
+        "quality": 85
+    },
+    "quota": {
+        "default_limit_gb": 0,
+        "threshold_percent": 80,
+        "notify": ["log", "smtp"]
+    },
+    "gc": {
+        "enabled": true,
+        "orphan_threshold_hours": 24,
+        "cron": "0 3 * * *"
+    }
+}

package/template/scripts/reset-all.sh

@@ -187,31 +187,46 @@ case "$1" in
         fi
 
         # 새로 생성된 API 키 조회 후 .env 업데이트
-        NEW_API_KEY=$("$ENTITY_CLI_BIN" api-key show --seq=1 --reveal-secret 2>/dev/null | grep -E '^key_value' | awk '{print $NF}')
-        NEW_HMAC=$("$ENTITY_CLI_BIN" api-key show --seq=1 --reveal-secret 2>/dev/null | grep -E '^hmac_secret' | awk '{print $NF}')
+        FIRST_SEQ=$("$ENTITY_CLI_BIN" api-key list 2>/dev/null | awk 'NR>4 && /^[0-9]/ {print $1; exit}')
+        API_KEY_OUTPUT=""
+        if [ -n "$FIRST_SEQ" ]; then
+            API_KEY_OUTPUT=$("$ENTITY_CLI_BIN" api-key show --seq="$FIRST_SEQ" --reveal-secret 2>/dev/null)
+        fi
+        NEW_API_KEY=$(echo "$API_KEY_OUTPUT" | grep -E '^key_value' | awk '{print $NF}' || true)
+        NEW_HMAC=$(echo "$API_KEY_OUTPUT" | grep -E '^hmac_secret' | awk '{print $NF}' || true)
 
         if [ -n "$NEW_API_KEY" ] && [ -n "$NEW_HMAC" ]; then
+            # 게이트웨이 .env 자동 업데이트 (개발 환경: entity-app-server/ 폴더가 같은 레벨에 있을 때만)
+            GW_DIR="$(dirname "$PROJECT_ROOT")/entity-app-server"
+            GW_ENV="$GW_DIR/.env"
+            GW_UPDATED=0
+            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"
+                GW_UPDATED=1
+            fi
+
             echo ""
+            echo "=================================================="
             if [ "$LANGUAGE" = "en" ]; then
                 echo "🔑 New API Key generated:"
             else
                 echo "🔑 새 API 키가 생성되었습니다:"
             fi
-            echo "   ENTITY_API_KEY    = $NEW_API_KEY"
+            echo ""
+            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"
+            echo ""
+            if [ "$GW_UPDATED" = "1" ]; then
                 if [ "$LANGUAGE" = "en" ]; then
                     echo "   ✓ Updated: entity-app-server/.env"
                 else
                     echo "   ✓ 업데이트 완료: entity-app-server/.env"
                 fi
+                echo ""
             fi
+            echo "=================================================="
+            echo ""
         fi
         ;;
     *)

package/template/configs/extensions/backup.json

@@ -1,46 +0,0 @@
-{
-    "enabled": false,
-
-    "data": {
-        "enabled": true,
-        "schedule": "0 2 * * *",
-        "db_groups": ["default"],
-        "entities": {
-            "include": [],
-            "exclude": [],
-            "exclude_patterns": ["*_log"]
-        },
-        "include_history": false,
-        "format": "jsonl",
-        "compress": true,
-        "encrypt_passphrase": "${BACKUP_ENCRYPT_KEY}",
-        "batch_size": 500,
-        "max_concurrent_entities": 3,
-        "retention": {
-            "keep_count": 7,
-            "keep_days": 30
-        }
-    },
-
-    "files": {
-        "enabled": true,
-        "mode": "realtime",
-        "max_retries": 3,
-        "retry_interval_sec": 60
-    },
-
-    "schema": {
-        "enabled": true
-    },
-
-    "target": {
-        "storage_key": "s3-backup",
-        "prefix": "backups"
-    },
-
-    "notification": {
-        "on_success": false,
-        "on_failure": true,
-        "channels": ["log", "smtp"]
-    }
-}

package/template/configs/extensions/storage.json

@@ -1,148 +0,0 @@
-{
-    "enabled": true,
-    "default": "local-main",
-    "max_file_size_mb": 20,
-    "storages": {
-        "local-main": {
-            "driver": "local",
-            "root": "./uploads"
-        },
-
-        "s3-aws": {
-            "driver": "s3",
-            "bucket": "my-entity-files",
-            "region": "ap-northeast-2",
-            "access_key": "${AWS_ACCESS_KEY_ID}",
-            "secret_key": "${AWS_SECRET_ACCESS_KEY}",
-            "prefix": "entity-files"
-        },
-
-        "s3-r2": {
-            "driver": "s3",
-            "bucket": "my-files",
-            "region": "auto",
-            "endpoint": "https://${CF_ACCOUNT_ID}.r2.cloudflarestorage.com",
-            "access_key": "${R2_ACCESS_KEY}",
-            "secret_key": "${R2_SECRET_KEY}",
-            "prefix": "",
-            "_comment": "Cloudflare R2 (S3 호환) — 이그레스 무료"
-        },
-
-        "s3-b2": {
-            "driver": "s3",
-            "bucket": "my-files",
-            "region": "us-west-004",
-            "endpoint": "https://s3.us-west-004.backblazeb2.com",
-            "access_key": "${B2_KEY_ID}",
-            "secret_key": "${B2_APP_KEY}",
-            "_comment": "Backblaze B2 (S3 호환) — S3 대비 1/4 가격"
-        },
-
-        "s3-wasabi": {
-            "driver": "s3",
-            "bucket": "my-files",
-            "region": "ap-northeast-2",
-            "endpoint": "https://s3.ap-northeast-2.wasabisys.com",
-            "access_key": "${WASABI_ACCESS_KEY}",
-            "secret_key": "${WASABI_SECRET_KEY}",
-            "_comment": "Wasabi (S3 호환) — 저가 hot storage"
-        },
-
-        "s3-do-spaces": {
-            "driver": "s3",
-            "bucket": "my-files",
-            "region": "sgp1",
-            "endpoint": "https://sgp1.digitaloceanspaces.com",
-            "access_key": "${DO_SPACES_KEY}",
-            "secret_key": "${DO_SPACES_SECRET}",
-            "_comment": "DigitalOcean Spaces (S3 호환)"
-        },
-
-        "s3-minio": {
-            "driver": "s3",
-            "bucket": "entity-files",
-            "region": "us-east-1",
-            "endpoint": "http://minio.internal:9000",
-            "access_key": "minioadmin",
-            "secret_key": "minioadmin",
-            "_comment": "MinIO (S3 호환) — 자체 호스팅"
-        },
-
-        "s3-ncloud": {
-            "driver": "s3",
-            "bucket": "my-files",
-            "region": "kr-standard",
-            "endpoint": "https://kr.object.ncloudstorage.com",
-            "access_key": "${NCLOUD_ACCESS_KEY}",
-            "secret_key": "${NCLOUD_SECRET_KEY}",
-            "_comment": "Naver Cloud Object Storage (S3 호환)"
-        },
-
-        "azure-example": {
-            "driver": "azure",
-            "container": "files",
-            "account_name": "${AZURE_STORAGE_ACCOUNT}",
-            "account_key": "${AZURE_STORAGE_KEY}",
-            "prefix": "entity-files"
-        },
-
-        "gcs-example": {
-            "driver": "gcs",
-            "bucket": "my-entity-files",
-            "credentials_file": "./configs/keys/gcp-sa.json",
-            "prefix": "entity-files",
-            "_comment": "GKE/Cloud Run에서는 credentials_file 불필요 (Workload Identity)"
-        },
-
-        "sftp-example": {
-            "driver": "sftp",
-            "host": "nas.company.com",
-            "port": 22,
-            "user": "backup",
-            "private_key_file": "./configs/keys/backup_rsa",
-            "root": "/volume1/entity-files",
-            "_comment": "NAS/온프레미스 서버 연동"
-        },
-
-        "swift-kt": {
-            "driver": "swift",
-            "auth_url": "https://ssproxy.ucloudbiz.olleh.com/identity/v3",
-            "container": "my-files",
-            "user": "${KT_USER}",
-            "password": "${KT_PASSWORD}",
-            "tenant_name": "${KT_TENANT}",
-            "domain_name": "Default",
-            "region": "kr1",
-            "_comment": "KT Cloud Storage (OpenStack Swift)"
-        }
-    },
-    "thumbnail": {
-        "enabled": true,
-        "auto_orient": true,
-        "sizes": {
-            "sm": {
-                "width": 160,
-                "height": 160
-            },
-            "md": {
-                "width": 480,
-                "height": 480
-            },
-            "lg": {
-                "width": 1024,
-                "height": 1024
-            }
-        },
-        "quality": 85
-    },
-    "quota": {
-        "default_limit_gb": 0,
-        "threshold_percent": 80,
-        "notify": ["log", "smtp"]
-    },
-    "gc": {
-        "enabled": true,
-        "orphan_threshold_hours": 24,
-        "cron": "0 3 * * *"
-    }
-}