create-entity-server 0.0.9

package/template/scripts/rbac-role.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+# RBAC 역할 관리 스크립트 (CLI 바이너리 직접 호출)
+# 서버가 중단된 상태에서도 사용 가능합니다.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+BIN_PATH="$PROJECT_ROOT/bin/entity-cli"
+
+cd "$PROJECT_ROOT"
+
+# Load language from .env
+if [ -f .env ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+show_help() {
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "RBAC Role Management (CLI mode)"
+        echo "================================"
+        echo ""
+        echo "Manage rbac_roles entity directly via CLI binary."
+        echo "Server does NOT need to be running."
+        echo ""
+        echo "Usage: $0 <subcommand> [options]"
+        echo ""
+        echo "Subcommands:"
+        echo "  list              List RBAC roles"
+        echo "  add               Create a new role"
+        echo "  delete            Delete a role by name or seq"
+        echo "  help              Show this help"
+        echo ""
+        echo "list options:"
+        echo "  --limit=<n>       Max rows to show (default: 50)"
+        echo ""
+        echo "add options:"
+        echo "  --name=<name>     Role name (required, unique)"
+        echo "  --permissions=<j> Permissions JSON array (default: [\"entity:read\",\"entity:list\"])"
+        echo "  --description=<t> Description"
+        echo "  --apply           Execute (default is dry-run)"
+        echo ""
+        echo "delete options:"
+        echo "  --name=<name>     Role name to delete"
+        echo "  --seq=<n>         Role seq to delete"
+        echo "  --apply           Execute (default is dry-run)"
+        echo ""
+        echo "Examples:"
+        echo "  $0 list"
+        echo "  $0 add --name=readonly --permissions='[\"entity:read\",\"entity:list\"]' --apply"
+        echo "  $0 add --name=fullaccess --permissions='[\"*\"]' --description=\"Full access\" --apply"
+        echo "  $0 delete --name=readonly --apply"
+        echo "  $0 delete --seq=5 --apply"
+    else
+        echo "RBAC 역할 관리 (CLI 모드)"
+        echo "======================"
+        echo ""
+        echo "CLI 바이너리로 rbac_roles 엔티티를 직접 조작합니다."
+        echo "서버가 실행 중이지 않아도 사용 가능합니다."
+        echo ""
+        echo "사용법: $0 <하위명령> [옵션]"
+        echo ""
+        echo "하위 명령:"
+        echo "  list              RBAC 역할 목록 조회"
+        echo "  add               새 역할 추가"
+        echo "  delete            역할 삭제 (이름 또는 seq 지정)"
+        echo "  help              도움말 출력"
+        echo ""
+        echo "list 옵션:"
+        echo "  --limit=<n>       최대 출력 행 수 (기본: 50)"
+        echo ""
+        echo "add 옵션:"
+        echo "  --name=<이름>      역할 이름 (필수, unique)"
+        echo "  --permissions=<j> 권한 JSON 배열 (기본: [\"entity:read\",\"entity:list\"])"
+        echo "  --description=<t> 설명"
+        echo "  --apply           실제 실행 (기본: dry-run)"
+        echo ""
+        echo "delete 옵션:"
+        echo "  --name=<이름>      삭제할 역할 이름"
+        echo "  --seq=<n>         삭제할 역할 seq"
+        echo "  --apply           실제 실행 (기본: dry-run)"
+        echo ""
+        echo "예제:"
+        echo "  $0 list"
+        echo "  $0 add --name=readonly --permissions='[\"entity:read\",\"entity:list\"]' --apply"
+        echo "  $0 add --name=fullaccess --permissions='[\"*\"]' --description=\"전체 권한\" --apply"
+        echo "  $0 delete --name=readonly --apply"
+        echo "  $0 delete --seq=5 --apply"
+    fi
+}
+
+# 인자 없으면 도움말
+if [ $# -eq 0 ]; then
+    show_help
+    exit 0
+fi
+
+# CLI 바이너리 존재 확인
+if [ ! -f "$BIN_PATH" ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ bin/entity-cli not found. Run: ./scripts/build.sh"
+    else
+        echo "❌ bin/entity-cli 파일이 없습니다. 먼저 ./scripts/build.sh 를 실행하세요."
+    fi
+    exit 1
+fi
+
+SUBCOMMAND="$1"
+shift
+
+case "$SUBCOMMAND" in
+    list|show|add|delete)
+        ENTITY_CLI_NAME="rbac-role" "$BIN_PATH" rbac-role "$SUBCOMMAND" "$@"
+        ;;
+    help|-h|--help)
+        show_help
+        ;;
+    *)
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "❌ Unknown subcommand: $SUBCOMMAND"
+        else
+            echo "❌ 알 수 없는 하위 명령: $SUBCOMMAND"
+        fi
+        echo ""
+        show_help
+        exit 1
+        ;;
+esac

package/template/scripts/remove-systemd.sh

@@ -0,0 +1,158 @@
+#!/bin/bash
+
+# Remove entity-server systemd service.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Load language from .env
+if [ -f "$PROJECT_ROOT/.env" ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' "$PROJECT_ROOT/.env" | cut -d '=' -f2)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+SERVICE_NAME="entity-server"
+INTERACTIVE=false
+CONFIRMED=false
+SERVER_CONFIG="$PROJECT_ROOT/configs/server.json"
+
+load_namespace() {
+    local namespace=""
+    if [ -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')
+    if [ -z "$namespace" ]; then
+        namespace="default"
+    fi
+    SERVICE_NAME="${namespace}-entity-server"
+}
+
+load_namespace
+
+show_help() {
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "Remove systemd service for Entity Server"
+        echo "======================================="
+        echo ""
+        echo "Usage: $0 [options]"
+        echo ""
+        echo "Service name is auto-generated as '<namespace>-entity-server'."
+        echo "Run without arguments to enter interactive mode."
+    else
+        echo "Entity Server systemd 서비스 제거"
+        echo "==============================="
+        echo ""
+        echo "사용법: $0"
+        echo ""
+        echo "서비스명은 '<namespace>-entity-server' 형식으로 자동 생성됩니다."
+        echo "인수 없이 실행하면 인터랙티브 모드로 진입합니다."
+    fi
+}
+
+if [ $# -eq 0 ]; then
+    INTERACTIVE=true
+fi
+
+for arg in "$@"; do
+    case "$arg" in
+        --yes|-y)
+            CONFIRMED=true
+            ;;
+        *)
+            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 ] && [ "$CONFIRMED" = false ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "[interactive] systemd service removal"
+        echo "service name: $SERVICE_NAME"
+    else
+        echo "[interactive] systemd 서비스 제거"
+        echo "서비스명: $SERVICE_NAME"
+    fi
+
+    if [ "$LANGUAGE" = "en" ]; then
+        read -r -p "Remove service '$SERVICE_NAME'? [y/N]: " input
+    else
+        read -r -p "'$SERVICE_NAME' 서비스를 제거할까요? [y/N]: " input
+    fi
+    input=$(echo "$input" | tr '[:upper:]' '[:lower:]')
+    if [ "$input" != "y" ] && [ "$input" != "yes" ]; then
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "Canceled."
+        else
+            echo "취소되었습니다."
+        fi
+        exit 0
+    fi
+fi
+
+UNIT_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
+
+if [ "$EUID" -ne 0 ]; then
+    if command -v sudo >/dev/null 2>&1; then
+        exec sudo "$0" --yes
+    fi
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ This script requires root privileges"
+    else
+        echo "❌ 이 스크립트는 root 권한이 필요합니다"
+    fi
+    exit 1
+fi
+
+SERVICE_EXISTS=false
+if systemctl list-unit-files | grep -q "^${SERVICE_NAME}\.service"; then
+    SERVICE_EXISTS=true
+fi
+if [ ! -f "$UNIT_PATH" ] && [ "$SERVICE_EXISTS" = false ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "ℹ️  Service '$SERVICE_NAME' is not registered."
+        echo "   Nothing to remove."
+        echo ""
+        echo "   To register the service, run:"
+        echo "   sudo $(dirname "$0")/install-systemd.sh"
+    else
+        echo "ℹ️  '$SERVICE_NAME' 서비스가 등록되어 있지 않습니다."
+        echo "   제거할 항목이 없습니다."
+        echo ""
+        echo "   서비스를 등록하려면:"
+        echo "   sudo $(dirname "$0")/install-systemd.sh"
+    fi
+    exit 0
+fi
+
+if [ "$SERVICE_EXISTS" = true ]; then
+    systemctl stop "$SERVICE_NAME" 2>/dev/null || true
+    systemctl disable "$SERVICE_NAME" 2>/dev/null || true
+fi
+
+if [ -f "$UNIT_PATH" ]; then
+    rm -f "$UNIT_PATH"
+fi
+
+systemctl daemon-reload
+
+if [ "$LANGUAGE" = "en" ]; then
+    echo "✅ Service removed: $SERVICE_NAME"
+    echo ""
+    echo "   To re-register the service, run:"
+    echo "   sudo $(dirname "$0")/install-systemd.sh"
+else
+    echo "✅ 서비스 제거 완료: $SERVICE_NAME"
+    echo ""
+    echo "   서비스를 다시 등록하려면:"
+    echo "   sudo $(dirname "$0")/install-systemd.sh"
+fi

package/template/scripts/reset-all.ps1

@@ -0,0 +1,83 @@
+# Reset All Entity Tables - Windows PowerShell
+# Drop all entity tables and recreate with default data
+param(
+    [switch]$DryRun,
+    [switch]$Apply,
+    [switch]$Force
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+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=', '' }
+}
+
+if (-not $DryRun -and -not $Apply -and -not $Force) {
+    if ($Language -eq "en") {
+        Write-Host "Reset All Entity Tables"
+        Write-Host "======================="
+        Write-Host ""
+        Write-Host "Drop all entity tables and recreate with default data."
+        Write-Host ""
+        Write-Host "Usage: .\reset-all.ps1 [OPTIONS]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  -DryRun  Preview mode - show what will be deleted"
+        Write-Host "  -Apply   Apply changes with confirmation prompt"
+        Write-Host "  -Force   Apply changes without confirmation"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\reset-all.ps1 -DryRun    # See what will happen"
+        Write-Host "  .\reset-all.ps1 -Apply      # Execute with confirmation"
+        Write-Host "  .\reset-all.ps1 -Force      # Execute immediately (dangerous!)"
+    } else {
+        Write-Host "모든 엔티티 테이블 초기화"
+        Write-Host "====================="
+        Write-Host ""
+        Write-Host "모든 entity 테이블을 삭제하고 기본 데이터로 재생성합니다."
+        Write-Host ""
+        Write-Host "사용법: .\reset-all.ps1 [옵션]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  -DryRun  미리보기 모드 - 삭제될 테이블 확인"
+        Write-Host "  -Apply   확인 후 실행"
+        Write-Host "  -Force   확인 없이 즉시 실행"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\reset-all.ps1 -DryRun    # 미리보기"
+        Write-Host "  .\reset-all.ps1 -Apply      # 확인 후 실행"
+        Write-Host "  .\reset-all.ps1 -Force      # 즉시 실행 (위험!)"
+    }
+    exit 0
+}
+
+$CliBin = Join-Path $ProjectRoot "bin\entity-cli.exe"
+if (-not (Test-Path $CliBin)) {
+    if ($Language -eq "en") { Write-Host "X bin/entity-cli.exe not found" }
+    else { Write-Host "X bin/entity-cli.exe 파일이 없습니다" }
+    exit 1
+}
+
+if ($DryRun) {
+    & $CliBin reset-all
+} elseif ($Force -or $Apply) {
+    # 필수 엔티티 없으면 자동 생성 (api_keys, rbac_roles, account, user)
+    $NormalizePs1 = Join-Path $ScriptDir "normalize-entities.ps1"
+    if ($Language -eq "en") { Write-Host "⚙️  Checking required entities..." }
+    else { Write-Host "⚙️  필수 엔티티 확인 중..." }
+    $env:LANGUAGE = $Language
+    & $NormalizePs1 -Apply
+
+    if ($Force) {
+        & $CliBin reset-all --apply --force
+    } else {
+        & $CliBin reset-all --apply
+    }
+}

package/template/scripts/reset-all.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+
+# Reset all entity tables and seed default data
+
+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 "Reset All Entity Tables"
+        echo "======================="
+        echo ""
+        echo "Drop all entity tables and recreate with default data."
+        echo ""
+        echo "Usage: $0 [OPTIONS]"
+        echo ""
+        echo "Options:"
+        echo "  --dry-run  Preview mode - show what will be deleted"
+        echo "  --apply    Apply changes with confirmation prompt"
+        echo "  --force    Apply changes without confirmation"
+        echo ""
+        echo "Examples:"
+        echo "  $0 --dry-run    # See what will happen"
+        echo "  $0 --apply      # Execute with confirmation"
+        echo "  $0 --force      # Execute immediately (dangerous!)"
+    else
+        echo "모든 엔티티 테이블 초기화"
+        echo "====================="
+        echo ""
+        echo "모든 entity 테이블을 삭제하고 기본 데이터로 재생성합니다."
+        echo ""
+        echo "사용법: $0 [옵션]"
+        echo ""
+        echo "옵션:"
+        echo "  --dry-run  미리보기 모드 - 삭제될 테이블 확인"
+        echo "  --apply    확인 후 실행"
+        echo "  --force    확인 없이 즉시 실행"
+        echo ""
+        echo "예제:"
+        echo "  $0 --dry-run    # 미리보기"
+        echo "  $0 --apply      # 확인 후 실행"
+        echo "  $0 --force      # 즉시 실행 (위험!)"
+    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
+
+# Execute based on flag
+case "$1" in
+    --dry-run)
+        "$PROJECT_ROOT/bin/entity-cli" reset-all
+        ;;
+    --force|--apply)
+        # 필수 엔티티 없으면 자동 생성 (api_keys, rbac_roles, account, user)
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "⚙️  Checking required entities..."
+        else
+            echo "⚙️  필수 엔티티 확인 중..."
+        fi
+        LANGUAGE="$LANGUAGE" "$SCRIPT_DIR/normalize-entities.sh" --apply
+        if [ "$1" = "--force" ]; then
+            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply --force
+        else
+            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply
+        fi
+        ;;
+    *)
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "❌ Unknown option: $1"
+            echo "Run '$0' for usage information"
+        else
+            echo "❌ 알 수 없는 옵션: $1"
+            echo "'$0'로 사용법을 확인하세요"
+        fi
+        exit 1
+        ;;
+esac