create-entity-server 0.7.11 → 0.9.12

package/package.json

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

package/template/.env.example

@@ -1,6 +1,12 @@
 # 서버 포트 (configs/server.json의 port를 오버라이드)
 # SERVER_PORT=47200
 
+# 서버 네임스페이스 (configs/server.json의 namespace보다 우선)
+# SERVER_NAMESPACE=entity-prod
+
+# 기본 이메일 도메인 (configs/server.json의 default_email_domain보다 우선)
+# DEFAULT_EMAIL_DOMAIN=example.com
+
 # Entity Server 환경변수 설정 예시
 # 실제 사용시 이 파일을 .env로 복사하고 값을 변경하세요: cp .env.example .env
 # ./scripts/generate-env-keys.sh 를 사용하여 랜덤 시크릿을 생성할 수 있습니다.

package/template/configs/mimes.json

@@ -0,0 +1,64 @@
+{
+    "jpg": ["image/jpeg", "image/pjpeg"],
+    "jpeg": ["image/jpeg", "image/pjpeg"],
+    "png": "image/png",
+    "gif": "image/gif",
+    "webp": "image/webp",
+    "bmp": ["image/bmp", "image/x-bmp", "image/x-ms-bmp"],
+    "tif": "image/tiff",
+    "tiff": "image/tiff",
+    "svg": "image/svg+xml",
+    "pdf": [
+        "application/pdf",
+        "application/force-download",
+        "application/x-download"
+    ],
+    "csv": [
+        "text/csv",
+        "application/csv",
+        "application/vnd.ms-excel",
+        "text/plain"
+    ],
+    "xls": [
+        "application/vnd.ms-excel",
+        "application/msexcel",
+        "application/x-msexcel",
+        "application/x-ms-excel",
+        "application/x-excel",
+        "application/vnd.ms-office"
+    ],
+    "xlsx": [
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        "application/vnd.ms-excel",
+        "application/zip"
+    ],
+    "xlsm": [
+        "application/vnd.ms-excel.sheet.macroenabled.12",
+        "application/vnd.ms-excel",
+        "application/zip"
+    ],
+    "xlsb": [
+        "application/vnd.ms-excel.sheet.binary.macroenabled.12",
+        "application/vnd.ms-excel",
+        "application/zip"
+    ],
+    "doc": ["application/msword", "application/vnd.ms-office"],
+    "docx": [
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        "application/zip"
+    ],
+    "ppt": [
+        "application/vnd.ms-powerpoint",
+        "application/powerpoint",
+        "application/vnd.ms-office"
+    ],
+    "pptx": [
+        "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        "application/zip"
+    ],
+    "zip": [
+        "application/zip",
+        "application/x-zip",
+        "application/x-zip-compressed"
+    ]
+}

package/template/configs/server.json

@@ -6,6 +6,7 @@
     "timezone": "Asia/Seoul",
     "environment": "production",
     "port": 47200,
+    "min_search_token_length": 2,
     "enable_auto_schema_sync": true,
     "global_license_scope": true,
     "global_optimistic_lock": false

package/template/entities/System/Auth/license.json

@@ -21,7 +21,8 @@
         },
         "expire_date": {
             "index": true,
-            "comment": "만료일"
+            "comment": "만료일",
+            "nullable": true
         },
         "name": {
             "index": true,
@@ -44,8 +45,11 @@
             "index": true,
             "comment": "시군구"
         },
-        "max_user_cnt": {
-            "type": "uint"
+        "max_account_cnt": {
+            "index": true,
+            "type": "uint",
+            "default": 0,
+            "nullable": false
         }
     },
     "reset_defaults": [

package/template/entities/System/Auth/rbac_roles.json

@@ -1,6 +1,7 @@
 {
     "name": "rbac_roles",
     "description": "역할 기반 접근 제어 역할 정의.",
+    "index_table_only": true,
     "license_scope": false,
     "hard_delete": true,
     "fields": {
@@ -10,8 +11,12 @@
             "required": true,
             "unique": true
         },
+        "description": {
+            "comment": "역할 설명"
+        },
         "permissions": {
-            "type": "text"
+            "type": "json",
+            "comment": "권한 목록"
         }
     },
     "reset_defaults": [

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

@@ -11,6 +11,12 @@
             "type": ["none", "pending", "synced", "failed", "skipped"],
             "default": "none"
         },
+        "is_public": {
+            "index": true,
+            "comment": "공개 파일 여부 (인증 없이 GET 접근 가능)",
+            "type": "boolean",
+            "default": false
+        },
         "size": {
             "index": true,
             "comment": "파일 크기 (bytes)",
@@ -46,9 +52,12 @@
             "comment": "파일이 첨부된 필드 이름 (file/file[] 타입 필드)"
         },
         "mime_type": {
+            "index": true,
             "comment": "파일 MIME 타입 (image/jpeg, application/pdf 등)"
         },
         "original_name": {
+            "search": true,
+            "encrypt": true,
             "comment": "업로드 시 원본 파일명 (보안 대상 — 암호화 저장)"
         },
         "storage_key": {

package/template/scripts/api-key.ps1

@@ -1,123 +1,123 @@
-# API Key Management Script (CLI mode) - Windows PowerShell
-# Can be used even when the server is stopped.
-param(
-    [Parameter(Position=0)]
-    [string]$SubCommand = ""
-)
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = Split-Path -Parent $ScriptDir
-$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
-
-Set-Location $ProjectRoot
-
-# Load language from .env
-$Language = "ko"
-$EnvFile = Join-Path $ProjectRoot ".env"
-if (Test-Path $EnvFile) {
-    $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -First 1
-    if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
-}
-
-function Show-Help {
-    if ($Language -eq "en") {
-        Write-Host "API Key Management (CLI mode)"
-        Write-Host "============================="
-        Write-Host ""
-        Write-Host "Manage api_keys entity directly via CLI binary."
-        Write-Host "Server does NOT need to be running."
-        Write-Host ""
-        Write-Host "Usage: .\api-key.ps1 <subcommand> [options]"
-        Write-Host ""
-        Write-Host "Subcommands:"
-        Write-Host "  list              List API keys"
-        Write-Host "  add               Create a new API key (key/secret auto-generated)"
-        Write-Host "  delete            Delete an API key by seq"
-        Write-Host "  help              Show this help"
-        Write-Host ""
-        Write-Host "list options:"
-        Write-Host "  --limit=<n>       Max rows to show (default: 20)"
-        Write-Host ""
-        Write-Host "add options:"
-        Write-Host "  --role=<name>     Role name (default: admin)"
-        Write-Host "  --entities=<json> Allowed entities JSON (default: [`"*`"])"
-        Write-Host "  --description=<t> Description"
-        Write-Host "  --user-seq=<n>    Associated user seq"
-        Write-Host "  --apply           Execute (default is dry-run)"
-        Write-Host ""
-        Write-Host "delete options:"
-        Write-Host "  --seq=<n>         API key seq to delete (required)"
-        Write-Host "  --apply           Execute (default is dry-run)"
-        Write-Host ""
-        Write-Host "Examples:"
-        Write-Host "  .\api-key.ps1 list"
-        Write-Host "  .\api-key.ps1 list --limit=50"
-        Write-Host "  .\api-key.ps1 add --role=admin --apply"
-        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
-    } else {
-        Write-Host "API 키 관리 (CLI 모드)"
-        Write-Host "===================="
-        Write-Host ""
-        Write-Host "CLI 바이너리로 api_keys 엔티티를 직접 조작합니다."
-        Write-Host "서버가 실행 중이지 않아도 사용 가능합니다."
-        Write-Host ""
-        Write-Host "사용법: .\api-key.ps1 <하위명령> [옵션]"
-        Write-Host ""
-        Write-Host "하위 명령:"
-        Write-Host "  list              API 키 목록 조회"
-        Write-Host "  add               새 API 키 생성 (키/시크릿 자동 생성)"
-        Write-Host "  delete            API 키 삭제 (seq 지정)"
-        Write-Host "  help              도움말 출력"
-        Write-Host ""
-        Write-Host "list 옵션:"
-        Write-Host "  --limit=<n>       최대 출력 행 수 (기본: 20)"
-        Write-Host ""
-        Write-Host "add 옵션:"
-        Write-Host "  --role=<이름>     역할명 (기본: admin)"
-        Write-Host "  --entities=<json> 허용 엔티티 JSON (기본: [`"*`"])"
-        Write-Host "  --description=<t> 설명"
-        Write-Host "  --user-seq=<n>    연결 사용자 seq"
-        Write-Host "  --apply           실제 실행 (기본: dry-run)"
-        Write-Host ""
-        Write-Host "delete 옵션:"
-        Write-Host "  --seq=<n>         삭제할 API 키 seq (필수)"
-        Write-Host "  --apply           실제 실행 (기본: dry-run)"
-        Write-Host ""
-        Write-Host "예제:"
-        Write-Host "  .\api-key.ps1 list"
-        Write-Host "  .\api-key.ps1 list --limit=50"
-        Write-Host "  .\api-key.ps1 add --role=admin --apply"
-        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
-    }
-}
-
-if (-not $SubCommand) {
-    Show-Help
-    exit 0
-}
-
-if (-not (Test-Path $BinPath)) {
-    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found. Run: .\scripts\build.ps1" }
-    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다. 먼저 .\scripts\build.ps1 를 실행하세요." }
-    exit 1
-}
-
-# Collect remaining args (all args after SubCommand)
-$remainingArgs = $args
-
-switch ($SubCommand) {
-    { $_ -in @("list", "show", "add", "delete") } {
-        $env:ENTITY_CLI_NAME = "api-key"
-        & $BinPath api-key $SubCommand @remainingArgs
-    }
-    { $_ -in @("help", "-h", "--help") } {
-        Show-Help
-    }
-    default {
-        if ($Language -eq "en") { Write-Host "X Unknown subcommand: $SubCommand" }
-        else { Write-Host "X 알 수 없는 하위 명령: $SubCommand" }
-        Write-Host ""
-        Show-Help
-        exit 1
-    }
-}
+# API Key Management Script (CLI mode) - Windows PowerShell
+# Can be used even when the server is stopped.
+param(
+    [Parameter(Position=0)]
+    [string]$SubCommand = ""
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
+
+Set-Location $ProjectRoot
+
+# Load language from .env
+$Language = "ko"
+$EnvFile = Join-Path $ProjectRoot ".env"
+if (Test-Path $EnvFile) {
+    $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -First 1
+    if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
+}
+
+function Show-Help {
+    if ($Language -eq "en") {
+        Write-Host "API Key Management (CLI mode)"
+        Write-Host "============================="
+        Write-Host ""
+        Write-Host "Manage api_keys entity directly via CLI binary."
+        Write-Host "Server does NOT need to be running."
+        Write-Host ""
+        Write-Host "Usage: .\api-key.ps1 <subcommand> [options]"
+        Write-Host ""
+        Write-Host "Subcommands:"
+        Write-Host "  list              List API keys"
+        Write-Host "  add               Create a new API key (key/secret auto-generated)"
+        Write-Host "  delete            Delete an API key by seq"
+        Write-Host "  help              Show this help"
+        Write-Host ""
+        Write-Host "list options:"
+        Write-Host "  --limit=<n>       Max rows to show (default: 20)"
+        Write-Host ""
+        Write-Host "add options:"
+        Write-Host "  --role=<name>     Role name (default: admin)"
+        Write-Host "  --entities=<json> Allowed entities JSON (default: [`"*`"])"
+        Write-Host "  --description=<t> Description"
+        Write-Host "  --user-seq=<n>    Associated user seq"
+        Write-Host "  --apply           Execute (default is dry-run)"
+        Write-Host ""
+        Write-Host "delete options:"
+        Write-Host "  --seq=<n>         API key seq to delete (required)"
+        Write-Host "  --apply           Execute (default is dry-run)"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\api-key.ps1 list"
+        Write-Host "  .\api-key.ps1 list --limit=50"
+        Write-Host "  .\api-key.ps1 add --role=admin --apply"
+        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
+    } else {
+        Write-Host "API 키 관리 (CLI 모드)"
+        Write-Host "===================="
+        Write-Host ""
+        Write-Host "CLI 바이너리로 api_keys 엔티티를 직접 조작합니다."
+        Write-Host "서버가 실행 중이지 않아도 사용 가능합니다."
+        Write-Host ""
+        Write-Host "사용법: .\api-key.ps1 <하위명령> [옵션]"
+        Write-Host ""
+        Write-Host "하위 명령:"
+        Write-Host "  list              API 키 목록 조회"
+        Write-Host "  add               새 API 키 생성 (키/시크릿 자동 생성)"
+        Write-Host "  delete            API 키 삭제 (seq 지정)"
+        Write-Host "  help              도움말 출력"
+        Write-Host ""
+        Write-Host "list 옵션:"
+        Write-Host "  --limit=<n>       최대 출력 행 수 (기본: 20)"
+        Write-Host ""
+        Write-Host "add 옵션:"
+        Write-Host "  --role=<이름>     역할명 (기본: admin)"
+        Write-Host "  --entities=<json> 허용 엔티티 JSON (기본: [`"*`"])"
+        Write-Host "  --description=<t> 설명"
+        Write-Host "  --user-seq=<n>    연결 사용자 seq"
+        Write-Host "  --apply           실제 실행 (기본: dry-run)"
+        Write-Host ""
+        Write-Host "delete 옵션:"
+        Write-Host "  --seq=<n>         삭제할 API 키 seq (필수)"
+        Write-Host "  --apply           실제 실행 (기본: dry-run)"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\api-key.ps1 list"
+        Write-Host "  .\api-key.ps1 list --limit=50"
+        Write-Host "  .\api-key.ps1 add --role=admin --apply"
+        Write-Host "  .\api-key.ps1 delete --seq=3 --apply"
+    }
+}
+
+if (-not $SubCommand) {
+    Show-Help
+    exit 0
+}
+
+if (-not (Test-Path $BinPath)) {
+    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found. Run: .\scripts\build.ps1" }
+    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다. 먼저 .\scripts\build.ps1 를 실행하세요." }
+    exit 1
+}
+
+# Collect remaining args (all args after SubCommand)
+$remainingArgs = $args
+
+switch ($SubCommand) {
+    { $_ -in @("list", "show", "add", "delete") } {
+        $env:ENTITY_CLI_NAME = "api-key"
+        & $BinPath api-key $SubCommand @remainingArgs
+    }
+    { $_ -in @("help", "-h", "--help") } {
+        Show-Help
+    }
+    default {
+        if ($Language -eq "en") { Write-Host "X Unknown subcommand: $SubCommand" }
+        else { Write-Host "X 알 수 없는 하위 명령: $SubCommand" }
+        Write-Host ""
+        Show-Help
+        exit 1
+    }
+}

package/template/scripts/cleanup-history.ps1

@@ -1,69 +1,69 @@
-# cleanup-history.ps1 — history_ttl 기준 이력 정리
-#
-# 사용법:
-#   .\scripts\cleanup-history.ps1                        # 도움말
-#   .\scripts\cleanup-history.ps1 --apply                # 전체 이력 정리 실행
-#   .\scripts\cleanup-history.ps1 --entity=account       # dry-run (특정 엔티티)
-#   .\scripts\cleanup-history.ps1 --entity=account --apply
-
-param(
-    [string]$Entity = "",
-    [switch]$Apply
-)
-
-$ErrorActionPreference = "Stop"
-
-$ProjectRoot = Split-Path -Parent $PSScriptRoot
-Set-Location $ProjectRoot
-
-# LANGUAGE 로드
-$Lang = $env:LANGUAGE
-if (-not $Lang) {
-    $EnvFile = Join-Path $ProjectRoot ".env"
-    if (Test-Path $EnvFile) {
-        $line = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
-        if ($line) { $Lang = $line -replace '^LANGUAGE=', '' }
-    }
-}
-if (-not $Lang) { $Lang = "ko" }
-
-function Show-Help {
-    if ($Lang -eq "en") {
-        Write-Host "History TTL Cleanup"
-        Write-Host "==================="
-        Write-Host ""
-        Write-Host "Usage: .\scripts\cleanup-history.ps1 [-Entity <name>] [-Apply]"
-        Write-Host ""
-        Write-Host "Options:"
-        Write-Host "  -Entity <name>   Cleanup only one entity history"
-        Write-Host "  -Apply           Execute delete (default: dry-run)"
-    } else {
-        Write-Host "히스토리 TTL 정리"
-        Write-Host "================"
-        Write-Host ""
-        Write-Host "사용법: .\scripts\cleanup-history.ps1 [-Entity <이름>] [-Apply]"
-        Write-Host ""
-        Write-Host "옵션:"
-        Write-Host "  -Entity <이름>   특정 엔티티 히스토리만 정리"
-        Write-Host "  -Apply           실제 삭제 실행 (기본: dry-run)"
-    }
-}
-
-# 인자 없으면 도움말
-if (-not $Apply -and -not $Entity) {
-    Show-Help
-    exit 0
-}
-
-$CliBin = Join-Path $ProjectRoot "entity-cli.exe"
-if (-not (Test-Path $CliBin)) {
-    if ($Lang -eq "en") { Write-Error "❌ entity-cli.exe not found" }
-    else                { Write-Error "❌ entity-cli.exe 파일이 없습니다" }
-    exit 1
-}
-
-$Args = @("cleanup-history")
-if ($Entity) { $Args += "--entity=$Entity" }
-if ($Apply)  { $Args += "--apply" }
-
-& $CliBin @Args
+# cleanup-history.ps1 — history_ttl 기준 이력 정리
+#
+# 사용법:
+#   .\scripts\cleanup-history.ps1                        # 도움말
+#   .\scripts\cleanup-history.ps1 --apply                # 전체 이력 정리 실행
+#   .\scripts\cleanup-history.ps1 --entity=account       # dry-run (특정 엔티티)
+#   .\scripts\cleanup-history.ps1 --entity=account --apply
+
+param(
+    [string]$Entity = "",
+    [switch]$Apply
+)
+
+$ErrorActionPreference = "Stop"
+
+$ProjectRoot = Split-Path -Parent $PSScriptRoot
+Set-Location $ProjectRoot
+
+# LANGUAGE 로드
+$Lang = $env:LANGUAGE
+if (-not $Lang) {
+    $EnvFile = Join-Path $ProjectRoot ".env"
+    if (Test-Path $EnvFile) {
+        $line = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
+        if ($line) { $Lang = $line -replace '^LANGUAGE=', '' }
+    }
+}
+if (-not $Lang) { $Lang = "ko" }
+
+function Show-Help {
+    if ($Lang -eq "en") {
+        Write-Host "History TTL Cleanup"
+        Write-Host "==================="
+        Write-Host ""
+        Write-Host "Usage: .\scripts\cleanup-history.ps1 [-Entity <name>] [-Apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  -Entity <name>   Cleanup only one entity history"
+        Write-Host "  -Apply           Execute delete (default: dry-run)"
+    } else {
+        Write-Host "히스토리 TTL 정리"
+        Write-Host "================"
+        Write-Host ""
+        Write-Host "사용법: .\scripts\cleanup-history.ps1 [-Entity <이름>] [-Apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  -Entity <이름>   특정 엔티티 히스토리만 정리"
+        Write-Host "  -Apply           실제 삭제 실행 (기본: dry-run)"
+    }
+}
+
+# 인자 없으면 도움말
+if (-not $Apply -and -not $Entity) {
+    Show-Help
+    exit 0
+}
+
+$CliBin = Join-Path $ProjectRoot "entity-cli.exe"
+if (-not (Test-Path $CliBin)) {
+    if ($Lang -eq "en") { Write-Error "❌ entity-cli.exe not found" }
+    else                { Write-Error "❌ entity-cli.exe 파일이 없습니다" }
+    exit 1
+}
+
+$Args = @("cleanup-history")
+if ($Entity) { $Args += "--entity=$Entity" }
+if ($Apply)  { $Args += "--apply" }
+
+& $CliBin @Args

package/template/scripts/cli.ps1

@@ -1,24 +1,24 @@
-# Entity CLI wrapper script (Windows PowerShell)
-
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectRoot = Split-Path -Parent $ScriptDir
-$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
-
-# Load language from .env
-$Language = "ko"
-$EnvFile = Join-Path $ProjectRoot ".env"
-if (Test-Path $EnvFile) {
-    $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -First 1
-    if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
-}
-
-# Require prebuilt CLI binary
-if (-not (Test-Path $BinPath)) {
-    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
-    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
-    exit 1
-}
-
-Set-Location $ProjectRoot
-$env:ENTITY_CLI_NAME = "cli"
-& $BinPath @args
+# Entity CLI wrapper script (Windows PowerShell)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+$BinPath = Join-Path $ProjectRoot "bin\entity-cli.exe"
+
+# Load language from .env
+$Language = "ko"
+$EnvFile = Join-Path $ProjectRoot ".env"
+if (Test-Path $EnvFile) {
+    $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -First 1
+    if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
+}
+
+# Require prebuilt CLI binary
+if (-not (Test-Path $BinPath)) {
+    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
+    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
+    exit 1
+}
+
+Set-Location $ProjectRoot
+$env:ENTITY_CLI_NAME = "cli"
+& $BinPath @args