Volunteer workshift scheduler
Project description
Volunteer workshift scheduler for a helpline
Code written in Python finds the best possible schedule for volunteers while incorporating constrains and special requirements using CP-SAT Solver (Constraint Programming - boolean SATisfiability problem Solver).
Java version is in development.
The problem
Arranging volunteers for a helpline service for the period of one month.
There are three types of work that could be done on the same day:
- Phone shift: Every day.
- Chat shift: Mondays and Wednesdays.
- Observer shift: Any day.
Constraints:
Properties of each volunteer:
- Available days.
- Function: doing phone, chat, both or observation for training purposes.
- Maximum amount of weekend shifts.
- Whether their shifts have to be on separate weeks.
- Whether they welcome observers.
- Whether they want to work alone.
- Whether they cannot yet work alone.
- List of people they do not want to work with.
Each volunteer has to have 4 days between their shifts.
Priorities:
- Have minimum one volunteer for each day.
- Fill chat shifts.
- Have a second volunteer even on phone days.
- Employ observers on days when there is only phone shift.
Objective:
Maximize filled shifts.
Installation
Requires 64-bit Python 3.7
pip install helpline-scheduler
Usage
-
Select your language in config.py: EN/HU/CN
Alternatively you can create your XX language extension by creating the corresponding data_XX.csv and language_XX.py files.
-
Export corresponding data/data_XX.csv file into a spreadsheet, fill in your data, then export back into this file.
-
Execute the program from its directory:
python schedule.py
Output
- Prints results into the terminal and saves it into schedule_YYYY_MM____YYYYMMDD_hhmm.txt.
- Saves results into schedule_YYYY_MM____YYYYMMDD_hhmm.csv which can be conveniently imported into a spreadsheet.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for volunteer-scheduler-2019.4.15.post0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 02db4498c5d20f9af497f5a9a5557e8f6b846b93033397e397a1d8a608736abd |
|
MD5 | 5f7b806eb0efc90d912dd4b21ecd67c9 |
|
BLAKE2b-256 | 5f891bc6b074f881145e5f35dca68e0932335c55d6f122593daa8aa9463cb0c8 |
Hashes for volunteer_scheduler-2019.4.15.post0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c45180b373b3c54b5b4375f327c7f54c1795193a6c18002c9b246e559d99fbe4 |
|
MD5 | 6633eee4eb3072db4d6cfd9aa4ae393e |
|
BLAKE2b-256 | 6aea5154113e99d24d829cc997a8e81f2a9356723533f61daecf9d08d0b39338 |