create-entity-server 0.0.26 → 0.0.31

package/template/entities/System/Notification/alimtalk_msg.json

@@ -0,0 +1,53 @@
+{
+    "name": "alimtalk_msg",
+    "description": "알림톡 발송 트리거 엔티티 — Hook 또는 API를 통해 생성되면 알림톡 발송이 시작됩니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "history": false,
+    "fields": {
+        "template_code": {
+            "index": true,
+            "comment": "카카오 알림톡 템플릿 코드",
+            "required": true
+        },
+        "receiver": {
+            "index": true,
+            "hash": true,
+            "comment": "수신자 전화번호",
+            "required": true
+        },
+        "status": {
+            "index": true,
+            "type": [
+                "pending",
+                "processing",
+                "sent",
+                "delivered",
+                "failed"
+            ],
+            "default": "pending",
+            "comment": "발송 상태 (delivered = 프로바이더 수신 확인)"
+        },
+        "variables_json": {
+            "type": "text",
+            "comment": "템플릿 변수 JSON (#{key} 바인딩)"
+        },
+        "provider": {
+            "comment": "프로바이더 키 (빈 값이면 default)"
+        },
+        "ref_entity": {
+            "comment": "참조 엔티티 이름"
+        },
+        "ref_seq": {
+            "type": "int"
+        }
+    },
+    "hooks": {
+        "after_insert": [
+            {
+                "type": "alimtalk",
+                "alimtalk_receiver": "${new.receiver}",
+                "alimtalk_template_code": "${new.template_code}",
+                "alimtalk_variables": "${new.variables_json}"
+            }
+        ]
+    }
+}

package/template/entities/System/Notification/friendtalk_log.json

@@ -0,0 +1,89 @@
+{
+    "name": "friendtalk_log",
+    "description": "친구톡(브랜드메시지) 발송 로그 — 워커가 소비하는 DB 큐 역할을 합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "history": false,
+    "read_only": true,
+    "compress": true,
+    "fields": {
+        "status": {
+            "index": true,
+            "type": [
+                "pending",
+                "processing",
+                "sent",
+                "failed",
+                "expired"
+            ],
+            "default": "pending",
+            "comment": "발송 상태"
+        },
+        "msg_type": {
+            "index": true,
+            "type": [
+                "text",
+                "image",
+                "wide_image",
+                "wide_item_list",
+                "carousel"
+            ],
+            "default": "text"
+        },
+        "receiver": {
+            "index": true,
+            "hash": true,
+            "comment": "수신자 전화번호",
+            "required": true
+        },
+        "friendtalk_msg_seq": {
+            "index": true,
+            "comment": "friendtalk_msg 참조 seq"
+        },
+        "content": {
+            "type": "text",
+            "comment": "메시지 본문"
+        },
+        "image_url": {
+            "comment": "이미지 URL"
+        },
+        "image_link": {
+            "comment": "이미지 클릭 시 이동 URL"
+        },
+        "is_ad": {
+            "type": "bool",
+            "default": true,
+            "comment": "광고성 메시지 여부"
+        },
+        "buttons_json": {
+            "type": "text",
+            "comment": "버튼 목록 JSON"
+        },
+        "carousel_json": {
+            "type": "text",
+            "comment": "캐러셀 데이터 JSON"
+        },
+        "items_json": {
+            "type": "text",
+            "comment": "와이드 아이템 리스트 JSON"
+        },
+        "header": {
+            "comment": "와이드 아이템 리스트 헤더"
+        },
+        "provider": {
+            "comment": "사용 프로바이더"
+        },
+        "provider_msg_id": {
+            "comment": "프로바이더 메시지 ID"
+        },
+        "error_message": {
+            "type": "text",
+            "comment": "오류 메시지"
+        },
+        "retry_count": {
+            "type": "uint",
+            "default": 0
+        },
+        "sent_at": {
+            "type": "string"
+        }
+    }
+}

package/template/entities/System/Notification/friendtalk_msg.json

@@ -0,0 +1,91 @@
+{
+    "name": "friendtalk_msg",
+    "description": "친구톡(브랜드메시지) 발송 트리거 엔티티 — Hook 또는 API를 통해 생성되면 친구톡 발송이 시작됩니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "history": false,
+    "fields": {
+        "receiver": {
+            "index": true,
+            "hash": true,
+            "comment": "수신자 전화번호",
+            "required": true
+        },
+        "msg_type": {
+            "index": true,
+            "type": [
+                "text",
+                "image",
+                "wide_image",
+                "wide_item_list",
+                "carousel"
+            ],
+            "default": "text"
+        },
+        "status": {
+            "index": true,
+            "type": [
+                "pending",
+                "processing",
+                "sent",
+                "failed"
+            ],
+            "default": "pending"
+        },
+        "content": {
+            "type": "text",
+            "required": true,
+            "comment": "메시지 본문"
+        },
+        "image_url": {
+            "comment": "이미지 URL"
+        },
+        "image_link": {
+            "comment": "이미지 클릭 시 이동 URL"
+        },
+        "is_ad": {
+            "type": "bool",
+            "default": true,
+            "comment": "광고성 메시지 여부"
+        },
+        "buttons_json": {
+            "type": "text",
+            "comment": "버튼 목록 JSON"
+        },
+        "carousel_json": {
+            "type": "text",
+            "comment": "캐러셀 데이터 JSON"
+        },
+        "items_json": {
+            "type": "text",
+            "comment": "와이드 아이템 리스트 JSON"
+        },
+        "header": {
+            "comment": "와이드 아이템 리스트 헤더"
+        },
+        "provider": {
+            "comment": "프로바이더 키 (빈 값이면 default)"
+        },
+        "ref_entity": {
+            "comment": "참조 엔티티 이름"
+        },
+        "ref_seq": {
+            "type": "int"
+        }
+    },
+    "hooks": {
+        "after_insert": [
+            {
+                "type": "friendtalk",
+                "friendtalk_receiver": "${new.receiver}",
+                "friendtalk_content": "${new.content}",
+                "friendtalk_msg_type": "${new.msg_type}",
+                "friendtalk_image_url": "${new.image_url}",
+                "friendtalk_image_link": "${new.image_link}",
+                "friendtalk_is_ad": "${new.is_ad}",
+                "friendtalk_buttons_json": "${new.buttons_json}",
+                "friendtalk_carousel_json": "${new.carousel_json}",
+                "friendtalk_items_json": "${new.items_json}",
+                "friendtalk_header": "${new.header}"
+            }
+        ]
+    }
+}

package/template/entities/System/Notification/sms_log.json

@@ -0,0 +1,65 @@
+{
+    "name": "sms_log",
+    "description": "SMS/LMS/MMS 발송 이력 로그. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "hard_delete": true,
+    "history": false,
+    "read_only": true,
+    "compress": true,
+    "fields": {
+        "status": {
+            "index": true,
+            "type": [
+                "pending",
+                "processing",
+                "sent",
+                "failed"
+            ]
+        },
+        "msg_type": {
+            "index": true,
+            "type": [
+                "sms",
+                "lms",
+                "mms"
+            ]
+        },
+        "receiver": {
+            "index": true,
+            "hash": true,
+            "type": "string"
+        },
+        "sms_msg_seq": {
+            "index": true,
+            "comment": "sms_msg 참조 seq"
+        },
+        "sender": {
+            "type": "string"
+        },
+        "subject": {
+            "type": "string"
+        },
+        "content": {
+            "type": "string"
+        },
+        "image_url": {
+            "type": "string",
+            "comment": "MMS 이미지 URL"
+        },
+        "provider": {
+            "type": "string"
+        },
+        "provider_msg_id": {
+            "type": "string"
+        },
+        "error_message": {
+            "type": "string"
+        },
+        "retry_count": {
+            "type": "uint"
+        },
+        "sent_at": {
+            "type": "string"
+        }
+    }
+}

package/template/entities/System/Notification/sms_msg.json

@@ -0,0 +1,82 @@
+{
+    "name": "sms_msg",
+    "description": "SMS/LMS/MMS 발송 트리거 엔티티. insert 시 sms hook으로 비동기 발송. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "hard_delete": true,
+    "history": false,
+    "read_only": true,
+    "fields": {
+        "status": {
+            "index": true,
+            "type": [
+                "queued",
+                "sent",
+                "failed"
+            ],
+            "default": "queued"
+        },
+        "msg_type": {
+            "index": true,
+            "type": [
+                "sms",
+                "lms",
+                "mms"
+            ],
+            "default": "sms"
+        },
+        "receiver": {
+            "index": true,
+            "hash": true,
+            "type": "string",
+            "required": true,
+            "comment": "수신 전화번호"
+        },
+        "sender": {
+            "type": "string",
+            "comment": "발신번호"
+        },
+        "subject": {
+            "type": "string",
+            "comment": "LMS/MMS 제목 (SMS는 미사용)"
+        },
+        "content": {
+            "type": "string",
+            "comment": "메시지 본문"
+        },
+        "image_url": {
+            "type": "string",
+            "comment": "MMS 이미지 URL"
+        },
+        "provider": {
+            "type": "string",
+            "comment": "발송 프로바이더 키"
+        },
+        "provider_msg_id": {
+            "type": "string",
+            "comment": "프로바이더 메시지 ID"
+        },
+        "ref_entity": {
+            "type": "string"
+        },
+        "ref_seq": {
+            "type": "int"
+        },
+        "error_message": {
+            "type": "string"
+        },
+        "sent_at": {
+            "type": "string"
+        }
+    },
+    "hooks": {
+        "after_insert": [
+            {
+                "type": "sms",
+                "enabled": true,
+                "sms_receiver": "${new.receiver}",
+                "sms_content": "${new.content}",
+                "sms_subject": "${new.subject}"
+            }
+        ]
+    }
+}

package/template/entities/System/Notification/sms_verification.json

@@ -0,0 +1,50 @@
+{
+    "name": "sms_verification",
+    "description": "SMS 인증번호 검증 엔티티. 인증번호 SHA-256 해시 저장, 시도 횟수 관리. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "hard_delete": true,
+    "history": false,
+    "fields": {
+        "phone": {
+            "index": true,
+            "hash": true,
+            "comment": "수신 전화번호",
+            "type": "varchar(20)",
+            "required": true
+        },
+        "purpose": {
+            "index": true,
+            "comment": "인증 목적",
+            "type": [
+                "signup",
+                "password_reset",
+                "identity"
+            ],
+            "required": true
+        },
+        "status": {
+            "index": true,
+            "type": [
+                "pending",
+                "verified",
+                "expired"
+            ],
+            "default": "pending",
+            "required": true
+        },
+        "code_hash": {
+            "type": "varchar(64)",
+            "required": true,
+            "comment": "인증번호 SHA-256 해시"
+        },
+        "expires_at": {
+            "required": true,
+            "comment": "만료 시각"
+        },
+        "attempts": {
+            "type": "uint",
+            "default": 0,
+            "comment": "검증 시도 횟수"
+        }
+    }
+}

package/template/entities/System/Payment/pg_cancel.json

@@ -0,0 +1,60 @@
+{
+    "name": "pg_cancel",
+    "description": "PG 결제 취소 이력 엔티티. 부분/전액 취소를 기록합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "read_only": true,
+    "fields": {
+        "order_seq": {
+            "index": true,
+            "type": "integer",
+            "required": true,
+            "comment": "pg_order.seq 참조"
+        },
+        "order_id": {
+            "index": true,
+            "type": "string",
+            "required": true,
+            "comment": "주문번호 (조회 편의)"
+        },
+        "cancel_amount": {
+            "index": true,
+            "type": "integer",
+            "required": true,
+            "comment": "취소 금액"
+        },
+        "cancel_reason": {
+            "index": true,
+            "type": "string",
+            "required": true,
+            "comment": "취소 사유 (최대 200자)"
+        },
+        "cancel_status": {
+            "index": true,
+            "type": [
+                "done",
+                "failed"
+            ],
+            "default": "done",
+            "comment": "취소 처리 상태"
+        },
+        "transaction_key": {
+            "index": true,
+            "type": "string",
+            "comment": "PG사 취소 거래 키"
+        },
+        "canceled_time": {
+            "comment": "취소 시각 (ISO 8601)"
+        },
+        "refundable_amount": {
+            "comment": "취소 후 환불 가능 잔액"
+        },
+        "tax_free_amount": {
+            "comment": "취소된 금액 중 면세 금액"
+        },
+        "receipt_key": {
+            "comment": "현금영수증 키 (해당 시)"
+        },
+        "refund_account": {
+            "comment": "환불 계좌 정보 JSON (가상계좌 취소 시)"
+        }
+    }
+}

package/template/entities/System/Payment/pg_order.json

@@ -0,0 +1,115 @@
+{
+    "name": "pg_order",
+    "description": "PG 결제 주문 엔티티. 결제 요청/승인/취소 상태를 추적합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "order_id": {
+            "index": true,
+            "type": "string",
+            "required": true,
+            "unique": true,
+            "comment": "고유 주문번호 (6~64자, [a-zA-Z0-9_-])"
+        },
+        "status": {
+            "index": true,
+            "type": [
+                "created",
+                "ready",
+                "in_progress",
+                "waiting",
+                "done",
+                "canceled",
+                "partial_canceled",
+                "aborted",
+                "expired"
+            ],
+            "default": "created",
+            "comment": "결제 상태"
+        },
+        "payment_key": {
+            "index": true,
+            "type": "string",
+            "comment": "PG사 결제 키 (승인 후 할당)"
+        },
+        "provider": {
+            "index": true,
+            "type": "string",
+            "required": true,
+            "comment": "PG 프로바이더 키 (toss_payments, kcp, inicis 등)"
+        },
+        "method": {
+            "index": true,
+            "type": "string",
+            "comment": "결제수단 (card, virtual_account, transfer, phone, easy_pay)"
+        },
+        "amount": {
+            "index": true,
+            "type": "integer",
+            "required": true,
+            "comment": "총 결제 금액 (원)"
+        },
+        "balance_amount": {
+            "index": true,
+            "type": "integer",
+            "comment": "취소 가능 잔액"
+        },
+        "currency": {
+            "index": true,
+            "type": "string",
+            "default": "KRW",
+            "comment": "통화 코드 (ISO 4217)"
+        },
+        "account_seq": {
+            "index": true,
+            "type": "integer",
+            "comment": "구매자 계정 seq (로그인 사용자)"
+        },
+        "customer_name": {
+            "index": true,
+            "hash": true,
+            "type": "string",
+            "comment": "구매자명"
+        },
+        "customer_email": {
+            "index": true,
+            "hash": true,
+            "type": "string",
+            "comment": "구매자 이메일"
+        },
+        "order_name": {
+            "comment": "주문 상품명 (예: '토스 티셔츠 외 2건')"
+        },
+        "requested_time": {
+            "comment": "결제 요청 시각 (ISO 8601)"
+        },
+        "approved_time": {
+            "comment": "결제 승인 시각 (ISO 8601)"
+        },
+        "card_info": {
+            "comment": "카드 결제 정보 JSON (마스킹된 카드번호, 카드타입 등)"
+        },
+        "virtual_account_info": {
+            "comment": "가상계좌 정보 JSON (계좌번호, 은행, 입금기한)"
+        },
+        "easy_pay_info": {
+            "comment": "간편결제 정보 JSON (provider, amount, discountAmount)"
+        },
+        "receipt_url": {
+            "comment": "영수증 URL"
+        },
+        "checkout_url": {
+            "comment": "결제창 URL"
+        },
+        "failure_code": {
+            "comment": "실패 에러 코드"
+        },
+        "failure_message": {
+            "comment": "실패 에러 메시지"
+        },
+        "metadata": {
+            "comment": "상점 커스텀 데이터 JSON (최대 5개 key-value)"
+        },
+        "pg_raw_response": {
+            "comment": "PG사 원본 응답 JSON (디버깅용)"
+        }
+    }
+}

package/template/entities/System/Payment/pg_webhook_log.json

@@ -0,0 +1,52 @@
+{
+    "name": "pg_webhook_log",
+    "description": "PG 웹훅 수신 이력. 모든 수신 이벤트를 기록합니다. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "hard_delete": true,
+    "read_only": true,
+    "compress": true,
+    "fields": {
+        "event_type": {
+            "index": true,
+            "type": "string",
+            "required": true,
+            "comment": "웹훅 이벤트 타입 (payment.done, payment.canceled 등)"
+        },
+        "order_id": {
+            "index": true,
+            "type": "string",
+            "comment": "관련 주문번호"
+        },
+        "payment_key": {
+            "index": true,
+            "type": "string",
+            "comment": "관련 결제 키"
+        },
+        "status": {
+            "index": true,
+            "type": [
+                "received",
+                "processed",
+                "failed"
+            ],
+            "default": "received",
+            "comment": "웹훅 처리 상태"
+        },
+        "provider": {
+            "index": true,
+            "type": "string",
+            "comment": "PG 프로바이더 키"
+        },
+        "payload": {
+            "comment": "수신한 웹훅 원본 JSON"
+        },
+        "processed_time": {
+            "comment": "처리 완료 시각"
+        },
+        "error_message": {
+            "comment": "처리 실패 시 에러 메시지"
+        },
+        "signature": {
+            "comment": "웹훅 서명값 (검증용)"
+        }
+    }
+}