阿拉丁·智能排班工坊

每周排班，先从 Excel 说起

店长、客服主管、护士长每周都要手工拼排班表：表格拖到眼花，公平性被员工吐槽，夜班接早班没人管，兼职工时踩了劳动法红线，等人请假了才发现某个岗位只有一个人会。排班看起来是填空题，实际是一堆约束条件的组合问题——而普通表格不会告诉你哪里排错了。

它怎么把约束变成可核对的排班

输入两个文件：员工名单（CSV/TSV/JSON，中文表头别名自动识别，支持不可用日期与班次偏好）和班次需求（JSON，含周期、每天班次定义、岗位人数、周工时上限）。排班阶段落实六类硬约束：

• 不可用日与单日一班
• 夜班后禁次日早班
• 周班次上限，全职/兼职分别受周工时上限约束（默认 44h/24h，可调）
• 岗位匹配，通岗可顶任意岗

公平性用贪心策略处理：优先排工时最少的人，兼顾班次偏好与周末轮换。排完跑 S1-S8 体检——人手缺口、周超时、连上≥6天、分配失衡、偏好满足率低、岗位单点依赖、周末压一人、在册未用——按 P0×25 / P1×8 / P2×3 从 100 分里扣，给出 A-D 分级和 READY / REVIEW / BLOCK 结论。产出三份东西：自包含的 HTML 看板（排班网格、评分环、工时均衡图）、Markdown 说明、utf-8-sig 编码的 CSV（Excel 直开、可直接打印张贴）。

值得注意的工程细节

• 纯本地运行：员工数据不上传、不联网，跑完即走
• 同输入可复算：确定性算法，重跑逐字节一致，方便对账复核；输入非法直接 exit=2 并给中文修复提示，不产出半成品
• 缺口如实报告：排不满时输出 S1 缺口清单和补人建议，不会静默塞进违规班次
• 贪心只做近似，不保证 NP 难问题的全局最优；上限是默认参数而非法律意见，跨月疲劳度也不继承

工作流四步：归集（shift_ingest.py）→ 排班+体检（shift_plan.py）→ 产出（shift_report.py）→ 迭代。名单或需求调整后重跑即可。