Skip to content

Full-stack web platform providing personalized study spot recommendations for UW students. Through an interactive survey, users specify preferences for noise level, busyness, power outlets, and nearby amenities. The system then recommends study spots with live data and displays them on an interactive Mapbox-powered campus map.

Notifications You must be signed in to change notification settings

gsfaigan/uwdialed

Repository files navigation

UWDialed

Discover Your Perfect Study Spot at the University of Waterloo

React Flask MySQL Mapbox

A web application helping UW students find their ideal study spots across campus

FeaturesTech StackHighlightsDocumentation


About

UWDialed is a comprehensive web application designed to help University of Waterloo students discover the perfect study spots across campus. By combining intelligent recommendation algorithms with an interactive campus map, UWDialed makes finding your ideal study environment effortless.

Whether you're looking for a quiet corner for focused work, a collaborative space with power outlets, or a spot near food options, UWDialed personalizes your search based on your preferences and study habits.


Features

Personalized Recommendations

Complete a quick survey about your study preferences, and our intelligent recommendation engine will suggest the top study spots that match your needs perfectly.

Interactive Campus Map

Explore study spots visually on an interactive Mapbox-powered map with precise locations and detailed markers, making it easy to navigate campus and find your next study destination.

Precise Filtering & Sorting

Powerful filtering options to find exactly what you need:

Filter Type Options
Busyness Level 1/5 to 5/5 scale
Noise Level Quiet, Moderate, Active
Power Outlets Available, Limited, None
Food & Drink Cafeteria, Vending Machines, None
Natural Lighting Bright, Some, Low

Sort by name, busyness (ascending/descending), or noise level to customize your search.

Community Reviews

Read and write reviews for study spots to help fellow students make informed decisions. Share your experiences, rate locations, and discover hidden gems across campus.


Tech Stack

Frontend

React Mapbox GL Axios React Router

Backend

Flask Python PyMySQL

Database & APIs

MySQL Mapbox API


Key Highlights

Metric Value
Study Spots 20+ locations across campus
Test Coverage 94% code coverage (51 test cases)
API Endpoints 7 RESTful endpoints
Team Size 5 developers
Development 4 agile sprints
Sprint Completion 100% completion rate

Project Achievements

  • Comprehensive Testing: 51 test cases covering all backend functionality
  • High Code Quality: 94% code coverage, exceeding the 70% requirement by 24%
  • Full-Stack Implementation: Complete React frontend with Flask backend
  • Agile Development: Successfully completed 4 sprints following SDLC
  • Production Ready: Deployed and live on Vercel

Development Team

This project was developed collaboratively by a team of 5 students following:

  • Agile Development practices with sprint planning and retrospectives
  • Software Development Life Cycle (SDLC) methodology
  • 4 sprints with consistent 100% completion rates
  • Git-based collaboration with proper version control

Project Documentation

Document Description
User Manual Detailed user instructions and guide
Project Charter Project scope, objectives, and timeline
Test Report Testing details and 94% coverage report
API Documentation Complete API endpoint reference

Project Goals

UWDialed was created with the following objectives:

  • Save Time: Help students quickly find suitable study locations
  • Enhance Experience: Improve academic experience, especially for first-year students
  • Data-Driven: Provide recommendations based on real campus information
  • Community: Create a platform for shared experiences through reviews

Built with ❤️ for the University of Waterloo community


Made by project_team_01 - SE101 Fall 2025

About

Full-stack web platform providing personalized study spot recommendations for UW students. Through an interactive survey, users specify preferences for noise level, busyness, power outlets, and nearby amenities. The system then recommends study spots with live data and displays them on an interactive Mapbox-powered campus map.

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •