create-entity-server 0.0.26 → 0.0.31

package/template/scripts/reset-all.sh

@@ -1,15 +1,27 @@
 #!/bin/bash
 
+set -e
+set -o pipefail
+
 # Reset all entity tables and seed default data
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+RESET_LOG=""
+
+cleanup() {
+    if [ -n "$RESET_LOG" ] && [ -f "$RESET_LOG" ]; then
+        rm -f "$RESET_LOG"
+    fi
+}
+
+trap cleanup EXIT
 
 cd "$PROJECT_ROOT"
 
 # Load language from .env
 if [ -f .env ]; then
-    LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2)
+    LANGUAGE=$(grep '^LANGUAGE=' .env | cut -d '=' -f2 || true)
 fi
 LANGUAGE=${LANGUAGE:-ko}
 
@@ -76,10 +88,52 @@ case "$1" in
             echo "⚙️  필수 엔티티 확인 중..."
         fi
         LANGUAGE="$LANGUAGE" "$SCRIPT_DIR/normalize-entities.sh" --apply
+        RESET_LOG=$(mktemp)
         if [ "$1" = "--force" ]; then
-            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply --force
+            set +e
+            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply --force 2>&1 | tee "$RESET_LOG"
+            RESET_STATUS=${PIPESTATUS[0]}
+            set -e
         else
-            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply
+            set +e
+            "$PROJECT_ROOT/bin/entity-cli" reset-all --apply 2>&1 | tee "$RESET_LOG"
+            RESET_STATUS=${PIPESTATUS[0]}
+            set -e
+        fi
+
+        if [ "$RESET_STATUS" -ne 0 ]; then
+            exit "$RESET_STATUS"
+        fi
+
+        if ! grep -q "Reset completed successfully!" "$RESET_LOG"; then
+            exit 0
+        fi
+
+        # 새로 생성된 API 키 조회 후 .env 업데이트
+        NEW_API_KEY=$("$PROJECT_ROOT/bin/entity-cli" api-key show --seq=1 --reveal-secret 2>/dev/null | grep -E '^key_value' | awk '{print $NF}')
+        NEW_HMAC=$("$PROJECT_ROOT/bin/entity-cli" api-key show --seq=1 --reveal-secret 2>/dev/null | grep -E '^hmac_secret' | awk '{print $NF}')
+
+        if [ -n "$NEW_API_KEY" ] && [ -n "$NEW_HMAC" ]; then
+            echo ""
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "🔑 New API Key generated:"
+            else
+                echo "🔑 새 API 키가 생성되었습니다:"
+            fi
+            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
+                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"
+                else
+                    echo "   ✓ 업데이트 완료: packages/entity-app-server/.env"
+                fi
+            fi
         fi
         ;;
     *)

package/template/scripts/run.sh

@@ -62,6 +62,9 @@ is_running() {
         if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
             return 0
         fi
+        if is_port_in_use; then
+            return 0
+        fi
         return 1
     fi
     local pid
@@ -70,6 +73,9 @@ is_running() {
         if [ -n "$port_pid" ] && kill -0 "$port_pid" 2>/dev/null; then
             return 0
         fi
+        if is_port_in_use; then
+            return 0
+        fi
         return 1
     fi
     if kill -0 "$pid" 2>/dev/null; then
@@ -80,6 +86,10 @@ is_running() {
         return 0
     fi
 
+    if is_port_in_use; then
+        return 0
+    fi
+
     return 1
 }
 
@@ -89,6 +99,26 @@ find_pid_by_port() {
     ss -ltnp 2>/dev/null | grep ":$port " | sed -n 's/.*pid=\([0-9]\+\).*/\1/p' | head -n 1
 }
 
+is_port_in_use() {
+    local port
+    port=$(get_server_value "port" "3400")
+    ss -ltn 2>/dev/null | grep -q ":$port "
+}
+
+show_port_in_use_message() {
+    local port
+    port=$(get_server_value "port" "3400")
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "❌ Port $port is already in use, but the owning PID could not be identified."
+        echo "Check with: ss -ltnp | grep :$port"
+        echo "Or: lsof -iTCP:$port -sTCP:LISTEN -n -P"
+    else
+        echo "❌ 포트 $port 가 이미 사용 중이지만, 점유 PID를 식별할 수 없습니다."
+        echo "확인: ss -ltnp | grep :$port"
+        echo "또는: lsof -iTCP:$port -sTCP:LISTEN -n -P"
+    fi
+}
+
 stop_pid_with_confirm() {
     local pid="$1"
     local reason="$2"
@@ -157,6 +187,10 @@ stop_server() {
             stop_pid_with_confirm "$port_pid" "port fallback"
             return $?
         fi
+        if is_port_in_use; then
+            show_port_in_use_message
+            return 1
+        fi
         if [ "$LANGUAGE" = "en" ]; then
             echo "ℹ️  Server is not running (pid file not found)."
         else
@@ -191,6 +225,10 @@ stop_server() {
             stop_pid_with_confirm "$port_pid" "port fallback"
             return $?
         fi
+        if is_port_in_use; then
+            show_port_in_use_message
+            return 1
+        fi
         if [ "$LANGUAGE" = "en" ]; then
             echo "ℹ️  Stale pid file removed (process not found)."
         else
@@ -305,10 +343,16 @@ fi
 case "$MODE" in
     dev|development)
         if is_running; then
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ Server already running (pid: $(cat "$PID_FILE")). Stop first: ./run.sh stop"
+            local running_pid
+            running_pid=$(find_pid_by_port)
+            if [ -n "$running_pid" ]; then
+                if [ "$LANGUAGE" = "en" ]; then
+                    echo "❌ Server already running (pid: $running_pid). Stop first: ./run.sh stop"
+                else
+                    echo "❌ 이미 서버가 실행 중입니다 (pid: $running_pid). 먼저 중지하세요: ./run.sh stop"
+                fi
             else
-                echo "❌ 이미 서버가 실행 중입니다 (pid: $(cat "$PID_FILE")). 먼저 중지하세요: ./run.sh stop"
+                show_port_in_use_message
             fi
             exit 1
         fi
@@ -329,10 +373,16 @@ case "$MODE" in
         
     start)
         if is_running; then
-            if [ "$LANGUAGE" = "en" ]; then
-                echo "❌ Server already running (pid: $(cat "$PID_FILE")). Stop first: ./run.sh stop"
+            local running_pid
+            running_pid=$(find_pid_by_port)
+            if [ -n "$running_pid" ]; then
+                if [ "$LANGUAGE" = "en" ]; then
+                    echo "❌ Server already running (pid: $running_pid). Stop first: ./run.sh stop"
+                else
+                    echo "❌ 이미 서버가 실행 중입니다 (pid: $running_pid). 먼저 중지하세요: ./run.sh stop"
+                fi
             else
-                echo "❌ 이미 서버가 실행 중입니다 (pid: $(cat "$PID_FILE")). 먼저 중지하세요: ./run.sh stop"
+                show_port_in_use_message
             fi
             exit 1
         fi

package/template/templates/email/auth/2fa_disabled.html

@@ -0,0 +1,23 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">2단계 인증이 비활성화되었습니다</h2>
+<p style="margin: 0 0 16px; font-size: 15px; color: #555; line-height: 1.6;">
+    <strong>${email}</strong> 계정의 2단계 인증(TOTP)이 해제되었습니다.<br>
+    앞으로 이메일과 비밀번호만으로 로그인됩니다.
+</p>
+
+<div style="margin: 0 0 24px; padding: 20px; background-color: #f8d7da; border-radius: 8px; border-left: 4px solid #dc3545;">
+    <p style="margin: 0; font-size: 14px; color: #721c24; line-height: 1.6;">
+        <strong>보안 알림:</strong> 2단계 인증이 해제되면 계정 보안 수준이 낮아집니다.<br>
+        가능하면 다시 2단계 인증을 설정하는 것을 권장합니다.
+    </p>
+</div>
+
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    해제 시각: ${disabled_time}
+</p>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    해제 방법: ${disabled_by|본인 요청}
+</p>
+
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 해제하지 않은 경우, 즉시 비밀번호를 변경하고 관리자에게 문의하세요.
+</p>

package/template/templates/email/auth/2fa_recovery_regenerated.html

@@ -0,0 +1,31 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">복구 코드가 재생성되었습니다</h2>
+<p style="margin: 0 0 16px; font-size: 15px; color: #555; line-height: 1.6;">
+    <strong>${email}</strong> 계정의 2단계 인증 복구 코드가 새로 생성되었습니다.<br>
+    이전 복구 코드는 모두 <strong>폐기</strong>되었습니다.
+</p>
+
+<div style="margin: 0 0 24px; padding: 20px; background-color: #fff3cd; border-radius: 8px; border-left: 4px solid #ffc107;">
+    <p style="margin: 0 0 8px; font-size: 14px; font-weight: 700; color: #856404;">⚠ 새 복구 코드를 안전한 곳에 저장하세요</p>
+    <p style="margin: 0; font-size: 13px; color: #856404; line-height: 1.5;">
+        각 코드는 <strong>한 번만</strong> 사용할 수 있으며, 이 이메일 이후에는 다시 확인할 수 없습니다.
+    </p>
+</div>
+
+<div style="text-align: center; margin: 0 0 24px;">
+    <table role="presentation" cellpadding="0" cellspacing="0" style="margin: 0 auto;">
+        <tr>
+            <td style="padding: 16px 32px; background-color: #f0f0f5; border-radius: 8px;">
+                <pre style="margin: 0; font-size: 18px; font-weight: 700; color: #1a1a2e; font-family: 'Courier New', monospace; letter-spacing: 2px; line-height: 2;">${recovery_codes}</pre>
+            </td>
+        </tr>
+    </table>
+</div>
+
+<p style="margin: 0 0 16px; font-size: 14px; color: #888; line-height: 1.6;">
+    새 복구 코드: <strong>${recovery_count|10}개</strong><br>
+    재생성 시각: ${regenerated_time}
+</p>
+
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우, 계정이 보안 위협에 노출되었을 수 있습니다. 즉시 비밀번호를 변경하고 관리자에게 문의하세요.
+</p>

package/template/templates/email/auth/2fa_setup_complete.html

@@ -0,0 +1,43 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">2단계 인증이 활성화되었습니다</h2>
+<p style="margin: 0 0 16px; font-size: 15px; color: #555; line-height: 1.6;">
+    <strong>${email}</strong> 계정에 2단계 인증(TOTP)이 설정되었습니다.<br>
+    앞으로 로그인 시 Authenticator 앱의 인증 코드가 필요합니다.
+</p>
+
+<div style="margin: 0 0 24px; padding: 20px; background-color: #fff3cd; border-radius: 8px; border-left: 4px solid #ffc107;">
+    <p style="margin: 0 0 8px; font-size: 14px; font-weight: 700; color: #856404;">⚠ 복구 코드를 안전한 곳에 저장하세요</p>
+    <p style="margin: 0 0 12px; font-size: 13px; color: #856404; line-height: 1.5;">
+        Authenticator 앱에 접근할 수 없는 경우 아래 복구 코드로 로그인할 수 있습니다.<br>
+        각 코드는 <strong>한 번만</strong> 사용할 수 있으며, 이 이메일 이후에는 다시 확인할 수 없습니다.
+    </p>
+</div>
+
+<div style="text-align: center; margin: 0 0 24px;">
+    <table role="presentation" cellpadding="0" cellspacing="0" style="margin: 0 auto;">
+        <tr>
+            <td style="padding: 16px 32px; background-color: #f0f0f5; border-radius: 8px;">
+                <pre style="margin: 0; font-size: 18px; font-weight: 700; color: #1a1a2e; font-family: 'Courier New', monospace; letter-spacing: 2px; line-height: 2;">${recovery_codes}</pre>
+            </td>
+        </tr>
+    </table>
+</div>
+
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    남은 복구 코드: <strong>${recovery_count|10}개</strong>
+</p>
+<p style="margin: 0 0 16px; font-size: 14px; color: #888; line-height: 1.6;">
+    설정 시각: ${enabled_time}
+</p>
+
+<div style="margin: 0 0 16px; padding: 16px; background-color: #f8f9fa; border-radius: 6px;">
+    <p style="margin: 0; font-size: 13px; color: #666; line-height: 1.6;">
+        💡 <strong>권장 사항</strong><br>
+        • 복구 코드를 출력하거나 비밀번호 관리자에 저장하세요<br>
+        • 복구 코드가 3개 이하로 줄면 재생성하세요<br>
+        • 본인이 설정하지 않았다면 즉시 비밀번호를 변경하세요
+    </p>
+</div>
+
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 설정하지 않은 경우, 계정이 보안 위협에 노출되었을 수 있습니다. 즉시 비밀번호를 변경하고 관리자에게 문의하세요.
+</p>

package/template/templates/email/auth/welcome.html

@@ -0,0 +1,18 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">환영합니다, ${name|회원}님!</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    회원가입이 완료되었습니다. ${app_name|서비스}를 이용해 주셔서 감사합니다.
+</p>
+<div style="text-align: center; margin: 0 0 24px;">
+    <a href="${login_url|#}" style="display: inline-block; padding: 14px 36px; background-color: #1a1a2e; color: #ffffff; text-decoration: none; border-radius: 6px; font-size: 15px; font-weight: 600;">시작하기</a>
+</div>
+<div style="padding: 20px; background-color: #f8f8fa; border-radius: 6px; margin: 0 0 24px;">
+    <p style="margin: 0 0 8px; font-size: 14px; font-weight: 600; color: #1a1a2e;">계정 정보</p>
+    <p style="margin: 0; font-size: 14px; color: #555; line-height: 1.8;">
+        이메일: ${email|user@example.com}<br>
+        아이디: ${account_id|user001}<br>
+        가입일: ${created_at|오늘}
+    </p>
+</div>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    궁금한 점이 있으시면 언제든 문의해 주세요.
+</p>

package/template/templates/email/backup/backup_completed.html

@@ -0,0 +1,35 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #27ae60;">✅ 백업 완료</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    데이터 백업이 정상적으로 완료되었습니다.
+</p>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin: 0 0 24px;">
+    <tr>
+        <td style="padding: 16px 20px; background-color: #eafaf1; border-radius: 6px; border-left: 4px solid #27ae60;">
+            <table role="presentation" width="100%" cellpadding="0" cellspacing="0">
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">세션 ID</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${session_id|—}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">상태</td>
+                    <td style="padding: 4px 0; font-size: 14px; font-weight: 700; color: #27ae60;">완료</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">레코드 수</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${total_records|0}건</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">백업 크기</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${total_size|0 B}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">소요 시간</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${elapsed|—}</td>
+                </tr>
+            </table>
+        </td>
+    </tr>
+</table>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    이 알림은 백업 완료 시 자동 발송됩니다.
+</p>

package/template/templates/email/backup/backup_failed.html

@@ -0,0 +1,27 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #e74c3c;">❌ 백업 실패</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    데이터 백업에 실패했습니다. 오류 내용을 확인하고 조치해 주세요.
+</p>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin: 0 0 24px;">
+    <tr>
+        <td style="padding: 16px 20px; background-color: #fdedec; border-radius: 6px; border-left: 4px solid #e74c3c;">
+            <table role="presentation" width="100%" cellpadding="0" cellspacing="0">
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">세션 ID</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${session_id|—}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">상태</td>
+                    <td style="padding: 4px 0; font-size: 14px; font-weight: 700; color: #e74c3c;">실패</td>
+                </tr>
+            </table>
+        </td>
+    </tr>
+</table>
+<div style="margin: 0 0 24px;">
+    <p style="margin: 0 0 8px; font-size: 14px; font-weight: 600; color: #1a1a2e;">오류 내용</p>
+    <pre style="margin: 0; padding: 12px 16px; background-color: #f8f8fa; border-radius: 6px; font-size: 13px; color: #e74c3c; line-height: 1.6; white-space: pre-wrap; word-break: break-all;">${error_message|알 수 없는 오류}</pre>
+</div>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    이 알림은 백업 실패 시 자동 발송됩니다.
+</p>

package/template/templates/email/backup/backup_partial.html

@@ -0,0 +1,31 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #e67e22;">⚠️ 백업 부분 완료</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    백업이 완료되었으나 일부 엔티티에서 오류가 발생했습니다. 실패한 항목을 확인해 주세요.
+</p>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin: 0 0 24px;">
+    <tr>
+        <td style="padding: 16px 20px; background-color: #fef9e7; border-radius: 6px; border-left: 4px solid #e67e22;">
+            <table role="presentation" width="100%" cellpadding="0" cellspacing="0">
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">세션 ID</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${session_id|—}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">상태</td>
+                    <td style="padding: 4px 0; font-size: 14px; font-weight: 700; color: #e67e22;">부분 완료</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">레코드 수</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${total_records|0}건</td>
+                </tr>
+            </table>
+        </td>
+    </tr>
+</table>
+<div style="margin: 0 0 24px;">
+    <p style="margin: 0 0 8px; font-size: 14px; font-weight: 600; color: #1a1a2e;">실패한 엔티티</p>
+    <pre style="margin: 0; padding: 12px 16px; background-color: #f8f8fa; border-radius: 6px; font-size: 13px; color: #555; line-height: 1.6; white-space: pre-wrap; word-break: break-all;">${failed_entities|없음}</pre>
+</div>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    이 알림은 백업 결과에 오류가 포함되었을 때 자동 발송됩니다.
+</p>

package/template/templates/email/layout.html

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <!--[if mso]>
+    <noscript>
+        <xml>
+            <o:OfficeDocumentSettings>
+                <o:PixelsPerInch>96</o:PixelsPerInch>
+            </o:OfficeDocumentSettings>
+        </xml>
+    </noscript>
+    <![endif]-->
+</head>
+<body style="margin: 0; padding: 0; background-color: #f4f4f7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%;">
+    <table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background-color: #f4f4f7;">
+        <tr>
+            <td align="center" style="padding: 24px 16px;">
+                <table role="presentation" width="600" cellpadding="0" cellspacing="0" style="max-width: 600px; width: 100%; background-color: #ffffff; border-radius: 8px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.08);">
+                    <!-- Header -->
+                    <tr>
+                        <td style="padding: 32px 40px 24px; border-bottom: 1px solid #eaeaea;">
+                            <span style="font-size: 18px; font-weight: 700; color: #1a1a2e;">${app_name|Entity Server}</span>
+                        </td>
+                    </tr>
+                    <!-- Content -->
+                    <tr>
+                        <td style="padding: 32px 40px;">
+                            ${content}
+                        </td>
+                    </tr>
+                    <!-- Footer -->
+                    <tr>
+                        <td style="padding: 24px 40px; border-top: 1px solid #eaeaea; background-color: #fafafa;">
+                            <p style="margin: 0; font-size: 12px; color: #999; line-height: 1.6;">
+                                이 이메일은 자동 발송되었습니다. 회신하지 마세요.<br>
+                                &copy; ${company|Entity Server}
+                            </p>
+                        </td>
+                    </tr>
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>

package/template/templates/email/order/order_confirmation.html

@@ -0,0 +1,30 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #1a1a2e;">주문이 확인되었습니다</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    ${name|고객}님, 주문해 주셔서 감사합니다.
+</p>
+<div style="padding: 20px; background-color: #f8f8fa; border-radius: 6px; margin: 0 0 24px;">
+    <table role="presentation" width="100%" cellpadding="0" cellspacing="0">
+        <tr>
+            <td style="padding: 8px 0; font-size: 14px; color: #888;">주문번호</td>
+            <td style="padding: 8px 0; font-size: 14px; color: #1a1a2e; font-weight: 600; text-align: right;">${order_id|ORD-000001}</td>
+        </tr>
+        <tr>
+            <td style="padding: 8px 0; font-size: 14px; color: #888; border-top: 1px solid #eaeaea;">주문일시</td>
+            <td style="padding: 8px 0; font-size: 14px; color: #1a1a2e; text-align: right; border-top: 1px solid #eaeaea;">${order_date|2026-01-01}</td>
+        </tr>
+        <tr>
+            <td style="padding: 8px 0; font-size: 14px; color: #888; border-top: 1px solid #eaeaea;">상품</td>
+            <td style="padding: 8px 0; font-size: 14px; color: #1a1a2e; text-align: right; border-top: 1px solid #eaeaea;">${items|상품 1건}</td>
+        </tr>
+        <tr>
+            <td style="padding: 12px 0; font-size: 16px; font-weight: 700; color: #1a1a2e; border-top: 2px solid #1a1a2e;">총 결제금액</td>
+            <td style="padding: 12px 0; font-size: 16px; font-weight: 700; color: #1a1a2e; text-align: right; border-top: 2px solid #1a1a2e;">${total|50,000원}</td>
+        </tr>
+    </table>
+</div>
+<div style="text-align: center; margin: 0 0 24px;">
+    <a href="${detail_url|#}" style="display: inline-block; padding: 14px 36px; background-color: #1a1a2e; color: #ffffff; text-decoration: none; border-radius: 6px; font-size: 15px; font-weight: 600;">주문 상세 보기</a>
+</div>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    주문 관련 문의사항이 있으시면 고객센터로 연락해 주세요.
+</p>

package/template/templates/email/storage/storage_quota_exceeded.html

@@ -0,0 +1,37 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #e74c3c;">🚫 저장공간 초과</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    저장공간 사용량이 제한 용량을 초과했습니다. 파일 업로드가 차단됩니다. 즉시 불필요한 파일을 삭제하거나 쿼터를 늘려주세요.
+</p>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin: 0 0 24px;">
+    <tr>
+        <td style="padding: 16px 20px; background-color: #fdedec; border-radius: 6px; border-left: 4px solid #e74c3c;">
+            <table role="presentation" width="100%" cellpadding="0" cellspacing="0">
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">사용량</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${used|0 B}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">제한 용량</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${limit|0 B}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">사용률</td>
+                    <td style="padding: 4px 0; font-size: 15px; font-weight: 700; color: #e74c3c;">${percent|0}%</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">업로드 시도</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${upload_size|0 B}</td>
+                </tr>
+            </table>
+        </td>
+    </tr>
+</table>
+<!-- 사용률 바 (100%) -->
+<div style="margin: 0 0 24px;">
+    <div style="background-color: #eee; border-radius: 4px; height: 12px; overflow: hidden;">
+        <div style="background-color: #e74c3c; height: 100%; width: 100%; border-radius: 4px;"></div>
+    </div>
+</div>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    이 알림은 저장공간 사용량이 제한 용량을 초과했을 때 자동 발송됩니다.
+</p>

package/template/templates/email/storage/storage_quota_warning.html

@@ -0,0 +1,37 @@
+<h2 style="margin: 0 0 16px; font-size: 22px; font-weight: 700; color: #e67e22;">⚠️ 저장공간 사용량 경고</h2>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    저장공간 사용량이 경고 임계값에 도달했습니다. 오래된 파일을 정리하거나 쿼터를 늘려주세요.
+</p>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin: 0 0 24px;">
+    <tr>
+        <td style="padding: 16px 20px; background-color: #fef9e7; border-radius: 6px; border-left: 4px solid #e67e22;">
+            <table role="presentation" width="100%" cellpadding="0" cellspacing="0">
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">사용량</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${used|0 B}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">제한 용량</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${limit|0 B}</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">사용률</td>
+                    <td style="padding: 4px 0; font-size: 15px; font-weight: 700; color: #e67e22;">${percent|0}%</td>
+                </tr>
+                <tr>
+                    <td style="padding: 4px 0; font-size: 14px; color: #555; width: 120px; font-weight: 600;">임계값</td>
+                    <td style="padding: 4px 0; font-size: 14px; color: #333;">${threshold|80}%</td>
+                </tr>
+            </table>
+        </td>
+    </tr>
+</table>
+<!-- 사용률 바 -->
+<div style="margin: 0 0 24px;">
+    <div style="background-color: #eee; border-radius: 4px; height: 12px; overflow: hidden;">
+        <div style="--quota-percent: ${percent|0}%; background-color: #e67e22; height: 100%; width: var(--quota-percent); max-width: 100%; border-radius: 4px;"></div>
+    </div>
+</div>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    이 알림은 저장공간 사용량이 임계값(${threshold|80}%)을 초과했을 때 자동 발송됩니다.
+</p>