> 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/member/org-chart.md).

# 조직도 관리

## 조직도 관리

구성원 목록 페이지(`/member/list`)의 **뷰 전환** 을 통해 전체 구성원과 부서·그룹 단위의 조직도를 한 화면에서 관리합니다. 별도 경로였던 `/member/unit` 과 `/member/group` 은 현재 자동으로 `/member/list?view=unit` · `?view=group` 으로 리다이렉트됩니다.

{% hint style="info" %}
**부서(Unit) vs 그룹(Group)**

* **부서(Unit)**: 계층 구조를 가진 조직 단위 (회사 → 본부 → 팀 등). 구성원은 **하나의 부서**에만 직접 소속됩니다.
* **그룹(Group)**: 계층 없이 플랫한 구성원 그룹. TF·프로젝트팀 등 유연하게 묶을 때 사용하고, 구성원은 **여러 그룹**에 동시에 속할 수 있습니다.
  {% endhint %}

***

### 1. 뷰 전환

구성원 목록 페이지 상단 툴바에 세 가지 뷰 아이콘이 있습니다.

| 아이콘           | 뷰           | URL 파라미터      | 레이아웃                    |
| ------------- | ----------- | ------------- | ----------------------- |
| ListIcon      | **전체** (기본) | 없음            | 평면 구성원 그리드              |
| Building2Icon | **부서별**     | `?view=unit`  | 좌측 부서 트리 + 우측 해당 부서 구성원 |
| UsersIcon     | **그룹별**     | `?view=group` | 좌측 그룹 목록 + 우측 해당 그룹 구성원 |

부서·그룹 뷰는 **좌우 가변 분할 레이아웃** 으로 표시되며, 좌측 패널(기본 30%)과 우측 그리드(기본 70%)의 폭은 자유롭게 조정할 수 있습니다.

{% hint style="info" %}
**뒤로가기 동작** 뷰 전환은 브라우저 히스토리에 쌓이지 않고 URL만 교체됩니다. 뒤로가기를 누르면 뷰 전환이 아닌 **이전 페이지**로 이동합니다.
{% endhint %}

***

### 2. 부서 관리

#### 2-1. 부서 트리

부서 뷰 좌측에 계층 트리가 표시됩니다.

* 최상단에 가상 노드 **`회사 전체`** 가 있습니다. 클릭하면 어느 부서에도 배정되지 않은 구성원만 그리드에 표시됩니다.
* **접힌(▶)** 노드의 구성원 수는 **하위 부서를 포함한 재귀 카운트**입니다.
* **펼친(▼)** 노드의 구성원 수는 **직접 소속된 구성원만** 세는 카운트입니다.

#### 2-2. 부서 추가

1. 트리에서 상위가 될 부서에 마우스를 올리면 인라인 `+` 버튼이 표시됩니다. 최상위에 추가하려면 `회사 전체` 또는 페이지 상단의 추가 버튼을 사용합니다.
2. **`부서 추가`** 다이얼로그가 열립니다.
3. 필드:
   * **부서명** — 필수
   * **상위 부서** — 콤보박스에서 선택 (한글 검색 지원)
4. **`저장`** 클릭 → 토스트 *"부서가 추가되었습니다."*

#### 2-3. 부서 수정

1. 부서 노드에 마우스를 올리고 **수정(펜) 아이콘** 을 클릭합니다.
2. 기존 값이 채워진 폼에서 내용을 수정합니다.
3. 저장 시 토스트 *"부서가 수정되었습니다."*

#### 2-4. 부서 삭제

1. 부서 노드의 **삭제(휴지통) 아이콘** 을 클릭합니다.
2. 확인 다이얼로그가 열리며 부서명이 따옴표로 감싸져 표시됩니다.
3. 확인하면 *"부서가 삭제되었습니다."* 토스트가 표시됩니다.

{% hint style="warning" %}
**삭제할 수 없는 부서** 다음 조건이면 삭제 버튼이 비활성화됩니다.

* Google Workspace 등 외부 시스템과 동기화된 부서
* 하위 부서가 있는 경우
* 배정된 구성원이 있는 경우

외부 동기화된 부서는 **원본 시스템(Google Workspace / Microsoft 365)** 에서 삭제해야 합니다.
{% endhint %}

#### 2-5. 부서에 구성원 배정

1. 트리에서 부서를 선택합니다.
2. 우측 그리드 상단의 **`구성원 관리`** 버튼(또는 유사 UI)을 클릭하면 **부서 구성원 관리 다이얼로그** 가 열립니다.
3. 전체 활성 구성원 목록에서 체크박스로 **이 부서에 속할 구성원** 을 선택합니다.
4. **`저장`** 클릭 → 변경된 소속이 즉시 반영됩니다.

구성원은 **하나의 부서에만** 속할 수 있으므로, 다른 부서 소속자를 체크하면 소속이 자동으로 이동합니다.

***

### 3. 그룹 관리

그룹 뷰 좌측의 그룹 목록에서 동일한 패턴으로 관리합니다.

#### 3-1. 그룹 추가

1. 그룹 목록 상단 **`+ 그룹 추가`** 버튼 클릭 → **`그룹 추가`** 다이얼로그
2. 필드: **그룹명** (단일 필드, 상위 그룹 없음)
3. **`저장`** → *"그룹이 추가되었습니다."*

#### 3-2. 그룹 수정 / 삭제

* 그룹 항목 hover 시 펜/휴지통 아이콘 노출
* 수정 다이얼로그는 기존 값 프리필
* 삭제 확인 다이얼로그에 그룹명 표시

#### 3-3. 그룹 구성원 관리

1. 그룹을 선택합니다.
2. 우측 그리드 상단 **`구성원 관리`** 버튼을 클릭해 **그룹 구성원 관리 다이얼로그** 를 엽니다.
3. 체크박스로 그룹에 포함할 구성원을 선택/해제합니다.

**한 구성원이 여러 그룹에 동시에 속할 수 있습니다.**

***

### 4. 외부 연동 조직/그룹

Google Workspace·Microsoft 365 연동이 활성화되어 있으면, 외부 시스템의 조직 단위(OU)·그룹이 자동으로 동기화되어 같은 트리/목록에 함께 표시됩니다.

| 상태         | 설명           | 가능한 작업            |
| ---------- | ------------ | ----------------- |
| **동기화됨**   | 외부 시스템과 연결됨  | 조회만 가능 (편집·삭제 불가) |
| **연결 해제됨** | 외부 시스템에서 삭제됨 | 삭제 가능             |

{% hint style="info" %}
**동기화 조직 편집은 원본 시스템에서** 동기화된 부서/그룹은 SMPLY에서 직접 수정·삭제할 수 없습니다. 변경이 필요하면 Google Workspace 또는 Microsoft 365 관리 콘솔에서 작업하세요. 변경 내용은 다음 동기화 때 SMPLY에도 반영됩니다.
{% endhint %}

***

### 5. 접근 경로 요약

| 하고 싶은 것            | 경로                                              |
| ------------------ | ----------------------------------------------- |
| 전체 구성원 목록          | `/member/list`                                  |
| 부서별 조직도            | `/member/list?view=unit` 또는 기존 `/member/unit`   |
| 그룹별 조직도            | `/member/list?view=group` 또는 기존 `/member/group` |
| 어디에도 속하지 않은 구성원 확인 | 부서 뷰에서 **`회사 전체`** 선택                           |
| 한 구성원의 소속만 변경      | 해당 구성원 상세 페이지에서 **`수정하기`** (부서·그룹 직접 변경)        |

***

### 6. 자주 묻는 질문

#### Q: 구성원을 여러 부서에 동시에 배정하고 싶어요

부서는 **1인 1부서** 구조입니다. 여러 조직에 걸치는 구성원이 있다면 **그룹** 기능을 함께 활용하세요 (예: "TF-신사업" 그룹에 복수 부서 인원 추가).

#### Q: 외부 동기화된 부서를 SMPLY에서 수정할 수 있나요

아니요. 원본 시스템(Google Workspace / Microsoft 365)에서 수정해야 합니다. 동기화되지 않게 하려면 GWS 연동 설정의 **선택적 동기화**에서 해당 조직 단위를 제외하세요.

#### Q: 부서·그룹 이름을 바꿨는데 검색에서 예전 이름이 나와요

브라우저 캐시 영향일 수 있습니다. 페이지를 강력 새로고침(Cmd+Shift+R / Ctrl+Shift+R)해 보세요.

#### Q: 한 사람의 부서·그룹만 바꾸고 싶어요

이 화면의 **`구성원 관리`** 다이얼로그는 하나의 부서·그룹에 속할 구성원을 한꺼번에 선택하는 용도입니다. 특정 구성원 한 명의 소속만 바꾸려면 그 구성원의 **상세 페이지**에서 **`수정하기`** 를 눌러 부서·그룹을 직접 변경하세요. 부서는 1인 1부서로 교체되고, 그룹은 추가·제거됩니다.

#### Q: 이 외의 문제

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