Command line application for planning a schedule of shifts for a team of doctors.
Run unit tests:
sbt clean test
Package and generate fat JAR:
sbt assembly
Run to generate rota:
java -jar rota.jar gen <start date>
E.g.
java -jar rota.jar gen 2020-06-01
Run to suggest swap. The rota file is generated when running gen:
java -jar rota.jar swap <doctor wanting swap> <date of shift to swap>
E.g.
java -jar rota.jar swap "Fred Smith" 2020-06-01
Run Scala formatting on all files:
sbt scalafmtAll
The application is split into two parts:
- Generate a rota over an initial 10 week period.
- Given a doctors asks for leave for a particular period of days, suggest swaps if not possible to accommodate.
There are three shifts:
- "Normal" - 09:00 - 17:00 (only on weekdays)
- "Long day" - 08:30 - 21:00
- "Night" - 20:30 - 09:00 (+1) A weekday shift is defined as Monday-Thursday and a weekend shift is defined as Friday-Sunday.
- No doctor can work more than 47 hours per week on average. But they can work more than 47 hours in a single week.
- No doctor can work more than 7 days in a row.
- After a night shift, a doctor must wait a minimum 13 hours before doing another shift.
- Over a 10 week/10 doctor period they must do:
- 4 long days which fall on a weekday.
- 4 nights on a weekday. On the initial rota the 4 nights must be consecutive but can adjust when doing swaps.
- 3 long days on a weekend. On the initial rota the 3 long days must be consecutive but can adjust when doing swaps.
- 3 nights on a weekend. On the initial rota the 3 nights must be consecutive but can adjust when doing swaps.
- Only one doctor can work on an anti-social shift (i.e. long day or Night, either weekend/weekday).
- Swaps only apply to anti-social shifts.
- Currently only supports 2-way swaps
- When doing a long day/night on a weekend, can split over multiple weekends (to make swaps easier).
- Improve how output is displayed
- Fix serialisation when running in SBT
Copyright (c) 2020 Hasan Zaidi
Published under the MIT License.