15. 서브에이전트 관리
서브에이전트는 에이전트(중개사) 아래에서 함께 일하는 보조 사용자입니다. 이 장에서는 서브에이전트의 개념, 초대 방법, 자동 멤버 추가 원리, 슬롯 관리, 해제 절차를 상세히 안내합니다.
15.1 서브에이전트란?
서브에이전트는 에이전트(중개사) 계정에 소속된 보조 사용자입니다. 부동산 사무실에서 대표 중개사 아래에서 함께 일하는 직원, 보조원, 파트너 등이 서브에이전트에 해당합니다.
서브에이전트로 등록되면, 해당 에이전트가 소유한 모든 워크스페이스에 자동으로 editor 권한이 부여됩니다. 별도로 워크스페이스마다 멤버를 초대할 필요가 없어, 팀 관리가 매우 간편해집니다.
| 구분 | 에이전트 (중개사) | 서브에이전트 (보조 사용자) |
|---|---|---|
| 역할 | 워크스페이스와 데이터베이스의 소유자 | 에이전트 아래에서 데이터를 함께 관리하는 보조 사용자 |
| 권한 | owner (모든 권한) | editor (데이터 조회/편집 가능, 구조 변경 불가) |
| 워크스페이스 접근 | 직접 생성하고 관리 | 에이전트의 모든 워크스페이스에 자동 추가 |
| 멤버 관리 | 서브에이전트 초대/해제 가능 | 다른 멤버를 초대하거나 해제할 수 없음 |
15.2 서브에이전트 초대
서브에이전트를 초대하려면 워크스페이스 페이지의 서브에이전트 관리 메뉴를 사용합니다. 초대는 이메일 주소를 기반으로 이루어지며, PropSheet에 아직 가입하지 않은 사용자도 초대할 수 있습니다.
15.2.1 초대 절차
- PropSheet에 에이전트 계정으로 로그인합니다.
- 좌측 사이드바 또는 워크스페이스 페이지에서 "서브에이전트 관리" 메뉴를 클릭합니다.
- 서브에이전트 관리 화면이 열리면, 상단의 "서브에이전트 초대" 버튼을 클릭합니다.
- 초대할 사용자의 이메일 주소를 입력합니다. 반드시 Google 계정 이메일이어야 합니다 (PropSheet는 Google OAuth 로그인을 사용합니다).
- "초대" 버튼을 클릭하면 초대가 완료됩니다.
- 초대된 사용자에게는 초대 안내가 전달됩니다.
15.2.2 미가입자 초대
PropSheet에 아직 가입하지 않은 사용자도 서브에이전트로 초대할 수 있습니다. 미가입자를 초대하면 다음과 같은 과정이 진행됩니다.
- 에이전트가 미가입자의 이메일 주소를 입력하여 초대합니다.
- 시스템에 초대 기록이 "대기 중(pending)" 상태로 저장됩니다.
- 미가입자가 나중에 해당 이메일로 Google 로그인하여 PropSheet에 가입합니다.
- 가입이 완료되면 시스템이 대기 중인 초대를 자동으로 감지하여 서브에이전트로 연결합니다.
- 에이전트의 모든 워크스페이스에 editor 멤버로 자동 추가됩니다.
15.3 자동 멤버 추가
서브에이전트 시스템의 가장 큰 장점은 자동 멤버 추가 기능입니다. 서브에이전트가 초대를 수락(Google 로그인)하면, 에이전트가 소유한 모든 워크스페이스에 editor 멤버로 자동 추가됩니다.
15.3.1 자동 추가 흐름
- 에이전트가 서브에이전트를 초대합니다.
- 서브에이전트가 Google 계정으로 PropSheet에 로그인합니다.
- 시스템이 해당 이메일에 대한 대기 중인 초대를 확인합니다.
- 초대가 확인되면 서브에이전트 관계가 활성화됩니다.
- 에이전트가 소유한 모든 기존 워크스페이스에 서브에이전트가 editor로 자동 추가됩니다.
- 이후 에이전트가 새 워크스페이스를 생성하면, 해당 서브에이전트도 자동으로 editor로 추가됩니다.
| 상황 | 자동 추가 여부 | 설명 |
|---|---|---|
| 기존 워크스페이스 | 자동 추가됨 | 서브에이전트 연결 시점에 에이전트가 이미 소유한 모든 워크스페이스에 editor로 추가 |
| 신규 워크스페이스 | 자동 추가됨 | 연결 이후 에이전트가 새로 생성하는 워크스페이스에도 자동으로 editor 추가 |
| 다른 에이전트의 워크스페이스 | 추가 안 됨 | 서브에이전트는 자신을 초대한 에이전트의 워크스페이스에만 접근 가능 |
15.4 슬롯 관리
각 에이전트에게는 서브에이전트를 초대할 수 있는 최대 인원 제한(슬롯)이 설정되어 있습니다. 슬롯 수는 Propnet 서비스 계약에 따라 결정되며, 에이전트별로 다를 수 있습니다.
15.4.1 슬롯 현황 확인
- 서브에이전트 관리 화면에 접속합니다.
- 화면 상단에 "사용 중 슬롯 / 전체 슬롯" 형식으로 현재 현황이 표시됩니다. 예:
2 / 5는 5개 슬롯 중 2개를 사용 중이라는 의미입니다. - 슬롯이 모두 사용 중인 경우, 추가 초대가 불가능합니다.
15.4.2 슬롯이 가득 찬 경우
모든 슬롯이 사용 중이면 새로운 서브에이전트를 초대할 수 없습니다. 이 경우 다음 두 가지 방법 중 하나를 선택해야 합니다.
| 방법 | 설명 |
|---|---|
| 기존 서브에이전트 해제 | 더 이상 함께 일하지 않는 서브에이전트를 해제하면 슬롯이 반환됩니다. |
| 슬롯 추가 요청 | Propnet 관리자에게 연락하여 슬롯 수 증가를 요청할 수 있습니다. |
15.5 서브에이전트 해제
더 이상 함께 일하지 않는 서브에이전트는 해제할 수 있습니다. 해제하면 해당 서브에이전트는 에이전트의 모든 워크스페이스 멤버에서도 자동으로 제거됩니다.
15.5.1 해제 절차
- 서브에이전트 관리 화면에 접속합니다.
- 해제할 서브에이전트 항목 옆의 "해제" 버튼을 클릭합니다.
- 확인 대화상자에서 "해제"를 클릭합니다.
- 서브에이전트 관계가 즉시 해제됩니다.
- 해당 사용자는 에이전트의 모든 워크스페이스 멤버 목록에서 자동으로 제거됩니다.
- 사용하던 슬롯이 반환되어 새로운 서브에이전트를 초대할 수 있습니다.
15.5.2 해제 후 영향
| 항목 | 해제 후 상태 |
|---|---|
| 워크스페이스 접근 | 에이전트의 모든 워크스페이스에서 멤버 제거. 더 이상 접근 불가. |
| 데이터 변경 이력 | 서브에이전트가 이전에 수정한 데이터는 그대로 유지됩니다. 수정 이력도 보존됩니다. |
| 재초대 | 해제한 서브에이전트를 다시 초대할 수 있습니다. 초대 절차를 다시 진행하면 됩니다. |
| 슬롯 | 해제 즉시 슬롯 1개가 반환됩니다. |