LocoQuest is an Android app that offers an interactive scavenger hunt experience using your device's geolocation capabilities. With LocoQuest, you can:
- Explore new places and take on a unique scavenger hunt by finding hidden treasures
- Bechmarks utilized by National Geodetric Survey (NGS).
- Use benchmarks to provide a reference point for mapping and surveying
- Enjoy a fun and educational way to explore the world around you
Explore LocoQuest and start your adventure today!
Given I've already authorized permissions for the app to use my device's geolocation capabilities within Android, When I open LocoQuest from a clean-state and get sent to the "landing page," also known as the map, Then geolocation shall be activated and display my current location on my device, so that I can find my current location and start my scavenger hunt.
Given there is a benchmark that I visited on my device, When I open my profile on LocoQuest, Then the profile side of the app shall display the completed benchmarks.
Given that I have logged into a profile on the application, When I can access it in the profile section of application, Then I am able to edit my name within the application.
- UserActivity, MainViewModel, MainActivity, ContextAwareViewModel, and BenchmarkInfoActivity are all related to the user interface of the app. They are responsible for displaying information to the user and receiving input from them.
- RetrofitClientInstance is a class used to make HTTP requests to a server using the Retrofit library.
- Benchmark.kt, LocationDetails.kt, User.kt, and Photo.kt are data transfer objects (DTOs) used to represent data that is being sent or received by the app.
- IBenchmarkDAO and ILocalBenchmarkDAO are interfaces related to data access. They define the contract for accessing benchmark data from different sources.
- BenchmarkDatabase is a class that represents a local database used by the app to store benchmark data. It is implemented using the Room library.
- BenchmarkService.kt is a class that provides a service related to benchmarks. It interacts with a remote server to retrieve or update benchmark data. -RoomDatabase is a class provided by the Android framework that is used to create and manage local databases. It is used as the underlying implementation for BenchmarkDatabase.
Product Backlog
Milestones and Tasks for Sprint 1
- Allow the user, when they open the app, to the see the map right away so that they can interact with it despite not being logged in
- Implement JSON data of benchmarks from NGS to allow for Scavenging item and location parsing functionality
- Implement Firebase to allow user to register/login and view profile and history
- Design app through revisioned design document
Tasked Stories for Sprint 1
- https://github.com/users/lh1207/projects/3/
- https://github.com/users/lh1207/projects/8/
- https://github.com/users/lh1207/projects/6/
- https://github.com/users/lh1207/projects/9/
Milestones and Tasks for Sprint 2
- Implement Geolocation as soon as user grants permissions and opens app
- Alert user when geo-location and or internet capabilities have been lost
- Add benchmarks on the map
- Assuming geo-location is granted, show user's current location
Tasked Stories for Sprint 2
- https://github.com/users/lh1207/projects/4/views/2
- https://github.com/users/lh1207/projects/7/views/1
- https://github.com/users/lh1207/projects/10/views/1
- https://github.com/users/lh1207/projects/11/views/1
Milestones and Tasks for Sprint 3:
- Implement logic to show all benchmarks on the map
- Add a toggle button to switch between GPS route and benchmark location on the map
- Create a list of completed benchmarks and add functionality to add/remove benchmarks from the list
- Create a user profile page with basic user information and the ability to edit/update the profile
- Integrate the completed benchmarks list and user profile page with Firebase
Tasked Stories for Sprint 3
- https://github.com/users/lh1207/projects/14/views/1
- https://github.com/users/lh1207/projects/15/views/1
- https://github.com/users/lh1207/projects/16/views/1
- https://github.com/users/lh1207/projects/17/views/1
- https://github.com/users/lh1207/projects/18/views/1
Scrum Roles, and who will fill those roles
- Product Owner: Eric Miller
- Scrum Master: Sam Dappen
- Development Team: Levi Huff, Derrick Adkins, and William Bohman
The LocoQuest team gets together weekly at Sunday 6pm EST on Microsoft Teams