> 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)  | 이벤트 단위 상태                                 |

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guide.hypercape.com/brand-guide/form-events/undefined-4.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.