create-entity-server 0.0.9

package/template/scripts/cleanup-history.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+# Cleanup expired history rows by history_ttl
+
+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_help() {
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "History TTL Cleanup"
+        echo "==================="
+        echo ""
+        echo "Usage: $0 [--entity=<name>] [--apply]"
+        echo ""
+        echo "Options:"
+        echo "  --entity=<name>  Cleanup only one entity history"
+        echo "  --apply          Execute delete (default: dry-run)"
+    else
+        echo "히스토리 TTL 정리"
+        echo "================"
+        echo ""
+        echo "사용법: $0 [--entity=<name>] [--apply]"
+        echo ""
+        echo "옵션:"
+        echo "  --entity=<name>  특정 엔티티 히스토리만 정리"
+        echo "  --apply          실제 삭제 실행 (기본: dry-run)"
+    fi
+}
+
+if [ $# -eq 0 ]; then
+    show_help
+    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
+
+# Pass-through to CLI
+"$PROJECT_ROOT/bin/entity-cli" cleanup-history "$@"

package/template/scripts/cli.ps1

@@ -0,0 +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

package/template/scripts/cli.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# Entity CLI wrapper script
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+BIN_PATH="$PROJECT_ROOT/bin/entity-cli"
+
+# Load language from .env
+if [ -f "$PROJECT_ROOT/.env" ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' "$PROJECT_ROOT/.env" | cut -d '=' -f2)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+# Require prebuilt CLI binary
+if [ ! -f "$BIN_PATH" ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ bin/entity-cli not found"
+    else
+        echo "❌ bin/entity-cli 파일이 없습니다"
+    fi
+    exit 1
+fi
+
+# Run the CLI tool
+cd "$PROJECT_ROOT"
+ENTITY_CLI_NAME="cli" "$BIN_PATH" "$@"

package/template/scripts/entity.ps1

@@ -0,0 +1,70 @@
+# Init Entity Tables - Windows PowerShell
+# Add, reset, or truncate one entity's data/index/history tables
+
+$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=', '' }
+}
+
+function Show-Help {
+    if ($Language -eq "en") {
+        Write-Host "Init Entity Tables"
+        Write-Host "=================="
+        Write-Host ""
+        Write-Host "Add, reset, or truncate one entity's data/index/history tables."
+        Write-Host ""
+        Write-Host "Usage: .\entity.ps1 --entity=<name> [--reset|--truncate] [--apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "  --entity=<name>  Entity name (required)"
+        Write-Host "  --reset          Drop this entity tables and recreate"
+        Write-Host "  --truncate       Delete all rows and reset AUTO_INCREMENT=1"
+        Write-Host "  --apply          Execute (default is dry-run)"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "  .\entity.ps1 --entity=license --apply"
+        Write-Host "  .\entity.ps1 --entity=account --reset --apply"
+        Write-Host "  .\entity.ps1 --entity=account --truncate --apply"
+    } else {
+        Write-Host "단일 엔티티 테이블 초기화"
+        Write-Host "====================="
+        Write-Host ""
+        Write-Host "하나의 엔티티(data/index/history) 테이블을 추가/재생성/비우기(truncate) 합니다."
+        Write-Host ""
+        Write-Host "사용법: .\entity.ps1 --entity=<name> [--reset|--truncate] [--apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "  --entity=<name>  엔티티명 (필수)"
+        Write-Host "  --reset          해당 엔티티 테이블 드롭 후 재생성"
+        Write-Host "  --truncate       데이터 전체 삭제 + AUTO_INCREMENT=1 초기화"
+        Write-Host "  --apply          실제 실행 (기본은 dry-run)"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "  .\entity.ps1 --entity=license --apply"
+        Write-Host "  .\entity.ps1 --entity=account --reset --apply"
+        Write-Host "  .\entity.ps1 --entity=account --truncate --apply"
+    }
+}
+
+if ($args.Count -eq 0) {
+    Show-Help
+    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
+}
+
+# Pass-through to CLI
+& $CliBin init-entity @args

package/template/scripts/entity.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+
+# Add or reset a single entity tables
+
+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_help() {
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "Init Entity Tables"
+        echo "=================="
+        echo ""
+        echo "Add, reset, or truncate one entity's data/index/history tables."
+        echo ""
+        echo "Usage: $0 --entity=<name> [--reset|--truncate] [--apply]"
+        echo ""
+        echo "Options:"
+        echo "  --entity=<name>  Entity name (required)"
+        echo "  --reset          Drop this entity tables and recreate"
+        echo "  --truncate       Delete all rows and reset AUTO_INCREMENT=1"
+        echo "  --apply          Execute (default is dry-run)"
+        echo ""
+        echo "Examples:"
+        echo "  $0 --entity=license --apply"
+        echo "  $0 --entity=account --reset --apply"
+        echo "  $0 --entity=account --truncate --apply"
+    else
+        echo "단일 엔티티 테이블 초기화"
+        echo "====================="
+        echo ""
+        echo "하나의 엔티티(data/index/history) 테이블을 추가/재생성/비우기(truncate) 합니다."
+        echo ""
+        echo "사용법: $0 --entity=<name> [--reset|--truncate] [--apply]"
+        echo ""
+        echo "옵션:"
+        echo "  --entity=<name>  엔티티명 (필수)"
+        echo "  --reset          해당 엔티티 테이블 드롭 후 재생성"
+        echo "  --truncate       데이터 전체 삭제 + AUTO_INCREMENT=1 초기화"
+        echo "  --apply          실제 실행 (기본은 dry-run)"
+        echo ""
+        echo "예제:"
+        echo "  $0 --entity=license --apply"
+        echo "  $0 --entity=account --reset --apply"
+        echo "  $0 --entity=account --truncate --apply"
+    fi
+}
+
+if [ $# -eq 0 ]; then
+    show_help
+    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
+
+# Pass-through to CLI
+"$PROJECT_ROOT/bin/entity-cli" init-entity "$@"

package/template/scripts/generate-env-keys.ps1

@@ -0,0 +1,125 @@
+# Generate Environment Keys/Secrets - Windows PowerShell
+# Generates ENCRYPTION_KEY and JWT_SECRET random values
+param(
+    [switch]$Create,
+    [switch]$Export,
+    [switch]$Apply
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Load language from .env (env var takes priority)
+$Language = $env:LANGUAGE
+if (-not $Language) {
+    $EnvFile = Join-Path $ProjectRoot ".env"
+    if (Test-Path $EnvFile) {
+        $LangLine = Get-Content $EnvFile | Where-Object { $_ -match '^LANGUAGE=' } | Select-Object -Last 1
+        if ($LangLine) { $Language = $LangLine -replace '^LANGUAGE=', '' }
+    }
+}
+if (-not $Language) { $Language = "ko" }
+
+function Show-Help {
+    if ($Language -eq "en") {
+        Write-Host "Generate Environment Keys/Secrets"
+        Write-Host "==================================="
+        Write-Host ""
+        Write-Host "Generates random values for ENCRYPTION_KEY and JWT_SECRET."
+        Write-Host ""
+        Write-Host "Note: API keys (api_keys entity) are managed via DB commands:"
+        Write-Host "      .\scripts\api-key.ps1 add --role=admin --apply"
+        Write-Host ""
+        Write-Host "Usage: .\generate-env-keys.ps1 [-Create|-Export|-Apply]"
+        Write-Host ""
+        Write-Host "Options:"
+        Write-Host "    -Create      Print copy/paste format for .env"
+        Write-Host "    -Export      Print shell export format"
+        Write-Host "    -Apply       Apply values directly to project .env"
+        Write-Host ""
+        Write-Host "Examples:"
+        Write-Host "    .\generate-env-keys.ps1 -Create"
+        Write-Host "    .\generate-env-keys.ps1 -Export"
+        Write-Host "    .\generate-env-keys.ps1 -Apply"
+    } else {
+        Write-Host "환경 변수 키/시크릿 생성"
+        Write-Host "======================="
+        Write-Host ""
+        Write-Host "ENCRYPTION_KEY, JWT_SECRET 랜덤 값을 생성합니다."
+        Write-Host ""
+        Write-Host "참고: API 키(api_keys 엔티티)는 DB 명령으로 관리합니다:"
+        Write-Host "      .\scripts\api-key.ps1 add --role=admin --apply"
+        Write-Host ""
+        Write-Host "사용법: .\generate-env-keys.ps1 [-Create|-Export|-Apply]"
+        Write-Host ""
+        Write-Host "옵션:"
+        Write-Host "    -Create      .env 복붙 형식으로 출력"
+        Write-Host "    -Export      export 형식으로 출력"
+        Write-Host "    -Apply       프로젝트 루트 .env 파일에 즉시 반영"
+        Write-Host ""
+        Write-Host "예제:"
+        Write-Host "    .\generate-env-keys.ps1 -Create"
+        Write-Host "    .\generate-env-keys.ps1 -Export"
+        Write-Host "    .\generate-env-keys.ps1 -Apply"
+    }
+}
+
+if (-not $Create -and -not $Export -and -not $Apply) {
+    Show-Help
+    exit 0
+}
+
+function New-RandomHex {
+    param([int]$Bytes)
+    $rng = [System.Security.Cryptography.RandomNumberGenerator]::Create()
+    $buf = New-Object byte[] $Bytes
+    $rng.GetBytes($buf)
+    return ($buf | ForEach-Object { $_.ToString("x2") }) -join ""
+}
+
+$EncryptionKey = New-RandomHex 16
+$JwtSecret = New-RandomHex 32
+
+if ($Export) {
+    Write-Host "SET ENCRYPTION_KEY=$EncryptionKey"
+    Write-Host "SET JWT_SECRET=$JwtSecret"
+    Write-Host ""
+    Write-Host "# PowerShell:"
+    Write-Host "`$env:ENCRYPTION_KEY=`"$EncryptionKey`""
+    Write-Host "`$env:JWT_SECRET=`"$JwtSecret`""
+} elseif ($Create) {
+    if ($Language -eq "en") { Write-Host "# Copy & paste to .env" }
+    else { Write-Host "# .env에 복사해서 붙여넣기" }
+    Write-Host "ENCRYPTION_KEY=$EncryptionKey"
+    Write-Host "JWT_SECRET=$JwtSecret"
+} elseif ($Apply) {
+    $EnvFile = Join-Path $ProjectRoot ".env"
+    if (-not (Test-Path $EnvFile)) { New-Item -ItemType File -Path $EnvFile | Out-Null }
+
+    function Update-EnvKey {
+        param([string]$File, [string]$Key, [string]$Value)
+        $content = Get-Content $File
+        $found = $false
+        $newContent = $content | ForEach-Object {
+            if ($_ -match "^$Key=") {
+                $found = $true
+                "$Key=$Value"
+            } else { $_ }
+        }
+        if (-not $found) { $newContent += "$Key=$Value" }
+        $newContent | Set-Content $File
+    }
+
+    Update-EnvKey $EnvFile "ENCRYPTION_KEY" $EncryptionKey
+    Update-EnvKey $EnvFile "JWT_SECRET" $JwtSecret
+
+    if ($Language -eq "en") {
+        Write-Host "OK Updated: $EnvFile"
+        Write-Host "  - ENCRYPTION_KEY"
+        Write-Host "  - JWT_SECRET"
+    } else {
+        Write-Host "OK 업데이트 완료: $EnvFile"
+        Write-Host "  - ENCRYPTION_KEY"
+        Write-Host "  - JWT_SECRET"
+    }
+}

package/template/scripts/generate-env-keys.sh

@@ -0,0 +1,148 @@
+#!/bin/bash
+# 환경 변수 키/시크릿 생성 스크립트
+# ENCRYPTION_KEY, JWT_SECRET 랜덤 값 생성
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# LANGUAGE 환경변수를 우선 사용하고, 없으면 .env에서 로드
+if [ -z "${LANGUAGE:-}" ] && [ -f "$PROJECT_ROOT/.env" ]; then
+    LANGUAGE=$(grep '^LANGUAGE=' "$PROJECT_ROOT/.env" | tail -n 1 | cut -d '=' -f2 || true)
+fi
+LANGUAGE=${LANGUAGE:-ko}
+
+show_help() {
+    if [ "$LANGUAGE" = "en" ]; then
+        cat <<'EOF'
+Generate Environment Keys/Secrets
+===================================
+
+Generates random values for ENCRYPTION_KEY and JWT_SECRET.
+
+Note: API keys (api_keys entity) are managed via DB commands:
+      ./scripts/api-key.sh add --role=admin --apply
+
+Usage: ./scripts/generate-env-keys.sh [--create|--export|--apply]
+
+Options:
+    --create      Print copy/paste format for .env
+    --export      Print shell export format
+    --apply       Apply values directly to project .env
+
+Examples:
+    ./scripts/generate-env-keys.sh --create
+    ./scripts/generate-env-keys.sh --export
+    ./scripts/generate-env-keys.sh --apply
+EOF
+    else
+        cat <<'EOF'
+환경 변수 키/시크릿 생성
+=======================
+
+ENCRYPTION_KEY, JWT_SECRET 랜덤 값을 생성합니다.
+
+참고: API 키(api_keys 엔티티)는 DB 명령으로 관리합니다:
+      ./scripts/api-key.sh add --role=admin --apply
+
+사용법: ./scripts/generate-env-keys.sh [--create|--export|--apply]
+
+옵션:
+    --create      .env 복붙 형식으로 출력
+    --export      export 형식으로 출력
+    --apply       프로젝트 루트 .env 파일에 즉시 반영
+
+예제:
+    ./scripts/generate-env-keys.sh --create
+    ./scripts/generate-env-keys.sh --export
+    ./scripts/generate-env-keys.sh --apply
+EOF
+    fi
+}
+
+if [[ $# -eq 0 ]]; then
+    show_help
+    exit 0
+fi
+
+OUTPUT_MODE=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --create)
+            OUTPUT_MODE="dotenv"
+            shift
+            ;;
+        --export)
+            OUTPUT_MODE="export"
+            shift
+            ;;
+        --apply)
+            OUTPUT_MODE="apply-env"
+            shift
+            ;;
+        *)
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "❌ Unknown option: $1"
+            else
+                echo "❌ 알 수 없는 옵션: $1"
+            fi
+            echo ""
+            show_help
+            exit 1
+            ;;
+    esac
+done
+
+gen_hex() {
+    local bytes="$1"
+    if command -v openssl >/dev/null 2>&1; then
+        openssl rand -hex "$bytes"
+    else
+        head -c "$bytes" /dev/urandom | od -An -tx1 | tr -d ' \n'
+    fi
+}
+
+ENCRYPTION_KEY="$(gen_hex 16)"
+JWT_SECRET="$(gen_hex 32)"
+
+if [[ "$OUTPUT_MODE" == "export" ]]; then
+    cat <<EOF
+export ENCRYPTION_KEY=$ENCRYPTION_KEY
+export JWT_SECRET=$JWT_SECRET
+EOF
+elif [[ "$OUTPUT_MODE" == "dotenv" ]]; then
+    cat <<EOF
+# $( [ "$LANGUAGE" = "en" ] && echo "Copy & paste to .env" || echo ".env에 복사해서 붙여넣기" )
+ENCRYPTION_KEY=$ENCRYPTION_KEY
+JWT_SECRET=$JWT_SECRET
+EOF
+else
+    # --apply
+    ENV_FILE="$PROJECT_ROOT/.env"
+    touch "$ENV_FILE"
+
+    upsert_env_key() {
+        local key="$1"
+        local value="$2"
+        if grep -q "^${key}=" "$ENV_FILE"; then
+            sed -i "s|^${key}=.*$|${key}=${value}|" "$ENV_FILE"
+        else
+            echo "${key}=${value}" >> "$ENV_FILE"
+        fi
+    }
+
+    upsert_env_key "ENCRYPTION_KEY" "$ENCRYPTION_KEY"
+    upsert_env_key "JWT_SECRET" "$JWT_SECRET"
+
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "✓ Updated: $ENV_FILE"
+        echo "  - ENCRYPTION_KEY"
+        echo "  - JWT_SECRET"
+    else
+        echo "✓ 업데이트 완료: $ENV_FILE"
+        echo "  - ENCRYPTION_KEY"
+        echo "  - JWT_SECRET"
+    fi
+fi