Shift Management System | Create shifts from preferences, required number of people, and constraints

Overview #Personal Development

A web system that treats the entire workflow from employee shift preference submission through administrator confirmation and publication as a single business process. Rather than simply placing people on a calendar, it visualizes the rationale for assignments and issues that need to be verified, with implementation extending to the point where people make final judgments and publish the schedule.

Main Features

• Preference Submission: Employees input and submit work availability, desired days off, preferred hours, and notes from a monthly calendar
• Required Staffing Management: Set required number of staff by day of week and time slot, visualizing staffing fulfillment status
• Automatic Assignment: Generate draft proposals using deterministic greedy algorithm (no AI, explainable assignments)
• Conflict Detection: Automatically detect 9 types of issues including assignments on desired days off, outside preferred hours, overlaps, excessive work hours, consecutive work days, etc.
• State Transitions: Staged confirmation flow: Draft → Review → Confirmed → Published
• Audit Logging: Record append-only who changed which shift slot, when, and how
• No Registration Demo: Experience the full workflow of employees and administrators using 12 fictional staff members with /demo

Applicable Operations

• Shift management for restaurants, retail stores, service industries, etc.
• Staff allocation across multiple time slots (lunch period, afternoon slot, dinner period, etc.)
• Verification of work conditions (maximum work hours, minimum breaks, minimum interval between shifts, maximum consecutive work days)

Technology

Implemented in TypeScript. Two-layer architecture: in-browser demo (localStorage restoration) and Cloudflare D1 API. Automatically falls back to local demo when connection is unavailable.