このドキュメントについて

• 対象画面: /ja/{tenant}/settings の従業員テーブル（追加/編集/CSV 取込/配布）。
• ゴール: 従業員を正しく登録し、従業員ごとの打刻用 URL/QR を安全に配布する。
• 前提: 管理者でサインイン済み。従業員コードの採番ルール（1〜12 桁の数字）を決めておく。

1. 登録前の準備

• 打刻リンク送信用メールを使う場合は、運用チームでメール送信設定（送信元アドレス/SES設定）が完了しているか確認する（未設定だとメール送信が 501 で失敗し、コピー配布のみになる）。
• 日払い/月払い、賃金タイプ（時給/日給/月給）を従業員ごとに決めておく。
• 部署コードやメールアドレスがある場合は CSV 取込用の列に含めておく。

2. フォームで従業員を追加する

1. サイドバーの「設定」→ 従業員テーブルで「新規追加」を開く。
2. 必須: 従業員コード（1〜12 桁の数字）、氏名 を入力。
3. 支払方法を選択（日払い または 月払い）。賃金タイプを選び、該当する金額を 1 つ入力する。
4. 任意: 部署、メールアドレスを入力。メールを入れておくと打刻リンクをメール送信できる。
5. 「保存」を押すと即時追加され、一覧に反映される。

• ヒント: 入力中にエラーが出た場合はメッセージを修正して再保存する。コード重複や形式エラーは保存前にチェックされる。

3. CSV で一括登録する

1. 「CSV 取込」を開き、列の説明とサンプル CSV を確認する。
2. 最低限必要な列は 従業員コード。その他 氏名 支払方法 賃金タイプ 時給/日給/月給 部署 メールアドレス を任意で付与できる。
3. サンプルに沿って CSV を作成し、ファイルを選択 → 「インポート」を押す。
4. 取り込み結果で「追加件数」と「エラー行」を確認。エラー行は重複コードや数値形式の不備を修正して再実行する。

• 既存コードと重複する行はスキップされる。先に CSV で追加→表内で微調整する運用がおすすめ。

4. 打刻リンク/QR の配布

• 一覧で従業員名をクリックすると共有パネルが開く。QR と URL が同時に表示され、コピーで配布できる。
• 共有 URL には従業員トークンが含まれ、/ja/{tenant}/clock?token=... へ直接遷移する。第三者転送は禁止。
• ボタンから QR をコピーして印刷・掲示するか、URL をチャット等で共有する。
• メールアドレスが設定されていれば「メール送信」で SES 経由のワンタイムリンクを送付できる（環境変数未設定時はエラー表示）。
• オプション機能: 移動開始/到着の補助打刻（自宅出発・現場到着）を送ることもできる。テナント設定で移動ログを有効にした場合のみ表示され、通常の出退勤とは別ログとして扱われる（勤怠計算/CSVには含めない）。

5. トークンの更新とトラブルシュート

• リンクを再発行したい場合は共有パネルの「トークン再発行」を押す。新しい URL で上書き共有する（メール送信を併用可）。
• 共有パネルには「発行日時」が表示される。漏洩の疑いがあれば即再発行する。
• メール送信が失敗する場合は、管理者にメール送信設定の状況を確認してもらい、失敗コードが email_not_configured のときはコピー配布に切り替える。
• 受信側でアクセスできない場合は、URL の tenant スラッグとトークンを再確認し、/clock ページで最新ブラウザを利用してもらう。

6. 外部連携（API）

• 現時点で公開 API は提供していません（予約）。