create-entity-server 0.0.25 → 0.0.27

package/template/configs/extensions/pg.json

@@ -0,0 +1,37 @@
+{
+    "enabled": false,
+    "default": "toss_payments",
+    "webhook_secret": "${PG_WEBHOOK_SECRET}",
+    "order_id_prefix": "ORD",
+    "success_url": "/payment/success",
+    "fail_url": "/payment/fail",
+    "webhook_url": "/v1/pg/webhook",
+    "amount_limit": {
+        "min": 100,
+        "max": 10000000
+    },
+    "workers": 2,
+    "providers": [
+        {
+            "driver": "toss_payments",
+            "client_key": "${TOSS_CLIENT_KEY}",
+            "secret_key": "${TOSS_SECRET_KEY}",
+            "api_url": "https://api.tosspayments.com",
+            "api_version": "2022-11-16"
+        },
+        {
+            "_comment": "NHN KCP (Phase 2)",
+            "driver": "kcp",
+            "site_cd": "${KCP_SITE_CD}",
+            "secret_key": "${KCP_SECRET_KEY}",
+            "api_url": "https://api.pay.kcp.co.kr"
+        },
+        {
+            "_comment": "KG 이니시스 (Phase 2)",
+            "driver": "inicis",
+            "store_id": "${INICIS_STORE_ID}",
+            "sign_key": "${INICIS_SIGN_KEY}",
+            "api_url": "https://api.inicis.com"
+        }
+    ]
+}

package/template/configs/extensions/storage.json

@@ -0,0 +1,148 @@
+{
+    "enabled": true,
+    "default": "local-main",
+    "max_file_size_mb": 20,
+    "storages": {
+        "local-main": {
+            "driver": "local",
+            "root": "./uploads"
+        },
+
+        "s3-aws": {
+            "driver": "s3",
+            "bucket": "my-entity-files",
+            "region": "ap-northeast-2",
+            "access_key": "${AWS_ACCESS_KEY_ID}",
+            "secret_key": "${AWS_SECRET_ACCESS_KEY}",
+            "prefix": "entity-files"
+        },
+
+        "s3-r2": {
+            "driver": "s3",
+            "bucket": "my-files",
+            "region": "auto",
+            "endpoint": "https://${CF_ACCOUNT_ID}.r2.cloudflarestorage.com",
+            "access_key": "${R2_ACCESS_KEY}",
+            "secret_key": "${R2_SECRET_KEY}",
+            "prefix": "",
+            "_comment": "Cloudflare R2 (S3 호환) — 이그레스 무료"
+        },
+
+        "s3-b2": {
+            "driver": "s3",
+            "bucket": "my-files",
+            "region": "us-west-004",
+            "endpoint": "https://s3.us-west-004.backblazeb2.com",
+            "access_key": "${B2_KEY_ID}",
+            "secret_key": "${B2_APP_KEY}",
+            "_comment": "Backblaze B2 (S3 호환) — S3 대비 1/4 가격"
+        },
+
+        "s3-wasabi": {
+            "driver": "s3",
+            "bucket": "my-files",
+            "region": "ap-northeast-2",
+            "endpoint": "https://s3.ap-northeast-2.wasabisys.com",
+            "access_key": "${WASABI_ACCESS_KEY}",
+            "secret_key": "${WASABI_SECRET_KEY}",
+            "_comment": "Wasabi (S3 호환) — 저가 hot storage"
+        },
+
+        "s3-do-spaces": {
+            "driver": "s3",
+            "bucket": "my-files",
+            "region": "sgp1",
+            "endpoint": "https://sgp1.digitaloceanspaces.com",
+            "access_key": "${DO_SPACES_KEY}",
+            "secret_key": "${DO_SPACES_SECRET}",
+            "_comment": "DigitalOcean Spaces (S3 호환)"
+        },
+
+        "s3-minio": {
+            "driver": "s3",
+            "bucket": "entity-files",
+            "region": "us-east-1",
+            "endpoint": "http://minio.internal:9000",
+            "access_key": "minioadmin",
+            "secret_key": "minioadmin",
+            "_comment": "MinIO (S3 호환) — 자체 호스팅"
+        },
+
+        "s3-ncloud": {
+            "driver": "s3",
+            "bucket": "my-files",
+            "region": "kr-standard",
+            "endpoint": "https://kr.object.ncloudstorage.com",
+            "access_key": "${NCLOUD_ACCESS_KEY}",
+            "secret_key": "${NCLOUD_SECRET_KEY}",
+            "_comment": "Naver Cloud Object Storage (S3 호환)"
+        },
+
+        "azure-example": {
+            "driver": "azure",
+            "container": "files",
+            "account_name": "${AZURE_STORAGE_ACCOUNT}",
+            "account_key": "${AZURE_STORAGE_KEY}",
+            "prefix": "entity-files"
+        },
+
+        "gcs-example": {
+            "driver": "gcs",
+            "bucket": "my-entity-files",
+            "credentials_file": "./configs/keys/gcp-sa.json",
+            "prefix": "entity-files",
+            "_comment": "GKE/Cloud Run에서는 credentials_file 불필요 (Workload Identity)"
+        },
+
+        "sftp-example": {
+            "driver": "sftp",
+            "host": "nas.company.com",
+            "port": 22,
+            "user": "backup",
+            "private_key_file": "./configs/keys/backup_rsa",
+            "root": "/volume1/entity-files",
+            "_comment": "NAS/온프레미스 서버 연동"
+        },
+
+        "swift-kt": {
+            "driver": "swift",
+            "auth_url": "https://ssproxy.ucloudbiz.olleh.com/identity/v3",
+            "container": "my-files",
+            "user": "${KT_USER}",
+            "password": "${KT_PASSWORD}",
+            "tenant_name": "${KT_TENANT}",
+            "domain_name": "Default",
+            "region": "kr1",
+            "_comment": "KT Cloud Storage (OpenStack Swift)"
+        }
+    },
+    "thumbnail": {
+        "enabled": true,
+        "auto_orient": true,
+        "sizes": {
+            "sm": {
+                "width": 160,
+                "height": 160
+            },
+            "md": {
+                "width": 480,
+                "height": 480
+            },
+            "lg": {
+                "width": 1024,
+                "height": 1024
+            }
+        },
+        "quality": 85
+    },
+    "quota": {
+        "default_limit_gb": 0,
+        "threshold_percent": 80,
+        "notify": ["log", "smtp"]
+    },
+    "gc": {
+        "enabled": true,
+        "orphan_threshold_hours": 24,
+        "cron": "0 3 * * *"
+    }
+}

package/template/configs/extensions/tax-invoice.json

@@ -0,0 +1,59 @@
+{
+    "enabled": true,
+    "default": "barobill",
+    "workers": 2,
+    "queue_size": 100,
+    "dispatch_interval_sec": 10,
+    "max_retries": 3,
+    "providers": [
+        {
+            "driver": "barobill",
+            "cert_key": "${TAXINVOICE_CERT_KEY}",
+            "corp_num": "${TAXINVOICE_CORP_NUM}",
+            "user_id": "${TAXINVOICE_USER_ID}",
+            "api_endpoint": "https://barobill.co.kr/TAPI/TaxInvoiceService.asmx",
+            "timeout_sec": 30
+        },
+        {
+            "driver": "popbill",
+            "link_id": "${TAXINVOICE_LINK_ID}",
+            "secret_key": "${TAXINVOICE_SECRET_KEY}",
+            "corp_num": "${TAXINVOICE_CORP_NUM}",
+            "api_endpoint": "https://taxinvoice.linkhub.co.kr",
+            "timeout_sec": 30
+        },
+        {
+            "driver": "bolta",
+            "api_key": "${TAXINVOICE_API_KEY}",
+            "customer_key": "${TAXINVOICE_CUSTOMER_KEY}",
+            "api_endpoint": "https://xapi.bolta.io/v1",
+            "timeout_sec": 30
+        },
+        {
+            "driver": "smartbill",
+            "api_key": "${TAXINVOICE_API_KEY}",
+            "corp_num": "${TAXINVOICE_CORP_NUM}",
+            "api_endpoint": "https://nxapi.smartbill.co.kr",
+            "timeout_sec": 30
+        },
+        {
+            "driver": "esero",
+            "corp_num": "${TAXINVOICE_CORP_NUM}",
+            "cert_path": "/run/secrets/esero_cert.pfx",
+            "cert_pass": "${TAXINVOICE_CERT_PASS}",
+            "api_endpoint": "https://esero.go.kr/api/v1",
+            "timeout_sec": 60
+        }
+    ],
+    "nts": {
+        "taxation_option": 1,
+        "taxation_add_tax_allow": 0,
+        "tax_exemption_option": 1,
+        "tax_exemption_add_tax_allow": 0
+    },
+    "notify": ["log", "smtp", "alimtalk"],
+    "sync": {
+        "state_sync_interval_min": 10,
+        "max_list_days": 200
+    }
+}

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

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

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

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

package/template/configs/notification/alimtalk.json

@@ -0,0 +1,75 @@
+{
+    "_comment": "알림톡(Kakao Alimtalk) 설정 예시 — 4개 프로바이더 전체 구성",
+    "enabled": false,
+    "default": "aligo",
+    "sender_key": "YOUR_KAKAO_SENDER_KEY",
+    "workers": 2,
+    "dispatch_interval_sec": 5,
+    "queue_size": 200,
+    "max_retries": 3,
+    "fallback": {
+        "enabled": true,
+        "sender": "01012345678",
+        "type": "sms"
+    },
+    "template_cache_ttl_sec": 300,
+    "providers": {
+        "aligo": {
+            "driver": "aligo",
+            "api_key": "YOUR_ALIGO_API_KEY",
+            "user_id": "YOUR_ALIGO_USER_ID",
+            "sender_key": "YOUR_KAKAO_SENDER_KEY"
+        },
+        "solapi": {
+            "driver": "solapi",
+            "api_key": "YOUR_SOLAPI_API_KEY",
+            "api_secret": "YOUR_SOLAPI_API_SECRET",
+            "pf_id": "YOUR_SOLAPI_PF_ID",
+            "sender_key": "YOUR_KAKAO_SENDER_KEY"
+        },
+        "ppurio": {
+            "driver": "ppurio",
+            "account": "YOUR_PPURIO_ACCOUNT",
+            "api_key": "YOUR_PPURIO_API_KEY",
+            "sender_key": "YOUR_KAKAO_SENDER_KEY"
+        },
+        "nhn": {
+            "driver": "nhn_cloud",
+            "app_key": "YOUR_NHN_APP_KEY",
+            "secret_key": "YOUR_NHN_SECRET_KEY",
+            "sender_key": "YOUR_KAKAO_SENDER_KEY"
+        }
+    },
+    "templates": [
+        {
+            "code": "AUTH_001",
+            "description": "인증번호 발송",
+            "variables": ["code", "minutes"],
+            "fallback_sms": true
+        },
+        {
+            "code": "ORDER_001",
+            "description": "주문 접수 확인",
+            "variables": ["name", "order_no", "amount"],
+            "fallback_sms": true
+        },
+        {
+            "code": "DELIVERY_001",
+            "description": "배송 시작 알림",
+            "variables": ["name", "tracking_no", "courier"],
+            "fallback_sms": true
+        },
+        {
+            "code": "PAYMENT_001",
+            "description": "결제 완료",
+            "variables": ["name", "amount", "method"],
+            "fallback_sms": false
+        },
+        {
+            "code": "NOTICE_001",
+            "description": "일반 공지",
+            "variables": ["title", "content"],
+            "fallback_sms": false
+        }
+    ]
+}

package/template/configs/{push.json → notification/push.json}

@@ -2,7 +2,7 @@
     "workers": 2,
     "queue_size": 500,
     "fcm": {
-        "enabled": true,
+        "enabled": false,
         "type": "service_account",
         "project_id": "your-firebase-project-id",
         "private_key_id": "abc123def456...",
@@ -16,7 +16,6 @@
     },
     "apns": {
         "enabled": false,
-        "_comment": "APNs 직접 전송 (미구현 - 예약)",
         "key_file": "./configs/keys/apns.p8",
         "key_id": "ABCDE12345",
         "team_id": "FGHIJ67890",

package/template/configs/notification/sms.json

@@ -0,0 +1,54 @@
+{
+    "enabled": true,
+    "default": "aligo",
+    "sender": "01012345678",
+    "workers": 2,
+    "queue_size": 200,
+    "dispatch_interval_sec": 5,
+    "max_retries": 3,
+    "auto_lms": true,
+    "lms_threshold_bytes": 80,
+    "providers": {
+        "aligo": {
+            "driver": "aligo",
+            "api_key": "${ALIGO_API_KEY}",
+            "user_id": "${ALIGO_USER_ID}",
+            "sender": "01012345678"
+        },
+        "solapi": {
+            "driver": "solapi",
+            "api_key": "${SOLAPI_API_KEY}",
+            "api_secret": "${SOLAPI_API_SECRET}",
+            "sender": "01012345678"
+        },
+        "ppurio": {
+            "driver": "ppurio",
+            "account": "${PPURIO_ACCOUNT}",
+            "api_key": "${PPURIO_API_KEY}",
+            "sender": "01012345678"
+        },
+        "nhn": {
+            "driver": "nhn_cloud",
+            "app_key": "${NHN_SMS_APP_KEY}",
+            "secret_key": "${NHN_SMS_SECRET_KEY}",
+            "sender": "01012345678"
+        },
+        "aws": {
+            "driver": "aws_sns",
+            "region": "ap-northeast-2",
+            "access_key": "${AWS_ACCESS_KEY}",
+            "secret_key": "${AWS_SECRET_KEY}"
+        }
+    },
+    "rate_limit": {
+        "per_number_per_minute": 5,
+        "per_minute": 60,
+        "per_hour": 500
+    },
+    "verification": {
+        "code_length": 6,
+        "ttl_sec": 180,
+        "max_attempts": 5,
+        "cooldown_sec": 60
+    }
+}

package/template/configs/notification/smtp.json

@@ -0,0 +1,43 @@
+{
+    "enabled": false,
+    "default": "main",
+    "workers": 2,
+    "queue_size": 200,
+    "dispatch_interval_sec": 5,
+    "max_retries": 3,
+
+    "providers": {
+        "main": {
+            "host": "smtp.gmail.com",
+            "port": 587,
+            "username": "${SMTP_USERNAME}",
+            "password": "${SMTP_PASSWORD}",
+            "from": "noreply@example.com",
+            "from_name": "My Service",
+            "encryption": "starttls",
+            "auth": "plain",
+            "timeout_sec": 30,
+            "max_connections": 5
+        },
+        "transactional": {
+            "host": "smtp.sendgrid.net",
+            "port": 465,
+            "username": "apikey",
+            "password": "${SENDGRID_API_KEY}",
+            "from": "alerts@example.com",
+            "from_name": "My Service Alerts",
+            "encryption": "ssl",
+            "auth": "plain"
+        }
+    },
+
+    "templates": {
+        "dir": "./configs/templates/email",
+        "default_layout": "layout.html"
+    },
+
+    "rate_limit": {
+        "per_minute": 0,
+        "per_hour": 0
+    }
+}

package/template/configs/server.json

@@ -1,7 +1,9 @@
 {
     "namespace": "entity-prod",
+    "public_url": "https://api.example.com",
     "default_email_domain": "example.com",
     "language": "ko",
+    "timezone": "Asia/Seoul",
     "environment": "production",
     "port": 47200,
     "enable_auto_schema_sync": true,

package/template/entities/README.md

@@ -4,26 +4,25 @@
 
 ## 예제 엔티티 목록
 
-| 파일                                                                       | 설명           | 주요 특징                                                                 |
-| -------------------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------- |
-| [todo.json](#1-todojson)                                                   | 할 일 목록     | 기본 인덱스, 해시 필드                                                    |
-| [product.json](#2-productjson)                                             | 제품 관리      | 유니크 제약, reset_defaults 시딩                                          |
-| [examples/Auth/account.json](#3-examplesauthaccountjson)                   | 사용자 관리    | rbac_role, 인증 훅 / **JWT 사용 시 필수**                                 |
-| [examples/Auth/rbac_roles.json](#4-examplesauthrbac_rolesjson)             | RBAC 역할 정의 | permissions 포함 5개 역할, reset-all 시 자동 시딩 / **RBAC 사용 시 필수** |
-| [examples/Auth/api_keys.json](#5-examplesauthauthapi_keysjson)             | API 키 관리    | HMAC 인증 키, 역할 연결, user_seq 연결 / **HMAC 사용 시 필수**            |
-| [license.json](#6-licensejson)                                             | 라이선스 관리  | 계약/만료일, 유니크 제약, 자동 시딩                                       |
-| [company.json](#7-companyjson)                                             | 회사 정보      | license_scope, 사업자번호 해시, 캐시                                      |
-| [examples/Account/account_audit.json](#8-examplesaccountaccount_auditjson) | 감사 로그      | INSERT 전용, 훅으로 자동 기록                                             |
+| 파일                                                           | 설명           | 주요 특징                                                                 |
+| -------------------------------------------------------------- | -------------- | ------------------------------------------------------------------------- |
+| [todo.json](#1-todojson)                                       | 할 일 목록     | 기본 인덱스, 해시 필드                                                    |
+| [goods.json](#2-goodsjson)                                     | 상품 관리      | 유니크 제약, reset_defaults 시딩                                          |
+| [examples/Auth/account.json](#3-examplesauthaccountjson)       | 사용자 관리    | rbac_role, 인증 훅 / **JWT 사용 시 필수**                                 |
+| [examples/Auth/rbac_roles.json](#4-examplesauthrbac_rolesjson) | RBAC 역할 정의 | permissions 포함 5개 역할, reset-all 시 자동 시딩 / **RBAC 사용 시 필수** |
+| [examples/Auth/api_keys.json](#5-examplesauthauthapi_keysjson) | API 키 관리    | HMAC 인증 키, 역할 연결, user_seq 연결 / **HMAC 사용 시 필수**            |
+| [license.json](#6-licensejson)                                 | 라이선스 관리  | 계약/만료일, 유니크 제약, 자동 시딩                                       |
+| [company.json](#7-companyjson)                                 | 회사 정보      | license_scope, 사업자번호 해시, 캐시                                      |
 
 ## 문서 바로가기
 
-| 섹션                                                         | 내용                                      |
-| ------------------------------------------------------------ | ----------------------------------------- |
-| [포함된 예제](#포함된-예제)                                  | 각 예제 파일 상세 설명                    |
-| [엔티티 설정 규칙](#엔티티-설정-규칙)                        | 자동 추론 필드, Types, index 형식, 복합키 |
-| [훅 (Hooks)](#훅-hooks)                                      | SQL 훅, Entity 훅, 실행 시점, 템플릿 변수 |
-| [라이선스 스코프](#라이선스-스코프란)                        | 멀티테넌트 / 단일 시스템 모드             |
-| [Entity Config Guide](../../docs/ops/entity-config-guide.md) | 전체 엔티티 설정 레퍼런스                 |
+| 섹션                                                                 | 내용                                      |
+| -------------------------------------------------------------------- | ----------------------------------------- |
+| [포함된 예제](#포함된-예제)                                          | 각 예제 파일 상세 설명                    |
+| [엔티티 설정 규칙](#엔티티-설정-규칙)                                | 자동 추론 필드, Types, index 형식, 복합키 |
+| [훅 (Hooks)](#훅-hooks)                                              | SQL 훅, Entity 훅, 실행 시점, 템플릿 변수 |
+| [라이선스 스코프](#라이선스-스코프란)                                | 멀티테넌트 / 단일 시스템 모드             |
+| [Entity Config Guide](../../docs/guides/data/entity-config-guide.md) | 전체 엔티티 설정 레퍼런스                 |
 
 ---
 
@@ -38,7 +37,7 @@
 - 기본 인덱스 필드 (`title`, `status`, `created_time`)
 - 해시 필드 (`user_id`) - 암호화되어 저장
 
-### 2. product.json
+### 2. goods.json
 
 제품 관리 엔티티
 
@@ -50,7 +49,7 @@
 
 ### 3. examples/Auth/account.json
 
-사용자 관리 엔티티 (`entities/examples/Auth/` 에 위치 → 배포 시 `dist/entities/System/Auth/account.json`)
+사용자 관리 엔티티 (`entities-example/Auth/` 에 위치 → 배포 시 `dist/entities/System/Auth/account.json`)
 
 > **⚠️ JWT 인증을 사용하려면 필수입니다.**  
 > HMAC 인증만 사용하는 경우에는 필요하지 않습니다.  
@@ -68,7 +67,7 @@
 
 ### 4. examples/Auth/rbac_roles.json
 
-RBAC 역할 정의 엔티티 (`entities/examples/Auth/` 에 위치 → 배포 시 `dist/entities/System/Auth/rbac_roles.json`)
+RBAC 역할 정의 엔티티 (`entities-example/Auth/` 에 위치 → 배포 시 `dist/entities/System/Auth/rbac_roles.json`)
 
 > **⚠️ RBAC 인증을 사용하려면 필수입니다.**  
 > `reset-all` 실행 시 `reset_defaults`의 5개 역할이 자동 시딩됩니다.  
@@ -84,7 +83,7 @@ RBAC 역할 정의 엔티티 (`entities/examples/Auth/` 에 위치 → 배포
 
 ### 5. examples/Auth/api_keys.json
 
-API 키 관리 엔티티 (`entities/examples/Auth/` 에 위치 → 배포 시 `dist/entities/System/Auth/api_keys.json`)
+API 키 관리 엔티티 (`entities-example/Auth/` 에 위치 → 배포 시 `dist/entities/System/Auth/api_keys.json`)
 
 > **⚠️ HMAC 인증을 사용하려면 필수입니다.**  
 > `reset-all` 실행 시 admin 역할의 API 키 1개가 자동 생성되며 `key_value`와 `hmac_secret`이 출력됩니다.  
@@ -130,8 +129,6 @@ API_KEY=<admin-key> ./scripts/api-keys.sh delete 3
 - 해시 필드 (`tax_id`) - 사업자번호 암호화
 - 캐시 활성화 (TTL 300초)
 
-### 8. examples/Account/account_audit.json
-
 사용자 감사 로그 엔티티
 
 **특징**:

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

@@ -1,6 +1,6 @@
 {
     "name": "account",
-    "description": "JWT 로그인/인증 계정 예제",
+    "description": "JWT 로그인/인증 계정 예제. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
     "index": {
         "user_seq": {
             "comment": "사용자번호"
@@ -41,6 +41,22 @@
                 "params": ["${new.seq}", "INSERT", "${new.email}"],
                 "async": false
             }
+        ],
+        "after_update": [
+            {
+                "type": "sql",
+                "query": "INSERT INTO account_audit (account_seq, action, email, created_time) VALUES (?, ?, ?, NOW())",
+                "params": ["${new.seq}", "UPDATE", "${new.email}"],
+                "async": false
+            }
+        ],
+        "after_delete": [
+            {
+                "type": "sql",
+                "query": "INSERT INTO account_audit (account_seq, action, email, created_time) VALUES (?, ?, ?, NOW())",
+                "params": ["${old.seq}", "DELETE", "${old.email}"],
+                "async": false
+            }
         ]
     }
 }

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

@@ -0,0 +1,23 @@
+{
+    "name": "account_audit",
+    "description": "account 감사 로그. account.json 훅(after_insert/after_update/after_delete)에 의해 자동 기록됩니다. 사용자 환경에 맞게 index·fields를 자유롭게 확장할 수 있습니다.",
+    "hard_delete": true,
+    "read_only": true,
+    "compress": true,
+    "index": {
+        "account_seq": {
+            "comment": "계정 seq (JWT 인증 시 account.seq 참조. HMAC은 nullable)",
+            "type": "bigint",
+            "nullable": true
+        },
+        "action": {
+            "comment": "작업 유형 (after_insert → INSERT, after_update → UPDATE, after_delete → DELETE)",
+            "type": ["INSERT", "UPDATE", "DELETE"],
+            "required": true
+        },
+        "email": {
+            "comment": "작업 대상 계정 이메일",
+            "nullable": true
+        }
+    }
+}