[질문] 마일리지(적립금) 기능 구현 계획 및 커스텀 구현 시 마이그레이션 호환성 문의

[wnsdlf1234-rgb]

안녕하세요. 그누보드7 베타를 사용 중인 개발자입니다.

현재 베타 버전을 확인해보니 마일리지(적립금) 관련 로직이 아직
구현되어 있지 않은 것으로 보입니다. 관련하여 두 가지 문의드립니다.

1. 구현 계획

• 마일리지(적립금) 기능이 정식 로드맵에 포함되어 있는지 궁금합니다.
• 포함되어 있다면 대략적인 지원 예정 시점(마일스톤/버전)을 알 수 있을까요?

2. 커스텀 구현 시 호환성

• 정식 기능이 나오기 전에 자체적으로 마일리지 로직을 구현하여 운영하려고 합니다.
• 추후 공식 기능이 추가되었을 때, 기존 데이터(테이블 구조, 컬럼명 등)와의 충돌이나 마이그레이션 이슈가 발생할 가능성이있을지 궁금합니다.
• 가능하다면 향후 도입될 마일리지 관련 테이블/컬럼 네이밍 규칙을 미리 피해서 설계하고 싶어, 참고할 만한 방향성이 있다면 알려주시면 감사하겠습니다.

확인 부탁드립니다.

감사합니다

[HeuJung]

@wnsdlf1234-rgb

안녕하세요. 그누보드7에 관심 가져주셔서 감사합니다.

1. 마일리지 기능 구현 계획
마일리지 기능은 정식 버전에 포함 예정이며, 정식 버전은 7/1 출시를 목표로 하고 있습니다.

다만, 현재로서는 정식 버전에서 요구하는 안정성과 편의성, 기능성을 종합적으로 보완하고 있는 작업에 집중하고 있다 보니, 정식버전 출시 이전 마일리지 기능만 단독으로 지원할 계획은 없습니다. 이 점 양해 부탁드립니다.

2. 커스텀 구현 시 호환성
아래와 같은 기능을 제공하는 것으로 목표하고 있습니다.

• 쇼핑몰 환경설정 > 마일리지 설정 화면 신설

  • 마일리지 사용여부
  • 기본 적립률 (상품 등록시 기본값)
  • 적립 시점 (배송완료/구매확정 후 X일 경과 시 적립)
  • 통화별 사용단위: 1점당 금액, 최소 사용 금액, ㅅ용 단위, 최대 사용한도 등
  • 유효기간: 적립 후 X일 경과 시 소멸
  • 소멸 예정 알림: 만료 X일 전 알림 채널로 알림 발송

• 스키마 구조 (아직 확정되지 않았으며, 실제 출시 시점에 달라질 수 있으니 참고만 부탁드립니다)

테이블명: ecommerce_mileage_transactions

컬럼	타입	설명
id	bigint unsigned PK	거래 ID
user_id	bigint unsigned FK(users)	회원 ID
currency	varchar(10) default 'KRW'	통화 코드
type	varchar(30) NOT NULL	MileageTransactionTypeEnum
amount	decimal(12,2) NOT NULL	거래 금액 (양수=적립, 음수=차감)
remaining_amount	decimal(12,2) default 0	잔여 금액 (적립건만 양수, FIFO용)
balance_after	decimal(12,2) NOT NULL	거래 후 잔액 (감사 로그용)
order_id	bigint unsigned nullable FK	관련 주문 ID
order_option_id	bigint unsigned nullable FK	관련 주문옵션 ID
source_transaction_id	bigint unsigned nullable FK(self)	원본 적립건 ID (차감 시 FIFO 추적)
granted_by	bigint unsigned nullable (FK 없음)	부여 주체 (NULL=시스템, user ID=관리자). 감사 로그 성격이므로 FK 미적용
description	varchar(500) nullable	거래 설명
memo	text nullable	관리자 메모
expires_at	timestamp nullable	유효기간 만료일 (적립건만)
expired_at	timestamp nullable	실제 소멸 처리일
metadata	json nullable	추가 정보
created_at, updated_at	timestamp

MileageTransactionTypeEnum
case PURCHASE_EARN = 'purchase_earn';
case ADMIN_EARN = 'admin_earn';
case ORDER_USE = 'order_use';
case ADMIN_DEDUCT = 'admin_deduct';
case EXPIRED = 'expired';
case REFUND_RESTORE = 'refund_restore';
case ORDER_CANCEL_RESTORE = 'order_cancel_restore';
case EARN_CANCEL = 'earn_cancel';

감사합니다.