Commit Explain Code

Author: LearnCodingEasy

README.md

@@ -112,14 +112,11 @@ cd messenger_vuepress
 npm run docs:dev
 ```
 
-# **\*\*\*\***\*\*\*\***\*\*\*\***\_**\*\*\*\***\*\*\*\***\*\*\*\***
-
-# **\*\*\*\***\*\*\*\***\*\*\*\***\_**\*\*\*\***\*\*\*\***\*\*\*\***
-
-# **\*\*\*\***\*\*\*\***\*\*\*\***\_**\*\*\*\***\*\*\*\***\*\*\*\***
+___
 
 ###### 📝 Create File Gitignore
 
+
 ```
 .gitignore
 ```

messenger_django/account/__pycache__/api.cpython-312.pyc

@@ -0,0 +1,27 @@
+# Generated by Django 5.1.3 on 2024-11-30 15:19
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('account', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='friendshiprequest',
+            options={'ordering': ('-created_at',)},
+        ),
+        migrations.AddField(
+            model_name='user',
+            name='skills',
+            field=models.JSONField(blank=True, default=list, null=True),
+        ),
+        migrations.AlterField(
+            model_name='friendshiprequest',
+            name='status',
+            field=models.CharField(choices=[('notsend', 'NotSent'), ('send', 'Send'), ('waiting', 'Waiting'), ('accepted', 'Accepted'), ('rejected', 'Rejected'), ('cancel', 'Cancel')], default='notsend', max_length=20),
+        ),
+    ]

messenger_django/account/__pycache__/models.cpython-312.pyc

@@ -0,0 +1,18 @@
+# Generated by Django 5.1.3 on 2024-12-02 14:38
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('account', '0002_alter_friendshiprequest_options_user_skills_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='friendshiprequest',
+            name='status',
+            field=models.CharField(choices=[('notsend', 'NotSent'), ('send', 'Send'), ('waiting', 'Waiting'), ('accepted', 'Accepted'), ('rejected', 'Rejected'), ('cancel', 'Cancel'), ('blocked', 'Blocked'), ('muted', 'Muted'), ('frozen', 'Frozen'), ('archived', 'Archived'), ('following', 'Following'), ('unfollowed', 'Unfollowed'), ('reported', 'Reported'), ('spam', 'Spam'), ('deleted', 'Deleted'), ('favorite', 'Favorite'), ('temporarily_blocked', 'TemporarilyBlocked'), ('verified', 'Verified'), ('request_resent', 'RequestResent'), ('suggested', 'Suggested'), ('ignored', 'Ignored'), ('inactive', 'Inactive'), ('limited', 'Limited')], default='notsend', max_length=20),
+        ),
+    ]

messenger_django/account/api.py

@@ -52,39 +52,44 @@ def create_superuser(self, name=None, email=None, password=None, **extra_fields)
 # 🧑 Custom User Form
 # 🧑 نموذج المستخدم المخصص
 class User(AbstractBaseUser, PermissionsMixin):
+    # ___________________
+    # حقل يتم تعبئة تلقائي
+    # ___________________
     # 🔑 Define the primary field to be UUID  تعريف الحقل الأساسي ليكون
     id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
-    # 📛 User Data Properties خصائص بيانات المستخدم
-    name = models.CharField(max_length=255, blank=True, null=True, default="")
-    surname = models.CharField(max_length=255, blank=True, default="")
-    email = models.EmailField(unique=True)
-    date_of_birth = models.DateField(default=timezone.now)
-    gender = models.CharField(max_length=15, blank=True, null=True)
-    # 🖼️ Profile Picture صورة شخصية
-    avatar = models.ImageField(upload_to="avatars", blank=True, null=True)
-    # 🖼️ Cover Photo صورة الغلاف
-    cover = models.ImageField(upload_to="covers", blank=True, null=True)
-
     # ⚙️ User Status  حالة المستخدم
     is_active = models.BooleanField(default=True)
     is_superuser = models.BooleanField(default=False)
     is_staff = models.BooleanField(default=False)
-
     # 📋 Custom Admin Link ربط المدير المخصص
     objects = CustomUserManager()
-
     # 👥 Friends and Characteristics of Friendships الأصدقاء وخصائص الصداقات
     friends = models.ManyToManyField("self")
     friends_count = models.IntegerField(default=0)
     people_you_may_know = models.ManyToManyField("self")
-
-    # 📋 Tasks and Their Number المهام وعددها
-    task_count = models.IntegerField(default=0)
-
     # 📅 Join Date & Last Login تاريخ الانضمام وآخر تسجيل دخول و حالة الاتصال
     # Automatic
     date_joined = models.DateTimeField(default=timezone.now)
     last_login = models.DateTimeField(auto_now=True, blank=True, null=True)
+
+    # ___________________
+    # حقل يتم تعبئة من المستخدام
+    # ___________________
+    # 📛 User Data Properties خصائص بيانات المستخدم
+    name = models.CharField(max_length=255, blank=True, null=True, default="")
+    surname = models.CharField(max_length=255, blank=True, default="")
+    email = models.EmailField(unique=True)
+    date_of_birth = models.DateField(default=timezone.now)
+    gender = models.CharField(max_length=15, blank=True, null=True)
+    # 🖼️ Profile Picture صورة شخصية
+    avatar = models.ImageField(upload_to="avatars", blank=True, null=True)
+    # 🖼️ Cover Photo صورة الغلاف
+    cover = models.ImageField(upload_to="covers", blank=True, null=True)
+    # مهارات
+    skills = models.JSONField(default=list, blank=True, null=True)
+    # 📋 Tasks and Their Number المهام وعددها
+    task_count = models.IntegerField(default=0)
+    # 📅 User Is Online  حالة الاتصال
     is_online = models.BooleanField(default=False)
 
     # 🔒 إعدادات تسجيل الدخول: البريد الإلكتروني كمحدد رئيسي لتسجيل الدخول
@@ -112,36 +117,104 @@ def get_cover(self):
     def date_joined_formatted(self):
         return timesince(self.date_joined)
 
+    def last_login_formatted(self):
+        return timesince(self.last_login)
+
 
 # 📬 Friend Request Form نموذج طلب الصداقة
 class FriendshipRequest(models.Model):
     # 📝 Friend request cases  حالات طلب الصداقة
-    SENT = "sent"
-    NOT_SENT = "not sent"
-    ACCEPTED = "accepted"
-    WAITING = "waiting"
-    REJECTED = "rejected"
-    CANCEL = "cancel"
-
+    NOTSEND = "notsend"  # 🚫 لم يتم الإرسال
+    SEND = "send"  # ✉️ تم الإرسال
+    WAITING = "waiting"  # ⏳ في انتظار الرد
+    ACCEPTED = "accepted"  # ✅ تم القبول
+    REJECTED = "rejected"  # ❌ تم الرفض
+    CANCEL = "cancel"  # 🔄 تم الإلغاء
+    BLOCKED = "blocked"  # 🚫 الحظر
+    MUTED = "muted"  # 🔕 الكتم
+    FROZEN = "frozen"  # 🧊 تجميد
+    ARCHIVED = "archived"  # 📦 مؤرشف
+    FOLLOWING = "following"  # 👥 متابعة
+    UNFOLLOWED = "unfollowed"  # 🚫 إلغاء المتابعة
+    REPORTED = "reported"  # 🚨 تم الإبلاغ عنه
+    SPAM = "spam"  # 🗑️ بريد مزعج
+    DELETED = "deleted"  # 🗑️ محذوف
+    FAVORITE = "favorite"  # 🌟 مفضل
+    TEMPORARILY_BLOCKED = "temporarily_blocked"  # ⏳ حظر مؤقت
+    VERIFIED = "verified"  # ✔️ تم التحقق
+    REQUEST_RESENT = "request_resent"  # 🔄 تم إعادة الإرسال
+    SUGGESTED = "suggested"  # 💡 مقترح
+    IGNORED = "ignored"  # 🛑 تم التجاهل
+    INACTIVE = "inactive"  # ⚠️ غير نشط
+    LIMITED = "limited"  # 🚫 محدود
+
+    # 📜 قائمة الحالات الممكنة مع النصوص المقابلة
     STATUS_CHOICES = (
-        (SENT, "Sent"),
-        (NOT_SENT, "Not Sent"),
-        (ACCEPTED, "Accepted"),
-        (WAITING, "Waiting"),
-        (REJECTED, "Rejected"),
-        (CANCEL, "Cancel"),
+        (NOTSEND, "NotSent"),  # 🚫 لم يتم الإرسال
+        (SEND, "Send"),  # ✉️ تم الإرسال
+        (WAITING, "Waiting"),  # ⏳ في انتظار الرد
+        (ACCEPTED, "Accepted"),  # ✅ تم القبول
+        (REJECTED, "Rejected"),  # ❌ تم الرفض
+        (CANCEL, "Cancel"),  # 🔄 تم الإلغاء
+        (BLOCKED, "Blocked"),  # 🚫 الحظر
+        (MUTED, "Muted"),  # 🔕 الكتم
+        (FROZEN, "Frozen"),  # 🧊 تجميد
+        (ARCHIVED, "Archived"),  # 📦 مؤرشف
+        (FOLLOWING, "Following"),  # 👥 متابعة
+        (UNFOLLOWED, "Unfollowed"),  # 🚫 إلغاء المتابعة
+        (REPORTED, "Reported"),  # 🚨 تم الإبلاغ عنه
+        (SPAM, "Spam"),  # 🗑️ بريد مزعج
+        (DELETED, "Deleted"),  # 🗑️ محذوف
+        (FAVORITE, "Favorite"),  # 🌟 مفضل
+        (TEMPORARILY_BLOCKED, "TemporarilyBlocked"),  # ⏳ حظر مؤقت
+        (VERIFIED, "Verified"),  # ✔️ تم التحقق
+        (REQUEST_RESENT, "RequestResent"),  # 🔄 تم إعادة الإرسال
+        (SUGGESTED, "Suggested"),  # 💡 مقترح
+        (IGNORED, "Ignored"),  # 🛑 تم التجاهل
+        (INACTIVE, "Inactive"),  # ⚠️ غير نشط
+        (LIMITED, "Limited"),  # 🚫 محدود
     )
+
     # 🔑 Friend Request UUID Essential Field حقل أساسي UUID لطلب الصداقة
     id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
     # 🧑 User receiving the request  المستخدم المستلم للطلب
     created_for = models.ForeignKey(
         User, related_name="received_friendshiprequests", on_delete=models.CASCADE
     )
-    # 📅 Creation date تاريخ الإنشاء
-    created_at = models.DateTimeField(auto_now_add=True)
     # 🧑 The user who sent the request  المستخدم المرسل للطلب
     created_by = models.ForeignKey(
         User, related_name="created_friendshiprequests", on_delete=models.CASCADE
     )
+    # 📅 Creation date تاريخ الإنشاء
+    created_at = models.DateTimeField(auto_now_add=True)
     # 📝 Order Status  حالة الطلب
-    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default=NOT_SENT)
+    # 🚫 الحالة الافتراضية: "لم يتم الإرسال"
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default=NOTSEND)
+
+    # - 🔄 يتم استخدام عبارة "ترتيب حسب" لتحديد ترتيب البيانات المُسترجعة
+    # - 📊 يمكن تحديد ترتيب البيانات بناءً على أحد الحقول في الجدول
+    # - 🎚️ يتيح ذلك تنظيم البيانات بطريقة محددة، مثل الترتيب تصاعديًا أو تنازليًا
+    class Meta:
+        ordering = ("-created_at",)
+
+    # - 🔍 اسم الاوبجكت اللى يظهر فى صفحة الادمان
+    def __str__(self):
+        return "%s" % self.status
+
+    # 🔍 Retrieve All Friend Requests by User and Status 🔍
+    # 🧑‍🤝‍🧑 جلب جميع طلبات الصداقة بناءً على المستخدم والحالة
+    @staticmethod
+    def get_friends_by_status(user, status):
+        """جلب الأصدقاء بناءً على حالة محددة"""
+        if status == FriendshipRequest.ACCEPTED:
+            return User.objects.filter(
+                received_friendshiprequests__created_by=user,
+                received_friendshiprequests__status=status,
+            ) | User.objects.filter(
+                created_friendshiprequests__created_for=user,
+                created_friendshiprequests__status=status,
+            )
+        return User.objects.filter(
+            received_friendshiprequests__created_by=user,
+            received_friendshiprequests__status=status,
+        )

messenger_django/account/migrations/0002_alter_friendshiprequest_options_user_skills_and_more.py

@@ -25,12 +25,6 @@ onMounted(() => {
   }
 })
 
-// For Toggle Theme
-// const op = ref(null)
-// const toggle = event => {
-//   // console.log('toggle: ', toggle);
-//   op.value.toggle(event)
-// }
 // Log Out
 let logout = () => {
   // console.log('User Log out')
@@ -43,10 +37,7 @@ let logout = () => {
 </script>
 
 <template>
-  <div
-    class="wrapper_page_app"
-    style="border: 1rem solid #000; height: 100vh; overflow-y: scroll; padding: 0.5rem"
-  >
+  <div class="wrapper_messenger_app">
     <!-- Header Tailwind -->
     <div class="header_wrapper sticky top-0 left-0 right-0">
       <div class="container mx-auto">
@@ -336,13 +327,11 @@ let logout = () => {
 export default {
   data() {
     return {
-      // تعريف الخاصية
-      visibleAddBoard: false,
       isDropdownOpen: false,
     }
   },
   mounted() {
-    document.title = 'Trello | Home'
+    document.title = 'Messenger | Home'
   },
   methods: {
     toggleDropdown() {
@@ -355,79 +344,4 @@ export default {
 }
 </script>
 
-<style lang="scss">
-.header_right_section {
-  a,
-  RouterLink {
-    margin: 0 0.5rem;
-  }
-}
-
-.wrapper_page_app {
-  .header_wrapper {
-    border-bottom: 1px solid #99999985;
-    z-index: 7;
-    .container {
-      .header_inner {
-        .header_card {
-          border-radius: 0;
-          box-shadow: none;
-
-          > div {
-            padding: 0;
-
-            header.header_header {
-              nav.header_nav {
-                .header_content {
-                  .header_content_inner {
-                    .header_mobile_menu_button {
-                      button {
-                        border: 0.1rem solid #085dd8;
-                      }
-                    }
-
-                    .header_wrapper_links {
-                      .header_logo_link {
-                        .logo {
-                          img {
-                          }
-                        }
-                      }
-
-                      .header_main_links {
-                        .header_main_link {
-                          a {
-                          }
-
-                          button {
-                            background-color: #085dd8;
-                            border: 0;
-                            color: white;
-                          }
-                        }
-                      }
-                    }
-
-                    .header_wrapper_profile_search {
-                      .header_input_search {
-                        margin: 0 0.5rem;
-                        height: 30px;
-
-                        input {
-                          border-radius: 3px;
-                          height: 100%;
-                          box-shadow: none;
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
-</style>
+<style lang="scss"></style>