排班劳资权衡精算引擎

分享海报

@user_3851e389/schedule-tradeoff-engine

班表精算师的可复用引擎。基于"7天块调度"方法论（A=5工/2休、B=6工/1休、C=7工/0休， 硬约束无相邻 C 块，块内出勤≥6天→末位工作日双倍，节假日三倍，调休正常计）， 向量化枚举全部合法 13 块序列（约 50.9 万条），对日工时 H∈{8,10,12} 三档分别： 逐日定档（正常/双倍末位/三倍）、逐月与全程聚合月工时、月工资、员工均薪、公司时均 （含固定费），按合规下限（月≥208H 且月≥6500元）过滤可行集， 并选取出 ①②③ 折中最优、④⑤⑥ 锁死工时对比、员工收入上限/公司成本下限边界， 最终输出含劳资权衡平面 SVG 的 HTML 报告与可行集 CSV。 v1.1.0 新增：START_DATE + WINDOW_DAYS 可配置；月份分组、三倍节假日（国庆 10/1-7 固定 + 中秋按年查表）、调休补班（按年查表）均按真实公历日期自动算出 day index，换年份窗口 无需手改任何数组。 v1.1.1：内置 2025 中秋国庆合并年示例（HOLIDAY_OVERRIDE / MAKEUP_BY_YEAR 已写好）， 改 START_DATE = date(2025, 8, 1) 即可一键复现合并放假 10/1-10/8 的精算结果。 v1.1.2：基于测评反馈全面增强鲁棒性与可触达性。① 引擎与报告生成器顶部加 预检（numpy 依赖 / 输出目录可写 / 磁盘空间 ≥ 50MB / WINDOW_DAYS≥1 / START_DATE 是 date）， 主体 try/except 包裹，失败时打印"【原因+建议+示例】"而非裸露 traceback； ② 进度分步提示（[1/4] 枚举 → [2/4] 展开 → [3/4] 计算 → [4/4] 选方案）； ③ 写文件时附加行数确认。默认 2026/92 天数值完全复现。 v1.2.0：参数模板化（免改源码）。① 支持**命令行参数 + 环境变量**覆盖核心配置， 无需编辑本文件即可分析任意年份/窗口： - `--start-date` / `-s`（或环境变量 `START_DATE`）：窗口起点 YYYY-MM-DD - `--window-days` / `-w`（或 `WINDOW_DAYS`）：窗口总天数 - `--hs`（或 `H_TIERS`）：需计算的日工时档位，逗号分隔，如 `8,10,12` - `--fixed-fee`（或 `FIXED_FEE`）：月固定费 元/月 - `--comp-hours`（或 `COMP_HOURS`）：月合规工时下限 H - `--comp-wage`（或 `COMP_WAGE`）：月合规工资下限 元 ② 中秋（农历八月十五）公历日期查表**延长至 2040**（lunardate 库核验 2020-2040，原 2020-2035 与 holidays 核验一致）。 ③ 报告生成器从 `_summary.json` **动态读取实际计算的 H 档位**，仅渲染有可行方案的档位平面，H=8 等不可行档位单列结论段。 v1.3.0：鲁棒性 + 可触达性再增强（第二轮测评反馈）。① 引擎与生成器文件写入 拆分子 try/except，单文件失败不阻断整体并自动落回 cwd；② 错误信息统一 【原因 / 建议 / 示例】三段式 + 全中文文案；③ 引擎与生成器均接受 `--start-date` 等透传 参数（即 `python schedule_engine.py --hs 10,12` 与 `python run.py --hs 10,12` 等价）； ④ 新增 `run.py` 一键入口，让"两步执行"变一步，避免搞错顺序； ⑤ SKILL.md 加 `❌ 不能做什么` 边界声明、`📐 执行流程图`、`📊 输出长什么样` 报告章节导航表，新增 Q11-Q18 操作类 FAQ。