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

# 인원

> 직무 배치, 부서, 스케줄러에 반영되는 교대조, 휴일, 사용자 정의 직원 속성, 사무실 타임 카드를 포함하여 Alforse에서 직원 마스터 데이터를 설정합니다.

인원 모듈은 회사의 HR 마스터 데이터를 보관합니다. 누가 근무하는지, 조직에서 어디에 속하는지, 언제 일하는지, 추적하는 추가 정보가 무엇인지입니다. 관리자와 HR 담당자가 관리하며, 교대조가 역량이 필요한 작업의 일정 가능 시점을 결정하므로 계획 담당자도 이를 활용합니다.

로그인, 역할, 액세스 권한 부여는 이 영역에 포함되지 않습니다. 이들은 [권한](https://docs.alforse.com/ko/docs/reference/permissions.md)에서 다룹니다.

## 사람이 저장되는 방식

Alforse는 한 사람을 서로 연결된 세 개의 테이블로 나눕니다.

| 테이블 | 보관하는 내용 | 범위 |
| - | - | - |
| `user` | 로그인 신원 | 전역 |
| `employee` | 한 회사의 구성원 자격 | 회사별 |
| `employeeJob` | 직함, 위치, 부서, 교대조, 관리자 | 회사별 |

레코드가 ID를 공유하고 뒤의 두 개는 회사 범위이므로, 하나의 로그인으로 여러 회사에서 일하면서 각 회사에서 서로 다른 직함, 사업장, 관리자를 가질 수 있습니다.

## 직원

### 디렉터리

**관리** 아래에 있는 **직원**은 회사의 직원 목록입니다. 열에는 이름과 성, 이메일, 직원 유형, 위치가 있으며 그 뒤에 **상태**가 표시됩니다.

| 상태 | 의미 |
| - | - |
| **"활성"** | 회사에서 일하는 구성원. |
| **"초대됨"** | 초대가 아직 대기 중입니다. |
| **"비활성"** | 더 이상 회사에서 활성 상태가 아닙니다. |

이 상태를 직접 설정하는 사람은 없습니다. Alforse가 직원 레코드와 미결 초대를 함께 보고 판단합니다.

회사가 2단계 인증을 강제하는 경우 디렉터리에 각 사람이 인증 앱을 설정했는지 표시하는 **2단계** 열이 추가됩니다. 그러면 기기를 분실한 사람을 위해 행 메뉴에서 **"2단계 인증 재설정"**을 제공합니다. [2단계 인증](https://docs.alforse.com/ko/docs/reference/two-factor.md)을 참조하십시오.

### 직원 레코드

사람의 페이지는 탭으로 나뉩니다. **프로필**, **작업**(Job), **역량**, **메모**, 각 속성 카테고리별 탭, 시간 추적이 켜져 있으면 **타임카드**입니다. **작업** 탭에는 배치 데이터가 있습니다.

| 필드 | 유형 | 목적 |
| - | - | - |
| **직함**(Title) | 텍스트 | 이 회사에서 사람의 역할을 부르는 이름입니다. 접근 권한은 부여하지 않습니다(아래 경고 참조). |
| **시작일** | 날짜 | 근무 첫날. |
| **위치** | 참조 | 소속 사업장. 필수입니다. |
| **교대조** | 참조 | 선택적 근무 일정으로, 스케줄러가 사람이 역량이 필요한 작업을 맡을 수 있는 시기를 판단하기 위해 읽습니다. |
| **부서** | 참조 | 사람이 속한 조직 단위. |
| **관리자** | 참조 | 다른 직원으로, 이 사람이 보고하는 대상. |

HEADS UP

이 탭의 "작업"은 생산 작업이 아니라 *직무 직함*을 의미합니다. `employeeJob` 테이블은 조직 배치를 기록하며 작업 지시를 보관하는 `job` 테이블과는 관계가 없습니다. 직함은 권한도 부여하지 않습니다. 사람이 할 수 있는 일은 [권한](https://docs.alforse.com/ko/docs/reference/permissions.md)에 설명된 **직원 유형**에서 나옵니다.

### 사람 추가 및 제거

사람을 초대하고 비활성화하는 것은 여기가 아니라 신원 및 액세스 흐름에서 이루어집니다. 누군가를 비활성화하는 것은 단순한 편집보다 훨씬 크다는 점에 유의하십시오. 회사 구성원 자격이 제거되고, 직무 배치가 삭제되며, 액세스가 취소됩니다.

## 부서

부서는 회사의 조직 구성을 설명하며 **설정**(Configure) 아래에 있습니다. 부서가 상위 부서를 가리키도록 하면 계층 구조가 만들어져 인원수를 수준별로 집계할 수 있습니다. 사람은 **작업** 탭에서 부서에 배치됩니다.

| 필드 | 유형 | 목적 |
| - | - | - |
| **부서명** | 텍스트 | 회사 전체에서 고유합니다. |
| **상위 부서** | 참조 | 이 부서가 보고하는 단위이며, 비워 두면 최상위가 됩니다. |

HEADS UP

부서를 삭제하면 행이 제거되는 하드 삭제입니다. 먼저 부서에 배치된 모든 사람을 재배정하십시오. 그렇지 않으면 직무 배치에 부서가 없는 상태가 됩니다.

## 교대조

교대조는 사업장의 근무 시간, 즉 작업이 시작되고 끝나는 시각과 요일을 정의합니다. 사람의 **작업** 탭에서 교대조를 지정합니다.

| 필드 | 유형 | 목적 |
| - | - | - |
| **교대조 이름** | 텍스트 | 일정의 라벨. |
| **위치** | 참조 | 교대조를 소유하는 사업장. 필수입니다. |
| **시작 시간** / **종료 시간** | 시간 | 하루의 시작과 종료. 둘 다 필수입니다. |
| **요일** | 불리언 | 월요일부터 일요일까지 일곱 개의 토글로, 근무하는 요일을 표시합니다. |

### 교대조가 일정 계획에 미치는 영향

교대조는 오늘 누가 근무하는지에 대한 기록일 뿐 아니라 [일정 계획](https://docs.alforse.com/ko/docs/reference/scheduling.md)의 실제 입력입니다. 엔진은 각 사람의 교대 시간을 기계의 가동 시간과 겹쳐 역량이 필요한 작업이 실행될 수 있는 시기를 결정합니다. 따라서 교대조를 변경하거나 사람이 속한 교대조를 변경하면 영향을 받는 일정의 재계획이 대기열에 등록됩니다.

NOTE

교대조는 사람뿐 아니라 기계에도 적용됩니다. 직원의 경우 교대조는 그 사람을 일정에 배치할 수 있는 시기를 정하고, [작업장](https://docs.alforse.com/ko/docs/reference/work-centers.md)의 경우 스테이션의 가동 시간을 정합니다. 공정작업의 프로세스에 역량이 필요하면 교대 중인 작업자가 결정적인 제약입니다. 교대 중인 자격 있는 작업자가 없으면 공정작업은 대기합니다.

교대조를 삭제하면 제거되는 대신 비활성으로 표시되므로 과거 배정은 그대로 유지됩니다.

## 휴일

휴일은 회사가 쉬는 날을 표시합니다. 목록은 Alforse가 각 휴일의 날짜에서 도출하는 연도별로 묶이므로 한 번에 한 해를 확인할 수 있습니다.

| 필드 | 유형 | 목적 |
| - | - | - |
| **휴일 이름** | 텍스트 | 목록에 표시되는 라벨. 필수입니다. |
| **날짜** | 날짜 | 쉬는 날. 필수이며 연도는 여기서 가져옵니다. |

## 속성

인증서 만료일, 배지 번호, 티셔츠 크기처럼 Alforse에 기본 필드가 없는 것을 기록해야 합니까? 두 수준으로 구성된 속성을 사용하십시오.

* **속성 카테고리**는 관련 필드를 묶습니다. 이름, 이모지, 속성이 사람의 공개 프로필에 표시될지 관리자에게만 표시될지 결정하는 공개 토글이 있습니다.
* **속성**은 카테고리 안의 하나의 필드이며 데이터 유형을 가집니다.

각 속성은 다음으로 정의됩니다.

FieldType

<details>
  <summary>**이름**`text`</summary>

  필드의 이름입니다.
</details>

<details>
  <summary>**데이터 유형**`enum`</summary>

  허용하는 값의 종류. 아래 표를 참조하십시오.
</details>

<details>
  <summary>**목록 옵션**`text[]`</summary>

  허용되는 값. 데이터 유형이 *목록*일 때만 사용됩니다.
</details>

<details>
  <summary>**자체 관리**`boolean`</summary>

  켜짐: 직원이 자신의 프로필에서 값을 편집할 수 있습니다. 꺼짐: 관리자만 가능합니다.
</details>

### 데이터 유형

데이터 유형은 정해진 목록에서 선택합니다.

| 데이터 유형 | 속성에서 사용 가능 | 비고 |
| - | - | - |
| **"텍스트"**, **"숫자"**, **"예/아니요"**, **"날짜"**, **"사용자"** | 예 | |
| **"목록"** | 예 | 선택지는 목록 옵션에서 가져옵니다. |
| **"고객"**, **"공급업체"**, **"파일"** | 아니요 | 이 목록을 공유하는 고객 및 공급업체 사용자 정의 필드에 추가됩니다. |
| **"링크"** | 아니요 | 사용자 정의 필드에서만 제공됩니다. |

NOTE

속성을 생성할 때 데이터 유형을 신중하게 선택하십시오. 값이 기록된 후에는 변경할 수 없습니다. 카테고리나 속성을 삭제하면 비활성으로 표시되는 소프트 삭제이므로, 속성을 폐기해도 이미 수집된 값은 유지됩니다.

## 타임 카드

타임 카드는 직원이 하루 근무를 출근하고 퇴근한 시각을 기록합니다.

### 타임 카드 켜기

시간 추적은 기본적으로 꺼져 있습니다. **설정 → 인원**에서 **타임카드**(베타로 표시됨)를 켜십시오. 그러면 각 사람에게 **타임카드** 탭이 생기고 **관리** 아래에 회사 전체 목록이 나타납니다.

### 항목과 상태

항목에는 직원, 출근 시각, 선택적인 퇴근 시각, 메모가 있습니다. **상태**는 퇴근 시각이 있는지에 따라 결정됩니다.

<details open>
  <summary>**Active**</summary>

  출근했으나 아직 퇴근하지 않았습니다. 직원이 근무 중입니다.
</details>

<details>
  <summary>**Complete**</summary>

  퇴근했습니다. 항목이 닫혔으며 기간이 확정되었습니다.
</details>

* 상태는 저장되는 값이 아니라 계산됩니다.
* **승인 단계가 없습니다**. 완료된 타임 카드는 승인을 기다리지 않고 확정됩니다.
* 기간은 출근부터 퇴근까지이며, 항목이 활성인 동안은 *현재*까지입니다. 주간 시간은 현재 주 항목의 합계입니다.
* 항목을 직접 추가, 편집 또는 삭제할 수 있으므로 누락된 기록은 나중에 수정할 수 있습니다.

NOTE

이들은 사무실 측 근태 기록입니다. 현장에서는 작업자가 [MES](https://docs.alforse.com/ko/docs/reference/mes.md)에서 특정 작업의 공정작업에 시간을 기록하며, 이는 직원의 출근 및 퇴근과는 별개의 메커니즘입니다.

## 문제 해결

| 메시지 또는 증상 | 원인 | 해결 방법 |
| - | - | - |
| 교대조를 저장할 때 "Location is required"(위치가 필요합니다) | 교대조는 위치(`locationId`)에 속해야 합니다. 반면 직원 자신의 교대조 배정은 선택 사항입니다. | 위치를 선택한 다음 저장하십시오. |
| "Start time is required"(시작 시간이 필요합니다) / "End time is required"(종료 시간이 필요합니다) | 교대 시간 두 가지 모두 필수입니다. | 두 시간을 모두 입력하십시오. |
| 휴일에서 "Date is required"(날짜가 필요합니다) 또는 "Name is required"(이름이 필요합니다) | 휴일에는 이름과 날짜가 필요하며 연도는 날짜에서 도출됩니다. | 둘 다 입력하십시오. |
| 삭제 후 사람들의 부서가 사라짐 | 부서 삭제는 하드 삭제이며 비활성으로 표시되는 교대조 및 속성과 다릅니다. | 해당 직원을 다른 부서로 재배정하십시오. |
| **타임카드** 탭이나 목록이 없음 | 시간 추적이 꺼져 있습니다. | **설정 → 인원**에서 **타임카드**를 켜십시오. |
| 타임 카드를 승인하는 곳을 찾을 수 없음 | 타임 카드에는 승인 워크플로가 없으며 완료된 항목은 확정됩니다. | 항목을 편집하거나 삭제하여 실수를 정정하십시오. |

## 관련 문서

**권한**

직원 유형, 역할, 각 사람이 할 수 있는 일입니다.

[Open](https://docs.alforse.com/ko/docs/reference/permissions.md)

**2단계 인증**

인증 코드, 회사 전체 강제, 분실한 기기 재설정입니다.

[Open](https://docs.alforse.com/ko/docs/reference/two-factor.md)

**MES**

현장에서 작업 공정작업에 시간을 기록합니다.

[Open](https://docs.alforse.com/ko/docs/reference/mes.md)

**작업장**

공정작업이 실행되는 곳과 일정 및 원가 계산 방식입니다.

[Open](https://docs.alforse.com/ko/docs/reference/work-centers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.