# FairShift 项目申报书

## 基本信息

- 项目名称：FairShift：基于 MoonBit 的可解释公平排班优化引擎
- GitHub 仓库链接：https://github.com/zhou506403/zhou
- 项目方向：约束求解、组合优化与实际应用组件
- 是否为移植项目：否，原创项目

## 项目简介

FairShift 是一个使用 MoonBit 实现的轻量级排班优化引擎，用于根据人员技能、可用时间、班次需求和公平性要求自动生成排班方案。项目不仅输出排班结果，还提供约束冲突、无法分配原因、公平性指标、容量瓶颈和人员缺席影响，帮助使用者理解并调整方案。项目提供 MoonBit 核心库、可运行命令行示例、CSV 数据接口以及文本、CSV 和 JSON 报告。

## 项目方向与适用场景

项目面向实验室值班、社团活动、志愿服务、小型门店、社区诊所和运维轮班等场景，重点解决人工排班效率低、规则容易遗漏、工作量不均衡及结果难以解释的问题。项目属于实际应用与通用算法组件，不开发 MoonBit 编译器、编辑器或语言工具链。

## 拟实现的核心功能

- 建模人员、技能、班次、可用时间、偏好及排班周期；
- 支持技能覆盖、人员不可用、班次重叠、最短休息、连续工作和工时上限等硬约束；
- 支持工作量、夜班、周末班和个人偏好的公平性评分；
- 实现确定性贪心构造与局部搜索优化；
- 输出冲突原因、排班评分、审计轨迹及公平性报告；
- 提供 CSV 输入、文本/CSV/JSON 输出和三个可运行示例；
- 提供容量瓶颈、人员缺席敏感性和应急补员建议；
- 配置自动化测试、持续集成、完整 README、更新日志和 Mooncakes 发布。

## 原创、移植或开源参考说明

本项目为原创项目，不移植已有开源项目代码。算法设计使用约束检查、贪心搜索、局部改进和敏感性分析等通用方法，数据模型、公共接口、求解流程、解释系统、测试及示例均以 MoonBit 独立实现。项目采用 Apache-2.0 许可证，不包含第三方代码、素材或数据集；后续如引入依赖，将在 README 与 NOTICE 中注明来源、许可证和使用范围。