📖 系統使用說明

Phase 2 HR 系統以 Phase 1 打卡資料為基礎，提供出勤異常分析、 員工確認流程、HR 審閱管理及 Exchange 郵件通知等完整功能。

1. 1
   選擇查詢日期

   頁面頂部日期選擇器預設為「昨天」，可自由切換任意日期。點擊 🔍 分析 按鈕後，系統從 Phase 1 資料庫讀取當日所有員工打卡記錄並進行分析。
2. 2
   查看統計卡片

   分析完成後，頁面顯示六種狀態的員工人數統計卡：正常、遲到、早退、缺席、僅打上班、僅打下班。點擊各卡片可快速篩選對應狀態的員工清單。
3. 3
   觸發通知

   點擊 📧 發送通知 按鈕，系統對所有 notify_enabled=true 且有異常的員工寄送確認信。每位員工信中包含專屬一次性連結，有效期限由系統設定的 token_expire_days 控制。
4. 4
   員工清單操作

   清單中每列員工可直接點擊 📋 紀錄 跳至該員工的打卡紀錄，或點擊 ✉️ 補發通知 重新寄送確認信。

1. 1
   設定查詢條件

   提供四種篩選維度：開始日期、結束日期、員工 DIN（可留空查全員）。設定後點擊 🔍 查詢。
2. 2
   閱讀紀錄清單

   結果表格顯示員工姓名、DIN、日期、打卡時間、打卡次數、系統判定狀態，以及補登/修正旗標。點擊列尾 📋 可跳至打卡紀錄頁面。
3. 3
   操作按鈕

   原始打卡紀錄旁有 ✏️ 修正 按鈕可修正時間，HR 補登/修正紀錄旁有 🗑️ 撤銷 按鈕可軟刪除。

1. 1
   開啟補登表單

   在打卡紀錄頁面點擊右上角 ＋ 補登申請，或在清單中對特定員工點擊 ✏️ 修正。
2. 2
   填寫補登資訊

   必填欄位：員工 DIN、補登日期、補登時間、原因說明。確認後點擊確認補登。
3. 3
   修正現有紀錄

   修正功能允許更新現有打卡時間，操作後原始紀錄保留並標記 已修正，系統新增修正版本。
4. 4
   撤銷補登/修正

   在紀錄清單中點擊 🗑️ 撤銷，系統將該筆軟刪除，不會實際刪除資料。

1. 1
   收到確認信

   員工信箱收到打卡確認信，含當日出勤摘要與專屬確認連結。
2. 2
   填寫打卡回報

   點擊連結開啟確認頁，逐筆選擇打卡類型（上班/下班/加班/外出/出差/其他），可附備註。
3. 3
   送出確認

   送出後系統自動通知 HR，連結標記為已使用，無法重複提交。

1. 1
   查看待審閱清單

   進入確認審閱頁面，「待審閱」Tab 顯示所有員工已提交但尚未審閱的回報。
2. 2
   開啟審閱 Modal

   點擊任一筆的 ✅ 審閱 按鈕，彈出審閱視窗顯示完整打卡回報。
3. 3
   選擇 HR 判定

   選擇判定：核准/駁回，可附 HR 備註。
4. 4
   填寫審閱人 Email

   填入審閱人 Email 作為稽核記錄，送出後移至已審閱 Tab。

1. 1
   設定 HR 收件信箱

   在儀表板系統設定中，將 hr_emails 設定為 HR Email，多位以逗號分隔。
2. 2
   設定 Token 有效天數

   token_expire_days 控制確認連結有效期限，預設 7 天。建議 3～7 天。
3. 3
   手動發送測試通知

   在儀表板點擊測試通知，輸入目標 Email 驗證連線與信件格式。
4. 4
   批次發送通知

   分析完成後點擊批次通知，對所有符合條件員工一次性發送確認信。

1. 1
   進入員工設定頁

   在儀表板點擊 👥 員工設定，列出所有員工的 DIN、姓名、Email、兼職與通知開關。
2. 2
   設定 Email

   Email 為寄送確認信的必要資訊，未設定將無法收到通知。
3. 3
   兼職/全職切換

   兼職員工出勤規則較寬鬆，僅打上班或下班不視為異常。
4. 4
   通知開關

   關閉後該員工即使出勤異常也不會收到確認信。

1. 1
   開啟 Exchange 設定

   在儀表板點擊 📮 Exchange 設定。
2. 2
   填寫伺服器資訊

   必填：主機名稱、連接埠、帳號、密碼。密碼加密儲存。
3. 3
   選擇驗證方式

   支援 NTLM、NEGOTIATE、BASIC。建議先用 NTLM。
4. 4
   執行連線測試

   測試登入 Exchange 並讀取收件匣數量。
5. 5
   啟用設定

   測試通過後確認 is_active=true，系統開始使用此設定。