create-entity-server 0.7.12 → 0.9.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-entity-server",
-  "version": "0.7.12",
+  "version": "0.9.13",
   "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

@@ -12,7 +12,7 @@
             "default": "none"
         },
         "is_public": {
-            "index_only": true,
+            "index": true,
             "comment": "공개 파일 여부 (인증 없이 GET 접근 가능)",
             "type": "boolean",
             "default": false
@@ -52,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/run.sh

@@ -19,8 +19,12 @@ fi
 mkdir -p "$RUN_DIR" "$PROJECT_ROOT/logs"
 SERVER_NAME="Entity Server"
 
-# Load language from .env
+# Load environment from .env
 if [ -f .env ]; then
+    set -o allexport
+    # shellcheck disable=SC1091
+    source .env
+    set +o allexport
     LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2)
 fi
 LANGUAGE=${LANGUAGE:-ko}
@@ -29,20 +33,25 @@ has_command() {
     command -v "$1" >/dev/null 2>&1
 }
 
-# 현재 프로젝트를 관리하는 systemd 서비스명을 반환합니다.
+# 현재 프로젝트를 관리하는 systemd 서비스명을 반환합니다 (상태 무관).
 find_systemd_service() {
-    local unit=""
-    local exec_start=""
-
     has_command systemctl || return 1
 
-    for unit in $(systemctl list-units --type=service --state=active,activating --no-legend 2>/dev/null | awk '{print $1}'); do
-        exec_start=$(systemctl show -p ExecStart --value "$unit" 2>/dev/null || true)
-        if [[ "$exec_start" == *"$PROJECT_ROOT/scripts/run.sh"* ]] || [[ "$exec_start" == *"$SERVER_BIN"* ]]; then
-            echo "$unit"
-            return 0
-        fi
-    done
+    local namespace="${SERVER_NAMESPACE:-${NAMESPACE:-}}"
+    if [ -z "$namespace" ] && [ -f "$SERVER_CONFIG" ]; then
+        namespace=$(sed -n 's/.*"namespace"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$SERVER_CONFIG" | head -n 1)
+    fi
+    namespace=$(echo "$namespace" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_-]/-/g')
+    [ -z "$namespace" ] && namespace="default"
+
+    local svc_name="${namespace}-entity-server.service"
+    local exec_start=""
+    exec_start=$(systemctl show -p ExecStart --value "$svc_name" 2>/dev/null || true)
+
+    if [[ "$exec_start" == *"$PROJECT_ROOT/scripts/run.sh"* ]] || [[ "$exec_start" == *"$SERVER_BIN"* ]]; then
+        echo "$svc_name"
+        return 0
+    fi
 
     return 1
 }
@@ -462,11 +471,17 @@ stop_server() {
     local svc=""
     svc=$(find_systemd_service || true)
     if [ -n "$svc" ]; then
-        echo "ℹ️  systemd 서비스 중지: $svc"
-        sudo systemctl stop "$svc"
+        local svc_state=""
+        svc_state=$(systemctl is-active "$svc" 2>/dev/null || true)
+        if [ "$svc_state" = "active" ] || [ "$svc_state" = "activating" ]; then
+            echo "ℹ️  systemd 서비스 중지: $svc"
+            sudo systemctl stop "$svc"
+            rm -f "$PID_FILE"
+            echo "✅ ${SERVER_NAME} 종료 완료 (systemd)"
+            return 0
+        fi
+        # systemd 서비스가 inactive 이어도 고아 프로세스가 남아 있을 수 있으므로 아래로 진행
         rm -f "$PID_FILE"
-        echo "✅ ${SERVER_NAME} 종료 완료 (systemd)"
-        return 0
     fi
 
     local pid=""
@@ -475,11 +490,25 @@ stop_server() {
     rm -f "$PID_FILE"
 
     if [ -n "$pid" ]; then
+        if [ -n "$svc" ]; then
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "⚠️  systemd service ($svc) is inactive, but an orphan process was found."
+            else
+                echo "⚠️  systemd 서비스($svc)는 비활성이지만, 고아 프로세스가 발견되었습니다."
+            fi
+        fi
         stop_pid_with_confirm "$pid" "active process"
         return $?
     fi
 
     if is_port_in_use; then
+        if [ -n "$svc" ]; then
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "⚠️  systemd service ($svc) is inactive, but the port is in use."
+            else
+                echo "⚠️  systemd 서비스($svc)는 비활성이지만, 포트가 사용 중입니다."
+            fi
+        fi
         show_unmanaged_server_message
         return 1
     fi
@@ -497,9 +526,14 @@ show_status() {
     local svc=""
     svc=$(find_systemd_service || true)
     if [ -n "$svc" ]; then
-        echo "ℹ️  systemd 서비스로 관리 중: $svc"
-        sudo systemctl status "$svc" --no-pager 2>/dev/null || true
-        return
+        local svc_state=""
+        svc_state=$(systemctl is-active "$svc" 2>/dev/null || true)
+        if [ "$svc_state" = "active" ] || [ "$svc_state" = "activating" ]; then
+            echo "ℹ️  systemd 서비스로 관리 중: $svc"
+            sudo systemctl status "$svc" --no-pager 2>/dev/null || true
+            return
+        fi
+        # systemd inactive 일 때 고아 프로세스 여부까지 확인
     fi
 
     local status_pid=""
@@ -507,6 +541,13 @@ show_status() {
     status_pid=$(find_active_server_pid || true)
     if [ -n "$status_pid" ]; then
         "$SERVER_BIN" banner-status RUNNING
+        if [ -n "$svc" ]; then
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "⚠️  systemd service ($svc) is inactive, but an orphan process is running."
+            else
+                echo "⚠️  systemd 서비스($svc)는 비활성이지만, 고아 프로세스가 실행 중입니다."
+            fi
+        fi
         if [ "$LANGUAGE" = "en" ]; then
             echo "PID: $status_pid (managed process)"
             echo "Stop: ./run.sh stop"
@@ -519,6 +560,9 @@ show_status() {
         if is_port_in_use; then
             show_unmanaged_server_message
         fi
+        if [ -n "$svc" ]; then
+            echo "ℹ️  systemd 서비스: $svc (inactive)"
+        fi
         if [ "$LANGUAGE" = "en" ]; then
             echo "Start: ./run.sh start"
         else
@@ -559,13 +603,15 @@ if [ $# -eq 0 ]; then
         echo "모드:"
         echo "  dev   environment=development로 설정하고 database.default는 유지한 채 바이너리 실행"
         echo "  start 설정파일을 수정하지 않고 현재 설정 그대로 백그라운드 실행"
-        echo "  stop  run.sh로 백그라운드 실행한 서버 중지"
-        echo "  status 서버 상태 조회"
+        echo "  stop    run.sh로 백그라운드 실행한 서버 중지"
+        echo "  restart 서버 재시작"
+        echo "  status  서버 상태 조회"
         echo ""
         echo "예제:"
         echo "  $0 dev     # 개발 모드로 시작"
         echo "  $0 start   # 현재 설정 그대로 시작(백그라운드)"
         echo "  $0 stop    # 서버 중지"
+        echo "  $0 restart # 서버 재시작"
         echo "  $0 status  # 상태 조회"
     fi
 
@@ -641,6 +687,12 @@ case "$MODE" in
         ;;
         
     start)
+        # systemd 에서 ExecStart 로 호출된 경우 바이너리를 직접 exec 한다.
+        if [ -n "${INVOCATION_ID:-}" ]; then
+            sync_database_default_for_environment "$LINENO" || exit 1
+            exec "$SERVER_BIN"
+        fi
+
         # systemd 서비스가 등록되어 있으면 systemctl 로 관리한다.
         svc=$(find_systemd_service || true)
         if [ -n "$svc" ]; then
@@ -718,6 +770,19 @@ case "$MODE" in
         stop_server
         ;;
 
+    restart)
+        svc=$(find_systemd_service || true)
+        if [ -n "$svc" ]; then
+            echo "ℹ️  systemd 서비스 재시작: $svc"
+            sudo systemctl restart "$svc"
+            echo "✅ ${SERVER_NAME} 재시작 완료 (systemd)"
+            exit 0
+        fi
+
+        stop_server || exit $?
+        exec "$SCRIPT_DIR/run.sh" start
+        ;;
+
     status)
         show_status
         ;;

package/template/scripts/service-install.sh

@@ -14,10 +14,8 @@ fi
 LANGUAGE=${LANGUAGE:-ko}
 
 SERVICE_NAME="entity-server"
-RUN_USER="${SUDO_USER:-$(stat -c '%U' "$PROJECT_ROOT")}"
-RUN_GROUP="$(id -gn "$RUN_USER" 2>/dev/null || true)"
-START_NOW=true
-INTERACTIVE=false
+RUN_USER="$(id -un)"
+RUN_GROUP="$(id -gn)"
 SERVER_CONFIG="$PROJECT_ROOT/configs/server.json"
 SERVER_BIN="$PROJECT_ROOT/bin/entity-server"
 if [ ! -f "$SERVER_BIN" ] && [ -f "$PROJECT_ROOT/entity-server" ]; then
@@ -25,8 +23,8 @@ if [ ! -f "$SERVER_BIN" ] && [ -f "$PROJECT_ROOT/entity-server" ]; then
 fi
 
 load_namespace() {
-    local namespace=""
-    if [ -f "$SERVER_CONFIG" ]; then
+    local namespace="${SERVER_NAMESPACE:-${NAMESPACE:-}}"
+    if [ -z "$namespace" ] && [ -f "$SERVER_CONFIG" ]; then
         namespace=$(sed -n 's/.*"namespace"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$SERVER_CONFIG" | head -n 1)
     fi
     namespace=$(echo "$namespace" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_-]/-/g')
@@ -38,89 +36,6 @@ load_namespace() {
 
 load_namespace
 
-if [ $# -eq 0 ]; then
-    INTERACTIVE=true
-fi
-
-for arg in "$@"; do
-    case "$arg" in
-        --user=*)
-            RUN_USER="${arg#*=}"
-            ;;
-        --group=*)
-            RUN_GROUP="${arg#*=}"
-            ;;
-        --no-start)
-            START_NOW=false
-            ;;
-        *)
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ Unknown option: $arg"
-                echo "   Service name is fixed: $SERVICE_NAME"
-            else
-                echo "❌ 알 수 없는 옵션: $arg"
-                echo "   서비스명은 자동 고정값입니다: $SERVICE_NAME"
-            fi
-            exit 1
-            ;;
-    esac
-done
-
-if [ "$INTERACTIVE" = true ]; then
-    if [ "$LANGUAGE" = "en" ]; then
-        echo "[interactive] systemd service setup"
-        echo "service name: $SERVICE_NAME"
-    else
-        echo "[interactive] systemd 서비스 설정"
-        echo "서비스명: $SERVICE_NAME"
-    fi
-
-    read -r -p "Run user [$RUN_USER]: " input
-    if [ -n "$input" ]; then
-        RUN_USER="$input"
-    fi
-
-    if [ -z "$RUN_GROUP" ]; then
-        RUN_GROUP="$(id -gn "$RUN_USER" 2>/dev/null || true)"
-    fi
-    read -r -p "Run group [$RUN_GROUP]: " input
-    if [ -n "$input" ]; then
-        RUN_GROUP="$input"
-    fi
-
-    if [ "$LANGUAGE" = "en" ]; then
-        read -r -p "Start service now? [Y/n]: " input
-    else
-        read -r -p "서비스를 즉시 시작할까요? [Y/n]: " input
-    fi
-    input=$(echo "$input" | tr '[:upper:]' '[:lower:]')
-    if [ "$input" = "n" ] || [ "$input" = "no" ]; then
-        START_NOW=false
-    fi
-fi
-
-if [ "$RUN_GROUP" = "" ]; then
-    RUN_GROUP="$(id -gn "$RUN_USER")"
-fi
-
-if ! id -u "$RUN_USER" >/dev/null 2>&1; then
-    if [ "$LANGUAGE" = "en" ]; then
-        echo "❌ User not found: $RUN_USER"
-    else
-        echo "❌ 사용자를 찾을 수 없습니다: $RUN_USER"
-    fi
-    exit 1
-fi
-
-if ! getent group "$RUN_GROUP" >/dev/null 2>&1; then
-    if [ "$LANGUAGE" = "en" ]; then
-        echo "❌ Group not found: $RUN_GROUP"
-    else
-        echo "❌ 그룹을 찾을 수 없습니다: $RUN_GROUP"
-    fi
-    exit 1
-fi
-
 if [ ! -x "$PROJECT_ROOT/scripts/run.sh" ]; then
     chmod +x "$PROJECT_ROOT/scripts/run.sh"
 fi
@@ -140,11 +55,7 @@ UNIT_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
 
 if [ "$EUID" -ne 0 ]; then
     if command -v sudo >/dev/null 2>&1; then
-        SUDO_ARGS=("--user=$RUN_USER" "--group=$RUN_GROUP")
-        if [ "$START_NOW" = false ]; then
-            SUDO_ARGS+=("--no-start")
-        fi
-        exec sudo "$0" "${SUDO_ARGS[@]}"
+        exec sudo "$0"
     fi
     if [ "$LANGUAGE" = "en" ]; then
         echo "❌ This script requires root privileges"
@@ -177,20 +88,18 @@ EOF
 systemctl daemon-reload
 systemctl enable "$SERVICE_NAME"
 
-if [ "$START_NOW" = true ]; then
-    systemctl restart "$SERVICE_NAME"
-fi
-
 if [ "$LANGUAGE" = "en" ]; then
     echo "✅ Service registered: $SERVICE_NAME"
     echo "   Unit: $UNIT_PATH"
-    echo "   Start:  sudo systemctl start $SERVICE_NAME"
-    echo "   Stop:   sudo systemctl stop $SERVICE_NAME"
-    echo "   Status: sudo systemctl status $SERVICE_NAME"
+    echo "   User: $RUN_USER"
+    echo "   Start:  ./run.sh start"
+    echo "   Stop:   ./run.sh stop"
+    echo "   Status: ./run.sh status"
 else
     echo "✅ 서비스 등록 완료: $SERVICE_NAME"
     echo "   Unit: $UNIT_PATH"
-    echo "   시작:  sudo systemctl start $SERVICE_NAME"
-    echo "   중지:  sudo systemctl stop $SERVICE_NAME"
-    echo "   상태:  sudo systemctl status $SERVICE_NAME"
+    echo "   User: $RUN_USER"
+    echo "   시작:  ./run.sh start"
+    echo "   중지:  ./run.sh stop"
+    echo "   상태:  ./run.sh status"
 fi

package/template/scripts/service-remove.sh

@@ -19,8 +19,8 @@ CONFIRMED=false
 SERVER_CONFIG="$PROJECT_ROOT/configs/server.json"
 
 load_namespace() {
-    local namespace=""
-    if [ -f "$SERVER_CONFIG" ]; then
+    local namespace="${SERVER_NAMESPACE:-${NAMESPACE:-}}"
+    if [ -z "$namespace" ] && [ -f "$SERVER_CONFIG" ]; then
         namespace=$(sed -n 's/.*"namespace"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$SERVER_CONFIG" | head -n 1)
     fi
     namespace=$(echo "$namespace" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9_-]/-/g')