阿拉丁工资条工坊

为什么算薪依然是个手工活

月底算薪看起来是表格加减，实际是一条容易出错的规则链。加班费要先按 21.75 天折算时薪，再区分工作日、周末和法定节假日倍率；缺勤扣款要和考勤对账；五险一金要处理基数上下限与档案中的公积金比例；个税则按累计预扣法逐月滚动。任何一个环节口径不一致，都会让“实发到手”偏离人事台账。

更麻烦的是发薪前的最后核验：是否存在有加班却没有加班费、社保基数明显偏低、缺勤扣款异常、在册员工缺少工时记录等隐性问题。这类错误往往在工资发出后才被发现。

技能如何完成核算

@user_d18c97ea/aladin-payslip-forge 把这套流程拆成清晰的输入、核算和输出：

• 输入：员工薪资档案（CSV/TSV/JSON，至少包含姓名与基本工资），以及可选的工时来源。工时可以是工时 CSV，也可以是上游考勤契约 _attend.json（aladin.attend/v1），后者会把加班时长和缺勤天数直接带入核算。
• 核算：加班费按 21.75 天月计薪基数折算，倍率默认工作日 1.5、周末 2、法定 3；五险一金按个人扣缴比例计算，养老 8%、医疗 2%、失业 0.5%，公积金读取档案比例；个税采用 7 级超额累进与速算扣除，支持专项附加扣除和年内月数。
• 体检：发薪前执行 Y0 到 Y8 共 9 条规则，覆盖考勤门禁传导、实发为负、低于最低工资、社保基数异常、加班费缺失、计税月数缺失、缺勤扣款过高、公积金超上限和在册无工时记录。结果会给出健康分与 READY/REVIEW/BLOCK 门禁。
• 输出：默认生成到 build/，包括可直接查看的 payslip_board.html、可逐人私发的 payslip_slips.md、Excel 可直开的 payslip_ledger.csv，以及供下游工具消费的 _payslip.json（aladin.payslip/v1）。

实现上使用纯 Python 标准库，不依赖第三方包，排序与舍入保持确定性，方便代码审计和双跑比对。

适用边界

它面向内部核算，不生成社保或个税申报文件，也不做银行代发和支付集成。当前个税按综合所得累计预扣，不含年终奖单独计税、劳务报酬和股权激励等特殊税目。社保基数上下限、最低工资等参数需要外部传入，工具不会联网查询各地政策。体检结果用于提示风险，最终发放仍需人事与财务复核，不构成税务或法律意见。