Overview

schedulr is a scheduling framework for Rust: timetabling, appointment booking, workshop and shift planning. You describe the problem with domain types (activities, resources, participants, time windows, calendars, preferences); schedulr turns that description into a constraint model and solves it with unifier.

pathwise → unifier → schedulr → (application: timetabling, appointment booking, ...)

What it covers

• Batch planning: compile a SchedulingProblem, solve it, and read one assignment per activity with its window, resources and participants.
• Hard constraints: no double-booking, resource capacity, resource matching by type, feature and capacity, pools, participant groups, periodic slot calendars with exceptions.
• Preferences on three lexicographic levels, with a score component per rule in every solution.
• Single-activity checks for booking UIs through SchedulingState, without a solver search.
• Explanations and follow-up work: explain, analyze, evaluate_move, suggest, compare and a baseline-aware repair.

Versions

The latest release on crates.io is 0.8.0. The master branch additionally has breaks, per participant and per resource availability, and activity relations. Pages that describe them are marked as unreleased.

Where it stops

• Time is an integer. Mapping it to dates, time zones and clock times is the application’s job.
• There is no file format, serialization or CLI; problems are built in Rust.
• Persistence is an application concern. Solutions carry their score components so they can be stored with each schedule version.
• The solver is an exact search with a time limit. It is not yet tested on production-scale instances, so evaluate it on your own data before relying on it.

How the docs are organised

• Getting started: install the crate and solve a first problem.
• Guides: the scheduling DSL, calendars and availability, relations and scores, booking single activities, analysis and repair.
• Concepts: how schedulr builds on unifier.
• Reference: API overview and the conflicts and errors schedulr reports. Item-level documentation lives on docs.rs.