کوئرا به‌تازگی می‌خواهد یک فروشگاه برای خرید و فروش تجهیزات کامپیوتری تأسیس کند و از شما می‌خواهد که با استفاده از جنگو یک سیستم مدیریت فروشگاه آنلاین برای او پیاده‌سازی کنید.

پیاده‌سازی

پروژه‌ی اولیه را می‌توانید از این لینک دانلود کنید. ساختار پروژه به شرح زیر است و شما باید قسمت‌های مشخص شده را پیاده‌سازی کنید.

├── manage.py
├── requirements.txt
├── server
│   ├── __init__.py
│   ├── asgi.py
│   ├──  > settings.py < 
│   ├── urls.py
│   └── wsgi.py
└── store
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├──  > migrations < 
    │   └── __init__.py
    ├──  > models.py < 
    ├──  > permissions.py < 
    ├──  > queries.py < 
    ├── serializers.py
    ├──  > signals.py < 
    ├── tests.py
    ├──  > throttling.py < 
    └──  > views.py < 

نیازمندی‌ها

احراز هویت مبتنی بر توکن

• سیستم احراز هویت مبتنی بر توکن را با استفاده از TokenAuthentication جنگو پیاده‌سازی کنید.
• هر کاربر باید برای دسترسی به هر اندپوینت، با توکن احراز هویت شود.
• سه نوع کاربر وجود دارد:
  • مشتری: می‌تواند محصولات را مشاهده کند، سفارش ثبت کند و نظرات ارسال کند.
  • مدیر فروشگاه: می‌تواند موجودی را مدیریت کند و سفارش‌ها را پردازش کند.
  • مدیر کل (Admin): می‌تواند کاربران، تنظیمات فروشگاه و آمار را مدیریت کند.

مدل‌ها

• کاربر: مدل کاربر سفارشی که از AbstractUser جنگو به ارث می‌برد و نقش‌هایی (مشتری، مدیر فروشگاه، مدیر کل) دارد. که این مدل برای شما پیاده‌سازی شده است و نیاز به پیاده‌سازی آن نیست.

• محصول:

  • فیلد name که نام محصول است.
  • فیلد description که توضیحات مرتبط به محصول است.
  • فیلد price که یک عدد تنها با دو رقم اعشار است.
  • فیلد inventory تعداد محصولات موجود در انبار را نگه می‌دارد.(مقدار پیش فرض 0 عدد)
  • فیلد rating میانگین نمرات مشتریان را در یک عدد با دو رقم اعشار نگه می‌دارد که با تابع update_rating همواره پس از save شدن مدل محاسبه می‌شود.
  • پراپرتی ‍discounted_price که قیمت محصول پس از اعمال اولین تخفیف را نگه می‌دارد.

• سفارش:

  • فیلد ‍customer که user خریدار است.
  • فیلد products که یک ارتباط چند به چند به محصول است.
  • فیلد total_price که مجموع خرید را در یک عدد با دو رقم اعشار نگه می‌دارد.(مقدار پیش فرض: 0)
  • فیلد status که شامل یکی از گزینه‌هایی است که در صورت پروژه آمده است.
  • فیلد quantity یک عدد که تعداد کل محصولات خریداری شده را نگه می‌دارد. (مقدار پیشفرض یک عدد خواهد بود)
  • فیلد order_date که تاریخ ساخت سفارش را نگه می‌دارد.

• نقد و بررسی (Review):

  • فیلد ‍user که کاربر ثبت کننده نقد است.
  • فیلد product که محصول مورد بررسی است.
  • فیلد rating که یک عدد صحیح بین ۱ تا ۵ است که امتیاز کاربر به آن محصول است.
  • فیلد comment که کامنت کاربر راجع به محصول است.
  • فیلد created_at که تاریخ ساخت این نقد است.

• تخفیف (Discount):

  • فیلد product که محصول دارای تخفیف است.
  • فیلد discount_percentage که درصد تخفیف تا دو رقم اعشار است.
  • فیلد start_date که زمان شروع تخفیف است.
  • فیلد end_date که زمان پایان تخفیف است.
  • تابع is_active که فعال بودن تخفیف را مشخص می‌کند.

نکته: بعد از تکمیل پیاده‌سازی مدل‌ها، حتما باید دستورهای مایگرشن اجرا شود تا فایل‌های مایگرشن در پروژه ایجاد شوند.

کوئری‌ها

• محصولات پرفروش: تابع get_top_selling را پیاده‌سازی و یک اندپوینت /api/products/top-selling/‍ بسازید که ۵ محصول پرفروش بر اساس تعداد فروش (quantity) را بازگرداند. از کوئری‌های annotation برای محاسبه تعداد کل فروش هر محصول استفاده کنید.
• آمار سفارشات: تابع get_monthly_income را پیاده‌سازی کنید که درآمد کل تولید شده در ۳۰ روز گذشته را محاسبه کرده و سه مشتری برتر را بر اساس کل مبلغ خرج‌شده بازگرداند.
• تاریخچه سفارشات مشتری: تابع get_customers_orders را پیاده‌سازی و یک اندپوینت ‍/api/orders/customer_orders/ ارائه دهید که سفارشات قبلی مشتری را شامل قیمت کل، محصولات سفارش داده‌شده و وضعیت سفارش لیست کند. از ساب‌کوئری برای محاسبه کل مبلغ خرج‌شده توسط مشتری در پاسخ استفاده کنید.
• محصولات با بیشترین امتیاز: تابع get_top_rated_products را پیاده‌سازی کنید و یک اندپوینت /api/products/top-rated/‍ برای نمایش ۵ محصول با بیشترین امتیاز ایجاد کنید. از ساب‌کوئری‌ها برای محاسبه امتیاز میانگین و تعداد کل نظرات برای هر محصول استفاده کنید.
• سفارشات اخیر: تابع recent_orders را پیاده‌سازی کنید و از آن در یک اندپوینت /api/orders/recent/ استفاده کنید که جدیدترین سفارش هر مشتری را بازگرداند.

سیگنال‌ها

• از سیگنال‌های جنگو برای موارد زیر استفاده کنید:
  • به‌روزرسانی موجودی محصول هنگامی که یک سفارش ثبت می‌شود.
  • به‌روزرسانی امتیاز محصول هنگامی‌که یک نظر جدید اضافه یا ویرایش می‌شود و امتیاز میانگین محصول مجدداً محاسبه می‌شود.

مجوزها

• یک سیستم مجوز مبتنی بر نقش‌ها پیاده‌سازی کنید:
  • مشتریان: می‌توانند محصولات را مشاهده کنند، سفارش ثبت کنند و تنها سفارشات خود را ببینند و نظرات ارسال کنند و صرفا نظرات خود را می‌توانند ویرایش و پاک کنند.
  • مدیران فروشگاه: می‌توانند محصولات را مدیریت کرده و سفارشات مشتریان را پردازش کنند (تأیید، رد یا ارسال).
  • مدیران کل: کنترل کامل بر تمام موارد از جمله مدیریت کاربران و تخفیف‌ها دارند.
• فایل permissions.py را برای هندل کردن این مجوزها باید پیاده‌سازی کنید.
• اطمینان حاصل کنید که مشتریان نمی‌توانند نظرات را به‌روز کنند یا حذف کنند مگر این‌که خودشان آن‌ها را ایجاد کرده باشند.

سیستم محدودسازی درخواست‌ها

• یک سیستم محدودسازی درخواست‌ها با استفاده از سیستم Throttling DRF پیاده‌سازی کنید:
  • مشتریان: ۱۰۰ درخواست در روز
  • مدیران فروشگاه: ۵۰۰ درخواست در روز
  • مدیران کل: ۱۰۰۰ درخواست در روز

تخفیف‌ها

• مدیران کل باید قادر باشند تخفیف‌هایی را ایجاد و مدیریت کنند. هنگامی که یک محصول تخفیف فعال دارد، قیمت آن باید به‌روزرسانی شود تا تخفیف را منعکس کند.

اندپوینت‌های API

توجه داشته باشید که جز بخش تحلیل‌ها، فرمت پاسخ هر بخش به شکل serializer آن بخش است. %align_right_start%

1. احراز هویت:

• POST /api/token-auth/: تولید توکن احراز هویت که username و ‍password از کاربر دریافت می‌کند و در صورت احراز هویت token را در پاسخ برمی‌گرداند.

2. محصولات:

• GET /api/products/: لیست همه محصولات.

• GET /api/products/<id>/: دریافت جزئیات یک محصول.

• POST /api/products/: اضافه کردن یک محصول جدید (فقط مدیر فروشگاه/مدیر کل).

• PUT /api/products/<id>/: به‌روزرسانی یک محصول (فقط مدیر فروشگاه/مدیر کل).

• DELETE /api/products/<id>/: حذف یک محصول (فقط مدیر کل).

• GET /api/products/top-selling/: دریافت محصولات پرفروش (فقط مدیر کل).

• GET /api/products/top-rated/: دریافت محصولات با بیشترین امتیاز (مشتریان).

3. سفارشات:

• POST /api/orders/: ثبت سفارش جدید (مشتریان).

• GET /api/orders/<id>/: دریافت جزئیات سفارش (مشتری/مدیر فروشگاه).

• GET /api/orders/recent/: دریافت سفارشات اخیر هر مشتری (مدیر فروشگاه/مدیر کل).

• GET /api/orders/customer_orders/: دریافت تاریخچه سفارشات مشتری (مشتریان).

4. نقد و بررسی‌ها:

• POST /api/products/<id>/reviews/: ارسال نظر برای محصول (مشتریان).

• GET /api/products/<id>/reviews/: دریافت نظرات یک محصول (مشتریان).

• PUT /api/reviews/<id>/: به‌روزرسانی یک نظر (مشتریان).

• DELETE /api/reviews/<id>/: حذف یک نظر (مدیر کل/مشتری‌ای که نظر را ایجاد کرده).

5. تخفیف‌ها:

• POST /api/discounts/: ایجاد تخفیف (فقط مدیر کل).

• GET /api/discounts/: لیست همه تخفیف‌های فعال (فقط مدیر کل).

• DELETE /api/discounts/<id>/: حذف یک تخفیف فعال (فقط مدیر کل).

6. تحلیل‌ها:

• GET /api/analytics/revenue/: دریافت کل درآمد و سه مشتری برتر (فقط مدیر کل). مانند زیر:

{
    "total_income": 130.20
    "top_customers": [
        {
             "username": "ahmad",
             "total_spent": 23.01
        },
        {
             "username": "ali",
             "total_spent": 20.00
        },
        {
             "username": "javad",
             "total_spent": 14.50
        }
    ]
}

• GET /api/analytics/orders/: این API صرفا یک جواب به مدیر کل برگرداند که در آن تعداد کل رکوردهای order باشد. به شکل زیر:

{
    "total_orders": 13
}

آن‌چه باید آپلود کنید

شما باید یک فایل ZIP با ساختار مشابه با پروژه اولیه را آپلود کنید.