Skip to content

Donut-DONationUTile/Donut_Android

Repository files navigation

DONUT_Android APK file Demo Video

“A shilling is the measure of less pleasure, or satisfaction of any kind, to a rich man than to a poor one. The happiness which an additional shilling brings to a poor man is much greater than that which it brings to a rich one.”

- Principles of Economics (8th ed.) PLL v6.0 (generated September, 2011) 16 -


🍩 Overview

Demo Video

DONUT is a sustainable donation platform tailored to the developmental characteristics of adolescents, providing a stigma-free process for beneficiaries.

By utilizing unused resources such as gift vouchers, amounting to 900 million KRW annually in South Korea, it facilitates low-income youth to purchase groceries and essential items.



📂 Table of Contents



🛠️ Project Architecture



DONUT is comprised of a Client Application, Web Server, Database, Storage, and AI Server.

The Client Application is implemented on Android using Kotlin, with the MVVM architecture to separate UI logic from business logic and increase code reusability and scalability. Through various interactions with users, the Client Application forwards requests to the Web Server.

The Web Server processes client requests and can communicate with the AI Server in need. It is implemented based on Spring Boot and utilizes Redis for JWT processing. Both Spring Boot and Redis are deployed in Docker containers via GCP Compute Engine. CI/CD is established using GCP Code Build and Artifact Registry for agile development.

A MySQL 8.0-based GCP Cloud SQL instance serves as the main Database. GCP Cloud Storage is used for the Image bucket, where URLs of inserted objects are stored in the Database.

The AI Model, served by FastAPI, is hosted on a separate VM from the Web Server. It is also deployed using Docker in preparation for utilizing Kubernetes for resource management caused by an increase in the number of users. Low-resolution gift card images forwarded from the Web Server to the AI Server are enhanced to high resolution using TensorFlow’s ESRGAN model and then stored in the GCP Storage bucket. The URLs of the stored objects are also updated in the Database.



⚙️ Android Tech Stacks

Architecture MVVM
Jetpack Components AppCompat, LifeCycles, ViewModel, LiveData, viewPager2, CameraX
library Standard Library, Material Design, Glide, MPAndroidChart
Network OkHttp, Retrofit2, GSON, Coroutine
SDK ML Kit(Text Recogniztion v2), Firebase(Authentication, Cloud Messaging)



🚀 How to Run

Software requirement

  • Android studio Flamingo 2022.2.1
  • compileSdk 34 or higher
  • minSdk 33 or higher

Hardware requirement

  • CameraX supported Android Device within this link (CameraX is supported on most Android devices running Android 5.0 (API level 21) and higher.)

How to Run the Application

  1. Check the requirement above.
  2. Download the APK file on your Android device.
  3. Run the apllication from APK file



✨ How to Use DONUT

About

An android application that protects undernourished children from negative stigma by ensuring that surplus resources(mobile voucher) are donated to them.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages