Skip to content

nyorojames/LaundryAppointmentSystem

Repository files navigation

University Laundry Appointment System

A full-stack ASP.NET Core MVC application for managing laundry facility bookings in university dormitories.

Key Features

For Students

  • Smart booking flow for available machines and timeslots.
  • Validation for past dates, closed Sundays, and already-passed timeslots for today.
  • Fair usage policy limiting students to 3 active bookings.
  • Booking dashboard with cancellation support.

For Admins

  • Dashboard with booking and machine status summaries.
  • Machine management for washers and dryers.
  • Safety checks that block deleting or deactivating machines with booking history or active future bookings.
  • User management with role-based access.
  • Timeslot management for operating hours.

Technology Stack

  • Framework: ASP.NET Core 8.0 MVC
  • Database: Entity Framework Core (SQL Server)
  • Auth: ASP.NET Core Identity (Role-based Authorization)
  • Frontend: Bootstrap 5, Razor Views

How to Run Locally

  1. Clone the repository
    git clone https://github.com/nyorojames/LaundryAppointmentSystem.git
  2. Update Database The project uses Entity Framework Code First. Open the Package Manager Console in Visual Studio and run:
    update-database
  3. Run the Project Press F5 or run via CLI:
    dotnet run
  4. Default Credentials
    • Upon first run, you may need to register a user or seed the database depending on the configuration.

📸 Screenshots

Screenshot 2026-01-19 105851 Screenshot 2026-01-19 105830 Screenshot 2026-01-19 105917 Screenshot 2026-01-19 105938 Screenshot 2026-01-19 105955

About

Digitized manual dorm laundry booking process, replacing paper sign-up sheets with a full-stack web system.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages