팀 관리
기관이 커지면 리소스를 팀 단위로 나눠 관리하고 싶어집니다. [팀 관리] 페이지에서는 기관 하위에 팀을 만들고, 사용자를 팀에 배정하며, 팀별 역할을 지정합니다. 팀으로 나누면 장비·서비스·인증정보 등이 팀 단위로 격리됩니다.
필요 권한: 팀 생성·편집·삭제는 기관 관리자(Manager) 또는 플랫폼 관리자(PlatformAdmin)만 할 수 있습니다. 팀 관리자(TeamManager)는 자기 팀의 멤버 배정(추가·제거)만 할 수 있습니다.
팀 관리자 임명·해제를 포함한 모든 역할 변경은 [사용자 관리] 페이지 한 곳에서 이루어집니다. 권한을 바꾸는 경로가 두 곳으로 나뉘면, 한쪽에 걸어 둔 제한을 다른 쪽으로 우회할 수 있기 때문입니다. 이 화면의 팀 역할은 읽기 전용으로 표시됩니다. 자세한 내용은 사용자/권한 관리를 참고하세요.
무엇을 하는 곳인가
- 팀 생성·편집·삭제: 기관 하위 팀을 만들고 이름/설명을 관리합니다.
- 멤버 배정: 기관 사용자를 팀에 추가하거나 제거합니다. 한 사용자는 하나의 팀에만 속합니다(단일팀 정책) — 이미 다른 팀에 속한 사용자를 추가하면 실패합니다.
- 팀 역할 확인: 각 멤버가 팀 관리자인지 멤버인지 배지로 확인합니다(변경은 [사용자 관리] 에서).
핵심 요소
- 통계 카드: 전체 팀 수 · 총 멤버 수 · 팀 관리자 수.
- 팀 목록 테이블: 팀 이름(기본 팀은 기본 태그) · 설명 · 멤버(멤버 수와 팀 관리자 수) · 작업(멤버 관리 / 편집 / 삭제).
- 멤버 관리 모달: 팀의 멤버 목록(사용자·팀 역할 배지·제거)과 배정 가능 사용자에서 멤버를 추가하는 영역.
SaaS 환경의 플랫폼 관리자는 소속 기관이 없으므로, 헤더에서 대상 기관을 먼저 선택한 뒤 그 기관의 팀을 관리합니다. 설치형은 기관이 하나뿐이라 기관 선택 단계가 없습니다.
사용 방법
팀 만들기
- [팀 관리] 페이지에서 새 팀 등록 버튼을 클릭합니다. (기관 관리자 이상만 보입니다.)
- 팀 이름과 설명을 입력하고 저장합니다.
- 목록에 새 팀이 추가됩니다. 팀 이름을 편집하려면 행의 편집(연필) 버튼을 사용합니다.
멤버 배정하기
- 대상 팀 행의 멤버 관리 아이콘을 클릭해 멤버 관리 모달을 엽니다.
- 멤버 추가 영역에서 배정 가능한 사용자를 선택해 추가합니다. 추가된 사용자는 항상 멤버로 배정됩니다.
- 팀 관리자로 임명하려면 [사용자 관리] 페이지에서 해당 사용자의 역할을 변경합니다. 임명 대상은 이미 그 팀에 속해 있어야 하므로, 팀 배정을 먼저 하고 임명을 나중에 합니다.
- 멤버를 팀에서 빼려면 해당 행의 제거 버튼을 사용합니다.
기관 관리자는 팀에 속하지 않습니다
기관 관리자(Manager)는 기관 전체를 관리하는 역할이라 어떤 팀에도 소속되지 않습니다. [사용자 관리] 에서 소속 팀이 미배정으로 표시되며, 팀의 멤버 수나 팀 관리자의 "내 팀 사용자" 집계에도 포함되지 않습니다.
기관 관리자를 팀에 배정하면 그 사람의 기관 역할이 멤버로 내려가고 화면 접근 권한이 모두 해제됩니다. 팀 배정 창이 배정 전에 이를 알려 주며, 멤버로 들어가는 경우에는 화면 권한을 다시 지정해야 한다는 안내가 함께 표시됩니다(팀 관리자로 들어가면 팀 안에서 전권을 가지므로 해당하지 않습니다).
역할을 오르내릴 때의 팀 소속은 자동으로 정리됩니다.
- 멤버를 기관 관리자로 승격하면 팀 소속이 해제됩니다.
- 기관 관리자를 멤버로 강등하면 먼저 기본 팀에 배정한 뒤 역할을 변경합니다. 기본 팀이 없으면 강등 자체가 진행되지 않습니다 — 팀 없는 멤버가 남는 것을 막기 위해서입니다. 기본 팀을 먼저 지정하세요.
팀 삭제하기
- 대상 팀 행의 삭제 버튼 → 확인. 팀을 삭제하면 그 팀의 멤버 소속도 함께 해제됩니다.
- 기본 팀은 삭제할 수 없습니다. 다른 팀을 기본 팀으로 지정한 뒤 삭제하세요.
문제 해결
- "이미 다른 팀 소속"으로 멤버 추가가 실패합니다: 단일팀 정책상 한 사용자는 하나의 팀에만 속합니다. 기존 팀에서 먼저 제거한 뒤 새 팀에 추가하세요.
- 팀 역할 드롭다운이 없습니다: 정상입니다. 역할 변경은 [사용자 관리] 에서만 가능하며 이 화면에서는 배지로만 표시됩니다.
- 새 팀 등록 버튼이 보이지 않습니다: 팀 생성·편집·삭제는 기관 관리자 이상 권한이 필요합니다. 팀 관리자는 자기 팀의 멤버 배정만 가능합니다.
- 멤버를 다른 팀으로 옮기거나 제거했더니 해당 사용자가 로그아웃됐습니다: 팀 배정이 바뀌면 대상 사용자의 세션이 무효화되는 정상 동작입니다. 다시 로그인하면 복구됩니다.
- 팀 목록이 비어 있습니다(플랫폼 관리자): 헤더에서 대상 기관을 선택했는지 확인하세요. 소속 기관이 선택되지 않으면 팀을 관리할 수 없습니다.