جَلال انسانی وطن‌دوست و میهن‌پرست است. او که از کار کردن با تقویم میلادی و تبدیل دائم آن به تقویم شمسی خسته شده بود، از شما برای رفع این مشکل درخواست کمک کرده است. از آن‌جایی که شما نیز انسانی وطن‌دوست و میهن‌پرست هستید، با کمال میل به کمک او می‌شتابید و به جَلال کمک می‌کنید تا با تقویم جَلالی کار کند. در این پروژه شما باید قابلیت اضافه‌کردن تاریخ فارسی به مدل جنگو را با استفاده از کتابخانه‌ی `django_jalali` پیاده‌سازی کنید. # پروژه اولیه پروژه اولیه را از [این لینک](/contest/assignments/37739/download_problem_initial_project/129620/) دانلود کنید. ساختار فایل‌های این پروژه به صورت زیر است: ``` jalali ├── Users │ ├── <mark class="yellow" title="این فایل را تغییر دهید"> > admin.py < </mark> │ ├── apps.py │ ├── <mark class="yellow" title="این فایل را تغییر دهید"> > forms.py < </mark> │ ├── migrations │ │ └── __init__.py │ ├── <mark class="yellow" title="این فایل را تغییر دهید"> > models.py < </mark> │ ├── tests.py │ ├── urls.py │ └── views.py ├── jalali │ ├── asgi.py │ ├── __init__.py │ ├── settings.py │ ├── urls.py │ └── wsgi.py ├── manage.py ├── Pipfile ├── Pipfile.lock └── requirements.txt ``` ## مدل `CustomUser` اپلیکیشن `Users` فقط شامل یک مدل به نام `CustomUser` است که این مدل شامل فیلدهای زیر می‌باشد: #### **ویژگی‌ها** + **ویژگی** ‍‍`username` : این فیلد از نوع `CharField` و حداکثر طول آن **۲۵۶** می‌باشد. + **ویژگی** ‍‍`full_name` : این فیلد از نوع `CharField` و حداکثر طول آن **۲۵۶** می‌باشد. + **ویژگی** `‏gender` : این فیلد از نوع `CharField` می‌باشد. ویژگی `gender` باید از بین جنسیت‌های `Male` و `Female` انتخاب شود و در داخل پایگاه داده به جای `Male` حرف `M` ذخیره و به جای کلمه‌ی `Female` حرف `F` ذخیره شود. + **ویژگی** ‍‍`national_code` : این فیلد از نوع `CharField` و حداکثر طول آن **۱۰** می‌باشد. + **ویژگی** `birthday_date` : این فیلد از نوع تاریخ (‍`date`) شمسی می‌باشد. + **ویژگی** `‏ceremony_datetime` : این فیلد از نوع تاریخ و ساعت (`datetime`) شمسی می‌باشد. + **ویژگی** `country` :‌ این فیلد از نوع `CharField` است و مقدار آن، برای همه‌ی شئ‌ها برابر رشته‌ی `Iran` است. #### **توابع** + **تابع** `get_first_and_last_name` : این تابع، `first_name` و `last_name` کاربر را از روی فیلد `full_name` بدست آورده و در قابل یک دیکشنری بازمی‌گرداند. تضمین می‌شود که فیلد `full_name` فقط شامل یک فاصله (آن هم بین `first_name` و `last_name`) می‌باشد. ```python terminal terminal >>> valid_name = 'Mohammadreza Zamani' >>> wrong_name = 'Mohammad Reza Zamani' >>> wrong_name = 'Mohammad reza Zamani' ``` دیکشنری بازگردانده‌شده از این تابع، باید به‌صورت زیر باشد: ``` python {'first_name': first_name, 'last_name': last_name} ``` برای مثال، برای کاربری با `full_name='Saeid Zamani'`، خروجی تابع به‌صورت زیر خواهدبود: ``` python {'first_name': 'Saeid', 'last_name': 'Zamani'} ``` + **تابع** `get_age` : این تابع، سن کاربر را از روی فیلد `birthday_date` محاسبه کرده و بازمی‌گرداند. دقت کنید که این تابع باید جزء صحیح سن را بازگرداند. مثلا اگر شخصی ۵ سال و ۳ ماه سن داشت، باید عدد ۵ را بازگرداند یا اگر شخصی ۱۰ سال و ۱۱ ماه داشت باید عدد ۱۰ را بازگرداند. ```python terminal terminal >>> from Users.models import CustomUser >>> b = CustomUser.objects.get(person_name='Sara') >>> b.birthday_date jdatetime.date(1377, 10, 8) >>> b.get_age() 23 ``` + **تابع** `is_birthday` : این تابع مشخص می‌کند که آیا امروز، روز تولد کاربر مورد نظر هست یا خیر. در صورتی که امروز، روز تولد کاربر بود، مقدار `True` و در غیر این‌صورت، مقدار ‌`False` را بازمی‌گرداند. ## فرم `CustomUserForm` تمامی فیلدهای مدل `CustomUser` باید داخل کلاس `CustomUserForm` در فایل ‍‍`forms.py` وجود داشته باشند. **اعتبارسنجی‌ها:** + فیلد `national_code` باید **دقیقا** شامل **۱۰** کاراکتر باشد. + فیلد `full_name` باید حتماً شامل `first_name` و `last_name` باشد و هر دوی این مقادیر باید **عنوان** باشند. عنوان‌ بودن یعنی با یک حرف بزرگ انگلیسی شروع شده و بقیه‌ی حروف هر کلمه کوچک باشند. ```python >>> valid_name = 'Arash Ghasemi' >>> wrong_name = 'arash ghasemi' ``` ## ادمین مدل‌ `CustomUser` موجود در `models.py` باید در پنل ادمین ثبت شده و قابل مشاهده باشد. ### شخصی‌سازی `CustomUserAdmin` %align_right_start% - در لیست `CustomUser`ها، مقادیر زیر نمایش داده شود (ترتیب مهم نیست): - `username` - `first_name` - `last_name` - `gender` - `national_code` - `birthday_date` **توجه**: فیلدهای `first_name` و `last_name` از روی فیلد `full_name` ایجاد می‌شوند. - قابلیت جستجو بر اساس `username` و `full_name` وجود داشته باشد. - لیست `CustomUser`ها براساس `ceremony_datetime`، به صورت صعودی مرتب شده باشد. %align_end% ## نکات + شما تنها مجوز ایجاد تغییرات در فایل‌های `Users/models.py‍`، `Users/forms.py` و `Users/admin.py` را دارید و **تمامی تغییرات دیگر شما** در فایل‌های پروژه **نادیده گرفته خواهند شد.** + فراموش نکنید که می‌توانید با مطالعه‌ی `testsample.py` با روش تست کردن مدل‌ها، فرم‌ها و ادمین‌ها آشنا شوید. ## نحوه ارسال یک فایل _ZIP_ حاوی همه‌ی فایل‌های پروژه، آپلود کنید. نام فایل _ZIP_ اهمیتی ندارد.

حل سؤال در بانک سؤالات