> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front/undefined/undefined-3.md).

# 이벤트 응모

로그인한 회원이 해당 이벤트 상세 페이지에서 응모 버튼 클릭 시 등록하는 기능을 제공합니다. 이벤트 유형에는 추첨이벤트(단순클릭응모, 구매자추첨, 룰렛, 설문, 댓글)와 비추첨이벤트(출석체크, 구매사은, 쿠폰다운로드, 기타\[HTML])로 나누어집니다.

***

## 주요 기능

* **이벤트 응모**
  * 기타\[HTML] 제외한 이벤트에서 응모 기능을 제공합니다.
  * 댓글 이벤트의 경우, 작성한 댓글을 수정/삭제할 수 있습니다.
* **응모 체크**
  * 기본적인 응모 체크를 수행합니다.
  * 이벤트 여부, 응모 가능 등급 체크, 사용자 조회(로그인 여부) 등을 확인합니다.
  * 응모수 제한 체크(1일 1회 또는 행사 기간 1회)를 수행합니다.
  * ordDB와 evtDB의 회원 동기화 여부를 확인합니다.
  * 응모 기간 체크 및 각 유형별 특정 조건 체크를 수행합니다.
  * 구매자 추첨, 구매사은의 경우 주문 금액 체크를 합니다.
  * 쿠폰 다운로드의 경우 쿠폰 수량 체크를 수행합니다.
* **응모 완료 시 처리**
  * 비추첨 이벤트(출석체크, 쿠폰다운로드, 룰렛)인 경우, 응모하여 당첨되는 즉시 경품 또는 마일리지를 지급합니다.
  * 구매사은 또는 구매자 추첨인 경우, 응모 횟수는 행사 기간 1회로 설정됩니다.
* **댓글 수정 및 삭제**
  * 댓글 이벤트에서는 본인이 작성한 댓글을 수정 및 삭제할 수 있습니다.
  * 로그인이 필수이며, 본인 외의 댓글 수정 및 삭제는 불가능합니다.
  * 댓글 삭제 시 응모 이력은 사라집니다.

## 프로세스 정의

<figure><img src="/files/TcXSreChE0kc9N2rdMb3" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 응모하기

회원이 이벤트 응모를 할 때, 로그인 상태일 시 응모 체크 로직으로 넘어가고 비로그인 상태일 시, 로그인 페이지로 이동됩니다.
{% endstep %}

{% step %}

### 댓글 수정/삭제

본인이 작성한 댓글을 수정/삭제하는 기능입니다. 로그인 필수이며, 본인이 쓴 댓글만 수정/삭제가 가능합니다. 댓글 삭제 시, 응모이력도 삭제됩니다.
{% endstep %}

{% step %}

### 응모 체크

기본 이벤트 정보와 유형에 따른 체크 로직 검수를 진행합니다. 체크 실패 시, 해당 사항에 대한 Alert를 노출합니다.
{% endstep %}

{% step %}

### 응모 로직 확인

추첨이벤트(룰렛 제외)의 경우, 해당 회원은 응모자로 구분됩니다. 룰렛, 출석체크, 쿠폰 다운로드의 경우 응모가 된 순간, 리워드가 즉시 지급되므로 당첨자로서 구분됩니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="112.333251953125">API</th><th width="243.5555419921875">설명</th><th width="93.3333740234375">Server</th><th width="89">메소드</th><th>비고</th></tr></thead><tbody><tr><td>이벤트 응모 처리</td><td>로그인 한 회원이 이벤트 상세 페이지에서 응모 버튼을 클릭하여 응모를 합니다.</td><td>Event</td><td>POST</td><td><p><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8&#x26;path=registerEvent">🔗API 확인하기 ></a></p><p>주문정보 조회: /api/order/v1/event/evtOrdList<br>쿠폰 발급: /api/order/v1/marketing/cpnDown<br>마일리지 적립: /api/member/v1/mileage/mlgSaveUse</p></td></tr><tr><td>이벤트 댓글 수정</td><td>로그인 한 본인의 댓글을 수정합니다.</td><td>Event</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8&#x26;path=updateEventEntryReply">🔗API 확인하기 ></a></td></tr><tr><td>이벤트 댓글 삭제</td><td>로그인 한 본인이 작성한 댓글을 삭제합니다.</td><td>Event</td><td>POST</td><td><a href="https://api.x2bee.com/content?msa=event&#x26;depth=%EC%9D%B4%EB%B2%A4%ED%8A%B8%20%EC%9D%91%EB%AA%A8&#x26;path=deleteEventEntryReply">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="165.111083984375">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>전시기간​</td><td>이벤트가 이벤트 목록에서 전시되는 기간을 말합니다.​ 전시기간이 끝난 이벤트는 상세 진입이 안됩니다.​</td><td></td></tr><tr><td>응모기간(행사기간)​</td><td>이벤트 상세 화면에서 응모 버튼 눌렀을때, 응모 할 수 있는 기간을 말합니다.​</td><td></td></tr><tr><td>구매기간​</td><td>이벤트에 적용되는 상품을 구매할 수 있는 기간을 말합니다.​</td><td></td></tr><tr><td>추첨이벤트​</td><td>기업에서 소비자들에게 사은품, 마일리지, 쿠폰 등 다양한 상품을 제공하기 위해 추첨을 통해 선발하는 이벤트를 말합니다​</td><td></td></tr><tr><td>비추첨이벤트​</td><td>참여자들이 특정 조건을 만족하거나 특별한 활동을 수행함으로써 혜택(쿠폰,마일리지)을 지급하는 이벤트를 말합니다.​<br>(추첨이 아닌 즉시지급-출석, 구매사은 등)​</td><td></td></tr><tr><td>이벤트리워드​</td><td>이벤트에 참여한 사람들에게 주어지는 보상이나 혜택을 나타냅니다. ​<br>이벤트 당첨 시, 제공하는 혜택 정보에는 사은품, 경품, 마일리지, 쿠폰 등이 있습니다.​</td><td></td></tr></tbody></table>

## 기타 참고사항

* **이벤트 유형별 리워드**
  * 단순클릭/구매자추첨/설문/댓글 : 경품 / 마일리지 / 쿠폰
  * 룰렛 : 마일리지 / 쿠폰
  * 출석체크 : 마일리지
  * 구매사은 : 사은품 / 경품 / 마일리지 / 쿠폰
  * 쿠폰다운로드 : 쿠폰<br>
* **이벤트 세부사항 및 추가항목**
  * 출석체크 : 회차 정보(aply\_Rnk) – CC\_EVT\_DETL\_ITEM
  * 룰렛 : 룰렛 확률(rolt\_prbl) – CC\_EVT\_DETL\_ITEM -> 룰렛 확률은 합산값이 100보다 크면 안되며 각 확률은 0보다 커야한다.
  * 설문 : 질문구분코드(EV017) – \[객관형 : 10], \[객관형(기타) : 20], \[객관형(이미지) : 30], \[주관형 : 40], \[척도형 : 50] -> 질문내용 기입 필수. \
    -> 로그인 시, 질문 답변 정보( QUEST\_ANS\_CONT ) 또는 답변번호( ANS\_NO ) 를 가져옵니다. \
    \> CC\_EVT\_QUEST\_INFO : 이벤트 질문정보 \
    \> CC\_EVT\_QUEST\_ANS\_INFO : 이벤트 질문답변정보
* 이벤트 응모 시, CC\_EVT\_TRGMN\_INFO 테이블에서 응모이력을 확인할 수 있습니다.
* 이벤트 응모 시, 공통코드 EV002(이벤트 중분류코드) 에 해당하는 값에 따라 유형별 체크 로직, 응모 로직을 호출하여 응모합니다.
* 같은 계정으로 동시다발적으로 MO, PC에서 응모하는 것을 방지하기 위해 Redis-CacheManager를 사용하여 0.03초 간격으로 응모가 가능합니다.