HRFlow：開源人資管理系統

讀取 Markdown 原文 · 下載 Agent SKILL.md

把員工班表、打卡與請假核准放在同一套人資系統，先用虛構員工練習。

工坊收錄說明

小隊與協作

想整理排班、出勤與請假流程的團隊、能協助架設 .NET 與 SQL Server 的開發者。

一張虛構員工的「班表 → 出勤證據 → 請假核准」流程表，另列環境設定與補休尚未實作的部分。

把測試流程表帶到小隊討論：哪些公司政策能沿用，哪些要另寫與驗證，再回原作提出具體問題。

先在紙上列一名虛構員工的班表、出勤與請假核准流程，和 README 的功能逐項對照。

封面與來源署名

作者：Shiang

封面插畫：/art/skills/hrflow.webp

原作者 GitHub：https://github.com/tesdano-crypto/HRSystem-OpenSource

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/hrflow/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

讀者與格式

模組化人資管理系統

• 想整理排班、出勤與請假流程的團隊
• 能協助架設 .NET 與 SQL Server 的開發者

功能與使用範圍

這是需自行架設的 Apache-2.0 人資系統。核心需 .NET 10 與隔離 SQL Server；SQL 整合測試限 Windows、SQL Express 與整合驗證。這份獨立快照不是舊系統的升級路徑。補休到期僅存 metadata，尚無自動到期或轉薪。LINE bridge、外部出勤排程預設關閉，另需設定；不含 LINE 出勤報表匯入。台灣薪資、保險與日曆規則須自行核對，SQL Server、依賴套件與政府行事曆另有條款，見 NOTICE。工坊未架設或測試上游。

• 建立員工、部門、角色與帳號，安排公司日曆及班表。
• 保留原始出勤證據，再計算出勤；處理請假核准、年假與加班。
• 保存薪資、保險、補休期初餘額與另行核准的假日訓練額度。

開始前準備

• .NET SDK 10.0.302（及相容修補版）、PowerShell、可取得 NuGet 套件的環境。
• 一個空白、隔離的 SQL Server；初始管理員四項設定由本人私下提供。
• 先讀 README 的 Configuration／Database setup、NOTICE 與 src/HRSystem.Web/appsettings.example.json；example 檔不會自動載入。

第一個練習

1. 先在紙上列一名虛構員工的班表、出勤與請假核准流程，和 README 的功能逐項對照。

2. 在自己的隔離環境依 README 執行 dotnet tool restore --tool-manifest dotnet-tools.json、dotnet restore HRSystem.slnx、dotnet build HRSystem.slnx -c Release --no-restore。

3. 確認連線指向空白測試庫後，依 Database setup 初始化並啟動 src/HRSystem.Web；以虛構員工核對流程，把政策差異寫下來。

練習成果

一張虛構員工的「班表 → 出勤證據 → 請假核准」流程表，另列環境設定與補休尚未實作的部分。

專案與授權

原作 Repo：https://github.com/tesdano-crypto/HRSystem-OpenSource

從原作建立自己的版本：https://github.com/tesdano-crypto/HRSystem-OpenSource/fork

工坊整合參考：https://github.com/tesdano-crypto/HRSystem-OpenSource

記錄的授權：Apache-2.0

一起改這本技能書

可從原作 Issues 回報安裝卡點、出勤核對或文件差異，附 .NET／SQL Server 版本與虛構案例；保留 Shiang 的來源署名、Apache-2.0 與 NOTICE，不附員工、薪資或連線資料。

原作 Repo：https://github.com/tesdano-crypto/HRSystem-OpenSource

預設 PR 目標：tesdano-crypto/HRSystem-OpenSource:main

從原作建立自己的版本：https://github.com/tesdano-crypto/HRSystem-OpenSource/fork

原作 PR：https://github.com/tesdano-crypto/HRSystem-OpenSource/pulls

工坊整合參考：https://github.com/tesdano-crypto/HRSystem-OpenSource

工坊整合任務專用 Fork：https://github.com/tesdano-crypto/HRSystem-OpenSource/fork

工坊任務：https://github.com/tesdano-crypto/HRSystem-OpenSource/issues

工坊 PR：https://github.com/tesdano-crypto/HRSystem-OpenSource/pulls

GitHub Milestones：https://github.com/tesdano-crypto/HRSystem-OpenSource/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

• 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 改善模組化人資管理系統的第一個案例 · 建議任務

可從原作 Issues 回報安裝卡點、出勤核對或文件差異，附 .NET／SQL Server 版本與虛構案例；保留 Shiang 的來源署名、Apache-2.0 與 NOTICE，不附員工、薪資或連線資料。

• 驗收：一張虛構員工的「班表 → 出勤證據 → 請假核准」流程表，另列環境設定與補休尚未實作的部分。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。

Agent Skill：/development/skills/hrflow/SKILL.md

協作 JSON：/api/v1/skills/hrflow/collaboration

參與開發

可從原作 Issues 回報安裝卡點、出勤核對或文件差異，附 .NET／SQL Server 版本與虛構案例；保留 Shiang 的來源署名、Apache-2.0 與 NOTICE，不附員工、薪資或連線資料。

工坊 Issue／PR 協調入口：https://github.com/tesdano-crypto/HRSystem-OpenSource/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

閱讀與來源

閱讀原始專案：https://github.com/tesdano-crypto/HRSystem-OpenSource/blob/a60cd7b14d25b5a8ab90574247e48a4b4038b11c/README.md

核對日期：2026-10-20

核對版本：a60cd7b14d25b5a8ab90574247e48a4b4038b11c

• README.md：https://github.com/tesdano-crypto/HRSystem-OpenSource/blob/a60cd7b14d25b5a8ab90574247e48a4b4038b11c/README.md
• LICENSE：https://github.com/tesdano-crypto/HRSystem-OpenSource/blob/a60cd7b14d25b5a8ab90574247e48a4b4038b11c/LICENSE
• NOTICE：https://github.com/tesdano-crypto/HRSystem-OpenSource/blob/a60cd7b14d25b5a8ab90574247e48a4b4038b11c/NOTICE

共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map