Skip to content

A web application that recommends places to go or activities to do in Singapore

Notifications You must be signed in to change notification settings

joesurf/sgunchained-repo

Repository files navigation

test github action


Logo

Unchained

A website for recommending activities in Singapore
Explore our documentation »

View Demo

Table of Contents
  1. About The Project
  2. Roadmap
  3. Contact

About The Project

Level of Achievement

Gemini

Project Scope

Brief: Unchained is a web application that seeks to recommend unique experiences for students in Singapore based on how they are currently feeling.

Detailed: Visitors come to the website in search of interesting experiences in Singapore. The website aims to recommend activities that are cheap and easily accessible while being sufficiently novel for students, as most similar sites tend to focus on providing a marketplace and thus expensive activities.

All users will first be directed to a landing page which seeks to understand their current mood or interest. After that, they will recommended a few activities based on their responses, of which they can filter based on various constraints like cost, location and availability.

After the experience, users can write personal notes about the experience which will be saved. They can also rate and comment on each particular activity or share their experience bucket with others. Activities which are not completed can be saved to a wishlist.

Problem Motivation

When you are bored and want to go somewhere or do something exciting, your current alternatives are friends, Google or social media.

However, friends have limited knowledge about the best places to go or the most interesting activities to do. Google tend to provide search results of popular blogs which tend to have recommendations that are tailored toward the masses, that is, generic places or activities. Social media has by far the most interesting options, but sometimes lack key information on how to go to a particular place or how to conduct an activity due to the nature of the content.

But what if you would like to visit some place obscure, or do something extraordinary? What if you simply want a unique experience?

Currently, the closest real-time application of this idea is achieved by klook.com but its business model necessitates that its recommendations and experiences are common tourist attractions and paid activities, as opposed to more simple experiences like going for a picnic at Changi Jewel or catching the sunrise at Upper Seletar Reservoir.

User Stories

User

  • As a user who wants a new experience, I want to be able to find interesting options quickly, subject to various constraints.
  • As a user who is unsure where to start, I want places and activities to be recommended to me based on my past choices and my preferences.
  • As a user who has used the platform, I want to be able to share my experience with others.

Admin

  • As an admin who manages the site, I want to be able to add, update and delete the details of users and activities.

Project Scope

The scope of our Orbital project can be broken down into 3 parts - Setup, Core and Extensions.

Setup - User Registration and Login

Core - Home, Activity and Admin Page

Extensions - Activity Recommendation, Bucket Templates, Social Media Connections

Testing - WIP

Milestone 1 - Setup > User Registration and Login

    1. Frontend Web Routing

      Set up routing for our website from the homepage to profile and activities page.

      Backend API Endpoints & Database

      Set up backend API endpoints and a database for user registration and login.

      Token Authentication

      Set up JSON web tokens to authenticate users.

      Users will be able to register, and upon loggin in, is authenticated and assigned a token. Registration and login is not required to access the core features of the website but will give access to extensions.

  • Milestone 2 - Core > Home, Activity and Admin Page

    1. Home Page - Featured Activities

      Upon visiting the website, users are shown a set of activities which they can scroll through and click on to get more information. Activities shown are randomly generated every time the page is refreshed and limited to 9 only.

      Home Page - Button Filters

      In addition, users can click on the button theme filters which will reveal activities that are associated with that particular theme. Every time a button is clicked, all the buttons will be randomly generated in order to offer a wide variety of themes and also add an element of mystery.

      Profile Page

      Every user will have their own profile page. Here, users can choose to update their name, email and password.

      Bucket Page

      Users can add activities that they are interested in into this page. In addition, they can delete them as well. This is meant to be the confirmation page before users download activity information.

      Bucket Page - Download PDF

      Users can download a cool pamphlet [WIP] that includes more details about the activities they have chosen, including location and duration.

      Admin Page

      Admins are given access to an additional admin page in the navigation bar where they can edit information about users and activities.

      Admin Page - Edit Users

      Admins can see the list of users, update or delete user information at this page.

      Admin Page - Edit Activities

      Admins can see the full list of activities, create, update and delete activities at this page.

  • Milestone 3 - Refinement > Bugs, Edge Features, Testing

    1. Home Page - Activity Info

      Upon hovering each of the activity, a card will slide down with the information of the activity and a button to add the activity to the user's bucket list.

      PDF Design

      A PDF page of the activities that users have saved to their bucket list for reference and sharing.

      Testing

      Conducted system testing to check for usability of core functionality. Conducted user testing to get user feedback.

  • Concept Design

    Entity Relationship Diagram

    Users can create experiences using buckets which is a set of activities they can do. Each bucket can be filled with various activities which are filtered by cost, location and pax. In addition, users can write notes for each experience and download them in a pdf.

    (back to top)

    Built With

    (back to top)

    Roadmap

    Check out the website»

    • User Login and Registration
    • Activities Page
    • Bucket Selection
    • Admin Page
    • Recommendation Feature
    • PDF Download Feature

    (back to top)

    Contact

    Joseph Ong - [email protected]

    Stefanie Sew - [email protected]

    (back to top)

    About

    A web application that recommends places to go or activities to do in Singapore

    Resources

    Stars

    Watchers

    Forks

    Releases

    No releases published

    Packages

    No packages published