salk_lesson_scheduler
♥Cherished
A constraint satisfaction solver that generates weekly music lesson schedules for 22 student groups while rotating which academic classes students miss, ensuring fairness across a complex two-day rotating school calendar. Built as a browser-based static app with comprehensive test coverage including bias analysis to validate scheduling equity.
Clauded With Love Rating
8.9 / 10
A constraint satisfaction solver that generates fair music lesson schedules for 22 student groups while rotating which academic classes they miss, built for Jonas E. Salk Middle School's complex two-day rotating calendar system. The project includes comprehensive testing with bias analysis, statistical fairness validation, and runs as a zero-dependency browser-based static app.
Code Quality8.7
Usefulness9.2
Claude Usage8.9
Documentation9.1
Originality8.4
Highlights
- ✓Sophisticated constraint satisfaction problem with 28-day period spacing rules that requires lookahead scheduling to avoid dead-end states
- ✓Comprehensive test suite including 162 torture test scenarios, bias analysis across 100+ schedules, and statistical fairness validation with HTML reports
- ✓Clean architecture with separation between core scheduling logic, constraint validation, and UI, plus zero-dependency deployment as a static web app
To Improve
- →Add visual calendar view in the web interface to help users understand the two-day rotating cycle and see schedule conflicts more intuitively
- →Implement schedule export functionality (CSV, PDF, or calendar integration) to make the generated schedules practically usable by school administrators
Language