The app fetches a list of farmers from the network using the Retrofit library and displays the list using a RecyclerView. The app's architecture is a clean architecture, Single Activity and follows a typical MVVM pattern where all the complexity of the View is deferred to a ViewModel. The app uses ViewModel and LiveData to hold the data and update the UI.
The app is an online application, so the user needs a network connection to use it. However, i've implement offline caching to display results from the local database, instead of from the network. This way you will be able to use the app while your device is offline, or if you have a slow network connection.
To implement the offline cache, Room database was used to make fetched data persistent in the device's local storage. You access and manage the Room database using a repository pattern, which is a design pattern that isolates data sources from the rest of the app. This technique provides a clean API for the rest of the app to use for accessing the data.
-
Download the project by cloning this repository or downloading an archived snapshot. (See Installation)
-
In Android Studio, click the "Open an existing Android Studio project" or "Import Project" option.
-
Select the
Telleriumdirectory that you downloaded with this repository.
Clone this repository and import into Android Studio
https://github.com/clevmania/Tellerium.gitThe app consists of 7 flows
-
Register: A user registers by providing some required personal information
-
Login: A user can login using credentials provided during registration
-
Farmer: Displays a list of all farmers
-
Farmer Detail: Is provides a comprehensive breakdown of a particular farmer, categorised as Personal, Identity and Farm
-
Dashboard: Gives analytics on captured farms and farmers
-
Update: Capture a farm, Update personal farmer record
Sensitive key should not be in source control but i've added a key for the purposes of this assessment.