Wings: With Wings, You Never Walk Alone

Demo: Walkthrough (Updated 6/12/2021)

**Note: The map settings on the right is shown to display how to imitate a user's current location!

Table of Contents

1. Overview
2. Product Spec
3. Wireframes
4. Schema

Overview:

Description

Due to the recent rise of hate-crimes, the risk of public danger has significantly escalated for the general population. In addition to this, with the slow integration of in-person activities during the pandemic, countless college campuses are preparing for a large percentage of in-person courses. With both the growth of potential harm and actual public population (especially that of college campuses), Wings inspired to help provide a safer commmunity in these uncertain times.

Wings is an Android application that connects users to others when they feel unsafe in their current conditions.

Users who are connected are confirmed to be safe "walking buddies" for each other, and are intended to walk together to some common, agreed upon destination. However, Wings intends to offer multiple ways to provide trusted safety sources such as: immediate connection to the police, one button notifcation to emrgency contacts, routing to the nearest registered safe spaces. Several safety precautions are taken during this pairing of users. Wings constantly tracks both users and saves real time information in a real time database. Both users' emergency information are held and and may be contacted at any time, even without a pairing to another user. Users may also choose to leave their buddy at any time.

App Evaluation:

• Category: Safety
• Mobile: The app's function relies on the user's ability to move and be tracked. The app will utilize a user's location, display urgent notifications, and display relative map views. The programm cannot be used on immobile devices.
• Story: With the recent rise of hate-crimes, the app was developed to promote safety and community unity. The app can be useful to several demographics and provides a safer aspect of travel for all users. Because of its potential universal use, the app may be well responded to and spread easily.
• Market: The app is potentially marketable to all people who feel unsafe traveling by themself. However, the app will cater specifically to Cal Poly Pomona students for now. Later, the app may be expanded to work on several college campuses as well.
• Habit: The app is very habitual and can be used daily if need be. Users may feel unsafe at any time of the day, and therefore the app can be handy in all such situations. Users only comsume the app, there is currently no plans to allow user creativity.
• Scope: Wings will be pretty wide, as it will contain many safety feautures and location matching. There is a lot of room to expand to include various other features. Currently the stripped down version is still interesting to build but would not be very secure and safe to use.

Product Specifications:

1. User Stories (Required and Optional)

Required Must-have Stories

• [x] User can register a new account.
• [x] User can login and log off.
• [x] User can view their own profiles and other users' profiles
• [x] User is shown all possible buddies.
• [x] User can send, receive, and respond to multiple Buddy Requests.
• [x] User can set a marker on the map to determine the common destination for both Buddies to walk together towards.
• [x] User can verify their Buddy via PIN, assigned ID numbers, and profile pictures.
• [x] User can confirm via PIN when they've safely arrived at their destination.
• [x] User can input their intended destination on a map.
• [x] Users are tracked while on a Buddy Trip.
• [x] Users must be within 15 meters of their destination or meetup location before being able to confirm to the next step.
• [x] User can search for other users.
• [x] User can set up their Trusted Contacts with a max. of 5 contacts.
• [x] User can cancel the Buddy Trip at any time.
• [x] Buddy Trips and Meetups must be completed within a given lenient ETA. The ETA may be extended with the consent + confirmation of both Buddies.
• [x] User can see the most current information about the Buddy Trip at any time.
• [x] User can use the Safety Toolkit to notify Trusted Contacts at ANY time (during or not during a Buddy Trip):
  • [x] Safety Toolkit can only be used with confirmation of PIN.
  • [x] User can choose from two options in the Safety Toolkit: (1) Notify Trusted Contacts or (2) Immediate emergency:
    • User can choose the Notify Trusted Contacts option to automatically send texts of relevant information to all their saved Trusted Contacts. It is used when the user feels unsafe but is NOT in immediate danger.
    • User can choose the Immediate emergency option in the case that they need immediate help. Automatic dialing of police and automatic texts sent to all Trusted Contacts with urgent messages.
  • [x] All applicable relevant information is sent: All Buddies' current locations, intended destinations, their Buddy's general information, all other contacted Trusted Contacts
  • [ ] All sent locations via text message always shows real time locations.
  • [x] After being invoked, Safety Toolkit waits for the user to confirm their safety once again via PIN, and then automatically sends all Trusted Contacts an updated message of their safety.
  • [x] If the user has NOT confirmed safety after reaching their destination and after a lenient time period, Safety Toolkit notifies/updates all Trusted Contacts.
• [x] Buddies can rate and review each other after a Buddy Trip.
• [ ] Users are banned if their rating is too low.

Optional Nice-to-have Stories

• [ ] Different modes of buddying up:
  • [ ] User can choose to be "able to be a Buddy" when not in need of a Buddy themself.
  • [ ] User can choose to be a Solo Walker, where they walk to their destination on their own but is still open to being paired with a Buddy (i.e still receiving Buddy Requests).
• [ ] User can add friends.
• [ ] User can view friend list.
• [ ] Users can chat with their Buddies.
• [ ] User can request to chat with other users.
• [ ] Buddying can be extended to groups.
• [ ] The user is shown best matched possible buddies first.
• [ ] Filters are available when a user searches through a list of possible buddies.
• [ ] Users can choose to receive notifications when there is a new possible buddy.
• [ ] Users are shown the nearest registered safe spaces.
• [ ] Users can report suspicious areas/activity.

2. Screen Archetypes

• Login
  • User can login
• Register
  • User can register a new account.
  • User can go back to login screen
• Create Profile
  • User can customize their profile
• Profile
  • User can view their own information
  • User can log out
• Map-View
  • User can input their destination to create a buddy request
  • Buddy Pairs are required to confirm a route on the map to follow.
• Stream
  • User is shown all possible buddies
  • User can search for other users.

3. Navigation

Tab Navigation (Tab to Screen)

• Home Screen
• Buddy Request Screen
• Profile Screen
• Contact list Screen

Flow Navigation (Screen to Screen) Login

• Map-View
• Register
  • Register
• Map-View
• Login
  • Profile
  • Map-View
  • Stream
  • Map-View (Home Screen)
  • Stream
  • Profile
  • Stream (Create buddy request Screen)
  • Profile
  • Map-View

Wireframes:

[BONUS] Digital Wireframes & Mockups

https://www.figma.com/file/FvkFBW65HVYdpSDwqsKRMM/Wings?node-id=0%3A1

[BONUS] Interactive Prototype

https://www.figma.com/proto/FvkFBW65HVYdpSDwqsKRMM/Wings?node-id=4%3A8&scaling=scale-down&page-id=0%3A1

Schema

Models

Networking

List of network requests by screen

• Login screen

  • (Read/GET) Request to login
    

    
        @Override
        public void done(ParseUser user, ParseException e) {
            if(user != null){
                Log.d(DEBUG_TAG, "Login Success!!");
                loginSuccess();
            }
    }

• Register #2 screen:

  • (Create/POST) Create new User
    

    
    user.setEmail(email);
    user.setPassword(password);
    user.setUsername(username); 

• Profile Setup screen and Settings screen:

  • (Update/POST) User's email, username, password, or PIN
    Parse.getCurrentUser().setEmail(email); Parse.getCurrentUser().setUsername(username); Parse.getCurrentUser().setPIN(pin);

• Home screen:

  • (Read/GET): BuddyTrip’s calculated EST
    

    
    query.whereEqualTo(BuddyTrip.KEY_USER, Parse.getCurrentUser())

• Edit Trusted Contacts Screen:

  • (Update/PUT) User’s attribute: Trusted Contacts list
    Parse.getCurrentUser().setTrustedContacts(list);

• Search user screen:

  • (Read/GET) Query for a user given String username inputted
    

    
    query.whereEqualTo(User.KEY_USERNAME, input);

• Choose Buddy screen:

  • (Read/GET) All Buddies who’s current location is X distance away
    

    
     query.whereEqualTo(Buddy.KEY_CURRLOC, Parse.getCurrentUser().getLocation + X);

  • (Read/GET) All User’s who’s “Able to be a Buddy” is on
    

    
     query.whereEqualTo(Buddy.KEY_CANBUDDY, true;