7. 계정 관리
관리자 콘솔에 로그인하는 계정을 만들고 관리하는 화면입니다. 어드민 콘솔을 사용할 수 있는 사람은 모두 여기서 만든 계정으로 로그인합니다.
🍎
7.1 들어가기 전에 — 두 가지 역할
이 시스템의 계정에는 두 가지 역할이 있습니다.
| 역할 | 무엇을 할 수 있나 | 담당 서비스 |
|---|---|---|
| SYSTEM_ADMIN (시스템 관리자) | 모든 서비스·요금제·구독·결제·계정·전체 설정·감사 로그를 관리 | 모든 서비스 (배정 불필요) |
| SERVICE_MANAGER (서비스 담당자) | 자신에게 배정된 서비스의 요금제·구독만 관리 | 배정된 서비스만 |
🍎쉽게 말하면 SYSTEM_ADMIN은 회사 전체를 보는 관리자, SERVICE_MANAGER는 자기가 맡은 서비스만 보는 담당자입니다.
주의: 시스템 관리자(SYSTEM_ADMIN)에게는 담당 서비스를 배정할 수 없습니다. 이미 모든 서비스에 접근할 수 있기 때문입니다.
7.2 계정 목록 보기 · 검색
좌측 메뉴에서 계정을 누르면 등록된 계정 목록이 나옵니다.
목록에는 이메일 · 역할 · 주 서비스 · 상태가 표시됩니다. 로그인한 본인 계정에는 이메일 옆에 (로그인사용자) 라고 표시되며, 본인 행은 클릭(상세 이동)이 되지 않습니다 — 내 정보는 화면 왼쪽 아래 이메일을 눌러 내 정보 화면에서 수정합니다.
7.2.1 검색과 필터
| 도구 | 설명 |
|---|---|
| 검색창 | 이메일 일부를 입력하면 해당 계정만 추려집니다(부분 일치). |
| 역할 필터 | 시스템 관리자 / 서비스 담당자로 좁혀 봅니다. |
| 상태 필터 | 활성(ACTIVE) / 설정 대기(PENDING) / 잠김(LOCKED) / 비활성(DISABLED)으로 좁혀 봅니다. |
| 정렬 | 이메일 · 역할 · 상태 머리글을 클릭해 정렬할 수 있습니다(기본은 생성일 최신순). |
| 엑셀 다운로드 | 현재 검색·필터 조건 그대로 목록을 엑셀(.xlsx) 파일로 내려받습니다. 내려받는 항목은 이메일 · 역할 · 주 서비스 · 상태이며, 페이지에 보이는 분량이 아니라 조건에 맞는 전체가 담깁니다. |
💡참고: 삭제한 계정은 목록에 나타나지 않습니다. 어떤 필터를 걸어도 보이지 않습니다(완전히 지우지 않고 숨기는 방식이라 기록은 남습니다).
7.2.2 계정 상태가 뜻하는 것
| 상태 | 의미 |
|---|---|
| 활성 (ACTIVE) | 비밀번호가 설정되어 정상 로그인 가능 |
| 설정 대기 (PENDING) | 계정은 만들어졌지만 아직 비밀번호 미설정 → 로그인 불가 |
| 잠김 (LOCKED) | 로그인 비밀번호를 연속으로 여러 번 틀려 일시 잠김 (정해진 시간이 지나면 자동 해제) |
| 비활성 (DISABLED) | 관리자가 일부러 막아 둔 상태 → 로그인 불가 |
| 삭제됨 (DELETED) | 삭제 처리된 계정 → 목록에 보이지 않음(완전히 지우지 않고 숨김) |
💡참고: 비밀번호를 몇 번 틀리면 잠기는지(기본 5회), 얼마 후 자동 해제되는지(기본 15분)는 전체 설정에서 바꿀 수 있습니다.
7.3 새 계정 만들기
- 계정 목록 화면 오른쪽 위 계정 추가 버튼을 누릅니다. (필수 항목의 라벨에는 빨간 별표 * 가 표시됩니다)
- 이메일을 입력합니다. (로그인 아이디 겸 연락처로 쓰입니다. 시스템 전체에서 중복될 수 없습니다.)
- 필요하면 전화번호를 입력합니다. (선택)
- 역할을 고릅니다 — 기본값은 서비스 담당자(SERVICE_MANAGER)입니다.
- 서비스 담당자를 골랐다면, 아래에 나타나는 담당 서비스 체크박스에서 맡을 서비스를 선택합니다. (지금 비워 두고 나중에 배정해도 됩니다.)
- 계정 생성 + 설정 메일 발송 버튼을 누릅니다.
계정이 만들어지면 설정 대기(PENDING) 상태가 되고, 입력한 이메일로 비밀번호 설정 메일(「비밀번호 설정하기」 버튼이 있는 HTML 메일, 비밀번호 재설정 메일과 동일한 디자인)이 자동 발송됩니다. 받는 사람이 메일의 버튼/링크에서 비밀번호를 직접 정하면 활성(ACTIVE) 상태가 되어 로그인할 수 있습니다. 계정 생성 사실은 시스템 관리자 전원에게도 알림 메일로 전달됩니다.
💡참고: 서비스 담당자에게 여러 서비스를 한 번에 배정하면, 그중 첫 번째 서비스가 "주 서비스"(목록에 표시되는 대표 서비스)가 되고 나머지는 추가 담당으로 들어갑니다. 같은 서비스를 두 번 골라도 한 번만 반영됩니다.
중요: 비밀번호 설정 링크는 발송 후 48시간 동안만 유효합니다(기본값 — 서버 환경설정
password_link_ttl_hours로 조정, 관리자 화면에서는 바꿀 수 없음). 만료되면 계정 상세에서 다시 발송하면 됩니다.주의: 메일 발송에 실패해도 계정 자체는 정상적으로 만들어집니다. "메일 발송에 실패했습니다" 안내가 뜨면, 메일(SMTP) 설정을 확인한 뒤 계정 상세에서 비밀번호 재설정 메일로 다시 보낼 수 있습니다.
팁: 시스템 관리자(SYSTEM_ADMIN)로 만들면 담당 서비스 선택란이 사라집니다. 모든 서비스에 접근하기 때문입니다.
7.4 계정 정보 수정
계정을 눌러 상세 화면으로 들어간 뒤 오른쪽 위 정보 수정 버튼을 누르면 이메일과 전화번호를 바꿀 수 있습니다.
💡참고: 수정 화면에서는 역할을 바꿀 수 없습니다. 역할이 잘못 지정되었다면 계정을 새로 만드는 방식으로 처리하세요.
팁: 어떤 서비스의 대표 담당자로 지정된 계정의 이메일을 바꾸면, 그 서비스의 담당자 이메일도 자동으로 함께 바뀝니다. 따로 손볼 필요가 없습니다.
참고: 전화번호 칸을 비운 채 저장하면 등록된 전화번호가 지워집니다. 다른 계정이 이미 쓰는 이메일로는 바꿀 수 없습니다(중복 안내가 표시됩니다).
7.5 담당 서비스 배정 · 해제
서비스 담당자(SERVICE_MANAGER) 계정 상세 화면 오른쪽에는 담당 서비스 카드가 있습니다. 드롭다운에는 아직 담당하지 않은 서비스만 나타나므로, 같은 서비스를 두 번 배정할 일은 없습니다.
각 담당 서비스 옆에는 이 계정이 그 서비스의 대표 담당자(알림 수신처)인지 일반 담당자인지 배지로 표시됩니다. 서비스명을 누르면 해당 서비스의 상세 화면으로 이동해 담당자·요금제 등을 바로 확인할 수 있습니다.
7.5.1 서비스 배정하기
- 담당 서비스 카드의 드롭다운에서 맡길 서비스를 고릅니다.
- 서비스 추가 버튼을 누릅니다.
- 해당 서비스가 담당 목록에 추가됩니다.
💡참고: 담당 서비스가 하나도 없던 담당자에게 처음 배정한 서비스는 자동으로 주 서비스가 됩니다.
7.5.2 서비스 해제하기
- 담당 서비스 목록에서 해제할 서비스 옆 해제 버튼을 누릅니다.
- 즉시 담당에서 빠집니다.
💡참고: 해제 버튼은 확인 절차 없이 바로 처리됩니다. 신중히 누르세요.
참고: 주 서비스를 해제하면, 남아 있는 담당 서비스 중 하나가 자동으로 새 주 서비스로 올라섭니다. 남은 서비스가 없으면 담당 서비스가 비게 됩니다.
중요: 해당 서비스의 대표 담당자(알림 수신처)로 지정된 계정은 그 서비스에서 해제할 수 없습니다. 해제 버튼을 누르면 "대표 담당자는 해제할 수 없습니다. 먼저 다른 계정을 대표로 지정하세요." 경고 창이 뜹니다. 먼저 서비스 화면에서 다른 계정을 대표로 지정한 뒤 해제하세요.
주의: 시스템 관리자(SYSTEM_ADMIN)에게는 서비스를 배정할 수 없습니다. 배정을 시도하면 오류가 표시됩니다.
7.6 비활성화 · 활성화
잠시 로그인을 막고 싶을 때 계정을 비활성화할 수 있습니다(나중에 다시 활성화 가능).
7.6.1 비활성화
- 계정 상세에서 비활성화 버튼을 누릅니다.
- "로그인이 차단되고 기존 세션이 모두 종료됩니다" 확인 창에서 한 번 더 확인합니다.
- 계정이 비활성(DISABLED) 상태가 되고, 그 사람이 현재 로그인 중이었다면 즉시 로그아웃됩니다.
7.6.2 활성화
비활성 상태인 계정 상세에는 활성화 버튼이 나타납니다. 누르면 다시 로그인할 수 있게 됩니다. (비밀번호가 이미 설정돼 있으면 활성, 아직이면 설정 대기 상태로 복구됩니다.)
⚠️주의: 본인 계정은 비활성화할 수 없습니다. 실수로 스스로 잠기는 사고를 막기 위한 안전장치입니다.
7.7 계정 삭제
더 이상 쓰지 않는 계정은 삭제할 수 있습니다.
- 계정 상세에서 빨간색 삭제 버튼을 누릅니다.
- "로그인이 영구 차단되고 담당 서비스 연결이 모두 해제됩니다. 되돌릴 수 없습니다" 확인 창에서 확인합니다.
- 계정이 목록에서 사라지고 로그인이 막힙니다.
⚠️주의: 본인 계정은 삭제할 수 없습니다.
중요: 어떤 서비스의 대표 담당자로 지정된 계정은 바로 삭제되지 않습니다. "'OO' 서비스의 대표 담당자입니다. 먼저 다른 계정을 대표로 지정하세요" 안내가 뜨면, 먼저 서비스 화면에서 다른 계정을 대표로 바꾼 뒤 다시 삭제하세요. 여러 서비스의 대표라면 대표로 지정된 서비스 이름이 모두 나열됩니다(예: "'OO', 'XX' 등 2개 서비스의 대표 담당자입니다").
참고: 삭제는 기록을 완전히 지우지 않고 숨기는 방식입니다. 누가 무엇을 했는지 감사 로그에는 그대로 남습니다.
7.8 비밀번호 설정 메일 다시 보내기
비밀번호를 잊었거나, 설정 링크가 만료됐거나, 처음 메일이 도착하지 않았을 때 사용합니다.
- 계정 상세에서 비밀번호 재설정 메일 버튼을 누릅니다.
- 메일은 발송 대기열(서버가 순서대로 보내려고 잠시 쌓아 두는 줄)에 등록되고 "비밀번호 재설정 메일 발송을 요청했습니다(대기열)" 토스트가 바로 표시됩니다. 실제 전송은 서버가 대기열에서 순서대로 처리합니다(전송 결과는 감사 로그에 기록 — 감사 로그 참고).
- 입력된 이메일로 비밀번호 재설정 버튼이 있는 안내 메일(브랜딩·CTA 버튼 포함 HTML 메일, HTML 미지원 클라이언트는 평문으로 표시)이 발송됩니다.
- 받는 사람이 메일의 「비밀번호 재설정하기」 버튼(또는 본문 링크)에서 새 비밀번호를 정하면 다시 로그인할 수 있습니다.
⚠️중요: 설정/재설정 링크는 1회용입니다. 비밀번호를 한 번 설정하고 나면 만료 시간이 남아 있어도 같은 링크는 무효화되며, 다시 열면 "만료되었거나 이미 사용된 링크입니다. 시스템 관리자에게 재발급을 요청하세요" 안내와 함께 로그인 화면으로 이동합니다.
참고: 보안을 위해 재설정 메일을 보내면 해당 계정의 기존 로그인 세션(로그인된 상태)은 즉시 모두 종료됩니다 — 계정 탈취가 의심되는 상황에 대비한 조치로, 그 사람은 새 비밀번호로 다시 로그인해야 합니다. 새 링크 유효기간은 역시 48시간입니다.
팁: 비밀번호를 연속으로 여러 번(기본 5회) 틀려 잠김(LOCKED) 상태가 된 계정도, 이 재설정 메일로 새 비밀번호를 설정하면 잠금이 바로 풀립니다. (또는 정해진 시간이 지나면 자동 해제됩니다 — 기본 15분.)
7.9 자주 묻는 상황
| 상황 | 해결 |
|---|---|
| 새로 만든 사람이 로그인을 못 함 | 아직 비밀번호 미설정(PENDING)입니다. 설정 메일의 링크로 비밀번호를 정해야 합니다. |
| 설정 메일 링크가 만료됨 | 계정 상세 → 비밀번호 재설정 메일로 새 링크 발송. |
| 비밀번호를 여러 번 틀려 잠김 | 15분 후 자동 해제, 또는 재설정 메일로 즉시 해제. |
| 담당자를 다른 서비스로 옮기고 싶음 | 계정 상세에서 기존 서비스 해제 후 새 서비스 추가. |
| 대표 담당자라 삭제가 안 됨 | 서비스 화면에서 다른 계정을 대표로 지정한 뒤 삭제. |