KORAIL_STORE

[API] POST /store_order_subscribe (구독상품 주문)
- refer to /store_order

1.logic (difference with /store_order)
  1) if (orderVO.getPaymentAmount() == null || orderVO.getPaymentAmount() == 0) - PG is not called
    a) don't process processMinusStockCount() (bcz stock_count is not managed)
    b) process productApiService.insertOrCancelSaleInfo()
  2) DB (st_order)
    0) order_type : 'subscribe'
    a) subscribe_status : 'SU01' -> NULL
    b) subscribe_start_date : set by today
    c) subscribe_end_date : set by today + {st_product.subscribe_days}
    d) subscribe_count : set by {st_product.subscribe_count}
    e) subscribe_days : set by {st_product.subscribe_days}
    f) subscribe_extend_yn : set by {st_product.subscribe_extend_yn}
    g) subscribe_extend_days : set by {st_product.subscribe_extend_days}
    h) smart_order_status : NULL (it's not used)

[API] POST /pay_confirm

1.logic (change)
  1) if order_type = 'subscribe'
    a) don't process processMinusStockCount() (bcz stock_count is not managed)
    b) process productApiService.insertOrCancelSaleInfo()
    c) don't make {receive_no} (line: 902)

[API] GET /order

1.add response
  - order_type / subscribe_status / subscribe_start_date / subscribe_end_date

[API] GET /api/subscribe/product_list (구독상품 리스트)

1.Response
  1) add fields
    a) subscribe_count : 구독상품개수(총이용상품수)
      - set by {st_order.subscribe_count}
    b) receive_count : 구독상품 이용개수
      - SUM(product_count) FROM st_order_subscribe_receive WHERE order_no={the order_no}
    c) subscribe_extend_yn : 사용자구독연장가능여부
      - set by {st_order.subscribe_extend_yn}
    d) subscribe_extend_count : 구독상품 연장횟수
      - COUNT(*) FROM st_order_subscribe_extend WHERE order_no={the order_no} AND extend_type='user'
 

[API] GET /api/pos/order_subscribe_product_receive (스마트오더 구독상품 수령 완료)

- refer to GET /api/pos/user_point_use

1.Request parameters
  a) access_token
  b) id
  c) mall_code
  d) order_no

2.logic

  1) validate parameters
    a) access_token / id / mall_code / order_no : refer to user_point_use API
    b) order_no
      b-1) if {st_order.order_type} != 'subscribe'
        - return error msg: [subscribe.error.notSubscribeOrder] "구독상품 주문이 아닙니다."
    c) if {st_order.subscribe_end_date} < today
      - return error msg: [subscribe.error.expirePeriod] "구독 기간 만료로 수령이 불가합니다."
    d) if {st_order.subscribe_count} <= {receiveCount}
      - {receiveCount} : SUM(product_count) FROM st_order_subscribe_receive WHERE order_no={the order_no}
      - return error msg: [subscribe.error.allReceived] "잔여 수량이 없어 수령이 불가합니다."
    e) if {todayReceiveCount} >= 2
      - {todayReceiveCount} : COUNT FROM st_order_subscribe_receive WHERE order_no={the order_no} AND reg_date={today}
      - return error msg: [subscribe.error.overReceiveCount] "하루 최대 2개까지만 수령이 가능합니다."

  2) process
    a) INSERT st_order_subscribe_receive
      order_no: order_no param
      seq_no : max(seq_no) + 1 per order_no
      mall_code : mall_code of the order_no
      product_code : order's product_code
      product_count : 1
      reg_date / reg_user_seq
 

[ADMIN] 스토리 오더 관리 > 구독 상품 주문 관리 > 상세 (Modify)

1.구독 상태 : {subscribe_status} field (-> apply into List page > Grid > 구독상태 column too)
  1) logic change
    a) if {subscribe_status} != NULL
      - show SU code name with the value
    b) else
      a-1) if st_order.subscribe_start_date <= today <= subscribe_end_date
        - show SU01 (구독중)
      a-2) if subscribe_end_date < today
        - show SU02 (구독만료)

2.저장 (Save) - logic change
  1) if {subscribe_status} is changed with SU03 (구독취소 - cancel subscribe)
    a) call PG cancel 
      a-1) st_order_payment 
      a-2) st_order
        - subscribe_status = 'SU03', mod_date / mod_user_seq
        - don't update smart_order_status (it's kept with NULL)
    b) process productApiService.insertOrCancelSaleInfo()
      - cancel option

구독 관련 내용은 코레일유통에서도 데이터 추가 및 개발 처리를 해줘야 하는 부분이라서 5월 10일까지 처리 완료해야 하는 내용에서 빼기로 했습니다.

이 부분은 다른 이슈 처리하고 따로 논의해서 일정을 잡는 걸로 얘기해서, 기존 개발하시던 내용에서 연동이 필요한 부분은 보류 부탁드립니다.

[ADMIN] 구독 상품 등록 관리 (/subscribeProduct) > 상세 (Modify)

1.currently, page is not displayed (http://210.123.124.139:8084/subscribeProduct/PD10002?menuCode=M7010)

2.fields
  1) 구독기간 / 사용자 연장일
    - append '일' unit (append after inputbox(readonly))
  3) 총 이용 상품 수
    - append '개' unit (append after inputbox(readonly))

[ADMIN] 구독 상품 주문 관리 (/subscribeOrder) > 상세 (Modify)

1.fields
  1) 현재 이용 수량
    - 잔여 (remain count) : = subscribe_count - receive count (fix)
  2) 구독기간 / 사용자 연장일
    - append '일' unit (append after inputbox(readonly))
  3) 현재 이용 수량 / 총 이용 상품 수
    - append '개' unit (append after inputbox(readonly))

[ADMIN] 구독 상품 연장 관리 (/subscribeExtend) > 상세 (Modify)

1.field
  1) 구독 상태
    - same with comment 15 (apply into Grid > 구독 상태 column too)

  2) 구독기간
    - append '일' unit (append after inputbox(readonly))

  3) 총 이용 상품 수
    - append '개' unit (append after inputbox(readonly))

2.수령 기록 (receive history) modal
  1) Grid columns
    - decrease 수령일시 width and increase 매장명 width

3.관리자 연장 (admin subscribe extend) 
  1) 연장 (extend)
    a) fix logic
      - subscribe_start_date : no change
      - subscribe_end_date : is extended