همه چی از uber شروع شد. ایده‌ی خوبی که رانندگان را به مسافران وصل می‌کرد و هر کسی هر جایی بود به سرعت می‌توانست برای خودش تاکسی درخواست دهد. مدتی نگذشت که برنامه‌نویس‌های داخل کشور عزیزمان هم از این سرویس ایده گرفتند و شروع به پیاده‌سازی مشابه آن در ایران کردند. در حال حاضر چندین سرویس درخواست آنلاین تاکسی وجود دارد که در تهران و چند شهر دیگر مشغول سرویس‌دهی به مسافرین هستند و روز به روز هم گسترش بیشتری می‌یابند و اشتغال‌زایی زیادی را نیز به وجود آورده‌اند. حالا با توجه به بازار داغ این سرویس ما نیز می‌خواهیم یک سرویس مشابه ایجاد کنیم. اسمش را هم cabin گذاشته‌ایم.

پروژه اولیه

پروژه اولیه را از این لینک دانلود کنید. ساختار این پروژه به شرح زیر است:

cabin 2
├─── manage.py
├─── requirements.txt
│
├─── cabin
│   ├─── admin.py
│   ├─── apps.py
│   ├─── models.py
│   ├───  > queries.py < 
│   ├─── views.py
│   ├─── __init__.py
│   │
│   ├─── fixtures
│   │   └─── sample_test_fixture.json
│   │
│   └─── migrations
│        ├── 0001_initial.py
│        └─── __init__.py
│
├───challenge
│   ├─── settings.py
│   ├─── urls.py
│   ├─── wsgi.py
│   └─── __init__.py
│
└───tests
    ├─── testsample.py
    └─── __init__.py

همانطور که در فایل‌ها می‌بینید یک app به نام cabin وجود دارد. در فایل models.py هشت مدل به شرح زیر وجود دارند:

حال از شما می‌خواهیم پرس‌‌و‌‌جو (query) های زیر را روی مدل‌های بالا بنویسید.

حتما قبل شروع نوشتن کد، تذکرات انتهای سوال را بخوانید!

{'payment_sum': value }

<QuerySet [{'id': 1, 'n': 8}, {'id': 2, 'n': 1},....]>

زیرمسئله‌ها

امکانات اضافه

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

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

۱. ایجاد پایگاه‌داده

python manage.py migrate

۲. وارد کردن داده‌های از پیش آماده شده (fixture)

python manage.py loaddata cabin/fixtures/sample_test_fixture.json
python manage.py loaddata cabin/fixtures/test_fixtures.json

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

تست نمونه

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

تست‌ها را می‌توانید با دستور زیر اجرا کنید:

python manage.py test

نکات

• یک فایل به نام queries.py وجود دارد که برای هر سوال یک تابع در نظر گرفته شده است. شما باید کدهای خود را در این فایل بنویسید و QuerySet مربوطه را بازگردانید.
• برای نمونه تابع query_0 در پاسخ به پرس و جویِ «لیست همه‌ی رانندگانی که رتبه‌ی آنها بیشتر از x است.» کامل شده است که شما نیز باید مشابه همین تابع بقیه توابع را کامل کنید.

def query_0(x):
    q = Driver.objects.filter(rating__gt=x)
    return q

• در سوالاتی که در صورت سوال مقداری به صورت متغیر ذکر شده است (مانند x در مثال بالا)، متغیر مورد نظر در آرگومان‌های ورودی تابع درنظر گرفته شده است. شما خود نباید آرگومان‌های ورودی تابع را تغییر دهید.
• در تمام سوالات به جز سوالاتی که خروجی نمونه برای آنها مشخص شده است، همان‌طور که ذکر شد، خروجی شما یک شئ از نوع QuerySet با المان‌هایی از جنس گفته‌شده در اول سوال باید باشد. یعنی در واقع خود query را return کنید.
• برای مثال اگر سوال گفته باشد «لیست ماشین هایی که....» خروجی شما به شکل زیر باید باشد:

<QuerySet [<Car: Car object>, <Car: Car object>,.....]>

• در سوالات دیگر نیز که خروجی مشخص شده است، باز نتیجه یک QuerySet است ولی شامل همه فیلدهای مدل مورد نظر نمی‌شود و فقط فیلد‌های خواسته‌شده با نام خواسته‌شده باید در آن قرار داشته باشد.
• شما تنها مجوز ایجاد تغییرات در فایل‌ cabin/queries.py را دارید و تمامی تغییرات دیگر شما در فایل‌های پروژه نادیده گرفته خواهند شد.
• فراموش نکنید که می‌توانید با مطالعه‌ی testsample.py با روش تست کردن کوئری‌ها آشنا شوید.

نحوه ارسال

یک فایل ZIP حاوی همه‌ی فایل‌های پروژه، آپلود کنید. نام فایل ZIP اهمیتی ندارد.