پڕۆژەی فرۆشگای ئەلیکترۆنی جل و بەرگ

📱 دەربارەی پڕۆژەکە

پڕۆژەیەکی تەواوی فرۆشگای ئەلیکترۆنییە بۆ فرۆشتنی جل و بەرگ کە بە Flutter دروستکراوە و Firebase بەکاردێنێت بۆ Backend. ئەم پڕۆژەیە سیستەمێکی تەواوی authentication و role-based access control لەخۆدەگرێت.

✨ تایبەتمەندییەکان

🎯 Onboarding

• 3 پەیجی onboarding بە ئانیمەیشنی نەرم
• Page indicators بۆ نیشاندانی پەیجی ئێستا
• دوگمەکانی Navigation: دواتر، پاشەکەوت، پەڕاندن، دەستپێبکە
• یادکردنەوەی تەواوبوونی onboarding بە SharedPreferences

🔐 Authentication

• Register (تۆمارکردن):

  • تۆمارکردنی بەکارهێنەری نوێ بە ناو، ئیمەیل و تێپەڕەوشە
  • پشکنینی validation بۆ هەموو خانەکان
  • دروستکردنی document لە Firestore بە uid-ی بەکارهێنەر
  • زیادکردنی ڕۆڵ (user) بەشێوەی ئۆتۆماتیک
  • هەڵگرتنی timestamp-ی createdAt

• Login (چوونەژوورەوە):

  • چوونەژوورەوە بە ئیمەیل و تێپەڕەوشە
  • پشکنینی validation پێش ناردنی داواکاری
  • هەڵەکان بە شێوەی SnackBar نیشاندەدرێن
  • ناڤیگەیشنی ئۆتۆماتیک بەپێی ڕۆڵی بەکارهێنەر

👥 Role-Based Access

• User Dashboard:

  • پەیجی سەرەکی بۆ بەکارهێنەرانی ئاسایی
  • دوگمەی دەرچوون (Logout)

• Admin Panel:

  • پەیجی تایبەت بۆ بەڕێوەبەران
  • مێنۆی بەڕێوەبردن بۆ: بەرهەمەکان، داواکاریەکان، بەکارهێنەران، ڕاپۆرتەکان
  • دەستڕاگەیشتنی تایبەت بەپێی ڕۆڵ

🔄 Navigation Flow

Onboarding → Login/Register → Auth Check → Role-based Routing
                                           ├── Admin → AdminHomePage
                                           └── User → HomePage

🛠️ تەکنەلۆژیاکان

Frontend

• Flutter: Framework-ی سەرەکی
• Dart: زمانی پڕۆگرامکردن

Backend & Services

• Firebase Authentication: بۆ بەڕێوەبردنی بەکارهێنەران
• Cloud Firestore: بۆ هەڵگرتنی داتا
• Firebase Storage: بۆ هەڵگرتنی وێنەکان
• SharedPreferences: بۆ یادکردنەوەی state-ی local

📊 بونیادی داتابەیس (Firestore)

Collection: users

users/
  ├── {uid}/
      ├── name: String
      ├── email: String
      ├── role: String ('user' | 'admin')
      └── createdAt: Timestamp

🚀 چۆنیەتی Run کردن

1. Flutter Setup:

flutter pub get

2. Firebase Configuration:

flutterfire configure

3. Run Application:

flutter run -d chrome  # بۆ web
flutter run            # بۆ mobile

📁 بونیادی پڕۆژەکە

lib/
├── main.dart                    # Entry point و routing logic
├── firebase_options.dart        # Firebase configuration
├── Auth/
│   ├── login.dart              # Login page
│   ├── register.dart           # Registration page
│   └── AuthWrapper             # Role-based routing helper
├── pages/
│   ├── onboarding_page.dart    # Onboarding screens
│   └── home.dart               # User home page
└── AdminPanel/
    └── pages/
        └── admin_home.dart     # Admin dashboard

🔒 Security

• Firebase Authentication بۆ پاراستنی ئەکاونتەکان
• Role-based access control بۆ جیاکردنەوەی دەسەڵاتەکان
• Firestore security rules بۆ پاراستنی داتا
• Input validation لە هەموو فۆرمەکاندا

🎨 Features لە داهاتوودا

• بەڕێوەبردنی بەرهەمەکان (CRUD)
• سەبەتەی کڕین
• سیستەمی داواکاری
• بەڕێوەبردنی بەکارهێنەران لە Admin Panel
• ڕاپۆرتەکان و ئامارەکان
• سیستەمی گەڕان
• فلتەرکردنی بەرهەمەکان
• سیستەمی پارەدان

👨‍💻 Developer

Ibrahim

• GitHub: @ibrahmcode

📄 License

This project is for educational purposes.

---

زمانی پڕۆژەکە: کوردی (سۆرانی)
پلاتفۆرمەکان: Web, Android, iOS, Windows, macOS, Linux