create-entity-server 0.0.25 → 0.0.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-entity-server",
-  "version": "0.0.25",
+  "version": "0.0.27",
   "description": "Create a new entity-server project in one command — like create-react-app or create-vite.",
   "keywords": [
     "entity-server",

package/template/.env.example

@@ -11,6 +11,10 @@ ENCRYPTION_KEY=your-32-char-hex-encryption-key-here
 # 운영에서는 충분히 긴 랜덤 시크릿을 사용하세요.
 JWT_SECRET=your-jwt-secret-here
 
+# 백업 암호화 키 (backup.json의 ${BACKUP_ENCRYPT_KEY}와 매핑)
+# 비워두면 암호화 비활성화. 설정 시 충분한 길이의 랜덤 문자열 권장.
+# BACKUP_ENCRYPT_KEY=your-backup-encryption-key-here
+
 # 서버 포트 (configs/server.json의 port를 오버라이드)
 SERVER_PORT=47200
 
@@ -27,5 +31,39 @@ DB_NAME_PRODUCTION=your-production-db-name
 DB_USER_PRODUCTION=your-production-db-user
 DB_PASSWORD_PRODUCTION=your-production-db-password
 
+# SMTP 이메일 (smtp.json에서 ${SMTP_USERNAME} 등으로 참조)
+# SMTP_USERNAME=user@gmail.com
+# SMTP_PASSWORD=your-app-specific-password
+# SENDGRID_API_KEY=SG.xxxx...
+# SES_SMTP_USERNAME=your-ses-smtp-username
+# SES_SMTP_PASSWORD=your-ses-smtp-password
+# MAILGUN_SMTP_PASSWORD=your-mailgun-smtp-password
+
 # 푸시 알림 (push.json에서 ${FCM_PROJECT_ID} 등으로 참조 가능)
 # FCM_PROJECT_ID=your-firebase-project-id
+
+# OAuth 소셜 로그인 (configs/auth/oauth.json)
+# OAUTH_STATE_SECRET=your-random-oauth-state-secret
+# OAUTH_SUCCESS_REDIRECT_URL=https://your-frontend.example.com/auth/success
+# OAUTH_FAILURE_REDIRECT_URL=https://your-frontend.example.com/auth/fail
+# GOOGLE_CLIENT_ID=your-google-client-id
+# GOOGLE_CLIENT_SECRET=your-google-client-secret
+# GITHUB_CLIENT_ID=your-github-client-id
+# GITHUB_CLIENT_SECRET=your-github-client-secret
+# NAVER_CLIENT_ID=your-naver-client-id
+# NAVER_CLIENT_SECRET=your-naver-client-secret
+# KAKAO_CLIENT_ID=your-kakao-client-id
+# KAKAO_CLIENT_SECRET=your-kakao-client-secret
+
+# SMS (configs/notification/sms.json)
+# SMS_SENDER_NUMBER=029302266
+# ALIGO_USER_ID=your-aligo-user-id
+# ALIGO_API_KEY=your-aligo-api-key
+# AWS_SNS_ACCESS_KEY=your-aws-access-key
+# AWS_SNS_SECRET_KEY=your-aws-secret-key
+# AWS_SNS_REGION=ap-northeast-2
+
+# 카카오 알림톡 (configs/notification/alimtalk.json)
+# ALIMTALK_SENDER_KEY=your-kakao-sender-key
+# ALIGO_USER_ID=your-aligo-user-id
+# ALIGO_API_KEY=your-aligo-api-key

package/template/configs/auth/cors.json

@@ -0,0 +1,15 @@
+{
+    "_comment": "CORS 설정 예시. cors_allow_origins 는 프로덕션에서 반드시 구체적인 도메인으로 제한하세요.",
+    "cors_enabled": true,
+    "cors_allow_credentials": false,
+    "cors_allow_headers": "Origin,Content-Type,Accept,Authorization,X-API-Key,X-Signature,X-Timestamp,X-Nonce,X-Transaction-ID",
+    "cors_allow_methods": "GET,POST,PUT,PATCH,DELETE,OPTIONS",
+    "cors_allow_origins": "https://your-domain.com",
+
+    "environments": {
+        "development": {
+            "_comment": "개발 환경에서만 와일드카드 허용",
+            "cors_allow_origins": "*"
+        }
+    }
+}

package/template/configs/auth/identity.json

@@ -0,0 +1,27 @@
+{
+    "enabled": false,
+    "default": "nice",
+    "request_ttl_sec": 300,
+    "result_ttl_sec": 600,
+    "return_url": "/v1/identity/callback",
+    "success_redirect_url": "/identity/complete",
+    "failure_redirect_url": "/identity/error",
+    "duplicate_ci_check": true,
+    "providers": [
+        {
+            "driver": "nice",
+            "site_code": "${NICE_SITE_CODE}",
+            "site_password": "${NICE_SITE_PASSWORD}",
+            "client_id": "${NICE_CLIENT_ID}",
+            "client_secret": "${NICE_CLIENT_SECRET}",
+            "product_id": "2101979031",
+            "api_url": "https://nice.checkplus.co.kr",
+            "token_url": "https://svc.niceapi.co.kr:22001/digital/niceid/oauth/oauth/token",
+            "crypto_url": "https://svc.niceapi.co.kr:22001/digital/niceid/api/v1.0/common/crypto/token"
+        }
+    ],
+    "rate_limit": {
+        "per_ip_per_hour": 10,
+        "per_account_per_day": 5
+    }
+}

package/template/configs/auth/jwt.json

@@ -0,0 +1,12 @@
+{
+    "_comment": "JWT 설정 예시. secret 은 반드시 환경변수로 주입하세요. access_ttl_sec 은 보안 수준에 맞게 조정하세요.",
+    "enabled": true,
+    "secret": "${JWT_SECRET}",
+    "access_ttl_sec": 3600,
+    "refresh_ttl_sec": 1209600,
+    "issuer": "entity-server",
+    "algorithm": "HS256",
+
+    "_comment_algorithm": "지원 알고리즘: HS256 | HS384 | HS512 | RS256 | RS384 | RS512",
+    "_comment_ttl": "access_ttl_sec=3600(1시간), refresh_ttl_sec=1209600(14일) 기본값"
+}

package/template/configs/{oauth.json → auth/oauth.json}

@@ -1,31 +1,34 @@
 {
     "_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": "https://your-domain.com/v1/oauth/google/callback",
+            "redirect_url": "/v1/oauth/google/callback",
             "scopes": ["openid", "email", "profile"]
         },
         "github": {
             "client_id": "${GITHUB_CLIENT_ID}",
             "client_secret": "${GITHUB_CLIENT_SECRET}",
-            "redirect_url": "https://your-domain.com/v1/oauth/github/callback"
+            "redirect_url": "/v1/oauth/github/callback"
         },
         "naver": {
             "client_id": "${NAVER_CLIENT_ID}",
             "client_secret": "${NAVER_CLIENT_SECRET}",
-            "redirect_url": "https://your-domain.com/v1/oauth/naver/callback"
+            "redirect_url": "/v1/oauth/naver/callback"
         },
         "kakao": {
             "_comment": "Kakao — 커스텀 엔드포인트 예시",
             "client_id": "${KAKAO_CLIENT_ID}",
             "client_secret": "${KAKAO_CLIENT_SECRET}",
-            "redirect_url": "https://your-domain.com/v1/oauth/kakao/callback",
+            "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",

package/template/configs/auth/password.json

@@ -0,0 +1,33 @@
+{
+    "password_policy": {
+        "min_length": 8,
+        "require_mixed_case": false,
+        "require_number": false,
+        "require_special": false,
+        "history_count": 5
+    },
+    "admin_force_reset": {
+        "temp_password_length": 12,
+        "require_change": true,
+        "notify_email": true
+    },
+    "password_reset": {
+        "enabled": false,
+        "token_ttl_sec": 300,
+        "base_url": "/password-reset",
+        "rate_limit": {
+            "per_email_per_hour": 5,
+            "per_ip_per_minute": 10
+        }
+    },
+    "email_verification": {
+        "enabled": false,
+        "required": false,
+        "code_length": 6,
+        "code_ttl_sec": 300,
+        "max_attempts": 5,
+        "rate_limit": {
+            "per_email_per_hour": 5
+        }
+    }
+}

package/template/configs/auth/privacy_policy.json

@@ -0,0 +1,28 @@
+{
+    "_comment": "개인정보처리방침 설정 예시. 각 모듈은 독립적으로 enabled 설정 가능. 운영 적용 전 docs/security/privacy-policy-guide.md 를 반드시 확인하세요.",
+
+    "dormancy": {
+        "_comment": "휴면 계정 전환 정책. 마지막 로그인 기준으로 dormancy_days 경과 시 휴면 처리.",
+        "enabled": false,
+        "dormancy_days": 365,
+        "warning_days": [30, 7],
+        "email_template": "dormancy_warning",
+        "check_interval_hours": 24
+    },
+
+    "data_retention": {
+        "_comment": "개인정보 보존 기간 정책. action: anonymize(익명화) | delete(삭제).",
+        "enabled": false,
+        "retention_days": 1095,
+        "action": "anonymize",
+        "check_interval_hours": 24
+    },
+
+    "password_policy": {
+        "_comment": "비밀번호 만료/재사용 금지 정책. 복잡도 규칙은 password.json의 password_policy를 공통 사용.",
+        "enabled": false,
+        "max_age_days": 180,
+        "warning_days": [14, 7],
+        "email_template": "account/password_expiry_warning"
+    }
+}

package/template/configs/{security.json → auth/security.json}

@@ -1,10 +1,12 @@
 {
-    "enable_hmac": false,
+    "enable_hmac": true,
     "enable_rbac": true,
+    "enable_data_encryption": true,
     "enable_packet_encryption": false,
-    "packet_magic_len": 4,
     "timestamp_skew_sec": 300,
     "nonce_ttl_sec": 300,
+    "auth_fail_limit_per_min": 120,
+    "auth_block_sec": 60,
     "nonce_store": {
         "driver": "redis",
         "memcache_servers": ["localhost:11211"],

package/template/configs/auth/two_factor.json

@@ -0,0 +1,12 @@
+{
+    "enabled": false,
+    "issuer": "EntityServer",
+    "enforce_roles": [],
+    "code_digits": 6,
+    "period_sec": 30,
+    "skew": 1,
+    "recovery_code_count": 10,
+    "setup_token_ttl_sec": 300,
+    "max_verify_attempts": 5,
+    "verify_lockout_sec": 300
+}

package/template/configs/database.json

@@ -1,17 +1,6 @@
-// ──────────────────────────────────────────────────────────────────────────
-// database.json 설정 예시 (주석 포함 예시 전용 파일 — 실제 파일은 순수 JSON)
-//
-// "default"     : 사용할 그룹 이름 (groups 키 중 하나)
-// "groups"      : 드라이버별 연결 설정 모음
-//   driver        : "mysql" | "postgres" | "mongodb" | "dynamodb" |
-//                   "firestore" | "scylladb" | "couchdb"
-//
-// 환경 변수 참조: "${ENV_VAR_NAME}" 형식으로 값을 주입합니다.
-// ──────────────────────────────────────────────────────────────────────────
 {
     "default": "development",
     "groups": {
-        // ── MySQL (SQL) ─────────────────────────────────────────────────
         "development": {
             "driver": "mysql",
             "host": "${DB_HOST_DEVELOPMENT}",
@@ -33,154 +22,6 @@
             "maxOpenConns": 50,
             "maxIdleConns": 25,
             "connMaxLifetimeSec": 3600
-        },
-
-        // ── MongoDB ─────────────────────────────────────────────────────
-        // URI 우선 사용. uri 가 없으면 host/port/database/username/password 조합.
-        "mongodb_dev": {
-            "driver": "mongodb",
-            "uri": "mongodb://localhost:27017/entity_dev",
-            "database": "entity_dev"
-        },
-        "mongodb_prod": {
-            "driver": "mongodb",
-            "host": "${MONGO_HOST}",
-            "port": 27017,
-            "database": "${MONGO_DB}",
-            "username": "${MONGO_USER}",
-            "password": "${MONGO_PASSWORD}",
-            "uri": ""
-        },
-        "mongodb_replica": {
-            "driver": "mongodb",
-            "uri": "mongodb://${MONGO_USER}:${MONGO_PASS}@mongo1:27017,mongo2:27017,mongo3:27017/${MONGO_DB}?replicaSet=rs0&authSource=admin",
-            "database": "${MONGO_DB}"
-        },
-
-        // ── Amazon DynamoDB ─────────────────────────────────────────────
-        // region 과 IAM 인증이 필요합니다.
-        // 로컬 테스트: endpoint 에 "http://localhost:8000" 지정.
-        "dynamodb_dev": {
-            "driver": "dynamodb",
-            "region": "ap-northeast-2",
-            "endpoint": "http://localhost:8000",
-            "access_key_id": "${AWS_ACCESS_KEY_ID}",
-            "secret_access_key": "${AWS_SECRET_ACCESS_KEY}"
-        },
-        "dynamodb_prod": {
-            "driver": "dynamodb",
-            "region": "${AWS_REGION}",
-            "access_key_id": "${AWS_ACCESS_KEY_ID}",
-            "secret_access_key": "${AWS_SECRET_ACCESS_KEY}"
-        },
-
-        // ── Google Cloud Firestore ──────────────────────────────────────
-        // GCP 프로젝트 ID 와 서비스 계정 JSON 파일(또는 ADC)이 필요합니다.
-        //   credentials_file : 서비스 계정 키 파일 경로 (선택)
-        //   ADC 자동 사용 시 credentials_file 생략 가능.
-        "firestore_dev": {
-            "driver": "firestore",
-            "project_id": "${GCP_PROJECT_ID}",
-            "credentials_file": "${GOOGLE_APPLICATION_CREDENTIALS}"
-        },
-        "firestore_prod": {
-            "driver": "firestore",
-            "project_id": "${GCP_PROJECT_ID}"
-        },
-
-        // ── ScyllaDB / Apache Cassandra ────────────────────────────────
-        // hosts 는 쉼표 구분 문자열 또는 배열 모두 허용합니다.
-        // keyspace 가 없으면 자동 생성됩니다.
-        "scylladb_dev": {
-            "driver": "scylladb",
-            "hosts": "localhost:9042",
-            "keyspace": "entity_dev",
-            "username": "",
-            "password": ""
-        },
-        "scylladb_prod": {
-            "driver": "scylladb",
-            "hosts": "${SCYLLA_HOSTS}",
-            "keyspace": "${SCYLLA_KEYSPACE}",
-            "username": "${SCYLLA_USER}",
-            "password": "${SCYLLA_PASSWORD}",
-            "consistency": "quorum",
-            "timeout": "10s"
-        },
-
-        // ── Apache CouchDB ──────────────────────────────────────────────
-        // URI 우선 사용. uri 가 없으면 host/port/username/password 조합.
-        // 포트 기본값: 5984
-        "couchdb_dev": {
-            "driver": "couchdb",
-            "host": "localhost",
-            "port": 5984,
-            "username": "admin",
-            "password": "password"
-        },
-        "couchdb_uri": {
-            "driver": "couchdb",
-            "uri": "http://admin:password@localhost:5984/"
-        },
-        "couchdb_prod": {
-            "driver": "couchdb",
-            "uri": "http://${COUCH_USER}:${COUCH_PASS}@${COUCH_HOST}:${COUCH_PORT}/"
         }
     }
 }
-
-// ──────────────────────────────────────────────────────────────────────────
-// DataStore 단독 사용 — flat 형식 (groups 없이 최상위에 driver 직접 지정)
-//
-// SQL 없이 NoSQL DataStore만 단독으로 사용할 때는 groups 없이
-// database.json 최상위에 driver 를 직접 지정합니다.
-// store_loader.go 가 groups 키가 없고 NoSQL driver 인 경우에만 DataStore로 인식합니다.
-// ──────────────────────────────────────────────────────────────────────────
-
-// MongoDB flat 형식
-{
-    "driver": "mongodb",
-    "uri": "mongodb://localhost:27017",
-    "database": "entity_server"
-}
-
-// MongoDB — 환경변수 방식
-{
-    "driver": "mongodb",
-    "host": "${MONGO_HOST}",
-    "port": "${MONGO_PORT}",
-    "username": "${MONGO_USER}",
-    "password": "${MONGO_PASSWORD}",
-    "database": "${MONGO_DATABASE}"
-}
-
-// DynamoDB flat 형식
-{
-    "driver": "dynamodb",
-    "region": "${AWS_REGION}",
-    "access_key_id": "${AWS_ACCESS_KEY_ID}",
-    "secret_access_key": "${AWS_SECRET_ACCESS_KEY}"
-}
-
-// Firestore flat 형식
-{
-    "driver": "firestore",
-    "project_id": "${GCP_PROJECT_ID}",
-    "credentials_file": "${GOOGLE_APPLICATION_CREDENTIALS}"
-}
-
-// ScyllaDB flat 형식
-{
-    "driver": "scylladb",
-    "host": "${SCYLLA_HOST}",
-    "port": 9042,
-    "database": "${SCYLLA_KEYSPACE}",
-    "username": "${SCYLLA_USER}",
-    "password": "${SCYLLA_PASSWORD}"
-}
-
-// CouchDB flat 형식
-{
-    "driver": "couchdb",
-    "uri": "http://${COUCH_USER}:${COUCH_PASS}@${COUCH_HOST}:5984/"
-}

package/template/configs/database.json.example

@@ -0,0 +1,186 @@
+// ──────────────────────────────────────────────────────────────────────────
+// database.json 설정 예시 (주석 포함 예시 전용 파일 — 실제 파일은 순수 JSON)
+//
+// "default"     : 사용할 그룹 이름 (groups 키 중 하나)
+// "groups"      : 드라이버별 연결 설정 모음
+//   driver        : "mysql" | "postgres" | "mongodb" | "dynamodb" |
+//                   "firestore" | "scylladb" | "couchdb"
+//
+// 환경 변수 참조: "${ENV_VAR_NAME}" 형식으로 값을 주입합니다.
+// ──────────────────────────────────────────────────────────────────────────
+{
+    "default": "development",
+    "groups": {
+        // ── MySQL (SQL) ─────────────────────────────────────────────────
+        "development": {
+            "driver": "mysql",
+            "host": "${DB_HOST_DEVELOPMENT}",
+            "port": "${DB_PORT_DEVELOPMENT}",
+            "database": "${DB_NAME_DEVELOPMENT}",
+            "user": "${DB_USER_DEVELOPMENT}",
+            "password": "${DB_PASSWORD_DEVELOPMENT}",
+            "maxOpenConns": 20,
+            "maxIdleConns": 10,
+            "connMaxLifetimeSec": 3600
+        },
+        "production": {
+            "driver": "mysql",
+            "host": "${DB_HOST_PRODUCTION}",
+            "port": "${DB_PORT_PRODUCTION}",
+            "database": "${DB_NAME_PRODUCTION}",
+            "user": "${DB_USER_PRODUCTION}",
+            "password": "${DB_PASSWORD_PRODUCTION}",
+            "maxOpenConns": 50,
+            "maxIdleConns": 25,
+            "connMaxLifetimeSec": 3600
+        },
+
+        // ── MongoDB ─────────────────────────────────────────────────────
+        // URI 우선 사용. uri 가 없으면 host/port/database/username/password 조합.
+        "mongodb_dev": {
+            "driver": "mongodb",
+            "uri": "mongodb://localhost:27017/entity_dev",
+            "database": "entity_dev"
+        },
+        "mongodb_prod": {
+            "driver": "mongodb",
+            "host": "${MONGO_HOST}",
+            "port": 27017,
+            "database": "${MONGO_DB}",
+            "username": "${MONGO_USER}",
+            "password": "${MONGO_PASSWORD}",
+            "uri": ""
+        },
+        "mongodb_replica": {
+            "driver": "mongodb",
+            "uri": "mongodb://${MONGO_USER}:${MONGO_PASS}@mongo1:27017,mongo2:27017,mongo3:27017/${MONGO_DB}?replicaSet=rs0&authSource=admin",
+            "database": "${MONGO_DB}"
+        },
+
+        // ── Amazon DynamoDB ─────────────────────────────────────────────
+        // region 과 IAM 인증이 필요합니다.
+        // 로컬 테스트: endpoint 에 "http://localhost:8000" 지정.
+        "dynamodb_dev": {
+            "driver": "dynamodb",
+            "region": "ap-northeast-2",
+            "endpoint": "http://localhost:8000",
+            "access_key_id": "${AWS_ACCESS_KEY_ID}",
+            "secret_access_key": "${AWS_SECRET_ACCESS_KEY}"
+        },
+        "dynamodb_prod": {
+            "driver": "dynamodb",
+            "region": "${AWS_REGION}",
+            "access_key_id": "${AWS_ACCESS_KEY_ID}",
+            "secret_access_key": "${AWS_SECRET_ACCESS_KEY}"
+        },
+
+        // ── Google Cloud Firestore ──────────────────────────────────────
+        // GCP 프로젝트 ID 와 서비스 계정 JSON 파일(또는 ADC)이 필요합니다.
+        //   credentials_file : 서비스 계정 키 파일 경로 (선택)
+        //   ADC 자동 사용 시 credentials_file 생략 가능.
+        "firestore_dev": {
+            "driver": "firestore",
+            "project_id": "${GCP_PROJECT_ID}",
+            "credentials_file": "${GOOGLE_APPLICATION_CREDENTIALS}"
+        },
+        "firestore_prod": {
+            "driver": "firestore",
+            "project_id": "${GCP_PROJECT_ID}"
+        },
+
+        // ── ScyllaDB / Apache Cassandra ────────────────────────────────
+        // hosts 는 쉼표 구분 문자열 또는 배열 모두 허용합니다.
+        // keyspace 가 없으면 자동 생성됩니다.
+        "scylladb_dev": {
+            "driver": "scylladb",
+            "hosts": "localhost:9042",
+            "keyspace": "entity_dev",
+            "username": "",
+            "password": ""
+        },
+        "scylladb_prod": {
+            "driver": "scylladb",
+            "hosts": "${SCYLLA_HOSTS}",
+            "keyspace": "${SCYLLA_KEYSPACE}",
+            "username": "${SCYLLA_USER}",
+            "password": "${SCYLLA_PASSWORD}",
+            "consistency": "quorum",
+            "timeout": "10s"
+        },
+
+        // ── Apache CouchDB ──────────────────────────────────────────────
+        // URI 우선 사용. uri 가 없으면 host/port/username/password 조합.
+        // 포트 기본값: 5984
+        "couchdb_dev": {
+            "driver": "couchdb",
+            "host": "localhost",
+            "port": 5984,
+            "username": "admin",
+            "password": "password"
+        },
+        "couchdb_uri": {
+            "driver": "couchdb",
+            "uri": "http://admin:password@localhost:5984/"
+        },
+        "couchdb_prod": {
+            "driver": "couchdb",
+            "uri": "http://${COUCH_USER}:${COUCH_PASS}@${COUCH_HOST}:${COUCH_PORT}/"
+        }
+    }
+}
+
+// ──────────────────────────────────────────────────────────────────────────
+// DataStore 단독 사용 — flat 형식 (groups 없이 최상위에 driver 직접 지정)
+//
+// SQL 없이 NoSQL DataStore만 단독으로 사용할 때는 groups 없이
+// database.json 최상위에 driver 를 직접 지정합니다.
+// store_loader.go 가 groups 키가 없고 NoSQL driver 인 경우에만 DataStore로 인식합니다.
+// ──────────────────────────────────────────────────────────────────────────
+
+// MongoDB flat 형식
+{
+    "driver": "mongodb",
+    "uri": "mongodb://localhost:27017",
+    "database": "entity_server"
+}
+
+// MongoDB — 환경변수 방식
+{
+    "driver": "mongodb",
+    "host": "${MONGO_HOST}",
+    "port": "${MONGO_PORT}",
+    "username": "${MONGO_USER}",
+    "password": "${MONGO_PASSWORD}",
+    "database": "${MONGO_DATABASE}"
+}
+
+// DynamoDB flat 형식
+{
+    "driver": "dynamodb",
+    "region": "${AWS_REGION}",
+    "access_key_id": "${AWS_ACCESS_KEY_ID}",
+    "secret_access_key": "${AWS_SECRET_ACCESS_KEY}"
+}
+
+// Firestore flat 형식
+{
+    "driver": "firestore",
+    "project_id": "${GCP_PROJECT_ID}",
+    "credentials_file": "${GOOGLE_APPLICATION_CREDENTIALS}"
+}
+
+// ScyllaDB flat 형식
+{
+    "driver": "scylladb",
+    "host": "${SCYLLA_HOST}",
+    "port": 9042,
+    "database": "${SCYLLA_KEYSPACE}",
+    "username": "${SCYLLA_USER}",
+    "password": "${SCYLLA_PASSWORD}"
+}
+
+// CouchDB flat 형식
+{
+    "driver": "couchdb",
+    "uri": "http://${COUCH_USER}:${COUCH_PASS}@${COUCH_HOST}:5984/"
+}

package/template/configs/extensions/backup.json

@@ -0,0 +1,46 @@
+{
+    "enabled": false,
+
+    "data": {
+        "enabled": true,
+        "schedule": "0 2 * * *",
+        "db_groups": ["default"],
+        "entities": {
+            "include": [],
+            "exclude": [],
+            "exclude_patterns": ["*_log"]
+        },
+        "include_history": false,
+        "format": "jsonl",
+        "compress": true,
+        "encrypt_passphrase": "${BACKUP_ENCRYPT_KEY}",
+        "batch_size": 500,
+        "max_concurrent_entities": 3,
+        "retention": {
+            "keep_count": 7,
+            "keep_days": 30
+        }
+    },
+
+    "files": {
+        "enabled": true,
+        "mode": "realtime",
+        "max_retries": 3,
+        "retry_interval_sec": 60
+    },
+
+    "schema": {
+        "enabled": true
+    },
+
+    "target": {
+        "storage_key": "s3-backup",
+        "prefix": "backups"
+    },
+
+    "notification": {
+        "on_success": false,
+        "on_failure": true,
+        "channels": ["log", "smtp"]
+    }
+}