Project Problem Description
Project Problem Description
Warning: This is subject to change!
Event Lottery System Application
You are to design and implement a simple, attractive, and easy-to-use Android application to satisfy the following goals. Your design must be flexible enough to allow developers to extend or migrate it.
Description:
We want a mobile application where people can sign up for events at community centres that are popular and fill up fast. We want to allow people with limitations such as work, disability, etc. to be able to sign up for these events fairly and not have to sit refreshing a webpage until they can get a chance at reserving a spot.
How? Lottery! If I am running swimming lessons for 20 kids, I will post my event or series of events and I will let everyone join the waiting list for a period of a week. After the week is up, I will ask the system to choose 20 kids to sign up. The system will then notify these kids (or their guardians), if they say no they don’t want swimming lessons, then the system will sample another child to sign up. I can monitor the progress and then get access to the final list of everyone who signs up. If perhaps someone cancels later I can cancel them in the app and a new applicant is drawn.
Lottery systems are great because you don’t have to first get a chance to go to an event, you just have to say you are interested and if you’re lucky you will be offered a chance. This gives people who need the time, the time to sign up properly without a time pressure. Accessibility!
Features:
-
Pooling System:
- Organizers can draw from a waiting list of interested event attendees as selected participants.
-
QR Code Scanning:
- entrants can scan QR promotional code to view details about the event and also join the waiting list
-
Firebase Integration:
- Utilize Firebase for storing event details, attendee lists, and real-time check-in status updates.
-
Multi-User Interaction:
- Distinguish between entrants, organizers, and admin with special roles and privileges granted to each actor.
-
Image Upload:
- Allow event organizers upload event poster image
-
Geolocation Verification (Optional)
- Optionally use geolocation to verify where users are joining the waiting list from. This is the location provided by the device.
Scenario:
-
I want to sign my partner up to swim lessons, they need to learn how to swim if they are going to go canoeing with me. I go to the local rec centre, I see they have listed swimming lessons for beginners, I scan the QR code. I see that it is open to register for 2 more days. I click register. 2 days later when it is closed the system samples people, but not me. It notifies me that I wasn’t sampled in the first draw, but there might be a chance if someone declines. Nobody declines. Boo.
-
I am running an interpretive dance class where I teach the safety basics of dance (no eye gouging, that kind of stuff). I tell the app that I have classes every monday From 2025-01-01 to 2025-03-01, and that you need to register by 2024-12-15 and registration opens on 2024-12-01. The price is $60 and I can accommodate 60 people. I click publish and now an event is made where people can join the waiting list and they get this basic information. Also a QR code is generated that will lead them to this page.
-
I want to sign my partner up to piano lessons, they need to learn how to play if they are going to play piano with me. I go to the app, I go to my local rec centre, I see they have listed piano lessons for beginners, I scan the QR code. I see that it is open to register for 2 more days. I click register. 2 days later when it is closed the system samples people, but not me. It notifies me that I was sample.
Actors:
-
Entrant: a person who signs up for an event
-
Organizer: the entity that runs the event
-
Administrator: The entity that administers and runs the infrastructure
Glossary:
-
QR Code: a scannable code, either a barcode, a QR code, or other code scannable by Zebra crossing libraries or google QR code scanning libraries.
-
Entrant: someone who declares their interest in signing up for an event by joining the waiting list
-
Waiting List: a record of entrants that showed interest in a specific event
-
Sign Up : An action of registering/confirming for an event when successfully selected
- You can think of this like accepting an invitation.
-
Profile : A screen on the application that holds information about an entrant
-
Choosing: Randomly selecting a number of entrants in the waiting list to be invited to sign up
User Stories:
User needs are expressed in the form of partial user stories:
As a (role), I want (goal).
These descriptions may change to correct omissions and clarify noticed issues. New requirements will be introduced for the final project part.
User:
US 01.01.01 As an entrant, I want to join the waiting list for a specific event
US 01.01.02 As an entrant, I want to leave the waiting list for a specific event
US 01.02.01 As an entrant, I want to provide my personal information such as name, email and optional phone number in the app
US 01.02.02 As an entrant I want to update information such as name, email and contact information on my profile
US 01.03.01 As an entrant I want to upload a profile picture for a more personalized experience
US 01.03.02 As an entrant I want remove profile picture if need be
US 01.03.03 As an entrant I want my profile picture to be deterministically generated from my profile name if I haven't uploaded a profile image yet.
US 01.04.01 As an entrant I want to receive notification when chosen from the waiting list (when I "win" the lottery)
US 01.04.02 As an entrant I want to receive notification of not chosen on the app (when I "lose" the lottery)
US 01.04.03 As an entrant I want to opt out of receiving notifications from organizers and admin
US 01.05.01 As an entrant I want another chance to be chosen from the waiting list if a selected user declines an invitation to sign up
US 01.05.02 As an entrant I want to be able to accept the invitation to register/sign up when chosen to participate in an event
US 01.05.03 As an entrant I want to be able to decline an invitation when chosen to participate in an event
US 01.06.01 As an entrant I want to view event details within the app by scanning the promotional QR code
US 01.06.02 As an entrant I want to be able to be sign up for an event by scanning the QR code
US 01.07.01 As an entrant, I want to be identified by my device, so that I don't have to use a username and password
US 01.08.01 As an entrant, I want to be warned before joining a waiting list that requires geolocation.
Organizer:
US 02.01.01 As an organizer I want to create a new event and generate a unique promotional QR code that links to the event description and event poster in the app
US 02.01.02 As an organizer I want to store the generated QR code in my database
US 02.01.03 As an organizer, I want to create and manage my facility profile.
US 02.02.01 As an organizer I want to view the list of entrants who joined my event waiting list
US 02.02.02 As an organizer I want to see on a map where entrants joined my event waiting list from.
US 02.02.03 As an organizer I want to enable or disable the geolocation requirement for my event.
US 02.03.01 As an organizer I want to OPTIONALLY limit the number of entrants who can join my waiting list
US 02.04.01 As an organizer I want to upload an event poster to provide visual information to entrants
US 02.04.02 As an organizer I want to update an event poster to provide visual information to entrants
US 02.05.01 As an organizer I want to send a notification to chosen entrants to sign up for events.
- This is the notification that they "won" the lottery.
US 02.05.02 As an organizer I want to set the system to sample a specified number of attendees to register for the event
US 02.05.03 As an organizer I want to be able to draw a replacement applicant from the pooling system when a previously selected applicant cancels or rejects the invitation
US 02.06.01 As an organizer I want to view a list of all chosen entrants who are invited to apply
US 02.06.02 As an organizer I want to see a list of all the cancelled entrants
US 02.06.03 As an organizer I want to see a final list of entrants who enrolled for the event
US 02.06.04 As an organizer I want to cancel entrants that did not sign up for the event
US 02.07.01 As an organizer I want to send notifications to all entrants on the waiting list
US 02.07.02 As an organizer I want to send notifications to all selected entrants
US 02.07.03 As an organizer I want to send a notification to all cancelled entrants
Admin:
US 03.01.01 As an administrator, I want to be able to remove events.
US 03.02.01 As an administrator, I want to be able to remove profiles.
US 03.03.01 As an administrator, I want to be able to remove images.
US 03.03.02 As an administrator, I want to be able to remove hashed QR code data
US 03.04.01 As an administrator, I want to be able to browse events.
US 03.05.01 As an administrator, I want to be able to browse profiles.
US 03.06.01 As an administrator, I want to be able to browse images.
US 03.07.01 As an administrator I want to remove facilities that violate app policy