create-entity-server 0.0.25 → 0.0.27

package/template/entities/System/Storage/file_meta.json

@@ -0,0 +1,59 @@
+{
+    "name": "file_meta",
+    "description": "파일 메타데이터. 업로드된 파일의 저장 위치·크기·해시·상태를 관리합니다. 파일 핸들러가 자동 기록하며 API를 통한 직접 수정은 허용되지 않습니다. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
+    "history": false,
+    "hard_delete": true,
+    "read_only": true,
+    "index": {
+        "backup_status": {
+            "comment": "백업 동기화 상태",
+            "type": ["none", "pending", "synced", "failed", "skipped"],
+            "default": "none"
+        },
+        "size": {
+            "comment": "파일 크기 (bytes)",
+            "type": "bigint unsigned"
+        },
+        "status": {
+            "comment": "파일 상태",
+            "type": ["active", "pending", "orphan", "deleted"],
+            "default": "pending",
+            "required": true
+        },
+        "uuid": {
+            "comment": "파일 고유 식별자 (UUID v4). 저장 경로·다운로드 URL의 키로 사용",
+            "type": "varchar(36)",
+            "required": true,
+            "unique": true
+        }
+    },
+    "fields": {
+        "backup_retries": {
+            "comment": "백업 재시도 횟수"
+        },
+        "content_hash": {
+            "comment": "파일 SHA-256 해시 (중복 탐지·무결성 검증용)"
+        },
+        "entity_name": {
+            "comment": "파일이 첨부된 엔티티 이름"
+        },
+        "entity_seq": {
+            "comment": "파일이 첨부된 엔티티 레코드 seq. 업로드 직후 엔티티 미연결 시 NULL"
+        },
+        "field_name": {
+            "comment": "파일이 첨부된 필드 이름 (file/file[] 타입 필드)"
+        },
+        "mime_type": {
+            "comment": "파일 MIME 타입 (image/jpeg, application/pdf 등)"
+        },
+        "original_name": {
+            "comment": "업로드 시 원본 파일명 (보안 대상 — 암호화 저장)"
+        },
+        "storage_key": {
+            "comment": "스토리지 백엔드 내 상대 경로 (예: 2026/02/27/contact/uuid.jpg)"
+        },
+        "storage_path": {
+            "comment": "라이선스 접두어 포함 전체 경로 (예: 3/2026/02/27/contact/uuid.jpg)"
+        }
+    }
+}

package/template/entities/System/system_audit_log.json

@@ -1,11 +1,12 @@
 {
     "name": "system_audit_log",
-    "description": "시스템 감사 로그. 서버 레벨에서 자동 기록되며 API를 통한 직접 수정은 허용되지 않습니다. JWT 인증 시에만 account_seq 기록",
+    "description": "시스템 감사 로그. 서버 레벨에서 자동 기록되며 API를 통한 직접 수정은 허용되지 않습니다. JWT 인증 시에만 account_seq 기록. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
     "db_group": "system",
     "hard_delete": true,
     "history_ttl": 0,
     "read_only": true,
     "license_scope": false,
+    "compress": true,
     "index": {
         "transaction_id": {
             "comment": "요청 트랜잭션 ID. entity_history 테이블과 JOIN 키",

package/template/entities/company.json

@@ -1,6 +1,6 @@
 {
     "name": "company",
-    "description": "company Entity",
+    "description": "company Entity. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
     "index": {
         "company_name": {
             "comment": "회사명",

package/template/entities/{product.json → goods.json}

@@ -1,19 +1,15 @@
 {
-    "name": "product",
-    "description": "product Entity",
+    "name": "goods",
+    "description": "goods Entity. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
     "index": {
         "name": {
-            "comment": "제품명",
+            "comment": "상품명",
             "required": true,
             "unique": true
         },
         "category": {
             "comment": "카테고리",
-            "type": [
-                "전자제품",
-                "가구",
-                "생활용품"
-            ]
+            "type": ["전자제품", "가구", "생활용품"]
         },
         "price": {
             "comment": "가격"
@@ -21,13 +17,13 @@
     },
     "reset_defaults": [
         {
-            "name": "샘플 제품 A",
+            "name": "샘플 상품 A",
             "category": "전자제품",
             "price": 10000,
             "stock": 50
         },
         {
-            "name": "샘플 제품 B",
+            "name": "샘플 상품 B",
             "category": "가구",
             "price": 50000,
             "stock": 20

package/template/entities/todo.json

@@ -1,6 +1,6 @@
 {
     "name": "todo",
-    "description": "todo Entity",
+    "description": "todo Entity. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
     "index": {
         "title": {
             "comment": "할 일 제목"

package/template/samples/entities/README.md

@@ -3,8 +3,8 @@
 `entities/` 디렉토리에 배치하는 `.json` 설정 파일 예제 모음입니다.  
 엔티티 서버의 **모든 주요 기능을 하나씩** 알아볼 수 있도록 주제별로 구성하였습니다.
 
-> **전체 레퍼런스**: [docs/ops/entity-config-guide.md](../../docs/ops/entity-config-guide.md)  
-> **훅 가이드**: [docs/ops/hooks.md](../../docs/ops/hooks.md)
+> **전체 레퍼런스**: [docs/guides/data/entity-config-guide.md](../../docs/guides/data/entity-config-guide.md)  
+> **훅 가이드**: [docs/guides/extensions/hooks.md](../../docs/guides/extensions/hooks.md)
 
 ---
 

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

@@ -31,6 +31,11 @@ Options:
     --export      Print shell export format
     --apply       Apply values directly to project .env
 
+Generated keys:
+    ENCRYPTION_KEY      Master encryption key (32-byte hex)
+    JWT_SECRET          JWT signing key (64-byte hex)
+    BACKUP_ENCRYPT_KEY  Backup file encryption key (32-byte hex)
+
 Examples:
     ./scripts/generate-env-keys.sh --create
     ./scripts/generate-env-keys.sh --export
@@ -53,6 +58,11 @@ ENCRYPTION_KEY, JWT_SECRET 랜덤 값을 생성합니다.
     --export      export 형식으로 출력
     --apply       프로젝트 루트 .env 파일에 즉시 반영
 
+생성 키:
+    ENCRYPTION_KEY      마스터 암호화 키 (32바이트 hex)
+    JWT_SECRET          JWT 서명 키 (64바이트 hex)
+    BACKUP_ENCRYPT_KEY  백업 파일 암호화 키 (32바이트 hex)
+
 예제:
     ./scripts/generate-env-keys.sh --create
     ./scripts/generate-env-keys.sh --export
@@ -106,17 +116,20 @@ gen_hex() {
 
 ENCRYPTION_KEY="$(gen_hex 16)"
 JWT_SECRET="$(gen_hex 32)"
+BACKUP_ENCRYPT_KEY="$(gen_hex 16)"
 
 if [[ "$OUTPUT_MODE" == "export" ]]; then
     cat <<EOF
 export ENCRYPTION_KEY=$ENCRYPTION_KEY
 export JWT_SECRET=$JWT_SECRET
+export BACKUP_ENCRYPT_KEY=$BACKUP_ENCRYPT_KEY
 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
+BACKUP_ENCRYPT_KEY=$BACKUP_ENCRYPT_KEY
 EOF
 else
     # --apply
@@ -135,14 +148,17 @@ else
 
     upsert_env_key "ENCRYPTION_KEY" "$ENCRYPTION_KEY"
     upsert_env_key "JWT_SECRET" "$JWT_SECRET"
+    upsert_env_key "BACKUP_ENCRYPT_KEY" "$BACKUP_ENCRYPT_KEY"
 
     if [ "$LANGUAGE" = "en" ]; then
         echo "✓ Updated: $ENV_FILE"
         echo "  - ENCRYPTION_KEY"
         echo "  - JWT_SECRET"
+        echo "  - BACKUP_ENCRYPT_KEY"
     else
         echo "✓ 업데이트 완료: $ENV_FILE"
         echo "  - ENCRYPTION_KEY"
         echo "  - JWT_SECRET"
+        echo "  - BACKUP_ENCRYPT_KEY"
     fi
 fi

package/template/templates/email/account/dormancy_warning.html

@@ -0,0 +1,20 @@
+<h2 style="margin: 0 0 8px; font-size: 22px; font-weight: 700; color: #1a1a2e;">계정 휴면 예정 안내</h2>
+<p style="margin: 0 0 24px; font-size: 13px; color: #999;">D-${days_left|30}</p>
+<p style="margin: 0 0 20px; font-size: 15px; color: #555; line-height: 1.6;">
+    안녕하세요.<br>
+    <strong>${email}</strong> 계정이 <strong>${days_left|30}일 후</strong> 장기 미접속으로 인해 휴면 상태로 전환될 예정입니다.
+</p>
+<div style="background-color: #fff8e1; border-left: 4px solid #f59e0b; border-radius: 4px; padding: 16px 20px; margin: 0 0 24px;">
+    <p style="margin: 0; font-size: 14px; color: #92400e; line-height: 1.6;">
+        휴면 계정은 로그인이 제한되며, 서비스 이용을 위해 별도의 본인 인증이 필요합니다.
+    </p>
+</div>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    지금 로그인하면 휴면 전환을 방지할 수 있습니다.
+</p>
+<div style="text-align: center; margin: 0 0 28px;">
+    <a href="${login_url|#}" style="display: inline-block; padding: 14px 40px; 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/account/password_expiry_warning.html

@@ -0,0 +1,21 @@
+<h2 style="margin: 0 0 8px; font-size: 22px; font-weight: 700; color: #1a1a2e;">비밀번호 변경 안내</h2>
+<p style="margin: 0 0 24px; font-size: 13px; color: #999;">D-${days_left|14}</p>
+<p style="margin: 0 0 20px; font-size: 15px; color: #555; line-height: 1.6;">
+    안녕하세요.<br>
+    <strong>${email}</strong> 계정의 비밀번호가 <strong>${days_left|14}일 후</strong> 만료됩니다.
+</p>
+<div style="background-color: #fef2f2; border-left: 4px solid #ef4444; border-radius: 4px; padding: 16px 20px; margin: 0 0 24px;">
+    <p style="margin: 0; font-size: 14px; color: #991b1b; line-height: 1.6;">
+        만료된 비밀번호로는 로그인 후 즉시 비밀번호 변경이 요구될 수 있습니다.<br>
+        정기적인 비밀번호 변경으로 계정을 안전하게 보호하세요.
+    </p>
+</div>
+<p style="margin: 0 0 24px; font-size: 15px; color: #555; line-height: 1.6;">
+    아래 버튼을 클릭하여 지금 비밀번호를 변경하세요.
+</p>
+<div style="text-align: center; margin: 0 0 28px;">
+    <a href="${change_password_url|#}" style="display: inline-block; padding: 14px 40px; 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/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/email_verification.html

@@ -0,0 +1,18 @@
+<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;">
+    아래 인증 코드를 입력하여 이메일 주소를 인증하세요.
+</p>
+<div style="text-align: center; margin: 0 0 28px;">
+    <div style="display: inline-block; padding: 18px 40px; background-color: #f4f4f7; border-radius: 8px; border: 1px solid #e0e0e0;">
+        <span style="font-size: 32px; font-weight: 700; letter-spacing: 10px; color: #1a1a2e; font-family: 'Courier New', Courier, monospace;">${code|------}</span>
+    </div>
+</div>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이 코드는 <strong>${expires_in|5분}</strong> 동안 유효합니다.
+</p>
+<p style="margin: 0 0 8px; font-size: 13px; color: #aaa; line-height: 1.6;">
+    인증 대상 이메일: <strong>${email|}</strong>
+</p>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우 이 이메일을 무시하세요.
+</p>

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

@@ -0,0 +1,18 @@
+<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;">
+    관리자에 의해 비밀번호가 초기화되었습니다. 아래 임시 비밀번호로 로그인 후 즉시 비밀번호를 변경하세요.
+</p>
+<div style="text-align: center; margin: 0 0 28px;">
+    <div style="display: inline-block; padding: 14px 32px; background-color: #f4f4f7; border-radius: 8px; border: 1px solid #e0e0e0;">
+        <span style="font-size: 22px; font-weight: 700; letter-spacing: 4px; color: #1a1a2e; font-family: 'Courier New', Courier, monospace;">${temp_password|}</span>
+    </div>
+</div>
+<p style="margin: 0 0 16px; font-size: 14px; color: #d9534f; font-weight: 600; line-height: 1.6;">
+    ⚠ 보안을 위해 로그인 즉시 비밀번호를 변경하시기 바랍니다.
+</p>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이메일: <strong>${email|}</strong>
+</p>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우 즉시 관리자에게 문의하세요.
+</p>

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

@@ -0,0 +1,19 @@
+<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;">
+    비밀번호 재설정이 요청되었습니다. 아래 버튼을 클릭하여 새 비밀번호를 설정하세요.
+</p>
+<div style="text-align: center; margin: 0 0 24px;">
+    <a href="${reset_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 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    버튼이 작동하지 않으면 아래 링크를 브라우저에 붙여넣으세요:
+</p>
+<p style="margin: 0 0 16px; font-size: 13px; color: #4a90d9; word-break: break-all; line-height: 1.6;">
+    ${reset_url|https://example.com/reset?token=sample}
+</p>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이 링크는 <strong>${expires_in|1시간}</strong> 동안 유효합니다.
+</p>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우 이 이메일을 무시하세요. 비밀번호는 변경되지 않습니다.
+</p>

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

@@ -0,0 +1,15 @@
+<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;">
+    아래 코드를 입력하여 본인 인증을 완료하세요.
+</p>
+<div style="text-align: center; margin: 0 0 24px;">
+    <div style="display: inline-block; padding: 16px 40px; background-color: #f0f0f5; border-radius: 8px; letter-spacing: 8px; font-size: 36px; font-weight: 700; color: #1a1a2e; font-family: 'Courier New', monospace;">
+        ${code|000000}
+    </div>
+</div>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이 코드는 <strong>${expires_in|10분}</strong> 동안 유효합니다.
+</p>
+<p style="margin: 0; font-size: 13px; color: #aaa; line-height: 1.6;">
+    본인이 요청하지 않은 경우 이 이메일을 무시하세요.
+</p>

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

@@ -0,0 +1,25 @@
+```php
+<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;">
+    아래 버튼을 클릭하여 이메일 인증을 완료하세요.
+</p>
+<div style="text-align: center; margin: 0 0 24px;">
+    <a href="${activation_url}" target="_blank" rel="noopener noreferrer"
+        style="display: inline-block; padding: 14px 40px; background-color: #1a1a2e; color: #ffffff; text-decoration: none; border-radius: 8px; font-size: 16px; font-weight: 600; letter-spacing: 0.5px;">
+        이메일 인증하기
+    </a>
+</div>
+<p style="margin: 0 0 8px; font-size: 14px; color: #888; line-height: 1.6;">
+    이 링크는 <strong>${expires_in|10분}</strong> 동안 유효합니다.
+</p>
+<p style="margin: 0 0 16px; font-size: 13px; color: #aaa; line-height: 1.6;">
+    버튼이 작동하지 않는 경우 아래 링크를 브라우저에 직접 붙여넣으세요:
+</p>
+<p style="margin: 0; font-size: 12px; color: #999; word-break: break-all; line-height: 1.6;">
+    ${activation_url}
+</p>
+<p style="margin: 16px 0 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>