create-entity-server 0.0.31 → 0.2.2

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

@@ -22,10 +22,6 @@
             "type": ["active", "inactive", "blocked", "dormant"],
             "default": "active"
         },
-        "user_seq": {
-            "index": true,
-            "comment": "사용자번호"
-        },
         "max_session_cnt": {
             "type": "uint"
         },
@@ -50,26 +46,6 @@
             "type": "bool",
             "default": false,
             "comment": "다음 로그인 시 비밀번호 변경 강제"
-        },
-        "name": {
-            "no_store": true,
-            "comment": "가입 요청 시 전달되는 이름. account에는 저장되지 않고 after_insert 훅(user 엔티티 생성 등)에서만 사용됩니다."
-        },
-        "phone": {
-            "no_store": true,
-            "comment": "가입 요청 시 전달되는 전화번호. no_store."
-        },
-        "birth_date": {
-            "no_store": true,
-            "comment": "가입 요청 시 전달되는 생년월일. no_store."
-        },
-        "gender": {
-            "no_store": true,
-            "comment": "가입 요청 시 전달되는 성별. no_store."
-        },
-        "profile_image": {
-            "no_store": true,
-            "comment": "가입 요청 시 전달되는 프로필 이미지. no_store."
         }
     },
     "reset_defaults": [
@@ -129,21 +105,6 @@
                 "query": "INSERT INTO account_audit (account_seq, action, email, created_time) VALUES (?, ?, ?, NOW())",
                 "params": ["${new.seq}", "INSERT", "${new.email}"],
                 "required": true
-            },
-            {
-                "_comment": "가입 시 user 엔티티 자동 생성. enabled: true로 바꾸면 활성화됩니다. assign_seq_to로 account.user_seq에 자동 반영됩니다.",
-                "type": "submit",
-                "enabled": false,
-                "entity": "user",
-                "data": {
-                    "account_seq": "${new.seq}",
-                    "name": "${new.name}",
-                    "phone": "${new.phone}",
-                    "birth_date": "${new.birth_date}",
-                    "gender": "${new.gender}",
-                    "profile_image": "${new.profile_image}"
-                },
-                "assign_seq_to": "user_seq"
             }
         ],
         "after_update": [
@@ -152,22 +113,6 @@
                 "query": "INSERT INTO account_audit (account_seq, action, email, created_time) VALUES (?, ?, ?, NOW())",
                 "params": ["${new.seq}", "UPDATE", "${new.email}"],
                 "required": true
-            },
-            {
-                "_comment": "계정 업데이트 시 user 프로필 동기화. enabled: true로 바꾸면 활성화됩니다.",
-                "type": "submit",
-                "enabled": false,
-                "entity": "user",
-                "match": {
-                    "account_seq": "${new.seq}"
-                },
-                "data": {
-                    "name": "${new.name}",
-                    "phone": "${new.phone}",
-                    "birth_date": "${new.birth_date}",
-                    "gender": "${new.gender}",
-                    "profile_image": "${new.profile_image}"
-                }
             }
         ],
         "after_delete": [
@@ -179,15 +124,6 @@
             }
         ],
         "after_get": [
-            {
-                "type": "entity",
-                "entity": "user",
-                "action": "find",
-                "conditions": {
-                    "seq": "${new.user_seq}"
-                },
-                "assign_to": "user_profile"
-            },
             {
                 "type": "entity",
                 "entity": "account_device",

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

@@ -1,11 +1,12 @@
 {
     "name": "account_device",
-    "description": "계정 기기 정보 및 푸시 토큰 관리. JWT 인증 시 account_seq로 계정과 연결. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "description": "회원 계정 기기 정보 및 푸시 토큰 관리. account_seq로 계정과 연결되며 회원 전용으로 사용합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
     "license_scope": false,
     "fields": {
         "account_seq": {
             "index": true,
-            "comment": "계정seq (JWT 인증 시 필수. HMAC 인증은 nullable)"
+            "required": true,
+            "comment": "계정seq (회원 계정 필수)"
         },
         "id": {
             "index": true,
@@ -19,24 +20,12 @@
         },
         "device_type": {
             "comment": "기기유형",
-            "type": [
-                "mobile",
-                "tablet",
-                "desktop",
-                "watch"
-            ],
+            "type": ["mobile", "tablet", "desktop", "watch"],
             "default": "mobile"
         },
         "platform": {
             "comment": "플랫폼",
-            "type": [
-                "android",
-                "ios",
-                "web",
-                "windows",
-                "macos",
-                "linux"
-            ]
+            "type": ["android", "ios", "web", "windows", "macos", "linux"]
         },
         "browser": {
             "comment": "브라우저"
@@ -55,10 +44,6 @@
             "comment": "마지막IP주소"
         }
     },
-    "unique": [
-        [
-            "id",
-            "account_seq"
-        ]
-    ]
+    "unique": [["id", "account_seq"]],
+    "history": false
 }

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

@@ -41,19 +41,14 @@
         "language": {
             "comment": "언어"
         },
-        "user_seq": {
+        "account_seq": {
             "index": true,
-            "comment": "사용자번호"
+            "comment": "계정번호"
         },
         "auth_method": {
             "index": true,
             "comment": "인증 방식",
-            "type": [
-                "password",
-                "oauth",
-                "2fa_totp",
-                "2fa_recovery"
-            ],
+            "type": ["password", "oauth", "2fa_totp", "2fa_recovery"],
             "default": "password"
         },
         "location_info": {

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

@@ -0,0 +1,56 @@
+{
+    "name": "anon_device",
+    "description": "비회원 디바이스 식별 및 사용 제한 집계. device_id 쿠키 값 기반으로 추적하며 익명 사용자 전용으로 사용합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "fields": {
+        "id": {
+            "index": true,
+            "required": true,
+            "unique": true,
+            "comment": "익명 디바이스 ID (cookie/device_id)"
+        },
+        "calc_count": {
+            "index": true,
+            "type": "uint",
+            "default": 0,
+            "comment": "거리 계산 사용 횟수"
+        },
+        "first_seen_time": {
+            "comment": "최초 식별 시각"
+        },
+        "last_seen_time": {
+            "index": true,
+            "comment": "마지막 식별 시각"
+        },
+        "last_calc_time": {
+            "index": true,
+            "comment": "마지막 거리 계산 시각"
+        },
+        "blocked_until_time": {
+            "index": true,
+            "comment": "차단 해제 시각"
+        },
+        "last_ip_addr": {
+            "comment": "마지막 IP주소"
+        },
+        "device_type": {
+            "comment": "기기유형",
+            "type": ["mobile", "tablet", "desktop", "watch"],
+            "default": "mobile"
+        },
+        "platform": {
+            "comment": "플랫폼",
+            "type": ["android", "ios", "web", "windows", "macos", "linux"]
+        },
+        "browser": {
+            "comment": "브라우저"
+        },
+        "browser_version": {
+            "comment": "브라우저버전"
+        },
+        "user_agent": {
+            "comment": "User Agent"
+        }
+    },
+    "history": false
+}

package/template/scripts/reset-all.sh

@@ -25,6 +25,75 @@ if [ -f .env ]; then
 fi
 LANGUAGE=${LANGUAGE:-ko}
 
+get_env_value() {
+    local key="$1"
+    local value="${!key}"
+
+    if [ -n "$value" ]; then
+        echo "$value"
+        return
+    fi
+
+    if [ -f .env ]; then
+        value=$(grep -E "^${key}=" .env | tail -n 1 | cut -d '=' -f2-)
+        echo "$value"
+    fi
+}
+
+get_database_default_group() {
+    grep -E '"default"[[:space:]]*:' "$PROJECT_ROOT/configs/database.json" \
+        | head -n 1 \
+        | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/'
+}
+
+get_database_group_field() {
+    local group="$1"
+    local field="$2"
+
+    awk -v group="$group" -v field="$field" '
+        $0 ~ "^[[:space:]]*\"" group "\"[[:space:]]*:[[:space:]]*\\{" { in_group=1; next }
+        in_group && $0 ~ "^[[:space:]]*}" { exit }
+        in_group && $0 ~ "^[[:space:]]*\"" field "\"[[:space:]]*:" {
+            match($0, /"[^"]+"[[:space:]]*:[[:space:]]*"([^"]+)"/, arr)
+            if (arr[1] != "") {
+                print arr[1]
+            }
+            exit
+        }
+    ' "$PROJECT_ROOT/configs/database.json"
+}
+
+resolve_database_name() {
+    local group="$1"
+    local raw_value
+    raw_value=$(get_database_group_field "$group" "database")
+
+    if [[ "$raw_value" =~ ^\$\{([A-Z0-9_]+)\}$ ]]; then
+        get_env_value "${BASH_REMATCH[1]}"
+        return
+    fi
+
+    echo "$raw_value"
+}
+
+print_target_database() {
+    local group
+    local database_name
+
+    group=$(get_database_default_group)
+    database_name=$(resolve_database_name "$group")
+
+    echo ""
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "Target database group: ${group:-<unknown>}"
+        echo "Target database name : ${database_name:-<unknown>}"
+    else
+        echo "대상 DB 그룹 : ${group:-<unknown>}"
+        echo "대상 DB 이름 : ${database_name:-<unknown>}"
+    fi
+    echo ""
+}
+
 # Show usage if no arguments
 if [ $# -eq 0 ]; then
     if [ "$LANGUAGE" = "en" ]; then
@@ -78,9 +147,11 @@ fi
 # Execute based on flag
 case "$1" in
     --dry-run)
+        print_target_database
         "$PROJECT_ROOT/bin/entity-cli" reset-all
         ;;
     --force|--apply)
+        print_target_database
         # 필수 엔티티 없으면 자동 생성 (api_keys, rbac_roles, account, user)
         if [ "$LANGUAGE" = "en" ]; then
             echo "⚙️  Checking required entities..."
@@ -88,6 +159,7 @@ case "$1" in
             echo "⚙️  필수 엔티티 확인 중..."
         fi
         LANGUAGE="$LANGUAGE" "$SCRIPT_DIR/normalize-entities.sh" --apply
+
         RESET_LOG=$(mktemp)
         if [ "$1" = "--force" ]; then
             set +e
@@ -123,15 +195,16 @@ case "$1" in
             echo "   ENTITY_API_KEY    = $NEW_API_KEY"
             echo "   ENTITY_HMAC_SECRET = $NEW_HMAC"
 
-            # 게이트웨이 .env 자동 업데이트 (같은 저장소 내에 있는 경우)
-            GW_ENV="$PROJECT_ROOT/packages/entity-app-server/.env"
-            if [ -f "$GW_ENV" ]; then
+            # 게이트웨이 .env 자동 업데이트 (개발 환경: entity-app-server/ 폴더가 같은 레벨에 있을 때만)
+            GW_DIR="$(dirname "$PROJECT_ROOT")/entity-app-server"
+            GW_ENV="$GW_DIR/.env"
+            if [ -d "$GW_DIR" ] && [ -f "$GW_ENV" ]; then
                 sed -i "s|^ENTITY_API_KEY=.*|ENTITY_API_KEY=$NEW_API_KEY|" "$GW_ENV"
                 sed -i "s|^ENTITY_HMAC_SECRET=.*|ENTITY_HMAC_SECRET=$NEW_HMAC|" "$GW_ENV"
                 if [ "$LANGUAGE" = "en" ]; then
-                    echo "   ✓ Updated: packages/entity-app-server/.env"
+                    echo "   ✓ Updated: entity-app-server/.env"
                 else
-                    echo "   ✓ 업데이트 완료: packages/entity-app-server/.env"
+                    echo "   ✓ 업데이트 완료: entity-app-server/.env"
                 fi
             fi
         fi

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/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
-    }
-}