میعین (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

راه‌اندازی پروژه

برای اجرای پروژه، باید php و composer را از قبل نصب کرده باشید.

ابتدا پروژه‌ی اولیه را دانلود و از حالت فشرده خارج کنید.
دستور composer install را در پوشه‌ی اصلی پروژه برای نصب نیازمندی‌ها اجرا کنید.
برای اجرای مایگریشن‌ها از دستور php artisan migrate استفاده کنید.

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

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

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

ساختار جدول users و پیاده‌سازی مایگریشن create_users_table

ساختار جدول `users`

نام ستون	نوع داده	توضیحات
`id`	`bigint`	کلید اصلی
`name`	`string`	نام کاربر
`email`	`string`	ایمیل (منحصربه‌فرد)
`email_verified_at`	`timestamp`	زمان تأیید ایمیل
`password`	`string`	رمز عبور
`remember_token`	`string`	توکن احراز هویت
`created_at`	`timestamp`	زمان ایجاد
`updated_at`	`timestamp`	زمان آخرین به‌روزرسانی

ساختار جدول services و پیاده‌سازی مایگریشن create_services_table

جدول `services`

نام ستون	نوع داده	توضیحات
`id`	`bigint`	کلید اصلی
`user_id`	`bigint`	کلید خارجی به جدول `users`
`name`	`string`	نام سرویس
`price`	`decimal(8,2)`	قیمت سرویس
`created_at`	`timestamp`	زمان ایجاد
`updated_at`	`timestamp`	زمان آخرین به‌روزرسانی

ساختار جدول invoices و پیاده‌سازی مایگریشن create_invoices_table

جدول `invoices`

نام ستون	نوع داده	توضیحات
`id`	`bigint`	کلید اصلی
`service_id`	`bigint`	کلید خارجی به جدول `services`
`amount`	`decimal(8,2)`	مبلغ صورت‌حساب
`paid_at`	`timestamp`	زمان پرداخت
`created_at`	`timestamp`	زمان ایجاد
`updated_at`	`timestamp`	زمان آخرین به‌روزرسانی

ساختار جدول tickets و پیاده‌سازی مایگریشن create_tickets_table

جدول `tickets`

نام ستون	نوع داده	توضیحات
`id`	`bigint`	کلید اصلی
`user_id`	`bigint`	کلید خارجی به جدول `users`
`subject`	`string`	موضوع تیکت
`description`	`text`	توضیحات تیکت
`status`	`string`	وضعیت (`open` یا `closed`)
`created_at`	`timestamp`	زمان ایجاد
`updated_at`	`timestamp`	زمان آخرین به‌روزرسانی

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

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

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

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

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

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

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

ساختار فکتوری InvoiceFactory

فکتوری `InvoiceFactory`

نام ستون	توضیحات	مقادیر ممکن
`service_id`	کلید خارجی به جدول `services`	مقدار یک `service_id` معتبر
`amount`	مبلغ صورت حساب	عدد اعشاری بین ۱۰ تا ۱۰۰
`paid_at`	زمان پرداخت	`null` یا یک تاریخ تصادفی

ساختار فکتوری ServiceFactory

فکتوری`ServiceFactory`

نام ستون	توضیحات	مقادیر ممکن
`user_id`	کلید خارجی به جدول `users`	مقدار یک `user_id` معتبر
`name`	نام سرویس	یک کلمه تصادفی
`price`	قیمت سرویس	عدد اعشاری بین ۱۰ تا ۱۰۰

ساختار فکتوری TicketFactory

فکتوری `TicketFactory`

نام ستون	توضیحات	مقادیر ممکن
`user_id`	کلید خارجی به جدول `users`	مقدار یک `user_id` معتبر
`subject`	موضوع تیکت	یک جمله تصادفی
`description`	توضیحات تیکت	یک پاراگراف تصادفی
`status`	وضعیت تیکت	`open` یا `closed`

ساختار فکتوری UserFactory

فکتوری `UserFactory`

نام ستون	توضیحات	مقادیر ممکن
`name`	نام کاربر	نام تصادفی
`email`	ایمیل کاربر (یونیک)	ایمیل تصادفی معتبر
`email_verified_at`	زمان تأیید ایمیل	زمان فعلی
`password`	رمز عبور	کلمه `password` به صورت هش شده
`remember_token`	توکن یادآوری	رشته ۱۰ کاراکتری تصادفی

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

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

دقیقا ۱۰ کاربر با استفاده از فکتوری User ایجاد می‌شوند.
هر کاربر دقیقا ۵ سرویس با استفاده از فکتوری Service خواهد داشت، پس در نهایت باید ۵۰ سرویس ثبت شود.
هر کاربر به صورت تصادفی بین ۳ تا ۵ صورت‌حساب با استفاده از فکتوری Invoice برای سرویس‌های مختلف خود دارد. توجه داشته باشید که تعداد کل صورت‌حساب‌های کاربر بین ۳ تا ۵ صورت‌حساب می‌باشد و این مقدار به ازای هر کدام از سرویس‌های کاربر نیست.
هر کاربر به صورت تصادفی بین ۰ تا ۱۰ تیکت با استفاده از فکتوری 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 اهمیتی ندارد.

ارسال پاسخ برای این سؤال

جزئیات پروژه

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

ساختار جدول users

جدول services

جدول invoices

جدول tickets