میعین (Miein) که به تازگی از کوئرا (Quera) به جونیورا (Juniora) فرار کرده است، پس از مدتی متوجه شده است که حتی جونیورا نیز نمی‌تواند میزبان رویا‌های بلند‌پروازانه‌ی او باشد! او که پس از دیدن بنر مسابقه استخدامی ایران‌سرور (IranServer) در کوئرا و مراجعه به وب‌سایت آن، با شعار "سریع، امن و همیشه همراه در مسیر رشد کسب و کار" مواجه شده است حالا مطمئن شده که ایران‌سرور همان سرزمین رویا‌های او خواهد بود.

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

جزئیات پروژه

پروژه‌ی اولیه را از این لینک دانلود کنید.

miein-farari
├── app
│   ├── Http
│   │   ├── Controllers
│   │   │   └── UserController.php
│   ├── Models
│   │   ├── User.php
│   │   ├── Service.php
│   │   ├── Invoice.php
│   │   └── Ticket.php
├── database
│   ├── factories
│   │   ├── UserFactory.php
│   │   ├── ServiceFactory.php
│   │   ├── InvoiceFactory.php
│   │   └── TicketFactory.php
│   ├── migrations
│   │   ├── 2024_02_26_000000_create_users_table.php
│   │   ├── 2024_02_26_000001_create_services_table.php
│   │   ├── 2024_02_26_000002_create_invoices_table.php
│   │   └── 2024_02_26_000003_create_tickets_table.php
│   ├── seeders
│   │   └── DatabaseSeeder.php
├── routes
│   └── web.php
├── tests
├── README.md
├── artisan
├── composer.json
├── composer.lock
├── package.json
├── phpunit.xml
├── server.php
└── webpack.mix.js

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

پیاده‌سازی جداول و نوشتن مایگریشن‌ها (Migrations)

در این بخش میعین باید مایگریشن‌های مربوط به ایجاد جداول users، services، invoices و tickets را که به ترتیب مربوط به اطلاعات کاربران، سرویس‌های ارائه‌شده توسط ایران‌سرور به هر کاربر، صورت‌حساب‌های سرویس‌ها و تیکت‌های پشتیبانی ارسالی کاربران می‌باشند را پیاده‌سازی کند. ساختار مربوط به هر کدام از جداول در بخش زیر مشخص است:

پیاده‌سازی مدل‌ها

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

• مدل User: کاربران ایران‌سرور
• مدل Service: سرویس‌هایی که ایران‌سرور به هر کاربر ارائه می‌دهد
• مدل Invoice: صورت‌حساب‌های پرداختی مربوط به سرویس‌های ارائه شده
• مدل Ticket: تیکت‌های پشتیبانی ارسال شده توسط کاربران

پیاده‌سازی روابط بین مدل‌ها

• هر کاربر می‌تواند چندین سرویس داشته باشد.
• هر سرویس به یک کاربر تعلق دارد.
• هر سرویس می‌تواند چندین صورت‌حساب داشته باشد.
• هر صورت‌حساب به یک سرویس تعلق دارد.
• هر کاربر می‌تواند چندین تیکت پشتیبانی ایجاد کند.
• هر تیکت پشتیبانی متعلق به یک کاربر است.

پیاده‌سازی فکتوری‌ها‌ (Factories)

میعین باید فکتوری‌های زیر را در این چالش پیاده‌سازی کند تا در مرحله بعد با استفاده از یک دیتابیس سیدر (Seeder) داده‌های تصادفی برای تست برنامه‌ نوشته شده ایجاد کند. برای بررسی بیشتر هر کدام از فکتوری‌ها روی بخش‌های زیر کلیک کنید:

پیاده‌سازی سیدر (Seeder)

یک سیدر (Seeder) با عنوان DatabaseSeeder در پروژه اولیه وجود دارد که باید به شکل زیر برای ایجاد داده‌ها در دیتابیس با استفاده از فکتوری‌های پیاده‌سازی شده مورد استفاده قرار بگیرد:

1. دقیقا ۱۰ کاربر با استفاده از فکتوری User ایجاد می‌شوند.
2. هر کاربر دقیقا ۵ سرویس با استفاده از فکتوری Service خواهد داشت، پس در نهایت باید ۵۰ سرویس ثبت شود.
3. هر کاربر به صورت تصادفی بین ۳ تا ۵ صورت‌حساب با استفاده از فکتوری Invoice برای سرویس‌های مختلف خود دارد. توجه داشته باشید که تعداد کل صورت‌حساب‌های کاربر بین ۳ تا ۵ صورت‌حساب می‌باشد و این مقدار به ازای هر کدام از سرویس‌های کاربر نیست.
4. هر کاربر به صورت تصادفی بین ۰ تا ۱۰ تیکت با استفاده از فکتوری Ticket دارد.

بهینه‌سازی یک مشکل اساسی در کنترلر UserController

کنترلر UserController به شکل زیر از قبل در فایل‌های پروژه اولیه پیاده‌سازی شده است که با دریافت تمامی کاربران موجود در برنامه در ویو users.index لیست کاربران به همراه هر کدام از سرویس‌های مربوط به آن‌ها و هر کدام از صورت‌حساب‌های مربوط به هر کدام از آن سرویس‌ها را نمایش می‌دهد. پیاده‌سازی انجام شده به شکل بهینه‌ای نیست و دارای مشکل است که میعین باید این مشکل را نیز در پروژه ارسالی خود برطرف سازد:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;

class UserController extends Controller
{
    public function index()
    {
        $users = User::all();
        return view('users.index', compact('users'));
    }
}

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

• توجه: پس از پیاده‌سازی موارد خواسته شده، کل فایل‌های پروژه به‌جز پوشه‌ی vendor را زیپ کرده و ارسال کنید.
• توجه: شما مجاز به افزودن فایل جدیدی در این ساختار نیستید و تنها باید تغییرات را در فایل‌های موجود اعمال کنید.
• توجه: که نام فایل Zip اهمیتی ندارد.