# 기기 조사 캠페인 관리하기

## 기기 조사 캠페인 관리하기

캠페인 생성 이후의 전체 운영 흐름을 다룹니다. 상태 전이, 공지 이메일 발송, 진행 현황 모니터링, 조사 내용 승인, 완료/취소까지 순서대로 안내합니다.

{% hint style="info" %}
**필요 권한** 이 가이드의 모든 관리 작업은 **기기 편집(`device-edit`) 권한**을 가진 구성원만 수행할 수 있습니다. 권한이 없으면 상태 전이/수정/삭제/이메일 발송 버튼이 모두 비활성화됩니다.
{% endhint %}

***

### 1. 캠페인 상태 흐름

캠페인은 다음 5가지 상태 중 하나를 가지며, 관리자 액션에 따라 전이됩니다.

| 상태       | 관리자가 할 수 있는 일                             | 다음 전이 버튼             |
| -------- | ----------------------------------------- | -------------------- |
| **초안**   | 모든 설정 수정, 기기 선정, 삭제                       | `준비 완료`              |
| **준비**   | 기기 선정 변경, 초안으로 되돌리기                       | `시작하기` / `초안으로 되돌리기` |
| **진행 중** | 공지 이메일 발송, 담당자별 현황 확인, 타인 기기 검토·저장, 선택 승인 | `완료하기` / `취소하기`      |
| **완료**   | 리포트 확인, 엑셀 다운로드 (읽기 전용)                   | -                    |
| **취소**   | 리포트 확인 (읽기 전용)                            | -                    |

{% hint style="warning" %}
**설정 수정은 초안 상태에서만** 캠페인명·기간·담당자·조사 항목·기기 선정 등 모든 설정은 **초안 상태에서만 수정**할 수 있습니다. 준비 또는 진행 중 상태에서 내용을 고치려면 \*\*`초안으로 되돌리기`\*\*를 먼저 실행하세요.
{% endhint %}

<figure><img src="/files/lNbgZoLdoYE0kh5F7RvC" alt="캠페인 상세 페이지 상단 - 나의 조사로 가기 / 공지 이메일 보내기 / 취소하기 버튼과 기본 정보 카드"><figcaption></figcaption></figure>

***

### 2. 준비 완료로 전환하기

캠페인을 만든 직후 상태는 **초안**입니다. 실제 시작 전에 준비 상태로 전환해 설정을 잠급니다.

1. 자산조사 목록에서 대상 캠페인을 클릭해 상세로 이동합니다.
2. 화면 상단 오른쪽의 **`준비 완료`** 버튼을 클릭합니다.
3. 캠페인 상태가 **준비**로 바뀌며 설정 수정 버튼이 비활성화됩니다.

언제든 **`초안으로 되돌리기`** 버튼으로 다시 초안 상태로 돌아가 수정할 수 있습니다.

***

### 3. 캠페인 시작하기

1. 상태가 **준비**인지 확인합니다.
2. **`시작하기`** 버튼을 클릭합니다.
3. 상태가 **진행 중**으로 바뀌며, 이제 구성원이 조사 링크로 접속해 응답할 수 있습니다.
4. 캠페인 담당자와 참여자에게 알림이 발송됩니다.

{% hint style="info" %}
**시작 시점 참고** 시작일이 지나지 않았더라도 **`시작하기`** 버튼을 눌러 즉시 진행 중 상태로 전환할 수 있습니다. 시작일은 참고용 일정이며 자동 전이를 트리거하지 않습니다.
{% endhint %}

***

### 4. 공지 이메일 발송하기

진행 중 상태에서 **`공지 이메일 보내기`** 버튼을 통해 참여자에게 직접 이메일을 보낼 수 있습니다. 캠페인 시작 공지와 **리마인더** 두 용도 모두 이 다이얼로그를 사용합니다.

#### Step 1. 수신자 선택

1. **`공지 이메일 보내기`** 버튼을 클릭하면 다이얼로그가 열립니다.
2. 상단 제목: **"수신자 선택"** / 설명: "공지 이메일을 보낼 조사 인원을 선택하세요."
3. 조사 인원별로 아래 정보가 표로 표시됩니다.

| 컬럼           | 값                                       |
| ------------ | --------------------------------------- |
| **이름 / 이메일** | 구성원 기본 정보                               |
| **조사 상태**    | `조사 전` (아직 시작하지 않음) / `진행 중` (일부 이상 응답) |
| **QR 인증**    | `QR 인증됨` / `QR 미인증` (QR 필수 캠페인에서만 표시)   |

**기본 선택**은 아직 조사를 시작하지 않은(**조사 전**) 대상자입니다. 리마인더 발송 시 이 기본값을 활용하면 효율적입니다.

4. 검색창(`이름, 이메일로 검색...`)으로 필터링 가능합니다.
5. 수신자 선택 후 **`다음: 이메일 편집`** 버튼을 클릭합니다.

<figure><img src="/files/UNgLx4OgLWUg3rh9xmzk" alt="공지 이메일 다이얼로그 Step 1 - 수신자 선택: 조사 상태 뱃지(조사 전/진행 중)와 체크박스"><figcaption></figcaption></figure>

#### Step 2. 이메일 편집

| 필드         | 최대 길이 | 기본값                        |
| ---------- | ----- | -------------------------- |
| **이메일 제목** | 16자   | `자산조사를 시작합니다`              |
| **이메일 내용** | 255자  | `각자에게 할당된 기기를 조사해서 보고해주세요` |
| **미리보기**   | -     | 오른쪽 패널에서 실제 메일 형태로 실시간 렌더링 |

메일 본문에는 자동으로 아래 버튼들이 포함됩니다.

* **`조사 시작하기`** — 캠페인의 참여자 링크
* **`가이드 문서`** — 생성 시 연결한 가이드 URL이 있는 경우에만 노출
* **`문의하기`** — support 문의 링크

**`이메일 보내기 (N)`** 버튼으로 발송하면 선택한 N명에게 즉시 전송되고, 성공 토스트 \*\*"N명에게 이메일을 보냈어요!"\*\*가 표시됩니다.

<figure><img src="/files/XSAn75bgvB2IFCG09yIK" alt="공지 이메일 다이얼로그 Step 2 - 이메일 편집: 제목·내용 입력과 이메일 보내기(N) 버튼"><figcaption></figcaption></figure>

{% hint style="info" %}
**리마인더 보내기** 며칠 뒤 미응답자에게 리마인더를 보내고 싶다면, 같은 **`공지 이메일 보내기`** 버튼을 다시 열어 제목/내용을 리마인더용으로 수정한 뒤 발송하세요. `조사 전` 기본 선택이 자동으로 리마인더 대상을 좁혀줍니다.
{% endhint %}

***

### 5. 진행 현황 모니터링

진행 중 캠페인의 상세 페이지 상단에는 **캠페인 진행 현황** 카드가 표시됩니다.

* 요약 문장 예: *"총 25대 중 12대가 승인됐고, 8대는 검토 중이며, 5대는 시작 전입니다."*
* 세그먼트 바: **승인됨** / **검토 중** / **시작됨** 색상 구분

#### 담당자별 현황 카드

진행 현황 바로 아래에는 **담당자별 현황 카드**가 표시됩니다. 담당자별로 `승인 / 검토 중 / 시작 전` 건수를 progress bar 로 시각화해 한눈에 비교할 수 있습니다. 카드를 클릭하면 아래 기기 테이블이 해당 담당자 기기만 노출되도록 자동 필터링됩니다.

#### 조사 대상 기기 탭

아래쪽의 **조사 대상 기기** 섹션에는 탭과 데이터 그리드가 있어 작업 단위로 상세 확인이 가능합니다.

| 탭             | 대상                               |
| ------------- | -------------------------------- |
| **전체 (N)**    | 모든 조사 기기                         |
| **승인됨 (N)**   | 최종 확정된 작업                        |
| **검토 중 (N)**  | 참여자가 조사를 마쳤고 담당자가 확인 중인 작업       |
| **시작됨 (N)**   | 참여자가 아직 조사하지 않은 작업               |
| **변경 있음 (N)** | 참여자가 필드 값을 수정해 변경 내역이 남은 작업만 필터링 |

그리드 컬럼: `관리번호` / `조사 인원` / `카테고리` / `제품명` / `일련번호` / `상태` / `변경 항목` / `메모`

{% hint style="info" %}
**관리번호 '열기' 버튼으로 타인 기기 검토** 캠페인 담당자 또는 해당 작업의 담당자에게는 관리번호 셀에 **`열기`** 버튼이 활성화됩니다. 클릭하면 해당 작업 상세 화면으로 이동해 참여자가 수정한 내용을 확인하고 필요 시 값을 보정할 수 있습니다. 일반 조사자가 캠페인 상세 링크로 직접 진입하면 본인에게 배정된 작업 리스트로 자동 리다이렉트됩니다.
{% endhint %}

**`엑셀 다운로드`** 버튼으로 현재 보이는 기기 목록을 CSV/XLSX로 내보낼 수 있습니다.

<figure><img src="/files/4L61ZLK8YwprLp3hp8yn" alt="캠페인 진행 현황 카드와 조사 대상 기기 탭(전체/승인됨/검토 중/시작됨)"><figcaption></figcaption></figure>

***

### 6. 조사 내용 검토하기

참여자가 조사를 마치면 작업은 **검토 중** 상태가 됩니다. 담당자는 진행 중 캠페인 동안 언제든 타인 기기 작업 상세에 들어가 내용을 확인하고 필요하면 값을 직접 수정할 수 있습니다.

#### 작업 상태 의미

* **시작됨** — 참여자가 아직 조사하지 않은 상태
* **검토 중** — 참여자가 `조사 완료`를 눌러 담당자 확인 대기 중이거나, 담당자가 `검토 저장`으로 내용을 편집한 상태
* **승인됨** — 최종 확정된 상태. 캠페인이 **완료**로 전환되는 시점에 남아 있는 미승인 작업은 자동으로 승인 처리됩니다

{% hint style="info" %}
**데이터 반영 시점** 참여자·담당자가 수정한 값은 **캠페인이 "완료" 상태로 전환될 때 일괄로 실제 기기 데이터에 반영**됩니다. 그 전까지는 원본 기기 데이터가 변경되지 않고, 조사 내용은 캠페인 내부에만 저장됩니다. 이 덕분에 캠페인이 진행 중인 동안에는 언제든 값을 다시 열어 수정할 수 있습니다.
{% endhint %}

#### 타인 기기 검토 절차

1. 조사 대상 기기 테이블에서 관리번호의 **`열기`** 버튼 또는 **`변경 있음`** 탭에서 작업을 선택합니다.
2. 작업 상세 화면에서 참여자가 수정한 필드와 메모를 확인합니다.
3. 보정이 필요하면 값을 직접 편집하고, 하단의 **`검토 저장`** 버튼으로 반영합니다.
4. 추가 검토가 필요 없다면 그대로 둡니다 — 캠페인 완료 시점에 자동으로 승인 상태가 됩니다.

{% hint style="info" %}
**QR 필수 캠페인에서도 타인 기기는 검토 가능** QR 필수 캠페인이라도 **캠페인 담당자/추가 담당자**는 타인 기기의 상세를 열고 검토 저장할 수 있습니다. QR 인증은 **본인에게 배정된 기기를 조사하는 현장 조사자**에게만 요구됩니다.
{% endhint %}

#### 선택 승인 (벌크)

여러 작업을 한 번에 확정하고 싶다면 테이블에서 체크박스로 작업을 선택한 뒤 상단 액션 바의 \*\*`선택 승인`\*\*을 누릅니다.

{% hint style="warning" %}
**선택 승인 주의** 선택 승인은 개별 내용을 보지 않고 일괄 `승인됨` 상태로 만듭니다. **담당자별 현황 카드**와 **변경 있음 탭**으로 이상치를 먼저 점검한 뒤 사용하세요. 선택 승인은 **캠페인 담당자(owner)** + **진행 중** 상태에서만 활성화됩니다.
{% endhint %}

***

### 7. 캠페인 완료하기

모든 조사가 끝나면 캠페인을 **완료** 상태로 전환합니다. 이 시점에 조사 내용이 실제 기기 데이터에 반영됩니다.

1. 상태가 **진행 중**인지 확인합니다. 모든 작업이 최소 **검토 중** 이상 상태여야 안전합니다.
2. **`완료하기`** 버튼을 클릭합니다.
3. 상태가 **완료**로 전환되며 화면이 읽기 전용이 됩니다. 이 때 미승인 상태(검토 중·시작됨)로 남아 있던 작업은 자동으로 **승인됨** 처리되어 기기 데이터에 반영됩니다.

#### 완료 차단 안내

아직 시작되지 않은 작업(**시작됨** 상태)이 남아 있으면 완료 버튼을 눌렀을 때 안내 다이얼로그가 열릴 수 있습니다.

* 제목: **"캠페인을 완료할 수 없습니다"**
* 설명: *"미확인 항목 N개가 남아있습니다. 모든 항목을 최소 한 번 확인한 뒤 완료해주세요."*

리마인더 이메일을 발송해 참여자가 최소 한 번은 작업에 접근하도록 유도한 뒤 다시 \*\*`완료하기`\*\*를 클릭하세요. 끝까지 응답이 없는 참여자의 기기는 담당자가 직접 **`열기`** 로 검토 저장해 **검토 중** 상태로 바꿔 두면 완료 진행이 가능합니다.

***

### 8. 캠페인 취소 및 삭제

#### 취소 (진행 중 상태)

조사를 중단해야 할 때 사용합니다.

1. 상세 페이지 상단에서 **`취소하기`** 버튼을 클릭합니다.
2. 상태가 **취소**로 전환되며 화면이 읽기 전용이 됩니다.
3. 그동안 참여자가 입력한 조사 내용은 **실제 기기 데이터에 반영되지 않습니다**.

#### 삭제 (진행 중이 아닌 상태)

**진행 중 상태가 아닌 캠페인만 삭제할 수 있습니다.**

1. 상세 페이지 우측 상단 `⋯` 드롭다운에서 \*\*`삭제하기`\*\*를 선택합니다.
2. 확인 다이얼로그 \*\*"캠페인 삭제"\*\*에서 내용을 확인하고 확정합니다.
3. 성공 토스트 \*\*"캠페인이 삭제되었습니다."\*\*가 표시됩니다.

{% hint style="danger" %}
**삭제는 되돌릴 수 없음** 삭제된 캠페인은 복구할 수 없으며, 조사 기록도 함께 사라집니다. 진행 중 캠페인은 먼저 **취소하기** 또는 **완료하기**로 정리한 뒤 삭제하세요.
{% endhint %}

***

### 9. 완료 후 리포트 확인하기

캠페인이 **완료** 상태가 되면 상세 페이지에 아래 인사이트 카드가 표시됩니다.

| 카드                | 내용                           |
| ----------------- | ---------------------------- |
| **완료 인사이트**       | 캠페인 주요 지표 요약                 |
| **변경 감지 기기**      | 참여자가 값 변경을 요청한 기기 수          |
| **검토된 변경**        | 관리자가 승인한 변경 수                |
| **실제 값 변경**       | 최종적으로 기기 데이터에 반영된 변경 수       |
| **카테고리 분포**       | 조사 대상 기기의 카테고리별 분포           |
| **변경된 기기** (아코디언) | 변경 내역이 있는 기기의 상세 목록          |
| **QR 실사 미완료 기기**  | QR 필수 캠페인에서 QR 인증이 안 된 기기 목록 |

모든 데이터는 \*\*`엑셀 다운로드`\*\*로 내보낼 수 있습니다.

<figure><img src="/files/T8OdGCHQdqt3sPt0THnu" alt="캠페인 완료 상태 - &#x27;이 캠페인은 완료되어 읽기 전용입니다&#x27; 배너와 통계 카드(조사 대상 기기/조사 참여 구성원/조사 기간)"><figcaption></figcaption></figure>

***

### 10. 문제 해결

#### Q: `완료하기` 버튼을 눌렀는데 캠페인이 완료되지 않아요

**원인**: 참여자가 아직 한 번도 접근하지 않은 **시작됨** 상태 작업이 남아 있습니다.

**해결 방법**:

1. "캠페인을 완료할 수 없습니다" 다이얼로그의 **미확인 항목 N개** 숫자를 확인합니다.
2. **시작됨** 탭에서 남은 작업을 확인하고, 참여자에게 리마인더 이메일을 보내거나 관리번호 **`열기`** 로 직접 검토 저장해 **검토 중** 상태로 전환합니다. 건수가 많다면 \*\*`선택 승인`\*\*으로 한 번에 처리할 수도 있습니다.
3. 처리가 끝난 뒤 \*\*`완료하기`\*\*를 다시 클릭합니다. 여전히 **검토 중**으로 남아 있는 작업은 완료 시점에 자동으로 **승인됨** 처리되어 기기 데이터에 반영됩니다.

#### Q: 캠페인 설정을 바꾸고 싶은데 수정 버튼이 보이지 않아요

**원인**: 캠페인 상태가 **초안**이 아니어서 수정이 잠긴 상태입니다.

**해결 방법**:

1. 상태가 **준비**라면 \*\*`초안으로 되돌리기`\*\*를 실행해 초안으로 되돌린 뒤 수정합니다.
2. 상태가 **진행 중**이라면 운영 정책상 수정 대신 필요한 항목만 재조사 요청을 고려하거나, 캠페인을 **취소**한 뒤 새로 생성하세요.

#### Q: QR 인증 옵션을 켜지 않은 상태로 생성했어요

**원인**: QR 인증 설정은 생성 시에만 선택 가능하고 이후 변경할 수 없습니다.

**해결 방법**:

1. 현재 캠페인을 **완료** 혹은 **취소**로 종료합니다.
2. QR 인증을 켠 상태로 **신규 캠페인을 다시 생성**합니다.

#### Q: 리마인더 이메일을 자동으로 보낼 수 있나요

**원인**: 현재 자동 리마인더 스케줄링은 제공되지 않습니다.

**해결 방법**:

1. 필요 시점에 \*\*`공지 이메일 보내기`\*\*를 수동으로 여세요.
2. Step 1에서 기본으로 선택되는 **`조사 전`** 대상자만 체크 상태로 두고 발송하면 미응답자에게만 전달됩니다.

#### Q: 삭제했는데 복구할 수 있나요

**원인**: 삭제는 비가역 작업입니다.

**해결 방법**:

1. 복구는 지원되지 않습니다.
2. 조사 데이터가 중요한 경우 삭제 전 **엑셀 다운로드**로 별도 백업을 먼저 수행하세요.

#### Q: 이 외의 문제

채널톡 또는 사내 IT 담당자에게 문의해 주세요.


---

# Agent Instructions: 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:

```
GET https://docs.smply.one/due-dilligence/how-to-manage-dd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.