Pass-the-Meal

🏆 GDSC 2023 Solution Challenge Global Top 100 Winner 🏆

💻 Project Introduction

A project that means taking care of my meals and taking care of other people's meals with the food expenses users saved. Project name is derived from 'pass the hat' that means to ask a number of people to give money for something.

📱 Youtube Link ➡️ https://www.youtube.com/watch?v=0UTi7BZtnCI

GOALS

1. It solves health and well-being problems by encouraging regular eating habit by analyzing and showing users' meal records.
2. It helps planned consumption by encouraging consumption that fits user's own food budget.
3. It contributes to solving the hunger problem by allowing users to donate their budget savings to underprivileged children.

🕰 Develop Period

• 2023.01 ~ 2023.06

👩‍💻 Members

• Gahyun Lee (Backend, Server) @gahyun02
• Jiu Yang (Frontend) @yang-jiu
• Jungmin Lee (Frontend) @lmin402
• Eunjung Kwon (Frontend) @enjung

📒 Pages

⭐️ Sign in / Sign up

Enter information such as ID and password and press the 'Sign up' and 'Sign in' buttons at the bottom to access the main page.

⭐️ Record Meal

It is a page that manages daily food expenses, and you can record your meal.

⭐️ Chart

This page is composed of household account book and food cost analysis.

1. Household account book : When the daily settlement is completed, it shows how much food expenses have been saved, handed over, and put in the donation box. The following shows the amount of consumption and savings compared to the monthly budget.
2. Food Cost Analysis : Shows the type of meal corresponding to the selection year and month compared to last month's statistics according to the number and cost.

⭐️ Donation

This is a page where you can donate the amount you saved through ‘Settle for a day’. You can see ongoing campaigns you can donate to and the campaigns you have donated to. In order to increase accessibility to the campaigns currently in progress, we have placed about 4 campaigns at the bottom so that you can preview them.

⭐️ Collection

You can see the amount of MEAL points users have earned through donation payment and the level proportional to the number of donations. When enough MEAL points are accumulated, you can unlock various characters. Complete your own collection!

⭐️ My page

You can check your basic information, modify your monthly food budget, and view your donation details in the form of a receipt.

📌 Services

• Payment for donation

We support simple payment through Toss Payments service. After a user selects the campaign and amount to be donated and pays, amount of payment is converted into Ether at a 1:1 ratio and deposited into the user's e-wallet.

• Smart Contract & BlockChain

20 MEAL points are awarded to the user after the donation is delivered to the campaign fundraising safe implemented as a smart contract. MEAL point is managed by Loyalty point API of Luniverse Baas(Blockchain as a service). So, You can see when and how your points were spent, and you can check them at a glance at any time.

• Recording Meals

Press “+” button and check a meal time, method and write price, and note. Then press the save button. After using the daily food expenses, Click "one-day settlement" button above the “+” button to save the donation amount. Donations are possible as much as the difference between the daily food budget and expenditure. The donations will be accumulated in the donation box.

• Tracking Consumption

You can track monthly consumption through accountbook and analysis charts. Go manage your consumption patterns in detail !

• Keeping in touch with beneficiaries

If you click the Letter icon in the upper right corner of app bar, you can see the news of people who have been helped through the campaign you donated to. When the fundraising period of the campaign you donated is over, you can communicate with the beneficiaries through photos of daily necessities provided by donations, their photos, or handwritten letters.

• Donating to a campaign

Once you have selected the campaign you would like to donate to, you will be taken to the payment page and the amount accumulated in the donation box will be donated.

🛠 Tech Stacks

Backend

역할	종류
Framework
Deploy
Database
Programming Language
Environment
Communication

Frontend

역할	종류
Framework
Programming Language
Environment
Communication

🔍 Action Guide

Requirements

Backend

For building and running the application you need:

• Python 3.9.2

git clone https://github.com/Jakensori/Backend.git
pip install -r requirements.txt
cd Backend/naegginiggi

python3 manage.py runserver

Frontend

• Flutter 3.10.2
• Dart 3.0.2

🔗 Architecture

• Structure of directories

├── README.md
├── .gitignore
├── db.sqlite3
├── donation_smartcontract.sol    : file of smartcontract
├── dump.rdb
├── manage.py
├── requirements.txt              : installed packages
├── artifacts
	├── test.json
	├── test_metadata.json
└── campaign
	├── migrations
	└── templates/chat
			├── chat_room.html
			└── index.html
	├── __init__.py
	├── admin.py
	├── apps.py
	├── consumers.py
	├── models.py
	├── routing.py
	├── serializers.py
	├── tests.py
	├── urls.py
	└── views.py
└── donation_point
	├── migrations
	└── templates/chat
			├── requestPayment.html     : payment webview 
			└── success.html
	├── .views.py.swp
	├── __init__.py
	├── admin.py
	├── apps.py
	├── models.py
	├── routing.py
	├── serializers.py
	├── tests.py
	├── urls.py
	└── views.py
└── naegginiggi
	├── __init__.py
	├── asgi.py
	├── result.json                  : donation campaign crawling data
	├── search_apitest.py            : crawling 'happybean' site
	├── settings.py
	├── urls.py
	└── wsgi.py
└── user
	├── migrations
	├── __init__.py
	├── admin.py
	├── apps.py
	├── models.py
	├── serializers.py
	├── tests.py
	├── urls.py
	└── views.py
└── user_custom
	├── migrations
	├── __init__.py
	├── admin.py
	├── apps.py
	├── models.py
	├── serializers.py
	├── tests.py
	├── urls.py
	└── views.py
└── user_record
	├── migrations
	├── .views.py.swp
	├── __init__.py
	├── admin.py
	├── apps.py
	├── models.py
	├── serializers.py
	├── tests.py
	├── urls.py
	└── views.py