shift-planner

Generate weekly shift schedules by feeding roster and requirements CSV files into a constraint-satisfaction algorithm that assigns qualified staff to day-room time windows. The tool outputs Markdown assignments, a coverage matrix, fairness metrics, and structured alerts.

Coverage validation checks each 30-minute time slot against staffing requirements, excluding break periods, to verify whether generated shifts are fully covered. The algorithm emits structured alerts for any gaps or unmet requirements detected in the schedule.

Staff assignment enforces hard constraints including weekly hour limits, maximum working days, consecutive-day limits, minimum rest hours, and qualification matching. The greedy algorithm checks these rules before assigning employees to day-room time slots.

Yes, workforce staffing problems like scheduling for multiple rooms and enforcing supervisor requirements are supported. You define room, time slot, and qualification needs in the requirements CSV, and the algorithm matches qualified staff accordingly.

Fairness reporting outputs per-employee metrics including assigned hours versus contract, weekend distribution, and avoid-day violations. It highlights imbalances and constraint issues to help identify uneven workload distribution.

Uncovered time slots occur when the greedy constraint-satisfaction algorithm cannot assign staff without violating hard constraints like minimum rest hours, consecutive-day limits, or qualification mismatches. Check the generated alerts and fairness report for specific gap details.