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

# 클라이언트 포털, 접근 제어 및 세율 맞춤화

> AgencyHandy에서 클라이언트 로그인 및 회원가입 페이지 브랜딩, 역할별 사이드바 표시 제어, 청구서 및 결제 시 세율 설정하는 방법을 안내합니다.

AgencyHandy는 클라이언트가 처음 로그인하는 페이지부터 로그인 후 탐색할 수 있는 섹션까지 클라이언트의 경험을 세밀하게 제어할 수 있게 해줍니다. 이 페이지에서는 네 가지 연관된 설정 영역인 **로그인 포털**, **회원가입 포털**, **사이드바 및 접근 제어**, **세율**을 다룹니다. 이 설정들을 함께 사용하면 워크스페이스의 모든 사용자에게 세련되고 역할에 맞는 경험을 제공할 수 있습니다.

<Note>
  이 페이지의 모든 설정은 **최고 관리자(Super Admin)** 또는 **관리자(Admin)** 접근 권한이 필요합니다. 왼쪽 사이드바의 **워크스페이스 설정**으로 이동하여 각 섹션에 접근하세요.
</Note>

***

<Tabs>
  <Tab title="Sign-in Portal">
    ## 로그인 포털

    로그인 포털은 클라이언트와 팀원이 AgencyHandy 워크스페이스에 접근할 때 보이는 로그인 페이지입니다. 맞춤화를 통해 클라이언트의 첫인상이 에이전시의 이미지, 헤드라인 및 메시지가 담긴 완전한 브랜드 경험이 되도록 보장합니다.

    ### 맞춤화 가능한 요소

    | 요소         | 설명                       | 제한                       |
    | ---------- | ------------------------ | ------------------------ |
    | **헤드라인**   | 로그인 페이지 상단에 표시되는 주요 제목   | 최대 120자                  |
    | **이미지**    | 페이지에 표시되는 브랜드 사진 또는 일러스트 | PNG, JPG, JPEG — 최대 5 MB |
    | **보조 텍스트** | 로그인 필드 아래의 짧은 메시지        | 최대 300자                  |

    ### 로그인 포털 맞춤화 단계

    <Steps>
      <Step title="로그인 포털 설정 열기">
        왼쪽 탐색 메뉴에서 **워크스페이스 설정**으로 이동한 후, 하위 메뉴에서 **로그인 포털**을 선택하세요.
      </Step>

      <Step title="사용자 지정 헤드라인 입력">
        **헤드라인** 필드에 원하는 헤드라인을 입력하세요. 간결하고 관련성 있게 유지하세요 — 예를 들어, *"\[에이전시 이름]에 다시 오신 것을 환영합니다"* 또는 *"클라이언트 포털입니다."* 최대 120자입니다.
      </Step>

      <Step title="브랜드 이미지 업로드">
        업로드 영역을 클릭하거나 이미지 파일(PNG, JPG 또는 JPEG, 최대 5 MB)을 드래그 앤 드롭하여 로그인 페이지에 시각적 요소를 추가하세요. 이 이미지는 일반적으로 로그인 양식 옆에 표시됩니다.

        <Tip>
          에이전시를 대표하는 고품질 이미지를 사용하세요 — 팀 사진, 깔끔한 브랜드 일러스트 또는 전문적인 배경. 업로드 오류를 방지하려면 파일 크기가 5 MB 미만인지 확인하세요.
        </Tip>
      </Step>

      <Step title="보조 텍스트 추가">
        **보조 텍스트** 필드에 로그인 필드 아래에 표시될 짧은 메시지를 작성하세요 — 예를 들어 환영 문구, 지원 연락처 또는 짧은 태그라인. 300자 이내로 유지하세요.
      </Step>

      <Step title="미리보기 및 저장">
        미리보기를 사용하여 로그인 페이지 레이아웃을 검토하세요. 만족스러우면 **저장**(또는 **업데이트**)을 클릭하여 변경 사항을 적용하세요. 변경 사항은 즉시 적용됩니다.
      </Step>
    </Steps>

    ### 기본값으로 초기화

    로그인 포털 페이지에서 **기본 설정 초기화**를 클릭하면 모든 맞춤화가 제거되고 원래의 AgencyHandy 로그인 페이지로 복원됩니다.

    <Warning>
      기본값으로 초기화하면 되돌릴 수 없습니다. 모든 사용자 지정 헤드라인, 이미지 및 보조 텍스트가 영구적으로 제거됩니다. 확실하지 않은 경우 **취소**를 클릭하세요 — 저장되지 않은 변경 사항은 삭제되고 현재 저장된 설정이 유지됩니다.
    </Warning>

    ### 모범 사례

    * 헤드라인은 짧고 환영하는 느낌으로 유지하세요 — 클라이언트가 로그인 전에 보는 것이므로 안심감을 주어야 합니다.
    * 에이전시를 대표하는 전문적인 이미지를 사용하세요. 브랜드와 단절된 느낌을 주는 일반적인 스톡 사진은 피하세요.
    * 이미지와 텍스트 레이아웃이 올바르게 보이는지 확인하기 위해 저장 전 다양한 화면 크기에서 미리보기를 확인하세요.
    * 이미지 업로드가 실패하면 형식(PNG, JPG, JPEG) 및 크기(5 MB 미만) 요건을 충족하는지 확인하세요.
  </Tab>

  <Tab title="Sign-up Portal">
    ## 회원가입 포털

    회원가입 포털은 신규 클라이언트가 워크스페이스에 계정을 만들 때 이용하는 등록 페이지입니다. 맞춤화를 통해 잠재 클라이언트가 에이전시 플랫폼과 처음 상호작용하는 순간부터 일관된 브랜드 경험을 제공합니다.

    ### 맞춤화 가능한 요소

    | 요소         | 설명                       | 제한                       |
    | ---------- | ------------------------ | ------------------------ |
    | **헤드라인**   | 회원가입 페이지 상단에 표시되는 주요 제목  | 최대 120자                  |
    | **이미지**    | 페이지에 표시되는 브랜드 사진 또는 일러스트 | PNG, JPG, JPEG — 최대 5 MB |
    | **보조 텍스트** | 등록 필드 아래의 짧은 메시지         | 최대 300자                  |

    ### 회원가입 포털 맞춤화 단계

    <Steps>
      <Step title="회원가입 포털 설정 열기">
        왼쪽 탐색 메뉴에서 **워크스페이스 설정**으로 이동한 후, 하위 메뉴에서 **회원가입 포털**을 선택하세요.
      </Step>

      <Step title="사용자 지정 헤드라인 입력">
        신규 클라이언트를 환영하는 헤드라인을 **헤드라인** 필드에 입력하세요. 예를 들어, *"\[에이전시 이름]을 시작하세요"* 또는 *"클라이언트 계정을 만드세요."* 최대 120자입니다.
      </Step>

      <Step title="브랜드 이미지 업로드">
        업로드 영역을 클릭하거나 이미지 파일(PNG, JPG 또는 JPEG, 최대 5 MB)을 드래그 앤 드롭하세요. 이 이미지는 등록 양식 옆 회원가입 페이지에 표시됩니다.

        <Tip>
          두 페이지 간에 일관된 경험을 만들기 위해 로그인 포털과 회원가입 포털 이미지에 동일한 시각적 스타일과 색상 팔레트를 사용하세요.
        </Tip>
      </Step>

      <Step title="보조 텍스트 추가">
        **보조 텍스트** 필드에 짧은 지원 메시지를 작성하세요 — 예를 들어 회원가입 후 예상되는 사항에 대한 안내나 간단한 가치 제안. 최대 300자입니다.
      </Step>

      <Step title="미리보기 및 저장">
        미리보기 옵션을 사용하여 회원가입 페이지를 검토하세요. **저장**(또는 **업데이트**)을 클릭하여 변경 사항을 즉시 적용하세요.
      </Step>
    </Steps>

    ### 기본값으로 초기화

    회원가입 포털 페이지에서 **기본 설정 초기화**를 클릭하면 모든 맞춤화가 제거되고 원래의 AgencyHandy 회원가입 페이지로 복원됩니다.

    <Warning>
      이 작업은 되돌릴 수 없습니다. 모든 사용자 지정 헤드라인, 이미지 및 보조 텍스트 설정이 영구적으로 삭제됩니다.
    </Warning>

    ### 모범 사례

    * 회원가입 헤드라인의 톤을 전반적인 클라이언트 커뮤케이션 스타일(전문적, 친근한, 또는 둘 다)에 맞추세요.
    * 보조 텍스트를 핵심적으로 유지하세요: 신규 클라이언트에게 등록 후 무슨 일이 일어나는지 알려주세요(예: *"회원가입 후 팀에서 24시간 이내에 환영 이메일을 발송할 것입니다."*).
    * 변경 사항을 저장한 후 직접 회원가입 흐름을 테스트하여 페이지가 예상대로 보이고 작동하는지 확인하세요.
  </Tab>

  <Tab title="Sidebar & Access">
    ## 사이드바 및 접근 제어

    사이드바 및 접근 설정을 통해 각 사용자 역할이 왼쪽 탐색 메뉴에서 볼 수 있는 항목을 정확하게 제어할 수 있습니다. 메뉴 항목의 이름을 에이전시 용어에 맞게 변경하고, 기본 아이콘을 사용자 지정 아이콘으로 교체하고, 역할별로 메뉴 섹션 표시 여부를 전환할 수 있습니다. 그 결과 로그인하는 모든 사람에게 더 깔끔하고 목적에 맞는 인터페이스를 제공합니다.

    ### 설정 가능한 역할

    * 클라이언트(Client)
    * 최고 관리자(Super Admin)
    * 관리자(Admin)
    * 매니저(Manager)
    * 담당자(Assignee)
    * 사용자 지정 (역할 및 권한에서 생성한 모든 사용자 지정 역할)

    ### 사이드바 메뉴 항목 맞춤화 단계

    <Steps>
      <Step title="사이드바 및 접근 설정 열기">
        **워크스페이스 설정**으로 이동한 후, 설정 메뉴에서 **사이드바 및 접근**을 선택하세요.
      </Step>

      <Step title="맞춤화 클릭">
        패널 상단의 **맞춤화** 버튼을 클릭하세요. 현재 사이드바 메뉴 항목의 전체 목록이 **메인** 카테고리 아래에 표시됩니다.
      </Step>

      <Step title="메뉴 항목 이름 변경">
        메뉴 항목의 텍스트 필드를 클릭하고 새 레이블을 입력하세요. 예를 들어 "대시보드"를 "개요"로 또는 "CRM"을 "연락처"로 변경하세요. **저장**을 클릭하여 새 이름을 적용하세요.
      </Step>

      <Step title="메뉴 아이콘 변경">
        메뉴 항목 이름 옆의 아이콘을 클릭하세요. 아이콘 옵션 세트가 있는 팝업이 열립니다 — 라이브러리에서 하나를 선택하거나, 사용자 지정 32×32 px 이미지를 업로드하여 브랜드 아이콘을 사용하세요. **저장**을 클릭하여 적용하세요.
      </Step>
    </Steps>

    ### 역할 기반 가시성 설정 단계

    <Steps>
      <Step title="접근 편집 클릭">
        **접근 편집** 버튼(**맞춤화** 버튼 옆)을 클릭하세요. 사용 가능한 각 역할에 대한 탭이 표시됩니다.
      </Step>

      <Step title="역할 선택">
        설정하려는 역할 탭을 클릭하세요 — 예를 들어 **클라이언트**.
      </Step>

      <Step title="메뉴 항목 가시성 전환">
        나열된 각 메뉴 항목에 대해 토글을 사용하여 선택한 역할에 표시하거나 숨기세요. 예를 들어 관리자와 매니저에게는 표시하면서 클라이언트에게는 **청구서** 및 **구독**을 숨길 수 있습니다.
      </Step>

      <Step title="변경 사항 저장">
        **저장**을 클릭하세요. 업데이트된 가시성 설정이 즉시 적용됩니다 — 사용자는 다음 페이지 탐색 시 또는 다시 로그인한 후 변경 사항을 확인할 수 있습니다.
      </Step>

      <Step title="필요한 경우 기본값으로 초기화">
        역할 탭에서 **기본값으로 초기화**를 클릭하여 해당 역할의 원래 가시성 설정을 복원하세요.
      </Step>
    </Steps>

    <Tip>
      깔끔하고 간결한 사이드바는 클라이언트 경험을 향상시킵니다. 클라이언트에게 **대시보드**, **주문**, **메시지** 등 필요한 항목만 표시하면 혼란이 줄어들고 내부 전용 섹션에 접근하는 것을 방지합니다.
    </Tip>

    ### 역할 설정 예시

    | 역할     | 권장 표시 섹션                    |
    | ------ | --------------------------- |
    | 클라이언트  | 대시보드, 주문, 메시지, 청구서 (필요한 경우) |
    | 매니저    | CRM, 프로젝트, 근무 시간표, 작업       |
    | 담당자    | 대시보드, 작업, 프로젝트, 메시지         |
    | 최고 관리자 | 모든 섹션 (제한 없음)               |

    ### 중요 참고 사항

    * **변경 사항은 즉시 적용됩니다:** 역할 가시성 업데이트는 사용자가 새로 고침하거나 다시 로그인하면 즉시 반영됩니다.
    * **가장 높은 권한의 역할이 우선합니다:** 사용자가 여러 역할을 가지고 있는 경우, 가장 광범위한 접근 권한을 가진 역할이 우선합니다.
    * **사용자 지정 아이콘:** 사이드바에서 에이전시의 브랜드 시각 요소를 맞추기 위해 32×32 px 이미지를 업로드하세요.
    * **일관된 명칭 사용:** 팀 전체가 이해할 수 있는 명확하고 일관된 명명 규칙을 사용하세요 — 새 팀원이 인식하지 못할 약어나 내부 전문용어는 피하세요.
  </Tab>

  <Tab title="Tax Rates">
    ## 세율

    세율 기능을 사용하면 서비스, 구독 및 청구서 전반에 걸쳐 세금 설정을 생성, 관리 및 적용할 수 있습니다. VAT, GST, 판매세 등 여러 세금 유형을 설정할 수 있으며, 국가별 및 주별 세율, 포함 및 비포함 가격 모델 지원, 클라이언트 위치에 따른 결제 시 자동 적용 기능을 제공합니다.

    <Note>
      **최고 관리자(Super Admin)** 및 **관리자(Admin)** 만 세금 설정을 생성, 편집 또는 삭제할 수 있습니다.
    </Note>

    ### 세금 개념 요약

    | 개념                 | 정의                                                    |
    | ------------------ | ----------------------------------------------------- |
    | **비포함(Exclusive)** | 세금이 결제 시 표시된 가격에 추가됩니다 (예: $100 + 10% 세금 = $110 총액)   |
    | **포함(Inclusive)**  | 세금이 이미 고객에게 표시된 가격에 포함되어 있습니다 (예: \$110 총액에 이미 세금 포함) |
    | **세금 ID**          | 청구서에 표시되는 에이전시의 사업자 세금 식별 번호                          |

    ### 1단계: 세율 생성

    <Steps>
      <Step title="세율 열기">
        **워크스페이스 설정**으로 이동한 후, **세율** 탭을 클릭하세요.
      </Step>

      <Step title="+ 새 세금 클릭">
        **+ 새 세금** 버튼을 클릭하세요. 양식이 표시됩니다.
      </Step>

      <Step title="세금 세부 정보 입력">
        다음 필드를 완성하세요:

        * **제목 / 세금 유형** *(필수)*: 설명적인 이름을 입력하세요, 예: 표준 VAT, 인하된 GST, 또는 미국 판매세. 최대 255자.
        * **세금 ID** *(선택 사항)*: 에이전시의 사업자 세금 식별 번호. 최대 20자.
        * **본국**: 이 세금이 적용되는 주요 국가를 선택하세요.
        * **본국 일반 세율 %** *(선택 사항)*: 본국에 대한 기본 세율.
        * **국가별 세율** *(선택 사항)*: 선택적 주, 우편 번호 및 비율이 포함된 국가별 세율을 추가하세요. 여러 세금 관할 구역의 클라이언트를 서비스하는 에이전시에 유용합니다.
      </Step>

      <Step title="상태 설정">
        세금을 **활성**으로 전환하면 서비스 및 청구서에서 즉시 사용 가능합니다. **비활성**으로 설정하면 새 구매에 아직 적용하지 않고 설정을 저장합니다.
      </Step>

      <Step title="저장">
        **저장**을 클릭하세요. 세금이 세율 목록에 표시되며 이제 서비스에 연결할 수 있습니다.
      </Step>
    </Steps>

    <Tip>
      세율 비율에 소수점 4자리까지 지원합니다. 0% 세율도 유효합니다 — 세금을 나열해야 하지만 금액이 0인 면세 항목이나 규정 준수 시나리오에 사용하세요.
    </Tip>

    ### 2단계: 서비스에 세금 연결

    <Steps>
      <Step title="편집을 위해 서비스 열기">
        **서비스**로 이동하여 새 서비스를 만들거나 기존 서비스를 편집하세요.
      </Step>

      <Step title="추가 정보 섹션으로 이동">
        서비스 설정 마법사의 3단계(추가 정보)로 이동하세요.
      </Step>

      <Step title="서비스에 세금 추가">
        **세금 추가**를 클릭하고 설정된 목록에서 하나 이상의 세금 유형을 선택하세요. 이 서비스에 대해 세금이 **포함** 또는 **비포함**으로 적용되는지 선택하세요. 이 설정은 설정 수수료 및 부가 서비스를 포함한 서비스의 모든 연결된 세금에 적용됩니다.
      </Step>
    </Steps>

    ### 3단계: 세금 적용 방식

    세금은 **결제 시 자동으로** 또는 **청구서에 수동으로** 적용할 수 있습니다:

    **자동 (결제)**

    * 서비스에 연결된 세금은 클라이언트의 청구 위치에 따라 자동으로 계산됩니다.
    * 위치 기반 세금을 적용하려면 클라이언트가 결제 시 국가, 주 및 우편 번호를 제공해야 합니다.
    * Stripe India 계정의 경우 전체 위치 정보(국가, 주, 우편 번호)가 필수입니다.

    **수동 (청구서)**

    * 청구서를 수동으로 생성할 때 **세금 추가**를 클릭하여 적용할 세금을 선택하세요.
    * 청구 주소 필드가 자동으로 채워집니다.
    * **비포함 세금만** 수동 청구서에 적용할 수 있습니다 — 포함 세금은 이 흐름에서 지원되지 않습니다.

    ### 청구서 세금 표시

    세금이 포함된 모든 청구서에는 다음 세부 정보가 표시됩니다:

    * **세금 명칭** — 입력한 레이블 (예: VAT, GST)
    * **세율** — 적용된 비율 (예: 15%)
    * **세금 금액** — 계산된 청구 금액

    ### 기존 세율 관리

    * **세금 편집:** 목록에서 세금 항목을 클릭하여 제목, 세율 또는 국가 규칙을 업데이트하세요. 업데이트는 미래의 청구서 및 구매에만 적용됩니다.
    * **세금 삭제:** 삭제된 세금은 더 이상 새 구매 또는 구독에 적용되지 않지만, 해당 세금이 포함된 기존 청구서는 영향을 받지 않습니다.
    * **세금 비활성화:** 세금을 **비활성**으로 설정하면 설정을 삭제하지 않고도 새 구매에 적용이 중단됩니다.

    ### 중요 참고 사항

    * **쿠폰 할인은 세금 전에 적용됩니다:** 클라이언트가 할인 쿠폰을 사용하면 세금은 원래 가격이 아닌 할인된 가격에 계산됩니다.
    * **서비스당 여러 세금:** 단일 서비스에 두 개 이상의 세금을 첨부할 수 있습니다 (예: VAT + GST 동시 적용).
    * **세금은 부가 서비스 및 설정 수수료에도 적용됩니다:** 서비스에 설정 수수료나 부가 서비스가 있는 경우 해당 금액에도 세금이 적용됩니다.
    * **클라이언트 위치가 미리 채워집니다:** 클라이언트 프로필에 청구 국가와 주가 저장되어 있으면 결제 시 해당 필드가 미리 채워집니다. 그러나 결제 중 위치를 편집해도 클라이언트 프로필은 업데이트되지 **않습니다**.
    * **우편 번호 기반 주 감지:** 미국 클라이언트의 경우, 시스템이 우편 번호에서 주를 자동으로 감지하고 설정된 경우 올바른 지역 세율을 적용할 수 있습니다.
  </Tab>
</Tabs>
