leave.config.get
read讀取休假單位、審批模式、日曆、通知、payroll export、資料權限與 audit 設定。
建議先讀取
-
治理與審批
只讀；按 HR 權限返回。
安全說明
不得暴露 payroll 或員工敏感權限設定。
休假管理系統 MCP 工具
休假管理系統 MCP 工具支援員工與部門、假期類型、年假 accrual、入職日 pro-rata、carry-forward、公眾假期、手機請假、病假紙附件、假期餘額、團隊更表、衝突檢查、主管審批、TOIL 補假、月度 payroll 匯出、通知及 audit。
leave.employees.list
read查詢員工、部門、主管、入職日期、工作制及適用假期政策。
建議先讀取
leave.config.get
治理與審批
只讀；員工私隱資料按角色遮罩。
安全說明
只回傳請假判斷需要的最少員工資料。
leave.employee.get
read讀取單一員工的假期政策、入職日、主管、工作日、結餘及申請歷史摘要。
建議先讀取
leave.employees.list
治理與審批
只讀；只限本人、主管或 HR。
安全說明
病假證明和 payroll 欄位不在普通查詢顯示。
leave.departments.list
read查詢部門、主管、最低人手要求及休假審批負責人。
建議先讀取
leave.config.get
治理與審批
只讀；用於團隊覆蓋檢查。
安全說明
人手要求屬內部營運資料，需按管理權限顯示。
leave.leave_types.list
read讀取年假、病假、補假、產假、侍產假等類型、單位及附件要求。
建議先讀取
leave.config.get
治理與審批
只讀；用於申請表及政策檢查。
安全說明
類型設定需反映公司政策及香港法例。
leave.policies.list
read讀取公司假期政策、適用員工、結轉、折現、試用期、附件與審批規則。
建議先讀取
leave.config.get
治理與審批
只讀；政策版本需可追溯。
安全說明
不可混淆不同員工群組的政策。
leave.accrual_rules.list
read讀取按入職日、比例年假、每月累積、封頂、結轉及到期的 accrual 規則。
建議先讀取
leave.policies.list
治理與審批
只讀；作餘額計算與 preview 使用。
安全說明
年假計算規則必須版本化，避免歷史餘額被錯改。
leave.public_holidays.list
read讀取香港公眾假、勞工假、銀行假、公司假及非工作日規則。
建議先讀取
leave.config.get
治理與審批
只讀；用於請假日數計算。
安全說明
公眾假資料需按年份及政策版本固定。
leave.balances.list
read按員工、部門、假期類型查詢已用、剩餘、待批、即將到期及結轉餘額。
建議先讀取
leave.employees.list, leave.leave_types.list
治理與審批
只讀；員工可看本人，主管看團隊，HR 看全公司。
安全說明
不可讓一般員工查閱其他人餘額。
leave.balance.get
read讀取單一員工和假期類型的餘額、計算基礎、待批扣減及到期日。
建議先讀取
leave.balances.list
治理與審批
只讀；按員工/主管/HR 權限。
安全說明
需清楚分開實際餘額與待批申請影響。
leave.balance_movements.list
read查詢假期增加、扣減、補假、調整、結轉、到期及取消申請的 ledger。
建議先讀取
leave.balance.get
治理與審批
只讀；ledger 不可被普通使用者修改。
安全說明
ledger 需保留來源和 action request id。
leave.requests.list
read按員工、部門、日期、狀態、假期類型及主管查詢請假申請。
建議先讀取
leave.employees.list
治理與審批
只讀；按本人、主管、HR 權限。
安全說明
病假原因與附件不可在團隊日曆公開。
leave.request.get
read讀取請假日期、單位、原因、附件、餘額影響、衝突、審批及通知紀錄。
建議先讀取
leave.requests.list
治理與審批
只讀；附件按 HR/主管權限。
安全說明
限制病假紙等敏感文件的可見性。
leave.proof_documents.list
read查詢病假紙、證明文件、上載時間、審核狀態及保留期限。
建議先讀取
leave.request.get
治理與審批
只讀；只限 HR、主管或提交者。
安全說明
文件應加密、可遮罩並有查閱 audit。
leave.pending_approvals.list
read列出主管待批、待補資料、超額或有人手衝突的請假申請。
建議先讀取
leave.requests.list, leave.coverage_conflicts.list
治理與審批
只讀；只列出該 approver 可處理項目。
安全說明
不可把其他主管隊伍的待批資料暴露。
leave.approval_chain.get
read讀取申請的審批人、代理審批人、跳級規則、狀態及 SLA。
建議先讀取
leave.request.get
治理與審批
只讀；用於判斷寫入審批是否合法。
安全說明
審批人不可自行改寫審批鏈。
leave.team_calendar.get
read讀取團隊假期日曆、已批准/待批請假、公眾假及人手分佈。
建議先讀取
leave.departments.list, leave.requests.list
治理與審批
只讀；團隊日曆不顯示敏感原因。
安全說明
公開視圖只顯示可見狀態，不顯示病歷或個人原因。
leave.coverage_conflicts.list
read檢查同日多人請假、最低人手不足、關鍵角色缺席及連續長假衝突。
建議先讀取
leave.team_calendar.get, leave.departments.list
治理與審批
只讀；提供審批建議，不自動拒絕。
安全說明
AI 建議不能取代主管決策。
leave.toil_records.list
read查詢加班補假 TOIL 申請、來源、批核、可用餘額及到期日。
建議先讀取
leave.employee.get
治理與審批
只讀；補假來源與批核紀錄保留。
安全說明
避免未批核加班直接增加假期餘額。
leave.payroll_exports.list
read查詢月度 payroll 假期匯出、狀態、生成者、期間、檔案版本及錯誤。
建議先讀取
leave.config.get
治理與審批
只讀；payroll 檔案只限 HR/payroll。
安全說明
payroll export 可能含敏感缺勤資料，需權限及下載 audit。
leave.summary_report.get
read讀取月度/年度請假、餘額、到期、缺勤率、部門使用量及假期負債摘要。
建議先讀取
leave.requests.list, leave.balances.list
治理與審批
只讀；可按權限聚合。
安全說明
報表需避免暴露個別病假原因。
leave.audit_logs.list
read查詢請假、附件、審批、餘額、政策、結轉、payroll export 及通知操作紀錄。
建議先讀取
leave.config.get
治理與審批
只讀；audit log 不可由普通使用者改寫。
安全說明
audit 需防篡改並支援勞資爭議追溯。
leave.request_check.preview
preview預覽請假日數、餘額扣減、附件要求、公眾假排除、衝突及人手影響。
建議先讀取
leave.balance.get, leave.public_holidays.list, leave.coverage_conflicts.list
治理與審批
只產生預覽；提交或批核前必須確認。
安全說明
防止餘額不足或錯計公眾假仍提交。
leave.approval_result.preview
preview預覽批准或拒絕後的餘額、日曆、人手、通知、payroll 及 audit 影響。
建議先讀取
leave.request.get, leave.approval_chain.get
治理與審批
批核前必須由指定 approver 確認。
安全說明
AI 不可自行批准請假。
leave.balance_adjustment.preview
preview預覽人手調整餘額、原因、ledger、到期日、payroll 影響及通知。
建議先讀取
leave.balance.get, leave.balance_movements.list
治理與審批
餘額調整需 HR/管理層批核。
安全說明
所有調整必須有原因、附件或 action request。
leave.policy_change.preview
preview預覽政策、假期類型、accrual 或公眾假變更對員工餘額和歷史申請的影響。
建議先讀取
leave.policies.list, leave.accrual_rules.list
治理與審批
政策變更必須 HR/管理層批核並版本化。
安全說明
避免政策變更錯改已關帳或歷史紀錄。
leave.carry_forward_run.preview
preview預覽年結結轉、清零、到期、折現及每個員工餘額變化。
建議先讀取
leave.balances.list, leave.accrual_rules.list
治理與審批
執行前需 HR/payroll 批核。
安全說明
年結操作不可重複執行；需 idempotency。
leave.payroll_export.preview
preview預覽指定月份 payroll 匯出的請假、缺勤、扣薪、補假及異常項目。
建議先讀取
leave.requests.list, leave.summary_report.get
治理與審批
產生正式匯出前需 HR/payroll 確認。
安全說明
匯出前需標示未批申請及資料缺口。
leave.request.create
write建立手機請假申請，包含類型、日期、單位、原因、附件要求及預覽結果。
建議先讀取
leave.request_check.preview
治理與審批
員工提交後進入審批；不即時扣實際餘額。
安全說明
需檢查餘額、附件及日數計算。
leave.request.update
write更新草稿或待補資料申請的日期、類型、原因、附件或單位。
建議先讀取
leave.request.get, leave.request_check.preview
治理與審批
已批核申請不可直接改，需改期/取消流程。
安全說明
防止更改已批核資料而無 audit。
leave.request.withdraw
write員工撤回草稿、待批或按規則可取消的請假申請。
建議先讀取
leave.request.get
治理與審批
已批准且影響 payroll 的取消需主管/HR 批核。
安全說明
取消需回滾餘額、日曆和通知狀態。
leave.proof_document.attach
write上載或替換病假紙及其他證明文件，連結到請假申請。
建議先讀取
leave.request.get, leave.proof_documents.list
治理與審批
附件可由提交者上載；查閱及核實按主管/HR 權限。
安全說明
文件需病毒掃描、加密和查閱 audit。
leave.approval.approve
write批准請假申請，扣減餘額、更新團隊日曆、發送通知並保留審批紀錄。
建議先讀取
leave.approval_result.preview
治理與審批
必須由審批鏈指定 approver 執行。
安全說明
AI 不可自行批准；需人手確認衝突和人手影響。
leave.approval.reject
write拒絕請假申請，記錄原因，保留餘額，並通知員工。
建議先讀取
leave.approval_result.preview
治理與審批
必須由指定 approver 提供原因。
安全說明
拒絕原因需專業且不暴露其他員工私隱。
leave.approval.request_info
write要求員工補交證明、修改日期或補充請假原因。
建議先讀取
leave.request.get
治理與審批
由指定 approver 或 HR 發出。
安全說明
只要求處理申請必要資料，不過度收集。
leave.balance.adjust
write人手調整假期餘額、到期日或 ledger，並保留原因及附件。
建議先讀取
leave.balance_adjustment.preview
治理與審批
需 HR/管理層批核。
安全說明
所有餘額變動需 ledger、原因和 audit。
leave.toil_record.create
write建立加班補假 TOIL 記錄，連結加班來源、可用時數及到期日。
建議先讀取
leave.toil_records.list, leave.employee.get
治理與審批
建立後通常需主管/HR 批核才增加餘額。
安全說明
防止虛假加班直接轉為假期。
leave.toil_record.approve
write批核 TOIL 記錄並增加補假餘額與 ledger。
建議先讀取
leave.toil_records.list, leave.balance_adjustment.preview
治理與審批
只限主管/HR 批核。
安全說明
需保留加班來源、批核人和到期規則。
leave.policy.upsert
write建立或更新假期政策、結轉、折現、試用期、附件及審批規則。
建議先讀取
leave.policy_change.preview
治理與審批
政策變更需 HR/管理層批核並版本化。
安全說明
不能直接改寫已生效歷史政策而無版本。
leave.leave_type.upsert
write建立或更新假期類型、半日/小時計算、附件要求及是否影響 payroll。
建議先讀取
leave.leave_types.list, leave.policy_change.preview
治理與審批
需 HR 批核。
安全說明
避免刪除已有歷史申請引用的類型。
leave.accrual_rule.upsert
write建立或更新年假累積、入職日比例、封頂、結轉及到期規則。
建議先讀取
leave.accrual_rules.list, leave.policy_change.preview
治理與審批
需 HR/管理層批核；影響既有餘額需 preview。
安全說明
避免錯計全公司假期餘額。
leave.public_holiday.upsert
write建立或更新公眾假、公司假、勞工假/銀行假日曆及適用年份。
建議先讀取
leave.public_holidays.list, leave.policy_change.preview
治理與審批
需 HR/admin 批核，尤其影響已提交申請時。
安全說明
需避免已批假期日數被無聲更改。
leave.carry_forward_run.execute
write執行年結假期結轉、清零、到期或未用假折現，並寫入 ledger。
建議先讀取
leave.carry_forward_run.preview
治理與審批
正式執行需 HR/payroll 批核及 idempotency key。
安全說明
不可重複執行；需產生完整前後對照。
leave.calendar_sync.push
write將已批請假同步到公司/團隊日曆，隱藏敏感原因並更新出勤狀態。
建議先讀取
leave.approval_result.preview, leave.team_calendar.get
治理與審批
只同步已批核申請；失敗可重試。
安全說明
不得把病假原因或附件同步到公開日曆。
leave.payroll_export.create
write生成指定期間 payroll 假期/缺勤匯出檔及異常清單。
建議先讀取
leave.payroll_export.preview
治理與審批
需 HR/payroll 批核；下載需 audit。
安全說明
payroll 資料敏感，需限制匯出格式和收件人。
leave.notification.send
write發送提交、待補、批准、拒絕、餘額到期、payroll 異常及年結提醒。
建議先讀取
leave.request.get, leave.balance.get
治理與審批
正式訊息需按模板和收件人 preview；敏感內容不可廣播。
安全說明
避免把病假、拒絕原因或 payroll 資料發錯人。
leave.action_request.status
status查詢休假管理寫入動作的 preview、批核、執行、失敗、回滾及 audit 狀態。
建議先讀取
leave.audit_logs.list
治理與審批
只讀狀態；不能用此 endpoint 強制批核。
安全說明
審批狀態需可追溯，不可由申請者自行改寫。