{"id":20303385,"url":"https://github.com/abdulazeem-tk4vr/livemart","last_synced_at":"2025-04-11T13:44:26.151Z","repository":{"id":49927376,"uuid":"353400665","full_name":"abdulazeem-tk4vr/LIVEMart","owner":"abdulazeem-tk4vr","description":"Grocery Shop ecommerce Mobile App with Firebase Realtime Database built in Java using Android Studio.","archived":false,"fork":false,"pushed_at":"2025-04-03T20:18:56.000Z","size":7267,"stargazers_count":28,"open_issues_count":3,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T21:25:54.026Z","etag":null,"topics":["android","android-application","android-studio","college-project","crud-application","customer","firebase","firebase-auth","firebase-realtime-database","firebase-storage","grocery","gui-application","java","language","object-oriented-programming","problem-statement","retailers","shop","xml"],"latest_commit_sha":null,"homepage":"https://github.com/tk4vr/oop_anidev","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abdulazeem-tk4vr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-31T15:17:37.000Z","updated_at":"2025-04-03T20:19:00.000Z","dependencies_parsed_at":"2022-08-24T20:00:58.182Z","dependency_job_id":null,"html_url":"https://github.com/abdulazeem-tk4vr/LIVEMart","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdulazeem-tk4vr%2FLIVEMart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdulazeem-tk4vr%2FLIVEMart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdulazeem-tk4vr%2FLIVEMart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdulazeem-tk4vr%2FLIVEMart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abdulazeem-tk4vr","download_url":"https://codeload.github.com/abdulazeem-tk4vr/LIVEMart/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248410892,"owners_count":21098790,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-application","android-studio","college-project","crud-application","customer","firebase","firebase-auth","firebase-realtime-database","firebase-storage","grocery","gui-application","java","language","object-oriented-programming","problem-statement","retailers","shop","xml"],"created_at":"2024-11-14T16:37:04.946Z","updated_at":"2025-04-11T13:44:26.134Z","avatar_url":"https://github.com/abdulazeem-tk4vr.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grocery Shop eCommerce Android Application  \n**(Java + Firebase Realtime Database)**\n\n**LIVEMart** is a full-stack Android-based mobile eCommerce platform enabling **B2C** and **B2B** grocery transactions between **Customers**, **Retailers**, and **Wholesalers**. Built with **Java (Android SDK)** and **Firebase**, the app supports real-time syncing, role-based dashboards, offline reminders via speech input, and product moderation via admin controls.\n\n📄 [Detailed Report](https://drive.google.com/file/d/1vJVX2_IoBgb7cZaiypGeQTA6cj_qEzAo/view?usp=sharing)  \n🔗 [GitHub Repository](https://github.com/abdulazeem-tk4vr/LIVEMart)\n\n---\n\n## Table of Contents\n\n- [System Overview](#system-overview)\n- [Architecture \u0026 Stack](#architecture--stack)\n- [Core Modules \u0026 Features](#core-modules--features)\n- [Firebase Schema](#firebase-schema)\n- [Getting Started](#getting-started)\n- [Resources](#resources)\n- [Contributors](#contributors)\n\n---\n\n## System Overview\n\nLIVEMart simulates a real-world grocery eCommerce flow with three main user roles:\n\n- 🧍 **Customers** place orders for household groceries.\n- 🧑‍💼 **Retailers** source items in bulk from wholesalers and sell to customers.\n- 🏬 **Wholesalers** add and manage high-volume stock, servicing retailers.\n\nThe application supports both **online transactions** (with delivery tracking) and **offline orders** via **calendar reminders** and **voice input** using the Google Voice API.\n\n---\n\n## Architecture \u0026 Stack\n\n### 📦 Backend\n- **Firebase Realtime Database** (NoSQL, hierarchical JSON tree)\n- **Firebase Authentication** (email/password + OTP)\n- Admin controls for inventory visibility (approve/hide products)\n\n### 📱 Frontend\n- **Java** (Android SDK)\n- **XML** for UI layouts\n- **Material Design** principles for UI consistency\n- **Google Geocoding API** for location-based filtering\n- **Voice Recognition API** for offline reminder memos\n\n### 🧰 Development Tools\n- **Android Studio** (Gradle-based build system)\n- **Canva** for layout prototyping and visual design\n\n---\n\n## Core Modules \u0026 Features\n\n### 🔐 Registration \u0026 OTP Authentication\n- Role-based sign-up: Customer, Retailer, Wholesaler\n- Phone number OTP verification via Firebase Auth\n- Google Geocoding API to capture latitude/longitude\n\n### 📊 Dashboards\n- Role-specific dashboards:\n  - **Customer**: Browse items, filter by distance/stock, view cart/orders\n  - **Retailer**: Purchase from wholesalers, manage customer transactions\n  - **Wholesaler**: Add/update inventory, fulfill retailer orders\n\n### 🔎 Category \u0026 Product Search\n- Filter by:\n  - **Distance** (via user-entered km radius)\n  - **Stock availability**\n  - **Retailer/Wholesaler proximity**\n- Dynamic UI with distance and stock validation warnings\n\n### 🛒 Order Management\n- **Online orders**:\n  - Cart-based ordering with unique order IDs\n  - Delivery details, cash-on-delivery, and feedback submission\n- **Offline orders**:\n  - Set future reminders using **calendar + voice input**\n  - Voice-to-text conversion via Google Speech API\n\n### 🗣 Feedback \u0026 Queries\n- Product-specific feedback stored in Firebase\n- Displayed to other users while browsing the item\n\n### 🛠 Admin Approval System\n- Admin can:\n  - Approve new products\n  - Temporarily hide/unhide listings\n- Controlled via backend flags in Firebase\n\n---\n\n## Firebase Schema\n\nThe app uses a hierarchical JSON schema for:\n- Users (with roles)\n- Products (per category/store)\n- Orders (with unique transaction IDs)\n- Feedback\n- Admin flags for moderation\n\n📂 [Realtime DB Schema Visualization](https://drive.google.com/file/d/1G5YEXlrrd9oTsYyQz4_6TEx_2MoTLTua/view?usp=sharing)\n\n🔍 Use [CodeBeautify JSON Viewer](https://codebeautify.org/jsonviewer) to visualize the schema from the exported `.json` tree.\n\n---\n\n## Getting Started\n\n### 🛠 Prerequisites\n\n- Android Studio (latest)\n- Android device/emulator (API 28+)\n- Firebase account and `google-services.json`\n\n### 🚀 Setup\n\n1. Clone this repository\n2. Import it into Android Studio\n3. Sync Gradle and build the project\n4. Run on an emulator or connected device\n\n---\n\n## Resources\n\n- [CodePath Android Guides](https://github.com/codepath/android_guides)  \n- [Android Roadmap](https://github.com/coder2hacker/Android-Development-RoadMap)  \n- [Udacity Android Basics](https://classroom.udacity.com/courses/ud9012)  \n- [Android Studio Setup](https://www.youtube.com/watch?v=FeKfIWJyQMs)  \n- [Running First App](https://www.youtube.com/watch?v=13DPpfuP1Zs)\n\n---\n\n## Contributors\n\n- [**Abdul Azeem**](https://github.com/abdulazeem-tk4vr) – Backend, Firebase, Role-based logic  \n- [**Anirudh Sundar**](https://github.com/Anirudh-Sundar) – UI/UX, XML layouts, navigation  \n- [**Karthik Suresh**](https://github.com/karths8) – Firebase schema design, voice API integration\n\n### 🙌 Special Mention\n- [**Aryan Arora**](https://github.com/aryanarora180) – Feedback module support and UI testing\n\n📈 [Contribution Graph](https://github.com/abdulazeem-tk4vr/LIVEMart/graphs/contributors)\n\n---\n\n\u003e 💬 For questions, contact **sabdulazeem01@gmail.com** | **https://www.linkedin.com/in/abdulazeem-shaik/**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulazeem-tk4vr%2Flivemart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdulazeem-tk4vr%2Flivemart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulazeem-tk4vr%2Flivemart/lists"}