Scheduling App

This is a workforce scheduling project for operations-heavy teams, with a focus on environments like senior care communities. The goal is to map people with different roles and skills into shift-based schedules, then let managers adjust staffing through plain-language chat commands.

Project scope

• Define staffing needs by shift and day.
• Auto-fill schedules based on role requirements and team availability.
• Replace assigned people and automatically fill the resulting gaps.
• Provide a clear schedule view so teams can review the plan.
• Use a chat-first workflow instead of traditional action buttons.

Planning and delivery trace

Implementation planning and execution were documented in knowledge/ to make the delivery auditable and easy to follow.

• Planning files:
  • knowledge/plans/BACKEND.md
  • knowledge/plans/DATABASE.md
  • knowledge/plans/FRONTEND.md
• Timeline of work:
  • knowledge/TIMELINE.md

Execution used the Superpowers + Amplifiers workflow, with decisions and milestones recorded in the timeline for continuous tracking.

Tech stack

• Backend: Express + TypeScript
• Frontend: Next.js (React + TypeScript)
• Repository layout: backend/ and frontend/

Quick start

From main/:

make dev

This command:

• ensures environment files exist (backend/.env and frontend/.env.local)
• installs dependencies if node_modules is missing
• starts backend and frontend together

Useful commands

make help
make env
make install
make backend
make frontend
make dev

Collaboration docs

• CODE_OF_CONDUCT.md
• CONTRIBUTING.md
• SECURITY.md