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

# 사용자 관리

> 광고주와 매체사 계정을 생성하고 권한을 관리하는 방법을 안내합니다.

## 이 가이드는 누구를 위한 것인가요?

**관리자** 계정으로 사용자를 관리하는 분들을 위한 가이드입니다.

* 새로운 광고주나 매체사 계정을 만들고 싶은 분
* 사용자에게 권한을 부여하거나 변경하고 싶은 분
* 사용자의 예산이나 크레딧을 관리하고 싶은 분

***

## 시작하기 전에

<Note>
  다음 조건이 충족되어야 합니다:

  * A2 관리 콘솔 접속 권한 (**관리자** 역할)
  * 사용자 관리 권한 (Users 읽기/쓰기)
</Note>

***

## 사용자 역할 이해하기

A2 플랫폼에는 세 가지 역할이 있습니다.

| 역할      | 영어         | 주요 기능            |
| ------- | ---------- | ---------------- |
| **관리자** | Admin      | 전체 시스템 관리        |
| **매체사** | Retailer   | 지면 관리, 배정 승인     |
| **광고주** | Advertiser | 캠페인/소재 관리, 배정 요청 |

```mermaid theme={null}
flowchart TD
    A[관리자 Admin] -->|계정 생성| B[매체사 Retailer]
    A -->|계정 생성| C[광고주 Advertiser]
    B -->|배정 승인| D[광고 노출]
    C -->|배정 요청| D
```

***

## 1단계: 사용자 계정 만들기

### 계정 생성

1. **사용자** 메뉴에서 **새 사용자 만들기**를 클릭합니다.
2. 다음 정보를 입력합니다.

| 항목         | 영어             | 설명              | 필수 |
| ---------- | -------------- | --------------- | -- |
| **이메일**    | Email          | 로그인에 사용할 이메일    | ✅  |
| **비밀번호**   | Password       | 8자 이상           | ✅  |
| **이름**     | Name           | 사용자 이름 (3\~32자) | ✅  |
| **역할**     | Role           | 광고주 또는 매체사 선택   | ✅  |
| **초기 예산**  | Initial Budget | 광고주의 경우 시작 예산   | 선택 |
| **초기 크레딧** | Initial Credit | 프로모션 크레딧        | 선택 |

3. **저장**을 클릭하면 계정이 생성됩니다.

<Warning>
  관리자(Admin) 역할은 시스템당 1개만 존재합니다. 새 사용자는 광고주 또는 매체사로만 생성할 수 있습니다.
</Warning>

***

## 2단계: 권한 설정하기

### 역할별 기본 권한

각 역할은 기본 권한을 가지고 있습니다. 필요에 따라 세부 권한을 조정할 수 있습니다.

<Tabs>
  <Tab title="광고주 권한">
    광고주는 자신의 캠페인과 소재를 관리할 수 있습니다.

    | 기능        | 권한          |
    | --------- | ----------- |
    | **지면**    | 조회만 가능      |
    | **소재**    | 조회, 생성, 수정  |
    | **캠페인**   | 조회, 생성, 수정  |
    | **성과 분석** | 자신의 캠페인만    |
    | **타겟팅**   | 세그먼트 생성, 수정 |
  </Tab>

  <Tab title="매체사 권한">
    매체사는 지면을 관리하고 배정을 승인할 수 있습니다.

    | 기능         | 권한         |
    | ---------- | ---------- |
    | **지면**     | 조회, 생성, 수정 |
    | **소재**     | 조회, 생성, 수정 |
    | **캠페인**    | 조회만 가능     |
    | **성과 분석**  | 자신의 지면만    |
    | **배정**     | 승인, 거절 권한  |
    | **광고주 목록** | 조회 가능      |
  </Tab>

  <Tab title="관리자 권한">
    관리자는 **모든 기능에 접근**할 수 있습니다.

    * 모든 사용자의 데이터 조회/수정
    * 시스템 설정 변경
    * 결제/환불 처리
    * 활동 로그 조회
  </Tab>
</Tabs>

### 권한 변경하기

1. **사용자** 메뉴에서 권한을 변경할 사용자를 선택합니다.
2. **권한** 탭에서 필요한 권한을 조정합니다.
3. **저장**을 클릭합니다.

***

## 3단계: 예산 관리하기

### 예산과 크레딧

광고주에게 광고 집행을 위한 예산을 할당할 수 있습니다.

| 항목      | 영어     | 설명              | 사용 순서       |
| ------- | ------ | --------------- | ----------- |
| **크레딧** | Credit | 프로모션 등으로 지급된 금액 | 먼저 사용       |
| **예산**  | Budget | 직접 충전한 금액       | 크레딧 소진 후 사용 |

<Note>
  캠페인 예산은 크레딧을 먼저 사용하고, 크레딧이 부족하면 예산을 사용합니다.
</Note>

### 예산 할당하기

1. **사용자** 메뉴에서 예산을 할당할 광고주를 선택합니다.
2. **예산** 탭에서 금액을 입력합니다.
3. **저장**을 클릭합니다.

| 항목         | 설명          |
| ---------- | ----------- |
| **예산 추가**  | 광고주의 예산을 증가 |
| **크레딧 추가** | 프로모션 크레딧 지급 |

***

## 4단계: 사용자 정보 수정하기

### 본인이 수정할 수 있는 정보

사용자는 자신의 일부 정보만 수정할 수 있습니다.

| 항목        | 본인 수정 가능 |
| --------- | -------- |
| **이름**    | ✅ 가능     |
| **비밀번호**  | ✅ 가능     |
| **알림 설정** | ✅ 가능     |
| **이메일**   | ❌ 불가     |
| **역할**    | ❌ 불가     |
| **권한**    | ❌ 불가     |

### 관리자가 수정할 수 있는 정보

관리자는 모든 사용자의 정보를 수정할 수 있습니다.

| 항목              | 관리자 수정 가능 |
| --------------- | --------- |
| **이름**          | ✅ 가능      |
| **비밀번호**        | ✅ 가능      |
| **권한**          | ✅ 가능      |
| **예산**          | ✅ 가능      |
| **크레딧**         | ✅ 가능      |
| **계정 활성화/비활성화** | ✅ 가능      |

***

## 5단계: 사용자 삭제하기

### 삭제 전 확인사항

사용자를 삭제하기 전에 다음을 확인하세요.

<Warning>
  사용자 삭제 전 반드시 확인하세요:

  * 진행 중인 캠페인이 없는지
  * 승인된 배정이 없는지
  * 미결제 내역이 없는지
</Warning>

### 삭제 방법

1. **사용자** 메뉴에서 삭제할 사용자를 선택합니다.
2. **삭제** 버튼을 클릭합니다.
3. 확인 팝업에서 **삭제 확인**을 클릭합니다.

***

## 사용자 조회하기

### 역할별 조회 범위

| 역할      | 조회할 수 있는 사용자 |
| ------- | ------------ |
| **관리자** | 모든 사용자       |
| **매체사** | 광고주 목록       |
| **광고주** | 본인만          |

### 검색 및 필터

| 필터     | 설명            |
| ------ | ------------- |
| **역할** | 광고주, 매체사 중 선택 |
| **검색** | 이름 또는 이메일로 검색 |

***

## 문제 해결

<AccordionGroup>
  <Accordion title="사용자가 비밀번호를 잊어버렸어요">
    로그인 화면에서 '비밀번호 찾기'를 통해 등록된 이메일로 재설정 링크를 받을 수 있습니다.
  </Accordion>

  <Accordion title="사용자 역할을 변경할 수 있나요?">
    역할 변경은 지원되지 않습니다. 필요한 경우 새 계정을 생성하세요.
  </Accordion>

  <Accordion title="광고주/매체사 수 제한이 있나요?">
    라이선스 조건에 따라 생성 가능한 광고주/매체사 수가 제한될 수 있습니다.
  </Accordion>

  <Accordion title="여러 사용자에게 같은 권한을 부여할 수 있나요?">
    네, 동일한 역할을 가진 사용자는 기본적으로 같은 권한을 가집니다. 필요시 개별 권한을 조정할 수 있습니다.
  </Accordion>

  <Accordion title="계정을 일시적으로 비활성화할 수 있나요?">
    네, 사용자 정보에서 **활성 상태**를 끄면 해당 사용자는 로그인할 수 없습니다. 삭제와 달리 데이터는 유지됩니다.
  </Accordion>
</AccordionGroup>