# HRFlow：開源人資管理系統：技能書與協作來源 把員工班表、打卡與請假核准放在同一套人資系統，先用虛構員工練習。 ## 工坊收錄說明 小隊與協作 想整理排班、出勤與請假流程的團隊、能協助架設 .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