create-entity-server 0.0.9 → 0.0.15

package/template/samples/swift/EntityServerClient.swift

@@ -126,6 +126,111 @@ public final class EntityServerClient {
         try await request(method: "POST", path: "/v1/entity/\(entity)/rollback/\(historySeq)")
     }
 
+    /// 푸시 발송 트리거 엔티티에 submit합니다.
+    public func push(pushEntity: String, payload: [String: Any], transactionId: String? = nil) async throws -> [String: Any] {
+        try await submit(entity: pushEntity, data: payload, transactionId: transactionId)
+    }
+
+    /// push_log 목록 조회 헬퍼
+    public func pushLogList(page: Int = 1, limit: Int = 20) async throws -> [String: Any] {
+        try await list(entity: "push_log", page: page, limit: limit)
+    }
+
+    /// account_device 디바이스 등록/갱신 헬퍼 (push_token 단일 필드)
+    public func registerPushDevice(
+        accountSeq: Int64,
+        deviceId: String,
+        pushToken: String,
+        platform: String? = nil,
+        deviceType: String? = nil,
+        browser: String? = nil,
+        browserVersion: String? = nil,
+        pushEnabled: Bool = true,
+        transactionId: String? = nil
+    ) async throws -> [String: Any] {
+        var payload: [String: Any] = [
+            "id": deviceId,
+            "account_seq": accountSeq,
+            "push_token": pushToken,
+            "push_enabled": pushEnabled,
+        ]
+        if let platform { payload["platform"] = platform }
+        if let deviceType { payload["device_type"] = deviceType }
+        if let browser { payload["browser"] = browser }
+        if let browserVersion { payload["browser_version"] = browserVersion }
+        return try await submit(entity: "account_device", data: payload, transactionId: transactionId)
+    }
+
+    /// account_device.seq 기준 push_token 갱신 헬퍼
+    public func updatePushDeviceToken(
+        deviceSeq: Int64,
+        pushToken: String,
+        pushEnabled: Bool = true,
+        transactionId: String? = nil
+    ) async throws -> [String: Any] {
+        try await submit(
+            entity: "account_device",
+            data: [
+                "seq": deviceSeq,
+                "push_token": pushToken,
+                "push_enabled": pushEnabled,
+            ],
+            transactionId: transactionId
+        )
+    }
+
+    /// account_device.seq 기준 푸시 수신 비활성화 헬퍼
+    public func disablePushDevice(
+        deviceSeq: Int64,
+        transactionId: String? = nil
+    ) async throws -> [String: Any] {
+        try await submit(
+            entity: "account_device",
+            data: [
+                "seq": deviceSeq,
+                "push_enabled": false,
+            ],
+            transactionId: transactionId
+        )
+    }
+
+    /// 요청 본문을 읽어 JSON으로 반환합니다.
+    /// - application/octet-stream: 암호 패킷 복호화
+    /// - 그 외: 평문 JSON 파싱
+    public func readRequestBody(
+        _ rawBody: Data,
+        contentType: String = "application/json",
+        requireEncrypted: Bool = false
+    ) throws -> [String: Any] {
+        let lowered = contentType.lowercased()
+        let isEncrypted = lowered.contains("application/octet-stream")
+
+        if requireEncrypted && !isEncrypted {
+            throw NSError(
+                domain: "EntityServerClient",
+                code: -1,
+                userInfo: [NSLocalizedDescriptionKey: "Encrypted request required: Content-Type must be application/octet-stream"]
+            )
+        }
+
+        if isEncrypted {
+            if rawBody.isEmpty {
+                throw NSError(
+                    domain: "EntityServerClient",
+                    code: -1,
+                    userInfo: [NSLocalizedDescriptionKey: "Encrypted request body is empty"]
+                )
+            }
+            return try decryptPacket(rawBody)
+        }
+
+        if rawBody.isEmpty { return [:] }
+        guard let json = try JSONSerialization.jsonObject(with: rawBody) as? [String: Any] else {
+            throw EntityServerError.invalidResponse
+        }
+        return json
+    }
+
     // ─── 내부 ─────────────────────────────────────────────────────────
 
     private func request(method: String, path: String, body: Data? = nil, extraHeaders: [String: String] = [:]) async throws -> [String: Any] {

package/template/scripts/normalize-entities.sh

@@ -20,7 +20,7 @@ if [ $# -eq 0 ]; then
         echo "====================="
         echo ""
         echo "Remove redundant default values and reorder keys in entity JSON files."
-        echo "Also auto-creates missing required entities (api_keys, rbac_roles, and account/user when JWT is enabled)."
+        echo "Also auto-creates missing required entities (api_keys, rbac_roles, and account/account_login_log when JWT is enabled)."
         echo ""
         echo "Usage: $0 [options]"
         echo ""
@@ -41,10 +41,10 @@ if [ $# -eq 0 ]; then
         echo "  - Reorder top-level keys to canonical order"
         echo ""
         echo "Required entities (auto-created if missing, full mode only):"
-        echo "  - api_keys    → entities/Auth/api_keys.json"
-        echo "  - rbac_roles  → entities/Auth/rbac_roles.json"
-        echo "  - account     → entities/Auth/account.json (JWT enabled only)"
-        echo "  - user        → entities/User/user.json (JWT enabled only)"
+        echo "  - api_keys    → entities/System/Auth/api_keys.json"
+        echo "  - rbac_roles  → entities/System/Auth/rbac_roles.json"
+        echo "  - account     → entities/System/Auth/account.json (JWT enabled only)"
+        echo "  - account_login_log → entities/System/Auth/account_login_log.json (JWT enabled only)"
         echo ""
         echo "Examples:"
         echo "  $0                        # Dry-run all entities"
@@ -56,7 +56,7 @@ if [ $# -eq 0 ]; then
         echo "=================="
         echo ""
         echo "엔티티 JSON 파일에서 불필요한 기본값을 제거하고 키 순서를 정렬합니다."
-        echo "전체 모드에서는 필수 엔티티(api_keys, rbac_roles, JWT 사용 시 account/user)가 없으면 자동 생성합니다."
+        echo "전체 모드에서는 필수 엔티티(api_keys, rbac_roles, JWT 사용 시 account/account_login_log)가 없으면 자동 생성합니다."
         echo ""
         echo "사용법: $0 [옵션]"
         echo ""
@@ -77,10 +77,10 @@ if [ $# -eq 0 ]; then
         echo "  - 최상위 키 순서 정규화"
         echo ""
         echo "필수 엔티티 자동 생성 (전체 모드, 없을 경우):"
-        echo "  - api_keys   → entities/Auth/api_keys.json"
-        echo "  - rbac_roles → entities/Auth/rbac_roles.json"
-        echo "  - account    → entities/Auth/account.json (JWT 활성 시)"
-        echo "  - user       → entities/User/user.json (JWT 활성 시)"
+        echo "  - api_keys   → entities/System/Auth/api_keys.json"
+        echo "  - rbac_roles → entities/System/Auth/rbac_roles.json"
+        echo "  - account    → entities/System/Auth/account.json (JWT 활성 시)"
+        echo "  - account_login_log → entities/System/Auth/account_login_log.json (JWT 활성 시)"
         echo ""
         echo "예제:"
         echo "  $0                        # 전체 엔티티 dry-run 미리보기"

package/template/scripts/run.sh

@@ -25,6 +25,22 @@ get_server_value() {
     local fallback="$2"
     local value
 
+    if [ "$key" = "port" ]; then
+        local env_port
+        env_port="${SERVER_PORT:-${PORT:-}}"
+        if [ -z "$env_port" ] && [ -f .env ]; then
+            env_port=$(grep '^SERVER_PORT=' .env | tail -n 1 | cut -d '=' -f2-)
+            if [ -z "$env_port" ]; then
+                env_port=$(grep '^PORT=' .env | tail -n 1 | cut -d '=' -f2-)
+            fi
+        fi
+        env_port=$(echo "$env_port" | tr -d '[:space:]')
+        if [[ "$env_port" =~ ^[0-9]+$ ]] && [ "$env_port" -gt 0 ]; then
+            echo "$env_port"
+            return
+        fi
+    fi
+
     value=$(grep -E "\"$key\"[[:space:]]*:" "$SERVER_CONFIG" | head -n 1 | sed -E 's/.*:[[:space:]]*"?([^",}]+)"?.*/\1/')
     value=$(echo "$value" | tr -d '[:space:]')
     if [ -z "$value" ]; then
@@ -35,60 +51,61 @@ get_server_value() {
 }
 
 is_running() {
+    local port_pid
+    port_pid=$(find_pid_by_port)
+
     if [ ! -f "$PID_FILE" ]; then
+        if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
+            return 0
+        fi
         return 1
     fi
     local pid
     pid=$(cat "$PID_FILE" 2>/dev/null)
     if [ -z "$pid" ]; then
+        if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
+            return 0
+        fi
         return 1
     fi
-    kill -0 "$pid" 2>/dev/null
-}
-
-stop_server() {
-    if [ ! -f "$PID_FILE" ]; then
-        if [ "$LANGUAGE" = "en" ]; then
-            echo "ℹ️  Server is not running (pid file not found)."
-        else
-            echo "ℹ️  서버가 실행 중이 아닙니다 (pid 파일 없음)."
-        fi
+    if kill -0 "$pid" 2>/dev/null; then
         return 0
     fi
 
-    local pid
-    pid=$(cat "$PID_FILE" 2>/dev/null)
-    if [ -z "$pid" ]; then
-        rm -f "$PID_FILE"
-        if [ "$LANGUAGE" = "en" ]; then
-            echo "ℹ️  Empty pid file removed."
-        else
-            echo "ℹ️  비어있는 pid 파일을 정리했습니다."
-        fi
+    if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
         return 0
     fi
 
+    return 1
+}
+
+find_pid_by_port() {
+    local port
+    port=$(get_server_value "port" "3400")
+    ss -ltnp 2>/dev/null | grep ":$port " | sed -n 's/.*pid=\([0-9]\+\).*/\1/p' | head -n 1
+}
+
+stop_pid_with_confirm() {
+    local pid="$1"
+    local reason="$2"
+
+    if [ -z "$pid" ]; then
+        return 1
+    fi
     if ! kill -0 "$pid" 2>/dev/null; then
-        rm -f "$PID_FILE"
-        if [ "$LANGUAGE" = "en" ]; then
-            echo "ℹ️  Stale pid file removed (process not found)."
-        else
-            echo "ℹ️  실행 중인 프로세스가 없어 stale pid 파일을 정리했습니다."
-        fi
-        return 0
+        return 1
     fi
 
-    # 실행 중인 프로세스 정보 표시 후 확인
     local proc_info
     proc_info=$(ps -p "$pid" -o pid,user,etime,args --no-headers 2>/dev/null | head -1)
     if [ "$LANGUAGE" = "en" ]; then
-        echo "Running process:"
+        echo "Running process ($reason):"
         echo "  PID   USER     ELAPSED  COMMAND"
         echo "  $proc_info"
         echo ""
         read -r -p "Stop this process? [y/N]: " input
     else
-        echo "실행 중인 프로세스:"
+        echo "실행 중인 프로세스($reason):"
         echo "  PID   USER     실행시간  COMMAND"
         echo "  $proc_info"
         echo ""
@@ -128,12 +145,74 @@ stop_server() {
     return 0
 }
 
+stop_server() {
+    if [ ! -f "$PID_FILE" ]; then
+        local port_pid
+        port_pid=$(find_pid_by_port)
+        if [ -n "$port_pid" ]; then
+            stop_pid_with_confirm "$port_pid" "port fallback"
+            return $?
+        fi
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "ℹ️  Server is not running (pid file not found)."
+        else
+            echo "ℹ️  서버가 실행 중이 아닙니다 (pid 파일 없음)."
+        fi
+        return 0
+    fi
+
+    local pid
+    pid=$(cat "$PID_FILE" 2>/dev/null)
+    if [ -z "$pid" ]; then
+        rm -f "$PID_FILE"
+        local port_pid
+        port_pid=$(find_pid_by_port)
+        if [ -n "$port_pid" ]; then
+            stop_pid_with_confirm "$port_pid" "port fallback"
+            return $?
+        fi
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "ℹ️  Empty pid file removed."
+        else
+            echo "ℹ️  비어있는 pid 파일을 정리했습니다."
+        fi
+        return 0
+    fi
+
+    if ! kill -0 "$pid" 2>/dev/null; then
+        rm -f "$PID_FILE"
+        local port_pid
+        port_pid=$(find_pid_by_port)
+        if [ -n "$port_pid" ]; then
+            stop_pid_with_confirm "$port_pid" "port fallback"
+            return $?
+        fi
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "ℹ️  Stale pid file removed (process not found)."
+        else
+            echo "ℹ️  실행 중인 프로세스가 없어 stale pid 파일을 정리했습니다."
+        fi
+        return 0
+    fi
+
+    stop_pid_with_confirm "$pid" "pid file"
+    return $?
+}
+
 show_status() {
     if is_running; then
+		local status_pid
+		status_pid=$(find_pid_by_port)
         ./bin/entity-server banner-status RUNNING
         if [ "$LANGUAGE" = "en" ]; then
+			if [ -n "$status_pid" ]; then
+				echo "PID: $status_pid (detected by port)"
+			fi
             echo "Stop: ./run.sh stop"
         else
+			if [ -n "$status_pid" ]; then
+				echo "PID: $status_pid (포트 기준 감지)"
+			fi
             echo "중지: ./run.sh stop"
         fi
     else

package/template/scripts/update-server.ps1

@@ -1,10 +1,14 @@
-# update-server.ps1 — entity-server / entity-cli 바이너리 업데이트
+# update-server.ps1 — entity-server / entity-cli 바이너리 및 파일 업데이트
 #
 # 사용법:
 #   .\scripts\update-server.ps1             # 도움말
 #   .\scripts\update-server.ps1 version     # 현재 버전 + 최신 버전 확인
 #   .\scripts\update-server.ps1 latest      # 최신 버전으로 업데이트
 #   .\scripts\update-server.ps1 1.5.0       # 특정 버전으로 업데이트
+#
+# 업데이트 대상:
+#   - 바이너리: entity-server, entity-cli
+#   - 파일: scripts/  samples/  (configs/ entities/ docs/ 제외)
 
 param([string]$Action = "")
 
@@ -12,6 +16,7 @@ $ErrorActionPreference = "Stop"
 
 $REPO        = "ehfuse/entity-server"
 $BINARIES    = @("entity-server", "entity-cli")
+$DIST_DIRS   = @("scripts", "samples")
 $PLATFORM    = "windows"
 $ARCH_TAG    = "x64"
 $ProjectRoot = Split-Path -Parent $PSScriptRoot
@@ -71,22 +76,107 @@ function Install-Version([string]$TargetVer) {
         }
     }
 
+    Install-Dist $TargetVer
+
     Write-Host ""
     Write-Host "✅ 업데이트 완료: v$CurrentVer → v$TargetVer"
     Write-Host "   서버를 재시작하면 새 버전이 적용됩니다."
 }
 
+# ── dist 파일 업데이트 (scripts / samples) ──────────────────────────────────
+
+function Install-Dist([string]$TargetVer) {
+    $TargetVer = $TargetVer -replace '^v', ''
+    $FileName = "dist.tar.gz"
+    $Url = "https://github.com/$REPO/releases/download/v$TargetVer/$FileName"
+    $TmpTar = Join-Path $env:TEMP ("entity-server-dist-$TargetVer.tar.gz")
+    $TmpDir = Join-Path $env:TEMP ("entity-server-dist-$TargetVer")
+
+    Write-Host ("  ↓ {0,-35}" -f $FileName) -NoNewline
+    try {
+        Invoke-WebRequest -Uri $Url -OutFile $TmpTar -UseBasicParsing
+        Write-Host "✓"
+    } catch {
+        Write-Host "✗ 실패 (업데이트 스킵)"
+        Write-Host "    URL: $Url"
+        Write-Host "    ⚠️  dist.tar.gz 가 릴리스에 없습니다. 바이너리만 업데이트됩니다."
+        return
+    }
+
+    if (Test-Path $TmpDir) {
+        Remove-Item -Recurse -Force $TmpDir
+    }
+    New-Item -ItemType Directory -Path $TmpDir | Out-Null
+
+    # tar.exe 사용 (Windows 10+/PowerShell 5+ 기본 포함 환경 가정)
+    $TarCmd = Get-Command tar -ErrorAction SilentlyContinue
+    if (-not $TarCmd) {
+        Write-Host "    ⚠️  tar 명령을 찾지 못해 dist 동기화를 건너뜁니다."
+        if (Test-Path $TmpTar) { Remove-Item -Force $TmpTar }
+        return
+    }
+
+    try {
+        & tar -xzf $TmpTar -C $TmpDir
+    } catch {
+        Write-Host "    ⚠️  dist 압축 해제 실패: $_"
+        if (Test-Path $TmpTar) { Remove-Item -Force $TmpTar }
+        if (Test-Path $TmpDir) { Remove-Item -Recurse -Force $TmpDir }
+        return
+    }
+
+    $SrcRoot = $TmpDir
+    $HasTopLevel = $false
+    foreach ($Dir in $DIST_DIRS) {
+        if (Test-Path (Join-Path $TmpDir $Dir)) {
+            $HasTopLevel = $true
+            break
+        }
+    }
+
+    if (-not $HasTopLevel) {
+        $FirstSubdir = Get-ChildItem -Path $TmpDir -Directory | Select-Object -First 1
+        if ($FirstSubdir) {
+            $SrcRoot = $FirstSubdir.FullName
+        }
+    }
+
+    Write-Host ""
+    Write-Host "  파일 동기화 (configs/ entities/ docs/ 제외):"
+    foreach ($Dir in $DIST_DIRS) {
+        $Src = Join-Path $SrcRoot $Dir
+        $Dest = Join-Path $ProjectRoot $Dir
+        if (Test-Path $Src) {
+            if (Test-Path $Dest) {
+                Remove-Item -Recurse -Force $Dest
+            }
+            Copy-Item -Recurse -Force $Src $Dest
+            Write-Host ("    ✔ {0,-20}" -f ("$Dir/"))
+        } else {
+            Write-Host ("    – {0,-20} (릴리스에 없음, 스킵)" -f ("$Dir/"))
+        }
+    }
+
+    if (Test-Path $TmpTar) { Remove-Item -Force $TmpTar }
+    if (Test-Path $TmpDir) { Remove-Item -Recurse -Force $TmpDir }
+}
+
 # ── 서브커맨드 분기 ───────────────────────────────────────────────────────────
 
 switch ($Action) {
     "" {
-        Write-Host "update-server.ps1 — entity-server / entity-cli 바이너리 업데이트"
+        Write-Host "update-server.ps1 — entity-server / entity-cli 바이너리 및 파일 업데이트"
         Write-Host ""
         Write-Host "사용법:"
         Write-Host "  .\scripts\update-server.ps1 version        현재 버전 + 최신 버전 확인"
         Write-Host "  .\scripts\update-server.ps1 latest         최신 버전으로 업데이트"
         Write-Host "  .\scripts\update-server.ps1 <버전>         특정 버전으로 업데이트"
         Write-Host ""
+        Write-Host "업데이트 대상:"
+        Write-Host "  바이너리   entity-server  entity-cli"
+        Write-Host "  파일    scripts/  samples/"
+        Write-Host "  제외     configs/  entities/  docs/  (local 설정 보존)"
+        Write-Host ""
         Write-Host "예시:"
         Write-Host "  .\scripts\update-server.ps1 version"
         Write-Host "  .\scripts\update-server.ps1 latest"

package/template/scripts/update-server.sh

@@ -1,11 +1,15 @@
 #!/bin/bash
-# update-server.sh — entity-server / entity-cli 바이너리 업데이트
+# update-server.sh — entity-server / entity-cli 바이너리 및 파일 업데이트
 #
 # 사용법:
 #   ./scripts/update-server.sh             # 도움말
 #   ./scripts/update-server.sh version     # 현재 버전 + 최신 버전 확인
 #   ./scripts/update-server.sh latest      # 최신 버전으로 업데이트
 #   ./scripts/update-server.sh 1.5.0       # 특정 버전으로 업데이트
+#
+# 업데이트 대상:
+#   - 바이너리: entity-server, entity-cli
+#   - 파일: scripts/  samples/  (configs/ entities/ docs/ 제외)
 
 set -e
 
@@ -13,6 +17,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 REPO="ehfuse/entity-server"
 BINARIES=("entity-server" "entity-cli")
+DIST_DIRS=("scripts" "samples")
 
 # ── 플랫폼 감지 ───────────────────────────────────────────────────────────────
 
@@ -99,6 +104,7 @@ _install() {
     echo "📦 entity-server v${target_ver} 다운로드 중... (${PLATFORM}-${ARCH_TAG})"
     echo ""
 
+    # 바이너리 다운로드
     for BIN in "${BINARIES[@]}"; do
         local file="${BIN}-${PLATFORM}-${ARCH_TAG}"
         local url="https://github.com/${REPO}/releases/download/v${target_ver}/${file}"
@@ -114,24 +120,89 @@ _install() {
         fi
     done
 
+    # scripts / samples 업데이트
+    _install_dist "$target_ver"
+
     echo ""
     echo "✅ 업데이트 완료: v${current_ver} → v${target_ver}"
     echo "   서버를 재시작하면 새 버전이 적용됩니다."
 }
 
+# ── dist 파일 업데이트 (scripts / samples) ──────────────────────────────────────
+
+_install_dist() {
+    local target_ver="$1"
+    local file="dist.tar.gz"
+    local url="https://github.com/${REPO}/releases/download/v${target_ver}/${file}"
+    local tmp_tar="/tmp/entity-server-dist-${target_ver}.tar.gz"
+    local tmp_dir="/tmp/entity-server-dist-${target_ver}"
+
+    printf "  ↓ %-32s" "$file"
+    if ! _download "$url" "$tmp_tar" 2>/dev/null; then
+        echo "✗ 실패 (업데이트 스킵)"
+        echo "    URL: $url"
+        echo "    ⚠️  dist.tar.gz 가 릴리스에 없익니다. 바이너리만 업데이트됨."
+        return 0
+    fi
+    echo "✓"
+
+    rm -rf "$tmp_dir"
+    mkdir -p "$tmp_dir"
+    tar -xzf "$tmp_tar" -C "$tmp_dir" 2>/dev/null
+
+    # 아카이브 내부 디렉토리 구조 자동 탐지 (top-level 또는 서브디렉토리)
+    local src_root="$tmp_dir"
+    local found_dir="false"
+    for dir in "${DIST_DIRS[@]}"; do
+        if [ -d "${tmp_dir}/${dir}" ]; then
+            found_dir="true"
+            break
+        fi
+    done
+    if [ "$found_dir" = "false" ]; then
+        # tar가 서브디렉토리 하나로 풌주는 경우 (예: entity-server-1.5.0/)
+        local subdir
+        subdir="$(ls -1 "$tmp_dir" | head -1)"
+        if [ -n "$subdir" ] && [ -d "${tmp_dir}/${subdir}" ]; then
+            src_root="${tmp_dir}/${subdir}"
+        fi
+    fi
+
+    echo ""
+    echo "  파일 동기화 (configs/ entities/ 제외):"
+    for DIR in "${DIST_DIRS[@]}"; do
+        local src="${src_root}/${DIR}"
+        local dest="${PROJECT_ROOT}/${DIR}"
+        if [ -d "$src" ]; then
+            rm -rf "$dest"
+            cp -r "$src" "$dest"
+            printf "    ✔ %-20s\n" "${DIR}/"
+        else
+            printf "    – %-20s (릴리스에 없음, 스킵)\n" "${DIR}/"
+        fi
+    done
+
+    rm -rf "$tmp_dir" "$tmp_tar"
+}
+
 # ── 서브커맨드 분기 ───────────────────────────────────────────────────────────
 
 ARG="${1:-}"
 
 case "$ARG" in
     "")
-        echo "update-server.sh — entity-server / entity-cli 바이너리 업데이트"
+        echo "update-server.sh — entity-server / entity-cli 바이너리 및 파일 업데이트"
         echo ""
         echo "사용법:"
         echo "  ./scripts/update-server.sh version        현재 버전 + 최신 버전 확인"
         echo "  ./scripts/update-server.sh latest         최신 버전으로 업데이트"
         echo "  ./scripts/update-server.sh <버전>         특정 버전으로 업데이트"
         echo ""
+        echo "업데이트 대상:"
+        echo "  바이너리   entity-server  entity-cli"
+        echo "  파일    scripts/  samples/"
+        echo "  제외     configs/  entities/  docs/  (local 설정 보존)"
+        echo ""
         echo "예시:"
         echo "  ./scripts/update-server.sh version"
         echo "  ./scripts/update-server.sh latest"