Shamba App

• Shamba App is an AgriTech Android app with the following solution features for the farmer:)
  • Hire Farm Equipments Feature
  • Apply and Pay for Crop Insurance
  • Crop cycle : crop management
  • Access to AgriTrends
  • Chat With Farm Experts
  • A GPS smartphone enabled to pinpoint their farmers' farm location
  • Track nearby AgriTech Companies
  • Predict Their farm production via an integrated Machine Learning Algorithm (Linear regression)
  • Reach a ready market for their produce to maximize their profits

Screens

Tech Stack & Concepts

• • Kotlin - a cross-platform, statically typed, general-purpose programming language with type inference.
  • Coroutines - perform background operations.
  • Flow - handle the stream of data asynchronously that executes sequentially.
  • Dagger hilt - a pragmatic lightweight dependency injection framework.

  • Logging Interceptor - logs HTTP requests and responses data messages and lines and their headers based on their level

  • MVVM- MVVM stands for Model, View, ViewModel. Model: This holds the data of the application. It cannot directly talk to the View. Generally, it's recommended to expose the data to the ViewModel through Observables.

    • Room database - The Room persistence library provides an abstraction layer over SQLite to allow fluent database access while harnessing the full power of SQLite.

  • Kotlin Coroutines - A concurrency design pattern that you can use on Android to simplify code that executes asynchronously.

  • Retrofit - Retrofit is a REST client for Java/ Kotlin and Android by Square inc under Apache 2.0 license. Its a simple network library that is used for network transactions. By using this library we can seamlessly capture JSON response from web service/web API.

  • GSON - JSON Parser,used to parse requests on the data layer for Entities and understands Kotlin non-nullable and default parameters.

  • Network bound resource - An algorithm that provides an easy function to fetch resource from both database and network

    • Jetpack
      • Room - a persistence library provides an abstraction layer over SQLite.
      • LiveData - is an observable data holder.
      • Lifecycle - perform action when lifecycle state changes.
      • ViewModel - store and manage UI-related data in a lifecycle conscious way.

  • Lottie Animations - The lottie-android library provides a LottieAnimationView which will take care of rendering your animations for you. Add it to your layouts where you want to place your animations.

  • Google Map Services- Maps data, map displays, and map gesture responses. You can also provide additional information for map locations and support user interaction by adding markers, polygons, and overlays to your map.

  • Linear Regression Algorithm - Linear regression algorithm shows a linear relationship between a dependent (y) and one or more independent (y) variables

Payment Integration Gateways

• Mpesa-Daraja-API

DevOps Tool

• Circle CI

To Run this App, it's available on Appetize.io

UX Designs Urls

UX designs are meant to translate the idea or concept of the project into a working prototype

1. Link 1
2. Link 2

Important To Note

• CI CD tool is failing
• The App not work exactly as per user preferences but its performance can be improved
• It is a minimum viable product

TODO

• - Authentication using POST BACKEND APIs
• - Configure CI CD workflow

Issues to Address

When using backend post apis, i encounter SocketException that is D/OkHttp: <-- HTTP FAILED: java.net.SocketException: Socket closed

Found something to add? Contributions are welcome :)

MIT License

Copyright (c) 2023 Stephen Muindi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.