My Doctor is a premium, full-featured, and production-ready doctor appointment booking platform built on a powerful tech stack: Flutter (Mobile App) and Laravel 11 (Backend & Admin Panel). It contains three integrated roles (Admin, Doctor, and Patient) within a single codebase, specifically tailored to bridge the gap between patients and medical clinics seamlessly.

### Multi-Role Workflows:
• Patient App: Browse doctors by specialty or rating, view real-time open time slots, book appointments, and utilize integrated OpenStreetMap geolocation.
• Doctor Panel: Manage schedules, approve/cancel appointments, set weekly working hours, view financial earnings charts, and handle emergency clinical cancellations.
• Admin Dashboard: Comprehensive Laravel control room to approve/reject new doctor applications, manage medical specialties, adjust system settings, and overview overall statistics.

### Live Test Preview (Android APK):
Want to experience the fluid UX, animations, and transitions yourself? Download and test the live client app directly on your smartphone here:
https://portal.testapp.io/apps...

### Live Demo Credentials To test full experience , please use the following test accounts:

* **Admin Account:

*Email: [email protected]

*Password: pssword123

* **Doctor Account:

*Email: [email protected]
*Password: pssword123

* **Patient Account:

*Email: [email protected]
*Password: pssword123

### Key Features:

- **Full Localization & RTL:** Complete Arabic and English support out-of-the-box with seamless translation switching.
- **Dynamic Theme Engine:** Fluid transition between Light and Dark modes to match user preferences.
- **Text-to-Speech Accessibility:** Enhances user experience by converting key on-screen medical texts into clear voice audio.
- **Multi-Currency System:** Flexible engine supporting multiple global and local currencies effortlessly.
- **Smart Appointment Management:** Automated real-time slot booking, cancellation handling, and schedule locks.
- **Interactive Map Integration:** Utilizes OpenStreetMap for seamless clinic and doctor geolocation tracking.
- **Financial Analytics Dashboard:** Built-in responsive charts inside the doctor panel to track monthly earnings and stats.
- **Clean Architecture & Code:** High-quality Flutter and Laravel 11 source code adhering to industry-standard design patterns.

### Technical Requirements:

- **For Backend (Laravel Admin Panel):** PHP v8.2 or higher, MySQL v8.0 or higher, and a standard web hosting or VPS (cPanel, Ubuntu, etc.).
- **For Mobile App (Flutter):** Flutter SDK v3.x installed on your development machine (Windows, Mac, or Linux).
- **For App Customization:** Android Studio or VS Code (with Flutter extension) to build, modify, and export the APK.
-

### Installation & Setup Instructions:

1. **Extract the Main Files:** Unzip the downloaded package. You will find separate folders for the Flutter project, Laravel backend, and the SQL database file.
2. **Setup the Backend Dashboard:** - Upload the Laravel folder to your hosting or server.
   - Configure your `.env` file with your database credentials.
   - Import the provided `.sql` database file using phpMyAdmin.
   - Run `composer install` and `php artisan migrate` to finalize the server configuration.
3. **Setup the Mobile Application:**
   - Open the Flutter folder in VS Code or Android Studio.
   - Run `flutter pub get` in the terminal to download the dependencies.
   - Open the API configuration file and update the base URL to match your newly hosted backend domain.
4. **Run the Project:** You are ready! Build the app using `flutter run` or export your release APK. Complete admin and doctor demo credentials are listed clearly inside the attached documentation guide (README).
٥.