排班劳资权衡精算引擎

要解决的问题

排班争议往往卡在一个基本数学缺口上：排班表每改一次，员工的到手收入和公司的单位工时成本都会跟着变，但 HR 和财务通常各拿一份表格争论，缺一个能把它们放进同一坐标系量化对比的工具。

这个技能面向一段连续窗口（典型 13 个 7 天块 = 91 天，约一个季度），把「员工收入最大化」和「公司单位人力成本最小化」拆成可枚举、可对比、可画在同一张散点图上的数值。

它如何工作

核心思路是穷举枚举 + 向量化计算：

• 块建模：窗口拆成 7 天一个的调度块，每块只有三种合法模式——A（5 工 2 休）、B（6 工 1 休）、C（7 工 0 休），硬约束是两个 C 块不能相邻。
• 薪酬规则：块内出勤 ≥6 天时末位工作日计双倍；法定节假日出勤计三倍；调休补班日按正常档。日薪费率按 H 档位分正常/双倍/三倍三档计算。
• 固定费恒等式：公司时均 = 员工均薪 + 固定费总额 ÷ 总工时，所以两个指标的差被工时锁死，不能直接比大小。
• 合规过滤：剔除月工时 < 208H 或月工资 < 6500 元的方案。
• 输出：一份 HTML 报告（含权衡平面 SVG 散点图，左上方向是双赢区）+ 每档一份可行集 CSV。

跑法很直接：默认窗口下执行 python run.py，报告落在 reports/ 目录。报告里的 ①②③ 是离「理想点」（员工均薪最高 ∧ 公司时均最低）欧氏距离最近的折中方案，④⑤⑥ 则是在锁死总工时的前提下对双倍日数量做取舍。

适用边界

几个容易踩的坑：

• 只支持 7 天块调度，5+2、4+3 这类非 7 天作息需要映射近似，误差来自双倍/三倍日的精细分布。
• 只分析单人整月块序列，多员工只能逐人跑再手工合并 CSV。
• 跨年窗口的节假日规则只按起点年份查表，正确做法是拆成两个窗口分别跑再取并集。
• H=8 档在常见 92 天窗口下全部被合规过滤，想看理论边界得调低 --comp-wage / --comp-hours。
• 这是离线精算，窗口由 START_DATE 显式指定，不做实时排班调整。
• 窗口别贪大：默认 ≤ 200 天，再长序列数会指数爆炸，按季度分段跑再合并。