Skip to content

This is an awesome Android app that allows users to find fast food or convenience stores near where they're standing. In addition, this app allows users to do other fantastic things.

License

Notifications You must be signed in to change notification settings

nhoxbypass/FastFoodFinder

Repository files navigation

CoderSchool Final Project - Fastfood Finder

Build Status codecov Codacy Badge

Fastfood Finder is an awesome Android app that allows users to find fast food or convenience stores near where they're standing. In addition, this app allows users to do other fantastic things.

The source code is well-programmed with MVP architecture, SOLID principle & lots of design patterns.

Well-unit-tested with JUnit, Mockito, PowerMock.

Time spent: 180 hours spent in total

User Stories

The basic required functionality:

  • Show the splash screen and do the robust check for Internet connection.
  • Locate the current user's position using GPS or 3g Wi-Fi. If it cannot detect the user's location, it will get the user's past location.
  • Show the top 10 nearest stores by marking on the maps in the first tab.
  • Show list of 10 nearest stores in bottom sheet below the map, sort ascending by the distance from user to this store. Users can click on each item to show the way to this store (routing).
  • Swipe to "recent" tab. Show the recently tab that searched or selected by user.
  • Have a button to quickly show the nearest store base on user settings
  • If the user has logged in, the user can swipe to the "Favourite" tab to show a list of stores that the user visited and favourite.
  • User can filter stores that display in map by pressing the filter icon in Toolbar, and fulfill the Filter dialog.
  • User can click on a store in the map to show the basic detail, overview of this store to determine to go or choose another store.
  • User can navigate to other activity to see the list of district, and some advanced filter. Users can select and see the list of stores that fit their needs.

The extended features are implemented:

  • User can toggle navigation drawer to see their profile. If the user is not logged in. They can log in by email, Gmail, or Facebook.
  • User can toggle the navigation drawer to select "Last visit", "Profile Detail", "Favourite list", "Settings", etc.
  • Update to newest stores data, user can routing event dont have Internet
  • User can search for store name, addresses,... in the search view in toolbar

The advance features are implemented:

  • User can add new place that they liked
  • Sort stores based on location. Type of store.
  • User can sit at home and choose a specified location (use pin of google maps or lat/long) to list the store nearest.
  • User can place orders and wait for their food to be shipped to their home. (If stores provided this service)

Video Walkthrough

Here's a walkthrough of implemented user stories:

https://www.youtube.com/watch?v=QSXAEoJX9t8

Notes

Describe any challenges encountered while building the app.

Libraries used

  • Retrofit - A type-safe HTTP client for Android and Java
  • Glide - An image loading and caching library for Android
  • WorkManager - Makes it easy to schedule deferrable, asynchronous tasks that are expected to run even if the app exits or device restarts.
  • RxJava2 - Reactive Extensions for the JVM – a library for composing asynchronous and event-based programs using observable sequences for the Java VM.
  • EventBus - Event bus for Android and Java that simplifies communication between Activities, Fragments, Threads, Services, etc. Less code, better quality.
  • Realm - BUILD BETTER APPS FASTER™

License

Copyright 2016 4TripleF

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

This is an awesome Android app that allows users to find fast food or convenience stores near where they're standing. In addition, this app allows users to do other fantastic things.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •