Shift Management System | Create shifts from preferences, required personnel, 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 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 requested days off, hours outside preferences, overlaps, excessive work hours, consecutive work days, etc.
• State Transitions: Staged confirmation flow: Draft → Review → Confirmed → Published
• Audit Logging: Record in append-only format 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
• Staff allocation across multiple time slots (lunch period, afternoon period, 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 consisting of in-browser demo (localStorage restoration) and Cloudflare D1 API. Automatically falls back to local demo when connection is unavailable.