Gas24h_7App

Gas24h_7App is an online gas ordering application that allows users to easily search, place orders, and manage their orders directly from their mobile devices. The app provides a user-friendly interface, real-time order tracking, and various modern features to enhance the shopping experience.

🌟 Key Features

• 🚀 Place gas orders with just a few simple steps.
• 📦 Track orders in real-time.
• 🛒 Manage your shopping cart easily.
• 🔔 Receive instant notifications via WebSocket when order status updates.
• 🗨 Review and rate products with images/videos.
• 📞 Chat support with the admin for quick assistance.

🚀 Main Features

• 🛒 Cart Management: Add/remove products from the cart.
• 🛍 Quick Ordering: Multiple options for ordering gas.
• 📦 Order Tracking: View order status in real-time.
• 🗨 Review & Rating System: Users can submit reviews with images/videos.
• 🔔 Real-time Notifications: WebSocket-based notifications from the admin.
• 📞 Chat with Admin: One-on-one chat for each order.

🏗 Technologies Used

• Language: Kotlin
• UI: Jetpack Compose & XML
• Backend: Spring Boot + MongoDB
• Key Libraries:
  • Retrofit (API calls)
  • Glide (Image processing)
  • WebSocket (Real-time notifications)
  • Dagger 2 (Dependency injection)
  • Navigation Component (Screen navigation)
  • Zing QR (QR Code generation)
  • TravisHuyProgressBar (Enhanced UI progress tracking)
  • Firebase Authentication (User login and registration)
  • Firestore (Cloud database for user and order data)

📥 Installation & Running the App

1️⃣ Clone the repository:

git clone https://github.com/yourusername/gas24h_7app.git
cd gas24h_7app

2️⃣ Configure Firebase:

• Download google-services.json from Firebase Console and place it in the app/ directory.

3️⃣ Run the App:

• Open with Android Studio
• Select a virtual or physical device
• Click Run (Shift + F10)

📖 Backend API

The app connects to the backend deployed on Render:

• Base URL: https://mongodb-csvv.onrender.com/
• Main Endpoints:
  • GET travishuy/notifications/all - Get all notifications
  • GET travishuy/notifications/{id} - Get detail notification by Id
  • POST travishuy/notifications/add - Create a new notification
  • PUT travishuy/notifications/edit/{id} - Edit notification
  • DELETE travishuy/notifications/{id} - Delete notification

🎯 Main Screens

• 🏠 Dashboard
  
• 🏠 Home
  
• 🛒 Shopping Cart
  
• 📦 Order
  
• 🔍 Search Products
  
• 📷 Scanner
  
• ⭐ Review Products
  
• 🛠 Admin Home
  
• ➕ Add Product
  
• ✏ Edit Product
  
• 🗑 Remove Product
  
• 🎟 Add Voucher
  
• 📑 All QR Voucher
  
• 🆕 Create Voucher
  
• 🔔 Add Notification
  
• 📊 Revenue Statistics
  
• 💬 Chat
  

🛠 Contributing

You can contribute by following these steps:

1. Fork the repository 🍴
2. Create a new branch (git checkout -b feature-x)
3. Commit your changes (git commit -m "Add feature x")
4. Submit a pull request 📩

📄 License

This project is licensed under the MIT License. You are free to use, modify, and distribute the code for personal or commercial purposes. However, the software is provided "as-is" without any warranty, and the author (TravisHuy) is not responsible for any issues that may arise from its use. For more details, please refer to the full license text.