人事出缺勤（HR Attendance）

§0 本大綱的用途與標記說明狀態：Outline v2（大綱待裁示，尚未展開細節）。範圍：租戶內的員工出勤、請假、加班與簽核。本文件只描述需求，不涉及技術實作、介面設計與測試。上游依賴：specs/auth/spec.md（使用者、租戶、訂閱關係、角色）。本檔目前只有章節骨架與範圍主張，供人類裁示。確認後才逐節展開為完整需求規格（名詞定義、業務規則、FR 條目、例外邊界）。標記說明：✅ 人類已裁示／🟡 主張納入本版，等人類確認／⚪ 主張不納入本版（列入 nonGoals）／🟠 待人類裁示，AI 不自行決定。

§0.2 🔴 阻擋事項：本規格依賴一個尚不存在的模組資料池（Dataset）：vops-v2 完全不存在（全域檢索 0 命中）；只有舊專案 ~/develop/volu/vops 有。依裁示 F 另立規格。資料池規格未完成前，HR 規格可以寫、但無法進入切版與實作。✅ 已裁示 Q2（2026-08-02）：撰寫順序採 資料池 → 簽核 → HR。

§0.3 承載方式（裁示 G）：員工人事擴充欄位（職稱、到職日、自訂欄位）資料池，開放自訂。理由：各租戶需求差異大，這裡就是要彈性。

§0.3 承載方式（裁示 G）：假別定義、班別、工作日曆、簽核流程設定資料池。理由：屬設定資料，租戶需自行維護。

§0.3 承載方式（裁示 G）：出勤記錄、請假單、加班單、簽核紀錄資料池，不開放封存與刪除。理由：勞基法證據，須留痕不可竄改；以池層級關閉封存與刪除達成。

§0.3 承載方式：與舊專案的差異舊專案同樣把打卡記錄放進資料池，但明確宣告「不做勞基法合規報表」。v2 裁示 C 要求合規，同樣以資料池承載，差別在法規證據類的池關閉封存與刪除，以滿足留痕與保存要求。✅ 已裁示（2026-08-02）：簽核流程設定與簽核執行紀錄皆走資料池；執行紀錄所在的池不開放封存與刪除。

§3.1 打卡🟡 每日至少上班、下班兩次打卡；當日可多段（外出、回歸）。

§3.1 打卡：認定方式✅ 已裁示 W（2026-08-02）：打卡認定方式由租戶自行選擇，本版提供兩種模式。🟡 模式一（預設）：純系統按鈕打卡，不驗證位置。🟡 模式二：系統按鈕打卡 ＋ GPS 位置驗證，允許範圍由租戶設定；拿不到定位不阻擋打卡，照實記錄為異常。⚪ 不做：IP 白名單、實體考勤機匯入（見不在本規格範圍）。

§3.2 出勤異常🟡 異常類型：遲到、早退、缺卡、曠職、未達工時。🟡 由系統依班別自動判定，不需人工標記。

§3.3 補登（補卡）🟡 員工可對異常日送出補登申請，經簽核後更正出勤記錄。🟡 更正須留痕：原始記錄不可覆寫，更正為另一筆並保留前後值（勞資爭議舉證需要）。✅ 裁示 X 修訂（D-16，2026-08-29）：補登不設次數上限；補登期限至次月結算前。

§4 班別與工作日曆🟡 班別定義上下班時間、休息時段、應出勤時數、彈性上下班容許區間。🟡 工作日曆定義工作日、例假日、休息日、國定假日。🟡 例假日與休息日須區分（勞基法第 36 條，加班規則與費率不同）。✅ 裁示 Y（D-17，2026-08-29）：本版採固定班別，一位員工綁一個班別；輪班表（逐日指派班別）留待下一版作為第二個排班模式。✅ 裁示 Z（D-18，2026-08-29）：國定假日由租戶手動匯入。參考舊專案 ~/develop/volu/vops 居服排班模組的做法：以政府年度辦公日曆表為來源，提供「帶入 N 年國定假日」預置清單一鍵帶入，並可用「日期 名稱」文字清單貼入或手動增修（僅為參考註記，不限定實作）。

§5.1 假別✅ 依裁示 C，內建台灣勞基法法定假別與規則作為預設值，租戶可在法規容許範圍內加碼（優於法規可、劣於法規不可）。🟡 法定假別：特休、婚假、喪假、公傷病假、普通傷病假、事假、生理假、產假、產檢假、陪產檢及陪產假、家庭照顧假、公假。🟡 每個假別定義：是否給薪／半薪、是否需附證明、最小請假單位、年度額度上限。✅ 裁示 AA（D-19，2026-08-29）：法規變動時，內建預設值由平台方統一推送，租戶不各自維護。

§5.2 假別額度🟡 特休依到職日與年資自動累給（勞基法第 38 條級距）。🟡 額度依假別分別計算，有結算週期。🟡 未休完特休依法應折發工資；本版只計算並呈現應折發時數，金額不算（屬薪資範圍）。✅ 裁示 AB（D-19，2026-08-29）：特休曆年制與週年制兩者皆支援，由租戶選擇。

§5.3 請假單🟡 員工填寫假別、起訖時間、事由，系統即時試算扣除時數並檢查額度。🟡 額度不足、與既有假單重疊、超出可請期間時阻擋。🟡 已簽核的假單可申請撤銷，撤銷同樣需簽核。

§6 加班🟡 加班採申請制：事前申請或事後補登，經簽核後才計入。🟡 時數依工作日／休息日／例假日／國定假日分類累計（費率基礎不同）。🟡 依勞基法第 32 條檢核延長工時上限（單日、單月）並提出警示。🟡 補償支援「加班費／補休」二擇一；補休轉入額度並有使用期限（勞基法第 32 條之 1）。⚪ 加班費金額計算不做（屬薪資）。

§7 簽核✅ 裁示 H（2026-08-02）：簽核不在本模組定義，改由通用簽核模組承擔 → specs/workflow/workflow.md。

§7 簽核：本模組在簽核上的職責僅有三項（職責邊界見 workflow.md §0.2）1. 向簽核模組登記三種單據類型：請假單、加班單、補登單。2. 提供各單據的摘要與可用於分流條件的欄位（例：請假天數、加班時數）。3. 送簽前的業務檢查（額度是否足夠、是否與既有假單重疊）與核准後的業務動作（扣除假別額度、更正出勤記錄）。

§7 簽核：不由 HR 定義關卡、簽核者、簽核動作、簽核紀錄、通知 — 一律走簽核模組。

§7 簽核🟡 三種單據各自套用一條流程，由租戶管理者在簽核模組內設定。🟡 送簽前的業務檢查未通過時，單據不得送簽（在 HR 端阻擋，不進簽核模組）。原待裁示 AC／AD／AE／AH／AI 已移交 specs/workflow/workflow.md，不在本檔重複。

§8 查詢與報表🟡 員工：自己的出勤月曆、假別額度、單據紀錄。🟡 簽核者：待簽核清單。🟡 HR：全租戶出勤總表、異常清單、假別使用統計。🟡 勞基法要求的出勤紀錄保存與備查格式（第 30 條第 5、6 項：逐日記載至分鐘、保存 5 年、勞工申請時應提供副本）。✅ 裁示 AF（D-20，2026-08-29）：報表匯出先做 Excel／CSV；PDF 本版不做。

§10 安全需求（預計涵蓋）出勤資料屬個資、僅本人與有權者可見、跨租戶隔離、錯誤訊息一律繁中。

§10 安全需求🟡 出勤與請假的所有更正一律留痕，不可竄改、不可刪除（勞基法舉證責任在雇主）。🟡 出勤紀錄保存 5 年。✅ 裁示 AG（D-21，2026-08-29）：HR 模組自帶留痕（範圍限出勤與請假），不提升為全站稽核機制；與 specs/auth/spec.md §12「操作稽核紀錄：本版不做」不衝突。