🍽️ KampusMeal Mobile

Aplikasi Pemesanan Makanan untuk Mahasiswa Kampus

---

📱 Tentang Aplikasi

KampusMeal adalah aplikasi mobile untuk memesan makanan dari berbagai stall/warung makanan di sekitar kampus. Aplikasi ini memudahkan mahasiswa untuk memesan, membayar, dan melacak pesanan makanan mereka.

✨ Fitur Utama

Fitur	Deskripsi
🔐 Authentication	Register, Login, dan Logout dengan JWT
🏪 Explore Stalls	Jelajahi berbagai stall makanan di kampus
🍜 Menu & Detail	Lihat menu lengkap dengan harga dan gambar
🛒 Keranjang	Tambah, edit, dan hapus item dari keranjang
💳 Checkout & Payment	Pilih metode pengambilan (pickup/delivery) dan upload bukti bayar
📦 Order Tracking	Lacak status pesanan secara real-time
🔔 Notifikasi	Notifikasi lokal saat status pesanan berubah
⭐ Review & Rating	Berikan ulasan dan rating untuk pesanan yang selesai
👤 Profile Management	Edit profil dan alamat pengiriman

---

🛠️ Tech Stack

Core

• Flutter ^3.9.2 - Framework UI cross-platform
• Dart ^3.0 - Bahasa pemrograman

State Management

• Provider ^6.1.5 - State management sederhana dan efektif

Networking & Storage

• Dio ^5.4.0 - HTTP client dengan interceptors
• Flutter Secure Storage ^9.0.0 - Penyimpanan aman untuk token
• Shared Preferences ^2.2.2 - Penyimpanan lokal

Features

• Flutter Local Notifications ^19.0.0 - Notifikasi lokal
• Image Picker ^1.2.1 - Upload foto (bukti bayar, profil)
• Intl ^0.18.1 - Format tanggal dan mata uang

Config

• Flutter Dotenv ^5.2.1 - Environment variables

---

📂 Struktur Project

lib/
├── main.dart                    # Entry point aplikasi
├── constants/                   # Konstanta dan konfigurasi
│   └── review_tags.dart
├── models/                      # Data models
│   ├── cart.dart
│   ├── order.dart
│   ├── review.dart
│   ├── stall.dart
│   ├── stall_detail.dart
│   └── user.dart
├── providers/                   # State management
│   ├── auth_provider.dart
│   └── cart_provider.dart
├── services/                    # API dan business logic
│   ├── api_client.dart          # HTTP client dengan interceptors
│   ├── auth_service.dart        # Authentication API
│   ├── cart_service.dart        # Cart management
│   ├── notification_service.dart # Local notifications
│   ├── order_service.dart       # Order API
│   ├── review_service.dart      # Review API
│   ├── stall_service.dart       # Stall API
│   └── user_service.dart        # User/Profile API
├── screens/                     # UI Screens
│   ├── splash_screen.dart
│   ├── welcome_screen.dart
│   ├── login_screen.dart
│   ├── register_screen.dart
│   ├── home_screen.dart
│   ├── explore_screen.dart
│   ├── restaurant_detail_screen.dart
│   ├── checkout_screen.dart
│   ├── payment_screen.dart
│   ├── payment_loading_screen.dart
│   ├── order_history_screen.dart
│   ├── review/
│   │   └── review_order_screen.dart
│   ├── profile_screen.dart
│   ├── edit_profile_screen.dart
│   ├── edit_address_screen.dart
│   ├── address_screen.dart
│   └── about_screen.dart
└── utils/                       # Helper functions

---

🚀 Getting Started

Prerequisites

• Flutter SDK ^3.9.2
• Dart SDK ^3.0
• Android Studio / VS Code
• Android Emulator atau Device Fisik

Installation

1. Clone repository

   git clone https://github.com/your-username/kampusmeal-mobile.git
   cd kampusmeal-mobile

2. Setup environment

   cp .env.example .env

   Edit .env dan isi dengan konfigurasi yang sesuai:

   API_BASE_URL=https://your-api-url.com

3. Install dependencies

   flutter pub get

4. Run aplikasi

   flutter run

Build APK

# Debug APK
flutter build apk --debug

# Release APK
flutter build apk --release

---

🔔 Fitur Notifikasi

Aplikasi ini mendukung notifikasi lokal untuk update status pesanan:

Status	Notifikasi
waiting_confirmation	"Pembayaran Terkirim 📤"
processing	"Pesanan Dikonfirmasi 🍳"
ready (pickup)	"Pesanan Siap Diambil 🛒"
ready (delivery)	"Pesanan Dikirim 🛵"
completed	"Pesanan Selesai ✅"
rejected	"Pesanan Ditolak ❌"

---

📦 Order Status Flow

pending_payment → waiting_confirmation → processing → ready → completed
                          ↓
                      rejected

Status	Deskripsi
pending_payment	Menunggu user upload bukti bayar
waiting_confirmation	Menunggu konfirmasi penjual
processing	Pesanan sedang diproses/dimasak
ready	Siap diambil (pickup) atau sedang dikirim (delivery)
completed	Pesanan selesai
rejected	Pesanan ditolak oleh penjual

---

🎨 Design System

Color Palette

Warna	Hex	Penggunaan
🟠 Primary Orange	#FF7449	Warna utama, tombol, header
🟡 Secondary Orange	#FB923C	Aksen, gradient
🟢 Teal	#14B8A6	Status selesai, badge aktif
⚫ Text Dark	#1F2937	Teks utama
⚪ Background	#F9FAFB	Background halaman

---

👥 Tim Pengembang

Nama	NIM
Muh. Fajri Farid	D121231038
Irgiyansyah Ahmad Fahrezy	D121231115
Andi Muhammada Abigail Ghalib Athallah Surya Putra	D121231109

---

📄 License

Project ini dibuat untuk keperluan tugas kuliah Mobile Programming.

---

Made with ❤️ using Flutter