import uuid, random, string from datetime import timedelta from django.db import models…
- User
import uuid, random, string from datetime import timedelta from django.db import models from django.contrib.auth.models import AbstractUser from django.utils import timezone from django.urls import reverse
region ==> custom user model
class CustomUser(AbstractUser): username = models.CharField( max_length=50, unique=True, primary_key=True, blank=True, verbose_name='نام کاربری' ) phone_number = models.CharField( max_length=13, null=True, blank=True, verbose_name='شماره موبایل' ) access_hash = models.CharField( max_length=200, null=True, blank=True, verbose_name='توکن تلگرام کاربر' ) email = models.CharField( max_length=100, null=True, blank=True, verbose_name='ایمیل' ) refrral = models.CharField( max_length=100, null=True, blank=True, verbose_name='معرف' ) first_name = models.CharField( max_length=20, null=True, blank=True, verbose_name='نام' ) last_name = models.CharField( max_length=40, blank=True, null=True, verbose_name='نام خانوادگی' ) birth_date = models.DateField( null=True, blank=True, verbose_name='تاریخ تولد' ) avatar = models.ImageField( upload_to='app_account/avatar/', null=True, blank=True, verbose_name='آواتار پروفایل' ) user_language = models.CharField( max_length=20, default='en', verbose_name='زبان کاربر', ) is_superuser = models.BooleanField(default=False) is_staff = models.BooleanField(default=False) is_active = models.BooleanField(default=True) date_joined = models.DateTimeField(default=timezone.now)
def __str__(self): return f"{self.first_name} {self.last_name} / {self.username}" class Meta: db_table = 'tbl_user_info' verbose_name_plural = 'مشخصات کاربران'endregion
class users_request_log(models.Model): user = models.ForeignKey(CustomUser, on_delete=models.CASCADE, related_name='user_request_log', verbose_name='کاربر') method = models.CharField(max_length=10, verbose_name='متد درخواست') path = models.CharField(max_length=200, verbose_name='آدرس درخواست') # query_params = models.TextField(blank=True, null=True, verbose_name='پارامترهای درخواست') # data = models.TextField(blank=True, null=True, verbose_name='دیتای درخواست') time = models.DateTimeField(auto_now_add=True)
def __str__(self): return f"{self.user.username} / {self.method} / {self.path}" class Meta: db_table = 'tbl_user_request_log' verbose_name_plural = 'لاگ درخواست های کاربران'در مورد کد بالا توضیح بده بصورت سطر ب سطر
- Assistant
کد ارائهشده یک مدل (Model) در فریمورک Django برای تعریف یک سیستم مدیریت کاربران و ثبت لاگ درخواستهای آنها است. در ادامه توضیحات سطر به سطر این کد آمده است:
1. وارد کردن کتابخانهها
import uuid, random, string from datetime import timedelta from django.db import models from django.contrib.auth.models import AbstractUser from django.utils import timezone from django.urls import reverse- uuid: برای شناساییهای یکتا استفاده میشود، هرچند در کد استفادهای نشده است.
- random, string: برای تولید رشتههای تصادفی، هرچند در کد نیز استفادهای ندارند.
- timedelta: برای محاسبات زمان، که استفادهای در کد ندارد.
- models: ماژولی از Django که شامل کلاس پایه برای تعریف مدلها است.
- AbstractUser: کلاس اصلی برای کار با کاربران در Django. این امکان را میدهد که یک مدل کاربری سفارشی بسازیم.
- timezone: برای کار با زمان و تاریخ در مناطق زمانی مختلف.
- reverse: ابزاری برای معکوس کردن URL ها.
2. تعریف مدل کاربر سفارشی
class CustomUser(AbstractUser):- مدل
CustomUserازAbstractUserارثبری میکند و امکانات کاربری Django را گسترش میدهد.
3. ویژگیهای کلاس CustomUser
username = models.CharField( max_length=50, unique=True, primary_key=True, blank=True, verbose_name='نام کاربری' )- username: فیلدی برای نام کاربری که باید یکتا باشد و به عنوان کلید اصلی شناخته میشود.
phone_number = models.CharField( max_length=13, null=True, blank=True, verbose_name='شماره موبایل' )- phone_number: فیلدی برای شماره موبایل که میتواند خالی باشد.
access_hash = models.CharField( max_length=200, null=True, blank=True, verbose_name='توکن تلگرام کاربر' )- access_hash: فیلدی برای ذخیره توکن تلگرام کاربر.
email = models.CharField( max_length=100, null=True, blank=True, verbose_name='ایمیل' )- email: فیلدی برای ثبت ایمیل کاربر که میتواند خالی باشد.
refrral = models.CharField( max_length=100, null=True, blank=True, verbose_name='معرف' )- refrral: فیلدی برای ثبت اطلاعات معرف کاربر.
first_name = models.CharField( max_length=20, null=True, blank=True, verbose_name='نام' )- first_name: نام کاربر.
last_name = models.CharField( max_length=40, blank=True, null=True, verbose_name='نام خانوادگی' )- last_name: نام خانوادگی کاربر.
birth_date = models.DateField( null=True, blank=True, verbose_name='تاریخ تولد' )- birth_date: تاریخ تولد کاربر.
avatar = models.ImageField( upload_to='app_account/avatar/', null=True, blank=True, verbose_name='آواتار پروفایل' )- avatar: فیلدی برای بارگذاری تصویر آواتار پروفایل کاربر.
user_language = models.CharField( max_length=20, default='en', verbose_name='زبان کاربر', )- user_language: فیلدی برای تعیین زبان کاربر که به صورت پیشفرض
'en'است.
is_superuser = models.BooleanField(default=False)- is_superuser: فیلدی Boolean که نشاندهنده سوپریوزر بودن کاربر است.
is_staff = models.BooleanField(default=False)- is_staff: فیلدی Boolean که نشاندهنده این است که آیا کاربر مجاز است به پنل مدیریت وارد شود یا خیر.
is_active = models.BooleanField(default=True)- is_active: فیلدی Boolean که نشاندهنده فعال بودن حساب کاربر است.
date_joined = models.DateTimeField(default=timezone.now)- date_joined: تاریخ و زمان پیوستن کاربر به سیستم.
4. توابع و متا
def __str__(self): return f"{self.first_name} {self.last_name} / {self.username}"- متد
__str__که نمایشی خوانا از کاربر را برمیگرداند.
class Meta: db_table = 'tbl_user_info' verbose_name_plural = 'مشخصات کاربران'- تعریف نام جدول در دیتابیس و نام جمع مدل به زبان فارسی.
5. مدل ثبت لاگ درخواستها
class users_request_log(models.Model):- تعریف کلاس
users_request_logکه برای ثبت درخواستهای کاربران استفاده میشود.
6. ویژگیهای کلاس users_request_log
user = models.ForeignKey(CustomUser, on_delete=models.CASCADE, related_name='user_request_log', verbose_name='کاربر')- فیلدی برای ارجاع به کاربر، که با حذف کاربر، درخواستهای او نیز حذف میشوند.
method = models.CharField(max_length=10, verbose_name='متد درخواست')- فیلدی برای ذخیره متد درخواست (GET, POST و ...).
path = models.CharField(max_length=200, verbose_name='آدرس درخواست')- فیلدی برای ذخیره آدرس درخواست.
time = models.DateTimeField(auto_now_add=True)- فیلدی که به صورت خودکار زمان ثبت درخواست را ذخیره میکند.
7. توابع و متا
def __str__(self): return f"{self.user.username} / {self.method} / {self.path}"- متد
__str__که نمایشی از لاگ درخواست را ارائه میدهد.
class Meta: db_table = 'tbl_user_request_log' verbose_name_plural = 'لاگ درخواست های کاربران'- تعریف نام جدول و نام جمع مدل برای لاگ درخواستها.
با این توضیحات، مدلهای موجود در کد به وضوح تعریف شده و هر یک از ویژگیها و قابلیتهای موجود به طور کامل مشخص شدهاند.