create-entity-server 0.0.31 → 0.2.5

package/template/scripts/run.sh

@@ -54,6 +54,70 @@ get_server_value() {
     fi
 }
 
+get_database_default_group() {
+    local value
+    value=$(grep -E '"default"[[:space:]]*:' "$DATABASE_CONFIG" | head -n 1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/')
+    echo "$value"
+}
+
+list_database_groups() {
+    grep -E '^[[:space:]]*"[^"]+"[[:space:]]*:[[:space:]]*\{' "$DATABASE_CONFIG" \
+        | sed -E 's/^[[:space:]]*"([^"]+)"[[:space:]]*:[[:space:]]*\{.*/\1/' \
+        | grep -v '^groups$' \
+    | awk 'BEGIN { first = 1 } { if (!first) printf ", "; printf "%s", $0; first = 0 } END { printf "\n" }'
+}
+
+print_missing_database_group_error() {
+    local expected_group="$1"
+    local line_no="$2"
+    local current_default
+    local available_groups
+
+    current_default=$(get_database_default_group)
+    available_groups=$(list_database_groups)
+
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ database group '$expected_group' not found"
+        echo "   at: scripts/run.sh:$line_no"
+        echo "   config: $DATABASE_CONFIG"
+        echo "   current default: ${current_default:-<empty>}"
+        echo "   available groups: ${available_groups:-<none>}"
+        echo "   cause: run.sh $MODE hardcodes '$expected_group' as the target default group."
+    else
+        echo "❌ configs/database.json에 '$expected_group' 그룹이 없습니다"
+        echo "   위치: scripts/run.sh:$line_no"
+        echo "   설정파일: $DATABASE_CONFIG"
+        echo "   현재 default: ${current_default:-<empty>}"
+        echo "   사용 가능한 groups: ${available_groups:-<none>}"
+        echo "   원인: run.sh $MODE 모드는 '$expected_group' 그룹을 기본 DB 그룹으로 강제하도록 작성되어 있습니다."
+    fi
+}
+
+sync_database_default_for_environment() {
+    local environment_value
+    environment_value=$(get_server_value "environment" "development")
+
+    if [ "$environment_value" != "production" ]; then
+        return 0
+    fi
+
+    # 현재 default 그룹이 database.json 안에 존재하면 그대로 유지
+    local current_default
+    current_default=$(get_database_default_group)
+    if [ -n "$current_default" ] && grep -Eq "\"${current_default}\"[[:space:]]*:" "$DATABASE_CONFIG"; then
+        return 0
+    fi
+
+    # 현재 default 그룹이 없을 때만 production으로 fallback
+    if ! grep -Eq '"production"[[:space:]]*:' "$DATABASE_CONFIG"; then
+        print_missing_database_group_error "production" "$1"
+        return 1
+    fi
+
+    sed -E -i 's/("default"[[:space:]]*:[[:space:]]*")[^"]+(")/\1production\2/' "$DATABASE_CONFIG"
+    return 0
+}
+
 is_running() {
     local port_pid
     port_pid=$(find_pid_by_port)
@@ -146,7 +210,7 @@ stop_pid_with_confirm() {
         read -r -p "이 프로세스를 중지할까요? [y/N]: " input
     fi
     input=$(echo "$input" | tr '[:upper:]' '[:lower:]')
-    if [ "$input" != "y" ] && [ "$input" != "yes" ]; then
+    if [ "$input" != "y" ] && [ "$input" != "yes" ] && [ "$input" != "ㅛ" ]; then
         if [ "$LANGUAGE" = "en" ]; then
             echo "Canceled."
         else
@@ -273,13 +337,13 @@ if [ $# -eq 0 ]; then
         echo "Entity Server - Run Script"
         echo "=========================="
         echo ""
-        echo "Force configs/server.json environment and configs/database.json default group, then start compiled server binary."
+        echo "Adjust configs/server.json environment as needed, then start the compiled server binary."
         echo ""
         echo "Usage: $0 <mode>"
         echo ""
         echo "Modes:"
-        echo "  dev   environment=development, database.default=development, then run binary"
-        echo "  start environment=production, database.default=production, then run in background"
+        echo "  dev   environment=development, keep database.default, then run binary"
+        echo "  start environment=production, use database.default=production only in production, then run in background"
         echo "  stop  stop background server started by this script"
         echo "  status show server status"
         echo ""
@@ -292,13 +356,13 @@ if [ $# -eq 0 ]; then
         echo "Entity Server - 실행 스크립트"
         echo "==========================="
         echo ""
-        echo "configs/server.json의 environment와 configs/database.json의 default를 강제 설정하고 바이너리를 실행합니다."
+        echo "configs/server.json의 environment를 기준으로 필요한 경우에만 database.default를 조정한 뒤 바이너리를 실행합니다."
         echo ""
         echo "사용법: $0 <모드>"
         echo ""
         echo "모드:"
-        echo "  dev   environment=development, database.default=development 강제 후 바이너리 실행"
-        echo "  start environment=production, database.default=production 강제 후 백그라운드 실행"
+        echo "  dev   environment=development로 설정하고 database.default는 유지한 채 바이너리 실행"
+        echo "  start environment=production으로 설정하고 production일 때만 database.default=production으로 맞춘 뒤 백그라운드 실행"
         echo "  stop  run.sh로 백그라운드 실행한 서버 중지"
         echo "  status 서버 상태 조회"
         echo ""
@@ -357,17 +421,8 @@ case "$MODE" in
             exit 1
         fi
 
-        if ! grep -Eq '"development"[[:space:]]*:' "$DATABASE_CONFIG"; then
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ database group 'development' not found in configs/database.json"
-            else
-                echo "❌ configs/database.json에 'development' 그룹이 없습니다"
-            fi
-            exit 1
-        fi
-
         sed -E -i 's/("environment"[[:space:]]*:[[:space:]]*")[^"]+(")/\1development\2/' "$SERVER_CONFIG"
-        sed -E -i 's/("default"[[:space:]]*:[[:space:]]*")[^"]+(")/\1development\2/' "$DATABASE_CONFIG"
+        sync_database_default_for_environment "$LINENO" || exit 1
         "$SERVER_BIN"
         ;;
         
@@ -387,17 +442,8 @@ case "$MODE" in
             exit 1
         fi
 
-        if ! grep -Eq '"production"[[:space:]]*:' "$DATABASE_CONFIG"; then
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ database group 'production' not found in configs/database.json"
-            else
-                echo "❌ configs/database.json에 'production' 그룹이 없습니다"
-            fi
-            exit 1
-        fi
-
         sed -E -i 's/("environment"[[:space:]]*:[[:space:]]*")[^"]+(")/\1production\2/' "$SERVER_CONFIG"
-        sed -E -i 's/("default"[[:space:]]*:[[:space:]]*")[^"]+(")/\1production\2/' "$DATABASE_CONFIG"
+        sync_database_default_for_environment "$LINENO" || exit 1
 
         "$SERVER_BIN" banner
         nohup "$SERVER_BIN" >> "$STDOUT_LOG" 2>&1 &

package/template/scripts/sync.sh

@@ -7,6 +7,11 @@ PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 
 cd "$PROJECT_ROOT"
 
+ENTITY_CLI_BIN="$PROJECT_ROOT/bin/entity-cli"
+if [ ! -f "$ENTITY_CLI_BIN" ] && [ -f "$PROJECT_ROOT/entity-cli" ]; then
+    ENTITY_CLI_BIN="$PROJECT_ROOT/entity-cli"
+fi
+
 # Load language from .env
 if [ -f .env ]; then
     LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2)
@@ -70,11 +75,11 @@ if [ $# -eq 0 ]; then
 fi
 
 # Require prebuilt CLI binary
-if [ ! -f "$PROJECT_ROOT/bin/entity-cli" ]; then
+if [ ! -f "$ENTITY_CLI_BIN" ]; then
     if [ "$LANGUAGE" = "en" ]; then
-        echo "❌ bin/entity-cli not found"
+        echo "❌ entity-cli not found (bin/entity-cli or ./entity-cli)"
     else
-        echo "❌ bin/entity-cli 파일이 없습니다"
+        echo "❌ entity-cli 파일이 없습니다 (bin/entity-cli 또는 ./entity-cli)"
     fi
     exit 1
 fi
@@ -115,7 +120,7 @@ fi
 
 build_cmd() {
     local entity_name="$1"
-    local cmd=("$PROJECT_ROOT/bin/entity-cli" sync-index --entity="$entity_name")
+    local cmd=("$ENTITY_CLI_BIN" sync-index --entity="$entity_name")
     if [ "$APPLY_MODE" = "--apply" ]; then
         cmd+=(--apply)
     fi

package/template/configs/auth/oauth.json

@@ -1,40 +0,0 @@
-{
-    "_comment": "OAuth 2.0 설정 예시. 사용할 프로바이더만 남기고 실제 값으로 교체하세요.",
-    "enabled": false,
-
-    "state_secret": "${OAUTH_STATE_SECRET}",
-    "state_ttl_sec": 600,
-    "success_redirect_url": "/auth/callback",
-    "failure_redirect_url": "/auth/error",
-
-    "providers": {
-        "google": {
-            "client_id": "${GOOGLE_CLIENT_ID}",
-            "client_secret": "${GOOGLE_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/google/callback",
-            "scopes": ["openid", "email", "profile"]
-        },
-        "github": {
-            "client_id": "${GITHUB_CLIENT_ID}",
-            "client_secret": "${GITHUB_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/github/callback"
-        },
-        "naver": {
-            "client_id": "${NAVER_CLIENT_ID}",
-            "client_secret": "${NAVER_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/naver/callback"
-        },
-        "kakao": {
-            "_comment": "Kakao — 커스텀 엔드포인트 예시",
-            "client_id": "${KAKAO_CLIENT_ID}",
-            "client_secret": "${KAKAO_CLIENT_SECRET}",
-            "redirect_url": "/v1/oauth/kakao/callback",
-            "auth_url": "https://kauth.kakao.com/oauth/authorize",
-            "token_url": "https://kauth.kakao.com/oauth/token",
-            "user_info_url": "https://kapi.kakao.com/v2/user/me",
-            "scopes": ["profile_nickname", "account_email"],
-            "email_field": "kakao_account.email",
-            "name_field": "properties.nickname"
-        }
-    }
-}

package/template/configs/auth/password.json

@@ -1,45 +0,0 @@
-{
-    "password_policy": {
-        "min_length": 8,
-        "max_length": 128,
-        "require_mixed_case": false,
-        "require_number": false,
-        "require_special": false,
-        "history_count": 5,
-        "forbidden_patterns": {
-            "sequential_digits": true,
-            "repeated_chars": true,
-            "keyboard_patterns": false,
-            "sequential_length": 4
-        },
-        "pii_check": {
-            "enabled": false,
-            "entity": "user",
-            "fields": ["phone", "birthday"]
-        }
-    },
-    "admin_force_reset": {
-        "temp_password_length": 12,
-        "require_change": true,
-        "notify_email": true
-    },
-    "password_reset": {
-        "enabled": true,
-        "temp_password_ttl_sec": 300,
-        "temp_password_length": 12,
-        "rate_limit": {
-            "per_email_per_hour": 5,
-            "per_ip_per_minute": 10
-        }
-    },
-    "email_verification": {
-        "enabled": true,
-        "required": false,
-        "code_length": 6,
-        "code_ttl_sec": 300,
-        "max_attempts": 5,
-        "rate_limit": {
-            "per_email_per_hour": 5
-        }
-    }
-}

package/template/configs/keys/apns.p8.example

@@ -1,7 +0,0 @@
------BEGIN PRIVATE KEY-----
-(샘플) Apple Developer Console → Certificates, Identifiers & Profiles
-→ Keys → "+" 버튼으로 APNs 키 생성 후 다운로드한 .p8 파일 내용을 여기에 붙여넣으세요.
-
-실제 키는 아래와 같은 형식입니다:
-MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQg...
------END PRIVATE KEY-----

package/template/configs/keys/firebase.pem.example

@@ -1,7 +0,0 @@
------BEGIN PRIVATE KEY-----
-(샘플) Firebase Console → 프로젝트 설정 → 서비스 계정 → 새 비공개 키 생성
-으로 다운로드한 JSON 파일의 private_key 값을 여기에 붙여넣으세요.
-
-실제 키는 아래와 같은 형식입니다:
-MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQC...
------END PRIVATE KEY-----

package/template/configs/notification/push.json

@@ -1,25 +0,0 @@
-{
-    "workers": 2,
-    "queue_size": 500,
-    "fcm": {
-        "enabled": false,
-        "type": "service_account",
-        "project_id": "your-firebase-project-id",
-        "private_key_id": "abc123def456...",
-        "private_key_file": "./configs/keys/firebase.pem",
-        "client_email": "firebase-adminsdk-xxxxx@your-firebase-project-id.iam.gserviceaccount.com",
-        "client_id": "123456789012345678901",
-        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
-        "token_uri": "https://oauth2.googleapis.com/token",
-        "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
-        "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-xxxxx%40your-firebase-project-id.iam.gserviceaccount.com"
-    },
-    "apns": {
-        "enabled": false,
-        "key_file": "./configs/keys/apns.p8",
-        "key_id": "ABCDE12345",
-        "team_id": "FGHIJ67890",
-        "bundle_id": "com.example.myapp",
-        "production": false
-    }
-}

package/template/entities/System/Auth/account_oauth.json

@@ -1,74 +0,0 @@
-{
-    "name": "account_oauth",
-    "description": "소셜 로그인 OAuth 프로바이더 연동 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "history": false,
-    "hard_delete": true,
-    "fields": {
-        "account_seq": {
-            "index": true,
-            "required": true,
-            "comment": "계정 seq"
-        },
-        "provider": {
-            "index": true,
-            "type": [
-                "google",
-                "github",
-                "naver",
-                "kakao",
-                "apple"
-            ],
-            "required": true
-        },
-        "provider_id": {
-            "index": true,
-            "type": "string",
-            "required": true,
-            "comment": "프로바이더 고유 사용자 ID"
-        },
-        "status": {
-            "index": true,
-            "type": [
-                "active",
-                "unlinked"
-            ],
-            "default": "active"
-        },
-        "email": {
-            "type": "email",
-            "comment": "프로바이더에서 제공한 이메일"
-        },
-        "name": {
-            "type": "string",
-            "comment": "프로바이더에서 제공한 이름"
-        },
-        "profile_image": {
-            "type": "string",
-            "comment": "프로필 이미지 URL"
-        },
-        "access_token": {
-            "type": "string",
-            "comment": "OAuth access token (암호화 저장)"
-        },
-        "refresh_token": {
-            "type": "string",
-            "comment": "OAuth refresh token (암호화 저장)"
-        },
-        "token_expires_at": {
-            "type": "string",
-            "comment": "access token 만료 시각 (RFC3339)"
-        },
-        "raw": {
-            "type": "json",
-            "comment": "프로바이더 원본 응답 (디버깅용)"
-        },
-        "linked_at": {
-            "type": "string",
-            "comment": "연결 시각"
-        },
-        "unlinked_at": {
-            "type": "string",
-            "comment": "연결 해제 시각"
-        }
-    }
-}

package/template/entities/System/Auth/identity_verification.json

@@ -1,106 +0,0 @@
-{
-    "name": "identity_verification",
-    "description": "휴대폰 본인인증 요청 및 결과 저장. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "history": false,
-    "hard_delete": false,
-    "compress": true,
-    "fields": {
-        "request_id": {
-            "index": true,
-            "type": "string",
-            "required": true,
-            "unique": true,
-            "comment": "인증 요청 고유 ID (32바이트 hex)"
-        },
-        "status": {
-            "index": true,
-            "type": [
-                "pending",
-                "verified",
-                "failed",
-                "expired"
-            ],
-            "default": "pending"
-        },
-        "purpose": {
-            "index": true,
-            "type": [
-                "signup",
-                "find_account",
-                "password_reset",
-                "adult_verify",
-                "identity_change"
-            ],
-            "required": true
-        },
-        "provider": {
-            "index": true,
-            "type": [
-                "nice",
-                "kmc",
-                "danal"
-            ],
-            "required": true
-        },
-        "ci_hash": {
-            "type": "string",
-            "comment": "CI의 SHA-256 해시 (중복 조회용)"
-        },
-        "di": {
-            "type": "string",
-            "comment": "DI 원문 (암호화 저장)"
-        },
-        "name": {
-            "type": "string",
-            "comment": "인증된 실명"
-        },
-        "birth_date": {
-            "type": "string",
-            "comment": "생년월일 (YYYYMMDD)"
-        },
-        "gender": {
-            "type": "string",
-            "comment": "성별 (M/F)"
-        },
-        "carrier": {
-            "type": "string",
-            "comment": "통신사 코드"
-        },
-        "phone": {
-            "type": "string",
-            "comment": "인증 휴대폰 번호"
-        },
-        "nationality": {
-            "type": "string",
-            "comment": "내/외국인 (local/foreign)"
-        },
-        "account_seq": {
-            "type": "int",
-            "comment": "연결된 계정 seq (인증 완료 후 설정)"
-        },
-        "ip_address": {
-            "type": "string",
-            "comment": "요청 IP 주소"
-        },
-        "user_agent": {
-            "type": "string",
-            "comment": "요청 User-Agent"
-        },
-        "verified_at": {
-            "type": "string",
-            "comment": "인증 완료 시각 (RFC3339)"
-        },
-        "expires_at": {
-            "type": "string",
-            "comment": "요청 만료 시각 (RFC3339)"
-        },
-        "error_message": {
-            "type": "string",
-            "comment": "실패 시 에러 메시지"
-        },
-        "raw_response": {
-            "type": "json",
-            "comment": "중계사 원본 응답 (디버깅용, 암호화)"
-        }
-    }
-}

package/template/entities/System/Auth/password_history.json

@@ -1,19 +0,0 @@
-{
-    "name": "password_history",
-    "description": "비밀번호 변경 이력 (재사용 금지 정책용) 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "hard_delete": true,
-    "fields": {
-        "account_seq": {
-            "index": true,
-            "comment": "계정 seq",
-            "type": "integer",
-            "required": true
-        },
-        "passwd_hash": {
-            "comment": "변경 시점의 비밀번호 해시 (salt 포함)"
-        },
-        "changed_time": {
-            "comment": "비밀번호 변경 시각"
-        }
-    }
-}

package/template/entities/System/Notification/alimtalk_log.json

@@ -1,65 +0,0 @@
-{
-    "name": "alimtalk_log",
-    "description": "알림톡 발송 로그 — 워커가 소비하는 DB 큐 역할을 합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "history": false,
-    "read_only": true,
-    "compress": true,
-    "fields": {
-        "status": {
-            "index": true,
-            "type": [
-                "pending",
-                "processing",
-                "sent",
-                "delivered",
-                "failed",
-                "expired"
-            ],
-            "default": "pending",
-            "comment": "발송 상태 (delivered = 프로바이더 수신 확인)"
-        },
-        "template_code": {
-            "index": true,
-            "comment": "카카오 알림톡 템플릿 코드",
-            "required": true
-        },
-        "receiver": {
-            "index": true,
-            "hash": true,
-            "comment": "수신자 전화번호",
-            "required": true
-        },
-        "alimtalk_msg_seq": {
-            "index": true,
-            "comment": "alimtalk_msg 참조 seq"
-        },
-        "template_name": {
-            "comment": "내부 템플릿 이름"
-        },
-        "variables_json": {
-            "type": "text",
-            "comment": "템플릿 변수 JSON"
-        },
-        "provider": {
-            "comment": "사용 프로바이더"
-        },
-        "provider_msg_id": {
-            "comment": "프로바이더 메시지 ID"
-        },
-        "error_message": {
-            "type": "text",
-            "comment": "오류 메시지"
-        },
-        "retry_count": {
-            "type": "uint",
-            "default": 0
-        },
-        "sent_at": {
-            "type": "string"
-        },
-        "delivered_at": {
-            "type": "string",
-            "comment": "프로바이더 수신 확인 시각"
-        }
-    }
-}

package/template/entities/System/Notification/alimtalk_msg.json

@@ -1,53 +0,0 @@
-{
-    "name": "alimtalk_msg",
-    "description": "알림톡 발송 트리거 엔티티 — Hook 또는 API를 통해 생성되면 알림톡 발송이 시작됩니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
-    "history": false,
-    "fields": {
-        "template_code": {
-            "index": true,
-            "comment": "카카오 알림톡 템플릿 코드",
-            "required": true
-        },
-        "receiver": {
-            "index": true,
-            "hash": true,
-            "comment": "수신자 전화번호",
-            "required": true
-        },
-        "status": {
-            "index": true,
-            "type": [
-                "pending",
-                "processing",
-                "sent",
-                "delivered",
-                "failed"
-            ],
-            "default": "pending",
-            "comment": "발송 상태 (delivered = 프로바이더 수신 확인)"
-        },
-        "variables_json": {
-            "type": "text",
-            "comment": "템플릿 변수 JSON (#{key} 바인딩)"
-        },
-        "provider": {
-            "comment": "프로바이더 키 (빈 값이면 default)"
-        },
-        "ref_entity": {
-            "comment": "참조 엔티티 이름"
-        },
-        "ref_seq": {
-            "type": "int"
-        }
-    },
-    "hooks": {
-        "after_insert": [
-            {
-                "type": "alimtalk",
-                "alimtalk_receiver": "${new.receiver}",
-                "alimtalk_template_code": "${new.template_code}",
-                "alimtalk_variables": "${new.variables_json}"
-            }
-        ]
-    }
-}