create-entity-app-server 0.0.3

package/scripts/gen-table-type.sh

@@ -0,0 +1,169 @@
+#!/bin/bash
+# gen-table-type.sh — 엔티티 메타에서 Kysely 테이블 타입 자동 생성
+#
+# 엔티티서버의 /v1/entity/:entity/meta API를 호출하여 엔티티 설정을 조회하고,
+# src/app/models/{entity}.ts 에 TypeScript 인터페이스를 생성합니다.
+#
+# 사용법:
+#   ./scripts/gen-table-type.sh --entity=<name> [--all] [--list] [--dry-run]
+#
+# 옵션:
+#   --entity=<name>  엔티티명 (여러 개: --entity=user --entity=account)
+#   --all            전체 엔티티 대상
+#   --list           엔티티 목록만 출력
+#   --dry-run        파일 쓰기 없이 stdout 출력
+#   --force          기존 파일 덮어쓰기 (기본: 파일이 있으면 건너뜀)
+#
+# 예제:
+#   ./scripts/gen-table-type.sh --list
+#   ./scripts/gen-table-type.sh --entity=user
+#   ./scripts/gen-table-type.sh --entity=user --entity=account --force
+#   ./scripts/gen-table-type.sh --all --dry-run
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+# .env 로드
+[ -f ".env" ] && set -o allexport && source .env && set +o allexport
+
+# ── 도움말 ────────────────────────────────────────────────────────────────────
+_show_help() {
+    echo ""
+    echo "  엔티티 → Kysely 테이블 타입 자동 생성"
+    echo "  ====================================="
+    echo ""
+    echo "  사용법: $0 --entity=<name> [옵션]"
+    echo ""
+    echo "  옵션:"
+    echo "    --entity=<name>  엔티티명 (복수 지정 가능)"
+    echo "    --all            전체 엔티티 대상"
+    echo "    --list           엔티티 목록만 출력 (파일 생성 안 함)"
+    echo "    --dry-run        stdout에만 출력 (파일 쓰기 안 함)"
+    echo "    --force          기존 파일 덮어쓰기"
+    echo ""
+    echo "  예제:"
+    echo "    $0 --list"
+    echo "    $0 --entity=user"
+    echo "    $0 --entity=user --entity=account --force"
+    echo "    $0 --all --dry-run"
+    echo ""
+}
+
+if [ $# -eq 0 ]; then
+    _show_help
+    exit 0
+fi
+
+# ── 환경변수 확인 ─────────────────────────────────────────────────────────────
+if [ -z "${ENTITY_SERVER_URL:-}" ]; then
+    echo "❌ ENTITY_SERVER_URL이 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+if [ -z "${ENTITY_API_KEY:-}" ]; then
+    echo "❌ ENTITY_API_KEY가 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+if [ -z "${ENTITY_HMAC_SECRET:-}" ]; then
+    echo "❌ ENTITY_HMAC_SECRET이 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+
+# ── 인자 파싱 ─────────────────────────────────────────────────────────────────
+ENTITIES=()
+LIST_ONLY=false
+DRY_RUN=false
+ALL=false
+FORCE=false
+
+for arg in "$@"; do
+    case "$arg" in
+        --entity=*) ENTITIES+=("${arg#--entity=}") ;;
+        --all)      ALL=true ;;
+        --list)     LIST_ONLY=true ;;
+        --dry-run)  DRY_RUN=true ;;
+        --force)    FORCE=true ;;
+        --help|-h)  _show_help; exit 0 ;;
+        *)
+            echo "❌ 알 수 없는 옵션: $arg"
+            _show_help
+            exit 1
+            ;;
+    esac
+done
+
+# ── HTTP 헬퍼 (HMAC 서명) ─────────────────────────────────────────────────────
+_hmac_get() {
+    local url="$1"
+    local full_path
+    full_path=$(echo "$url" | sed -E 's|^https?://[^/]+||')
+    # 서명은 쿼리 파라미터 제외한 경로만 사용 (Fiber c.Path() 일치)
+    local sign_path
+    sign_path=$(echo "$full_path" | sed -E 's|\?.*$||')
+    local ts
+    ts=$(date +%s)
+    local nonce
+    nonce=$(cat /proc/sys/kernel/random/uuid 2>/dev/null || uuidgen)
+    local payload="GET|${sign_path}|${ts}|${nonce}|"
+    local sig
+    sig=$(printf '%s' "$payload" | openssl dgst -sha256 -hmac "${ENTITY_HMAC_SECRET}" -hex 2>/dev/null | sed 's/.*= //')
+    curl -sS \
+        -H "X-API-Key: ${ENTITY_API_KEY}" \
+        -H "X-Timestamp: ${ts}" \
+        -H "X-Nonce: ${nonce}" \
+        -H "X-Signature: ${sig}" \
+        "$url" 2>&1
+}
+
+# ── 엔티티 목록 조회 ─────────────────────────────────────────────────────────
+_list_entities() {
+    local resp
+    resp=$(_hmac_get "${ENTITY_SERVER_URL}/v1/admin/entities?page=1&page_size=1000")
+    echo "$resp" | node -e "
+        const d = JSON.parse(require('fs').readFileSync('/dev/stdin','utf-8'));
+        if (!d.ok) { console.error('API 오류:', JSON.stringify(d)); process.exit(1); }
+        (d.data?.items || []).forEach(i => console.log(i.name));
+    " 2>&1
+}
+
+if [ "$LIST_ONLY" = true ]; then
+    echo ""
+    echo "  엔티티 목록  |  서버: ${ENTITY_SERVER_URL}"
+    echo ""
+    _list_entities | while read -r name; do
+        echo "    $name"
+    done
+    echo ""
+    exit 0
+fi
+
+# --all 옵션: 전체 엔티티 자동 수집
+if [ "$ALL" = true ]; then
+    mapfile -t ENTITIES < <(_list_entities)
+fi
+
+if [ ${#ENTITIES[@]} -eq 0 ]; then
+    echo "❌ --entity=<name> 또는 --all 옵션이 필요합니다."
+    _show_help
+    exit 1
+fi
+
+# ── tsx 스크립트로 타입 생성 위임 ─────────────────────────────────────────────
+# 엔티티 목록을 콤마로 결합
+ENTITY_LIST=$(IFS=,; echo "${ENTITIES[*]}")
+
+FLAGS=""
+[ "$DRY_RUN" = true ] && FLAGS="$FLAGS --dry-run"
+[ "$FORCE" = true ] && FLAGS="$FLAGS --force"
+
+npx tsx "$SCRIPT_DIR/_gen-table-type.ts" \
+    --entities="$ENTITY_LIST" \
+    --server-url="${ENTITY_SERVER_URL}" \
+    --api-key="${ENTITY_API_KEY}" \
+    --hmac-secret="${ENTITY_HMAC_SECRET}" \
+    --out-dir="$PROJECT_ROOT/src/app/models" \
+    $FLAGS
+

package/scripts/push.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+# push.sh — 버전 관리 + Git push
+#
+# 사용법:
+#   ./scripts/push.sh version            — 현재 버전 확인
+#   ./scripts/push.sh patch              — 1.2.3 → 1.2.4 (버그 수정) + push
+#   ./scripts/push.sh minor              — 1.2.3 → 1.3.0 (기능 추가) + push
+#   ./scripts/push.sh major              — 1.2.3 → 2.0.0 (호환 변경) + push
+#   ./scripts/push.sh tag                — 현재 버전으로 git tag + push
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+PKG_FILE="package.json"
+
+# ─── 현재 버전 확인 ──────────────────────────────────────────────────────────
+_current_version() {
+    grep '"version"' "$PKG_FILE" | head -1 | sed 's/.*: *"\([^"]*\)".*/\1/'
+}
+
+# ─── 버전 업 ─────────────────────────────────────────────────────────────────
+_bump_version() {
+    local bump_type="${1:-patch}"
+    local current_ver
+    current_ver=$(_current_version)
+
+    IFS='.' read -ra parts <<< "$current_ver"
+    local major="${parts[0]}"
+    local minor="${parts[1]}"
+    local patch="${parts[2]}"
+
+    case "$bump_type" in
+        major) major=$((major + 1)); minor=0; patch=0 ;;
+        minor) minor=$((minor + 1)); patch=0 ;;
+        patch) patch=$((patch + 1)) ;;
+        *)
+            echo "❌ 알 수 없는 타입: $bump_type (patch | minor | major)" >&2
+            exit 1 ;;
+    esac
+
+    local new_ver="${major}.${minor}.${patch}"
+
+    # package.json 버전 업데이트
+    if command -v jq &>/dev/null; then
+        jq --arg v "$new_ver" '.version = $v' "$PKG_FILE" > "${PKG_FILE}.tmp" && mv "${PKG_FILE}.tmp" "$PKG_FILE"
+    else
+        sed -i "s/\"version\": \"${current_ver}\"/\"version\": \"${new_ver}\"/" "$PKG_FILE"
+    fi
+
+    echo "  버전: ${current_ver} → ${new_ver}"
+    echo "$new_ver"
+}
+
+# ─── Main ────────────────────────────────────────────────────────────────────
+
+if [ $# -eq 0 ]; then
+    echo "  현재 버전: v$(_current_version)"
+    echo ""
+    echo "  사용법:"
+    echo "    $0 version         — 현재 버전 확인"
+    echo "    $0 patch           — 버그 수정 버전 업 + push"
+    echo "    $0 minor           — 기능 추가 버전 업 + push"
+    echo "    $0 major           — 호환 변경 버전 업 + push"
+    echo "    $0 tag             — 현재 버전으로 git tag + push"
+    exit 0
+fi
+
+BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "main")
+
+if [ "$1" = "version" ]; then
+    echo "  현재 버전: v$(_current_version)"
+
+elif [ "$1" = "patch" ] || [ "$1" = "minor" ] || [ "$1" = "major" ]; then
+    NEW_VER=$(_bump_version "$1")
+
+    git add "$PKG_FILE"
+    git commit -m "chore: bump version to v${NEW_VER}"
+    git tag "gateway-v${NEW_VER}"
+    git push origin "$BRANCH"
+    git push origin "gateway-v${NEW_VER}"
+
+    echo ""
+    echo "  ✓ v${NEW_VER} pushed to ${BRANCH}"
+    echo ""
+
+elif [ "$1" = "tag" ]; then
+    CURRENT_VER=$(_current_version)
+    git tag "gateway-v${CURRENT_VER}"
+    git push origin "gateway-v${CURRENT_VER}"
+
+    echo ""
+    echo "  ✓ tag: gateway-v${CURRENT_VER}"
+    echo ""
+
+else
+    echo "❌ 알 수 없는 명령: $1" >&2
+    exit 1
+fi

package/scripts/release.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# release.sh — 빌드 + 버전 업 + push (one-shot)
+#
+# 사용법:
+#   ./scripts/release.sh patch   — 버그 수정 릴리즈
+#   ./scripts/release.sh minor   — 기능 추가 릴리즈
+#   ./scripts/release.sh major   — 호환 변경 릴리즈
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+BUMP_TYPE="${1:-patch}"
+
+if [ $# -eq 0 ]; then
+    echo ""
+    echo "  Gateway 릴리즈 (빌드 + 버전업 + push)"
+    echo "  ============================="
+    echo ""
+    echo "  사용법: $0 <타입>"
+    echo ""
+    echo "  타입:"
+    echo "    patch   버그 수정 릴리즈 (x.y.Z+1, 기본값)"
+    echo "    minor   기능 추가 릴리즈 (x.Y+1.0)"
+    echo "    major   호환 변경 릴리스 (X+1.0.0)"
+    echo ""
+    echo "  예제:"
+    echo "    $0 patch   # 버그 수정"
+    echo "    $0 minor   # 기능 추가"
+    echo "    $0 major   # 호환 변경"
+    echo ""
+    exit 0
+fi
+
+echo ""
+echo "  Entity Server Gateway — Release (${BUMP_TYPE})"
+echo ""
+
+# 1. 빌드
+echo "  [1/2] Building..."
+"$SCRIPT_DIR/build.sh"
+
+# 2. 버전 업 + push
+echo "  [2/2] Pushing..."
+"$SCRIPT_DIR/push.sh" version "$BUMP_TYPE"
+
+echo "  Release complete."
+echo ""

package/scripts/reset-all.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+# reset-all.sh — entity-server 전체 초기화 + Gateway .env 키 업데이트
+#
+# POST /v1/admin/reset-all 을 호출하여 모든 엔티티 테이블을 재생성하고,
+# 응답의 새 API 키를 .env에 자동 반영합니다.
+# (.env의 ENTITY_SERVER_URL + ENTITY_API_KEY 사용)
+#
+# 사용법:
+#   ./scripts/reset-all.sh --dry-run   — 미리보기 (기본)
+#   ./scripts/reset-all.sh --apply     — 확인 후 실행
+#   ./scripts/reset-all.sh --force     — 확인 없이 즉시 실행
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+cd "$PROJECT_ROOT"
+
+# .env 로드
+[ -f ".env" ] && set -o allexport && source .env && set +o allexport
+
+if [ $# -eq 0 ]; then
+    echo ""
+    echo "  Entity Server 전체 초기화"
+    echo "  ======================"
+    echo ""
+    echo "  사용법: $0 <옵션>"
+    echo ""
+    echo "  옵션:"
+    echo "    --dry-run   미리보기 (기본값)"
+    echo "    --apply     확인 흐 실행"
+    echo "    --force     확인 없이 즉시 실행"
+    echo ""
+    echo "  ⚠️  주의: entity-server의 모든 엔티티 데이터가 삭제됩니다."
+    echo "         실행 후 새 API 키가 생성되어 .env에 자동 반영됩니다."
+    echo ""
+    echo "  예제:"
+    echo "    $0 --dry-run    # 미리보기"
+    echo "    $0 --apply      # 확인 후 실행"
+    echo "    $0 --force      # 즉시 실행 (위험!)"
+    echo ""
+    exit 0
+fi
+
+DRY_RUN=true
+FORCE=false
+
+for arg in "$@"; do
+    case "$arg" in
+        --apply) DRY_RUN=false ;;
+        --force) DRY_RUN=false; FORCE=true ;;
+        --dry-run) DRY_RUN=true ;;
+    esac
+done
+
+echo ""
+echo "  Entity Server 전체 초기화"
+echo "  ======================="
+echo ""
+
+# 필수 환경변수 확인
+if [ -z "${ENTITY_SERVER_URL:-}" ]; then
+    echo "❌ ENTITY_SERVER_URL이 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+if [ -z "${ENTITY_API_KEY:-}" ]; then
+    echo "❌ ENTITY_API_KEY가 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+if [ -z "${ENTITY_HMAC_SECRET:-}" ]; then
+    echo "❌ ENTITY_HMAC_SECRET이 설정되지 않았습니다 (.env 확인)"
+    exit 1
+fi
+
+# HMAC-SHA256 서명 계산 (python3 사용)
+_hmac_sign() {
+    local method="$1" sign_path="$2" ts="$3" nonce="$4" body="${5:-}"
+    HMAC_PAYLOAD="${method}|${sign_path}|${ts}|${nonce}|${body}" \
+    python3 -c "
+import hmac, hashlib, os
+s = os.environ['ENTITY_HMAC_SECRET'].encode()
+p = os.environ['HMAC_PAYLOAD'].encode()
+print(hmac.new(s, p, hashlib.sha256).hexdigest())
+"
+}
+
+# HMAC 인증 POST 요청 (url, sign_path, body)
+_http_post() {
+    local url="$1" sign_path="$2" body="${3:-}"
+    local ts nonce sig
+    ts=$(date +%s)
+    nonce=$(python3 -c "import uuid; print(str(uuid.uuid4()))")
+    sig=$(_hmac_sign "POST" "$sign_path" "$ts" "$nonce" "$body")
+    if command -v curl &>/dev/null; then
+        curl -sS -X POST \
+            -H "X-API-Key: ${ENTITY_API_KEY}" \
+            -H "X-Timestamp: ${ts}" \
+            -H "X-Nonce: ${nonce}" \
+            -H "X-Signature: ${sig}" \
+            -H "Content-Type: application/json" \
+            ${body:+--data "$body"} \
+            "$url" 2>&1
+    elif command -v wget &>/dev/null; then
+        wget -qO- \
+            --method=POST \
+            --header="X-API-Key: ${ENTITY_API_KEY}" \
+            --header="X-Timestamp: ${ts}" \
+            --header="X-Nonce: ${nonce}" \
+            --header="X-Signature: ${sig}" \
+            --header="Content-Type: application/json" \
+            ${body:+--body-data="$body"} \
+            "$url" 2>&1
+    else
+        echo "❌ curl 또는 wget이 필요합니다."
+        exit 1
+    fi
+}
+
+# JSON 파싱 헬퍼 (jq 우선, 없으면 python3)
+_json_get() {
+    local json="$1" key="$2"
+    if command -v jq &>/dev/null; then
+        echo "$json" | jq -r "$key // empty" 2>/dev/null
+    else
+        echo "$json" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d$(echo "$key" | sed 's/\./][\"/'g | sed 's/^/["/' | sed 's/$/"]/'))" 2>/dev/null
+    fi
+}
+
+_parse_key() {
+    local json="$1" field="$2"
+    echo "$json" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    print(d.get('result', {}).get('$field', ''))
+except:
+    pass
+" 2>/dev/null || echo ""
+}
+
+if [ "$DRY_RUN" = true ]; then
+    echo "  [dry-run] entity-server의 모든 엔티티를 재생성합니다."
+    echo "  실제 실행: ./scripts/reset-all.sh --apply"
+    echo ""
+    exit 0
+fi
+
+# 확인 프롬프트
+if [ "$FORCE" = false ]; then
+    echo "  ⚠️  경고: entity-server의 모든 엔티티 데이터가 삭제됩니다!"
+    read -r -p "  계속 진행하시겠습니까? [y/N] " confirm
+    case "$confirm" in
+        [yY][eE][sS]|[yY]) ;;
+        *) echo "  취소되었습니다."; exit 0 ;;
+    esac
+fi
+
+# reset-all 실행 (단일 HTTP 호출)
+echo ""
+echo "  entity-server reset-all 실행 중..."
+url="${ENTITY_SERVER_URL}/v1/admin/reset-all?confirm=RESET_ALL_ENTITIES"
+response=$(_http_post "$url" "/v1/admin/reset-all" "")
+
+if ! echo "$response" | grep -q '"ok":true'; then
+    echo "  ❌ reset-all 실패:"
+    echo "  $response" | head -5
+    exit 1
+fi
+
+echo "  ✓ reset-all 완료"
+
+# 새 API 키 추출
+NEW_API_KEY=$(_parse_key "$response" "generated_api_key")
+NEW_HMAC=$(_parse_key "$response" "generated_hmac_secret")
+
+if [ -n "$NEW_API_KEY" ] && [ -n "$NEW_HMAC" ]; then
+    echo ""
+    echo "  🔑 새 API 키가 생성되었습니다:"
+    echo "     ENTITY_API_KEY     = $NEW_API_KEY"
+    echo "     ENTITY_HMAC_SECRET = $NEW_HMAC"
+
+    # .env 업데이트
+    if [ -f "$PROJECT_ROOT/.env" ]; then
+        sed -i "s|^ENTITY_API_KEY=.*|ENTITY_API_KEY=$NEW_API_KEY|" "$PROJECT_ROOT/.env"
+        sed -i "s|^ENTITY_HMAC_SECRET=.*|ENTITY_HMAC_SECRET=$NEW_HMAC|" "$PROJECT_ROOT/.env"
+        echo "     ✓ .env 업데이트 완료"
+        # 새 키로 환경변수 갱신
+        ENTITY_API_KEY="$NEW_API_KEY"
+        ENTITY_HMAC_SECRET="$NEW_HMAC"
+    else
+        echo "     ⚠️  .env 파일 없음 — 위 값을 수동으로 .env에 저장하세요"
+    fi
+else
+    echo "  ⚠️  응답에서 API 키를 추출하지 못했습니다 (python3 필요)"
+fi
+
+# DB 타입 자동 재생성 (새 키가 이미 환경변수에 적용된 상태)
+echo ""
+echo "  📦 database/tables/ 타입 재생성 중..."
+if bash "$SCRIPT_DIR/gen-table-type.sh" --all --force; then
+    echo "  ✓ database/tables/ 타입 재생성 완료"
+else
+    echo "  ⚠️  타입 재생성 실패 — 수동으로 실행하세요:"
+    echo "       ./scripts/gen-table-type.sh --all --force"
+fi
+
+echo ""