2025 Google Solution Challenge

♻️ Circulo : Pack it back, Earn it back

Circulo is a Packaging Reuse Platform that connects Individuals and Local Businesses to enable Community-driven Sustainability.

🌱 How Circulo Works

• 🏪 Stores post requests for reusable packaging they need
• 🙋‍♂️ Individuals respond to requests by offering packaging they already own
• 🛵 Individuals can also deliver the packaging from the provider to the store
• 🏅 All Participants receive Reward Points for each successful match and delivery

🚀 Features

• 🔐 Google Social Login for seamless user onboarding
• 🔄 Packaging registration and matching system
• 🤖 AI-powered image verification for packaging type validation
• 🎯 Reward point system for all participants (users, stores, deliverman)
• 🚚 Delivery management interface

🙌 Developers

Server	Client	AI	Server
Kyuree Kim	Suhyeon Kim	Jaehyoung Park	Jihee Lee

🛠️ Tech Stacks

Category	Tech Stack
Frontend	Kotlin (Jetpack Compose), Clean Architecture, Hilt, Gradle Version Catalog
Backend	Spring Boot, MySQL, Redis
AI/ML	Google Vertex AI - AutoML Vision
Authentication	Google Identity (OAuth2)
DevOps	GitHub Actions, Docker

⚙️ Getting Started

✅ Prerequisites

• JDK 17 or higher
• MySQL 8.0 or higher
• Redis
• Android Studio
• Git

📦 Installation

1. Clone the repository

git clone https://github.com/GDSC-DGU/2025-APAC-SolutionChallenge-Circulo.git
cd 2025-APAC-SolutionChallenge-Circulo

2. Set Up the Backend

cd server
./gradlew bootRun

Create an application.yml or .env file and configure Database credentials, Redis host and port, Google Cloud credentials.

3. Set Up the Android App (Frontend)

cd client

Open the client folder in Android Studio. Sync Gradle and click the Run ▶️ button to launch the app.

🌐 Deployment Notes

The backend is deployed on Google Cloud Platform (GCP). For cloud deployment, we recommend using:

Google Cloud Run (for containerized backend)

Cloud SQL (managed MySQL instance)

Memorystore or Compute Engine (for Redis)

💡 Solution Overview

📬 Contact

For questions, suggestions, or collaborations: Open an issue or contact us via circulo20252@gmail.com