> ## 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 の従業員マスターデータを設定します。

人員には、会社の人事マスターデータが保持されます。誰が働いているか、組織内のどこに所属しているか、いつ働くか、そして追跡したい追加情報です。管理者と人事担当者が保守し、計画担当者はこれに依存します。シフトによって、スキルが必要な作業をスケジューリングできる時間が決まるためです。

サインイン、ロール、アクセス権の付与は、この領域には含まれません。それらは[権限](https://docs.alforse.com/ja/docs/reference/permissions.md)で扱います。

## 人の保存方法

Alforse は、1 人の人を、リンクされた 3 つのテーブルに分けて保存します。

| テーブル | 保持する内容 | 範囲 |
| - | - | - |
| `user` | ログイン ID | グローバル |
| `employee` | 1 つの会社のメンバーシップ | 会社ごと |
| `employeeJob` | 役職、ロケーション、部門、シフト、マネージャー | 会社ごと |

レコードは ID を共有し、後の 2 つは会社単位のため、1 つのログインで複数の会社で働き、会社ごとに異なる役職、拠点、マネージャーを持てます。

## 従業員

### ディレクトリ

**管理**の下にある**従業員**は、会社のスタッフ一覧です。列には、姓名、メール、従業員タイプ、ロケーションがあり、その後に**ステータス**が続きます。

| ステータス | 意味 |
| - | - |
| **「有効」** | 会社で働いているメンバー。 |
| **「招待済み」** | 招待がまだ保留中。 |
| **「無効」** | 会社でもう有効ではない。 |

このステータスを手動で設定する人はいません。Alforse が、従業員レコードと未完了の招待から判断します。

会社が二要素認証を強制している場合、ディレクトリには**二要素認証**列が追加され、各ユーザーが認証アプリを設定済みかどうかが表示されます。その場合、デバイスを紛失したユーザーのために、行のメニューに**「2要素認証をリセット」**が表示されます。[二要素認証](https://docs.alforse.com/ja/docs/reference/two-factor.md)を参照してください。

### 従業員のレコード

ユーザーのページはタブに分かれています。**プロフィール**、**ジョブ**、**スキル**、**メモ**、属性カテゴリごとのタブ、時間管理が有効な場合は**タイムカード**です。**ジョブ**タブには、配置のデータが含まれます。

| フィールド | 型 | 目的 |
| - | - | - |
| **タイトル** | テキスト | この会社でのユーザーの役割の呼称。アクセス権は付与しません（下の警告を参照）。 |
| **開始日** | 日付 | 雇用の初日。 |
| **ロケーション** | 参照 | 所属拠点。必須。 |
| **シフト** | 参照 | 任意の勤務スケジュール。スケジューラーが、そのユーザーがスキルが必要な作業を引き受けられる時間を判断するために読み取ります。 |
| **部門** | 参照 | ユーザーが所属する組織単位。 |
| **マネージャー** | 参照 | 別の従業員。このユーザーの上司。 |

HEADS UP

このタブの「ジョブ」は、製造指図ではなく、職務の*肩書き*を意味します。`employeeJob` テーブルは組織上の配置を記録するもので、作業指示を保持する `job` テーブルとは無関係です。また、肩書きは権限を付与しません。ユーザーができることは、[権限](https://docs.alforse.com/ja/docs/reference/permissions.md)で説明している**従業員タイプ**によって決まります。

### 人の追加と削除

人の招待と無効化は、ここではなく、ID とアクセスのフローで行います。ただし、誰かを無効化することは、単なる編集以上の操作であることに注意してください。会社のメンバーシップは削除され、職務の配置も削除され、アクセスも取り消されます。

## 部門

部門は会社の組織構成を表し、**設定**の下にあります。部門を親部門に結びつけると階層が作られ、人数を階層ごとに集計できます。ユーザーは、**ジョブ**タブから部門に配置されます。

| フィールド | 型 | 目的 |
| - | - | - |
| **部門名** | テキスト | 会社内で一意。 |
| **親部門** | 参照 | この部門が属する上位の単位。空欄にするとトップレベルになります。 |

HEADS UP

部門の削除は物理削除で、行は削除されます。先にそこに配置されているすべてのユーザーを再配置してください。そうしないと、その職務の配置から部門が失われます。

## シフト

シフトは、拠点の勤務時間を定義します。作業がいつ始まり、いつ終わり、どの曜日に行われるかです。ユーザーへのシフトの割り当ては、**ジョブ**タブから行います。

| フィールド | 型 | 目的 |
| - | - | - |
| **シフト名** | テキスト | スケジュールのラベル。 |
| **ロケーション** | 参照 | シフトを所有する拠点。必須。 |
| **開始時刻** / **終了時刻** | 時刻 | 1 日の開始と終了。どちらも必須。 |
| **日数**（Days） | ブール値 | 月曜から日曜までの 7 つの切り替え。勤務する日を示します。 |

### シフトがスケジューリングに与える影響

シフトは、単に今日誰がいるかの記録ではなく、[スケジューリング](https://docs.alforse.com/ja/docs/reference/scheduling.md)への本物の入力です。エンジンは、各ユーザーのシフト時間を機械の稼働時間と重ね合わせて、スキルが必要な作業をいつ実行できるかを判断します。そのため、シフトの変更や、ユーザーのシフトの変更は、影響を受けるスケジュールの再計画をキューに入れます。

NOTE

シフトは、人だけでなく機械にも適用されます。従業員では、そのユーザーをスケジューリングできる時間を設定し、[作業区](https://docs.alforse.com/ja/docs/reference/work-centers.md)では、ステーションの稼働時間を設定します。工程のプロセスにスキルが必要な場合、決定的な制約になるのは、シフト中の作業者です。シフト中に資格を持つ作業者がいなければ、工程は待機します。

シフトを削除すると、削除ではなく無効としてマークされるため、過去の割り当てはそのまま残ります。

## 休日

休日は、会社が休む日を示します。一覧は年ごとにグループ化されます。年は各休日の日付から Alforse が導き出すため、1 つの暦年ずつ確認できます。

| フィールド | 型 | 目的 |
| - | - | - |
| **休日名** | テキスト | 一覧に表示されるラベル。必須。 |
| **日付** | 日付 | 休みの日。必須。年はここから取得されます。 |

## 属性

証明書の有効期限、バッジ番号、Tシャツのサイズなど、Alforse に組み込みのフィールドがない情報を記録したい場合は、属性を使います。属性は 2 つのレベルで構成されます。

* **属性カテゴリ**は、関連するフィールドをグループ化します。名前、絵文字、公開の切り替えがあり、その属性がユーザーの公開プロフィールに表示されるか、管理者だけに表示されるかを決めます。
* **属性**は、カテゴリ内の 1 つのフィールドで、データ型を持ちます。

各属性は次の項目で定義されます。

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>**有効**</summary>

  出勤済みで、まだ退勤していません。従業員は勤務中です。
</details>

<details>
  <summary>**完了**</summary>

  退勤済みです。エントリは閉じられ、その時間は確定します。
</details>

* ステータスは保存されるのではなく、計算されます。
* **承認ステップはありません。** 完了したタイムカードは確定であり、承認待ちにはなりません。
* 時間は、出勤から退勤まで、またはエントリが有効な間は*現在*まで計算されます。週の時間は、今週のエントリを合計したものです。
* エントリは直接追加、編集、削除できるため、打刻漏れは後から修正できます。

NOTE

これらは、事務所側の出退勤の記録です。現場では、作業者が [MES](https://docs.alforse.com/ja/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/ja/docs/reference/permissions.md)

**二要素認証**

認証アプリのコード、全社での強制、紛失したデバイスのリセット。

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

**MES**

現場で製造指図の工程に時間を記録する。

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

**作業区**

工程が実行される場所と、そのスケジューリングおよび原価計算の方法。

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


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