A comprehensive Flutter application for managing vehicle service appointments, workshop operations, and customer engagement. Built for multi-platform deployment (Android, iOS, Web, Desktop).
- User Authentication: Secure login/signup with Firebase Auth, Google SSO support.
- Dashboard: Personalized dashboard for customers and staff, showing upcoming appointments, service status, and notifications.
- Service Booking: Book, reschedule, or cancel vehicle service appointments with smart time slot selection and conflict checking.
- Appointment Management: Real-time status updates (Pending, In Repair, Completed, Missed, Cancelled) with automatic status change for missed appointments.
- Vehicle Management: Add, edit, and view vehicles. Track service history and mileage thresholds.
- Notifications: Local and push notifications for reminders, missed appointments, and service updates.
- Membership & Points: Track membership progress, points earned, and rewards. View history and redeem points.
- Feedback & Ratings: Submit service feedback, rate experience, and upload photos.
- Profile Management: Update personal info, change password, view notification history.
- Localization: Multi-language support (English, Chinese, Malay).
- Admin/Staff Tools: (If enabled) Manage appointments, view customer data, update service status.
- Firebase Integration: Auth, Firestore, Storage, Cloud Functions.
- Provider Architecture: State management using Provider and ChangeNotifier.
- Responsive UI: Adaptive layouts for mobile, tablet, and desktop.
- Local Notifications: Scheduled and instant notifications using platform channels.
- Time Zone Handling: Robust date/time logic for appointments and reminders.
- Error Handling: User-friendly error messages and validation throughout the app.
lib/
main.dart # App entry point
models.dart # Data models
firebase_options.dart # Firebase config
pages/ # Main app pages (dashboard, service, profile, etc.)
components/ # Reusable UI widgets (cards, chips, sheets)
data_providers/ # Provider classes for state management
providers/ # Language and other app-wide providers
utility/ # Helper functions (notifications, service tracking)
l10n/ # Localization files
assets/
real_time_service/ # Service process images
google.png # Branding
android/, ios/, web/, windows/, macos/, linux/ # Platform-specific code
- Clone the repository
git clone https://github.com/Jf-0712/WorkshopManagementSystem.git cd WorkshopManagementSystem - Install dependencies
flutter pub get
- Configure Firebase
- Update
firebase_options.dartand platform-specific config files with your Firebase project settings.
- Update
- Run the app
flutter run
- Flutter 3.x+
- Dart 2.18+
- Firebase project (Auth, Firestore, Storage)
- Android/iOS/Web/Desktop device or emulator
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the MIT License.
-
Refund Details When a refund is approved, the system will: Deduct any points that were earned from the refunded purchase. Return any points that were used during the purchase. Roll back membership spending progress linked to the refunded order. Vouchers used for the purchase will not be refunded. Instead, the user will receive an apology voucher as compensation.
-
High-Value Spending Voucher Users who spend RM1000 or more in a single payment will receive a special RM30 voucher. The voucher is valid for 2 years and requires a minimum spend of RM300.
-
Anti-Abuse Policy New users will not receive a free voucher upon registration. This measure is to prevent fake account creation () and ensure fairness for genuine users.