> ## Documentation Index
> Fetch the complete documentation index at: https://v3.selectfromuser.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 회원 관리

회원 관리에서는 프로젝트의 인증 기능을 사용하는 회원 계정을 조회하고 관리할 수 있습니다.

회원은 SAPP 웹 콘솔을 관리하는 프로젝트 관리자와 구분됩니다. 이 메뉴에서는 배포한 앱에 로그인하여 사용하는 회원의 계정, 권한, 추가 정보와 활동 기록을 관리합니다.

## 회원 목록 확인하기

프로젝트의 회원 관리 메뉴를 열면 현재 등록된 회원 목록이 표시됩니다.

목록에서는 다음 정보를 확인할 수 있습니다.

* ID: SAPP에서 자동으로 부여한 회원 식별값
* 로그인 ID: 회원이 로그인할 때 사용하는 아이디
* 이메일 및 전화번호
* 권한: 회원에게 부여된 역할
* Property: 회원별로 저장된 추가 정보

오른쪽 검색창에서 로그인 ID, 이메일 또는 전화번호로 회원을 찾을 수 있습니다.

개인정보는 기본적으로 일부가 가려져 표시됩니다. 필요한 경우 개인정보 표시를 선택해 원문을 확인하고, 확인이 끝나면 다시 감추는 것이 좋습니다.

## 회원 추가하기

오른쪽 위의 회원 추가를 선택하고 회원 정보를 입력합니다.

등록할 수 있는 정보는 다음과 같습니다.

* 아이디
* 이메일
* 전화번호
* 비밀번호

앱의 로그인 방식에 따라 필요한 항목만 입력할 수 있습니다. 다만 실제 로그인에 사용할 아이디나 이메일과 비밀번호는 앱의 인증 방식과 일치해야 합니다.

회원이 직접 가입할 수 있는 앱이라면 회원 추가 기능 대신 SAPP의 회원가입 API를 연결할 수도 있습니다.

## 회원 정보 관리하기

회원 목록에서 열기를 선택하면 해당 회원의 관리 기능이 표시됩니다.

### 회원정보 수정

회원의 로그인 ID, 이메일과 전화번호를 변경합니다.

로그인에 사용하는 값을 변경하면 회원이 기존 정보로 로그인하지 못할 수 있으므로, 변경 내용을 회원에게 안내해야 합니다.

### 권한 수정

회원에게 하나 이상의 권한을 부여할 수 있습니다.

기본적으로 `Admin`, `User` 권한을 사용할 수 있으며, 프로젝트에서 필요한 권한을 직접 추가할 수도 있습니다. 앱에서는 로그인한 회원의 권한을 확인하여 화면이나 기능의 사용 범위를 구분할 수 있습니다.

예를 들어 다음과 같이 사용할 수 있습니다.

* Admin: 전체 기능 사용
* User: 일반 업무 기능 사용
* CS: 고객 문의 및 주문 조회
* Manager: 승인 및 관리 기능 사용

새 권한을 추가한 뒤에는 앱에서도 같은 권한 이름을 기준으로 접근을 제어해야 합니다.

### Property 관리

Property는 회원마다 추가 정보를 저장하는 기능입니다. `key`와 `value` 형태로 여러 항목을 등록할 수 있습니다.

예를 들어 다음과 같은 정보를 저장할 수 있습니다.

```text theme={null}
department: operation
company_id: 120
region: seoul
employee_no: A-1024
```

Property는 회원을 특정 조직이나 고객사에 연결하거나, 앱에서 사용자별 화면과 데이터를 구분할 때 활용할 수 있습니다.

중요한 비밀번호, API 키와 같은 민감한 값은 Property에 저장하지 않는 것이 좋습니다.

### 비밀번호 재설정

회원이 비밀번호를 잊었거나 계정 보안을 위해 변경이 필요한 경우 새로운 비밀번호를 직접 설정할 수 있습니다.

새 비밀번호와 확인 값을 입력한 뒤 저장합니다. 변경 후에는 기존 비밀번호로 로그인할 수 없습니다.

### 활동기록 확인

회원의 로그인, 회원가입, 계정 관리 변경 기록을 확인할 수 있습니다.

각 기록에는 다음 정보가 표시됩니다.

* 실행 일시
* 활동 유형과 처리 결과
* 브라우저 및 접속 환경
* 요청 IP 주소

로그인이 되지 않거나 계정 변경 경위를 확인해야 할 때 활동기록을 활용할 수 있습니다. 화면 아래의 전체 활동기록에서는 특정 회원이 아닌 프로젝트 전체 회원의 기록을 확인할 수 있습니다.

### 회원 비활성화

더 이상 앱을 사용하지 않는 회원은 삭제하는 대신 비활성화할 수 있습니다.

비활성화된 회원은 로그인이 제한되지만 기존 회원 정보와 활동기록은 유지됩니다. 퇴사자나 계약이 종료된 외부 사용자를 관리할 때 활용할 수 있습니다.

## 회원 API 테스트하기

상단의 연동을 선택하면 SAPP에서 제공하는 회원 API를 직접 테스트할 수 있습니다.

테스트할 수 있는 주요 경로는 다음과 같습니다.

```text theme={null}
/api/login
/api/signup
/api/me
/api/profile
```

경로를 선택하면 해당 API에서 사용하는 입력 항목이 표시됩니다. 값을 입력하고 테스트 호출을 선택하면 응답을 JSON 형식으로 확인할 수 있습니다.

* `/api/login`: 로그인
* `/api/signup`: 회원가입
* `/api/me`: 현재 로그인한 회원 정보 조회
* `/api/profile`: 회원 프로필 조회 또는 관리

화면에 표시되는 프로젝트 인증 정보는 외부에 공개하거나 클라이언트 코드에 그대로 노출하지 않도록 주의해야 합니다. 실제 앱에서는 SAPP이 제공하는 인증 방식과 API 호출 규칙에 따라 연동합니다.

## 운영 시 권장사항

회원에게는 업무에 필요한 최소 권한만 부여합니다. 퇴사하거나 더 이상 사용하지 않는 계정은 즉시 비활성화하고, 로그인 문제나 의심스러운 접근이 발생하면 활동기록을 확인합니다.

회원의 추가 정보는 Property로 관리하되, 앱의 접근 제어는 화면에서 버튼을 숨기는 것만으로 처리하지 말고 API와 데이터 조회 단계에서도 회원 권한을 확인해야 합니다.