> For the complete documentation index, see [llms.txt](https://guide.hypercape.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.hypercape.com/brand-guide/form-events/undefined-4.md).

# 이벤트 상태와 운영 제어

## Part 5 · 이벤트 상태와 운영 제어

폼 이벤트는 **두 가지 상태값**을 동시에 가집니다. 하나는 시간이 흐르면 자동으로 바뀌고, 다른 하나는 운영자가 필요할 때 직접 켜고 끕니다. 이 두 상태가 합쳐져서 응모자에게 폼이 노출될지가 결정됩니다.

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

### 5-1. 두 가지 상태값 — State / Status

| 구분            | State (자동)                     | Status (수동)         |
| ------------- | ------------------------------ | ------------------- |
| **무엇이 결정?**   | 시간 (신청 기간)                     | 운영자가 직접             |
| **값**         | `scheduled` / `live` / `ended` | `live` / `closed`   |
| **자동 변경?**    | 시간이 흐르면 자동으로 변함                | 운영자가 명시적으로 바꿀 때만 변함 |
| **응모 차단 영향?** | `live`가 아니면 응모 불가              | `closed`면 응모 불가     |

#### 응모 가능 여부 결정

응모자에게 폼이 노출되려면 **두 상태가 모두 충족되어야** 합니다. 즉, 시간 기반 State가 **Live**이고, 운영자가 설정한 Status가 **진행중**일 때만 응모자가 폼을 작성할 수 있습니다.

> 💡 **두 상태가 같은 단어("live")를 쓰는 이유** "응모 기간이 시작됐고(State), 운영자도 받기로 한 상태(Status)"라는 두 조건을 따로 표현하기 위해 같은 단어가 두 곳에서 사용됩니다. 화면에서는 라벨이 다르게 표시되니 헷갈릴 일은 거의 없습니다 (State는 영문, Status는 한국어).

### 5-2. State — 시간 기반 자동 상태 (3가지)

신청 시작일·종료일을 현재 시각과 비교해 시스템이 자동으로 매기는 값입니다. 운영자가 손댈 게 없습니다.

| 값           | 화면 라벨               | 색상  | 의미                 |
| ----------- | ------------------- | --- | ------------------ |
| `scheduled` | **Not started yet** | 호박색 | 신청 시작일 이전 (예정 캠페인) |
| `live`      | **Live**            | 초록  | 신청 기간 안 — 응모 폼이 활성 |
| `ended`     | **Ended**           | 파랑  | 신청 종료일 경과 — 응모 차단  |

폼 이벤트 목록 페이지(Part 2)와 응모자 공개 폼(Part 13)에서 이 라벨을 그대로 보게 됩니다.

### 5-3. Status — 운영자 수동 제어 (2가지)

운영자가 직접 켜고 끄는 값입니다.

| 값       | 화면 라벨   | 색상 | 의미             |
| ------- | ------- | -- | -------------- |
| `live`  | **진행중** | 초록 | 정상 운영 (기본값)    |
| `ended` | **종료**  | 파랑 | 운영자가 강제로 응모 차단 |

신청 종료일이 아직 남았더라도 응모를 미리 닫고 싶을 때 사용합니다 (5-5 참고).

### 5-4. 응모 페이지에서 보이는 모습

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

같은 이벤트라도 두 상태의 조합에 따라 응모자가 보는 화면이 달라집니다.

| State       | Status   | 응모자가 보는 화면                         |
| ----------- | -------- | ---------------------------------- |
| `scheduled` | (무관)     | "이 이벤트는 아직 시작되지 않았습니다." + 신청 기간 안내 |
| `live`      | `live`   | 응모 폼 + **참가 신청하기** 버튼 (정상 응모 가능)   |
| `live`      | `closed` | "이 이벤트는 종료되었습니다." (운영자가 미리 닫음)     |
| `ended`     | (무관)     | "이 이벤트는 종료되었습니다." (기간 만료)          |

응모자가 보는 정확한 화면 구성은 **Part 13 · 응모자가 보는 공개 폼 페이지**에서 자세히 다룹니다.

### 5-5. 이벤트 수동 종료 — Status를 `closed`로

신청 종료일 전에 응모를 미리 닫고 싶을 때 사용합니다.

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

#### 5-5-1. 종료 버튼 위치

이벤트 상세 페이지(Part 6)에서 진행할 수 있습니다. 자세한 헤더 구성은 Part 6에서 다룹니다.

#### 5-5-2. 종료 확인 다이얼로그

종료 버튼을 누르면 확인 다이얼로그가 열립니다.

* **제목**: 이벤트 종료
* **안내 문구**: "이벤트를 종료하면 더 이상 참가 신청을 받을 수 없습니다. 기존 신청자는 영향받지 않습니다. 계속하시겠습니까?"

확정하면 즉시 Status가 `closed`로 바뀌고, 응모 페이지가 "이 이벤트는 종료되었습니다." 화면으로 전환됩니다.

> 🟡 **종료한 이벤트는 다시 진행 상태로 자동 복귀하지 않습니다** 다시 응모를 받으려면 운영팀에 문의하셔야 합니다. 응모자에게 혼란을 줄 수 있어 자주 사용하는 기능은 아니며, 보통은 신청 종료일이 자연스럽게 도래하도록 두는 것이 권장됩니다.

### 5-6. 상태 표시 위치 — 어디서 확인하나요?

| 화면                         | 표시되는 상태                                   |
| -------------------------- | ----------------------------------------- |
| **폼 이벤트 목록 표** (Part 2)    | State 배지 (Live / Ended / Not started yet) |
| **상세 페이지 헤더** (Part 6)     | State + Status 모두                         |
| **응모자가 보는 공개 폼** (Part 13) | 두 상태의 조합에 따라 다른 화면                        |
| **메일 관리 페이지** (Part 10-5)  | 이벤트 단위 상태                                 |

상태에 따라 일부 액션(편집·일괄 메일 발송 등)이 잠기거나 풀립니다. 자세한 제약은 각 파트의 해당 항목에서 안내합니다.