User Stories for Mobile App

[joebeernink]

TrashMob.eco Mobile App User Stories

User opens app

• User sees screen with information about TrashMob.eco and link to website
• User sees a running total of the number of events, number of bags of litter picked by all volunteers, and total hours contributed by volunteers to date, number of litter reports filed, number of litter reports cleaned up
• User can select button to sign in to app

User can sign in

• User can sign in to the app using the same Azure AD B2C tenants used by the Dev and Prod Websites
• The first time a user logs in to the mobile app, check to see if they have set a preferred location (may have done it through the website).
• If they have, continue on to home screen
• If they haven't check to see when was the last check status was.
  -- If more than 30 days, ask again.
  -- If less than 30 days, skip to home screen

User can sign out

• If the user is signed in, they should have the option to sign out
• After signing out, they are taken back to the welcome screen

User sees home screen

• user sees their stats
  -- number of events attended
  -- number of bags picked
  -- number of hours contributed

• User sees options:
  -- Update their preferred location
  -- Create a new event
  -- Create a litter report
  -- Invite others to use trashmob.eco (social media share)
  -- View their dashboard
  -- View litter reports

• User sees map of upcoming events in their area if location preference is set / world if not

User can update their preferred location

• Allow the user to set a location by clicking on a map, or cancel setting it.
  -- If they select cancel, and have a location already set, return to home screen
  -- If they select cancel, and have no location already set, update the last check status to current date.
  -- If they click on the map, store that to the database if they then click ok

User can see a list of upcoming events

• User can see a list of events
• User can filter to show upcoming events only (default) or all events including completed ones
• User can filter the events displayed by selecting a country, a state/region, city
  -- Country must be selected first.
  -- Only countries that have upcoming events should be shown
  -- Once the country has been selected, show list of states/regions for that country that have upcoming events
  -- Once the state/region has been selected, show list of cities with upcoming events for those states/regions
  -- User can select one of the events to view details of that event

User can see a map of upcoming events

• User can see a map displaying pins of all upcoming events for the selected area
• Selecting a pin shows details for the event (See Event Details section below)

User can view Event Details

• if the event is in the future
  -- User can see
  --- Event Name
  --- Event Date/Time
  --- Event Location (Street Address, City, State/Region, Country, Postal Code)
  --- Max Number of Attendees
  -- User can
  --- Register for the event if they are not attending already / aren't event lead
  --- Unregister for the event if they are already registered and not event lead
  --- Cancel Event if they are event lead
  --- Update Event if they are are event lead (See below)
  --- Share on social media

• if the event is in the past
  -- User can see
  --- Event Name
  --- Event Date/Time
  --- Event Location (Street Address, City, State/Region, Country, Postal Code)
  --- Number of Attendees
  --- Number of Bags Picked
  --- Length of the pick in minutes
  -- User can
  --- Update Event Summary if they are are event lead (See below)
  --- Share Summary on social media

User can submit a litter report

• User opens create a new trash report screen
  -- User clicks button to take picture of a littered area
  -- User can add notes to the report
  -- Picture is geo-tagged and uploaded to TrashMob.eco
  -- User is thanked for their submission
  -- User can share report on social media
  -- User is taken back to home page

User can see litter reports

• User can chose list or map
• If user chooses list
  -- User can see a list of all litter reports that are active
  --- List shows location and thumbnail of picture, and a button to show more details
  -- User can reduce the number of report displayed by selecting a country, a state/region, city
  -- Country must be selected first.
  -- Only countries that have litter reports should be shown
  -- Once the country has been selected, show list of states/regions for that country that have litter reports
  -- Once the state/region has been selected, show list of cities with litter reports for those states/regions
  -- User can select an entry for more details
• If user chooses map
  -- show a pin for each report on the map
  -- allow user to click on a pin to select the report

User views individual litter report

• Report shows
  -- Location
  -- Image
• User can
  -- return to list/map
  -- Create cleanup event for this report
  -- If they are the creator of this report, they can delete it or mark it cleaned up
  -- Share litter report on social media (See social media sharing)

User can create an event to help clean up a trashed area

• User can enter the following data
  -- Enter Event Name
  -- Enter Event Date and Time
  -- Enter Event Type
  -- Event Event Description
  -- Enter Event Location by clicking on map
  -- Enter Event Location by searching for an address
  -- Enter maximum number of attendees (optional)
  -- Enter length of pick in hours / minutes
  -- User can associate 1 to many existing trash reports to a cleanup (system should automatically find and list nearby litter reports that are active and not assigned to other events to be selected)
  -- User can request help from available partners to:
  --- Haul garbage
  --- Dispose of garbage
  --- Supply gear
  --- Provide supplies
  -- After saving the event, the user can post it to social media (See social media sharing)

User who created the event can enter event summary after the event

• After the event has completed, the user can create an event summary report which includes
  -- Number of Attendees
  -- Number of Bags picked
  -- Duration of pick
• User can add photos of trash piles to be picked up and send to hauling partner with Geo-tagged locations
• User can mark the associated trash reports as cleaned up (or not if they didn't get to them)
• User can send out event summary posts their social media channels (See social media sharing)

Social Media Sharing

• Users should be able to share events, event summaries, litter reports, TrashMob.eco site invites with their social media networks, including
  -- Email
  --Facebook
  -- LinkedIn
  -- Twitter/X
  -- Bluesky
  -- Instagram
  -- WhatsApp
• Sharing sample text should included relevant details about the event/report with actionable links back to TrashMob.eco

User can see a dashboard of their information:

• How many events have they attended
• How many bags of litter have they picked
• How many hours have they contributed to cleaning up the planet
• How many litter reports have they filed
• How many litter reports have they helped to close
• User can share a report of their cleanup effort totals on social media
• A list of events they are attending in the future
  -- If they are an attendee, they can
  --- Deregister
  --- View Details
  --- Share on social media
  -- If they are the event lead, they can
  --- Edit the event
  --- Cancel the event
  --- View Details
  --- Share on social media
• A list of completed events they have attended / created
  -- If they were an attendee, they can
  --- View event details
  --- View event summary
  --- Share event summary on social media
  -- If they were the event lead, they can
  --- Update the event summary
  --- View Event Details
  --- Share event summary on social media
• Litter reports they have created
  -- If report is not yet completed they can
  --- Mark it cleaned up
  --- Delete it

Notifications

• If the user is an event lead, they can send a note to all other attendees of the event who have the mobile app (fallback to email if they don't)
• Records must be kept of all sent notifications
• If the user has the mobile app installed, they should get an in-app notification / toast (not SMS)

Contact Us

• Allow users to send TrashMob.eco a note