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

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

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

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

***

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

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

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

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

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fgit-blob-04d004731808f41849b52b9ae54078dc715289a4%2Fdd-admin-detail-transitions.png?alt=media" 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="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fgit-blob-5ea277ed8535af0708e04804556ca7c3581c5128%2Fdd-admin-email-step1.png?alt=media" alt="공지 이메일 다이얼로그 Step 1 - 수신자 선택: 조사 상태 뱃지(조사 전/진행 중)와 체크박스"><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fgit-blob-2e323ed1089c50c9f6966468c746e83ef09375b1%2Fdd-admin-email-step2.png?alt=media" alt="공지 이메일 다이얼로그 Step 2 - 이메일 편집: 제목·내용 입력과 이메일 보내기(N) 버튼"><figcaption></figcaption></figure>

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

***

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

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

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

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

| 탭            | 대상                       |
| ------------ | ------------------------ |
| **전체 (N)**   | 모든 조사 기기                 |
| **승인됨 (N)**  | 관리자가 승인한 작업              |
| **검토 중 (N)** | 참여자가 저장했지만 아직 승인되지 않은 작업 |
| **시작됨 (N)**  | 참여자가 아직 검토하지 않은 작업       |

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

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

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fgit-blob-f01161eb3bea956838ce58750b056348abac4eaa%2Fdd-admin-progress.png?alt=media" alt="캠페인 진행 현황 카드와 조사 대상 기기 탭(전체/승인됨/검토 중/시작됨)"><figcaption></figcaption></figure>

***

### 6. 조사 내용 검토 및 승인하기

참여자가 `검토 저장` 또는 `승인`을 누른 작업은 아래 두 가지 상태가 됩니다.

* **검토 중** — 참여자가 값은 수정/확인했지만 담당자 검토를 요청한 상태
* **승인됨** — 참여자가 최종 확인 요청까지 보낸 상태 (캠페인 완료 시 실 데이터 반영)

{% hint style="info" %}
**데이터 반영 시점** 참여자가 수정한 값은 **캠페인이 "완료" 상태로 전환될 때 일괄 반영**됩니다. 그 전까지는 원본 기기 데이터가 변경되지 않고, 조사 내용은 캠페인 내부에만 저장됩니다.
{% endhint %}

#### 개별 승인 절차

1. 조사 대상 기기 탭에서 **검토 중** 또는 **시작됨** 탭으로 이동해 작업을 고릅니다.
2. 작업을 클릭하면 우측 작업 상세 패널이 열립니다.
3. 참여자가 수정한 필드와 메모를 확인합니다.
4. 내용이 올바르면 **`승인`** 버튼으로 확정하거나, 직접 추가 수정 후 **`검토 저장`**/**`승인`** 중 선택합니다.

#### 전체 승인 절차 (진행 중 상태 한정)

검토할 건수가 많을 때는 상단 **`전체 승인`** 버튼으로 선택된 작업을 한 번에 승인할 수 있습니다.

{% hint style="warning" %}
**전체 승인 주의** 전체 승인은 선택된 작업을 일괄 승인하므로, 변경 사항을 개별적으로 확인하지 않게 됩니다. **카테고리 분포**와 **변경 감지 기기** 카드로 이상치가 없는지 점검한 뒤 사용하세요.
{% endhint %}

***

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

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

1. 상태가 **진행 중**이며 **모든 기기가 승인됨** 상태인지 확인합니다.
2. **`완료하기`** 버튼을 클릭합니다.
3. 상태가 **완료**로 전환되며 화면이 읽기 전용이 됩니다.

#### 완료 차단 안내

미승인 항목이 남아 있으면 완료 버튼을 눌러도 캠페인이 완료되지 않고 안내 다이얼로그가 열립니다.

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

남은 미승인 항목을 모두 처리한 뒤 다시 \*\*`완료하기`\*\*를 클릭하세요.

***

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

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

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

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

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

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

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

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

***

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

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

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

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

<figure><img src="https://820136014-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6FwP2wwMRtAxUfyA9xhy%2Fuploads%2Fgit-blob-1cabf7f2bd90385e0161413e346c5d14342fca3c%2Fdd-admin-completed.png?alt=media" 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: 이 외의 문제

<support@sherpas.team> 또는 사내 IT 담당자에게 문의하세요.