create-entity-server 0.0.9

package/template/scripts/sync.ps1

@@ -0,0 +1,145 @@
+# Sync entity index schema
+
+param(
+    [string]$Target = "",
+    [switch]$Apply,
+    [switch]$WithData
+)
+
+$ProjectRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+Set-Location $ProjectRoot
+
+# Load language from .env
+$Language = "ko"
+if (Test-Path ".env") {
+    $EnvLine = Get-Content ".env" | Where-Object { $_ -match '^LANGUAGE=' }
+    if ($EnvLine) { $Language = $EnvLine -replace '^LANGUAGE=', '' }
+}
+
+# Show usage if no arguments
+if (-not $Target) {
+    if ($Language -eq "en") {
+        Write-Host "Sync Entity Index Schema"
+        Write-Host "========================"
+        Write-Host ""
+        Write-Host "Synchronize index table schema with entity configuration."
+        Write-Host ""
+        Write-Host "Usage: .\sync.ps1 <EntityName>|-All [-Apply] [-WithData]"
+        Write-Host ""
+        Write-Host "Arguments:"
+        Write-Host "  EntityName  Name of the entity to sync (required)"
+        Write-Host "  -All        Sync all entities in entities/"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  -Apply     Apply changes to database (default: dry-run)"
+        Write-Host "  -WithData  Sync schema and backfill index rows from existing data"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\sync.ps1 user              # Preview changes for user entity"
+        Write-Host "  .\sync.ps1 user -Apply       # Apply changes for user entity"
+        Write-Host "  .\sync.ps1 user -Apply -WithData  # Apply + backfill"
+        Write-Host "  .\sync.ps1 -All              # Preview for all entities"
+        Write-Host "  .\sync.ps1 -All -Apply       # Apply for all entities"
+        Write-Host "  .\sync.ps1 license -Apply    # Sync license entity schema"
+    } else {
+        Write-Host "엔티티 인덱스 스키마 동기화"
+        Write-Host "======================="
+        Write-Host ""
+        Write-Host "엔티티 설정과 인덱스 테이블 스키마를 동기화합니다."
+        Write-Host ""
+        Write-Host "사용법: .\sync.ps1 <엔티티명>|-All [-Apply] [-WithData]"
+        Write-Host ""
+        Write-Host "인자:"
+        Write-Host "  엔티티명  동기화할 엔티티 이름 (필수)"
+        Write-Host "  -All      entities/ 내 전체 엔티티 동기화"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  -Apply     데이터베이스에 변경사항 적용 (기본값: 미리보기)"
+        Write-Host "  -WithData  스키마 동기화 + 기존 데이터 인덱스 백필"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\sync.ps1 user              # user 엔티티 변경사항 미리보기"
+        Write-Host "  .\sync.ps1 user -Apply       # user 엔티티 변경사항 적용"
+        Write-Host "  .\sync.ps1 user -Apply -WithData  # 적용 + 기존 데이터 백필"
+        Write-Host "  .\sync.ps1 -All              # 전체 엔티티 미리보기"
+        Write-Host "  .\sync.ps1 -All -Apply       # 전체 엔티티 적용"
+        Write-Host "  .\sync.ps1 license -Apply    # license 엔티티 스키마 동기화"
+    }
+    exit 0
+}
+
+# Validate --with-data requires --apply
+if ($WithData -and -not $Apply) {
+    if ($Language -eq "en") {
+        Write-Host "❌ -WithData requires -Apply"
+    } else {
+        Write-Host "❌ -WithData 는 -Apply 와 함께 사용해야 합니다"
+    }
+    exit 1
+}
+
+# Require prebuilt CLI binary
+$CliBin = Join-Path $ProjectRoot "entity-cli.exe"
+if (-not (Test-Path $CliBin)) {
+    if ($Language -eq "en") {
+        Write-Host "❌ entity-cli.exe not found"
+    } else {
+        Write-Host "❌ entity-cli.exe 파일이 없습니다"
+    }
+    exit 1
+}
+
+function Invoke-SyncEntity {
+    param([string]$EntityName)
+    $Args = @("sync-index", "--entity=$EntityName")
+    if ($Apply)    { $Args += "--apply" }
+    if ($WithData) { $Args += "--with-data" }
+    Write-Host "[sync] $EntityName"
+    & $CliBin @Args
+    return $LASTEXITCODE -eq 0
+}
+
+if ($Target -eq "-All" -or $Target -eq "--all") {
+    $EntityFiles = Get-ChildItem -Path (Join-Path $ProjectRoot "entities") -Filter "*.json" -Recurse |
+        Select-Object -ExpandProperty BaseName | Sort-Object -Unique
+
+    if ($EntityFiles.Count -eq 0) {
+        if ($Language -eq "en") {
+            Write-Host "❌ No entity config files found in entities/"
+        } else {
+            Write-Host "❌ entities/ 에 엔티티 설정 파일이 없습니다"
+        }
+        exit 1
+    }
+
+    $TotalCount   = $EntityFiles.Count
+    $SuccessCount = 0
+    $FailedCount  = 0
+
+    foreach ($Entity in $EntityFiles) {
+        if (Invoke-SyncEntity $Entity) {
+            $SuccessCount++
+        } else {
+            $FailedCount++
+        }
+    }
+
+    $ApplyLabel = if ($Apply) { "apply" } else { "dry-run" }
+    $ModeLabel  = if ($WithData) { "with-data" } else { "index-only" }
+    Write-Host ""
+    Write-Host "[summary] target=all mode=$ModeLabel apply=$ApplyLabel total=$TotalCount success=$SuccessCount failed=$FailedCount"
+
+    if ($FailedCount -gt 0) { exit 1 }
+} else {
+    $ok = Invoke-SyncEntity $Target
+    $ApplyLabel = if ($Apply) { "apply" } else { "dry-run" }
+    $ModeLabel  = if ($WithData) { "with-data" } else { "index-only" }
+    if ($ok) {
+        Write-Host ""
+        Write-Host "[summary] target=$Target mode=$ModeLabel apply=$ApplyLabel total=1 success=1 failed=0"
+    } else {
+        Write-Host ""
+        Write-Host "[summary] target=$Target mode=$ModeLabel apply=$ApplyLabel total=1 success=0 failed=1"
+        exit 1
+    }
+}

package/template/scripts/sync.sh

@@ -0,0 +1,178 @@
+#!/bin/bash
+
+# Sync entity index schema
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+# Load language from .env
+if [ -f .env ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+# Show usage if no arguments
+if [ $# -eq 0 ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "Sync Entity Index Schema"
+        echo "========================"
+        echo ""
+        echo "Synchronize index table schema with entity configuration."
+        echo ""
+        echo "Usage: $0 <entity-name>|--all [--dry-run|--apply] [--index-only|--with-data]"
+        echo ""
+        echo "Arguments:"
+        echo "  entity-name  Name of the entity to sync (required)"
+        echo "  --all        Sync all entities in entities/"
+        echo ""
+        echo "Options:"
+        echo "  --dry-run  Preview mode - show what will be changed"
+        echo "  --apply    Apply changes to database"
+        echo "  --index-only  Sync index schema only (default)"
+        echo "  --with-data   Sync schema and backfill index rows from existing data"
+        echo ""
+        echo "Examples:"
+        echo "  $0 user --dry-run    # Preview changes for user entity"
+        echo "  $0 user --apply      # Apply changes for user entity"
+        echo "  $0 user --apply --with-data  # Apply + backfill"
+        echo "  $0 --all --dry-run   # Preview for all entities"
+        echo "  $0 --all --apply     # Apply for all entities"
+        echo "  $0 license --apply   # Sync license entity schema"
+    else
+        echo "엔티티 인덱스 스키마 동기화"
+        echo "======================="
+        echo ""
+        echo "엔티티 설정과 인덱스 테이블 스키마를 동기화합니다."
+        echo ""
+        echo "사용법: $0 <엔티티명>|--all [--dry-run|--apply] [--index-only|--with-data]"
+        echo ""
+        echo "인자:"
+        echo "  엔티티명  동기화할 엔티티 이름 (필수)"
+        echo "  --all     entities/ 내 전체 엔티티 동기화"
+        echo ""
+        echo "옵션:"
+        echo "  --dry-run  미리보기 모드 - 변경사항 확인"
+        echo "  --apply    데이터베이스에 변경사항 적용"
+        echo "  --index-only  인덱스 스키마만 동기화 (기본값)"
+        echo "  --with-data   스키마 동기화 + 기존 데이터 인덱스 백필"
+        echo ""
+        echo "예제:"
+        echo "  $0 user --dry-run    # user 엔티티 변경사항 미리보기"
+        echo "  $0 user --apply      # user 엔티티 변경사항 적용"
+        echo "  $0 user --apply --with-data  # 적용 + 기존 데이터 백필"
+        echo "  $0 --all --dry-run   # 전체 엔티티 미리보기"
+        echo "  $0 --all --apply     # 전체 엔티티 적용"
+        echo "  $0 license --apply   # license 엔티티 스키마 동기화"
+    fi
+    exit 0
+fi
+
+# Require prebuilt CLI binary
+if [ ! -f "$PROJECT_ROOT/bin/entity-cli" ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ bin/entity-cli not found"
+    else
+        echo "❌ bin/entity-cli 파일이 없습니다"
+    fi
+    exit 1
+fi
+
+TARGET="$1"
+APPLY_MODE="--dry-run"
+SYNC_MODE="--index-only"
+
+for arg in "${@:2}"; do
+    case "$arg" in
+        --dry-run|--apply)
+            APPLY_MODE="$arg"
+            ;;
+        --index-only|--with-data)
+            SYNC_MODE="$arg"
+            ;;
+        *)
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "❌ Unknown option: $arg"
+                echo "Run '$0' for usage information"
+            else
+                echo "❌ 알 수 없는 옵션: $arg"
+                echo "'$0'로 사용법을 확인하세요"
+            fi
+            exit 1
+            ;;
+    esac
+done
+
+if [ "$SYNC_MODE" = "--with-data" ] && [ "$APPLY_MODE" != "--apply" ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ --with-data requires --apply"
+    else
+        echo "❌ --with-data 는 --apply 와 함께 사용해야 합니다"
+    fi
+    exit 1
+fi
+
+build_cmd() {
+    local entity_name="$1"
+    local cmd=("$PROJECT_ROOT/bin/entity-cli" sync-index --entity="$entity_name")
+    if [ "$APPLY_MODE" = "--apply" ]; then
+        cmd+=(--apply)
+    fi
+    if [ "$SYNC_MODE" = "--with-data" ]; then
+        cmd+=(--with-data)
+    fi
+    echo "${cmd[@]}"
+}
+
+run_for_entity() {
+    local entity_name="$1"
+    local cmd
+    cmd=$(build_cmd "$entity_name")
+    echo "[sync] $entity_name"
+    if eval "$cmd"; then
+        return 0
+    fi
+    return 1
+}
+
+if [ "$TARGET" = "--all" ]; then
+    mapfile -t ENTITIES < <(find "$PROJECT_ROOT/entities" -type f -name '*.json' -printf '%f\n' | sed 's/\.json$//' | sort -u)
+
+    if [ ${#ENTITIES[@]} -eq 0 ]; then
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "❌ No entity config files found in entities/"
+        else
+            echo "❌ entities/ 에 엔티티 설정 파일이 없습니다"
+        fi
+        exit 1
+    fi
+
+    total_count=${#ENTITIES[@]}
+    success_count=0
+    failed_count=0
+
+    for entity in "${ENTITIES[@]}"; do
+        if run_for_entity "$entity"; then
+            success_count=$((success_count + 1))
+        else
+            failed_count=$((failed_count + 1))
+        fi
+    done
+
+    echo ""
+    echo "[summary] target=all mode=${SYNC_MODE#--} apply=${APPLY_MODE#--} total=${total_count} success=${success_count} failed=${failed_count}"
+
+    if [ "$failed_count" -gt 0 ]; then
+        exit 1
+    fi
+else
+    if run_for_entity "$TARGET"; then
+        echo ""
+        echo "[summary] target=${TARGET} mode=${SYNC_MODE#--} apply=${APPLY_MODE#--} total=1 success=1 failed=0"
+    else
+        echo ""
+        echo "[summary] target=${TARGET} mode=${SYNC_MODE#--} apply=${APPLY_MODE#--} total=1 success=0 failed=1"
+        exit 1
+    fi
+fi

package/template/scripts/update-server.ps1

@@ -0,0 +1,117 @@
+# 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       # 특정 버전으로 업데이트
+
+param([string]$Action = "")
+
+$ErrorActionPreference = "Stop"
+
+$REPO        = "ehfuse/entity-server"
+$BINARIES    = @("entity-server", "entity-cli")
+$PLATFORM    = "windows"
+$ARCH_TAG    = "x64"
+$ProjectRoot = Split-Path -Parent $PSScriptRoot
+
+# ── 현재 버전 확인 ────────────────────────────────────────────────────────────
+
+function Get-CurrentVer {
+    $BinPath = Join-Path $ProjectRoot "entity-server.exe"
+    if (Test-Path $BinPath) {
+        try {
+            $out = & $BinPath --version 2>$null
+            if ($out -match '(\d+\.\d+\.\d+)') { return $Matches[1] }
+        } catch {}
+    }
+    return "(없음)"
+}
+
+# ── 최신 버전 조회 ────────────────────────────────────────────────────────────
+
+function Get-LatestVer {
+    try {
+        $resp = Invoke-RestMethod "https://api.github.com/repos/$REPO/releases/latest"
+        return $resp.tag_name -replace '^v', ''
+    } catch {
+        Write-Error "❌ 최신 버전을 가져오지 못했습니다: $_"
+        exit 1
+    }
+}
+
+# ── 설치 ──────────────────────────────────────────────────────────────────────
+
+function Install-Version([string]$TargetVer) {
+    $TargetVer = $TargetVer -replace '^v', ''
+    $CurrentVer = Get-CurrentVer
+
+    Write-Host ""
+    Write-Host "📦 entity-server v$TargetVer 다운로드 중... ($PLATFORM-$ARCH_TAG)"
+    Write-Host ""
+
+    foreach ($Bin in $BINARIES) {
+        $FileName = "$Bin-$PLATFORM-$ARCH_TAG.exe"
+        $Url      = "https://github.com/$REPO/releases/download/v$TargetVer/$FileName"
+        $Dest     = Join-Path $ProjectRoot "$Bin.exe"
+        $Tmp      = "$Dest.tmp"
+
+        Write-Host ("  ↓ {0,-35}" -f $FileName) -NoNewline
+        try {
+            Invoke-WebRequest -Uri $Url -OutFile $Tmp -UseBasicParsing
+            Move-Item -Force $Tmp $Dest
+            Write-Host "✓"
+        } catch {
+            Write-Host "✗ 실패"
+            Write-Host "    URL: $Url"
+            Write-Host "    오류: $_"
+            if (Test-Path $Tmp) { Remove-Item $Tmp -Force }
+            exit 1
+        }
+    }
+
+    Write-Host ""
+    Write-Host "✅ 업데이트 완료: v$CurrentVer → v$TargetVer"
+    Write-Host "   서버를 재시작하면 새 버전이 적용됩니다."
+}
+
+# ── 서브커맨드 분기 ───────────────────────────────────────────────────────────
+
+switch ($Action) {
+    "" {
+        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 "  .\scripts\update-server.ps1 version"
+        Write-Host "  .\scripts\update-server.ps1 latest"
+        Write-Host "  .\scripts\update-server.ps1 1.5.0"
+    }
+    "version" {
+        Write-Host "🔍 버전 확인 중..."
+        $Current = Get-CurrentVer
+        $Latest  = Get-LatestVer
+        Write-Host ""
+        Write-Host "  현재 버전: v$Current"
+        Write-Host "  최신 버전: v$Latest"
+        Write-Host ""
+        if ($Current -eq $Latest) {
+            Write-Host "✅ 최신 버전입니다."
+        } else {
+            Write-Host "💡 업데이트 가능: .\scripts\update-server.ps1 latest"
+        }
+    }
+    "latest" {
+        Write-Host "🔍 최신 버전 확인 중..."
+        $Latest = Get-LatestVer
+        Install-Version $Latest
+    }
+    default {
+        Install-Version $Action
+    }
+}

package/template/scripts/update-server.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+# 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       # 특정 버전으로 업데이트
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+REPO="ehfuse/entity-server"
+BINARIES=("entity-server" "entity-cli")
+
+# ── 플랫폼 감지 ───────────────────────────────────────────────────────────────
+
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+
+case "$OS" in
+    Linux)  PLATFORM="linux" ;;
+    Darwin) PLATFORM="darwin" ;;
+    *)
+        echo "❌ 지원하지 않는 OS: $OS"
+        echo "   Windows 는 scripts\\update-server.ps1 을 사용하세요."
+        exit 1
+        ;;
+esac
+
+case "$ARCH" in
+    x86_64)        ARCH_TAG="x64" ;;
+    aarch64|arm64) ARCH_TAG="arm64" ;;
+    *)
+        echo "❌ 지원하지 않는 아키텍처: $ARCH"
+        exit 1
+        ;;
+esac
+
+# ── 현재 버전 확인 ────────────────────────────────────────────────────────────
+
+_current_ver() {
+    local bin="$PROJECT_ROOT/entity-server"
+    if [ -x "$bin" ]; then
+        "$bin" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "(알 수 없음)"
+    else
+        echo "(없음)"
+    fi
+}
+
+# ── 최신 버전 조회 ────────────────────────────────────────────────────────────
+
+_latest_ver() {
+    local ver
+    if command -v curl >/dev/null 2>&1; then
+        ver="$(curl -fsSL "https://api.github.com/repos/${REPO}/releases/latest" \
+            | grep '"tag_name"' | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)"
+    elif command -v wget >/dev/null 2>&1; then
+        ver="$(wget -qO- "https://api.github.com/repos/${REPO}/releases/latest" \
+            | grep '"tag_name"' | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)"
+    else
+        echo "❌ curl 또는 wget 이 필요합니다." >&2
+        exit 1
+    fi
+    if [ -z "$ver" ]; then
+        echo "❌ 최신 버전을 가져오지 못했습니다. 네트워크 연결을 확인하세요." >&2
+        exit 1
+    fi
+    echo "$ver"
+}
+
+# ── 다운로드 ──────────────────────────────────────────────────────────────────
+
+_download() {
+    local url="$1"
+    local dest="$2"
+    local tmp="${dest}.tmp"
+
+    if command -v curl >/dev/null 2>&1; then
+        curl -fsSL --retry 3 -o "$tmp" "$url"
+    elif command -v wget >/dev/null 2>&1; then
+        wget -q -O "$tmp" "$url"
+    else
+        echo "❌ curl 또는 wget 이 필요합니다."
+        exit 1
+    fi
+
+    mv "$tmp" "$dest"
+    chmod +x "$dest"
+}
+
+_install() {
+    local target_ver="${1#v}"   # v 접두사 제거
+    local current_ver
+    current_ver="$(_current_ver)"
+
+    echo ""
+    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}"
+        local dest="$PROJECT_ROOT/$BIN"
+
+        printf "  ↓ %-32s" "$file"
+        if _download "$url" "$dest" 2>/dev/null; then
+            echo "✓"
+        else
+            echo "✗ 실패"
+            echo "    URL: $url"
+            exit 1
+        fi
+    done
+
+    echo ""
+    echo "✅ 업데이트 완료: v${current_ver} → v${target_ver}"
+    echo "   서버를 재시작하면 새 버전이 적용됩니다."
+}
+
+# ── 서브커맨드 분기 ───────────────────────────────────────────────────────────
+
+ARG="${1:-}"
+
+case "$ARG" in
+    "")
+        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 "  ./scripts/update-server.sh version"
+        echo "  ./scripts/update-server.sh latest"
+        echo "  ./scripts/update-server.sh 1.5.0"
+        ;;
+
+    "version")
+        echo "🔍 버전 확인 중..."
+        CURRENT="$(_current_ver)"
+        LATEST="$(_latest_ver)"
+        echo ""
+        echo "  현재 버전: v${CURRENT}"
+        echo "  최신 버전: v${LATEST}"
+        echo ""
+        if [ "$CURRENT" = "$LATEST" ]; then
+            echo "✅ 최신 버전입니다."
+        else
+            echo "💡 업데이트 가능: ./scripts/update-server.sh latest"
+        fi
+        ;;
+
+    "latest")
+        echo "🔍 최신 버전 확인 중..."
+        LATEST="$(_latest_ver)"
+        _install "$LATEST"
+        ;;
+
+    *)
+        _install "$ARG"
+        ;;
+esac