# 구성원 추가/제외 하기

## 구성원 추가/제외하기

SMPLY에서 구성원을 추가하고 제외하는 방법을 안내합니다. 구성원 추가는 초대와는 별개로, 관리자가 직접 구성원을 등록하는 기능입니다. 제외는 퇴사자 등을 관리 대상에서 제거하되, 데이터는 보존하는 기능입니다.

<figure><img src="/files/14aqlXauLrlIDbqhj7cj" alt="구성원 > 목록"><figcaption><p>구성원 > 목록</p></figcaption></figure>

***

### 구성원 추가와 초대의 차이

| 구분            | 구성원 추가            | 구성원 초대         |
| ------------- | ----------------- | -------------- |
| **방식**        | 관리자가 직접 등록        | 초대 이메일 발송      |
| **이메일 발송**    | 없음                | 있음 (접속 링크)     |
| **로그인 가능 여부** | 즉시 가능 (SSO 연동 시)  | 최초 접속 이후 자동 가입 |
| **사용 시기**     | 온보딩 사전 준비, 연동 구성원 | 일반적인 구성원 등록    |

{% hint style="info" %}
**언제 사용하나요?**

* **구성원 추가**: 입사 예정자 사전 등록, Google/Microsoft 연동 구성원
* **구성원 초대**: 일반적인 신규 구성원 등록 (구성원 초대 가이드 참조)
  {% endhint %}

***

### 구성원 추가하기

{% hint style="info" %}
**가입 요청 탭** 구성원이 직접 워크스페이스 가입을 요청한 경우 **구성원 > 목록** 페이지의 **가입 요청** 탭에서 확인하고 승인할 수 있습니다.
{% endhint %}

#### 개별 구성원 추가

**1단계: 구성원 추가 화면 이동**

1. 왼쪽 메뉴에서 **구성원 > 목록**을 클릭합니다.
2. 우측 상단의 **구성원 추가하기** 버튼을 클릭합니다.

**2단계: 구성원 정보 입력**

| 필드      | 필수 여부 | 설명                    |
| ------- | ----- | --------------------- |
| **이름**  | 필수    | 구성원의 실명               |
| **이메일** | 필수    | 회사 이메일 주소 (도메인 확인 필요) |
| **직급**  | 선택    | 직급 또는 직책              |
| **부서**  | 선택    | 소속 부서                 |
| **팀**   | 선택    | 소속 팀 (최대 3개)          |
| **입사일** | 선택    | 입사 예정일 또는 실제 입사일      |

{% hint style="warning" %}
**이메일 도메인 제한** 회사 도메인이 아닌 이메일 (gmail.com, naver.com 등)은 추가할 수 없습니다. 도메인 추가가 필요하면 관리자에게 문의하세요.
{% endhint %}

**3단계: 역할 할당**

기본적으로 **일반(멤버)** 역할이 할당됩니다. 다른 역할이 필요하면:

1. **역할** 드롭다운을 클릭합니다.
2. 적절한 역할을 선택합니다 (관리자, 매니저, 커스텀 역할 등).
3. 역할에 대한 자세한 설명은 역할 및 권한을 참조하세요.

**4단계: 저장**

1. 모든 정보를 입력한 후 **저장** 버튼을 클릭합니다.
2. 구성원이 목록에 추가됩니다.

{% hint style="success" %}
**SSO 연동 시 즉시 로그인 가능** Google Workspace 또는 Microsoft 365와 연동된 경우, 추가된 구성원은 별도 가입 없이 즉시 로그인할 수 있습니다.
{% endhint %}

***

#### 대량 구성원 추가

여러 명을 한 번에 추가하려면 Excel/CSV 업로드를 사용하세요.

**1단계: 템플릿 다운로드**

1. **구성원 > 목록** 메뉴로 이동합니다.
2. **대량 추가** 버튼을 클릭합니다.
3. **템플릿 다운로드**를 클릭하여 Excel 파일을 받습니다.

{% hint style="danger" %}
**주의: Excel에서 CSV 저장 시**

* 인코딩: UTF-8로 저장
* 구분자: 쉼표(,)
* 이메일 중복 불가
  {% endhint %}

**3단계: 파일 업로드**

1. 작성한 파일을 저장합니다.
2. **파일 선택** 버튼을 클릭하여 파일을 업로드합니다.
3. 업로드 후 **미리보기**에서 데이터를 확인합니다.

**4단계: 오류 확인 및 수정**

업로드 시 오류가 있으면:

| 오류 유형        | 원인             | 해결 방법                 |
| ------------ | -------------- | --------------------- |
| **이메일 중복**   | 이미 등록된 이메일     | 해당 행 삭제 또는 이메일 변경     |
| **도메인 불일치**  | 회사 도메인이 아님     | 올바른 도메인으로 수정          |
| **팀 제한 초과**  | 5개 이상 팀 입력     | 팀 개수를 5개 이하로 조정       |
| **날짜 형식 오류** | YYYY-MM-DD가 아님 | 형식 수정 (예: 2026-01-15) |

오류가 있는 행은 빨간색으로 표시되며, 수정 후 재업로드할 수 있습니다.

**5단계: 등록 완료**

1. 모든 오류를 수정한 후 **등록** 버튼을 클릭합니다.
2. 등록 완료 메시지가 표시되면 구성원 목록에서 확인합니다.

{% hint style="success" %}
**대량 추가 완료 알림** 등록이 완료되면 관리자에게 Slack/이메일로 알림이 발송됩니다.
{% endhint %}

***

### 구성원 비활성화 (제외)

퇴사자·휴직자 등 관리 대상에서 제외하되 **데이터는 보존**하고 싶은 경우에 사용합니다. 실제 UI에서는 "비활성화"라는 용어로 표시됩니다.

#### 비활성화 vs 삭제

| 구분         | 비활성화       | 삭제        |
| ---------- | ---------- | --------- |
| **데이터 보존** | ✅ 보존 (익명화) | ❌ 완전 삭제   |
| **재활성화**   | ✅ 가능       | ❌ 불가능     |
| **사용 기록**  | ✅ 통계에 포함   | ❌ 통계에서 제외 |
| **사용 시기**  | 퇴사자, 휴직자   | 잘못 등록된 계정 |

{% hint style="info" %}
**권장: 비활성화 사용** 데이터 보존과 재활성화 가능성을 고려하여, "삭제"보다 "비활성화"를 권장합니다. 상세 페이지 삭제 플로우에도 *"삭제 시 관련 데이터가 모두 영구 삭제됩니다. 보존하려면 '제외하기'를 사용하세요."* 안내가 표시됩니다.
{% endhint %}

***

#### 개별 구성원 비활성화 (상세 페이지)

1. **구성원 > 목록**에서 비활성화할 구성원을 클릭해 상세 페이지로 이동합니다.
2. 우측 상단 **`수정하기`** 버튼 옆 드롭다운(⋮)을 열고 **`제외하기`** 를 선택합니다.
3. 확인 다이얼로그가 열립니다.
   * Google Workspace 계정이 `active` 또는 `suspended` 상태라면 **`Google Workspace 계정도 함께 삭제`** 체크박스가 함께 표시됩니다.
4. 확인하면 성공 토스트 *"구성원이 제외되었습니다."* 가 표시됩니다.

#### 벌크 비활성화 (목록 Action Bar)

여러 구성원을 한 번에 비활성화할 때:

1. **구성원 > 목록** 에서 체크박스로 여러 구성원을 선택합니다. (본인은 자동으로 제외됩니다)
2. 하단에 나타나는 **Action Bar**에서 **`비활성화`** 버튼을 클릭합니다.
3. 확인 다이얼로그 *"구성원 일괄 비활성화"* — *"{N}명의 구성원을 비활성화하시겠습니까?"*
4. 성공 시 *"구성원 {n}명을 제외했습니다."* 토스트가 표시됩니다.

{% hint style="warning" %}
**비활성화 시 영향**

* 로그인 불가
* 기기 할당 해제
* 소프트웨어 사용자 제거
* 팀 소속 해제
* 사용 기록은 익명화되어 보존
* Google Workspace 계정을 함께 삭제한 경우 Gmail/Drive 등 Google 서비스 접근도 차단
  {% endhint %}

***

### 비활성화된 구성원 관리 (재활성화 / 영구 삭제)

비활성화한 구성원은 **비활성화된 구성원 페이지**(`/member/deactivated`)에서 한곳에 모아 관리합니다. 이곳에서 **복원(재활성화)** 과 **영구 삭제** 를 같은 SplitButton 으로 수행할 수 있습니다.

#### 페이지 열기

1. **구성원 > 목록** 으로 이동합니다.
2. 상단 탭 또는 우측 상단 드롭다운 메뉴(⋮)에서 **`비활성화된 구성원`** 항목을 클릭합니다.
3. 비활성화된 구성원 목록 페이지가 열립니다. 상단에 총 인원 수가 표시되고, 이름·이메일 검색창으로 필터링할 수 있습니다.

#### 일괄 복원(재활성화)

1. 체크박스로 복원하고 싶은 구성원을 선택합니다. (여러 명 가능)
2. 우측 상단 **`{n}명 복원하기`** 메인 버튼을 클릭합니다.
3. 즉시 복원이 실행되며 *"구성원을 복원했습니다."* 토스트가 표시됩니다.

#### 일괄 영구 삭제

영구 삭제는 보존이 필요 없는 기록을 완전히 제거할 때만 사용합니다. 한 번 삭제된 구성원은 복구할 수 없습니다.

1. 체크박스로 삭제할 구성원을 선택합니다.
2. 메인 버튼 오른쪽의 **chevron(▾)** 을 눌러 드롭다운에서 **`{n}명 삭제하기`** (빨간색, 휴지통 아이콘) 를 선택합니다.
3. 확인 다이얼로그에서 대상자 이름·이메일을 확인한 뒤 확정합니다.
4. 완료 시 *"선택한 구성원이 삭제되었습니다."* 토스트가 표시되고 그리드가 재로드됩니다.

{% hint style="danger" %}
**삭제는 되돌릴 수 없습니다** 영구 삭제를 실행한 구성원 레코드와 관련 데이터는 복구되지 않습니다. 보존이 필요하면 **비활성화(제외)** 상태로 두세요. 본인(로그인한 관리자 자신)은 자동으로 대상에서 제외되어 실수로 자신을 삭제할 수 없습니다.
{% endhint %}

{% hint style="info" %}
**권한이 없으면 버튼이 숨겨집니다** 구성원 편집(`member-edit`) 권한이 없으면 SplitButton 자체가 노출되지 않아 조회만 가능합니다. 행 선택이 0건일 때는 버튼이 비활성화되고 툴팁으로 *"구성원을 선택해주세요"* 가 표시됩니다.
{% endhint %}

#### 개별 재활성화 (상세 페이지)

특정 구성원의 상세 페이지로 직접 이동해 재활성화할 수도 있습니다.

1. 비활성화된 구성원의 상세 페이지로 이동합니다. (이름 옆 **`제외됨`** 배지가 표시됩니다)
2. 헤더의 **`제외 취소`** 버튼을 클릭합니다.
3. 성공 시 *"구성원 제외를 취소했어요"* 토스트가 표시됩니다.

{% hint style="success" %}
**재활성화 시 복원되는 정보**

* 로그인 권한
* 역할 및 권한
* 팀 소속 정보
* 과거 사용 기록

기기 할당·소프트웨어 사용자 연결은 자동 복원되지 않으므로 필요 시 수동으로 재등록하세요.
{% endhint %}

**재활성화 후 정보 업데이트 체크리스트:**

* 기기 재할당 (기존 기기 또는 신규 기기)
* 소프트웨어 사용자 재등록
* 팀 소속 변경 (필요 시)

{% hint style="warning" %}
**구성원 한도 주의** 활성 구성원 수가 플랜 한도에 도달한 경우 *"구성원 등록 한도를 초과했습니다. SMPLY에 문의해주세요."* 오류가 표시될 수 있습니다. 이 경우 고객지원팀에 문의하세요.
{% endhint %}

***

### 구성원별 자산 확인하기

특정 구성원이 사용 중인 기기와 소프트웨어를 한눈에 확인할 수 있습니다.

#### 1단계: 구성원 검색

1. **구성원 > 목록** 메뉴로 이동합니다.
2. 상단 검색창에 이름 또는 이메일을 입력합니다.
3. 검색 결과에서 구성원을 클릭합니다.

#### 2단계: 자산 현황 확인

구성원 상세 페이지에서 다음 정보를 확인할 수 있습니다:

**기기 섹션**:

* 할당된 기기 목록 (노트북, 모니터, 마우스 등)
* 기기 상태 (사용 중, 반납 예정 등)
* 에이전트 설치 여부

**소프트웨어 섹션**:

* 사용 중인 SaaS 목록
* 라이선스 종류 (유료/무료)
* 마지막 사용 일시

**사용 통계**:

* 앱 사용 시간

#### 3단계: 직접 편집

구성원 상세 페이지에서 바로 편집할 수 있습니다:

1. **기기 할당** 버튼: 새 기기 할당
2. **소프트웨어 추가** 버튼: 사용자로 등록
3. **팀 변경** 버튼: 소속 팀 수정

***

### 문제 해결

#### Q: 구성원을 추가할 수 없어요

**확인 사항**:

1. ✅ 관리자 또는 "구성원 수정" 권한이 있는지 확인
2. ✅ 이메일 도메인이 회사 도메인인지 확인
3. ✅ 구성원 등록 한도를 초과하지 않았는지 확인 (기본 한도: 1,000명)

**해결 방법**:

* 권한 없음: 관리자에게 권한 요청
* 도메인 오류: 설정 > 회사 설정에서 도메인 추가 요청
* 한도 초과: 채널톡을 통해 문의

#### Q: 대량 추가 시 일부만 등록되고 일부는 실패했어요

**원인**:

* 중복 이메일
* 도메인 불일치
* 팀 개수 초과 (3개 이상)

**해결 방법**:

1. 실패한 행만 따로 CSV로 저장
2. 오류 수정
3. 재업로드

#### Q: 제외한 구성원이 여전히 로그인할 수 있어요

**확인 사항**:

* SSO 연동 시: Google/Microsoft 계정은 별도로 비활성화해야 함
* 캐시 문제: 브라우저 캐시 삭제 또는 시크릿 모드로 확인

**해결 방법**:

1. Google/Microsoft 관리 콘솔에서 계정 비활성화
2. SMPLY에서 구성원 제외
3. 24시간 후 완전히 로그인 차단됨

#### Q: 제외된 구성원을 재활성화했는데 기기가 없어요

재활성화 시 자산은 자동으로 복원되지 않습니다.

**절차**:

1. 구성원 상세 페이지로 이동
2. **기기 할당** 버튼 클릭
3. 기존 기기 또는 신규 기기 할당

#### Q: 구성원별 자산 현황을 일괄 내보내기할 수 있나요?

네, 가능합니다.

**방법**:

1. **구성원** 메뉴로 이동
2. 우측 상단 **내보내기** 버튼 클릭
3. **자산 포함** 옵션 선택
4. CSV 다운로드

내보낸 CSV에는 구성원별 기기 목록, 소프트웨어 목록이 포함됩니다.

#### Q: Google Workspace 연동 시 자동으로 구성원이 추가되나요?

예, 자동 동기화됩니다.

**동기화 주기**: 일 1회 (한국 시간 오전 2시)

**수동 동기화**:

1. 설정 > 연동 관리 > Google Workspace
2. **지금 동기화** 버튼 클릭


---

# 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/member/add_hide.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.