分享程式代碼相關筆記
目前文章總數:203 篇
最後更新:2025年 10月 25日
以下是 Jorani 的限制,關鍵在於免費、適用於中小型企業
| 功能面向 | 優點 (✅) | 限制 (❌) |
|---|---|---|
| 流程與審批 | - 支援主管審批 - 可設定多層主管審批 |
- 無法設計複雜流程 - 無平行簽核 / 會簽 - 無條件式審批(如請假天數不同走不同流程) |
| 角色與權限 | - 內建角色簡單(Admin / HR Admin / User) | - 無法自訂角色 - 權限粗糙(難以精細控制部門層級權限) - 不支援 SSO / LDAP / AD 整合 |
| 系統整合 | - 開源,可自行開發 API | - 缺乏 Payroll / ERP / 考勤機整合 - 無 REST API 套件 - 需自行修改程式碼整合 |
| 報表與分析 | - 內建基本報表(假期統計、加班統計) | - 報表固定,無法自訂 - 無 BI 整合(Power BI、Tableau) - 無即時 Dashboard |
| 使用體驗 | - 界面簡單,上手快 - 適合中小企業 |
- UI/UX 老舊 - 無行動 App(僅能用瀏覽器) |
| 維運與資安 | - 免費開源,成本低 | - 無官方技術支援(靠社群) - 缺乏完整稽核日誌 - 資安功能不足(加密、SSO 需自行擴充) |
| 適用場景 | - 成本敏感的公司 - 中小企業 |
- 大型企業 / 跨國公司 - 需要複雜流程與高度整合的組織 |
在申請休假流程,如下圖,一般員工 -> 主管 -> HR
HR 要為自己公司設定以下所有基礎設定,也是本篇 第二部分 -> 第七部分 ,所有設定教程
從第二部分開始,以 管理員(HR) 視角開始進行
此功能是請假系統一切的基礎,要有請假類別才能成立整個請假管理
※每個假別的休假天數,要從 合約 與 員工享有天數 此 2 功能來設定,本篇後續部分都會說明
休假種類:定義該企業提供員工可申請休假的種類
進入休假 -> 總類列表
預設只有補休,用於加班計數器使用,因此不能刪除,每間企業的狀況不同,可以依照需要自行建立,範例以台灣常見的請假類型建立
選擇 -> 建立請假種類
依序將所有資料補完
| 名字 | 假別名稱 EX: 特休、陪產假、產假等等… |
| Acronym | 縮寫,用於企業內部的縮寫辨識,也可不填寫 |
2025 年,台灣勞基法規則參考後,整理如下:
※僅供參考,完整資訊請參考台灣政府勞基法規則
| 補休 (compensate) | Jorani 預設,用於申請加班時的計數 |
| 特休 (paid leave) | 有薪水的休假,如年假 |
| 產假 (maternity leave) | 女性員工生產前後的休假 |
| 陪產假 (paternity leave) | 男性員工因配偶生產或育兒的休假 |
| 生理假 (menstrual leave) | 女性員工因生理期不適申請的假別 |
| 病假 (Sick leave) | 因疾病無法工作的假別 |
| 事假 (personal leave) | 因特殊事由申請的假別 |
以下為範例說明用的請假種類,具體設定每間企業都不同。
只有擁有HR權限的使用者才可以修改組織架構,
※組織應符合自己的公司架構,會影響報表顯示、行事曆顯示,並且上級批准假單可以更直覺
組織:定義該企業組織的架構,每個部門間的關係圖
進入人力管理者 -> 組織
進入後初始為空(示意)
這邊的編輯方式是用滑鼠右鍵開始進行編輯
完整編輯完成後,可能會有以下 樹狀 結構,範例拆了 6 個部門,最上級的為董事長,每個部門將主管、一般員工切割開來
只有擁有HR權限的使用者才可以修改類別名單,依照員工身分的不同有不一樣的合約
※一般公司可能會比照勞基法給予的休假天數
類別:又名合約名單,定義企業與員工雇傭合同中,公司基於勞基法加上企業自身提供員工在此次契約中約定的休假享有天數
進入人力管理者 -> 類別 (英文名稱:Contract)
進入後初始為空(示意),需要建立企業對員工的初始合約,選擇建立類別
開始依序補齊自己企業的所有合約類別
| 1. 名字 | 合約的名字,用於辨識 |
| 2. 起訖 | 某些約聘的合約會用到(工讀生、一年一聘等等…),大部分正職員工的契約不會用到此欄位 |
| 3. 預設類別 | 若員工被分配到此合約,員工要請假時預設的請假類別(員工還是可以自行選擇,這裡只是預設值) |
這邊範例使用了三種合約,接著要對合約設定可休假天數,因此還需繼續編輯,如圖選擇 享有天數
進入後每個合約預設都是空,要選擇 外加
依照勞基法規定,員工初始第一年度會有 7 天特休
※更進階的用法 HR 可以先把每年度正職的特休天數配置好,每年替換員工該年度的對應特休天數
天數設定完成後,在此合約內可以檢視到在 時間段 中的可享休假天數
只有擁有HR權限的使用者才可以修改職位職稱,用於 辨識 員工於企業內部的職等顯示
※每間企業都會不相同,因此公司 HR 應依照自己企業的內容配置
職位職稱:每間企業分配的職位職稱,依照等級而劃分,會影響報表的分類顯示結果
進入人力管理者 -> 類別 -> 職位職稱
進入後初始為空(示意),需要依照企業部門、職等定義所有職稱,選擇 建立職稱
職稱為辨識用,將會影響報表,不同的員工,可能會用到相同的職稱
想要檢視部門特定職等的員工時,顯示報表很實用
這邊 Demo 展示,依照 組織 架構下,設定 主管職、一般員工 職等
上述的所有基礎架構都配置完成後,可以開始使用 Jorani 請假系統,為每一位員工建立帳號
※嚴格來說老闆(老闆的秘書)也是員工之一,但角色應為 admin 便於隨時想看所有員工的資料
使用者:企業內的所有員工
管理 -> 使用者列表 (如果選擇建立使用者直接跳到 Step 3: 步驟)
預設會只有 1 筆 bbalet,建議改為 HR Manager
選擇 建立使用者 依序將公司所有員工添加完成
以下是建立使用者相關欄位,HR 應為公司所有員工補完
| 01. 名 | 名字 |
| 02. 姓 | 姓氏 |
| 03. 登陸 | 登入請假系統時要輸入的帳號,建議用 英文 |
| 04. Email | 必填欄位,當申請假單 審核通過/拒絕 時,可以收到信件通知 |
| 05. 管理者 | 重要,這個欄位為允許該位員工休假的批審者 |
| 06. 角色 | 除了 HR、老闆 等最高等級的員工外,應都設為 User ,包含所有主管,主管只有批准的權限使用 User 即可 |
| 07. 事業體 | 對應組織的所屬,此配置會影響報表統計顯示 |
| 08. 職稱 | 對應職稱的對應,此配置會影響報表統計顯示 |
| 09. 到職日 | 該員工到職日,用於核算薪資與分配享有特休日的考據 |
| 10. 內部/公司識別碼 | 該公司的員工編號,通常與出缺勤打卡系統匹配 |
| 11. 語言 | 預設該員工登入考勤系統時顯示的文字,通常員工可以自己後續更改 |
| 12. 時間區 | 依照員工所屬區域劃分時間區 |
Demo 為每個部門都配置 1 名主管 + 1名員工,便於展示申請休假批准
當建立完員工後,可以到此功能為每位員工設定各自的休假享有天數,因為每位員工入職的時間不同
人力管理者 -> 員工 -> 員工列表
進入員工列表後,選擇一筆員工
這時選擇享有天數
進入後會看到該位員工已設定資料
我們假定該員工入職第 2 年,要為其而外設定 3 天的特休,可以如圖配置,該年度額外 3 天
該位員工,今年度(2025年),就將會有 合約7天 + 額外配置3天 共 10 天特休
這是一種設定方式,也可以從合約建立好所有年份的特休天數,然後每年替換所有員工的資料
因此 Jorani 適合於小型企業,若人數破百應找尋找其他方案
我們使用一般員工的帳號登入 (角色 : user)
登入後,選擇 申請 -> 休假 -> 申請一個休假
假設員工要申請,可以依照時段申請,目前 Jorain 有設定上的限制,關於時數對應如下:
| 時段 | 數值 |
|---|---|
| 全天 | 1.0 |
| 半天 | 0.5 |
並且每個請假的時段會為 ■
※因此工時如果一天工時 8 小時轉換數值應為下:
| 時段(Hour) | 數值 |
|---|---|
| 1 | 0.125 |
| 2 | 0.25 |
| 3 | 0.375 |
| 4 | 0.5 |
| 5 | 0.625 |
| 6 | 0.75 |
| 7 | 0.875 |
| 8 | 1.0 |
登入者可以檢視自己當前的休假天數,選擇 申請 -> 休假 -> 櫃台
可以看到自己當前的 享有天數
申請休假可以選擇 申請,計畫,計畫並不會真的送出,只會放在該員工的待請清單中
差異整理(以下主管為批准人員):
| 項目 | 計畫 (Planned) | 要求 (Requested) |
|---|---|---|
| 通知主管 | 不發送電子郵件 | 發送電子郵件通知 |
| 需要審核 | 預設不需要主管審核 | 預設需要主管審核 |
| 主管檢視 | 預設不出現在主管的待審清單 | 預設檢視 |
| 可修改性 | 員工可以修改 | 提交後員工無法修改 |
| 用途 | 暫時規劃、不確定的請假 | 正式申請、確定的請假 |
每個員工都會有對應的批准人員,通常是直屬主管,我們使用主管的帳號進行登入
登入後會出現批准筆數
※該位員工只有 1 筆請求,因此為 1
若帳號有被分派批審人員,就會有批准的欄位
批准 -> 休假
這時批審人員就可以進行批准,打勾 表示接受申請
| 圖案 | 項目 |
|---|---|
| √ | 批准休假 |
| × | 拒絕休假 |
| 眼睛 | 檢視這筆假單請假內容 |
| 時間 | 整理列表檢視 |
身為主管(批准人員),會想知道部屬們的請假狀況,這時可以選擇部屬行事曆
進入後可以以主管的視角,看到底下的員工已申請休假的狀況,來進行人力調配
我們使用一般員工的帳號登入 (角色 : user)
登入後,選擇 申請 -> 加班 -> OT工作列表
進入後,會顯示登入者的所有申請加班清單,目前尚未有
選擇 -> 新申請
同休假,有 計畫,請求 ,規則可參考上方
建立加班單完成後,會出現在列表中
主管(批准人員),接著可以為自己的部屬進行批審加班
選擇批准 -> 批准 -> 加班
這時批審人員就可以進行批准,打勾 表示接受申請
| 圖案 | 項目 |
|---|---|
| √ | 批准加班申請 |
| × | 拒絕加班申請 |
| 眼睛 | 檢視這筆加班單內容 |
加班單申請通過後,預設會為該員工 增加補休時數,如果要變為加班費,可以額外處理
※不紀錄該筆補休,轉換為金錢,不計入系統中
如果管理人員、主管(批審人員),想要檢視成員的加班申請
登入 -> 人力管理者 -> 報告 -> 加價平均值 (Jorani 翻譯名稱)
可以觀察到補休的地方即為該名員工的加班時數