vic3e / quandoo

Table Reservation Android Application Assigned by Quandoo GmbH

Quandoo Application

This repository holds the source code of the Quandoo Application, a simple Android Application for Table reservation. This application was created by Mohsen Mirhoseini Argi, as part of the technical assessment by the Quandoo GmbH team.

---

What is this repository for?

• Quandoo Application

•   Version:  1.0
  

• Last Update: Mon Oct 24, 2016

---

Development Tools

• Android Studio v2.2.1
• gradle-plugin v2.2.1
• Android SDK Build Tools v24.0.3
• MinSdkVersion 9
• CompileSDKVersion 24

---

Dependencies

• Android Support Tools (recyclerView, cardView, vector, palette,... ) v24.2.1
• Retrofit v2.1.0
• Okhttp v3.4.1
• Dagger v2.4
• RxJava v1.1.9
• RxAndroid v1.2.1
• Butterknife v8.0.1
• Timber v4.1.2
• OrmLite v5.0
• Firebase v9.6.1
• AndroidUtils v1.0.1
• jUnit v4.12
• Android Support Test v0.5
• Mockito v1.10.19
• Robolectric v3.1.1
• Espresso v2.2.2

---

Important Notes

The application has two Activities, Main and Tables Activities. The Main Activity is consist of one Fragment, Customers Fragment, which is responsible for loading Customers List and Searching for a Customer. The Tables Activity contains of one Fragment, Tables Fragment, which is responsible for loading Tables data and presenting Tables reservation states and Booking.

All activity lifecycle and network behaviours are implemented, and according to device size and network situation user get a good UI and UX. In case having update cache data, app do not call Network. If no internet connection or network error, a dialog pops up and ask user to turn on network connection or retry.

Also used a simple Alarm Manager to handle Bookings clear every 10 min.

Some simple Test Cases was designed to test application UI functionality and core classes using jUnit and AndroidUnitTest.

Application Structure

The Application implemented and structured bases on the MVP pattern best practice, contributed by Antonio Leiva.

Whole application functionality is implemented in "Core-Lib" module using pure Java, and .the "App" module contain all codes required for Android Application to load on Android OS, which can be replace by any other interface (e.g. console app or web app)

The view, Main and Tables Activities, contain two fragments. Customers and Tables fragments both contain their own presenter and implement View interfaces and the only thing that the view will do is calling a method from the presenter every time there is an interface action.

The presenter, Customer and Tables Presenters, are responsible to act as the middle man between views and models. They retrieves data from the Model or Database and returns it formatted to the view. It also decides what happens when user interact with the view.

The models, Customer and Table Interactors, would only be the gateway to the service domain layer or business logic. In this case it provide the data needed to be displayed in the view from Network.

The networking and API call are managed by Retrofit and OkHttp as its httpclient, contributed by Square. It also shows decent logs while application is running in Debug mode.

Caching Customers and Tables data is done using OrmLite, a Lightweight Object Relational Mapping (ORM) Java Package. Database layer can also be done using other ORM libraries like realm or DBFlow.

Layers communications are managed by RxJava & RxAndroid contributed by ReactiveX.

Dependency Injections are being managed by Dagger created by Square and now maintained by Google.

Some minor Android common functions are managed using AndroidUtils library, developed and published on jCenter by myself.

Whole projects Dependencies are placed in "libraries.gradle" to avoid version conflicts and redundant in different modules.

Used new DataBinding library contributed by Google in Adapters for faster development.

The Android Log system is replaced with Timber contributed by Jake Wharton, which avoid logging in release version.

Used new SupportVector library in some icons cases for a better UI.

Used new Google Firebase as application Analytics and CrashReport services.

Sample test cases are implemented by mockito, espresso, robolectric and mocking dagger.

Finally, used circleci and travis ci as Continues Integration services which are bind with Github repo.