> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/it-device/workflow.md).

# 워크플로우로 기기 처리하기

## 워크플로우로 기기 처리하기

기기에 일어나는 일(반출·반납, 다른 구성원에게 이전, 수리 의뢰, 자산조사)은 모두 **워크플로우**로 추적됩니다. 한 기기에 여러 워크플로우가 동시에 걸릴 수 있으며, 관리자는 **`워크플로우`** 화면에서 네 종류를 탭으로 오가며 한 곳에서 처리합니다. 구성원은 자신이 관여한 워크플로우를 **`내 워크플로우`** 에서 확인하고, QR코드로 기기에 접근해 직접 요청을 올릴 수 있습니다.

{% hint style="info" %}
**워크플로우 네 종류**

* **반출/반납**: 기기를 구성원에게 빌려주고 돌려받습니다.
* **이전**: 기기 사용자(소유자)를 다른 구성원으로 바꿉니다.
* **수리/AS**: 기기를 수리 센터에 보내고 이력·비용을 관리합니다.
* **자산조사**: 기기 자산을 일괄 점검합니다.

QR코드로 구성원이 직접 올리는 이전·할당·반납·수리 요청의 진행 흐름은 [구성원 간 기기 이전/할당하기](/it-device/transfer.md)에서 자세히 다룹니다. 이 문서는 관리자가 워크플로우를 **확인하고 처리**하는 관점을 안내합니다.
{% endhint %}

***

### 1. 워크플로우 화면 열기

**경로**: 사이드바 **기기** 메뉴 → **워크플로우**

**페이지 제목**: *"워크플로우"* **설명**: *"기기 워크플로우를 확인하고 처리합니다."*

화면 상단에는 네 종류를 오가는 탭이 있습니다. 탭을 바꾸면 그에 맞는 목록과 처리 버튼으로 전환됩니다.

| 탭         | 무엇을 처리하나                   |
| --------- | -------------------------- |
| **자산조사**  | 진행 중인 자산조사 캠페인과 점검 항목      |
| **이전 요청** | 구성원이 올린 기기 이전·할당 요청의 승인/거절 |
| **반출/반납** | 반출 중인 기기의 반납 처리, 반납 예정일 변경 |
| **수리/AS** | 수리 요청 접수·시작·완료, 수리 통계 카드   |

{% hint style="info" %}
**사이드바 진입 지점은 자산조사 화면입니다** 사이드바 **기기 > 워크플로우** 를 누르면 첫 탭인 **자산조사** 화면(`/device/campaign`)으로 들어갑니다. 상단 탭에서 **이전 요청 / 반출/반납 / 수리/AS** 로 이동하면 워크플로우 화면(`/device/workflow`)으로 전환됩니다.
{% endhint %}

***

### 2. 반출/반납 처리하기

**반출/반납** 탭에서는 현재 반출 중인 기기를 한눈에 보고 반납을 처리합니다.

**단계 1: 대상 찾기**

1. 상단 상태 필터에서 **활성**(반출 중) 또는 **종료**(반납 완료)를 고릅니다.
2. 목록에서 반출자·반출일·반납 예정일·D-day·사유를 확인합니다.

**단계 2: 반납 또는 반납 예정일 변경**

* 행에서 **반납** 을 실행하면 반납일과 메모를 입력하는 창이 열립니다.
* 반납 예정일만 미루려면 행에서 반납 예정일 변경을 선택해 날짜를 조정합니다.
* 여러 건을 한 번에 반납하려면 체크박스로 대상을 고른 뒤 일괄 반납을 실행합니다.

{% hint style="info" %}
**반출은 기기 상세에서 시작합니다** 새 반출을 등록하는 동작은 기기 상세 화면의 **`반출하기`** 버튼에서 진행합니다. 워크플로우 화면의 **반출/반납** 탭은 이미 반출된 기기를 **반납·관리**하는 곳입니다.

빈 상태에서는 *"아직 반출 기록이 없습니다 · 기기 상세에서 반출을 등록하면 여기에 표시됩니다."* 가 표시됩니다.
{% endhint %}

{% hint style="warning" %}
**일부만 실패할 때** 일괄 반납 중 일부 건이 처리되지 않으면 *"일부 반납이 실패했습니다"* 알림과 실패 건수가 표시됩니다. 다시 시도하거나 개별 반납으로 진행하세요.
{% endhint %}

***

### 3. 이전 요청 승인/거절하기

**이전 요청** 탭에는 구성원이 올린 기기 이전·할당 요청이 모입니다.

**단계 1: 요청 확인**

1. 목록에서 대상 기기·요청자·요청일·메모를 확인합니다.
2. 항목을 열면 **승인 현황**(중간 관리자별 승인 진행 상황)을 볼 수 있습니다.

**단계 2: 승인 또는 거절**

* **`승인하기`** 를 누르면 *"이전 요청을 승인하시겠습니까?"* 확인 후 다음 단계로 진행됩니다.
* **`거절하기`** 를 누르면 요청이 취소됩니다.
* 여러 요청을 체크박스로 골라 한 번에 승인·거절·취소할 수도 있습니다.

{% hint style="info" %}
**승인은 단계로 이뤄집니다** 구성원이 이전·할당을 신청할 때 선택한 **중간 관리자**가 먼저 승인해야 하고(여러 명을 골랐다면 전원 승인), 그다음 심플리 **관리자**가 최종 승인합니다. 관리자는 여러 명 중 한 명만 승인해도 최종 반영됩니다. 신청 측 흐름은 [구성원 간 기기 이전/할당하기](/it-device/transfer.md)를 참고하세요.
{% endhint %}

***

### 4. 수리/AS 처리하기

**수리/AS** 탭은 상단에 수리 현황 카드, 그 아래 수리 요청 목록으로 구성됩니다.

**단계 1: 현황 파악**

상단 카드로 **수리 요청 대기 · 수리 중 · 이번달 수리 완료 · 이번달 수리 비용** 을 확인합니다. 카드를 누르면 해당 상태로 목록이 걸러집니다.

**단계 2: 요청 처리**

목록 상태 필터는 **대기**(처리 전)와 **종료**(완료·거절·취소)로 나뉩니다. 각 요청에서 다음 동작을 진행합니다.

| 동작        | 의미                   |
| --------- | -------------------- |
| **접수**    | 수리 요청을 접수합니다         |
| **거절**    | 수리 요청을 거절합니다         |
| **수리 시작** | 수리를 시작합니다(수리 중으로 전환) |
| **완료**    | 수리를 완료 처리합니다         |
| **취소**    | 진행 중인 건을 취소합니다       |

* 접수·시작·거절·취소는 체크박스로 여러 건을 골라 **일괄 처리**할 수 있습니다(완료는 개별 처리만).
* 처리 시 담당자와 사유를 입력하는 창이 열립니다.

{% hint style="info" %}
**수리비와 수리 이력은 기기 상세에서** 개별 기기의 수리비·수리 이력은 기기 상세 화면의 **`워크플로우`** 탭에서 확인합니다. 수리/AS 탭은 전사 단위의 수리 작업 대기열입니다.
{% endhint %}

***

### 5. 자산조사 진행하기

**자산조사** 탭(사이드바 진입 시 첫 화면)에서는 자산조사 캠페인을 만들고 진행 상황을 추적합니다. 캠페인은 대상 기기를 묶어 점검을 요청하고, 구성원이 자신에게 배정된 기기 정보를 확인·정정하면 관리자가 검토·확정하는 흐름입니다.

***

### 6. 워크플로우 충돌 처리 (Cascade)

한 기기에 워크플로우가 이미 걸려 있는 상태에서 다른 워크플로우(예: 이전 승인)를 진행하면, 기존 워크플로우와 충돌이 생길 수 있습니다. 이때 **충돌 확인 창**이 떠서 어떤 워크플로우가 영향을 받는지 보여줍니다.

* 예를 들어 반출 중인 기기의 이전 요청을 승인하면 *"이전 승인으로 기기에 진행 중인 워크플로우가 영향을 받습니다."* 라는 안내와 함께, 자동으로 정리될 워크플로우 목록이 표시됩니다.
* 내용을 확인하고 진행하면, 기존 워크플로우가 정리된 뒤 새 워크플로우가 반영됩니다.

{% hint style="warning" %}
**충돌 내용을 확인한 뒤 진행하세요** 충돌 확인 창은 어떤 워크플로우가 자동으로 취소·정리되는지 보여줍니다. 진행하면 기존 진행 건이 함께 정리되므로, 영향 범위를 확인한 뒤 진행하세요.
{% endhint %}

***

### 7. 내 워크플로우 — 구성원 관점

**경로**: 사이드바 **내 워크플로우** → `/my-workflows`

**페이지 제목**: *"내 워크플로우"* **설명**: *"내가 관여 중인 반출·수리·자산조사 현황을 확인합니다."*

구성원이 자신이 관여한 워크플로우를 확인하는 화면입니다. 관리자 화면과 달리 **조회 전용**이며, 실제 처리(반납·이전·수리 신청 등)는 기기 상세 화면이나 QR 화면에서 진행합니다.

* 화면 상단의 **활성 워크플로우** 영역에 진행 중인 수리·자산조사가 카드로 요약됩니다. 각 카드의 **`상세 보기`** 로 해당 기기의 **`워크플로우`** 탭으로 이동합니다.
* 탭은 **반출/반납 · 이전 · 수리/AS · 자산조사** 로 나뉘며, 각 탭 이름 옆에 건수가 표시됩니다.

{% hint style="info" %}
**이전 탭은 준비 중입니다** **내 워크플로우** 의 **이전** 탭은 *"준비 중 · 본인 기준 이전 요청 조회는 곧 만나실 수 있습니다."* 로 표시됩니다. 그동안 이전 요청 현황은 기기 상세 화면의 **`워크플로우`** 탭에서 확인하세요.
{% endhint %}

***

### 8. QR 액션바로 직접 요청하기

구성원이 기기의 QR코드로 접근하면, 화면 하단에 **워크플로우 시작 액션바**가 고정으로 나타납니다. 기기 보유 상태에 따라 보이는 액션이 달라집니다.

| 기기 상태        | 보이는 액션                                            |
| ------------ | ------------------------------------------------- |
| 사용자가 없는 기기   | *"이 기기를 나에게 할당하기"*                                |
| 다른 사람의 기기    | *"이 기기를 나에게 할당하기"*                                |
| 본인 기기        | *"이 기기를 다른 사람에게 이전하기"*, *"수리 신청"*                 |
| 본인 기기 + 반출 중 | *"기기 반납 신청하기"*, *"이 기기를 다른 사람에게 이전하기"*, *"수리 신청"* |

* 가능한 액션이 **하나면** 그 액션이 단일 버튼으로 바로 보입니다.
* 가능한 액션이 **여럿이면** **`워크플로우 시작하기`** 버튼이 보이고, 누르면 *"워크플로우 선택"* 목록에서 원하는 작업을 고릅니다.

QR로 올린 요청은 모두 워크플로우로 접수되어, 관리자 **`워크플로우`** 화면과 신청자 기기 상세의 **`워크플로우`** 탭에서 진행 상황을 추적합니다. 단계별 신청 흐름은 [구성원 간 기기 이전/할당하기](/it-device/transfer.md)를 참고하세요.

***

### 9. 대시보드 위젯으로 한눈에 보기

관리자 대시보드에 워크플로우 관련 위젯을 추가하면, 처리해야 할 일을 한눈에 파악할 수 있습니다.

| 위젯            | 보여주는 것                  |
| ------------- | ----------------------- |
| **반출 중 기기**   | 현재 현장에서 운영 중인 기기 수      |
| **연체 기기**     | 반납 예정일이 지나 회수가 필요한 기기 수 |
| **수리 중 기기**   | 현재 수리 중인 기기 작업 대기열(목록)  |
| **수리 요청 대기**  | 접수가 필요한 수리 요청 수         |
| **수리 중**      | 현재 수리 진행 중인 건수          |
| **이번달 수리 완료** | 이번달에 완료된 수리 건수          |
| **이번달 수리 비용** | 이번달 수리 비용 합계            |
| **교체 예정 기기**  | 30일 이내 교체 예정 기기 목록      |

위젯 추가·배치 방법은 대시보드 편집 모드에서 진행합니다.

***

### 10. 권한 안내

| 작업                            | 필요 권한                |
| ----------------------------- | -------------------- |
| 워크플로우 화면(반출/반납·이전·수리·자산조사) 처리 | **`device-edit`** 권한 |
| 내 워크플로우 조회                    | 기본 구성원 이상            |
| QR 액션바로 요청 올리기                | 기본 구성원 이상            |

{% hint style="info" %}
**처리 동작은 기기 편집 권한이 필요합니다** 워크플로우의 승인·거절·반납·수리 처리 같은 동작은 **`device-edit`** 권한이 있는 구성원에게만 노출됩니다. 권한이 없으면 처리 버튼 없이 목록 조회만 가능합니다. 플랜이 만료되면 처리 동작이 비활성화됩니다.
{% endhint %}

***

### 11. 문제 해결

#### Q: 워크플로우 화면에 처리 버튼이 보이지 않아요

**원인**: 처리 동작은 **`device-edit`** 권한이 있는 구성원에게만 노출됩니다.

**해결 방법**:

1. ✅ 본인에게 **기기 편집 권한**이 있는지 확인하세요. 없으면 관리자에게 요청합니다.
2. ✅ 플랜이 만료되지 않았는지 확인하세요. 만료 시 처리 동작이 비활성화됩니다.

#### Q: 사이드바에서 "워크플로우" 를 눌렀더니 자산조사 화면이 떠요

정상 동작입니다. 사이드바 **기기 > 워크플로우** 의 진입 지점은 첫 탭인 **자산조사** 입니다. 상단 탭에서 **이전 요청 / 반출/반납 / 수리/AS** 로 이동하세요.

#### Q: 이전 요청을 승인했는데 다른 작업이 같이 취소됐어요

같은 기기에 진행 중이던 워크플로우와 충돌이 있어 자동으로 정리된 경우입니다. 승인 전 **충돌 확인 창**에 어떤 워크플로우가 정리되는지 안내됩니다. 정리하지 않으려면 충돌 확인 창에서 진행을 멈추고, 기존 워크플로우를 먼저 마무리한 뒤 다시 시도하세요.

#### Q: 내 워크플로우의 이전 탭이 "준비 중" 이에요

**내 워크플로우** 의 이전 탭은 아직 준비 중입니다. 이전 요청 현황은 해당 기기 상세 화면의 **`워크플로우`** 탭에서 확인하세요.

#### Q: 반출/반납 탭이 비어 있어요

아직 반출된 기기가 없으면 *"아직 반출 기록이 없습니다"* 로 표시됩니다. 새 반출은 기기 상세 화면의 **`반출하기`** 버튼에서 등록하면 이 탭에 나타납니다.

#### Q: 이 외의 문제

채널톡으로 문의해 주세요.